シリアルデバッグアシスタントソフトウェアATK-XCOM V 3.0

ソース：Modbus China Network（modbus.cn） -中国をリードするModbusCommunicationプロトコル技術コミュニティ

この記事：シリアルデバッグアシスタントソフトウェアATK-X COM V 3.0：基本的な送受信からModbusプロトコルへの完全なガイド·著者：modbus Technology Team·公開日2026- 0 7 - 0 1

要旨：ATK-XCOM V3.0はALIENTEK（ALIENTEK）によって開発され、国内組込み開発界で最も広く使用されているシリアルデバッグツールの一つである。この記事では、コア機能をカバーするだけでなく、プロトコル伝送モード（自動タイムアウト再送信、チェックサム/例外OR/CRC8/CRC16の4つの検証、データフレームと実際のデータの分離表示）についても詳しく説明します。これらの機能により、ATK-X COMはModbus RTUデバッグシナリオにおいて通常のシリアルアシスタントよりも1桁優れたものになります。完全なModbusデバッグガイドと類似ツールの比較が付属しています。キーワード：ATK-X COM、Time-to-time Atom、シリアルデバッグアシスタント、プロトコルトランスポート、Modbus RTUデバッグ、CRC16、チェックサム。

シリアルポートのデバッグは、簡単で簡単です-シリアルアシスタントを見つけ、COMポートとボーレートを選択し、16進数フレームを送信し、何を見るために。フレームが送信されると、デバイスは戻ってきますが、返されたデータが正しいかどうか、フレームが失われたかどうか、真ん中の2バイトが正しいチェックコードかどうかはわかりません。

ATK-XCOM V 3.0は、Tunatomチームが開発したシリアルデバッグツールです。STM 32開発ボード、ESP32モジュール、RT-Threadチュートリアルなど、国内の組込みサークルにおけるTianatomの影響は言うまでもなく、基本的に組込みを学ぶ人はすべて自分たちのものを使用しています。ATK-X COMは社内デバッグツールを外部化したものであり、機能は空から設計されたものではなく実際の開発シナリオから構築された。

1.ソフトウェアのインストール方法

开発者：原子（ALN）、国内専门の组み込み开発プロバイダー。エンジニア、Chapter 3、愛好家のための開発ボード、モジュール、コンパニオンツールに長期的に焦点を当てています。

システム要件：Windows 7以上、32/64ビットの両方をサポートしています。Windows 10およびWindows 11 上で安定して動作し、CH340、CP2102、FT232などの一般的なUSB-シリアルチップは正常に認識されます。

2.基本機能の概要

2.1シリアルポートの設定

ソフトウェアを開くと、利用可能なすべてのシリアルポートが自動的にスキャンされ、シリアルポートのドロップダウンリストに対応するシリアルポート名と詳細が表示されます。COM3: USB-SERIAL CH340）。一般的なCH340チップはホットスワップをサポートしています-USBプラグ後にリフレッシュをクリックして表示され、プラグ後に自動的に消えます。一部の古いドライバは手動でシリアルポートを閉じる必要があります。

ボーレート範囲：すべての標準レートをカバーする1200 ~ 138 2，400 bpsのプリセット。標準以外のボーレート（750，000、9216 00など）が必要な場合は、シリアルポートオフ状態で“カスタマイズ”ボタンをクリックして直接数値を入力します。USB-Serialチップと他のデバイスのUARTがこのレートをサポートできることを前提としています。STM 32 USARTは72MHzクロックでサポートする非標準ボーレート範囲は非常に狭く、任意の数字を入力しても安定することはできません。

ストップビット：1、1.5、2の3種類。データビット：5、6、7、8の4ビット。チェックビット：チェックなし、奇数チェック、偶数チェック。Modbus RTUの標準構成：8データビット、1ストップビット、偶数チェックまたは無チェック。

2.2表示と送信。

