docs(ioboard): tighten shadow-register note and fix polarity item ref

Two comment-only follow-ups carried over from gate #33 (both deferred
by the reviewer to keep the accepted face frozen; no code, no size
impact - attestation restamped after a no-diff rebuild):

- Drivers/BSP/IOBOARD/README.md item 6: the "what I last asked for"
  gloss of the software shadow register is exact for the 9 relay/LED
  bits but not for bit6, which ioboard_do_get() reports as the
  driver-synthesised supply state. Qualify it in place and point at
  item 4 for the rule instead of restating it.
- test/host/ioboard/ioboard_test.c: the ACTIVE-level comment says the
  polarity fact lives in README section 6 item 7; it has always been
  item 5 (item 7 is the PE2/PE4 naming residue). This test is the
  polarity pin, so a wrong cross-ref here is the worst place to
  leave one.
This commit is contained in:
2026-11-18 19:41:24 +08:00
parent 6e0755f971
commit 50ee1b4402
3 changed files with 8 additions and 7 deletions
+1 -1
View File
@@ -370,7 +370,7 @@ static void di_polarity_macros_are_complementary(void)
/*
* 钉死当前实测极性:低电平有效。
* 这是**硬件事实**(用户口径 2026-11-16 + C 通道实测:ACTIVE 取 1U 时屏上全灭、
* 取 0U 时对应那一路亮),改它必须同时改 Drivers/BSP/IOBOARD/README.md 第 6 节第 7 条
* 取 0U 时对应那一路亮),改它必须同时改 Drivers/BSP/IOBOARD/README.md 第 6 节第 5 条
* 与本用例的注释,不能悄悄翻过来。本断言变红就是提醒走这条流程,不是要把它删掉。
*/
static void di_active_level_matches_documented_low(void)