manufacture ​

版本信息 ​

1. 组件概述 ​

1.1 组件简介 ​

manufacture 组件负责BMC的DFT装备测试项管理、路由分发。该组件提供统一的装备命令管理机制，具体的测试项功能在对应的业务组件中实现。

1.2 解决什么问题 ​

manufacture 组件解决以下核心问题：

• 统一装备测试项的管理机制，屏蔽各业务组件测试逻辑的差异
• 提供统一的测试项查询、启动、停止与结果获取入口
• 支持获取部件版本信息
• 支持设置VGA前后使能命令
• 支持设置上下电次数和AC操作命令

1.3 核心功能 ​

• 装备测试项管理与路由分发：建立装备测试项路由表，将装备命令路由到相关业务组件。
• 装备测试项IPMI接口：提供测试项数目查询、详细信息查询、测试启动/停止、结果查询等命令（0x30 0x90 0x40 ~ 0x43）。
• 版本获取IPMI接口：获取板卡各种版本信息（0x30 0x90 0x08）。
• VGA前后使能切换：VGA前置/后置/默认模式切换（0x30 0x90 0x52）。
• 上下电次数与AC设置：强制上下电次数与AC操作设置（0x30 0x90 0x31）。

1.4 关键术语表 ​

1.5 外部交互边界图 ​

装备测试项执行时序图

2. API 使用说明与示例 ​

2.1 资源协作接口概览 ​

2.1.1 bmc.kepler.Manufacture ​

属性

方法

备注：

• Start、Stop 无返回值，测试进展通过 Status 属性维护：启动测试时将 Status 置为 Testing 或 Complete，停止测试时置为 Unstart。
• GetResult 的出参 Status 为枚举，取值为 Succeed（测试成功）、Failed（测试失败）、Non（不涉及结果查询）；出参 Description 为测试项描述字符串。
• Status 属性与 GetResult 方法配合使用，只有 Status 为 Complete 时装备组件才会调用 GetResult。

2.1.2 bmc.kepler.Manufacture.Status ​

装备模式状态接口，用于查询单板当前的装备模式与装备使能状态。

path: /bmc/kepler/Managers/:ManagerId/Manufacture

属性

2.1.3 bmc.kepler.Manufacture.Extension ​

装备扩展接口，用于Multihost场景下标识system编号。

属性

2.1.4 bmc.kepler.Manufacture.Simulate ​

属性

2.2 装备通用测试项IPMI命令 ​

功能说明 ​

通过IPMI命令对装备测试项进行查询、启动、停止与结果获取。测试类型（type）取值如下：

首发版本 ​

openUBMC 25.3.0

应用场景 ​

装备测试项执行。

参数说明 ​

调试示例 ​

① 查询测试项数目

命令模板：0x30 0x90 0x40 {type}，type来自上文测试类型表。

> ipmicmd -k "f 0 30 90 40 01 " smi 0
0f 31 00 90 00 12
>

返回 0x12，表示有0x12个自检项。

② 查询测试项的详细信息

命令格式：ipmitool raw 0x30 0x90 0x41 0x00 0x20 {type} {index}，index取自0~0x12。

> ipmicmd -k "f 0 30 90 41 00 20 01 01" smi 0
0f 31 00 90 00 (第一个字节起始处) 00 0b 01 00 00 00 00 46 6c 61 73 68 20 54 65 73 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
>

解析方式：

• 第0个字节：状态，通常成功为00
• 第1个字节：是否打印完全标志位，00表示打印没有结束，80表示返回打印结束
• 第2个字节：dftid，0x0b转为十进制为11，表示对Flash的测试
• 第3~6字节：slot
• 第7字节：device_num
• 第8字节及以后：测试项描述，可以使用ASCII转换工具查看信息

③ 启动测试

方式一：ipmitool raw 0x30 0x90 0x42 0x00 0x20 {type} 0x01 {index}，返回无报错即表明启动测试成功。

方式二：ipmitool raw 0x30 0x90 0x42 0x00 0x20 {type} 0x01 {dftid} {slot} {device_num}，输入来源为②获取到的dftid/slot/device_num。

举例启动Flash的测试：

