doc:jroboplc:modules:jrbustcp-eng

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
doc:jroboplc:modules:jrbustcp-eng [2026/01/21 20:04] – denisdoc:jroboplc:modules:jrbustcp-eng [2026/01/21 20:06] (current) – denis
Line 92: Line 92:
 Initializes tag list and session parameters. Initializes tag list and session parameters.
  
-==== Request ==== <code>+==== Request ====  
 +<code>
 cmd        : 0x01 cmd        : 0x01
 flen       : 1 byte flen       : 1 byte
Line 107: Line 108:
   * b3: Include tags with `hidden` flag   * b3: Include tags with `hidden` flag
  
-==== Response ==== <code>+==== Response ====  
 +<code>
 cmd        : 0x81 cmd        : 0x81
 listsize   : 3 bytes (uint24) </code> listsize   : 3 bytes (uint24) </code>
Line 119: Line 121:
 Retrieves tag metadata in chunks. Retrieves tag metadata in chunks.
  
-==== Request ==== <code>+==== Request ====  
 +<code>
 cmd   : 0x02 cmd   : 0x02
 index : 3 bytes (uint24) </code> index : 3 bytes (uint24) </code>
  
-==== Response ==== <code>+==== Response ====  
 +<code>
 cmd      : 0x82 cmd      : 0x82
 index    : 3 bytes index    : 3 bytes
Line 130: Line 134:
 [tag entries] </code> [tag entries] </code>
  
-==== Tag Entry Format ==== <code>+==== Tag Entry Format ====  
 +<code>
 type    : 1 byte type    : 1 byte
 nlen    : 1 byte nlen    : 1 byte
Line 151: Line 156:
 Checks for tag value changes. Checks for tag value changes.
  
-==== Request ==== <code>+==== Request ====  
 +<code>
 cmd : 0x03 </code> cmd : 0x03 </code>
  
-==== Response ==== <code>+==== Response ====  
 +<code>
 cmd        : 0x83 cmd        : 0x83
 quantity   : 3 bytes quantity   : 3 bytes
Line 169: Line 176:
 Reads tag values. Reads tag values.
  
-==== Request ==== <code>+==== Request ====  
 +<code>
 cmd   : 0x04 cmd   : 0x04
 index : 3 bytes </code> index : 3 bytes </code>
  
-==== Response ==== <code>+==== Response ====  
 +<code>
 cmd      : 0x84 cmd      : 0x84
 index    : 3 bytes index    : 3 bytes
Line 210: Line 219:
 Writes tag values. Writes tag values.
  
-==== Request ==== <code>+==== Request ====  
 +<code>
 cmd      : 0x05 cmd      : 0x05
 index    : 3 bytes index    : 3 bytes
Line 216: Line 226:
 [data blocks] </code> [data blocks] </code>
  
-==== Response ==== <code>+==== Response ====  
 +<code>
 cmd : 0x85 </code> cmd : 0x85 </code>
  
Line 225: Line 236:
 Returns CRC32 checksum of all tag values after last UPDATE. Returns CRC32 checksum of all tag values after last UPDATE.
  
-==== Request ==== <code>+==== Request ====  
 +<code>
 cmd : 0x06 </code> cmd : 0x06 </code>
  
-==== Response ==== <code>+==== Response ====  
 +<code>
 cmd : 0x86 cmd : 0x86
 crc : 4 bytes </code> crc : 4 bytes </code>
Line 236: Line 249:
 ===== 11. Authentication ===== ===== 11. Authentication =====
  
-==== AUTH_INIT (0x07) ==== <code>+==== AUTH_INIT (0x07) ====  
 +<code>
 request: request:
 cmd      : 0x07 cmd      : 0x07
Line 254: Line 268:
   * 0x02 DISABLED   * 0x02 DISABLED
  
-==== AUTH_SUBMIT (0x08) ==== <code>+==== AUTH_SUBMIT (0x08) ====  
 +<code>
 request: request:
 cmd      : 0x08 cmd      : 0x08
Line 280: Line 295:
 ===== 13. Session Lifecycle ===== ===== 13. Session Lifecycle =====
  
-1. TCP connect +  1. TCP connect 
-2. AUTH_INIT / AUTH_SUBMIT (optional) +  2. AUTH_INIT / AUTH_SUBMIT (optional) 
-3. INIT +  3. INIT 
-4. LIST (paged) +  4. LIST (paged) 
-5. UPDATE +  5. UPDATE 
-6. READ / WRITE +  6. READ / WRITE 
-7. CRC (optional) +  7. CRC (optional) 
-8. TCP disconnect+  8. TCP disconnect
  
 --- ---
Line 308: Line 323:
 ===== 16. Diagrams ===== ===== 16. Diagrams =====
  
-==== 16.1 Typical Session Sequence ==== <code>+==== 16.1 Typical Session Sequence ====  
 +<code>
 Client                          Server Client                          Server
 |                                 | |                                 |
Line 330: Line 346:
 |                                 | </code> |                                 | </code>
  
-==== 16.2 Binary Layout: READ Response ==== <code>+==== 16.2 Binary Layout: READ Response ====  
 +<code>
 +---------+------+---------+-----------+-----------+----------------+ +---------+------+---------+-----------+-----------+----------------+
 | reqId   | cmd  | index   | quantity  | next      | data blocks    | | reqId   | cmd  | index   | quantity  | next      | data blocks    |
Line 336: Line 353:
 +---------+------+---------+-----------+-----------+----------------+ </code> +---------+------+---------+-----------+-----------+----------------+ </code>
  
-==== 16.3 Binary Layout: WRITE Request ==== <code>+==== 16.3 Binary Layout: WRITE Request ====  
 +<code>
 +---------+------+---------+-----------+----------------+ +---------+------+---------+-----------+----------------+
 | reqId   | cmd  | index   | quantity  | data blocks    | | reqId   | cmd  | index   | quantity  | data blocks    |
Line 364: Line 382:
 ===== Appendix A: Examples ===== ===== Appendix A: Examples =====
  
-==== A.1 INIT Request (hex dump) ==== <code>+==== A.1 INIT Request (hex dump) ====  
 +<code>
 00 1A AB CD 00 00 00 01 01 00 1A AB CD 00 00 00 01 01
 05 2E 2A 00 06 4A 52 6F 62 6F 05 2E 2A 00 06 4A 52 6F 62 6F
Line 370: Line 389:
 A1 B2 C3 D4 </code> A1 B2 C3 D4 </code>
  
-==== A.2 READ Response (single INT32 value) ==== <code>+==== A.2 READ Response (single INT32 value) ====  
 +<code>
 00 14 AB CD 00 00 00 05 84 00 14 AB CD 00 00 00 05 84
 00 00 01 00 00 01 00 00 00 00 00 01 00 00 01 00 00 00
  • doc/jroboplc/modules/jrbustcp-eng.1769015044.txt.gz
  • Last modified: 2026/01/21 20:04
  • by denis