Skip to content

Spec consistency follow-ups: discovery set, read routing, temp scale#8

Merged
lkasso merged 1 commit into
mainfrom
lkasso/spec-consistency-followups
Jun 13, 2026
Merged

Spec consistency follow-ups: discovery set, read routing, temp scale#8
lkasso merged 1 commit into
mainfrom
lkasso/spec-consistency-followups

Conversation

@lkasso

@lkasso lkasso commented Jun 13, 2026

Copy link
Copy Markdown
Member

Summary

Follow-up review pass closing the remaining cross-references that still disagreed after the contradiction batch (PR #7):

  • Module discovery renamed to the SDK discovery set; states it is not "all active modules" — it legacy-probes the deprecated iBeacon (0x07) and Humidity (0x16) while omitting NeoPixel/ANCS/GSR/Color/Proximity. Matching note added under the discovery-order list.
  • Board-init step now distinguishes present (full info) vs absent (bare [opcode, 0x80]) responses.
  • Data-processor src_reg: "(not OR'd with 0x80)" was wrong for read-based sources → streaming = plain register, read-based = loud-read form (0x81/0x86/0x87).
  • Bit-6 packet note: silent reads feed logger triggers only; processors are fed by loud reads.
  • Temperature: dropped the "backend-driver specific" hedge (all channels are channel + int16/8); fixed the intro table's "2 byte Address" → one byte.
  • Macro cmd_byte2..cmd_byteN-2 notation clarified to "all remaining bytes."

mkdocs build --strict passes.

🤖 Generated with Claude Code

Follow-up review pass closing the remaining cross-references that still
disagreed after the contradiction batch:

- Module discovery: renamed to the "SDK discovery set" and stated it is
  not "all active modules" — it legacy-probes the deprecated iBeacon
  (0x07) and Humidity (0x16) opcodes while omitting NeoPixel/ANCS/GSR/
  Color/Proximity; added a matching note under the discovery-order list.
- Board-init step now distinguishes present (full info) from absent
  (bare [opcode, 0x80]) responses, consistent with the discovery rule.
- Data-processor src_reg: "(not OR'd with 0x80)" was wrong for read-based
  sources; now spells out streaming = plain register, read-based =
  loud-read form (0x81/0x86/0x87).
- Bit-6 packet note: silent reads feed LOGGER TRIGGERS only; data
  processors are fed by loud reads (was "loggers and data processors").
- Temperature: removed the unjustified "data format may be backend-driver
  specific" hedge — all channels use channel + int16/8 (0.125 C);
  corrected the introductory table's "2 byte Address" to one byte.
- Macro ADD_PARTIAL/ADD_COMMAND split: clarified the ambiguous
  cmd_byte2..cmd_byteN-2 notation to "all remaining bytes."

mkdocs build --strict passes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lkasso lkasso merged commit 88b667f into main Jun 13, 2026
2 checks passed
@lkasso lkasso deleted the lkasso/spec-consistency-followups branch June 14, 2026 03:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant