📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

DftSPI 类 ​

📊 属性定义详表 ​

必选属性 ​

以下属性来自 bmc.kepler.Manufacture 接口，为装备测试项的核心配置属性。

可选属性 ​

以下属性来自 bmc.kepler.Manufacture.Extension 接口及对象级别属性，为SPI装备测试的扩展配置属性。

🔗 动态关联机制 ​

语法规范 ​

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

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

# DftSPI类当前无动态关联属性，所有属性均为静态CSR配置

关联说明 ​

• 当前状态：DftSPI类所有属性均为静态CSR配置，无动态关联需求
• 扩展说明：如后续需要关联硬件状态或组件信号，可按 <=/xxx 或 #/xxx 格式扩展

📂 分类标准 ​

软件属性 ​

• 定义：用于软件层面的装备测试管理和配置
• 特点：包含标识、交互提示、测试时间、SPI通道等配置功能
• 示例：Type, Id, Slot, DeviceNum, ItemName, PrompteReady, PrompteFinish, ProcessPeriod, SystemId, SpiSwitch, Channel

📝 配置示例 ​

标准SPI测试项配置 ​

{
  "DftSPI": {
    "Type": 2,
    "Id": 1,
    "Slot": 0,
    "DeviceNum": 1,
    "ItemName": "SPI Test",
    "PrompteReady": "请确认SPI已就绪",
    "PrompteFinish": "请检查SPI测试结果",
    "ProcessPeriod": 120,
    "SystemId": 1,
    "SpiSwitch": 1,
    "Channel": 255
  }
}

多Host场景配置 ​

{
  "DftSPI_Host2": {
    "Type": 2,
    "Id": 2,
    "Slot": 0,
    "DeviceNum": 2,
    "ItemName": "SPI Test Host2",
    "PrompteReady": "请确认SPI已就绪",
    "PrompteFinish": "请检查SPI测试结果",
    "ProcessPeriod": 120,
    "SystemId": 2,
    "SpiSwitch": 1,
    "Channel": 255
  }
}

指定SPI通道配置 ​

{
  "DftSPI_Channel0": {
    "Type": 2,
    "Id": 3,
    "Slot": 0,
    "DeviceNum": 1,
    "ItemName": "SPI Channel0 Test",
    "PrompteReady": "请确认SPI通道0已就绪",
    "PrompteFinish": "请检查SPI通道0测试结果",
    "ProcessPeriod": 60,
    "SystemId": 1,
    "SpiSwitch": 1,
    "Channel": 0
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 设置基本标识：配置Id、Slot、DeviceNum
2. 指定测试类型：设置Type，确定SPI测试项的测试类型
3. 配置交互提示：设置PrompteReady、PrompteFinish，定义测试前后的交互提示
4. 设置测试时间：配置ProcessPeriod，指定测试所需时间
5. 配置SPI通道：设置SpiSwitch和Channel，指定SPI切换开关和通道号
6. 可选配置：根据需要配置SystemId（多Host场景）

注意事项 ​

• Manufacture接口通用属性：Type、Id、Slot、DeviceNum、ItemName、PrompteReady、PrompteFinish、ProcessPeriod 为所有装备测试对象的通用属性，来自 bmc.kepler.Manufacture 接口
• ID唯一性：Id在路径 /bmc/kepler/Manufacture/PrepareTest/DftSPI/${Id} 中作为唯一标识
• Type取值：Type取值范围为1~6，分别对应不同测试类型，需根据实际测试场景选择
• SPI专属属性：SpiSwitch和Channel为DftSPI对象级别属性，用于控制SPI通道切换和通道编号
• Channel默认值：Channel默认值为255，表示使用默认SPI通道
• SystemId默认值：单Host场景下SystemId默认为1，无需额外配置
• 权限要求：操作该对象需要 ConfigureSelf 权限

性能建议 ​

• 测试时间：根据SPI实际测试需求合理设置ProcessPeriod
• 交互提示：PrompteReady和PrompteFinish应提供清晰的操作指引
• SPI通道：根据实际硬件连接选择合适的Channel值，默认255为通用配置
• 资源优化：单Host场景无需配置SystemId

Type类型说明 ​

常见问题 ​

• Q: DftSPI和DftPmu有什么区别？
  • A: DftSPI位于PrepareTest路径下且有SpiSwitch和Channel专属属性，DftPmu位于SelfTest路径下且无专属属性
• Q: Channel默认值255代表什么？
  • A: Channel默认值255表示使用默认SPI通道，实际使用时可根据硬件连接配置具体通道号
• Q: SpiSwitch的作用是什么？
  • A: SpiSwitch用于控制SPI通道的切换状态，配合Channel指定具体的SPI通信通道
• Q: SystemId在什么情况下需要配置？
  • A: 在Multihost环境下需要配置SystemId以区分不同system，单Host场景使用默认值1即可