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

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

DftPysicalLed 类

属性
类名称DftPysicalLed
功能描述物理LED测试项,用于装备测试中的LED灯功能验证和状态检测
所属SIG组manufacture
所属组件装备测试
责任人装备测试组
最后更新2025-01-27
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
ItemNameString-String-装备项名称装备测试项识别"Physical Led Test"CSR配置硬件
TypeU8-U8-测试项类型
4:LED装备测试
测试项分类管理4CSR配置软件
IdU8-U8-测试类型ID
用于唯一标识测试项,参考:https://3ms.huawei.com/hi/group/2030499/wiki_7817506.html
测试项唯一标识129CSR配置软件
DftEnableMixed-关联装备模式Accessor_DftEnable装备模式寄存器置位
开始设置1,停止设置0
装备测试,I2cLed对应"#/Accessor_DftEnable.Value"硬件提供硬件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
SlotU32-U32-测试项所在槽位
支持变量替换
Type,Id,Slot,DeviceNum匹配唯一装备项
测试项位置标识"${GroupId}"CSR配置软件
DeviceNumU8-U8-设备数量
Type,Id,Slot,DeviceNum匹配唯一装备项
测试设备管理0CSR配置软件
ProcessPeriodU16-U16-测试周期
单位:毫秒,65535表示不限制
当前未使用
测试时间控制65535CSR配置软件
PrompteReadyString""String-测试准备提示信息
当前未使用
测试过程提示""CSR配置软件
PrompteFinishString""String-测试完成提示信息
当前未使用
测试过程提示"Please check the leds"CSR配置软件

🔗 动态关联机制

语法规范

使用 #/xxx 格式实现动态关联:

yaml
# 装备模式寄存器关联
DftEnable: "#/Accessor_DftEnable.Value"

# 变量替换
Slot: "${GroupId}"

关联说明

  • DftEnable: 关联到装备模式寄存器,用于控制装备测试的开始和停止
  • Slot: 支持变量替换,动态获取槽位信息
  • 唯一性标识: Type、Id、Slot、DeviceNum四个属性组合确定唯一装备项

📂 分类标准

硬件属性

  • 定义:与LED硬件控制和测试直接相关的参数
  • 特点:涉及装备模式寄存器控制和LED测试名称
  • 示例ItemName, DftEnable

软件属性

  • 定义:用于测试项管理和控制的参数
  • 特点:测试项元数据、唯一性标识和提示信息
  • 示例Type, Id, Slot, DeviceNum, ProcessPeriod, PrompteReady, PrompteFinish

📝 配置示例

标准LED装备测试配置

json
{
  "DftPysicalLed_1": {
    "ItemName": "Physical Led Test",
    "Type": 4,
    "Id": 129,
    "Slot": "${GroupId}",
    "DeviceNum": 0,
    "ProcessPeriod": 65535,
    "PrompteReady": "",
    "PrompteFinish": "Please check the leds",
    "DftEnable": "#/Accessor_DftEnable.Value"
  }
}

扩展板LED测试配置

json
{
  "DftPysicalLed_2": {
    "ItemName": "EXU Led Test",
    "Type": 4,
    "Id": 129,
    "Slot": "${GroupId}",
    "DeviceNum": 0,
    "ProcessPeriod": 65535,
    "PrompteReady": "",
    "PrompteFinish": "Please check the EXU leds",
    "DftEnable": "#/Accessor_DftEnable.Value"
  }
}

基础板LED测试配置

json
{
  "DftPysicalLed_3": {
    "ItemName": "BCU Led Test",
    "Type": 4,
    "Id": 129,
    "Slot": "${GroupId}",
    "DeviceNum": 0,
    "ProcessPeriod": 65535,
    "PrompteReady": "",
    "PrompteFinish": "Please check the BCU leds",
    "DftEnable": "#/Accessor_DftEnable.Value"
  }
}

多槽位LED测试配置

json
{
  "DftPysicalLed_4": {
    "ItemName": "Multi-Slot Led Test",
    "Type": 4,
    "Id": 129,
    "Slot": "${GroupId}",
    "DeviceNum": 1,
    "ProcessPeriod": 65535,
    "PrompteReady": "",
    "PrompteFinish": "Please check the multi-slot leds",
    "DftEnable": "#/Accessor_DftEnable.Value"
  }
}

🔧 使用指南

配置步骤

  1. 确定测试项:明确要测试的LED装备项类型(EXU、BCU等)
  2. 配置唯一标识:设置Type、Id、Slot、DeviceNum确保装备项唯一性
  3. 关联装备模式:将DftEnable关联到装备模式寄存器
  4. 设置测试名称:配置ItemName标识测试项
  5. 配置提示信息:设置PrompteFinish提示用户检查LED状态
  6. 设置测试参数:配置ProcessPeriod等测试控制参数

测试流程

  1. 初始化:装备测试系统初始化LED测试项
  2. 启动测试:通过DftEnable寄存器置位启动测试(设置为1)
  3. LED控制:系统控制LED进行相应的测试动作
  4. 人工检查:根据PrompteFinish提示,人工检查LED状态
  5. 停止测试:通过DftEnable寄存器停止测试(设置为0)
  6. 结果输出:输出测试结果(Succeed/Failed/Non)

装备测试说明

  • 装备模式:通过DftEnable寄存器控制装备测试的开始和停止
  • I2C LED对应:与I2C LED控制器对应,实现LED的硬件控制
  • 人工验证:需要人工观察LED状态,验证测试结果
  • 唯一性保证:通过四个属性组合确保装备项的唯一性

注意事项

  • 唯一性约束:确保Type、Id、Slot、DeviceNum四个属性组合的唯一性
  • 装备模式寄存器:确认DftEnable寄存器的正确关联和访问权限
  • 测试时机:在适当的时机进行LED装备测试,避免影响正常业务
  • 人工验证:需要人工观察LED状态,确保测试结果的准确性

故障排除

  1. 装备测试无法启动

    • 检查DftEnable寄存器关联是否正确
    • 确认装备模式寄存器的访问权限
    • 验证Accessor_DftEnable对象是否存在
  2. LED无响应

    • 检查I2C LED控制器连接
    • 确认LED硬件电源供应
    • 验证装备测试模式是否正确启动
  3. 测试项冲突

    • 检查Type、Id、Slot、DeviceNum组合是否重复
    • 确认不同测试项的唯一性标识
    • 验证测试项配置的正确性

性能优化

  • 测试效率:合理设置ProcessPeriod,优化测试周期
  • 资源占用:控制装备测试的系统资源消耗
  • 并发管理:避免多个装备测试项同时操作同一硬件资源

📚 相关文档