CSR配置字典之DftUsb类
📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | DftUsb类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2025-04-24 |
| 最后更新 | 2025-04-24 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2025-04-24 | 初始版本 | 创建DftUsb类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
| 属性 | 值 |
|---|---|
| 类名称 | DftUsb |
| 功能描述 | USB装备测试项配置，用于工厂测试阶段的USB功能自动化测试 |
| 所属SIG组 | test |
| 所属组件 | usb_entry |
| 最后更新 | 2025-04-24 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Type | U8 | - | [1, 2, 3, 4, 5, 6] | - | 装备测试项类型 | 标识测试项类型 | 1 | CSR配置 | 软件 |
Id | U8 | - | U8 | - | 装备测试项id | 唯一标识测试项 | 132 | CSR配置 | 软件 |
Slot | U32 | - | U32 | - | 槽位号 | 标识测试项对应的槽位 | 1 | CSR配置 | 软件 |
DeviceNum | U8 | - | U8 | - | 设备id | 标识USB设备编号 | 0 | CSR配置 | 软件 |
ItemName | String | - | String | - | 设备名称 | 测试项显示名称 | "Led1 Intelligence Test" | CSR配置 | 软件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
PrompteReady | String | - | String | - | 测试前交互提示 | 提示操作员准备测试条件 | "" | CSR配置 | 软件 |
PrompteFinish | String | - | String | - | 测试完成交互提示 | 提示操作员检查测试结果 | "Please check the led" | CSR配置 | 软件 |
ProcessPeriod | U16 | - | U16 | - | 测试所需时间 | 估计测试耗时（单位：秒） | 0 | CSR配置 | 软件 |
🔗 动态关联机制
语法规范
yaml
# USB测试项配置
Type: 1
Id: 132
Slot: 1
DeviceNum: 0
ItemName: "Led1 Intelligence Test"
PrompteReady: ""
PrompteFinish: "Please check the led"
ProcessPeriod: 0关联说明
- Type: 标识测试项的类型分类
- Id: 唯一标识符，用于测试项索引
- Slot: 标识测试项对应的设备槽位
- DeviceNum: USB设备编号
- ItemName: 测试项的显示名称
- PrompteReady: 测试前的准备提示
- PrompteFinish: 测试完成后的检查提示
- ProcessPeriod: 预计测试耗时
📂 分类标准
硬件属性
- 定义：当前版本无硬件属性
- 特点：所有属性都是软件管理相关
- 示例：无
软件属性
- 定义：由软件管理和维护的测试配置参数
- 特点：测试项管理、提示管理、时间管理等
- 示例：所有属性都是软件属性
📝 配置示例
人工自检配置
json
{
"DftUsb": {
"Type": 1,
"Id": 132,
"Slot": 1,
"DeviceNum": 0,
"ItemName": "Led1 Intelligence Test",
"PrompteReady": "",
"PrompteFinish": "Please check the led",
"ProcessPeriod": 0
}
}需要前置准备配置
json
{
"DftUsb": {
"Type": 2,
"Id": 133,
"Slot": 1,
"DeviceNum": 1,
"ItemName": "USB Port Test",
"PrompteReady": "Please insert USB device",
"PrompteFinish": "Please check USB device recognition",
"ProcessPeriod": 30
}
}拷机测试配置
json
{
"DftUsb": {
"Type": 3,
"Id": 134,
"Slot": 1,
"DeviceNum": 0,
"ItemName": "USB Stress Test",
"PrompteReady": "",
"PrompteFinish": "Stress test completed",
"ProcessPeriod": 3600
}
}装备交互测试配置
json
{
"DftUsb": {
"Type": 6,
"Id": 135,
"Slot": 1,
"DeviceNum": 2,
"ItemName": "USB Equipment Interaction Test",
"PrompteReady": "Connect test equipment",
"PrompteFinish": "Check test results",
"ProcessPeriod": 120
}
}🔧 使用指南
配置步骤
- 设置测试类型：配置Type属性
- 设置测试ID：配置Id属性，确保唯一性
- 设置槽位信息：配置Slot和DeviceNum属性
- 设置显示名称：配置ItemName属性
- 配置提示信息：根据需要配置PrompteReady和PrompteFinish
- 设置测试时间：配置ProcessPeriod属性
测试类型说明
| 类型值 | 类型名称 | 说明 |
|---|---|---|
| 1 | 人工自检 | 需要人工操作的自检测试 |
| 2 | 需要人工准备前置条件 | 需要操作员预先准备测试条件 |
| 3 | 拷机测试 | 长时间稳定性测试 |
| 4 | 人工检查结果 | 测试完成后需要人工检查结果 |
| 5 | 人工操作测试 | 需要人工操作进行的测试 |
| 6 | 与装备交互测试 | 与测试装备自动交互的测试 |
使用场景
- 工厂测试：生产线的USB功能测试
- 质量检验：出厂前的质量检验测试
- 故障诊断：售后维护的故障诊断测试
- 装备对接：与自动化测试装备的对接
注意事项
- ID唯一性：每个测试项的Id必须唯一
- 槽位匹配：Slot和DeviceNum应与实际硬件匹配
- 提示准确性：PrompteReady和PrompteFinish应准确描述操作步骤
- 时间估算：ProcessPeriod应准确估算测试时间
- 类型选择：Type应根据实际测试性质选择
故障排除
测试项未识别：
- 检查Id是否唯一
- 确认Slot和DeviceNum是否正确
- 验证测试配置是否加载
测试超时：
- 检查ProcessPeriod设置是否合理
- 确认测试流程是否正常执行
提示信息错误：
- 检查PrompteReady和PrompteFinish内容
- 确认提示语言是否正确