Get Device Info
更新时间： 2026/08/06
在Gitcode上查看源码Get Device Info
Change History
| openUBMC Version | Revision Date | Description |
|---|---|---|
| 25.06 | 2025/06/26 | Initial draft: add command details |
Basic Information
Function Description
This API is used to obtain device information.
Privilege
Command Information
Request Information
| Byte | Data Field |
|---|---|
| NetFn | 30h |
| CMD | 93h |
| 1:3 | Manufacturer ID, LS Byte first. The length is fixed to three bytes. For example, if the vendor ID is 2011 and the corresponding hexadecimal value is 0x0007DB, the first byte is DBh, the second byte is 07h, and the third byte is 00h. |
| 4 | Sub command, sub command = 0x27h |
| 5 | Device type parameter. For details, see Table 3. |
| 6 | Device No: logical device number (starting from 1). The slot ID scenario is supported, and the value must be the same as the slot ID or silkscreen. Special notes: 1. 0xff indicates that the slot ID is not specified. Some operations are supported. The actual returned value prevails. 2. If 0xff fails to be used, the system retries using the slot ID or device logical sequence number. 3. When Device Type is Pcie Card and Device Info is 0xCA, Device No indicates the PCIe device port number. |
| 7 | Device Info Parameter, Common type, for example, Table 1. Specific type, for example, Table 2. |
| 8 | Read offset, starting from 0. |
| 9 | Length: length of the data to be read. The maximum value is 250 bytes. |
Response Information
| Byte | Data Field |
|---|---|
| 1 | Completion Code 80h-Device not present |
| 2:04 | Manufacturer ID, LS Byte first. The length is fixed to three bytes. For example, if the vendor ID is 2011 and the corresponding hexadecimal value is 0x0007DB, the first byte is DBh, the second byte is 07h, and the third byte is 00h. |
| 5 | End of List indicates whether the data reading is complete, Long data may need to be read multiple times. This field is used to check whether data is completely read. [7:1]: reserved [0]: End of list 0=last data 1=middle data |
| 6:N | Data. Returned data, which may be less than or equal to the read length. Common type, for example, Table 1. Specific type, for example, Table 2. |
Reference Information
Table 1 General Device Information Parameters (General Device Info Range 0x00-0xBF)
| Parameter | Parameter Data | Description | |
|---|---|---|---|
| Maximum | read only | data1:1-Get maximum of the device type | 1 |
| Presence Status | read only | data1:1-Get presence status 00h-not present 01h-present 02h-unknown Other Reserved | 2 |
| Health Status | read only | data1:1-Get health status 00h-normal 01h-minor 02h-major 03h-critical 04h-absent 05h-unknown Other Reserved | 3 |
| sub-device Maximum | read only | data1:1-Get sub-device Maximum of a device, only for expansion board | 4 |
| Availability | Read-only. Currently, only CPUs, DIMMs, and standard PCIe devices are supported. The active status is valid only for DIMMs. | data1:1-Get enable status and active status [7:2]: reserved [0]: enable status 0=disable 1=enable [1]: active status. 0=backup 1=active | 5 |
| BoardID | read only | data1:2-Get BoardID of the device. LS-byte first | 6 |
| Physical Number | Physical serial number. For example, MEZZ1 is connected to the switch boards in slots 2 and 3 in the middle, and MEZZ2 is connected to the switch boards in slots 1 and 4 on both sides. data1 indicates the slot number of the board, and data2 indicates the MEZZ number of the board. | data1-Get Physical Number of the device, 1 based data2-Get Physical Sub Number of the device, 1 based | 7 |
| location | Read only, physical location, and container (such as the mainboard, front hard disk backplane, and rear hard disk backplane). | data1:N-Device Location Max 50 Bytes.End by null if less than 50 Bytes | 8 |
| Function | Read only: function group or logical group (such as memory, system disk, and data disk). | data1:N-Device Function Max 50 Bytes.End by null if less than 50 Bytes | 9 |
| Device Name | Read only, which corresponds to the device silkscreen. | data1:N-Device Name Max 50 Bytes.End by null if less than 50 Bytes | 10 |
| Group ID | Read only. ID of the group to which the device belongs. | data1-Get Group ID of the device. 1 Based. | 11 |
| Sensor State | Write only. Sets the sensor reading and status. | Set sensor reading and event status data1:1-event direct 0-assert 1-deassert data2:1-sensor reading data3:1-event data1 data4:1-event data2 data5:1-event data3 | 12 |
| Disk Connect | read only | Gets disk connection by port. This is used by the BMA to determine the physical location of a disk. data1:1, disk container count. Total number of hard disk containers. A hard disk backplane is a hard disk container. data2:1-disk maximum in the container1, unknown if 0xff. data3:1- container1 type and sas port count in the container1, unknown if 0xff [7:4]: disk container type 0- pass-through drive backplane 1-Expander hard disk backplane 15-unknown others reserved [3:0]: sas port count in the container1, unknown if 0x0f. data4:1-sas port1 destination [7:4]:type, 0-none, 1-RAID controller card, 2-PCH, 3-RAID controller card, 15-unknown [3:0]:port number, 1 based, none if 0, unknown if 15. data5:1-sas port2 destination [7:4]:type, 0-none, 1-RAID controller card, 2-PCH, 3-RAID controller card, 15-unknown [3:0]:port number, 1 based, none if 0, unknown if 15. ...... data(N+3):1-sas portN destination [7:4]:type, 0-none, 1-RAID controller card, 2-PCH, 3-RAID controller card [3:0]:port number, 1 based, none if 0, unknown if 15. data(N+4):1-disk maximum in the container2, unknown if 0xff. data(N+5):1-sas port count in the container2, unknown if 0xff. data(N+6):1-sas port1 destination [7:4]:type, 0-none,1-RAID: screw-in card; 2: PCH; 3: PCIe RAID controller card; 15: unknown [3:0]:port number, 1 based, none if 0, unknown if 15. data(N+7):1-sas port2 destination [7:4]:type, 0-none, 1-RAID controller card, 2-PCH, 3-RAID controller card, 15-unknown [3:0]:port number, 1 based, none if 0, unknown if 15. ...... | 13 |
| Model | read only | data1:N-Device model Max 128 Bytes.End by null if less than 128 bytes. | 14 |
| Disk Locate State | read only | Get All Disk Locate State: queries the location indicator status of all disks. data1:8: Each bit indicates the status of the location indicator of a disk. data1:bit0 indicates the status of the location indicator of the disk whose logical number is 1. | 15 |
| FRU Device ID | read only | data1: 1-Get FRU ID. This parameter is used only by the mezzanine card and is reserved for compatibility. However, this parameter is not used for other device types. To obtain the FRU device ID, run the Get Device FRU ID command. | 16 |
| Mezz PCIE Connect | read only | data1: 1-direct connection or cross-connection; 0-direct connection; 1-cross-connection Data2:3-PCIe bus, device, and fun data5:4: information about the second PCIe port 0xff 0xff 0xff 0xff indicates that the PCIe information is invalid. | 17 |
| Type | read only | data1: 1-type If the value of devicetype is Disk, this parameter indicates the disk type. 0h=HDD 1h=SSD | 18 |
| Capacity | read only | Data1:4-Capacity data5: 1-unit If devicetype is set to Disk, this parameter indicates the disk capacity unit. 0h=GB 1h=TB | 19 |
| NC Work Stage | read only | data1:1-NC work stage status, 1 base | 20 |
| Power Control | read write | data1:1 indicates power-on, power-off, and reset. Currently, hard disks, carrier boards, standard cards, and PCIe Retimer support power-on and power-off operations. Standard cards support reset (requiring CPLD support). 0h=Forced power-off 1h=Power on with the x86 system (After the setting, the device is powered on only when the x86 system is powered on.) 2h=Forced reset 3h=Follow the x86 system reset (After the setting, the device is reset only when the x86 system is reset.) | 21 |
| SDI Card storage ip | read only | read For the values of Data1:1 status, see the right column. Data2:4 IPv4 address Data7:2 VLAN ID | 22 |
| SDI Card bootorder | read write | data1:1 bootorder startup item bit0: 0x0=hdd 0x1=pxe bit1 (for SDI 2.1.0 and later cards, bit1 is valid when bit0 is 1): 0x0=PXE on the mother board 0x1=NIC PXE | 23 |
| SDI Card System Status | read | data1:1 system status: system startup phase 0x0: not started 0x1=The BIOS is successfully loaded and the OS is being started. 0x3=The OS is successfully loaded. | 24 |
| SDI Card eth0/eth1'bond0 ip | read write | read data1:1 status (See the right part.) data2:4 - IPv4 address data7:2 - VLAN ID write data1:4: IPv4 address data5:4 mask data9:2: VLAN ID (1 – 4096) | 25 |
| SDI Card Reset | write | Note: This parameter is valid for SDI 2.1.0 and later cards. data1:1 reset 0x55=reset Other values: invalid | 26 |
| SDI Card IMU Reset | write | Note: This parameter is valid for SDI 3.0 and later cards. data1:1 reset 0x55=reset Other values: invalid | 27 |
| Rack Ucount | read write | Number of U spaces in a cabinet data1:1 (integer) | 28 |
| Empty Rack SN | read write | SN of an empty cabinet data1:n character string | 29 |
| Typical Configuration Rack SN | read write | Rack typical configuration SN. data1:n character string | 30 |
| Rack Model | read write | Rack model. data1:n character string | 31 |
| LSW PORT INFO | read only | data1:1 indicates the port link status. data2:2: port rate data4:1: port duplex status Data5:8-Number of RX bit errors on the port Data13:8-Number of TX bit errors on the port | 32 |
| ALL SDI Cards EP Init Status | read | data1:1 indicates the initialization status of all SDI cards. 0x0=SDI EP initialization is not complete. 0x1=SDI card initialization completed (The initialization is complete only after all SDI cards are initialized.) | 33 |
| Basic Rack SN | read write | SN of the basic configuration cabinet data1:n character string | 34 |
| Component Unique ID | read only | Unique ID of a component data1:n character string NOTE: The query takes effect only on the Tianchi model. | 35 |
| Rack Function | read write | Cabinet Usage data1: 1-C indicates a computing cabinet, and N indicates a network cabinet. data2:19-Reserved (optional) | 36 |
| KunpengDevice Type | read write | Kunpeng Device Type data1:1 0x00-TaiShan 200 (Model 2280) 0x01-TaiShan 200 (Model 5280) 0x0a-TaiShan 200K (Model 2280K) 0x0b-TaiShan 200K (Model 5280K) | 37 |
| Rack Configuration | read write | Cabinet Delivery Configuration data1:1- 0: indicates that the GE network port eth2 is used as the management network port and there is no right mounting ear. (default configuration) 1: indicates that the management network port is a PCIe expansion network port with a right mounting ear. (Huawei Cloud configuration) 2: indicates that the GE network port eth3 is used as the management network port. Configuration command: ipmitool raw 0x30 0x93 0xdb 0x07 0x00 0x3c 0x51 0x26 0x00 0xff 0xff 0x00 0x00 0x00 0x01 0x00 | 38 |
| Memory Temperature | read only | data1:N memory temperature | 41 |
| Memory Chip BitWidth | read only | data1:N character string, memory chip bit width | 42 |
| Retimer Type | read only | data1:1 retimer chip type 0x00: 5902L 0x01: 5902H 0x02: 5901 0x03: ds280 0x05: ds160 0xff: no retimer | 43 |
| Manufacturer | read only | data1:N character string, device vendor name | 99 |
Remarks:
The general device information range is 0x00-0xBF. The device information must be globally unique in the system.
The dedicated device information range is 0xC0-0xFF. The device information must be unique in the same device type.
The iBMC V2 query code ipmi_get_device_info needs to be adapted to query by Device Type and Device Info.
Table 2 Device Type and information parameters (dedicated Device Info range 0xC0-0xFF)
| Device Type | Device Info | Description | Querying and Setting Attributes | Data |
|---|---|---|---|---|
| 0x39 SCM | 10=0x0A | Device Name | read only | data1: N-Device Name, which indicates the SD100 silkscreen number. Max 50 Bytes.End by null if less than 50 Bytes. |
| 22=0x16 | SDI Card storage ip | read only | Query the IP address and VLAN of the SD100 FusionStorage Agent. Data 1: 1 IPv4 address and VLAN status Data 2:1 status. For details, see the return code table in the SD100 Command Reference. Data 3: 4 IPv4 address Data 7: 2 VLAN ID | |
| 23=0x17 | SDI Card bootorder | read write | Query the SD100 boot option. Data1: boot sequence. SDI V2: 0x00=hdd 0x01=primary card PXE 0x03=expansion card pxe SDI V3: 0x00=HDD Boot 0x01=Base Board PXE Boot 0x03=Buckle Card1 PXE Boot 0x05=Buckle Card2 PXE Boot 0x07=Buckle Card3 PXE Boot SDI V5.0, SDI V5.1: 0x00=HDD Boot 0x01=Base Board PXE Boot 0xff=None Data2: validity period. (for SDI V5.0 and SDI V5.1 only) 0x00=valid only once 0x01=Permanently valid | |
| 24=0x18 | SDI Card System Status | read | Query the SD100 system startup status. Data: system boot status SDI V2: 00h-BIOS loading failure 01h-BIOS loading success 03h-OS loading success SDI V3: 00h-IMU loading is not complete. 04h-IMU Loading Completed, BIOS and OS Loading Not Completed 05h-The IMU and BIOS are loaded, but the OS is not loaded. 07h-The IMU, BIOS, and OS are loaded successfully. | |
| 25=0x19 | SDI Card eth0/eth1'bond0 ip | read write | Run the following command to query the status of the IP address on the SD100 VLAN (only SD100 versions earlier than 2.1.0 are supported):Data 1: 1 IP address setting status Data 2: 4 IPv4 address Date 6: 2 VLAN ID | |
| 26=0x1A | Reset the SD100. | write | To reset the SD100, run the following command: data1:1 reset 0x55=reset | |
| 27=0x1B | Resetting the IMU of the SDI Card | write | Reset the IMU of the SDI card. data1:1 reset 0x55=reset | |
| 28=0x1C | Setting the NMI of the SDI Card | write | Set the NMI of the SDI card. Length: 0. No parameter is required. | |
| 29=0x1D | Powering On or Off the SDI Card System | write | Set the SDI card system power-on and power-off. Data1:1 power-on and power-off operations 0x00: power-off 0x01: power-on | |
| 39=0x27 | DPU Card Reset Linkage | read write | Note: This parameter is valid for the DPU card. data1:1 reset linkage policy 0x00=reset linkage 0x01=Reset not associated | |
| 40=0x28 | DPU Card Secure Boot | read write | When device info is 0x28, the secure boot configuration of the DPU card is set. Data1:1 Secure Boot Configuration 0x00=Secure boot is disabled. 0x01=Enable secure boot. | |
| 192=0xC0 | DPU Card Sol Switch | read write | Note: This parameter is valid for the DPU card. data1:1 Switching the Internal Serial Port of the DPU Card 0x01=SPU UART 0x02=MPU UART 0x03=MCU UART 0x04=GE UART 0x07=IMP UART 0x08=IMU UART | |
| 193=0xC1 | DPU Card Bios PXE Option | read write | Querying the PXE Boot OptionSetting the PXE Boot Optiondata1:1 PXE boot option 0x00 UEFI PXE (IPV4) 0x01 https PXE (IPV4 & IPV6) :SDI does not support this item. 0x02 https PXE (IPV4) :SDI does not support this item. 0x03 https PXE (IPV6) :SDI does not support this item. 0x04 UEFI PXE (IPV6) 0x05 UEFI PXE (IPV4 & IPV6) | |
| 194=0xC2 | DPU Card Bios MRC Log Level | read write | Setting the DPU BIOS Log Level data1:1 log type 1 – MRC 2 – UEFI data2:1 log level 1: simplified printing 2: full printing Querying the DPU BIOS Log Level data1:1 MRC log level data2:1 UEFI log level | |
| 195=0xC3 | Get force power on state | read | Note: China Telecom e-Cloud is used with 512C DPU NICs. The value of Device No must be 0xff. If the BIOS status is Enabled, the BIOS automatically resets to Disabled. data1:1 system forcible startup flag 0x00: disabled 0x01: enabled | |
| 196=0xC4 | Get DPU os startup status | read | Note: China Telecom e-Cloud is used with 512C DPU NICs. The value of Device No must be 0xff. The power-on status on the service side is available. data1:1 DPU os startup status 0x00: not started or not completely started 0x01: enabled | |
| 198=0xC6 | Set force power on state | write | Note: China Telecom e-Cloud is used with 512C DPU NICs. data1:1 system forcible startup flag 0x00: disabled 0x01: enabled | |
| 199=0xC7 | DPU Card Bios PXE Option | Read Write | Querying the PXE Boot OptionSetting the PXE Boot Optiondata1:1 PXE boot option 0x00 UEFI PXE (IPV4) 0x04 UEFI PXE (IPV6) 0x05 UEFI PXE (IPV4 & IPV6) | |
| 0x08 M.2 | 197=0xC5 | Set M.2 info | write | Note: The BMA cannot be installed on the e-Cloud. You need to obtain data from the BIOS for configuration. Data1:77 The M.2 data is entered in the following format: part1:1 selector part2:4 capacity part3:1 sataPort part4:10 manufacturer part5:41 modelNumber part6:21 serialNumber part7:9 firmwareVersion |
| 0x08 PCIeCard | 200=0xC8 | Card Number and Name | Read only | Number of data 1 cards, that is, the number of PCIe cards configured in the current environment. Slot number of data 2 card 1. Length of the name of data 3 card 1 Data 4:23 Name of card 1 Data 24: length of the card 2 name Data 25:44 Name of card 2. ...... |
| 201=0xC9 | Card Reg Info | Read only | Slot number of the data 1 card Data 2:106 SOC1 Reg Info Data 107:211 SOC2 Reg Info | |
| 202=0xCA | Set/Get PCIe Card Link Status And Pci.ids Info | Write Read | Sets or queries the access status and pci.ids information of a card. Access status of data card 1 0x01: access 0x00: removed Data 2: manufacturer ID of the 3G card. Data 4: device ID of card 5. Data 6: sub-vendor number of the 7 card. Data 8: subdevice ID of the 9 card. |
Command Example
Obtain device information.
Request:
bash
ipmicmd -k "0f 00 MM NN" smi 0Response:
text
0f MM NN