📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

AbnormalFan 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

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

# 语法格式
属性名: "#/目标类.属性名"

# 实际示例
FanGroup: [1, 2, 3, 4]                     # 风扇组ID数组
FanIdx: 1                                  # 对应风扇ID
Status: "AbnormalRotation"                 # 异常状态类型

关联说明 ​

• FanGroup: 定义受影响的风扇组，数组中的数字对应具体风扇ID
• FanIdx: 与FanGroup关联，指定具体的风扇索引
• Status: 定义异常类型，影响调速策略的执行

📂 分类标准 ​

热设计属性 ​

• 定义：与热管理和风扇控制直接相关的参数
• 特点：影响系统散热性能和风扇运行策略
• 示例：FanGroup, FanIdx, Status, SpeedPercentage

软件属性 ​

• 定义：用于逻辑控制和软件管理的参数
• 特点：策略标识和管理相关
• 示例：Id

📝 配置示例 ​

标准异常风扇配置 ​

{
  "AbnormalFan": {
    "FanGroup": [1, 2, 3, 4],
    "FanIdx": 1,
    "Id": 1,
    "Status": "AbnormalRotation",
    "SpeedPercentage": 70
  }
}

风扇不在位配置 ​

{
  "AbnormalFan": {
    "FanGroup": [1, 2],
    "FanIdx": 1,
    "Id": 2,
    "Status": "NotInPosition",
    "SpeedPercentage": 80
  }
}

高转速补偿配置 ​

{
  "AbnormalFan": {
    "FanGroup": [3, 4, 5, 6],
    "FanIdx": 3,
    "Id": 3,
    "Status": "AbnormalRotation",
    "SpeedPercentage": 90
  }
}

单风扇异常配置 ​

{
  "AbnormalFan": {
    "FanGroup": [1],
    "FanIdx": 1,
    "Id": 4,
    "Status": "AbnormalRotation",
    "SpeedPercentage": 85
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 确定风扇组：通过FanGroup数组配置受影响的风扇ID列表
2. 设置目标风扇：通过FanIdx指定具体的风扇索引
3. 分配策略ID：设置唯一的Id标识此异常调速策略
4. 选择异常类型：根据实际情况配置Status（转速异常/不在位）
5. 调整转速占空比：根据散热需求配置SpeedPercentage
6. 验证配置：确保风扇ID在系统中存在且可控

注意事项 ​

• 风扇ID映射：FanGroup和FanIdx中的数字必须对应实际存在的风扇
• 异常类型选择：根据实际故障情况选择合适的Status值
• 转速范围：SpeedPercentage取值范围为0-100，建议不低于最小安全转速
• 策略唯一性：每个异常调速策略的Id必须唯一
• 组合逻辑：FanGroup和FanIdx应该保持逻辑一致性

性能建议 ​

• 转速设置：异常情况下建议适当提高转速以保证散热
• 分组策略：合理分组可以提高散热效率和系统稳定性
• 监控机制：建议配合温度监控和告警机制使用
• 冗余设计：考虑多风扇冗余，避免单点故障

常见问题 ​

• Q: FanGroup中的数字含义？
  • A: 数字代表风扇ID序列，对应系统中的具体风扇编号
• Q: SpeedPercentage为什么默认80？
  • A: 80%是经过热设计验证的安全转速，既能保证散热又避免过度噪音
• Q: 如何处理风扇不在位的情况？
  • A: 设置Status为"NotInPosition"，系统会自动提高其他风扇转速进行补偿