Serial Protocol Playground

このツールについて

シリアルプロトコル・プレイグラウンドは、シリアルモニタの上級版です。流れてくるものを見ているだけでなく、自分でバイトのパケットを組み立て、機器へ送り、応答を取り込んで解きほぐします。自分のシリアル機器のファームウェアを書いている人、あるいは他人が作った機器のプロトコルを解析する人のためのものです。すべてChromeやEdgeのWeb Serial API上で動き、IDEもドライバの導入も不要で、送受信した内容がブラウザの外へ出ることはありません。

パケットを組み立てる

パケット構築欄は、混在した書き方を受け付けます。HEX（0x1A、あるいは素の1A）、10進（d255）、2進（0b10101010）、エスケープ付きで引用符に囲んだASCII（"AT\r\n"）を、すべて1行に混ぜて書けます。実際に回線へ出るバイト列はライブプレビューで確認できます。面倒な部分はヘルパーが引き受けます。チェックサムやCRCの自動付与（Modbus、CCITT、XMODEM、Maxim、SMBus、IEEEのCRC-32、さらにsum、XOR、LRC、Fletcher-16）、任意のバイト範囲に対する長さフィールドの自動補完、SLIPやHDLCのバイトスタッフィングによるフレーム包装です。

テスト手順をスクリプト化する

繰り返すテストを指先で覚える必要はありません。スクリプトランナーは、短くループのない手順（パケットを送る、指定ミリ秒だけ待つ、指定のバイト列を含む応答を待つ）をつなげて、実際のポートに対して実行します。各ステップにはタイムスタンプ付きの成功・失敗の記録が残ります。スクリプトはブラウザに保存され、書き出せるプロトコル定義ファイルの中に入って、同僚にそのまま渡せます。

応答を解読する

送信と受信はすべて、正確な単調増加のタイムスタンプ付きで記録され、タイミング解析のためにテキストまたはCSVで書き出せます。取り込んだ応答は、hexエディタとまったく同じHEX＋ASCIIのダンプとしてリクエストと並べて表示され、任意のデコーダがバイトに注釈を付けます。CRCを検証して関数コードと例外コードに名前を付ける内蔵のModbus RTUデコーダ、NMEA 0183のセンテンスデコーダ、あるいは自分で定義するフィールドテンプレート（オフセット、長さ、型、ラベル）です。hexエディタと同じテンプレートの考え方を、未知のプロトコルに当てはめたものです。

プライバシーと対応ブラウザ

Web SerialはChromium系専用のAPIなので、ポートを開くにはデスクトップのChrome、Edge、Opera（またはAndroid版のChrome 148以降）が必要です。FirefoxとSafariは実装していないため、それらのブラウザでは動かないボタンの代わりに正直な対応状況の表が出ます。ただしCRC・チェックサム計算機は機器を必要としないので、そこでも使えます。何につないでも、バイトはこのページと機器の間を直接流れ、サイト側がそれを見ることはありません。