CSR配置字典之LswSwitchInfo类
更新时间: 2025/07/22
在Gitcode上查看源码

📋 文档信息

项目内容
文档标题LswSwitchInfo类配置字典
版本v1.0
创建日期2025-01-27
最后更新2026-06-22
维护状态✅ 活跃维护

📋 变更历史记录

文档变更记录

版本发布日期变更类型变更内容影响范围维护人员
v1.02026-06-22初始版本创建LswSwitchInfo类配置字典全新文档系统管理员

🎯 类概览

LswSwitchInfo 类

属性
类名称LswSwitchInfo
功能描述交换芯片信息配置对象
所属SIG组network
所属组件交换板管理
责任人系统架构组
最后更新2026-06-22
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
UnitU32--交换芯片ID指定交换芯片的编码0CSR配置软件
TypeU32--交换芯片类型交换芯片类型显示1CSR配置软件
ChipRstU8--芯片复位状态交换芯片复位控制0CSR配置软件
PowerStateU8--电源状态交换芯片电源状态显示1CSR配置软件
ErrorCodeU8--错误码交换芯片错误码显示0CSR配置软件
HealthStateU8--健康状态交换芯片健康状态告警配置1CSR配置软件
SlotNumberU8--槽位号交换芯片槽位号显示1CSR配置软件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
暂无---------

🔗 动态关联机制

语法规范

使用 #/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
  }
}

🔧 使用指南

配置步骤

  1. 设置基本标识:配置Unit指定交换芯片ID
  2. 配置芯片类型:设置Type指定交换芯片类型
  3. 设置复位状态:配置ChipRst指定芯片复位状态
  4. 配置电源与健康:设置PowerState、ErrorCode、HealthState
  5. 设置槽位信息:配置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与物理槽位对应