CSR配置字典之UartDynamicConfig类
更新时间: 2026/05/11
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | UartDynamicConfig类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026/05/11 |
| 最后更新 | 2026/05/11 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026/05/11 | 初始版本 | 创建UartDynamicConfig类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
UartDynamicConfig 类
| 属性 | 值 |
|---|---|
| 类名称 | UartDynamicConfig |
| 功能描述 | 动态系统串口参数配置,用于动态改配硬件下发的系统串口参数 |
| 所属SIG组 | bmc_core |
| 所属组件 | bmc_soc |
| 责任人 | bmc_soc组件 |
| 最后更新 | 2026/05/11 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
SysComId | U8 | - | 0~31 | - | 支持动态配置的系统输入端口Id | Uart:0~15, Port:16~31(其中Port口换算为+16,如Port1的SysComId为17) | 0 | CSR | 软件 |
RawConfigData | U64 | 0 | U64 | 基础板相应系统串口对应的动态参数SMC命令字 | 从cpld读到的串口参数原始数据 | <=/Scanner_Chan0Conf.Value | CSR | 硬件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
BaudRate | U32 | 115200 | U32 | - | 从cpld获取到的串口波特率配置 | 配置波特率 | 115200 | CSR | 软件 |
DataBit | U8 | 8 | U8 | - | 从cpld获取到的串口数据位长配置 | 配置数据位 | 8 | CSR | 软件 |
ParityBit | U8 | 78 | U8 | - | 从cpld获取到的串口校验开关配置 | 配置校验位 | 78 | CSR | 软件 |
StopBit | U8 | 1 | U8 | - | 从cpld获取到的串口停止位配置 | 配置停止位 | 1 | CSR | 软件 |
FlowControl | U8 | 0 | U8 | - | 从cpld获取到的串口控制流配置 | 配置流控 | 0 | CSR | 软件 |
🔗 动态关联机制
语法规范
UartDynamicConfig类主要通过静态配置和同步语法来管理:
yaml
# 基础配置示例
"SysComId": 0 # 表示硬件上系统串口接在bmc插卡的Uart0上
"RawConfigData": "<=/Scanner_Chan0Conf.Value"关联说明
RawConfigData: 用于维护从cpld读到的串口参数原始数据
📂 分类标准
硬件属性
- 定义:直接从硬件获取的参数
- 特点:控制系统串口的参数配置
- 示例:
RawConfigData
软件属性
- 定义:用于软件层面的动态串口管理和配置
- 特点:包含标识
Id,表示cpld连接到bmc插卡的端口号 - 示例:
SysComId
📝 配置示例
串口动态配置
json
{
"UartDynamicConfig": {
"SysComId": 0,
"RawConfigData": 0,
"BaudRate": 115200,
"DataBit": 8,
"ParityBit": 78,
"StopBit": 1,
"FlowControl": 0
}
}🔧 使用指南
配置步骤
- 确定系统串口编号:明确硬件上cpld的串口传输数据是连接到bmc插卡的什么口上。
Uart:0~15,Port:16~31(其中Port口换算为+16,如Port1的SysComId为17) - 确定Smc命令字:不同Host端口会对应不同的命令字偏移,需要与当前系统节点相对应
注意事项
- 系统端口一致性:
UartDynamicConfig的SysComId需与platform.sr中的SerialManagement对象的"SYS COM"对应端口号一致 Uart对象配置完备:所有涉及到的需要一同改配的Uart对象均需在root.sr中配置,如当支持串口参数动态改配,Uart_5(即SOL)需要配置
故障排除
连接Sol与系统串口后串口输出乱码:
- 检查
platform.sr中是否适配Uart_5对象 - 检查cpld上报smc中串口参数是否为bios下发配置
- 检查
连接面板串口与系统串口后串口输出乱码:
- 检查串口线连接对端终端工具中串口参数设置是否已于bios下发配置相符
- 检查cpld上报smc中串口参数是否为bios下发配置