受信領域は、16進数とASCIIの2つの表示モードをサポートしており、リアルタイムで切り替えられます。2つのカラースキーム：古典的な“黒と緑のワード”（ターミナルスタイルに似ていて、長時間見ても画面が眩しくない）と“白と黒”（ドキュメントスタイルに似ていて、スクリーンショットが利用可能）。“タイムスタンプ”を選択すると、受信した各データに正確な時刻が追加されます時刻表を参照。rnフレーム境界-受信したModbusフレームのちょうど真ん中にある場合0D 0Aタイムスタンプはフレーム内に誤って挿入されます。Modbusデバッグタイムスタンプ機能はASCIIモードで使用し、Hexモードではオフにします。

送信領域は、ASCIIと16進数の両方の入力フォーマットをサポートしています。“新しい行を送信”を選択して送信の最後に自動的に追加rn-ATコマンドモジュール（ESP 826 6、4 Gモジュールなど）を調整する場合は、チェックを入れる必要があります。ショートカットキー。Ctrl+Enter直接送信できます。

“時限送信”機能：一定期間（ミリ秒単位）を設定でき、ソフトウェアは自動的に送信エリアの内容を間隔で循環させます。経年劣化テストに適しています。例えば、Modbusスレーブに24時間連続してレジスタリードコマンドを発行し、デバイスがCommunicationを中断するかどうかを確認します。

“ファイル送信”機能：任意の形式のファイル（.binファームウェア、.hexアップグレードパッケージなど）を、プログレスバーと一時停止/継続制御を備えたシリアルポート経由でバイトストリームに送信できます。IAP（In-Application Programming）シリアルポートファームウェアのアップグレードに直接使用し、個別のアップグレードツールを記述する必要はありません。

2.3複数の送信と指示管理

4つの別々の送信ページ、各ページに10個の編集可能な送信命令（最大40個のプリセットコマンドに相当）。各命令の送信フォーマット（Hex/ASCII）、改行の有無、送信サイクルは個別に設定できます。数字キーパッド0~9は、現在のページの1~10番目のコマンドにバインドすることができます。スマートカーの制御（数字キー 1を押して前進、2を押して後退、3を左に押してください）など、迅速な応答制御が必要なシナリオに最適です。

Commandセットは、Excel形式へのエクスポートとExcelからのインポートをサポートします。プロジェクトの引き渡しでは、すべてのテストCommandをファイルにエクスポートして同僚に直接送信し、同僚はインポート後にまったく同じコマンドでデバッグできます。

プロトコル伝送モード-ATK-X COMのキラー

これがATK-X COMと通常のシリアルアシスタントの本質的な違いです。ほとんどのシリアルアシスタントは、単に“バイトを送信すると、応答が表示されます”です。ATK-X COMのプロトコルトランスポートモードは、自動検証、自動タイムアウト再送信、データとフレームの分離表示の3つのことを行います。

3.1動作の原理

プロトコル伝送の基本的な流れ：送信エリアに実際のデータ（ペイロード）を入力し、ATK-X COMは自動的にデータの前後にフレームヘッダとチェックコードを追加し、完全なプロトコルフレームを構成し、シリアルポート経由で送信します。受信端はフレームを受信した後、チェックコードを計算し、もしチェックが通過すれば確認フレーム（ACK）を返し、送信端はACKを受信して伝送成功を示す。設定時間内にACKを受信しなければ，自動再送し，最大で設定回数再試行する.

Modbus RTUには完全なSend-Ackメカニズムはありませんが（Modbusは独自のマスター/スレーブ応答プロトコルを持っています）、4つの検証アルゴリズムと“生フレームの表示”と“実際のデータの表示”の分離をサポートしています。

3.2 4つの検証方法

プロトコル転送設定で“CRC16”を選択すると、ATK-X COMは自動的にModbus標準多項式（0 x A 0 01）を計算し、Modbus RTUのCRC順序規則に完全に準拠して、下位バイトが前に、上位バイトが後になります（リトルエンディアン）。CRCに加えてベアフレームを入力するだけで、ソフトウェアが2バイトのCRCを追加します。

3.3オリジナルフレームの表示vs実際のデータの表示

受信エリアは2つのモードで切り替えることができます。

