产品分类说明及其注意事项
不同产品支持的命令集合可能存在差异，即同一条命令非以上所有机型均支持。
【注意事项】子系统命名和划分
| 子系统中文名称 | 英文名称 | 备注 |
|---|---|---|
| 融合运维子系统 | om | 1、interface，包含北向接口（含web） 2、om，运维系统，在BMC领域的运维管理 |
| 多样硬件子系统 | hardware | hardware，硬件管理 |
| 能效管理子系统 | energy | energy，不呈现动词 |
| RAS故障管理子系统 | ras | ras，业界专用缩写，完整呈现故障管理领域功能 |
| 安全韧性子系统 | security | security，安全相关APP |
| 平台功能子系统 | bmc_core | bmc_core，BMC软件的基础核心功能 |
| 基础框架子系统 | framework | framework，与业务无关的纯软件框架 |
【注意事项】openUBMC四段式版本号规则
openUBMC 软件版本采用四段式编号，格式为 a.bb.cc.dd，各段含义为 MajorVer.MinorVer.releaseMajorVer.releaseMinorVer。
| 段 | 字段 | 编码方式 | 取值范围 | 规范来源 | 说明 |
|---|---|---|---|---|---|
| 第 1 段（a） | MajorVer | Binary encoded | 3–9 | IPMI 规范 | 主版本号 |
| 第 2 段（bb） | MinorVer | BCD encoded | 00–99 | IPMI 规范 | 次版本号，须保留前导 0，如 01 |
| 第 3 段（cc） | releaseMajorVer | BCD encoded | 00–99 | OEM 规范 | 发布主版本号，须保留前导 0 |
| 第 4 段（dd） | releaseMinorVer | BCD encoded | 00–97 | OEM 规范 | 发布次版本号，须保留前导 0；装备分离场景下对外呈现时会将本段值加 1。若商用版本号第 4 段已至 99，则装备版本号无法达到 100 |
示例：3.01.17.43 表示 MajorVer=3，MinorVer=01，releaseMajorVer=17，releaseMinorVer=43。对应 IPMI 响应中，四段版本号字节依次为 MajorVer（Binary encoded）、MinorVer（BCD encoded）、releaseMajorVer（BCD encoded）、releaseMinorVer（BCD encoded）；Get Component Properties 响应在 MinorVer 与 releaseMajorVer 之间还包含 2 字节 Board ID。
通过 IPMI 查询版本号时，各段按上述编码方式以字节依次返回（MajorVer 为 Binary encoded，其余三段为 BCD encoded）。例如 MinorVer 为 99 时，响应中对应字节为 0x99。查询命令示例（Get Component Properties，NetFn=0x2C，CMD=0x2F，selector=1/get_current_version）：
ipmitool raw 0x2C 0x2F 0x00 0x00 0x01【注意事项】接口申报责任人
总体原则：
1、由BMC软件实现的IPMI命令，优先由BMC侧申报议题评审。
2、由IMU软件实现的IPMI命令，优先由IMU侧申报议题评审。
例外场景：有一些特性，确实是某个领域看的比较全，或者是对应需求发起方，就让对应领域的责任人申报议题一起评审。
【注意事项】接口修改流程
步骤1、 “开发人员”获取最新的接口文档。
步骤2、 “开发人员”基于最新的文档，刷新修改或新增接口，并通过组内的SE审核（审核维度：接口完整性、接口需求满足度）。
步骤3、 “开发人员”找“接口文档看护SE”审核（审核维度：接口的合理性、通用性、兼容性），审核通过后提交SubPC评审。
步骤4、 SubPC评审通过后，“开发人员”将修改点和评审纪要邮件通知“接口文档看护SE”刷新。
【注意事项】IPMI接口修改常见问题checklist
1、设置、查询的内容，需要增加长度字段，如果超长内容，需要考虑分段读写。
2、不要漏了步骤4“SubPC评审通过后，“开发人员”将修改点和评审纪要邮件通知“接口文档看护SE”刷新”，测试会基于对外IPMI接口文档来验收，不更新对外IPMI文档，测试提单跟踪。
3、命令字定义，要避免与已有的IPMI冲突。
4、复用老版本命令，必须要考虑BMC全场景的兼容性，包括不限于：新老板、周边组件、工具、生产装备、现网场景等。
5、接口修改需要必须写清楚“修订记录”，包括：openUBMC软件版本、修改背景、时间、修改人。
6、IPMI命令若是特定机型专用命令，需要在“适用机型”中明确具体机型。
7、IPMI命令“使用实例”需要准确、可执行。