Merged
【0fa36a86bd337d9cb60bacd05ce234f4】支持Gpio对象CSR初始电平(InitialLevel)配置 #9
【0fa36a86bd337d9cb60bacd05ce234f4】支持Gpio对象CSR初始电平(InitialLevel)配置 #9
Merged
liuyanyu09Add on 26 days ago
Total: 5 files changed+308-1
@@ -1,5 +1,8 @@
1# Changelog1# Changelog
2All notable changes to this project will be documented in this file.2All notable changes to this project will be documented in this file.
3+## [1.140.1] - 2026-10-21
4+GPIO 初始电平(InitialLevel)完善:仅输出方向单管脚模式(Id!=255)生效,输入方向忽略并告警(不校验取值),组模式不感知;未配置(含属性层无效默认值 0xFF)不下发,输出方向配置非法值或下发失败均记 error 日志并跳过下发(不阻断初始化)
5+ 
3## [1.140.0] - 2026-10-156## [1.140.0] - 2026-10-15
4修改依赖版本号7修改依赖版本号
5 8 
@@ -1,7 +1,7 @@
1{1{
2 "name": "runtime_accessor",2 "name": "runtime_accessor",
3 "type": "library",3 "type": "library",
4- "version": "1.140.0",4+ "version": "1.140.1",
5 "author": "Huawei",5 "author": "Huawei",
6 "license": "Mulan PSL v2",6 "license": "Mulan PSL v2",
7 "description": "runtime accessor component",7 "description": "runtime accessor component",
@@ -9,6 +9,7 @@
9-- See the Mulan PSL v2 for more details.9-- See the Mulan PSL v2 for more details.
10 10 
11local class = require('mc.class')11local class = require('mc.class')
12+local log = require('mc.logging')
12local stream = require('stream.base')13local stream = require('stream.base')
13local s_pack = string.pack14local s_pack = string.pack
14 15 
@@ -18,6 +19,9 @@ local INIT_GPIO_NUM = 0xff
18local REVERSE_BIT_READ = 0x0119local REVERSE_BIT_READ = 0x01
19local REVERSE_BIT_WRITE = 0x0220local REVERSE_BIT_WRITE = 0x02
20 21 
22+local GPIO_INVALID_LEVEL = 0xff
23+local GPIO_DIR_OUTPUT = 1
24+ 
21---@class gpio:stream25---@class gpio:stream
22local gpio = class(stream)26local gpio = class(stream)
23 27 
@@ -34,12 +38,46 @@ function gpio:ctor(property, bus_name)
34 self.group[6] = property.Bit5GpioNum or 038 self.group[6] = property.Bit5GpioNum or 0
35 self.group[7] = property.Bit6GpioNum or 039 self.group[7] = property.Bit6GpioNum or 0
36 self.group[8] = property.Bit7GpioNum or 040 self.group[8] = property.Bit7GpioNum or 0
41+ -- CSR 未配置时属性层回落无效默认值 0xFF(而非 nil),与 nil 一并视为未配置;
42+ -- 默认值可能以字符串形式回落(如 "255"/"0xFF"),先 tonumber 归一化再比较(与 init 口径一致)
43+ local initial_level = property.InitialLevel
44+ if tonumber(initial_level) == GPIO_INVALID_LEVEL then
O
Oopenubmc-ci-bot24 days ago

💡 建议:未配置默认值仅归一化 0xFF,空字符串等其余占位值会误触发 error 日志

ctor 中 if tonumber(initial_level) == GPIO_INVALID_LEVEL then initial_level = nil end 只归一化了 0xFF/255。若属性层以其它「未配置」占位值回落(如空字符串 "" / 纯空白),tonumber("") 为 nil,不等于 255,会被当作「已配置」保留下来;随后 init 内 tonumber("") 仍为 nil,非 0/1,落入 else 分支打印 log:error 'Invalid...',而同一「未配置」语义下 0xFF 却是静默不动作,行为不一致。

这虽与 CHANGELOG「未配置(含属性层无效默认值 0xFF)不下发」仅覆盖 0xFF 的口径一致,但既然这里已引入归一化逻辑,建议一并覆盖空串/空白等占位值,使所有「未配置」形态都静默不动作。

修复建议:归一化时把 nil 化扩展到所有无法解析为值的占位:

local raw = property.InitialLevel
local n = tonumber(raw)
if raw == nil or n == nil or n == GPIO_INVALID_LEVEL then
    initial_level = nil
else
    initial_level = raw
end

(或在 init 校验前统一先 tonumber,对 nil 结果同样走「未配置」静默路径,与下方 init 口径保持一致。)

likedislike
liuyanyu09
liuyanyu09
24 days ago Comments:
45+ initial_level = nil
46+ end
47+ self.initial_level = initial_level
37end48end
38 49 
39function gpio:init()50function gpio:init()
40 self.drv = stream.open_drive('libsoc_adapter.gpio')51 self.drv = stream.open_drive('libsoc_adapter.gpio')
41 if self.id ~= RW_GPIO_GROUP then52 if self.id ~= RW_GPIO_GROUP then
42 self.drv:init(self.id, self.direction)53 self.drv:init(self.id, self.direction)
54+ -- 设完方向后处理初始电平(逻辑值,走输出极化):仅输出脚且配置有效时下发;
55+ -- 输入脚无论配置什么都忽略并告警;配置异常只记 error 日志并跳过下发,
56+ -- 不抛错阻断初始化(否则该管脚所在流初始化失败,后续功能全部失效)
57+ if self.initial_level ~= nil then
O
Oopenubmc-ci-bot26 days ago

💡 建议:组模式(Id=255)下配置的 InitialLevel 会被静默忽略

self.initial_level 的校验与下发逻辑都放在非组分支(self.id ~= RW_GPIO_GROUP)内。当 GPIO 为组模式且配置了 InitialLevel 时,既不会校验也不会告警,配置被静默丢弃,与单管脚输入脚的 log:warn 提示不一致,排障时较难察觉。

修复建议:在组模式分支或校验入口,当 self.initial_level ~= nil 时给出一条 log:warn(如 'Gpio initial level ignored in group mode, id: %s')以保持可观测性。

likedislike
liuyanyu09
liuyanyu09
25 days ago Comments:
58+ if self.direction ~= GPIO_DIR_OUTPUT then
59+ log:warn('Gpio InitialLevel ignored for input pin, id: %s, level: %s', self.id, self.initial_level)
60+ else
61+ -- 配置层可能以字符串下发数值(如 "1"),tonumber 归一化后再校验
62+ local level = tonumber(self.initial_level)
63+ if level == 0 or level == 1 then
64+ if self.output_pol_reversal ~= 0 then
65+ level = (level == 0) and 1 or 0
66+ end
67+ local ok, err = pcall(self.drv.write, self.drv, self.id, level)
O
Oopenubmc-ci-bot24 days ago

💡 建议:PR 描述与实现关于「下发失败/非法值是否阻断初始化」不一致

PR 描述「修改方案」一节称:

  • 「非 0/1 直接失败」(非法值导致初始化失败)
  • 「下发失败使初始化失败」

但当前实现(本行起)是:配置非法值(else 分支)与下发失败(if not ok 分支)都是记 log:error 并跳过下发,并不阻断初始化 —— 与 CHANGELOG「均记 error 日志并跳过下发(不阻断初始化)」一致,test_write_failure_skipped / test_invalid_initial_level_skipped_* 等用例也据此断言。

「校验先于方向判断」那条 PR 描述虽已对齐,但这两句「直接失败」「使初始化失败」仍描述的是旧的阻断式行为,会误导审阅者对异常路径的预期。

修复建议:将 PR 描述改为与实现/CHANGELOG 一致,例如「非 0/1 或下发失败均记 error 日志并跳过下发,不阻断初始化」。

likedislike
liuyanyu09
liuyanyu09
24 days ago Comments:
68+ if not ok then
69+ -- 下发失败只记 error 日志,不抛错阻断初始化
70+ log:error('Gpio InitialLevel apply failed, id: %s, error: %s', self.id, err)
71+ end
72+ else
73+ log:error(
74+ 'Invalid Gpio InitialLevel, id: %s, level: %s, expect 0 or 1, skip applying',
75+ self.id,
76+ self.initial_level
77+ )
78+ end
79+ end
80+ end
43 else81 else
44 for i = 1, #self.group do82 for i = 1, #self.group do
45 if self.group[i] == self.direction then83 if self.group[i] == self.direction then
@@ -27,4 +27,5 @@ require('test_smc')
27require('test_hisport')27require('test_hisport')
28require('test_hisport2')28require('test_hisport2')
29require('test_jtag_over_hisport')29require('test_jtag_over_hisport')
30+require('test_gpio')
30os.exit(lu.LuaUnit.run())31os.exit(lu.LuaUnit.run())
@@ -0,0 +1,265 @@
1+-- Copyright (c) 2026 Huawei Technologies Co., Ltd.
2+-- openUBMC is licensed under Mulan PSL v2.
3+-- You can use this software according to the terms and conditions of the Mulan PSL v2.
4+-- You may obtain a copy of Mulan PSL v2 at:
5+-- http://license.coscl.org.cn/MulanPSL2
6+-- THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
7+-- EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
8+-- MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
9+-- See the Mulan PSL v2 for more details.
10+ 
11+local lu = require('luaunit')
12+local class = require('mc.class')
13+local log = require('mc.logging')
14+ 
15+-- 用最小桩替换 stream.base:保留 ctor(mc.class 会自动调用父类 ctor,self.id 由此设置),
16+-- 同时避免 unit 环境引入 stream.base 的额外依赖
17+local stream = class()
18+ 
19+function stream:ctor(property, bus_name)
20+ self.id = property.Id or 0
21+ self.bus_name = bus_name
22+end
23+ 
24+-- 注意:mc.class 的 new 在构造时会自动执行 pre_init/init,
25+-- 因此用例构造对象即触发被测逻辑,无需再显式调用 init;
26+-- 期望初始化失败的用例应对 gpio.new 做 pcall
27+local original_stream = package.loaded['stream.base']
28+local original_gpio = package.loaded['stream.gpio']
29+package.loaded['stream.base'] = stream
30+package.loaded['stream.gpio'] = nil
31+local gpio = require('stream.gpio')
32+package.loaded['stream.base'] = original_stream
33+package.loaded['stream.gpio'] = original_gpio
34+ 
35+TestGpio = {}
36+ 
37+local RW_GPIO_GROUP = 0xff
38+ 
39+function TestGpio:setUp()
40+ self.open_drive = stream.open_drive
41+ self.log_warn = log.warn
42+ self.log_error = log.error
43+ self.driver = {
44+ init_calls = {},
45+ write_calls = {},
46+ fail_write = false,
47+ }
48+ self.driver.init = function(drv, id, direction)
49+ drv.init_calls[#drv.init_calls + 1] = { id = id, direction = direction }
50+ end
51+ self.driver.read = function(drv, id, direction)
52+ return 0
53+ end
54+ self.driver.write = function(drv, id, level)
55+ drv.write_calls[#drv.write_calls + 1] = { id = id, level = level }
56+ if drv.fail_write then
57+ error('stub gpio write failed')
58+ end
59+ end
60+ stream.open_drive = function(driver_name)
61+ lu.assertEquals(driver_name, 'libsoc_adapter.gpio')
62+ return self.driver
63+ end
64+end
65+ 
66+-- log.warn/log.error 桩的恢复放在 tearDown 兜底:用例中途失败也不会污染后续用例
67+function TestGpio:tearDown()
68+ stream.open_drive = self.open_drive
69+ log.warn = self.log_warn
70+ log.error = self.log_error
71+end
72+ 
73+-- 配了 InitialLevel + 输出脚 → 下发一次
74+function TestGpio:test_initial_level_applied_when_configured_output()
75+ gpio.new({ Id = 5, Direction = 1, InitialLevel = 1 }, 'Gpio_1')
76+ 
77+ lu.assertEquals(#self.driver.write_calls, 1)
78+ lu.assertEquals(self.driver.write_calls[1].id, 5)
79+ lu.assertEquals(self.driver.write_calls[1].level, 1)
80+end
81+ 
82+-- 显式配置为 0 也要下发,以区别于「未配置」
83+function TestGpio:test_initial_level_zero_configured_still_writes()
84+ gpio.new({ Id = 5, Direction = 1, InitialLevel = 0 }, 'Gpio_1')
85+ 
86+ lu.assertEquals(#self.driver.write_calls, 1)
87+ lu.assertEquals(self.driver.write_calls[1].level, 0)
88+end
89+ 
90+-- 未配 → 完全不动作
91+function TestGpio:test_no_write_when_initial_level_absent()
92+ gpio.new({ Id = 5, Direction = 1 }, 'Gpio_1')
93+ 
94+ lu.assertEquals(#self.driver.write_calls, 0)
95+end
96+ 
97+-- 输入脚 → 跳过并告警,初始化本身成功
98+function TestGpio:test_no_write_for_input_pin()
O
Oopenubmc-ci-bot25 days ago

💡 建议:输入脚合法值用例未断言告警信息,与非法值用例不对称

test_no_write_for_input_pin(本行)仅断言 write_calls 为 0,未校验 log:warn 是否按设计发出;而同文件的 test_invalid_initial_level_ignored_for_input_pin(line 134)会用桩捕获 warned 并断言包含 'ignored for input pin'。两处同为"输入脚忽略初始电平",合法值分支缺少对告警的断言,覆盖不对称。

修复建议:参考非法值用例,在 test_no_write_for_input_pin 中同样用 log.warn 桩断言告警内容,例如:

local warned = {}
log.warn = function(_, fmt, ...) warned[#warned + 1] = string.format(fmt, ...) end
gpio.new({ Id = 5, Direction = 0, InitialLevel = 1 }, 'Gpio_1')
lu.assertStrContains(warned[1], 'ignored for input pin')
lu.assertEquals(#self.driver.write_calls, 0)
likedislike
liuyanyu09
liuyanyu09
25 days ago Comments:
99+ local warned = {}
100+ log.warn = function(_, fmt, ...)
101+ warned[#warned + 1] = string.format(fmt, ...)
102+ end
103+ 
104+ gpio.new({ Id = 5, Direction = 0, InitialLevel = 1 }, 'Gpio_1')
105+ 
106+ lu.assertEquals(#warned, 1)
107+ lu.assertStrContains(warned[1], 'ignored for input pin')
108+ lu.assertEquals(#self.driver.write_calls, 0)
109+end
110+ 
111+-- Direction 未配置时默认输入,不按 InitialLevel 修改电平
112+function TestGpio:test_no_write_when_direction_absent()
113+ gpio.new({ Id = 5, InitialLevel = 1 }, 'Gpio_1')
114+ 
115+ lu.assertEquals(#self.driver.write_calls, 0)
116+end
117+ 
118+-- 输出极化位 = 1 → 逻辑 1 写成物理 0
119+function TestGpio:test_initial_level_with_output_polarity_reversal()
O
Oopenubmc-ci-bot25 days ago

💡 建议:补充「显式 0 + 输出极化反转」的 UT 用例

当前测试分别覆盖了「显式 0 下发(无反转)」(test_initial_level_zero_configured_still_writes)与「反转 + 逻辑 1(→ 物理 0)」(test_initial_level_with_output_polarity_reversal),但没有组合 InitialLevel = 0 + ReverseBit(write 位)的场景,即期望物理电平为 1 的路径。

修复建议:新增用例断言 InitialLevel=0、ReverseBit=0x02 时 drv.write 收到的 level 为 1(level = (level==0) and 1 or 0),锁定显式 0 在反转分支下的语义,避免后续重构破坏该路径。

likedislike
liuyanyu09
liuyanyu09
25 days ago Comments:
120+ gpio.new({ Id = 5, Direction = 1, ReverseBit = 0x02, InitialLevel = 1 }, 'Gpio_1')
121+ 
122+ lu.assertEquals(#self.driver.write_calls, 1)
123+ lu.assertEquals(self.driver.write_calls[1].level, 0)
124+end
125+ 
126+-- 显式 0 + 输出极化反转 → 物理 1:锁定显式 0 在反转分支下的语义
127+function TestGpio:test_initial_level_zero_with_output_polarity_reversal()
128+ gpio.new({ Id = 5, Direction = 1, ReverseBit = 0x02, InitialLevel = 0 }, 'Gpio_1')
129+ 
130+ lu.assertEquals(#self.driver.write_calls, 1)
131+ lu.assertEquals(self.driver.write_calls[1].level, 1)
132+end
133+ 
134+-- CSR 未配置时属性层回落无效默认值 0xFF → 等价于未配置,静默不动作
135+function TestGpio:test_initial_level_invalid_default_ignored()
O
Oopenubmc-ci-bot24 days ago

💡 建议:补充「字符串形式无效默认值」用例,覆盖未配置静默语义

test_initial_level_invalid_default_ignored(本处)只覆盖了数值 0xFF。历史上多次指出:gpio.lua ctor 里 initial_level == GPIO_INVALID_LEVEL 仅能匹配数值,字符串形式的未配置默认值(如 "0xFF"/"255")会被当作「已配置」保留,随后 tonumber 归一化为 255、非 0/1,走 else 分支打印 log:error invalid —— 而同一种「未配置」在数值 0xFF 场景却是静默不动作,行为不一致。

本测试文件缺少对应用例,正是该缺陷长期未被 CI 拦截的原因。

修复建议:补充一组用例,锁定字符串默认值也必须静默不动作:

for _, level in ipairs({'0xFF', '255'}) do
    local warned, logged = {}, {}
    log.warn  = function(_, fmt, ...) warned[#warned+1] = string.format(fmt, ...) end
    log.error = function(_, fmt, ...) logged[#logged+1] = string.format(fmt, ...) end
    gpio.new({ Id = 5, Direction = 1, InitialLevel = level }, 'Gpio_1')
    lu.assertEquals(#warned, 0)
    lu.assertEquals(#logged, 0)
    lu.assertEquals(#self.driver.write_calls, 0)
end

(同时需在 gpio.lua ctor 统一 tonumber 口径后再比较,见既有 🚨 意见。)

likedislike
136+ local warned = {}
137+ log.warn = function(_, fmt, ...)
138+ warned[#warned + 1] = string.format(fmt, ...)
139+ end
140+ 
141+ gpio.new({ Id = 5, Direction = 1, InitialLevel = 0xff }, 'Gpio_1')
142+ 
143+ lu.assertEquals(#warned, 0)
144+ lu.assertEquals(#self.driver.write_calls, 0)
145+end
146+ 
147+-- 字符串形式回落无效默认值(如 "255")同样视为未配置:tonumber 归一化后匹配 0xFF,静默不动作
148+function TestGpio:test_initial_level_string_invalid_default_ignored()
149+ local logged = {}
150+ log.error = function(_, fmt, ...)
151+ logged[#logged + 1] = string.format(fmt, ...)
152+ end
153+ 
154+ gpio.new({ Id = 5, Direction = 1, InitialLevel = '255' }, 'Gpio_1')
155+ 
156+ lu.assertEquals(#logged, 0)
157+ lu.assertEquals(#self.driver.write_calls, 0)
158+end
159+ 
160+-- 十六进制字符串 "0xFF" 同样归一化为 255 并视为未配置
161+function TestGpio:test_initial_level_hex_string_invalid_default_ignored()
162+ local logged = {}
163+ log.error = function(_, fmt, ...)
164+ logged[#logged + 1] = string.format(fmt, ...)
165+ end
166+ 
167+ gpio.new({ Id = 5, Direction = 1, InitialLevel = '0xFF' }, 'Gpio_1')
168+ 
169+ lu.assertEquals(#logged, 0)
170+ lu.assertEquals(#self.driver.write_calls, 0)
171+end
172+ 
173+-- 配置层以字符串下发数值(如 "1")→ tonumber 归一化后正常下发
174+function TestGpio:test_initial_level_string_value_normalized()
O
Oopenubmc-ci-bot25 days ago

💡 建议:补充字符串数值 "0" 的下发用例

test_initial_level_string_value_normalized 覆盖了字符串 "1" 经 tonumber 归一化后下发,但字符串 "0" 是一条不同的路径:apply_level and tonumber(self.initial_level) or nil 依赖 Lua 中 0 为真值才能被保留(而非被 or nil 吞掉)。当前用例若改为 InitialLevel = 0 只能锁定数值 0 路径,无法锁定字符串 "0" 的归一化路径。

修复建议:新增用例,断言 InitialLevel='0'、输出脚下发 level 为 0,锁定字符串零经归一化后仍能正确下发(区别于未配置)。

likedislike
175+ gpio.new({ Id = 5, Direction = 1, InitialLevel = '1' }, 'Gpio_1')
176+ 
177+ lu.assertEquals(#self.driver.write_calls, 1)
178+ lu.assertEquals(self.driver.write_calls[1].level, 1)
179+end
180+ 
181+-- 字符串 "0" 归一化后按数值 0 下发(区别于未配置;锁定 tonumber("0")→0 真值路径)
182+function TestGpio:test_initial_level_string_zero_normalized()
183+ gpio.new({ Id = 5, Direction = 1, InitialLevel = '0' }, 'Gpio_1')
184+ 
185+ lu.assertEquals(#self.driver.write_calls, 1)
186+ lu.assertEquals(self.driver.write_calls[1].level, 0)
187+end
188+ 
189+-- 非数值字符串归一化失败 → 按非法值处理,记 error 日志并跳过下发
190+function TestGpio:test_initial_level_non_numeric_string_skipped()
191+ local logged = {}
192+ log.error = function(_, fmt, ...)
193+ logged[#logged + 1] = string.format(fmt, ...)
194+ end
195+ 
196+ gpio.new({ Id = 5, Direction = 1, InitialLevel = 'abc' }, 'Gpio_1')
197+ 
198+ lu.assertEquals(#logged, 1)
199+ lu.assertStrContains(logged[1], 'Invalid')
200+ lu.assertEquals(#self.driver.write_calls, 0)
201+end
202+ 
203+-- 非法值(非 0/1)→ 记 error 日志并跳过下发,不阻断初始化
204+function TestGpio:test_invalid_initial_level_skipped_for_output_pin()
205+ local logged = {}
206+ log.error = function(_, fmt, ...)
207+ logged[#logged + 1] = string.format(fmt, ...)
208+ end
209+ 
210+ gpio.new({ Id = 5, Direction = 1, InitialLevel = 0x03 }, 'Gpio_1')
211+ 
212+ lu.assertEquals(#logged, 1)
213+ lu.assertStrContains(logged[1], 'Invalid')
214+ lu.assertEquals(#self.driver.write_calls, 0)
215+end
216+ 
217+-- 输入脚无论 InitialLevel 合法与否都忽略:非法值不阻断初始化,仅告警、不下发
218+function TestGpio:test_invalid_initial_level_ignored_for_input_pin()
219+ local warned = {}
220+ log.warn = function(_, fmt, ...)
O
Oopenubmc-ci-bot25 days ago

💡 建议:log.warn 的覆盖仅在断言通过后恢复,断言失败会污染后续用例

此处先 log.warn = function(_, fmt, ...) ... end,随后才执行断言,最后 log.warn = original_warn 恢复。若中间任一断言失败,log.warn 保持被覆盖,tearDown 也不恢复,会顺带影响其后的测试用例(如其它依赖 log.warn 的用例断言会被改变)。

修复建议:用 try/finally(或 pcall + 恢复)保证无论断言成败都恢复 log.warn,例如:

local original_warn = log.warn
local ok = pcall(function()
    log.warn = function(_, fmt, ...) warned[#warned + 1] = string.format(fmt, ...) end
    gpio.new({ Id = 5, Direction = 0, InitialLevel = 0x03 }, 'Gpio_1')
end)
log.warn = original_warn
lu.assertFalse(not ok)

同文件 test_group_mode_ignores_initial_level_silently(约 149-156 行)存在同样问题。

likedislike
liuyanyu09
liuyanyu09
25 days ago Comments:
221+ warned[#warned + 1] = string.format(fmt, ...)
222+ end
223+ 
224+ gpio.new({ Id = 5, Direction = 0, InitialLevel = 0x03 }, 'Gpio_1')
225+ 
226+ lu.assertEquals(#warned, 1)
227+ lu.assertStrContains(warned[1], 'ignored for input pin')
228+ lu.assertEquals(#self.driver.write_calls, 0)
229+end
230+ 
231+-- 组模式(Id == 255)不解析 InitialLevel:不产生写操作
232+function TestGpio:test_no_write_in_group_mode()
233+ gpio.new({ Id = RW_GPIO_GROUP, Direction = 1, InitialLevel = 1, Bit0GpioNum = 10, Bit1GpioNum = 11 }, 'Gpio_1')
234+ 
235+ lu.assertEquals(#self.driver.write_calls, 0)
236+end
237+ 
238+-- 组模式(Id == 255)静默忽略 InitialLevel:不告警、不产生写操作
239+function TestGpio:test_group_mode_ignores_initial_level_silently()
240+ local warned = {}
241+ log.warn = function(_, fmt, ...)
242+ warned[#warned + 1] = string.format(fmt, ...)
243+ end
244+ 
245+ gpio.new({ Id = RW_GPIO_GROUP, Direction = 1, InitialLevel = 1, Bit0GpioNum = 10, Bit1GpioNum = 11 }, 'Gpio_1')
246+ 
247+ lu.assertEquals(#warned, 0)
248+ lu.assertEquals(#self.driver.write_calls, 0)
249+end
250+ 
251+-- 下发失败(硬件写失败)→ 记 error 日志,不阻断初始化
252+function TestGpio:test_write_failure_skipped()
253+ self.driver.fail_write = true
254+ 
255+ local logged = {}
256+ log.error = function(_, fmt, ...)
257+ logged[#logged + 1] = string.format(fmt, ...)
258+ end
259+ 
260+ gpio.new({ Id = 5, Direction = 1, InitialLevel = 1 }, 'Gpio_1')
261+ 
262+ lu.assertEquals(#logged, 1)
263+ lu.assertStrContains(logged[1], 'apply failed')
264+ lu.assertEquals(#self.driver.write_calls, 1) -- 尝试下发过一次
265+end