功能简介 ​

主要负责BMC的dft装备测试项管理、路由分发。本组件提供统一的装备命令管理机制，具体的命令逻辑在对应的业务组件中实现。

关键特性 ​

• dft装备测试项管理、路由分发，以下为装备组件和其他组件配合工作的主要流程（测试序列图）

• ipmi获取组件版本

  • 用于装备脚本获取板卡的各种版本信息，包括mcu版本、pcb版本、cpld版本、vrd版本、csr版本、bmc版本等，关键目录：
  shell

  ├─lualib                                       
  │  └─external_interface
  │     └─ function_get_version.lua    # 用于从板卡对象、网卡对象、fru对象获取各种版本信息
  └─ ipmi_cmd
      └─ read_version_data.lua         # IPMI接口的具体实现

• 关键目录结构分析

  yaml

  manufacture: 
    manufacture_manufacture_app.lua     # 装备包裁剪部分的组件入口
  src:
    lualib: 
      device_chip:                    # vga接口的单独管理
      external_interface:             # 汇集其他组件信息提供统一获取接口
      ipmi_cmd:                       # ipmi命令的具体实现
      factory.lua                     # 全局对象句柄注册池
      manufacture.lua                 # 组件入口，包含ipmi注册、rpc注册、对象分发、组件初始化、组件关键线程
      manufacture_service.lua         # 完成装备路由表的建立和查询接口的封装

对外接口 ​

装备通用测试项ipmi ​

测试示例

①查询测试项数目

命令模板：0x30 0x90 0x40 type —— type来自上表

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

表示有 0x12 个自检项

②查询测试项的详细信息

查询方式为遍历查询 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 ，0b转为十六进制转换过来为11，表示对flash的测试

第3,4,5,6字节：slot

第7字节：device_num

第8到后面的字节：测试项描述，可以使用ascll转换工具查看信息

③启动测试

方式一：

raw 0x30 0x90 0x42 0x00 0x20 type 0x01 index

返回无报错即表明启动测试成功

方式二：

raw 0x30 0x90 0x42 0x00 0x20 type 0x01 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表示返回打印结束

其中存在特殊情况，一些测试项需要传入参数。传入参数时需要特殊情况

方式一：

raw 0x30 0x90 0x42 0x00 0x20 type 0xa1 index param（参数长度一般为1）

长度一般为1

方式二：

raw 0x30 0x90 0x42 0x00 0x20 type 0xe1 dftid slot device_num param（参数长度一般为1）

④查询测试项结果

方式一：

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 ，0b表示flash

第4,5,6,7字节：slot

第8字节：device_num

第9到后面的字节：测试项描述，可以使用ascll转换工具查看信息

方式二：

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
>

与方式一结果相同

⑤停止测试

方式一：

raw 0x30 0x90 0x42 0x00 0x20 type 0x00 index

返回无报错即表明启动测试成功

方式二：

raw 0x30 0x90 0x42 0x00 0x20 type 0x00 dftid slot device_num

版本获取ipmi ​

命令格式： 0x30 0x90 0x08 {fruid} {type} 0x00 0xff

返回值：80/00 版本字符串的每一位的Ascii码

type取值范围：

vga 前后使能命令ipmi ​

0x30 0x90 0x52 0x42 0x00 0x01 0x00 0x00 0x00 0x01 $

Swich_cmd取值范围 2：装备前置VGA

3：装备后置VGA

0：正常默认模式

ipmi:设置上下电次数和ac ​

0x30 0x90 0x31 {type}

type == 2 count == n 表示强制上下电n次

type == 3 表示ac

配置介绍 ​

• 装备组件对测试项本身只提供路由转发功能，测试项由各个相关组件定义、配置以及实现功能调用

• 组件需要实现的接口：

• 该接口包含以下属性和方法：

ItemName:             测试项名称
Type:                 测试项类型
Id:                   测试项id
Slot:                 测试项所在槽位（分组）
DeviceNum:            设备数量
ProcessPeriod:	      测试时长
PrompteReady: 	      测试前提示
PrompteFinish:        测试完成提示
Param:                测试参数
Status：              当前测试状态，取值"Complete","Testing","Unstart"

Start():                  启动测试
Stop():                   停止测试
GetResult():              获取测试结果。返回值：两个字符串。第一个字符串必须为枚举{"Succeed","Failed","Non"}中一个。第二个字符串为任意长提示字符

• 组件使用时通常做三件事：

  1. 定义测试项名称，实现 bmc.kepler.Manufacture 接口，并定义测试需要使用到的私有属性
  2. 实现测试方法注册，有如下规则： （1）Start/Stop 不需要返回值，通过维护Status状态来表示当前测试情况，启动测试时要将Status置为Testing或者Complete,结束测试时要置为Unstart （2）GetResult 有两个返回值，第一个为字符串，限制为这三个{"Succeed","Failed","Non"}，分别表示测试项成功、失败和不涉及结果查询。 第二个字符串为测试描述，可以返回提示语表示当前测试项的状况。 （3）Status和GetResult需要配合使用，GetResult只有在Status已经置为Complete时才可以被装备组件调用到。
  3. 配置测试项CSR，除了Param属性外的所有属性通常都来自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"
}