OpenBMC Entity Manager实战：5分钟搞定温度传感器配置（附JSON模板）
1. 温度传感器配置的核心逻辑
在OpenBMC生态中，温度传感器的管理遵循一套标准化的配置流程。Entity Manager通过JSON配置文件定义硬件实体属性，其核心工作流程可分为三个关键阶段：
- 硬件探测：fru-device等守护进程扫描I2C总线，识别连接的传感器设备
- 配置匹配：Entity Manager将探测结果与本地JSON配置文件进行规则匹配
- 接口暴露：生成标准化的D-Bus接口供上层服务调用
典型温度传感器配置需要关注的参数包括：
| 参数类别 | 关键参数 | 示例值 | 说明 |
|---|---|---|---|
| 基础信息 | Type | "TempSensor" | 指定设备类型 |
| Name | "CPU0_Temp" | 设备唯一标识名 | |
| 总线参数 | Bus | 3 | I2C总线编号 |
| Address | "0x4d" | 设备I2C地址 | |
| 功能参数 | Unit | "DegreesC" | 温度单位 |
| PowerState | "On" | 电源状态关联 | |
| 阈值设置 | upper_critical | 95.0 | 过温告警阈值 |
2. 快速配置模板解析
以下是一个可直接复用的TMP75温度传感器配置模板，适用于大多数I2C接口的数字温度传感器：
{ "Type": "TempSensor", "Name": "TMP75_Sensor", "Probe": { "xyz.openbmc_project.FruDevice": { "PRODUCT_PRODUCT_NAME": "TMP75" }, "xyz.openbmc_project.Inventory.Decorator.I2CDevice": { "Bus": "$bus", "Address": "$address" } }, "Exposes": [ { "Name": "AmbientTemp", "Type": "Temperature", "Address": "$address", "Bus": "$bus", "Unit": "DegreesC", "Scale": 1000, "Thresholds": [ { "Name": "upper_critical", "Value": 85.0, "Direction": "greater", "Severity": 1 }, { "Name": "upper_warning", "Value": 75.0, "Direction": "greater", "Severity": 0 } ] } ] }关键配置项说明：
- 动态变量：
$bus和$address会在运行时由探测结果自动填充 - 阈值设置：
Severity: 1表示严重告警级别Direction: greater表示超过阈值触发
- Scale因子：原始读数乘以1000转换为浮点温度值
3. 常见问题解决方案
3.1 地址冲突处理
当多个相同型号传感器共用I2C总线时，推荐解决方案：
- 硬件修改：调整传感器的地址引脚电平
- 软件配置：为每个设备指定固定地址
"Exposes": [ { "Name": "CPU0_Temp", "Address": "0x48", "Bus": 3 }, { "Name": "CPU1_Temp", "Address": "0x49", "Bus": 3 } ]3.2 阈值配置优化
合理的阈值设置应参考：
- 器件规格书中的工作温度范围
- 系统散热设计参数
- 历史运行数据统计
推荐的分级阈值配置：
"Thresholds": [ { "Name": "upper_non_recoverable", "Value": 100.0, "Action": "HardPowerOff" }, { "Name": "upper_critical", "Value": 95.0, "Action": "LogEvent" }, { "Name": "upper_warning", "Value": 85.0, "Action": "IncreaseFanSpeed" } ]3.3 传感器数据异常排查
当D-Bus接口无法读取数据时，可按以下步骤排查：
- 确认硬件连接：
i2cdetect -y 3 # 扫描总线3上的设备 - 检查内核驱动：
dmesg | grep tmp75 ls /sys/class/hwmon - 验证Entity Manager日志：
journalctl -u xyz.openbmc_project.EntityManager --no-pager
4. 高级配置技巧
4.1 多传感器聚合
通过虚拟传感器实现温度平均值计算：
{ "Type": "VirtualSensor", "Name": "CPU_Zone_Temp", "Probe": { "xyz.openbmc_project.Inventory.Item": { "Present": true } }, "Exposes": [ { "Name": "CPU_Zone", "Type": "VirtualTemperature", "Sensors": ["CPU0_Temp", "CPU1_Temp", "CPU2_Temp"], "Algorithm": "Average", "Unit": "DegreesC", "Thresholds": [ { "Name": "upper_critical", "Value": 90.0, "Direction": "greater", "Severity": 1 } ] } ] }支持的聚合算法包括：
Average：算术平均值Maximum：取最大值Minimum：取最小值Sum：求和
4.2 风扇联动控制
与phosphor-pid-control集成实现温度自适应调速：
{ "zones": [ { "id": 0, "minThermalOutput": 3000.0, "pids": [ { "name": "cpu_zone_temp", "type": "temp", "inputs": ["CPU_Zone_Temp"], "setpoint": 75.0, "pid": { "samplePeriod": 0.1, "proportionalCoeff": 0.5, "integralCoeff": 0.01 } } ], "fans": [ { "name": "sys_fans", "type": "fan", "inputs": ["Fan1", "Fan2", "Fan3"], "setpoint": 80.0 } ] } ] }4.3 热插拔支持
对于可热插拔的传感器模块，需添加Present属性监控：
"Probe": { "xyz.openbmc_project.Inventory.Item": { "Present": true } }, "Exposes": [ { "Name": "ModuleTemp", "Status": { "Property": "Present", "Interface": "xyz.openbmc_project.Inventory.Item" } } ]
