bmc_soc ​

版本信息 ​

1. 组件概述 ​

1.1 组件简介 ​

BMC SOC管理为BMC基本功能特性，主要提供BMC片上资源的管理和监控功能，包括UART串口管理、串口连接管理、NAND Flash健康管理、SOC状态监控、生产自检等功能。

1.2 解决什么问题 ​

bmc_soc主要涉及与芯片相关的功能，包括串口管理、串口日志导出、efuse升级、温度信息、同步DIEID信息、电源事件、nandflash监控等功能。对于串口管理、串口日志导出、nandflash写保护、PCIe通道使能、Efuse升级等功能均通过调用soctrl组件来实现；对于获取BMC的自检结果、BMC核温、BMC复位原因、DIEID信息、nandflash信息（厂商、EMMC型号、寿命、写入量、擦写次数）等数据，通过调用libsoc_adapter库方法来实现。

1.3 核心功能 ​

• UART串口管理

支持BMC多个UART串口的配置和管理，包括串口参数配置（波特率、数据位、校验位、停止位）和串口连接管理。支持串口数据的监听和日志记录功能。

• 串口连接管理

提供串口源和目的地的动态连接管理，支持串口连接的持久化策略（掉电保留/复位保留），支持面板串口SwitchCMD命令切换。

• NAND Flash健康管理

对BMC的NAND Flash存储介质进行健康度监控，包括寿命监控、擦写次数统计、坏块管理、写保护等功能，支持Flash健康度告警。

• SOC状态监控

监控SOC芯片的工作状态，包括温度监控、黑匣子功能、PCIe控制器使能、DDR自检结果、启动时间等关键指标。

1.4 关键术语表 ​

2. API 使用说明与示例 ​

2.1 资源协作接口概览 ​

2.1.1 SOC串口端口资源协作接口 ​

资源协作接口：

path: /bmc/kepler/Managers/${ManagerId}/UartPorts/${Id}

interface: bmc.kepler.Managers.UartPort

properties

methods

2.1.2 SOC串口数据配置资源协作接口 ​

path:/bmc/kepler/Managers/${ManagerId}/UartData

interface: bmc.kepler.Managers.UartData

properties

methods

2.1.3 SOC串口互联配置资源协作接口 ​

path:/bmc/kepler/Managers/${ManagerId}/SerialManagement

interface: bmc.kepler.Managers.SerialManagement.Config

methods

2.1.4 SOC串口互联关系资源协作接口 ​

path:/bmc/kepler/Managers/${ManagerId}/SerialManagement/${Id}

interface: bmc.kepler.Managers.SerialManagement

properties

methods

2.1.5 SOC Flash资源协作接口 ​

path:/bmc/kepler/Managers/:ManagerId/NandFlash

interface: bmc.kepler.Managers.NandFlash

properties

methods

2.1.6 SOC 资源协作接口 ​

path:/bmc/kepler/Managers/:ManagerId/SOC

interface: bmc.kepler.Managers.SOC

properties

2.2 Reset ​

功能说明 ​

打开启动UART设备，并对设备进行参数设置等初始化。

参数说明 ​

返回值与异常 ​

应用场景 ​

打开启动UART设备，并对设备进行参数设置等初始化。

调试示例 ​

命令行调试 ​

busctl --user call bmc.kepler.bmc_soc /bmc/kepler/Managers/1/UartPorts/Uart_0_01 bmc.kepler.Managers.UartPort Reset a{ss} 0

响应：无

2.3 Export ​

功能说明 ​

导出串口日志。

参数说明 ​

返回值与异常 ​

应用场景 ​

导出串口日志，前提是日志使能开关打开。

调试示例 ​

命令行调试 ​

busctl --user call bmc.kepler.bmc_soc /bmc/kepler/Managers/1/UartData bmc.kepler.Managers.UartData Export a{ss}ss 0 'SYS COM' '/tmp/ee.txt'

响应：u 2088034522

2.4 Reset ​

功能说明 ​

恢复串口管理配置。

参数说明 ​

返回值与异常 ​

应用场景 ​

恢复串口管理配置。

调试示例 ​

命令行调试 ​

busctl --user call bmc.kepler.bmc_soc /bmc/kepler/Managers/1/SerialManagement bmc.kepler.Managers.SerialManagement.Config Reset a{ss} 0

响应：0

2.5 SetConnectStatus ​

功能说明 ​

设置串口链路状态。

参数说明 ​

返回值与异常 ​

应用场景 ​

设置串口链路状态。

调试示例 ​

命令行调试 ​

