seismo-relay

serversdown/seismo-relay

Fork 0

Author	SHA1	Message	Date
serversdown	beca5de06e	docs: clean up and verify s3 protocol docs	2026-05-20 17:55:02 +00:00
Claude	8316a1bbd8	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	2026-05-20 15:41:42 +00:00

Author

SHA1

Message

Date

serversdown

beca5de06e

docs: clean up and verify s3 protocol docs

2026-05-20 17:55:02 +00:00

Claude

8316a1bbd8

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

2026-05-20 15:41:42 +00:00

1 changed files with 523 additions and 205 deletions

docs/instantel_protocol_reference.md

+518 -200

View File

File diff suppressed because it is too large Load Diff

Compare commits

2 Commits

d85df4c886 .. beca5de06e

Compare commits

2 Commits d85df4c886 .. beca5de06e

2 Commits

d85df4c886 .. beca5de06e