设备类型(Component-Type)
修订记录
| openUBMC版本号 | 修订日期 | 修订内容 |
|---|---|---|
| 25.06 | 2025/06/26 | 初稿,新增命令详情 |
openUBMC版本:Fru Type与Component Type保持一致,统一一套定义,Fru Type例外部分单独biao。
类和属性:Fru.Type, Component.Type
使用场景
当精确定位获取指定FRU信息时,推荐的获取机制:基于命令“Get Fruid Info”,通过参数"device_type=xx;group_id=xx;device_number=xx;"(xx为16进制值,调用方配置,比如装备根据BOM 0302编码来配置)获取FruID,然后再根据FruID来查询/设置电子标签、查询版本信息等。
场景2:
1)查询所有FruId对应的Fru Type; 2)找到BCU/NPU等部件对应的FruId,根据FruId查询UID等各种信息
表 1
| 序列 | bit位 | 功能 | 描述 |
|---|---|---|---|
| 最高 | bit24-bit31 | 事件主体类型 | 参见 表 3 |
| - | bit16-bit23 | 产品ID | 参见 产品ID分配表 |
| - | bit8-bit15 | 事件偏移,高字节 | - |
| 最低 | bit0-bit7 | 事件偏移,低字节 | 事件偏移,每个事件主体类型的事件统一编号,从1开始 |
表 2 FRU类型(Fru Type与Component Type不归一的定义)
| 部件类型 (包括板卡类型) | 部件类型显示名称 | 类型编号(10进制) | 类型编号(16进制) |
|---|---|---|---|
| 主板 | MotherBoard | 0 | 0x00 |
| MEZZ扣卡 | - | 1 | 0x01 |
| AMC | - | 2 | 0x02 |
| MMC | - | 3 | 0x03 |
| 电源模块 | - | 4 | 0x04 |
表 3 设备类型
| 部件类型 (包括板卡类型) | 部件类型显示名称 | 部件显示名称 注:[]内表示可选 | 类型编号(10进制) | 类型编号(16进制) | 子系统 |
|---|---|---|---|---|---|
| CPU | CPU | CPU[1~N] | 0 | 0x00 | 异构算力管理 |
| 内存 | Memory | DIMM###,###分别表示CPU ID、Channel ID、DIMM ID。 | 1 | 0x01 | 异构算力管理 |
| 硬盘 | Disk | Disk[0~N]或Disk[A~Z] | 2 | 0x02 | 通用硬件管理 |
| 电源 | PSU | PSU[1~N] | 3 | 0x03 | 能效管理 |
| 风扇 | Fan | Fan[1~N] | 4 | 0x04 | 能效管理 |
| 硬盘背板 | Disk Backplane | Disk BP[1~N],RH8100V5产品首先使用。 | 5 | 0x05 | 通用硬件管理 |
| RAID扣卡 | RAID Card | RAID Card[1~N] | 6 | 0x06 | 通用硬件管理 |
| 未定义(历史未知原因未定义) | UNKNOWN | UNKNOWN | 7 | 0x07 | NA |
| PCIe标卡 | PCIe Card | PCIe Card[1~N] 说明: FunctionClass(PCIE卡功能分类) 0:未知 1:RAID 2:网卡(以太网、FC卡、FcOE卡等) 3:GPU卡 4:存储卡(SSD卡/M.2卡) 5:SDI卡 6:加速卡 7:扩展卡(PCIe Riser) 8:FPGA卡 9:NPU卡 10:存储DPU卡 11:DPU卡 与FunctionClass对应的FunctionType描述: 0: Unknown 1: RAID Card 2: Net Card 3: GPU Card 4: Storage Card 5: SDI Card 6: Accelerate Card 7: PCIe Riser Card 8: FPGA Card 9: NPU Card 10: Storage DPU Card 11: DPU Card | 8 | 0x08 | 通用硬件管理 |
| AMC板 | AMC | AMC[1~N] | 9 | 0x09 | 通用硬件管理 |
| HBA卡 | HBA | HBA[1~N] | 10 | 0x0A | 通用硬件管理 |
| Mezz扣卡 | Mezz Card | Mezz Card[1~N] | 11 | 0x0B | 通用硬件管理 |
| 未定义(历史未知原因未定义) | UNKNOWN | UNKNOWN | 12 | 0x0C | NA |
| 网卡扣卡 | NIC | NIC[1~N] | 13 | 0x0D | 通用硬件管理 |
| 内存板 | Memory Board | Memory Board[1~N] | 14 | 0x0E | 异构算力管理 |
| PCIe Riser卡 | PCIe Riser Riser Card | PCIe Riser[1~N] | 15 | 0x0F | 通用硬件管理 |
| 主板 | Mainboard | Mainboard[1~N] 使用场景:(查询FruId为0的组件/Fru,优先使用FruName为BMC的Fru)- 天池机型,FruName为BMC(FRU类型为26)的组件,配置FruId为0,对应事件主体:chassisBMC/MotherBoard;- 非天池机型,FruName为Mainboard(组件类型为16)的组件,配置FruId为0,对应事件主体:chassisMainboard;- 天池机型和非天池机型:Redfish接口DeviceType统一为“MainBoard”,对应接口https://device_ip/redfish/v1/Chassis/chassis_id/Boards/board_id "DeviceType": "MainBoard" | 16 | 0x10 | 通用硬件管理 |
| LCD | LCD | LCD[1~N] | 17 | 0x11 | 通用硬件管理 |
| 机箱 | Chassis | Chassis[1~N] | 18 | 0x12 | 通用硬件管理 |
| NC板 | NCM | NCM[1~N] | 19 | 0x13 | 通用硬件管理 |
| 交换板 | Switch Module | Switch Module[1~N] | 20 | 0x14 | 通用硬件管理 |
| 存储板 | Storage Board | Storage Board[1~N] | 21 | 0x15 | 通用硬件管理 |
| 机框背板 | Chassis Backplane | Chassis BP[1~N],RH8100V5产品首先使用,其他机型后续使用。 | 22 | 0x16 | 通用硬件管理 |
| SMM板/CMC | HMM/CMC | HMM/CMC[1~N],集中管理板。 | 23 | 0x17 | TCE |
| 风扇背板 | Fan Backplane | Fan BP[1~N],RH8100V5产品首先使用。 | 24 | 0x18 | 能效管理 |
| 电源背板 | Power Backplane | PSU BP[1~N],RH8100V5产品首先使用。BMC V2版本使用 | 25 | 0x19 | 能效管理 |
| 电源转接板 | Power Transfer Board | Power Transfer Board[1~N]。openUBMC及其之后版本使用 | 25 | 0x19 | 能效管理 |
| BMC/BMC板 | BMC BMCCard | BMC[1~N] | 26 | 0x1A | 通用硬件管理 |
| MMC(MM)板 | MM/MMC | MMC/MM[1~N],外围部件管理板,管理电源风扇。 | 27 | 0x1B | TCE |
| 双胞胎底板 | Twin Node Backplane | Twin Node Backplane[1~N] | 28 | 0x1C | NA |
| Base (交换平面) | Base Plane | Base Plane[1~N] | 29 | 0x1D | 集群 |
| Fabric (交换平面) | Fabric Plane | Fabric Plane[1~N] | 30 | 0x1E | 集群 |
| 交换扣卡(如FC GW扣卡/FCoE/M8PA) | Switch Mezz | Switch Mezz[1~N],OSCA交换板上的扣卡。 | 31 | 0x1F | 通用硬件管理 |
| LED | LED | LED[1~N] | 32 | 0x20 | 通用硬件管理 |
| SD卡 | SD Card | SD Card[1~N] | 33 | 0x21 | 通用硬件管理 |
| TPM/TCM卡 | Security Module | Security Module[1~N] | 34 | 0x22 | 安全管理 |
| IO板 | I/O Board | I/O Board[1~N] FIO Board[1~N] BIO Board[1~N] | 35 | 0x23 | 通用硬件管理 |
| 处理器板/CPU板 | CPU Board | CPU Board[1~N] | 36 | 0x24 | 异构算力管理 |
| RMC板 | RMC | RMC[1~N],X8000机柜管理板。 | 37 | 0x25 | 通用硬件管理 |
| PCIE SSD盘转接卡 | PCIe Adapter | PCIe Adapter[1~N],插在标准PCIE槽,用于PCIE总线转接硬盘,如:X16转4个X4。 | 38 | 0x26 | 通用硬件管理 |
| PCH(南桥) | PCH | PCH[1~N] | 39 | 0x27 | 异构算力管理 |
| 线缆/内部连接 | Cable | Cable[1~N] | 40 | 0x28 | 通用硬件管理 |
| 端口 | Port | Port[1~N] | 41 | 0x29 | 通用硬件管理 |
| LSW | LSW | LSW[1~N] | 42 | 0x2A | 通用硬件管理 |
| PHY | PHY | PHY[1~N] | 43 | 0x2B | 通用硬件管理 |
| 业务系统/产品 | System | System | 44 | 0x2C | 通用硬件管理 |
| M.2转接卡 | M.2 Transfer Card | M.2 Transfer Card[1~N] M.2 转接卡 | 45 | 0x2D | 通用硬件管理 |
| Expander | Expander | Expander[1~N] 备注:X86 V3机型专用,V6/鲲鹏机型废弃此类型,切换到0x5D/0xC1 | 45 | 0x2D | 通用硬件管理 |
| LED转接板 | LED Board | LED Board[1~N] | 46 | 0x2E | 通用硬件管理 |
| LPM(内部叫PBI板,即PCH、BMC、IO组合板) | LPM | LPM[1~N],RH8100产品使用。 | 47 | 0x2F | 通用硬件管理 |
| PIC卡(灵活插卡) | PIC Card | PIC Card[1~N],交换板XCUK上使用。 | 48 | 0x30 | 通用硬件管理 |
| 按钮 | Button | ### Button,如Power Button,UID Button等 | 49 | 0x31 | 通用硬件管理 |
| 通用扩展板 | Expander | Expander[1~N],通用扩展板,如:扩展硬盘的expander,一般在硬盘背板上。 | 50 | 0x32 | 通用硬件管理 |
| CPI(集中控制分区单元,Central Partition Interconnect Module ) | CPI | CPI[1~N],目前应用在9032,由CMC管理。 | 51 | 0x33 | 集群 |
| ACM(系统时钟板,Advanced Clock Module) | ACM | ACM[1~N],目前应用在9032,由CMC管理。 | 52 | 0x34 | 集群 |
| CIM(中心接口模块,Central Interface Module) | CIM | CIM[1~N],目前应用在9032,由CMC管理。 | 53 | 0x35 | 集群 |
| PFM(电源风扇合一模块) | PFM | PFM[1~N],9032产品的一个部件,由CMC管理。 | 54 | 0x36 | 集群 |
| KPAR(多分区系统) | KPAR | KPAR(多分区系统) | 55 | 0x37 | 集群 |
| JC芯片 | JC | JC[1~N],如:JC芯片在主板或内存板上。 | 56 | 0x38 | 异构算力管理 |
| SCM(系统计算模块,指CPU+内存的计算单元) | SCM | SCM[1~N] | 57 | 0x39 | 异构算力管理 |
| MINISAS HD通道 | Minisas HD channel | ARM产品,用于故障诊断。 | 58 | 0x3A | RAS故障管理 |
| SATA DOM通道 | SATA DOM channel | ARM产品,用于故障诊断。 | 59 | 0x3B | RAS故障管理 |
| GE通道 | GE channel | ARM产品,用于故障诊断。 | 60 | 0x3C | RAS故障管理 |
| XGE通道 | XGE channel | ARM产品,用于故障诊断。 | 61 | 0x3D | RAS故障管理 |
| PCIe Switch | PCIe Switch | PCIe Switch[1~N] | 62 | 0x3E | 通用硬件管理 |
| 接口器件/接口板 | Interface Device | Interface Device[1~N],举例E9000后插板上的光模块,或DAC线缆;或UB接口板 | 63 | 0x3F | 集群 |
| xPU载板/xPU | xPU Carrier Board/xPU Board | xPU Board[1~N],比如:GPU、VPU | 64 | 0x40 | 异构算力管理 |
| 硬盘底板(CH222V3的SESA) | Disk BaseBoard | Disk BaseBoard | 65 | 0x41 | 通用硬件管理 |
| VGA接口卡 | VGA Interface Card | VGA Intf Card | 66 | 0x42 | 通用硬件管理 |
| 直通卡(SAS直通卡等) | Pass-Through Card | Pass-Through Card | 67 | 0x43 | 通用硬件管理 |
| 逻辑盘 | Logical Driver | Logical Driver[1~N] | 68 | 0x44 | 通用硬件管理 |
| PCIe Retimer | PCIe Retimer | PCIe Retimer[1~N] | 69 | 0x45 | 通用硬件管理 |
| PCIe Reperter | PCIe Repeater | PCIe Repeater1~N] | 70 | 0x46 | 通用硬件管理 |
| SAS | SAS | SAS[1~N] | 71 | 0x47 | 通用硬件管理 |
| 内存通道 | Memory Channel | Memory Channel[1~N] | 72 | 0x48 | 异构算力管理 |
| BMA | BMA | BMA | 73 | 0x49 | 通用硬件管理 |
| 板载网卡 | LOM | LOM[1~N] 备注:此类型暂未使用,查询LOM信息使用0x0D | 74 | 0x4A | 通用硬件管理 |
| 信号转接板 | Signal Adapter Board | Signal Adapter Board | 75 | 0x4B | 通用硬件管理 |
| 水平转接板 | Horizontal Connection Board | Horizontal Connection Board | 76 | 0x4C | 通用硬件管理 |
| 节点 | Node | Node[1~N],如:E9000上的前插板和交换板。 | 77 | 0x4D | 集群 |
| 资产管理控制板 | Asset Locate Board | Asset Locate Board[1~N] | 78 | 0x4E | 集群 |
| 机柜U位 | Unit | Unit[1~N] | 79 | 0x4F | 集群 |
| 机柜管理模块 | RMM | RMM,机柜管理模块。 | 80 | 0x50 | 集群 |
| 机柜 | Rack | Rack | 81 | 0x51 | 集群 |
| 备电 | BBU | BBU[1~N],Taishan 2280 V2产品的备电模块。 | 82 | 0x52 | 集群 |
| OCP扣卡 | OCP Card | OCP Card[1~N] | 83 | 0x53 | 通用硬件管理 |
| 漏液检测卡 | Leakage Detection Card | Leakage Detection Card[1~N] | 84 | 0x54 | 集群 |
| MESH卡 | MESH Card | MESH Card[1~N] | 85 | 0x55 | TCE |
| 神经网络计算芯片 | NPU | NPU[1~N],AtlasA 800产品神经网络计算芯片。 | 86 | 0x56 | 异构算力管理 |
| 融合接口卡, Converged Interface Card | CIC Card | Converged Interface Card[1~N] | 87 | 0x57 | 存储 |
| Expansion Module | Expansion Module | Expansion Module[1~N] | 88 | 0x58 | 通用硬件管理 |
| 风扇模块 | Fan Module | Fan Module[0-N] | 89 | 0x59 | 能效管理 |
| AR卡 | AR Card | AR Card[1~N] | 90 | 0x5A | 存储 |
| 汇聚板 | Converge Board | Converge Board[1~N] | 91 | 0x5B | 存储 |
| SoC主板 | SoC Board | SoC Board[1~N], SoC架构的推理小主板,如,Atlas 200I SoC A1 | 92 | 0x5C | 通用硬件管理 |
| 扩展板 | Expand Board | ExpBoard[1-N] | 93 | 0x5D | 通用硬件管理 |
| HiAM | HiAM | HiAM [1~N] | 94 | 0x5E | RAS故障管理 |
| 光模块 | OpticalModule | OpticalModule[1-N] | 95 | 0x5F | RAS故障管理 |
| HDU | HDU | HDU[1~N] | 96 | 0x60 | 集群 |
| 网络加速卡 | NP | Network Process Board | 97 | 0x61 | TCE |
| 区域计算机网络 | LCN | Local Computer Network | 98 | 0x62 | 昇腾,灵衢网络 |
| 基础计算组件 | BCU | BCU[1~N] | 192 | 0xC0 | 异构算力管理 |
| 系统扩展组件 | EXU | EXU[1~N] | 193 | 0xC1 | 通用硬件管理 |
| 存储扩展组件 | SEU | SEU[1-N] | 194 | 0xC2 | 通用硬件管理 |
| IO扩展组件 | IEU | IEU[1~N] | 195 | 0xC3 | 通用硬件管理 |
| 散热组件 | CLU | CLU[1~N] | 196 | 0xC4 | 能效管理 |
| 昇腾软件告警 | Ascend Software Events | 昇腾软件告警(MindIE、MindCluster等软件告警) | 252 | 0xFC | 昇腾 |
| PoDManager系统软件 | PoDManager | 用于PoDManager系统软件检测的告警 | 253 | 0xFD | 集群 |
| 预留字段 | Reserved | 保留。 用作扩展或特殊场景定义, 禁止 作为有效的设备类型使用。 | 255 | 0xFF |
DFT-ID定义
修订记录
| openUBMC版本号 | 修订日期 | 修订内容 |
|---|---|---|
| 25.06 | 2025/06/26 | 初稿,新增命令详情 |
相关命令:
- 获取测试项数目(Get DFT Test Item cnt)
- 获取测试项内容(Get DFT Test Item)
- 启动/停止测试(Start DFT Test)
- 获取测试结果(Get DFT Test Result)
表1 DFT定义
| 类型 | 类别 | Component Type | 十六进制DFT ID | 十进制DFT ID | 中文名称 | 英文名称 | 机型 | 测试场景 |
|---|---|---|---|---|---|---|---|---|
| 1:可以自检 dft id <1h-40h> | 器件<1-20h> | - | 0x01 | 1 | LM75 | LM75 | - | - |
| - | - | - | 0x02 | 2 | LM80 | LM80 | - | 多路巡检串行数字接口温度传感器。实现单板电源电压和环境温度的监控,LM80内部集成7路电压A/D转换通道和1路温度传感器 |
| - | - | - | 0x03 | 3 | PCA9555 | PCA9555 | - | 9555是I2C扩展IO口的功能,当你的IO口数量不够用的时候,可以用一个I2C通道(只使用2根线),扩展出16个IO接口出来 前4位为固定“0100”,A2A1A0为可编程的位,最后一位为读写控制位。 |
| - | - | - | 0x04 | 4 | PCA9545 | PCA9545 | - | - |
| - | - | - | 0x05 | 5 | PCA9517 | PCA9517 | - | - |
| - | - | - | 0x06 | 6 | INA220 | INA220 | - | - |
| - | - | - | 0x07 | 7 | 纽扣电池 | Button Cell Voltage | - | - |
| - | - | - | 0x08 | 8 | 电源 | Power Supply | - | - |
| - | - | - | 0x09 | 9 | ME | ME | - | - |
| - | - | - | 0x0a | 10 | U盘抽样测试 | SD Card Sample Test | - | - |
| - | - | - | 0x0b | 11 | FLASH | Flash | - | - |
| - | - | - | 0x0c | 12 | EEPROM | EEPROM | - | - |
| - | - | - | 0x0d | 13 | DDR3 | DDR3 | - | - |
| - | - | - | 0x0e | 14 | SRAM | SRAM | - | - |
| - | - | - | 0x0f | 15 | CPLD | CPLD | - | - |
| - | - | - | 0x10 | 16 | CPU电压 | CPU Voltage | - | - |
| - | - | - | 0x11 | 17 | 内存电压 | Memory Voltage | - | - |
| - | - | - | 0x12 | 18 | 12V电压 | 12V0 Voltage | - | - |
| - | - | - | 0x13 | 19 | 5V电压 | 5V0 Voltage | - | - |
| - | - | - | 0x14 | 20 | 3.3V电压 | 3V3 Voltage | - | - |
| - | - | - | 0x15 | 21 | SD卡/U盘在位 | SD Card Presence | - | 用于早期SD卡/USB设备直连BMC的单板,现已废弃 |
| - | - | - | 0x16 | 22 | TPM卡在位测试 | TPM Card Presence | - | - |
| - | - | - | 0x17 | 23 | LM96080 | LM96080 | - | - |
| - | - | - | 0x18 | 24 | SD卡在位测试 | SD Card Presence | - | 用于SD卡通过RAID控制芯片连接BMC的单板 |
| - | - | - | 0x19 | 25 | SD卡随机读写测试 | - | - | - |
| - | - | - | 0x1a | 26 | Hi1710寄存器扫描测试 | Hi1710 Test | - | - |
| - | - | - | 0x1B | 27 | CLK测试 | CLK Test | - | 仅用于9032 |
| - | - | - | 0x1C | 28 | 网口装备自检 | - | MM920MM921 | 2023.12.4:与通用自检冲突,废弃 |
| - | - | - | 0x1C | 28 | NAND Flash | NAND Flash | - | 用于自检BMC的NAND Flash,包括(1)可用寿命低于50%(2)预留块低于总预留块70%,两者任意一个满足,自检失败,否则,自检成功 |
| - | 总线<21h-40h> | - | 0x21 | 33 | I2C | I2C | - | - |
| - | - | - | 0x22 | 34 | LPC(KCS/BT) | LPC | - | - |
| - | - | - | 0x23 | 35 | IPMB | IPMB | - | - |
| - | - | - | 0x24 | 36 | LocalBus | LocalBus | - | - |
| - | - | - | 0x25 | 37 | PCIe | PCIe | - | - |
| - | - | - | 0x26 | 38 | PWM | PWM | - | - |
| - | - | - | 0x27 | 39 | Lan Switch测试 | Lan Switch Test | - | 被9032占用,无记录 |
| - | - | - | 0x28 | 40 | CPLD Self POST | CPLD Self POST | - | 被9032占用,无记录 |
| - | - | - | 0x29 | 41 | PECI | PECI | - | BMC与x86 CPU之间的PECI链路测试,需要x86 CPU上电 |
| - | - | - | 0x2A | 42 | USB端口切换测试 | USB Port Switch | - | 面板的USB端口可以在PCH和BMC之间通过切换实现动态功能,此测试项主要是测切换通道是否正常 |
| - | - | - | 0x2B | 43 | 时钟信号自检 | Clock Signal Test | - | 通过CPLD寄存器值判断时钟信号是否正常(支持多个信号同时检测) |
| - | - | - | 0x2E | 46 | 板间心跳环回测试 | Heart Beat Loop Test | - | 控制板间心跳环回测试,用于装备背板下板间网口环回测试。 |
| - | - | - | 0x32 | 50 | 外部硬件接口通用测试 | External Hardware General Test | - | 用于通过控制硬件接口启动/停止测试,并从硬件接口获取测试结果的通用测试场景。比如,通过CPLD寄存器控制各种器件的自检,自检结果也是通过读取特定的CPLD寄存器来确定,比如Hisport链路。 |
| 2: 需要前提条件 dft id <41h-60h>说明:考虑到类型非1的,部分装备测试项会绑定dft id(大于64),故每种类型支持独立编号部分使用1-64。 | - | - | 0x01 | 1 | 交换机网口测试 | - | DA123C | GE或者NCSI网口通过线缆直接对接到交换机,测试网口能否正确接收交换机报文功能 DFT参数: DftId:0x01 DftType:0x02 DftParam:NA Manufacture资源信息: path:/bmc/kepler/Manufacture/PrepareTest/DftSwitch/:Id interface:bmc.kepler.Manufacture |
| - | - | - | 0x41 | 65 | 键盘 | Keyboard | - | 需要OS上电 |
| - | - | - | 0x42 | 66 | 虚拟光驱 | Virtual CD-ROM | - | 需要OS上电 |
| - | - | - | 0x43 | 67 | 虚拟软驱 | Virtual Floppy Drive | - | 需要OS上电 |
| - | - | - | 0x44 | 68 | VCE | VCE | - | 需要设置屏幕图片 |
| - | - | - | 0x45 | 69 | JTAG链路 | JTAG | - | 需要对端接CPLD |
| - | - | - | 0x46 | 70 | SPI(BMC到挂在CPLD下的flash通道) | SPI | - | - |
| - | - | - | 0x47 | 71 | BMC串口 | BMC UART | - | 需要串口环回头 |
| - | - | - | 0x48 | 72 | LCD串口 | LCD UART | - | - |
| - | - | - | 0x49 | 73 | NSCI | NSCI | - | BMC网口环回测试 |
| - | - | - | 0x4a | 74 | 管理网口 | Ethernet Port | - | 测试场景: **场景1、通用机架:**网口环回测试,对应V2函数dft_net_mgmt_test 机架场景,网口通用自环测试(TU日落中,缺点:不具备测试网口速率),nic_magloop_test%hi1710 机架场景,网口通用归一测试(新开发TU,收编网口自环,用于网口连通性&速率测试),nic_ping_test_tobmc_arm TU实现机制:优先通过连通性&速率测试,若不通过,再尝试通过自环用例测试。(2024.6.11切换中,可以测试网络速率) **场景2、TCE/TianGong双平面测试方案:**通过机框的内网IP的连通性覆盖刀片到管理板之间的两条网络链路。 BMC V2参考函数:dft_net_base_test **机框场景,网口测试TU(TCE/TianGong),**base_lswtobmcloop_test%CN90GPUA |
| - | - | - | 0x4b | 75 | 内存板电压测试 | Memory Board Voltage | - | - |
| - | - | - | 0x4d | 77 | BMC时钟测试 | - | - | - |
| - | - | - | 0x4e | 78 | 跳帽自检 | Jumper selftest | - | - |
| - | - | - | 0x4f | 79 | 后插板主板与扣板间链路检测 | FC Link Test | 仅用于CX916、CX220 | 后插板特性 |
| - | - | - | 0x50 | 80 | M8PB固件加载 | M8PB FW Load | 仅用于CX916、CX220 | 后插板特性 |
| - | - | - | 0x51 | 81 | Lan Switch测试 | Lan Switch Test | - | - |
| - | - | - | 0x52 | 82 | XCUJ保留通道测试 | XCUJ保留通道 | - | - |
| - | - | - | 0x53 | 83 | 风扇测试 | Fan Test | - | param1:测试的风扇转速级别数量(如40,50,80,100四个测试级别) param2:每个转速级别的稳定时间(默认20S) para3:fanlevel1 para4:fanlevel2 … paran:fanlevelm |
| - | - | - | 0x54 | 84 | 硬件通道测试,HW Channel Test, | HW Channel Test | BM320、鲲鹏920B使用 X6800装备背板信号环回测试 | 举例: 场景1:IIC通道、IIC从设备测试 场景2:通过SMC读取一部分数据,对其中数据做校验 e.g.:测试项DftHwChannel_Cpld_Gpio4 支持的Operator如下1-6取值定义: -- num1为实际读取数据和CSR配置“InputMask”做“与”动作后 -- num2为CSR配置的InputValue local function calculate ( num1 , num2 , operator ) local operators ={ [ 1 ]= function ( a , b ) return a < b and OK or ERR end , [ 2 ]= function ( a , b ) return a <= b and OK or ERR end , [ 3 ]= function ( a , b ) return a > b and OK or ERR end , [ 4 ]= function ( a , b ) return a >= b and OK or ERR end , [ 5 ]= function ( a , b ) return a == b and OK or ERR end , [ 6 ]= function ( a , b ) return a ~ = b and OK or ERR end , } return operators[operator](num1, num2) endAtlasT_200_CSR - 文件 |
| - | - | - | 0x55 | 85 | NI自环测试,NI Loop Test, | NI Loop Test | 仅用于9032 | - |
| - | - | - | 0x56 | 86 | NC串口环回,NC Serial Loop Test, | NC Serial Loop Test | 仅用于9032 | - |
| - | - | - | 0x57 | 87 | NI眼图测试,NI EYE Test, | - | 仅用于9032 | - |
| - | - | - | 0x57 | 87 | PHY端口环回测试,Phy port loop test,"FT阶段环回:插入环回头,装备背板 | Phy port loop test | 仅用于E9000后插板 | device id为端口编号,取值范围0-31表示32个端口,0xff表示所有的端口; param1: 1表示物理自环多端口串联环回测试(用于正常FT测试,BMC目前只配置模式,不发包,后续由BMC发包测试。device id建议取为0xff,一个命令启动测试和查询结果); 2表示逻辑自环多端口串联环回测试(用于FT精确定位,BMC目前只配置模式,不发包,后续由BMC发包测试。device id建议取为0-31); 3表示逻辑自环单端口环回测试(用于ST测试,BMC目前只配置模式,不发包,后续由BMC发包测试。device id建议取为0xff,一个命令启动测试和查询结果)。 |
| - | - | - | 0x58 | 88 | ST阶段环回:不用环回头,前插板" | - | - | 参数: param1:FruID,1个字节 param2:TimeOut,检测超时时间,该时间需要大于复位的正常时间,单位是S,1个字节(目前该命令用于装备XCUL单板IB芯片复位测试) |
| - | - | - | 0x59 | 89 | IO读测试,IO Read Test,对IO进行读测试 | - | - | 参数: param1:需要写的值 param2:预留配置为0即可 |
| - | - | - | 0x5A | 90 | IO写测试,IO Write Test,对IO进行写测试 | IO Write Test | 仅用于9032 | 仅用于9032,跨BMC/NI对接测试 |
| - | - | - | 0x5B | 91 | NI对接测试,NI Peer-to-Peer Test,NI端口对接测试 | NI Peer-to-Peer Test | 仅用于MM921 | 当前仅用于MM921,通过外置U盘进行读写测试 |
| - | - | - | 0x5C | 92 | USB读写测试 | USB RW Test | 仅用于MM921 | 当前仅用于MM921,通过外置U盘进行读写测试 |
| - | - | - | 0x5D | 93 | RS485半双工串口测试 | RS485 Half-duplex Test | 仅用于RM210 | 当前仅用于RM210,全双工测试可用串口环回测试(71) |
| - | - | - | 0x5E | 94 | Type-c读写测试 | Type-C Test | - | Type-C接口读写测试 参数: param1: 1:表示只对USB设备进行格式化处理; 其他值:表示按Type-C读写流程处理。 |
| - | - | - | 0x5F | 95 | 光模块在位检测 | Optical Module Test | - | 检测光模块端口在位 设备编号(DevNum)为:0、1、2、3,分别对应光模块SFP0、SFP1、SFP2、SFP3 |
| - | - | - | 0x60 | 96 | 测试Riser卡链路 | - | - | 通过装备工具卡测试Riser标准卡场景 |
| 3:拷机项目 dft id <61h-80h>使用约束: <65h-80h>不允许装备直接绑定DFT ID,需要通过Component Type和DFT ID来匹配唯一测试项 | - | - | 0x61 | 97 | SD卡全盘测试 | SD Card Overall Test | - | - |
| - | - | - | 0x62 | 98 | 内存VDDQ电压拉偏测试 | VDDQ Volt test | - | 参数: param1:电压拉偏百分比,取值范围[-4,4]; param2:预留配置为0即可 |
| - | - | - | 0x63 | 99 | IO VDDN电压拉偏测试 | IO VDDN Test | Taishan | 参数: param1:电压拉偏百分比,取值范围[-5,5]; param2:预留配置为0即可 |
| - | - | - | 0x64 | 100 | CPU核心VDDAVS电压拉偏测试 | CPU Core AVS Test | Taishan | 参数: param1:电压拉偏百分比,取值范围[-5,5]; param2:预留配置为0即可 |
| CPU:0 | - | - | 0x65 | 101 | CPU加严测试 | CPU Voltage | - | 参数: param1:加严测试类型 0:FIX, 1:AVS, 2:MBIST param2:电压拉偏百分比,若使用硬件默认拉偏百分比时,填写0xFF param3:预留配置为0即可 |
| - | - | - | 0x66 | 102 | CPU加严测试 | CPU Voltage | - | - |
| - | - | - | 0x67 | 103 | CPU加严测试 | CPU Voltage | - | - |
| 4:需要人工检查结果 dft id <81h-A0h> | - | - | 0x81 | 129 | LED | LED | - | - |
| - | - | - | 0x82 | 130 | 数码管 | Lamp Tube | - | - |
| - | - | - | 0x83 | 131 | LED诊断面板 | LED Panel | - | - |
| - | - | - | 0x84 | 132 | LED防呆 | LED Fool-proofing | - | LED指示灯防呆测试 参数: param1: 防呆测试模式类型,1个字节,取值范围[0,1] 0-表示常亮模式 1-表示闪烁模式 |
| - | - | - | 0x85 | 133 | 数码管防呆 | Digital Tube Fool-proofing | - | 数码管防呆测试。数码管显示3个数字:param1 param2 param3 参数说明: param1:必填,取值范围[0,9] param2:选填,取值范围[0,9]。若不填,数码管第2个数字显示param1 param3:选填,取值范围[0,9]。若不填,数码管第3个数字显示param1 |
| 5:需要人工操作 dft id <A1h-C0h> | - | - | 0xA1 | 161 | 扳手 | Handle | - | - |
| - | - | - | 0xA2 | 162 | UID Button | UID Button | - | - |
| - | - | - | 0xA3 | 163 | PowerButton | PowerButton | - | - |
| - | - | - | 0xA4 | 164 | LCD自检测试 | LCD Selftest | - | - |
| - | - | - | 0xA5 | 165 | 液晶屏校准 | LCD Calibrate | - | - |
| - | - | - | 0xA6 | 166 | 液晶屏指示灯 | LCD Lamp | - | - |
| - | - | - | 0xA7 | 167 | 液晶屏背光指示灯 | LCD Back Light | - | - |
| - | - | - | 0xA8 | 168 | 液晶屏坏点 | LCD Dead Pixel | - | - |
| - | - | - | 0xA9 | 169 | 液晶屏在位 | LCD Presence | - | - |
| - | - | - | 0xAA | 170 | 按钮测试 | Button Test | - | - |
| - | - | - | 0xAB | 171 | Switch | Switch Test | - | 0表示闭合,1表示断开 |
| - | - | - | 0xAC | 172 | MCU | MCU Test | - | 用于自研PCIe卡的管理芯片(Micro Control Unit)装备测试 IPMI命令中的Device ID具体定义如下: 1:主控芯片内部自检项 2:MCU管理的PCIe卡主控芯片外围设备自检 3:MCU管理的PCIe卡面板按钮测试 4:MCU管理的PCIe卡面板指示灯测试 5:MCU日志清除测试 6:MCU自愈功能测试(由按钮触发) 7:MCU触发降频中断测试 8:MCU控制芯片下电测试 |
| - | - | - | 0xAD | 173 | 漏液检测卡电磁阀测试 | Magnetic Valve Test | - | 写PCA9555寄存器开/关电磁阀,然后读另一个PCA9555寄存器检测电磁阀开/关状态 |
| - | - | - | 0xAE | 174 | 漏液检测卡漏液检测告警测试 | Leak Alarm Test | - | 写PCA9555寄存器模拟漏液告警产生/消除,然后读另外一个PCA9555寄存器检测漏液告警状态 |
| - | - | - | 0xAF | 175 | NPU过温保护测试 | Npu High Temp Protect Test | atlas800 | 装备从带内注入故障触发cpld信号,然后从带外查询cpld寄存器获取过温状态 |
| 6:机型自定义 dft id <C1h-FFh>备注:同一个机型的dft id定义不允许冲突 | 公共 | - | 0xC3 | 195 | 机箱盖开盖检测、测试 | Chassis Cover Open Test | - | 用于开箱测试中检测机箱盖开关状态 |
| - | - | - | 0xC6 | 198 | SECURITY PANEL TEST | SECURITY PANEL TEST | - | 用于安全面板测试项装备测试 |
| - | TianGong | - | 0xC1 | 193 | CAN通道测试 | - | - | 用于CAN通道环回测试,CAN通道发出测试数据,在BMC串口读取对应的数据。 |
| - | TCE | - | 0xC1 | 193 | 计算板CDR测试 | - | TCE计算板 | - |
| - | 废弃 | - | 0xC1 | 193 | SOL串口 | SOL UART | - | - |
| - | - | - | 0xC2 | 194 | 风扇 | Fan | - | - |
| - | TaiShan | - | 0xC4 | 196 | 60盘硬盘抽屉拉出测试 | 60-disk drawer pull out Test | - | 用于TaiShan 5290 60盘硬盘抽屉拉出测试 |
| - | 存储 | - | 0xC5 | 197 | PENGEA FT TEST | PENGEA FT TEST | 盘古V6R5 | 用于盘古V6R5产品(太平洋、北冰洋、大西洋)装备测试 IPMI命令中的Device ID具体定义如下: 1:风扇板点灯测试 2:光模块上下电测试 |
| - | E9000 | - | 0xC2 | 194 | 管理板网口装备自检 | - | MM920 MM921 TCE管理板 | - |
固件ID管理
修订记录
| openUBMC版本号 | 修订日期 | 修订内容 |
|---|---|---|
| 25.06 | 2025/06/26 | 初稿,新增命令详情 |
ComponentIDEx规则定义
| 序列 | bit位 | 功能 | 描述 |
|---|---|---|---|
| 最高 | bit24-bit31 | ComponentID | 参见 表1 |
| - | bit16-bit23 | 产品 ID ,固件通用升级方案使用00,特定产品专用固件使用对应的产品ID | 参见 产品ID分配表 |
| - | bit8-bit15 | 自定义 | - |
| 最低 | bit0-bit7 | 自定义 | - |
固件升级匹配原则
1、通过ComponentID、ComponentIDEx匹配具体固件类型。
2、通过BoardID、Uid匹配硬件类型。
3、非天池架构,“update.cfg”不承载板卡的BoardID,需要通过ComponentIDEx来区分不同的硬件类型。
“固件类型”用于 Redfish FirmwareInventory,场景如下:
1、资源 Id:路径为 /redfish/v1/UpdateService/FirmwareInventory/<[Position]+[DeviceName]><固件类型>。例如:/redfish/v1/UpdateService/FirmwareInventory/BCU1CpuBoard1HWSR。
2、SoftwareId:命名规范为 <固件类型>-xxx。例如:CPLD-BC82AMDT。
表 1 固件升级ID分配表(ComponentID和ComponentIDEx)
说明:升级包 update.cfg 中的 ComponentID、ComponentIDEx 须填写十进制。表中按 十六进制=十进制 对照列出,便于填写。
| 固件类型 | ComponentID | ComponentIDEx | 功能描述 |
|---|---|---|---|
| CONFIG | 0x00 | - | 升级所需配置文件包support.tar.gz |
| APP | 0x01 | - | app区升级 |
| BIOS | 0x02 | - | BIOS升级 |
| CFG | 0x03 | - | CFG升级 |
| UBOOT | 0x04 | - | uboot升级 |
| CPLD | 0x05 | - | CPLD升级,默认不填写 ComponentIDEx;UpdateFileType |
| CPLD | 0x05 | 0x05000001=83886081 | FPGA Jtag加载,例如:天工HPC刀片。Hi1711直出Jtag,svf格式 |
| CPLD | 0x05 | 0x05000002=83886082 | FPGA并口加载,例如:天工管理板 |
| CPLD | 0x05 | 0x05000003=83886083 | FPGA SFC加载,例如:磁电盘框 |
| CPLD_HDD_BACKPLANE | 0x06 | - | 硬盘背板CPLD升级(前置) |
| IPMC/BMC | 0x07 | - | BMC根文件系统升级(cramfs) |
| 2488H_CPU | 0x08 | - | 2488H |
| 8100_CPU | 0x08 | - | 8100 |
| 9032_CPU | 0x08 | - | - |
| 8100_FIO | 0x09 | - | 8100 |
| 9032_FIO | 0x09 | - | 9032前IO板 |
| ATLAS_NPU_BOARD | 0x09 | - | NPU板CPLD升级组件ID |
| ATLAS_NPU_BOARD | 0x09 | 0x0F=15 | NPU板CPLD升级组件扩展ID(CPLD_NPU_BOARD_IDEX) |
| ATLAS_NPU_BOARD | 0x09 | 0x10=16 | NPU模组CPLD升级组件扩展ID(同步写入所有模组方式,CPLD_NPU_HAM_IDEX1) |
| ATLAS_NPU_BOARD | 0x09 | 0x11=17 | NPU模组CPLD升级组件扩展ID(依次写入所有模组方式,CPLD_NPU_HAM_IDEX2) |
| SOC_FW | 0x09 | - | altas载板模组升级 |
| 8100_BIOS | 0x0A=10 | - | 8100 |
| 9032_BIOS | 0x0A=10 | - | - |
| 8100_BIO | 0x0B=11 | - | 8100 |
| LCD | 0x0C=12 | - | LCD升级 |
| RAID | 0x0D=13 | - | RAID升级 |
| RAID | 0x0D=13 | 0x0D000001=218103809 | SP686 系列固件 |
| FAN | 0x0E=14 | - | FAN升级 |
| 8100_HDD_BACKPLANE_B | 0x0F=15 | - | 8100 |
| 9032_HDD_BACKPLANE_B | 0x0F=15 | - | - |
| RH5885_HDD_BACKPLANE_CD | 0x0F=15 | - | RH5885V3-HV3 |
| host类固件 | 0x10=16 | 0x10000001=268435457 | SP固件 |
| 8100_HDD_BACKPLANE_C | 0x10=16 | - | 已废弃(2023/12/6) |
| 9032_HDD_BACKPLANE_C | 0x10=16 | - | - |
| WBD | 0x11=17 | - | 白牌包 |
| HWSR | 0x11=17 | - | Component Self-Description Record,组件自描述记录 |
| HWSR | 0x11=17 | 0x11000001=285212673 | 预留 |
| HWSR | 0x11=17 | 0x11000002=285212674 | 部件驱动 |
| 9032_BIO | 0x12=18 | - | 9032后IO板 |
| RETIMER_FW | 0x13=19 | - | 9032 |
| DFT_MODE | 0x14=20 | - | 装备模式标识升级,用于深度恢复出厂配置 |
| 8100_HDD_BACKPLANE_D | 0x15=21 | - | 8100 |
| CPLD_HDD_BACKPLANE_EXP | 0x16=22 | - | 扩展的硬盘背板 |
| PSU | 0x17=23 | 0x17000001=385875969 | 天工管理板HDU固件 |
| PSU | 0x17=23 | 0x17100001=386924545 | TCE NP板VRD升级 |
| PSU | 0x17=23 | 0x17100002=386924546 | TCE Mesh板VRD升级 |
| PSU | 0x17=23 | 0x17100003=386924547 | 天工管理板电源砖升级(本板IIC升级,跨板网络升级) |
| CPLD | 0x18=24 | - | 硬盘背板CPLD升级(包含内置和后置) |
| CPLD | 0x18=24 | 0x8=8 | 扩展板CPLD-0 |
| CPLD | 0x18=24 | 0x9=9 | 扩展板CPLD-1 |
| CPLD | 0x18=24 | 0xA=10 | IEU CPLD |
| CPLD | 0x18=24 | 0xFFFFFFFD=4294967293 | CPLD_HDD_COMPONENT_IDEX |
| IPMC_EXT4 | 0x19=25 | - | BMC根文件系统升级(ext4fs) |
| CPLD_BY_I2C | 0x1A=26 | - | RAID卡CPLD升级(通过I2C) |
| I2C_CPLD | 0x1B=27 | - | - |
| PRR_FW | 0x1C=28 | - | PRR固件升级 |
| MCU | 0x1D=29 | 0x0=0 | 板卡MCU固件升级,包括通过MCU升级的固件(如VRD等)。2024.1.9基于V2/V3版本代码实现刷新 |
| MCU | 0x1D=29 | 0x1=1 | NPU MCU |
| MCU | 0x1D=29 | Byte3:0x1=1 | 通过MCU升级NPU固件。Byte2 ~ Byte0:不涉及;Smbus通道。例如:Atlas系列标卡 |
| MCU | 0x1D=29 | Byte3:0x2=2 | 通过MCU升级ECU固件。Byte2 ~ Byte0:不涉及;Mobus通道。例如:RM211管理模块 |
| MCU | 0x1D=29 | Byte3:0x3=3 | 通过MCU升级CPLD固件。Byte2 ~ Byte0:不涉及;Smbus通道。例如:DPU系列卡 |
| MCU | 0x1D=29 | Byte3:0x4=4 | SDI VRD固件。Byte2 ~ Byte0:不涉及 |
| MCU | 0x1D=29 | 0x1D000005=486539269 | VDM固件,通过MCU升级。例如:基础板 |
| MCU | 0x1D=29 | 0x1D000006=486539270 | VRD固件,将串行生效优化为并行生效(通过MCU缓存,缩短中断业务时间)。例如:HPC单机(16个模组) |
| PUB_FW | 0x1E=30 | - | 共享FRU升级 |
| CPLD_182X_EXT_IDEX | 0x0F=15 | - | 计算型存储:全宽计算延伸板CPLD升级函数,182X延申板CPLD升级扩展ID |
| EFUSE | 0x1F=31 | - | - |
| NSBoard | 0x20=32 | 0x20090000=537460736 | 伙伴09的交换类固件 |
| CollectRegister | 0x21=33 | 0x21000001=553648129 | 通过固件管理方式进行CPU寄存器的收集 |
| Disk | 0x22=34 | 0xFFFFFFFF=4294967295 | 硬盘固件,通过 update.cfg 中的 Model 属性匹配具体型号 |
| NIC | 0x23=35 | 0x23000001=587202561 | 1825网卡固件 |
| 通配 | 0xFF=255 | 0xFFFFFFFF=4294967295 | 忽略此属性,通过其他方式匹配固件类型 |
事件ID定义规则
1、openUBMC社区告警定义,“产品ID”使用“通用告警=0”,即公共告警统一告警码,伙伴最大化复用,减少工作量
2、伙伴自定义新增告警时,需要满足伙伴“产品ID”编码分配表,保证伙伴自主增加与华为通用告警不重复。
| 序列 | bit位 | 功能 | 描述 |
|---|---|---|---|
| 最高 | bit24-bit31 | 事件主体类型 | 参见表 设备类型(Component Type) |
| - | bit16-bit23 | 产品 ID | 参见 产品ID分配表 |
| - | bit8-bit15 | 事件偏移,高字节 | - |
| 最低 | bit0-bit7 | 事件偏移,低字节 | 事件偏移,每个事件主体类型的事件统一编号,从1开始 |
产品ID分配表
产品 ID 定义为 1 个字节,取值范围为 0–255(0x00–0xFF)。其中 255(0xFF)禁止分配给产品。
| 产品 | 产品ID分配 | 备注 |
|---|---|---|
| openUBMC | 0 | openUBMC社区通用产品 |
| 华为 | 0x01 | 预留 ,华为出厂整机产品 |
| 同方 | 0x02 | 同方产品 |
| 宝德 | 0x03 | 宝德产品 |
| 长江计算 | 0x04 | 长江 计算产品 |
| H3C/ 紫光恒越 | 0x05 | H3C/ 紫光恒 越产品 |
| 神码 | 0x06 | 神 码产品 |
| 百信 | 0x07 | 百 信产品 |
| 华鲲振宇 | 0x08 | 华鲲振 宇产品 |
| 河南昆仑 | 0x09 | 河南 昆仑产品 |
| 湘江鲲鹏 | 0x0A | 湘江 鲲鹏产品 |
| 黄河 | 0x0B | 黄河产品 |
| 广电运通 | 0x0C | 广电运 通产品 |
| 凌华 | 0x0D | 凌 华产品 |
| 华启 | 0x0E | 华启产品 |
| 华为-存储 | 0x0F | 华为存储产品 |
| 华为-电信 | 0x10 | 华为电信设备 |
| 华为-鲲鹏 | 0x11 | - |
| 华为-昇腾 | 0x12 | - |
| 华为-集群 | 0x13 | - |
| PoDManager | 0x14 | 昇腾控制面产品告警 |
KVM集成
修订记录
| openUBMC版本号 | 修订日期 | 修订内容 |
|---|---|---|
| 25.06 | 2025/06/26 | 初稿,新增命令详情 |
相关命令:
BMC支持浏览器地址URL集成KVM功能,为保证系统正常运行,需要满足运行环境要求、并按照相关步骤完成开发。
环境要求
不同BMC版本存在差异,请以具体版本支持情况为准:
| 运行环境 | 配置要求 |
|---|---|
| 操作系统 | Windows XP 32位 |
| Windows 7 32位/64位 | |
| Windows 8 32位/64位 | |
| Windows Server 2008 R2 64位 | |
| Windows Server 2012 64位 | |
| Redhat 4.3 64位 | |
| Redhat 6.0 64位 | |
| Mac OS X v10.7 | |
| 浏览器 | Internet Explorer 8.0/10.0(仅适用于Windows操作系统),其中Internet Explorer 10.0不支持Windows XP |
| Mozilla Firefox 9.0/23.0 | |
| Chrome 13.0/31.0(仅适用于Windows操作系统) | |
| Safari 5.1(仅适用于MAC操作系统) | |
| Java运行环境 | JRE 1.6.0 U25/1.7.0 U40 |
注意说明
- KVM集成功能适用华为支持KVM功能的服务器。
- 由于客户有可能使用华为多种服务器、多个版本,部分版本服务器可能不支持此调用方式,可能存在兼容性问题。
- 考虑到JAR包的版本配套问题,集成时不建议在本地缓存JAR包,而应该每次打开远程控制台时从服务器BMC下载JAR包(在打开remote_access.asp页面时会自动下载)。
Web 集成
不加密的情况下URL登录KVM
首先设置KVM为非加密状态
设置KVM的加密状态必须要管理员权限。可以在BMC的web上设置,也可以用IPMITool设置,ipmi的设置关闭加密命令:
bashipmitool -I lanplus -U root -P <Password> -H 192.168.2.100 raw 0x30 0x94 0xdb 0x07 0x00 0x21 0x02 0x00 0x00 0x01 0x00参数说明:
-I lan:表示通过网络访问,-I lanplus为加密,lan无加密功能-H 192.168.2.100:BMC的IP地址,此处根据实际情况填写-U root:BMC本地用户名,此处根据实际情况填写-P <Password>:BMC用户密码,此处根据实际情况填写
不是红色字体的部分是头部信息(一般无须修改),红色字体是设置KVM的加密状态:
0x00是非加密状态0x01是加密状态
通过IPMITool设置识别ID
为防止非法用户通过本地KVM控制台连接BMC,并使用KVM功能,BMC需要根据用户识别ID确认用户身份,通过IPMITool工具可以设置识别ID,有两条命令都可以设置ID,使用时只要发送其中任意一种设置命令来设置识别ID即可:
第一种命令:
bashipmitool -I lanplus -H 192.168.2.100 -U root -P <Password> raw 0x30 0x93 0xdb 0x07 0x00 0x04 0x00 0x0 0x0 0x0 0x3 0x72 0x6f 0x6f 0x74 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0参数说明:
-I lan:表示通过网络访问,-I lanplus为加密,lan无加密功能-H 192.168.2.100:BMC的IP地址,此处根据实际情况填写-U root:BMC本地用户名,此处根据实际情况填写-P <Password>:BMC用户密码,此处根据实际情况填写raw 0x30 0x93 0xdb 0x07 0x00 0x04 0x00 0x0 0x0 0x0 0x3 0x72 0x6f 0x6f 0x74 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0:红色字体分成三部分- 第一部分:_红色部分前面的
0x0 0x0 0x0 0x3为识别ID号,小端格式,KVM与控制台通信使用,识别ID的有效时间为2分钟,验证一次后立即失效 - 第二部分:_后面16字节
0x72 0x6f 0x6f 0x74 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0为用户名 - 第三部分:_是最后一个字节代表是用共享模式打开还是独占模式打开KVM
0x00:代表共享模式0x01:代表独占模式
- 第一部分:_红色部分前面的
第二种命令:
bashipmitool -I lanplus -H 192.168.2.100 -U root -P <Password> raw 0x30 0x94 0xdb 0x07 0x00 0x21 0x06 0x00 0x00 0x37 0x00 0x24 0x00 0x00 0x00 0x03 0x06 0xBD 0x43 0x29 0x77 0x3F 0xC3 0x34 0x36 0x75 0x96 0x4B 0x67 0xEE 0x72 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x72 0x6f 0x6f 0x74 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00参数说明:
-I lan:表示通过网络访问,-I lanplus为加密,lan无加密功能-H 192.168.2.100:BMC的IP地址,此处根据实际情况填写-U root:BMC本地用户名,此处根据实际情况填写-P root:BMC用户密码,此处根据实际情况填写raw 0x30 0x94 0xdb 0x07 0x00 0x21 0x06 0x00 0x00 0x37 0x00 0x24 0x00 0x00 0x00 0x03 0x06 0xBD 0x43 0x29 0x77 0x3F 0xC3 0x34 0x36 0x75 0x96 0x4B 0x67 0xEE 0x72 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x72 0x6f 0x6f 0x74 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00:不是红色字体的部分是头部信息(一般无须修改),红色字体分成4部分第一部分:_红色部分前面的
0x0 0x0 0x0 0x3为识别ID号,小端格式。识别ID的有效时间为2分钟,登录一次后直接失效。第二部分:_
0x0 0x0 0x0 0x3后面的32个字节0x06 0xBD 0x43 0x29 0x77 0x3F 0xC3 0x34 0x36 0x75 0x96 0x4B 0x67 0xEE 0x72 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83是加密方式打开的时候会用到,非加密状态下为无效字段,在非加密的状态下可以随意赋值
第三部分:_加密字段的后面的16个字节是用户名
0x72 0x6f 0x6f 0x74 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00第四部分:_是最后一个字节代表是用共享模式打开还是独占模式打开KVM
0x00:代表共享模式0x01:代表独占模式
调用相应的URL(Uniform Resource Locator),URL格式如下:
https:// 192.168.2.100/remote_access.asp?authParam=3&lp=en&openWay=html5其中,URL红色字体表示可根据当前的实际情况进行更改的参数。
参数说明:
192.168.2.100:表示需要访问的BMC的IP地址,可根据实际情况填写authParam:表示之前通过IPMITool设置的识别ID,authParam=3这个3是0x00 0x00 0x00 0x03转成10进制所得注:此处ID号只支持十进制输入
lp:表示当前使用的语言,是中文或者英文,中文参数值注:lp=cn表示中文,lp=en表示英文
openWay:可选参数,表示通过"html5"或"java"方式打开KVM,默认"java"
加密的情况下URL登录KVM
首先设置KVM为加密状态
设置KVM的加密必须要管理员权限。可以在BMC的web上设置,也可以用IPMITool设置,ipmi的设置开启加密命令:
bashipmitool -I lanplus -U root -P <Password> -H 192.168.2.100 raw 0x30 0x94 0xdb 0x07 0x00 0x21 0x02 0x00 0x00 0x01 0x01参数说明:
-I lan:表示通过网络访问,-I lanplus为加密,lan无加密功能-H 192.168.2.100:BMC的IP地址,此处根据实际情况填写-U root:BMC本地用户名,此处根据实际情况填写-P <Password>:BMC用户密码,此处根据实际情况填写
不是红色字体的部分是头部信息(一般无须修改),红色字体是设置KVM的加密状态:
0x00是非加密状态0x01是加密状态
为防止非法用户通过本地KVM控制台连接BMC,并使用KVM功能,BMC需要根据用户识别ID确认用户身份,通过IPMITool工具可以设置识别ID
bashipmitool -I lanplus -H 192.168.2.100 -U root -P <Password> raw 0x30 0x94 0xdb 0x07 0x00 0x21 0x06 0x00 0x00 0x37 0x00 0x24 0x00 0x00 0x00 0x03 0x06 0xBD 0x43 0x29 0x77 0x3F 0xC3 0x34 0x36 0x75 0x96 0x4B 0x67 0xEE 0x72 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x72 0x6f 0x6f 0x74 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00参数说明:
-I lan:表示通过网络访问,-I lanplus为加密,lan无加密功能-H 192.168.2.100:BMC的IP地址,此处根据实际情况填写-U root:BMC本地用户名,此处根据实际情况填写-P root:BMC的root用户密码,此处根据实际情况填写raw 0x30 0x94 0xdb 0x07 0x00 0x21 0x06 0x00 0x00 0x37 0x00 0x24 0x00 0x00 0x00 0x03 0x06 0xBD 0x43 0x29 0x77 0x3F 0xC3 0x34 0x36 0x75 0x96 0x4B 0x67 0xEE 0x72 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x72 0x6f 0x6f 0x74 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00:不是红色字体的部分是头部信息(一般无须修改),红色字体分成3部分第一部分:_红色部分前段的
0x00 0x00 0x00 0x03 0x06 0xBD 0x43 0x29 0x77 0x3F 0xC3 0x34 0x36 0x75 0x96 0x4B 0x67 0xEE 0x72 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83为识别ID号。识别ID的有效时间为2分钟,登录一次后直接失效。第二部分:_ID后面的16个字节是用户名
0x72 0x6f 0x6f 0x74 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00第三部分:_是最后一个字节代表是用共享模式打开还是独占模式打开KVM
0x00:代表共享模式0x01:代表独占模式
KVM与控制台通信使用,识别ID的有效时间为2分钟,登录一次后直接失效。
调用相应的URL(Uniform Resource Locator),URL格式如下:
https://192.168.2.100/remote_access.asp?authParam=0000000306BD4329773FC3343675964B67EE728383838383838383838383838383838383&lp=en&openWay=html5其中,URL红色字体表示可根据当前的实际情况进行更改的参数。其中参数说明:
192.168.2.100:表示需要访问的BMC的IP地址,可根据实际情况填写authParam:表示之前通过IPMITool设置的识别ID,authParam=0000000306BD4329773FC3343675964B67EE728383838383838383838383838383838383后面参数是识别ID0x00 0x00 0x00 0x03 0x06 0xBD 0x43 0x29 0x77 0x3F 0xC3 0x34 0x36 0x75 0x96 0x4B 0x67 0xEE 0x72 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83 0x83直接转换过来的注:此处ID号只支持十六进制输入
lp:表示当前使用的语言,是中文或者英文,中文参数值注:lp=cn表示中文,lp=en表示英文
openWay:可选参数,表示通过"html5"或"java"方式打开KVM,默认"java"
通过token连接Web首页或KVM
申请token
请求
POST/sso HTTP/1.1
参数:username=xxx,password=xxx,logtype=xxx,function=addtoken
参数说明
- username:用户名,最大长度为320个字符
- password:密码,最大长度为20个字符
- logtype:登录用户类型
- local:本地用户
- ldap:LDAP用户
- function:执行动作
token响应
响应
{ret:val, token:val}
参数说明
- ret:返回码,val取值如下
- 0:成功
- 131:用户被锁定
- 136:用户无权限
- 137:密码过期
- 144:登录受限
- 其他:用户名或密码错误
- token:临时验证凭证,固定长度31个字符。登录成功,val为token值,否则val为" "
登录WEB首页或KVM控制台
请求
URL=https://ip[:port]/sso?token=xxx[&redirect=xxx][&kvmmode=xxx]
参数说明
- ip:需要访问的BMC的IP地址,可根据实际情况填写
- port(可选参数):需要访问的BMC的http服务端口,可根据实际情况填写
- token:临时验证凭证
- redirect(可选参数):重定向目标
- index: WEB首页
- console: 远程KVM控制台
- 不输入 "redirect=xxx" 时,默认为index
- kvmmode(可选参数):KVM会话模式
- share:共享模式
- dedicate:独占模式
- 不输入 "kvmmode=xxx" 时,默认为dedicate
通过口令登录失败的情况
| 登录失败情况 | 处理 |
|---|---|
| 当前在线用户数(WEB/KVM)达到支持的最大连接数 | 跳转到WEB登录界面,提示 "已达最大会话数" |
| token失效、无权限、其他错误 | 跳转到WEB登录界面,提示"登录失败,请重试" |