busctl --user call bmc.kepler.bmc_soc /bmc/kepler/Managers/1/SerialManagement/SerialManagement_5_00 bmc.kepler.Managers.SerialManagement SetConnectStatus a{ss}b 0 false

响应：无

2.6 ClearStatistics ​

功能说明 ​

清除写入量统计。

参数说明 ​

返回值与异常 ​

应用场景 ​

清除写入量统计。

调试示例 ​

命令行调试 ​

busctl --user call bmc.kepler.bmc_soc /bmc/kepler/Managers/1/NandFlash bmc.kepler.Managers.NandFlash ClearStatistics a{ss} 0

响应：无

2.7 SetDebugValue ​

功能说明 ​

调试模式下设置参数。

参数说明 ​

返回值与异常 ​

应用场景 ​

调试模式下设置参数。

调试示例 ​

命令行调试 ​

busctl --user call bmc.kepler.bmc_soc /bmc/kepler/Debug/Managers/1/NandFlashMock bmc.kepler.Debug.Managers.NandFlashMock SetDebugValue a{ss}yyuutu 0 50 2 60 30 10 60

响应：无

3. 组件扩展案例 ​

4 CSR配置介绍 ​

4.1 SerialManagement 对象配置介绍 ​

此对象用于配置串口链路连接管理，表名：t_serial_management。

4.2 UartCircularLog对象配置介绍 ​

此对象用于配置UART循环日志功能。

4.3 NandInfo对象配置介绍 ​

此对象用于配置NAND Flash的基本信息。

4.4 BMCFileSystemCheck对象配置介绍 ​

此对象用于配置BMC文件系统健康检查功能。

4.5 SerialSwitchAction对象配置介绍 ​

此对象用于配置串口切换动作的寄存器关联。

4.6 McuLog对象配置介绍 ​

此对象用于配置MCU日志相关参数。

4.7 UartDynamicConfig对象配置介绍 ​

此对象用于配置支持动态配置的串口参数。

4.8 NandFlashRecord对象配置介绍 ​

此对象用于记录NAND Flash的历史数据，表类型为PoweroffPer。

5. 日志说明 ​

5.1 一键日志收集 ​

5.2 关键日志信息 ​

6. 问题定界指南 ​

6.1 典型问题定界 ​

6.2 调试方法 ​

开启调试日志 ​

busctl资源协作接口方法调试见文档第二章节

查看串口连接

ipmcget -d serialdir

切换串口

ipmcset -d serialdir -v

Usage: ipmcset -d serialdir -v <option> [-s <systemid>]
Options are:
 0 Serial switch from PANEL COM to SYS COM
 1 Serial switch from SOL COM to SYS COM
 2 Serial switch from SOL COM to BMC COM
 3 Serial switch from PANEL COM to BMC COM
 4 Serial switch from SOL COM to CARD COM1
 5 Serial switch from SOL COM to CARD COM2
 254 Serial switch from PANEL COM to CLOSE

切换SOL

ipmcset -t sol -d ac -v
Usage: ipmcset -t sol -d activate -v <option> <mode> [-s <systemid>]
Options are:
    1 SYS COM
    2 BMC COM
    4 CARD COM1
    5 CARD COM2
Mode :
    0 Shared mode
    1 Private mode

导出串口数据

/redfish/v1/Managers/:managerid/DiagnosticService/Actions/DiagnosticService.ExportSerialPortData

ipmcget -d systemcom

7. 常见问题解答 ​

Q1：NAND Flash寿命监控告警 ​

关键日志: NAND Flash寿命低于阈值时，系统会产生告警信息。

处理方法:

• 检查 NandInfo 对象中的 LifeThreshold 配置

• 查看 NandFlash 资源协作接口的 LifeTime 和 PreEOL 属性

• 关注 NandFlashRecord 表中的历史数据记录

Q2：SOC温度过高 ​

关键日志: SOC温度超过 TemperatureThreshold 阈值时触发告警。

处理方法:

• 检查SOC资源协作接口的 Temperature 和 TemperatureThreshold 属性

• 根据需要调整 CoreEnableTemp 和 CoreDisableTemp 配置

• 当温度过高时，SOC可能自动关闭部分核心以降低温度

Q3：串口连接状态异常 ​

关键日志: 串口连接状态与预期不符时产生告警。

处理方法:

• 检查 SerialManagement 资源协作接口的连接状态

• 验证 RetainedPolicy 配置（掉电保留/复位保留）

• 检查 CPLDValue 和 ConnectMode 配置是否正确

附录 ​

附录A 参考资料 ​

• 《UartDynamicConfig类配置字典》

• 《串口参数动态改配机制》

附录B 修订记录 ​