> ipmicmd -k "f 0 30 90 42 00 20 01 01 01" smi 0
0f 31 00 90 00 80
>

返回 80 表示返回打印结束。

部分测试项需要传入参数（参数长度一般为1）：

• 方式一：ipmitool raw 0x30 0x90 0x42 0x00 0x20 {type} 0xa1 {index} {param}
• 方式二：ipmitool raw 0x30 0x90 0x42 0x00 0x20 {type} 0xe1 {dftid} {slot} {device_num} {param}

④ 查询测试项结果

方式一：ipmitool raw 0x30 0x90 0x43 0x00 0x20 {type} {index}

> ipmicmd -k "f 0 30 90 43 00 20 01 01" smi 0
0f 31 00 90 00 (第一个字节起始处) 00 00 0b 01 00 00 00 00 46 6c 61 73 68 20 54 65 73 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
>

解析方式：

• 第1个字节：是否打印完全标志位，00表示打印没有结束，80表示返回打印结束
• 第2个字节：00表示自检结果成功，01表示失败，ff表示不涉及
• 第3个字节：dftid，0x0b表示Flash
• 第4~7字节：slot
• 第8字节：device_num
• 第9字节及以后：测试项描述，可以使用ASCII转换工具查看信息

方式二：ipmitool raw 0x30 0x90 0x43 0x00 0x20 {type} {dftid} {slot} {device_num}

> ipmicmd -k "f 0 30 90 43 00 20 01 0b 01 00 00 00 00" smi 0
0f 31 00 90 00 (第一个字节起始处) 00 00 0b 01 00 00 00 00 46 6c 61 73 68 20 54 65 73 74 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
>

与方式一结果相同。

⑤ 停止测试

• 方式一：ipmitool raw 0x30 0x90 0x42 0x00 0x20 {type} 0x00 {index}，返回无报错即表明停止测试成功
• 方式二：ipmitool raw 0x30 0x90 0x42 0x00 0x20 {type} 0x00 {dftid} {slot} {device_num}

2.3 装备模式状态查询IPMI命令 ​

功能说明 ​

查询当前装备使能状态

首发版本 ​

openUBMC 25.3.0

应用场景 ​

判断单板当前是否处于装备模式及所处装备阶段，以决定可执行的装备操作。

参数说明 ​

命令格式：ipmitool raw 0x30 0x90 0x1f

返回值与异常 ​

调试示例 ​

> ipmitool raw 0x30 0x90 0x1f
00 01
>

2.4 版本获取IPMI命令 ​

功能说明 ​

用于装备脚本获取板卡的各种版本信息，包括MCU版本、PCB版本、CPLD版本、VRD版本、CSR版本、BMC版本等。

首发版本 ​

openUBMC 25.3.0

应用场景 ​

装备脚本查询板卡各部件版本信息，用于板卡识别与测试项选择。

参数说明 ​

命令格式：ipmitool raw 0x30 0x90 0x08 {fruid} {type} 0x00 0xf5

返回值与异常 ​

调试示例 ​

> ipmitool raw 0x30 0x90 0x08 0x00 0xff 0x00 0xf5
80 30 31
>

2.5 VGA前后使能IPMI命令 ​

功能说明 ​

装备阶段切换VGA显示接口（前置VGA / 后置VGA / 正常默认模式）。

首发版本 ​

openUBMC 25.3.0

应用场景 ​

设置VGA前后使能

参数说明 ​

命令格式：ipmitool raw 0x30 0x90 0x52 0x42 0x00 0x01 0x00 0x00 0x00 0x01 {Switch_cmd}

2.6 设置上下电次数和AC IPMI命令 ​

功能说明 ​

装备阶段设置强制上下电次数与AC操作。

参数说明 ​

命令格式：ipmitool raw 0x30 0x90 0x31 {type} {count}

3. 组件扩展案例 ​

3.1 扩展能力概述 ​

manufacture 组件对测试项本身只提供路由转发功能，测试项由各业务组件定义、配置并实现。业务组件通过实现 bmc.kepler.Manufacture 接口即可注册新的装备测试项，无需修改 manufacture 组件。

