CSR配置字典之LswPortInfo类
更新时间: 2025/07/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | LswPortInfo类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2025-01-27 |
| 最后更新 | 2026-06-22 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-06-22 | 初始版本 | 创建LswPortInfo类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
LswPortInfo 类
| 属性 | 值 |
|---|---|
| 类名称 | LswPortInfo |
| 功能描述 | 交换板端口信息配置对象 |
| 所属SIG组 | network |
| 所属组件 | 交换板管理 |
| 责任人 | 系统架构组 |
| 最后更新 | 2026-06-22 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Unit | U32 | 无 | - | - | 交换芯片ID | 指定端口所属的交换芯片 | 0 | CSR配置 | 软件 |
LogicId | U32 | 无 | - | - | 端口逻辑ID | 端口逻辑标识显示 | 0 | CSR配置 | 软件 |
PhysicalId | U32 | 无 | - | - | 端口物理ID | 端口物理标识显示 | 1 | CSR配置 | 软件 |
PortType | U32 | 无 | - | - | 端口类型 | 端口类型配置 | 1 | CSR配置 | 软件 |
ExtMode | U32 | 无 | - | - | 扩展模式 | 端口扩展模式配置 | 0 | CSR配置 | 软件 |
ConPhyAddr | U32 | 无 | - | - | 连接物理地址 | 端口连接物理地址配置 | 0 | CSR配置 | 软件 |
LinkCheck | Boolean | 无 | true/false | - | 链路检查 | 端口链路检查配置 | true | CSR配置 | 软件 |
PortIso | U32 | 无 | - | - | 端口隔离 | 端口隔离配置 | 0 | CSR配置 | 软件 |
PVid | U32 | 无 | - | - | 端口VLAN ID | 端口默认VLAN ID配置 | 1 | CSR配置 | 软件 |
AccFrameType | U32 | 无 | - | - | 接收帧类型 | 端口接收帧类型配置 | 0 | CSR配置 | 软件 |
ExportPort | Boolean | 无 | true/false | - | 是否导出端口 | 端口导出标记配置 | false | CSR配置 | 软件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
| 暂无 | - | - | - | - | - | - | - | - | - |
🔗 动态关联机制
语法规范
使用 #/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
}
}🔧 使用指南
配置步骤
- 设置基本标识:配置Unit、LogicId、PhysicalId指定端口标识信息
- 配置端口类型:设置PortType指定端口类型
- 设置扩展模式:配置ExtMode指定端口扩展模式
- 配置连接地址:设置ConPhyAddr指定端口连接物理地址
- 设置链路检查:配置LinkCheck指定链路检查状态
- 配置端口隔离:设置PortIso指定端口隔离参数
- 设置VLAN配置:配置PVid、AccFrameType指定端口VLAN和帧类型
- 配置导出标记:设置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决定端口接收的帧类型,常见值包括接收所有帧、仅接收标记帧、仅接收未标记帧等