docs(protocol): accuracy sweep across the protocol reference
Three-pass audit of docs/instantel_protocol_reference.md against CLAUDE.md and the minimateplus/ implementation. Closes long-standing discrepancies that had accumulated as the protocol understanding evolved month over month. Major corrections: - §2/§3: S3 frames terminate on bare ETX, not DLE+ETX; payload byte[1] is flags / byte[2] is SUB (was wrongly DLE/ADDR). - §4.2: probe responses do not carry data length; DATA_LENGTH is a per-SUB hardcoded constant. - §5.1: dropped stale duplicate "SUB 1C = TRIGGER CONFIG READ" row; SUB 0A lengths corrected from 0x30/0x26 to 0x46/0x2C. - §5.3: added the missing write-frame mechanics (BW_CMD-only doubling, DLE-aware checksum, offset = data[1]+2, ack format, SUB 71 chunk parameters). - §7.6.x: switched compliance-anchor convention from the unstable 10-byte form to the canonical 6-byte `\xbe\x80\x00\x00\x00\x00`; recording_mode confirmed at anchor−8 in both read and write (the prior anchor−3/−4 split caused anchor drift on write). Sample_rate at anchor−6, histogram_interval at anchor−4 (now ✅), record_time at anchor+6. Geo_range row added at channel_label+33. - §7.5b/§8: added the 10-byte sub_code=0x03 continuous-mode timestamp variant; peak vector sum location corrected from fixed offset 87 to label-relative tran_pos−12. - §7.7.2: SUB 1E/1F token byte at params[7], not params[6]. - §7.7.3: SUB 0A length disambiguation rewritten. - §7.8.4/§7.8.7: fi==9 skip marked FIXED; metadata-page TODO replaced with current decoder state. - §11: POLL example wire bytes corrected; SUB 5A row added to checksum table. - §13/§14: device-under-test updated to BE11529/S338.17; TCP Idle Timeout consistency fix (0→2 min); Data Forwarding Timeout units clarified. - §15 (renumbered from second §14): open-question entries already resolved in CLAUDE.md closed out. - Appendix D: extension taxonomy rewritten — extensions encode a timestamp (AB0T scheme), not recording mode. Navigation note added to §7 acknowledging the organic-growth duplicate section numbers (§7.5/§7.5b, §7.6, §7.7, §7.8, §7.9) and pointing readers to the canonical sections for each topic. https://claude.ai/code/session_019tWZybD94YUsBaEGhnM5A2
This commit is contained in:
Claude