Open
[需求] 支持通过CSR配置GPIO管脚的初始电平状态 #828
chenshengfanAdd on  28 days ago
chenshengfan
chenshengfanCollaborators
28 days ago Create

所属版本 (id: version)

openUBMC main

版本分支 (id: branch)

简要说明 (id: summary)

支持在 Gpio 对象的 CSR 配置中指定 GPIO 管脚的初始电平状态。对象初始化时按配置将输出管脚设置为目标电平,避免上电/初始化阶段电平不确定;未配置时保持现有行为不变。需同时覆盖单管脚模式与 8bit 分组模式。

前置条件 (id: prerequisites)

  1. BMC 运行正常,GPIO 驱动正常加载。
  2. 目标 Gpio 对象已在 CSR 中定义,且管脚已正确映射。
  3. 目标管脚配置为输出方向(Direction=1),并明确期望的初始电平。

系统用户 (id: users)

硬件适配/驱动开发者、整机 CSR 配置人员、负责 GPIO 时序的测试人员。

主成功场景 (id: main_scenario)

  1. 在 CSR 中为 Gpio 对象配置输出方向及初始电平。
  2. devmon 创建并初始化 Gpio 对象时解析该配置。
  3. 驱动在对象对外可用前,将对应 GPIO 管脚设置为配置的初始电平。
  4. 后续业务读写按正常流程执行,初始电平保持稳定,不出现额外跳变。
  5. 未配置初始电平的既有 CSR 对象行为与当前版本保持一致。

非功能需求类型 (id: test_type)

兼容性影响评估 (id: compatibility_impact)

  1. 新增可选 CSR 配置项,未配置时不下发电平,保持现有行为,向后兼容。
  2. 不改变现有 Gpio 对象属性及 Bus 读/写接口语义。
  3. 需明确初始电平与 ReverseBit(输出极性反转)组合时的语义,避免不同产品理解不一致。
  4. 需兼容单管脚模式与 Id=0xFF 的 8bit 分组模式;分组模式下应支持按位配置或明确统一配置规则。

扩展场景(含异常场景) (id: extended_scenario)

  • 未配置初始电平:不主动写管脚,保持当前电平,不产生额外日志噪声。
  • 管脚方向为输入:忽略初始电平配置,并输出明确告警,避免误写输入管脚。
  • 初始电平取值非法(非 0/1 或超出字段范围):初始化返回明确错误或拒绝配置,并记录日志。
  • 管脚号无效、驱动初始化失败或写电平失败:记录清晰错误;分组模式下跳过无效管脚,不影响其他有效管脚。
  • 配置了 ReverseBit 输出极性反转:需明确初始电平是逻辑电平还是物理电平,并在配置文档与实现中保持一致。
  • 热插拔/对象重建场景:对象重新初始化时应重新应用 CSR 中的初始电平配置。

周边依赖 (id: dependencies)

  1. Gpio CSR 对象定义及属性反射(drivers/csr1/bus/gpio)。
  2. 内部 bus_gpio 初始化与读写实现(drivers/internal/bus/bus_gpio)。
  3. DRIVER_GPIO::Gpio 底层驱动接口。
  4. CSR schema/配置字典及 devmon 对象创建与初始化流程。

约束 (id: constraints)

  1. 初始电平必须在 Gpio 对象对外可用前完成设置,避免业务首次访问时出现电平跳变。
  2. 新增配置项必须为可选,未配置时不得改变现有电平与行为。
  3. 输出方向下修改初始电平生效;最后电平方向应与CSR配置一致。
  4. 只关注初始电平,不受ReserveBit影响。
  5. 只支持单管脚模式。
  6. 需补充 UT/DT 测试,覆盖配置成功、未配置、非法值、输入方向、分组模式。
likedislike
openUBMC-robotopenUBMC-robotCollaborators
28 days ago Added label: sig/sig-component-drivers
openUBMC-robot
openUBMC-robotCollaborators
28 days ago Comments:

欢迎来到 openUBMC 社区

Hey @chenshengfan , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 说明文档 或 论坛 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。您可以自助配置此仓库的 PR 合并规则,更多详情,请参阅机器人自助配置使用手册。

联系指引

有疑问可以联系 SIG: sig-component-drivers ,
维护者是: @dongyushan, @net_swift_wangchen, @sam_h1973, @u012924942, @weixin_37569011, @xiaoxinglxs ,
优秀贡献者是: @adellonzzy, @avery-j, @changxingOpenUBMC, @chenshengfan, @dli_bmc, @huangjiapei, @leessential, @net_swift_tianwen, @xiapengc1, @yelvsub .

likedislike
openUBMC-robot
openUBMC-robotCollaborators
28 days ago Comments:

Issue 工作流介绍

社区的需求和缺陷的工作流状态处于纳管中。

类型 上个状态 下个状态 评论命令 谁可以操作
需求 待办的 已接纳 /todo2accepted SIG组: sig-release-management (maintainer)
需求 已接纳 开发中 /accepted2developing 仓库成员角色: Maintainer, Committer, Contributor, Owner
需求 开发中 待验收 /developing2UAT 仓库成员角色: Maintainer, Committer, Contributor, Owner
需求 待验收 已完成 /UAT2done SIG组: sig-QA (maintainer,committer)
需求 待办的 已挂起 /todo2suspended SIG组: sig-release-management (maintainer)
需求 已挂起 已接纳 /suspended2accepted SIG组: sig-release-management (maintainer)
需求 待办的 已拒绝 /todo2rejected SIG组: sig-release-management (maintainer)
需求 已拒绝 已接纳 /rejected2accepted SIG组: sig-release-management (maintainer)
likedislike
chenshengfanchenshengfanCollaborators
28 days ago Modify description of issue
chenshengfanchenshengfanCollaborators
26 days ago associated Kanban: openUBMC 26.12需求看板
5 event messages are collapsed here。 See more
LlishengxiaoCollaborators
25 days ago Deleted associated pull request: 支持GPIO初始电平(CSR配置)
wangjianCollaborators
25 days ago Comments:

/todo2accepted

likedislike
openUBMC-robotopenUBMC-robotCollaborators
25 days ago changed custom state from 待办的 to 已接纳
liuyanyu09
liuyanyu09
23 days ago Comments:
liuyanyu09liuyanyu09
14 days ago Associated pull request
CchendanmingCollaborators
4 days ago Assign chendanming as responsible person, remove original responsible person: chenshengfan、weixin_37529026
chendanmingCollaborators
4 days ago Comments:

/accepted2developing

likedislike
openUBMC-robotopenUBMC-robotCollaborators
4 days ago changed custom state from 已接纳 to 开发中
chendanmingCollaborators
4 days ago Comments:

/developing2UAT

likedislike
openUBMC-robotopenUBMC-robotCollaborators
4 days ago changed custom state from 开发中 to 待验收