3.2 扩展点说明 ​

业务组件需实现的接口结构如下图所示：

该接口包含的属性和方法详见 2.1.1 bmc.kepler.Manufacture。

3.3 二次开发指导 ​

步骤一：定义测试项并配置CSR ​

以ADC电压测试项 Dft3V3Vlot 为例，除实现 bmc.kepler.Manufacture 外还需定义私有属性，CSR配置如下：

"Dft3V3Vlot_1": {
    "ItemName": "VCC 3.3V Test",
    "Type": 1,
    "Id": 20,
    "Slot": "${GroupId}",
    "DeviceNum": 2,
    "ProcessPeriod": 65535,
    "PrompteReady": "",
    "PrompteFinish": "",
    "VoltValue": "#/Accessor_Adc4STBVlot.Value",     #  关联到要测试的ADC寄存器
    "PowOnStandValue": 2700,                         #  上电时电压的基准值
    "PowOffStandValue": 0,                           #  下电时电压的基准值
    "HystValue": 108,                                #  电压浮动阈值，实际测量值在 基准值±浮动阈值
    "DevPowerStatus": "#/Accessor_PowerGd.Value"     #  当前上下电状态
}

步骤二：实现RPC方法 ​

伪代码如下：

local result = "Non"
function Start(obj){
    obj.Status = "Testing"
    -- 电压值测试，假设测试结果为成功
    result = "Succeed"
    obj.Status = "Complete"
}
function Stop(obj){
    obj.Status = "Unstart"
}
function GetResult(obj){
    return result, "vlot test ok"
}

验证方法 ​

1. 配置CSR并加载组件，确认测试项对象成功注册；
2. 调用 Start 启动测试，确认 Status 由 Unstart 变为 Testing，测试完成后变为 Complete；
3. 调用 GetResult 获取结果，确认返回 Succeed/Failed/Non 及描述信息；
4. 调用 Stop 停止测试，确认 Status 回到 Unstart。

注意事项 ​

• 只有 Status 为 Complete 时，GetResult 才会被 manufacture 组件调用；
• GetResult 的第一个返回值必须是 Succeed、Failed、Non 三者之一；
• CSR中除 Param 外的属性通常都来自CSR配置。

4. 日志说明 ​

4.1 一键日志收集 ​

4.2 关键日志信息 ​

5. 问题定界指南 ​

5.1 典型问题定界 ​

5.2 错误码速查表 ​

不涉及

5.3 调试方法 ​

开启调试日志 ​

busctl --user call bmc.kepler.manufacture /bmc/kepler/manufacture/MicroComponent bmc.kepler.MicroComponent.Debug SetDlogLevel a{ss}sy 0 debug 2

调试命令 ​

接口方法调试见文档 2. API 使用说明与示例

6. 常见问题解答 ​

Q1：启动装备测试项报错 ​

问题描述:

启动测试项时报错，如 Invalid data field in request。

处理方法:

• 查看manufacture组件调试日志是否出现 type_list is nil 错误日志，若出现说明组件未获取到全局测试项句柄
• （index方式启动场景）检查index是否匹配到正确的DFT对象
• 检查DFT对象是否上资源树，属性是否匹配
• 检查BMC装备能力是否被裁剪

Q2：装备测试项获取结果异常 ​

问题描述:

装备测试项获取结果失败，或数据不符合预期。

处理方法:

• 确认测试项 Status 已为 Complete，且 GetResult 第一个返回值为 Succeed/Failed/Non 之一。

Q3：装备模式状态查询异常 ​

问题描述:

装备模式状态查询失败。

处理方法:

• 确认对象路径 /bmc/kepler/Managers/:ManagerId/Manufacture 是否存在及服务是否正常。

Q4：读取部件版本为空 ​

问题描述:

IPMI命令读取部件版本，只返回80。

处理方法:

• 读取到部件版本号为空串，通常是因为未能根据FruId、VerType匹配到资源树对象。常见情况是某个对象的FruId经过BMC升级/重启等操作后发生改变，导致此前能查询成功的命令只返回空串。

附录 ​

附录A 参考资料 ​

附录B 修订记录 ​