CSR配置字典之EthMac类
更新时间： 2026/05/11
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | EthMac类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026/05/11 |
| 最后更新 | 2026/05/11 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026/05/11 | 初始版本 | 创建EthMac类配置字典 | 全新文档 | bmc_network组件组 |
🎯 类概览
EthMac 类
| 属性 | 值 |
|---|---|
| 类名称 | EthMac |
| 功能描述 | 网口MAC地址管理配置，支持网口组ID、网口名称、网口号、MAC地址、速率双工等配置 |
| 所属SIG组 | hardware |
| 所属组件 | bmc_network |
| 责任人 | 基础服务组 |
| 最后更新 | 2026/05/11 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
EthMac 类 - 必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
GroupId | String | - | String | - | 网口组Id | 配置网口组 | "group1" | CSR | 软件 |
EthName | String | - | String | - | 网口名称，比如eth2 | 配置网口名称 | "eth2" | CSR | 软件 |
EthId | U8 | - | U8 | - | 网口号，例如eth2则网口号为2 | 配置网口号 | 2 | CSR | 软件 |
Mac | String | - | String | - | 数据库保存的网口Mac地址 | 配置MAC地址 | "xx" | CSR | 软件 |
MacUseEnabled | Boolean | - | Boolean | - | 可使用Mac地址标志 | 配置MAC使用开关 | true | CSR | 软件 |
SpeedDuplexEnable | Boolean | - | Boolean | - | 网口自协商模式使能 | 配置自协商开关 | true | CSR | 软件 |
SpeedSetting | U8 | - | U8 | - | 网口速率：0:不涉及 1:10M, 2:100M, 3:1000M | 配置网口速率 | 3 | CSR | 软件 |
DuplexSetting | U8 | - | U8 | - | 网口工作模式：0:不涉及配置 1:半双工 2:全双工 | 配置工作模式 | 2 | CSR | 软件 |
📝 配置示例
网口MAC配置
json
{
"EthMac": {
"GroupId": "group1",
"EthName": "eth2",
"EthId": 2,
"Mac": "xx",
"MacUseEnabled": true,
"SpeedDuplexEnable": false,
"SpeedSetting": 3,
"DuplexSetting": 2
}
}🔧 使用指南
配置步骤
配置网口标识：设置 GroupId、EthName、EthId 确定网口
配置MAC地址：设置 Mac 和 MacUseEnabled
配置速率双工：设置 SpeedDuplexEnable、SpeedSetting、DuplexSetting
注意事项
SpeedDuplexEnable=true 时使用自协商模式，SpeedSetting 和 DuplexSetting 失效
SpeedDuplexEnable=false 时使用手动配置的 SpeedSetting 和 DuplexSetting
MAC 地址需要全局唯一
故障排查
网口速率不匹配：检查 SpeedSetting 和 DuplexSetting 配置
自协商失败：检查 SpeedDuplexEnable 配置和链路对端设备