CSR配置字典之LswSwitchInfo类
更新时间: 2025/07/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | LswSwitchInfo类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2025-01-27 |
| 最后更新 | 2026-06-22 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-06-22 | 初始版本 | 创建LswSwitchInfo类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
LswSwitchInfo 类
| 属性 | 值 |
|---|---|
| 类名称 | LswSwitchInfo |
| 功能描述 | 交换芯片信息配置对象 |
| 所属SIG组 | network |
| 所属组件 | 交换板管理 |
| 责任人 | 系统架构组 |
| 最后更新 | 2026-06-22 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Unit | U32 | 无 | - | - | 交换芯片ID | 指定交换芯片的编码 | 0 | CSR配置 | 软件 |
Type | U32 | 无 | - | - | 交换芯片类型 | 交换芯片类型显示 | 1 | CSR配置 | 软件 |
ChipRst | U8 | 无 | - | - | 芯片复位状态 | 交换芯片复位控制 | 0 | CSR配置 | 软件 |
PowerState | U8 | 无 | - | - | 电源状态 | 交换芯片电源状态显示 | 1 | CSR配置 | 软件 |
ErrorCode | U8 | 无 | - | - | 错误码 | 交换芯片错误码显示 | 0 | CSR配置 | 软件 |
HealthState | U8 | 无 | - | - | 健康状态 | 交换芯片健康状态告警配置 | 1 | CSR配置 | 软件 |
SlotNumber | U8 | 无 | - | - | 槽位号 | 交换芯片槽位号显示 | 1 | CSR配置 | 软件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
| 暂无 | - | - | - | - | - | - | - | - | - |
🔗 动态关联机制
语法规范
使用 #/xxx 和 <=/xxx 格式实现属性间的动态关联:
yaml
# 语法格式
属性名: "#/目标类.属性名" # 直接关联
属性名: "<=/目标类.属性名" # 条件关联
# LswSwitchInfo类当前无动态关联配置关联说明
- 暂无动态关联: LswSwitchInfo类当前所有属性均为静态配置,无需关联其他组件或扫描器
📂 分类标准
硬件属性
- 定义:直接从硬件获取或控制硬件的参数
- 特点:实时反映硬件状态,支持硬件控制操作
- 示例:
ChipRst,PowerState,ErrorCode,HealthState
软件属性
- 定义:用于软件层面的交换芯片管理和配置
- 特点:包含标识、配置、状态管理等功能
- 示例:
Unit,Type,SlotNumber
📝 配置示例
标准单交换芯片配置
json
{
"LswSwitchInfo": {
"Unit": 0,
"Type": 1,
"ChipRst": 0,
"PowerState": 1,
"ErrorCode": 0,
"HealthState": 1,
"SlotNumber": 1
}
}多交换芯片配置(芯片1)
json
{
"LswSwitchInfo1": {
"Unit": 0,
"Type": 1,
"ChipRst": 0,
"PowerState": 1,
"ErrorCode": 0,
"HealthState": 1,
"SlotNumber": 1
}
}多交换芯片配置(芯片2)
json
{
"LswSwitchInfo2": {
"Unit": 1,
"Type": 2,
"ChipRst": 0,
"PowerState": 1,
"ErrorCode": 0,
"HealthState": 1,
"SlotNumber": 2
}
}🔧 使用指南
配置步骤
- 设置基本标识:配置Unit指定交换芯片ID
- 配置芯片类型:设置Type指定交换芯片类型
- 设置复位状态:配置ChipRst指定芯片复位状态
- 配置电源与健康:设置PowerState、ErrorCode、HealthState
- 设置槽位信息:配置SlotNumber指定交换芯片槽位号
注意事项
- Unit唯一性:Unit在交换板内必须唯一,用于标识不同的交换芯片
- 芯片复位:ChipRst用于控制交换芯片的复位操作,复位后芯片状态需重新初始化
- 健康状态:HealthState反映交换芯片的整体健康状况,需与其他状态属性配合使用
- 槽位对应:SlotNumber应与物理槽位实际对应
性能建议
- 芯片监控:合理设置HealthState的检查频率
- 复位操作:ChipRst复位操作需谨慎,避免频繁复位影响业务
- 错误处理:及时处理ErrorCode反馈的错误信息
- 资源优化:根据实际需求配置交换芯片参数
ID体系说明
- Unit (U32): 交换芯片全局唯一标识
- SlotNumber (U8): 物理槽位号,标识交换芯片所在的物理位置
状态管理机制
- ChipRst: 芯片复位状态管理
- PowerState: 电源状态管理
- ErrorCode: 错误码状态管理
- HealthState: 健康状态管理
常见问题
- Q: Unit和SlotNumber有什么区别?
- A: Unit是交换芯片的逻辑ID,SlotNumber是物理槽位号,两者分别用于逻辑管理和物理定位
- Q: ChipRst复位后需要做什么?
- A: 复位后需重新初始化交换芯片的端口、VLAN等配置
- Q: HealthState如何判断芯片健康?
- A: HealthState综合了芯片的多项状态指标,正常值为1,异常时需结合ErrorCode排查
- Q: 多交换芯片场景如何配置?
- A: 通过不同的Unit值区分各交换芯片,SlotNumber与物理槽位对应