Write File to BMC
更新时间: 2025/06/26
在AtomGit上查看源码09h-向BMC写数据(Write-File-to-BMC)(BT超长帧)
修订记录
| openUBMC版本号 | 修订日期 | 修订内容 |
|---|---|---|
| 25.06 | 2025/06/26 | 初稿,新增命令详情 |
基本信息
功能说明
通过带外通道批量发送数据给BMC(BT超长帧)。
权限
ReadOnly
命令信息
请求信息
| 字节顺序 | 域取值说明 |
|---|---|
| NetFn | 30h |
| CMD | 92h |
| 1:3 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 说明: Internet Assigned Numbers Authority (IANA):因特网地址分配组织 |
| 4 | Sub command,子命令=09h |
| 5 | BIOS ID:预留给多host场景,单host场景固定填0。 |
| 6 | File Selector 00h-Display.ini 01h-Options.ini 04h-image.hpm 08h-ClpConfig0.ini 2Ch-current_secureboot.json 2Dh-ConfigValue.json 2Eh-PolicyConfigRegistry.json other-Reserved 备注:File Selector分配表参见 表1 的文件编码。 |
| 7 | Operation: 00h Write Prepare. 01h Write Data 03h Write Finish |
| (8) | 说明: 本字段可选,仅当Operation为Write Data和Write Finish时需要提供本字段。 Data checksum. 当Operation为Write Data时,本字段表示数据内容累加和。 当Operation为Write Finish时,本字段表示整个文件的累加和。 |
| (9:12) | 说明: 本字段可选,仅当Operation为Write Prepare,Write Data时需要提供本字段。 当Operation为Write Prepare时: File Size, LSB First,文件大小。 当Operation为Write Data时:Offset to write,LSB First,数据段相对于File开始位置的偏移。 |
| (13:n) | Data. 数据内容。 约束条件为:总的IPMI命令长度不能超过254字节,也就是n不大于247(不包含checksum校验)。 本字段可选,仅当Operation为Write Data时需要提供本字段。 |
表1
| ID | file name | upload | download | 备注 |
|---|---|---|---|---|
| 00h | bios display0.ini | Y | Y | - |
| 01h | bios option0.ini | Y | Y | - |
| 02h | bios changed0.ini | Y | Y | - |
| 03h | ibmcbmc debug info | N | Y | 一键收集信息文件 |
| 04h | Firmware | Y | N | 包括iBMCBMC、BIOS、CPLD等固件升级镜像。 |
| 05h | bios netconfig.ini | Y | Y | - |
| 06h | ibmcbmc sol.dat | N | Y | - |
| 07h | ibmcbmc blackbox.tar | N | Y | - |
| 08h | BIOS ClpConfig.ini | N | Y | - |
| 09h | BIOS ClpResponse.ini | Y | N | - |
| 0ah | BMA systeminfo.txt | Y | Y | - |
| 0bh | powerview.txt | N | Y | - |
| 0ch | bios configsync.ini | Y | Y | 用于9032产品主从节点BIOS同步setup配置,启动时主节点BIOS的设置菜单配置发给主节点iBMCBMC,主节点iBMCBMC同步到从节点iBMCBMC,从节点BIOS从从节点iBMCBMC获取并更新。 |
| 0dh | ibmcbmc sshpublickey | Y | N | - |
| 0eh | SSL服务器证书 | Y | N | - |
| 0fh | 导入导出配置(iBMCBMC/BIOS等) | Y | Y | - |
| 10h | 服务器证书的CSR | N | Y | - |
| 11h | 一键收集日志信息 | N | Y | - |
| 12h | LDAP服务端根证书 | Y | N | - |
| 13h | 双因子认证根证书 | Y | N | - |
| 14h | 双因子认证用户的客户端证书 | Y | N | - |
| 15h | Syslog服务端根证书 | Y | N | - |
| 16h | Syslog本地证书 | Y | N | - |
| 18h | NTP组密钥 | Y | N | - |
| 19h | bios registry.json | Y | Y | BIOS设置菜单注册文件 |
| 1Ah | bios currentvalue.json | Y | Y | BIOS设置菜单项当前值文件 |
| 1Bh | bios setting.json | Y | Y | BIOS设置菜单项修改预期值文件 |
| 1Ch | bios result.json | Y | Y | BIOS设置菜单项修改结果文件 |
| 1Dh | weakdictionary | Y | Y | 弱口令字典 |
| 1Eh | CMES.dat | Y | N | 部件号CMES文件 |
| 1Fh | logo.jpg | Y | N | iBMCBMC logo |
| 20h | favicon.ico | Y | N | 浏览器ico |
| 21h | code1.png | Y | N | 二维码 |
| 22h | web_custom.xml | Y | N | 白牌配置文件 |
| 23h | CustomizeSensor.xml | Y | N | 传感器名配置文件 |
| 24h | customize.pfx | Y | N | 证书(参考白牌升级) |
| 25h | style_config.json | Y | N | 主界面风格 |
| 26h | login.png | Y | N | 背景图片 |
| 27h | login_logo.png | Y | N | 登录界面iBMCBMC图标 |
| 28h | img_01.png或img_02.png等 | Y | N | 主界面机型展示图片 |
| 29h | header_logo.png | Y | N | 主界面左上角iBMCBMC图片 |
| 2Ah | bios silkconfig.json | N | Y | 整合丝印信息文件 |
| 2Bh | bios new_secureboot.json | N | Y | Bios待生效安全启动配置 |
| 2Ch | bios current_secureboot.json | Y | N | Bios当前已生效安全启动配置 |
| 2Dh | bios ConfigValue.json | Y | Y | Bios策略重配设置菜单当前值文件 |
| 2Eh | bios PolicyConfigRegistry.json | Y | Y | Bios策略重配设置菜单注册文件 |
| 2Fh | 电源信息查询,PsuInfo.json | N | Y | 电源信息查询 |
| 30h | 服务器bios定制化配置文件,bios_custom_settings.json | Y | Y | 服务器bios定制化配置文件 |
响应信息
| 字节顺序 | 域取值说明 |
|---|---|
| 1 | Completion Code 00h Command Completed Normally 80h Invalid Checksum 81h Wrong Data Offset D5h Invalid Status |
| 2:4 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 |
| (5:8) | Required offset. 请求BIOS开始重传的偏移地址。 本字段可选,当完成码为81h的时候,才需要提供本字段, |
命令样例
批量配置BIOS数据
请求:
ipmicmd -k "0f 00 30 92 db 07 00 09 00 01 00 01" smi 0响应:
0f 31 00 92 00 db 07 00