Get Property Value Common Command
更新时间: 2025/06/26
在Gitcode上查看源码36h-查询属性值通用命令(Get-Property-Value-Common-Command)
修订记录
| openUBMC版本号 | 修订日期 | 修订内容 |
|---|---|---|
| 25.06 | 2025/06/26 | 初稿,新增命令详情 |
基本信息
功能说明
查询属性值通用命令。
权限
命令信息
请求信息
| 字节顺序 | 域取值说明 |
|---|---|
| NetFn | 30h |
| CMD | 93h |
| 1:3 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 |
| 4 | Sub command,子命令=36h |
| 5:6 | Function ID Parameter,见 表1 , LSB first |
| 7 | Get Information Count M,获取信息数目 |
| 8 | Required Data Length,要求的读取数据长度 |
| 9:10 | Read Offset,读取的数据偏移,从0开始, LSB first |
| 11:N | //datax:y x表示起始字节,y表示字节数 //指定对象索引 data1:2-Object Key ID, LSB first. 索引属性的信息号,如果对象没有索引属性则填0xffff,表示查询类的第一个对象,若索引属性信息号最高位为1(即:1xxxxxxx xxxxxxxxb)且不为0xffff,则表示查询该类与索引属性值(不是真正的索引属性,存在不唯一性)匹配的所有对象(即:多对象),否则,查询具有索引属性的第1个对象(即:单对象)。- 获取多对象的情况下,始终不支持属性帧拆分(如右图所示),即:一个属性值超长,需要跨多帧时,第一帧数据之后的帧数据前面不需要带头(即:三元组)。- 获取单对象情况下,始终支持属性帧拆分(如右图所示),即:每一帧数据前面都要带头(即:三元组)。 实际使用索引属性ID范围为(1~0x7ffe)。 data3:1-Reserved,统一填0。 data4:1-Object Key Length L,若Object Key ID填0xffff,则此处统一填1。 data5:L-Object Key Value,指定信息值作为对象索引值, 见 表1 , LSB first,若Object Key ID填0xffff,则此处统一填0。 //以下指定查询的信息号 data(5+L):2-information1 ID, LSB first data(5+L+2):2-information2 ID, LSB first …... data(5+L+2M-2):2-informationM ID, LSB first |
响应信息
| 字节顺序 | 域取值说明 |
|---|---|
| 1 | Completion Code |
| 2:4 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 |
| 5 | End of List,表示当前数据是否结束。当参数数据比较长的时候,可能需要分多次读取,通过此字段可以判断数据是否读完。 [7:1]: reserved [0]: End of list 0=last data 1=middle data |
| 6:N | //datax:y x表示起始字节,y表示字节数 //以下返回查询结果,包括信息号及信息值,当某个属性的值超长(一般指超过220个字节长度)时,该属性的值需要分帧返回,每一帧都要带上information ID、Reserved、information Length三元组。 data1:2-information1 ID, LSB first data3:1-information1 Type,详见 表1 。 data4:1-information1 Length L,信息获取不到时,长度返回为0,且不返回information1 Value。 data5:L-information1 Value,每一帧的数据都要求带上information ID、Reserved、information Length三元组,包括分帧时。 ...... dataX:2-informationM ID, LSB first data(X+2):1-informationM Type,详见 表1 。 data(X+3):1-informationM Length L ,信息获取不到时,长度返回为0,且不返回informationM Value。 data(X+4):L-informationM Value 说明: 当某个属性的值超长(一般指超过220个字节长度)时,该属性需要分帧返回,每一帧都要带上information ID、Reserved、information Length三元组。 |
命令样例
查询属性值通用命令
请求:
ipmicmd -k "0f 00 MM NN" smi 0响应:
0f MM NN附表1 Data Type Parameters
| 数据类型码 | 对应C数据类型 | 数据类型含义 |
|---|---|---|
| 121 | UINT8 | 无符号8位整型 范围:0~255 |
| 110 | INT16 | 有符号16位整型 范围:-32768 ~ 32767 |
| 113 | UINT16 | 无符号16位整型 范围:0 ~ 65535 |
| 105 | INT32 | 有符号32位整型 范围:-2147483648 ~ 2147483647 |
| 117 | UINT32 | 无符号32位整型 范围:0 ~ 4294967295 |
| 115 | char[] | 字符串 |