差分

このページの2つのバージョン間の差分を表示します。

--- desktop_station_s_serial_communication_specification [2016/04/30 07:22] – [Parameter meaning] yaasan
+++ desktop_station_s_serial_communication_specification [2025/08/15 07:39] (現在) – [How to use this topic] yaasan
@@ 行 3: / 行 3: @@
 ===== How to use this topic =====
-This topic describes in Desktop Station's serial communication specification. DSGatewayLib's example (e.g. DSgateway, DSmainRx) supports this specification to communicate with Desktop Station.
+このページでは、Windows上で動作するDesktop Station Softwareと、DSmainシリーズ,DSairLite, DSair2や、DSshield2装着済みArduino UNO R4 Minimaに専用スケッチを書き込んだものと、シリアル通信で指令を送る際のコマンド体系を解説しています。この解説を元に、WindowsやMacでオリジナルのソフトを作って、デスクトップステーションのコマンドステーション製品を自由に制御できます。
-このページでは、Windows上で動作するDesktop Station Softwareと、DSmainR5や、DCC/MM2シールド装着済みArduinoUNOにDSGatewayを書き込んだものと、シリアル通信で指令を送る際のコマンド体系を解説しています。この解説を元に、WindowsやMacでオリジナルのソフトを作って、DSmainなどを自由に制御できます。
 ===== How to communicate =====
@@ 行 22: / 行 20: @@
 コマンドの構造は、「コマンド名(引数1,引数2,・・・)\n」となっています。命令の最後はLF(改行コード)を必ず付けてください。大文字小文字を考慮します。
+コマンドを送る場合、200 Okの応答からウェイトを最低100ms以上置いてください。内部で処理を行ってDCCパルス生成器を確実に動作させるために必要です。
 ===== Command list =====
 ^Commands ^ Parameters ^ examples ^
+|setPing| none | setPing()\n|
 |setPower| Power on/off | setPower(1)\n|
 |setLocoSpeed| Locomotive address, Speed, (Speed Step)| setLocoSpeed(5,100,2)\n |
@@ 行 32: / 行 33: @@
 |getS88| S88 decoder count | getS88(2)\n |
 |setLocoConfig| CV Address, CV No, CV Value | setLocoConfig(49152,1,3)\n |
+|getLocoConfig| CV Address, CV No | getLocoConfig(49152,1)\n |
 ===== Parameter meaning =====
@@ 行 47: / 行 49: @@
 |S88 decoder count | 0-32 | Set connected S88 decoder count.|
 |CV Address| 0 or 49152 | Set 0 (MM2, under developing) or 49152 (DCC).|
-|CV No | 0-255 | Locomotive's CV number |
+|CV No | 0-1023| Locomotive's CV number |
 |CV Value | 0-255 | Locomotive's CV Value |
+以下のテーブルは、ロコとポイントのアドレス(1-65535)の意味をあらわしてます。\\
 The following table describes Locomotive's and Accessory's address meaning.
@@ 行 67: / 行 70: @@
 |302 receive timeout | Command is not received fully in the enough time. |
 |303 Unknown error | Unknown issue happens. |
+|@PWR,SWITCH,| 電源操作されて発生する状態変化通知|
+|@DIR,XX,YY,DIR,| 進行方向操作されて発生する状態変化通知 |
+|@FNC,XX,YY,NO,SWITCH,| ファンクション操作されて発生する状態変化通知|
+|@ACC,AA,BB,DIR,|ポイント操作されて発生する状態変化通知|
+|@SPD,XX,YY,SPD_H,SPD_L,|速度操作されて発生する状態変化通知|
+===== Communication procedure =====
+  - Initialization of serial port.
+  - Set baudrate 115200bps and FIFO configuration(if needed).
+  - Open serial port
+  - Reset serial port(Use DTR).
+  - Wait for receiving a message "100 Ready".
+  - After received "100 ready", you can send commands.
+  - Firstly you need to send "setPower(1)".
+  - The output of track is available. Send commands which you want.
 ===== Example of communication log =====
+以下は、通信ログの例です。setPing()を投げて生存確認をしてから、setPower(1)で線路電源のON、そのあとはコマンドを打てばその通りにDCC信号が出力されます。
 <code>
-[RECV]200 Ok
+[RECV]100 Ready
 [SEND] setPing()
 [RECV]200 Ok
@@ 行 108: / 行 129: @@
 [RECV]200 Ok
 </code>
+===== 外部操作の注意点 =====
+  * 本体でDCC電源のON/OFFを操作された場合、本体側の操作が優先されます。@PWRで操作状態が応答されますので、その値を見て制御を行ってください。
+  * 本仕様書は随時更新されます。また、予告なしに仕様が変更される場合があります。
+  * 本仕様書に記載の事項で、自動運転装置をビジネス・業務としてインテグレーションすることは自由ですが、当社は一切の動作保証、環境に起因するサポートをいたしません。ビジネス・業務用途での個別サポートを要求される場合には、サポート契約を申し込みください。サポート契約外のサポートについては一切お断りいたします。