• オリジナルフレームの表示：フレームヘッダ、アドレス、関数コード、データ、チェックコードを含む受信した完全なバイトストリームが表示されます。フレーム構造のトラブルシューティングに使用されます。受信バイト数が少ない場合や、タイミング間隔が短すぎる場合があります。
• 実際のデータの表示：検証済みのペイロードのみが表示され、フレームヘッダとチェックコードはすべて取り除かれます。データの内容をすばやく確認するために-“データがどこで始まり、検証がどこで終わるか”を16進数で調べる必要はありません。

Modbusデバッグ時のこの2つのモードの切り替えは次のようになります。まず“表示元フレーム”でフレーム構造が正しく、チェックコードが通過していることを確認します。誤りがないことを確認したら“実データを表示”に切り替え，レジスタの数値変化のみに注目する.

3.4自動再送とタイムアウト設定

送信失敗後の再試行メカニズムには、次の3つのパラメータを設定できます。

• タイムアウト時間（ms）ACKを待つ最大時間。Modbusスレーブの場合、スレーブデバイスの応答速度に応じて、標準的な値は100~500msで十分です。一部の低速デバイス（古い51マイクロコントローラは4，800ボーレート）は、800ms以上に設定する必要があります。
• 再送信の回数：タイムアウト後の自動再送の最大回数。0は再送信しないことを示す。通常は3 - 5回。
• 再送信（ms）：2回の再送信の間隔。この値には>タイムアウトが必要です。さもなければロジックが乱れます。Modbus RTUの場合、フレーム間隔は3.5文字時間（3.5 × 11 /ボーレート）以上でなければならず、9600 bpsは約4msである。

これらのパラメータはGUIパネル上に設定され、シリアルタイムアウトでコードを書くよりもはるかに直感的です。ポイントは、“何回目の再送で正しいACKを受信したか”を視覚的に確認できることです。毎回3回目まで成功しない場合は、Communicationリンクに不安定な場所があり、ケーブルや干渉をトラブルシューティングする必要があります。

ATK-X COMを使用したModbus RTUの完全なデバッグプロセス

ステップ1：シリアルパラメータの設定

ATK-XCOM V3.0を開き、対応するCOMポートを選択します。ボーレートは9600（またはデバイスの実際のボーレート）、データビット8、ストップビット1、検証ビットなしまたは偶発チェックに設定されています。

“Open Serial”をクリック。ラインが正しく、デバイスの電源が入っている場合、ステータスバーにシリアルポートが開いていることが表示され、送受信バイト数は0から始まります。

ステップ2：Modbusクエリフレームの構築

スレーブアドレス01の保持レジスタ40001（アドレス0 x 0000）を読み込むと、1つのレジスタを読み込む。Rawフレーム（CRCを含まない）は：

01 03 00 00 00 01

“16進送信”にチェックを入れ、送信エリアに入力します。010300000001。プロトコルトランスポート設定でCRC16チェックをオンにすると、ATK-X COMは自動的にCRCを計算し、フレームの最後に2バイトを追加します（このフレームの場合、CRCは0 x 840Aで、送信されたフルフレームは01 03 00 00 00 01 84 0A）。送信してください。

ステップ3：リターンフレームのParse

デバイスが正常に応答すると、ATK-X COM受信エリアに16進数データが表示されます。標準的な応答フレームフォーマットは次のとおりです。

01 03 02 XX YY CRCL CRCH

その中で02データ領域のバイト数を表します（1つのレジスタを読み取ると2バイト）。XX YYはレジスタ値（上位バイト）です。

返された場合：

01 83 02 CRCL CRCH

関数コードは0 x 83になります。これは、元の関数コード0 x 0 3の最上位ビットが1に設定され、例外コード0 x 0 2が加算されます。Modbus例外コード0 x 0 2は、“不正なデータアドレス”を示します。つまり、要求したレジスタアドレスはこのスレーブにexistenceしません。

ステップ4：共通のModbusコマンドを複数の送信で管理する

“複数送信”領域に4つのページを作成します。

ページ1--クラスの読み取りコマンド

エントリ1 01030000001 →リードスレーブ01レジスタ40001（1个）
エントリ2 01030000004 →読み出しスレーブ局01レジスタ40001~40004（4个）
エントリ3 0103000A0001 →読み出しスレーブ01レジスタ40011（1个）
4

各エントリは独立して“16進送信”とCRC16チェックをチェックします。

