Merged
【20b15e225e482a9abbd258829acfdb32】支持GPIO初始电平(CSR配置) #425
【20b15e225e482a9abbd258829acfdb32】支持GPIO初始电平(CSR配置) #425
Merged
liuyanyu09Add on 25 days ago
Total: 3 files changed+16-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.2.147] - 2026-10-23
4+- fix(devmon): GPIO 模型新增 InitialLevel CSR 属性,支持配置管脚初始输出电平(0:低 1:高),仅 Direction 为输出且 Id!=255 的单管脚模式生效,不配置则不改变管脚电平
5+ 
3## [1.2.146] - 2026-10-216## [1.2.146] - 2026-10-21
4- fix(devmon): 适配安全GPIO控制JtagOverLocalBus场景下升级cpld7- fix(devmon): 适配安全GPIO控制JtagOverLocalBus场景下升级cpld
5## [1.2.145] - 2026-09-248## [1.2.145] - 2026-09-24
@@ -1640,6 +1640,18 @@
1640 "baseType": "U8",1640 "baseType": "U8",
1641 "description": "0: 不变 1: 比特反转"1641 "description": "0: 不变 1: 比特反转"
1642 },1642 },
1643+ "InitialLevel": {
1644+ "usage": [
1645+ "CSR"
1646+ ],
1647+ "baseType": "U8",
1648+ "enum": [
1649+ 0,
1650+ 1
1651+ ],
1652+ "default": 255,
OO
Oopenubmc-ci-bot24 days ago

💡 建议:default: 255 不在 enum: [0, 1] 取值范围内,建议与消费端确认哨兵值的校验边界

enum 限定了该属性的合法配置值为 0/1,但这里 default 使用了 255 作为「未配置」哨兵值。本文件中其他同时带 enum 与 default 的属性(如 I2c.Speed、Scanner.ScanEnabled、各 Status 字段),其 default 均在 enum 范围内;InitialLevel 是本文件中唯一 default 超出 enum 的属性。

这本身是可接受的「未配置哨兵」设计(PR 描述也已说明 255 表示不配置、不下发、不改变管脚电平),但若下游存在基于模型做 default ∈ enum 的一致性校验,这里会被判为非法值并导致对象初始化失败——这恰好与测试建议中「非法值导致初始化失败」的预期相冲突,可能造成误判。

修复建议:

  1. 若 255 仅作哨兵、不会被下发,建议在 description/文档中明确标注其为哨兵值、不参与枚举校验(当前描述已有此意,可补充更清晰说明);
  2. 或让校验侧对 default=255 的场景单独放行,避免把「未配置」误判为「非法配置」。

请与消费端(libsoc 驱动)确认 255 哨兵的校验边界。

likedislike
liuyanyu09
liuyanyu09
24 days ago Comments:
Oopenubmc-ci-bot24 days ago

补充已有讨论(default: 255 不在 enum: [0, 1] 范围内):本文件已有多处「255 作为未配置/无效哨兵值」的既有惯例,即 不设 enum:如 I2c.MultiIO(default:255,描述注明"配置为255的时候为无效值",无 enum)、LocalBus.Width / AddrOffset / Lale(default:255,无 enum)。这些字段用 description 描述合法取值,而不是用 enum 限制,从而避免枚举与默认值冲突。

新加的 InitialLevel 是此类字段中唯一同时声明 enum: [0,1] 和 default: 255 的,与该文件既有惯例不一致,下游若做 default \u2208 enum 一致性校验会被判为非法。

修复建议:

  1. 参照本文件既有惯例,去掉 enum,改为在 description 中说明合法取值范围(0:低 1:高;255:未配置),与 MultiIO/Width 等保持一致;或
  2. 保留 enum,但让校验侧对 default=255 哨兵单独放行,并确认消费端(libsoc 驱动)不因 255 与 enum 冲突而拒绝初始化。
likedislike
1653+ "description": "GPIO管脚初始输出电平,0:低 1:高;255:未配置(无效默认值);仅Direction为输出且单管脚模式(Id!=255)时生效;不配置则不改变管脚电平"
1654+ },
1643 "Bit0GpioNum": {1655 "Bit0GpioNum": {
1644 "usage": [1656 "usage": [
1645 "CSR"1657 "CSR"
@@ -2,7 +2,7 @@
2 "name": "devmon",2 "name": "devmon",
3 "type": "application",3 "type": "application",
4 "deployConfig": "",4 "deployConfig": "",
5- "version": "1.2.146",5+ "version": "1.2.147",
6 "license": "",6 "license": "",
7 "description": "",7 "description": "",
8 "options": {8 "options": {