CSR配置字典之SerialManagement类
更新时间： 2026/05/11
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | SerialManagement类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026/05/11 |
| 最后更新 | 2026/05/11 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026/05/11 | 初始版本 | 创建SerialManagement类配置字典 | 全新文档 | bmc_soc组件组 |
🎯 类概览
SerialManagement 类
| 属性 | 值 |
|---|---|
| 类名称 | SerialManagement |
| 功能描述 | 串口连接管理配置，支持源串口、目标串口、连接状态、持久化策略等配置 |
| 所属SIG组 | hardware |
| 所属组件 | bmc_soc |
| 责任人 | 基础服务组 |
| 最后更新 | 2026/05/11 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
SerialManagement 类 - 必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Id | U8 | - | U8 | - | 串口链路的Id | 配置串口链路的Id | 0 | CSR | 软件 |
Availability | U8 | - | U8 | - | 串口链路的可用性 | 配置串口链路的可用性 | 1 | CSR | 软件 |
Source | String | - | String | - | 链路关系源端 | 配置链路关系源端 | "PANEL COM" | CSR | 软件 |
Destination | String | - | String | - | 链路关系对端 | 配置链路关系对端 | "openUBMC COM" | CSR | 软件 |
SrcSerial | U8 | - | U8 | - | 源Uart或Port口，其中取值大于16是Port，否则是Uart | 配置源串口编号 | 18 | CSR | 软件 |
DestSerial | U8 | - | U8 | - | 目标串口编号 | 配置目标串口编号 | 2 | CSR | 软件 |
SourceId | U8 | - | U8 | - | 目的Uart或Port口，其中取值大于16是Port，否则是Uart | 配置源端标识 | 1 | CSR | 软件 |
DestinationId | U8 | - | U8 | - | 目标标识 | 配置目标端标识 | 2 | CSR | 软件 |
ConnectStatus | U8 | - | U8 | - | 掉电保留的串口连接状态 | 配置连接状态 | 0 | CSR | 软件 |
SerialManagement 类 - 可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
CPLDValue | U8 | 255 | U8 | - | 切换串口方向寄存器的值 | 配置寄存器值 | 255 | CSR | 软件 |
ConnectMode | U8 | 0 | U8 | - | 串口连接方式 | 配置连接模式 | 0 | CSR | 软件 |
ListenSwitchCmdEnabled | Boolean | false | true/false | - | 面板串口SwitchCMD命令使能 | 配置监听开关 | false | CSR | 软件 |
ConnectStatusResetPer | U8 | - | U8 | - | 复位保留的串口连接状态 | 配置复位后状态 | 0 | CSR | 软件 |
RetainedPolicy | U8 | - | 0/1 | - | 串口的持久化方案：0-掉电保留，1-复位保留 | 配置持久化策略 | 0 | CSR | 软件 |
ListenSwitchCmd | String | - | String | - | 面板串口SwitchCMD命令 | 配置监听命令 | "switch" | CSR | 软件 |
📝 配置示例
串口连接管理配置
json
{
"SerialManagement": {
"Id": 0,
"Availability": 1,
"Source": "UART4 COM",
"SourceId": 2,
"Destination": "CARD COM",
"DestinationId": 13,
"SrcSerial": 1,
"DestSerial": 2,
"ConnectStatus": 0,
"ConnectStatusResetPer": 0,
"RetainedPolicy": 0,
"CPLDValue": 255,
"ConnectMode": 0,
"ListenSwitchCmdEnabled": false,
"ListenSwitchCmd": "switch"
}
}🔧 使用指南
配置步骤
- 配置串口连接标识：设置 Id 确定连接编号
- 配置源目标串口：设置 SourceId/DestinationId 和 SrcSerial/DestSerial
- 配置持久化策略：设置 RetainedPolicy 选择掉电保留或复位保留
- 配置连接模式：设置 ConnectMode 选择连接方式
- 配置监听功能：设置 ListenSwitchCmdEnabled 和 ListenSwitchCmd
注意事项
- 持久化策略 RetainedPolicy=0 表示掉电保留，RetainedPolicy=1 表示复位保留
- CPLDValue 用于控制串口方向寄存器，需根据硬件设计配置
- 连接状态 ConnectStatus 在掉电或复位后会根据 RetainedPolicy 恢复
故障排查
- 串口连接不稳定：检查 ConnectMode 和 CPLDValue 配置
- 连接状态丢失：检查 RetainedPolicy 配置是否正确