ページ2 -クラスの書き込みコマンド

エントリ1 01060000001 →スレーブ01レジスタ40001=1
エントリ2 01060000000 →スレーブ01レジスタ40001=0
エントリ3 01100000001020001 →書き込みスレーブ01複数のレジスタ、開始0000、2バイト、値=0001

ページ3-放送と診断

エントリ1 00080000001 →放送（サブコード0001、通信再开）
エントリ2 00110000 →ブロードキャスト取得スレーブ局イベントカウンタ

ページ4 -バックアップのエクスポート

メニュー →エクスポート送信エントリ→ Excelファイルとして保存。その後、このファイルを直接インポートし、すべてのコマンドを1秒で復元します。

ATK-X COMと他のシリアルツールの位置づけ

ツールの3つのシナリオ：

• Modbus RTUの毎日のデバッグ、データの送受信と表示ATK-X COMの略。プロトコル転送モード内蔵CRC、複数の送信管理が便利で、スクリプトを書く必要がない。
• 自動バッチテスト、カスタムデータParse、TCP/MQTTチューニングが必要略称はLLCOM。Luaスクリプトの柔軟性はかけがえのないものですが、習得にはコストがかかります。
• 時折シリアルを使用して、いくつかのATコマンドを送信します。COMToolまたはSSCOM。軽量で、設定は不要です。

ATK-X COMは“プログラマブル万能ツール”ではなく“プロフェッショナルシリアルデバッグツールボックス”として位置づけられている。その設計哲学は、組込みエンジニアが最も一般的に使用するデバッグプロセスを固定機能にし、コードを書くことなく実行できるようにすることです。LLCOMはすべてのプログラマブル機能をあなたに開放し、あなたが望むことをすることができます-しかし、あなたがLuaを書くことを犠牲にして。

ATK-X COMは毎日の送受信と検証を行い、LLCOMは繰り返しOperationを自動化する必要があるタスクを行います。

VI.よくある質問

CRC16チェック結果と手動計算の不一致？2つのことを確認してください：1 '多項式が正しいこと-Modbus RTUは0 x A 001を使用します（IBM CRC-16の順多項式である0 x 80 0 5ではなく）。2)初期化は0 x FFFFである。ATK-X COMに組み込まれたCRC16はModbusプロトコルに厳密に準拠して実装されており、正しい結果はオンラインCRC計算機でクロス検証できます。

駅からの応答がない？3チェック：1ボーレートとチェックビットが一致しているかどうか。2)スレーブアドレスが正しいかどうか（デフォルトアドレスはベンダーごとに1または247のいずれかになります）。3)デバイスの電源が入っているかどうか-これは現場で最も一般的に無視され、多くの人がUSBを485に接続し、デバイスが電源を持っていると思うと、実際のデバイスは独立したDC電源を必要とします。

タイムスタンプが表示されない？ATK-X COMのタイムスタンプrnFrank Signsの略。受信したデータが純粋なModbus RTUバイナリフレームの場合0D 0Aタイムスタンプ機能は動作しません。Hex受信モードでタイムスタンプをオフにするか、相手のデータストリームに改行が含まれていることを確認することをお勧めします。

書類は半分で止まった？ターゲット·デバイスの受信バッファが十分であるかどうかを確認します。ファイル送信は連続バイトストリームであり、デバイスが速度に追いつかない場合（例えば、受信したバイトごとにFlashを書き込み、完了を待つなど）、送信側は自動的にスピンダウンしません。解決策は、送信ボーレートを下げるか、ファイルを小さなチャンクに分割し、複数の送信タイミング機能で分割することです。

ATK-X COMにはクールな新しいコンセプトはありません。その各機能は、デバッグ現場での組込みエンジニアの実際のニーズから来ています。プロトコル伝送は、デバイスが応答してエラーが発生し、どこが間違っているのかminからないため、複数の送信は、12以上のATコマンドが前後にあまりにも拷問的であるため、カスタムボーレートは、常にいくつかの非標準デバイスがあるためです。これが、“開発ボードから生まれたツールチーム”と“純粋なソフトウェアツールチーム”の最大の違いです。後者は設計され、前者は研削されます。

再び話す問題がある。