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

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

LswPortInfo 类

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

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
UnitU32--交换芯片ID指定端口所属的交换芯片0CSR配置软件
LogicIdU32--端口逻辑ID端口逻辑标识显示0CSR配置软件
PhysicalIdU32--端口物理ID端口物理标识显示1CSR配置软件
PortTypeU32--端口类型端口类型配置1CSR配置软件
ExtModeU32--扩展模式端口扩展模式配置0CSR配置软件
ConPhyAddrU32--连接物理地址端口连接物理地址配置0CSR配置软件
LinkCheckBooleantrue/false-链路检查端口链路检查配置trueCSR配置软件
PortIsoU32--端口隔离端口隔离配置0CSR配置软件
PVidU32--端口VLAN ID端口默认VLAN ID配置1CSR配置软件
AccFrameTypeU32--接收帧类型端口接收帧类型配置0CSR配置软件
ExportPortBooleantrue/false-是否导出端口端口导出标记配置falseCSR配置软件

可选属性

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

🔗 动态关联机制

语法规范

使用 #/xxx<=/xxx 格式实现属性间的动态关联:

yaml
# 语法格式
属性名: "#/目标类.属性名"     # 直接关联
属性名: "<=/目标类.属性名"    # 条件关联

# LswPortInfo类当前无动态关联配置

关联说明

  • 暂无动态关联: LswPortInfo类当前所有属性均为静态配置,无需关联其他组件或扫描器

📂 分类标准

硬件属性

  • 定义:直接从硬件获取或控制硬件的参数
  • 特点:实时反映硬件状态,支持硬件控制操作
  • 示例LinkCheck, ConPhyAddr, PortIso

软件属性

  • 定义:用于软件层面的端口管理和配置
  • 特点:包含标识、配置、状态管理等功能
  • 示例Unit, LogicId, PhysicalId, PortType, ExtMode, PVid, AccFrameType, ExportPort

📝 配置示例

标准单端口配置

json
{
  "LswPortInfo": {
    "Unit": 0,
    "LogicId": 0,
    "PhysicalId": 1,
    "PortType": 1,
    "ExtMode": 0,
    "ConPhyAddr": 0,
    "LinkCheck": true,
    "PortIso": 0,
    "PVid": 1,
    "AccFrameType": 0,
    "ExportPort": false
  }
}

多端口配置(端口1)

json
{
  "LswPortInfo1": {
    "Unit": 0,
    "LogicId": 0,
    "PhysicalId": 1,
    "PortType": 1,
    "ExtMode": 0,
    "ConPhyAddr": 0,
    "LinkCheck": true,
    "PortIso": 0,
    "PVid": 1,
    "AccFrameType": 0,
    "ExportPort": false
  }
}

多端口配置(端口2)

json
{
  "LswPortInfo2": {
    "Unit": 0,
    "LogicId": 1,
    "PhysicalId": 2,
    "PortType": 1,
    "ExtMode": 0,
    "ConPhyAddr": 1,
    "LinkCheck": true,
    "PortIso": 0,
    "PVid": 1,
    "AccFrameType": 0,
    "ExportPort": false
  }
}

🔧 使用指南

配置步骤

  1. 设置基本标识:配置Unit、LogicId、PhysicalId指定端口标识信息
  2. 配置端口类型:设置PortType指定端口类型
  3. 设置扩展模式:配置ExtMode指定端口扩展模式
  4. 配置连接地址:设置ConPhyAddr指定端口连接物理地址
  5. 设置链路检查:配置LinkCheck指定链路检查状态
  6. 配置端口隔离:设置PortIso指定端口隔离参数
  7. 设置VLAN配置:配置PVid、AccFrameType指定端口VLAN和帧类型
  8. 配置导出标记:设置ExportPort指定是否为导出端口

注意事项

  • ID唯一性:LogicId在交换芯片内必须唯一,PhysicalId与物理端口对应
  • VLAN配置:PVid指定端口默认VLAN ID,需与VLAN配置一致
  • 链路检查:LinkCheck为Boolean类型,true表示启用链路检查
  • 端口隔离:PortIso用于端口间隔离控制,防止不必要的流量转发
  • 帧类型:AccFrameType决定端口接收的帧类型,需与网络规划一致
  • 导出端口:ExportPort标记端口是否为导出端口,影响端口流量转发策略

性能建议

  • 链路监控:合理设置LinkCheck的检查策略
  • 端口隔离:根据网络拓扑合理配置PortIso
  • VLAN规划:PVid需与整体VLAN规划保持一致
  • 资源优化:根据实际业务需求配置端口参数

ID体系说明

  • Unit (U32): 端口所属交换芯片ID,标识端口归属
  • LogicId (U32): 端口逻辑ID,交换芯片内唯一
  • PhysicalId (U32): 端口物理ID,与物理端口对应

端口配置机制

  • PortType: 端口类型管理
  • ExtMode: 扩展模式管理
  • ConPhyAddr: 连接物理地址管理
  • LinkCheck: 链路检查管理
  • PortIso: 端口隔离管理
  • PVid: 端口VLAN ID管理
  • AccFrameType: 接收帧类型管理
  • ExportPort: 导出端口标记管理

常见问题

  • Q: LogicId和PhysicalId有什么区别?
    • A: LogicId是端口逻辑标识,用于软件管理;PhysicalId是端口物理标识,与物理端口对应
  • Q: LinkCheck为true时做什么?
    • A: 启用链路检查后,系统会定期检测端口链路状态,及时发现链路异常
  • Q: PortIso端口隔离如何配置?
    • A: PortIso通过位图方式配置端口隔离关系,不同位代表不同的隔离组
  • Q: AccFrameType接收帧类型有哪些?
    • A: AccFrameType决定端口接收的帧类型,常见值包括接收所有帧、仅接收标记帧、仅接收未标记帧等