Hi3093开发板的传感器功能适配与调试

实践案例

2025/08/25

郭馨

Hi3093开发板的传感器功能适配与调试

前言

本文介绍了基于米尔电子MYC-LHi3093开发板适配I2C传感器的常用调试和适配方法，供社区开发者适配传感器提供指导。

物料准备

Hi3093核心板
核心板电源适配器
网线
typeC-USB线
杜邦线
扩展板（拥有LM75传感器）

I2C工具的应用

目前2506版本的OpenUBMC暂不支持i2ctool工具进行i2cdetect和i2ctransfer操作，本文参考论坛帖子自制I2C调试工具分享(适用于OpenUBMC平台的i2cdetect和i2ctransfer)，将i2cdetect和i2ctransfer工具通过scp上传到/data目录下使用。

传感器的调试

根据米尔科技开发板硬件原理图设计，通过开发板上的排针将BMC的I2C总线等通过杜邦线连接到外部调试板上。本文以I2C9为例，电源、GND、SDA和SCL连线如下图所示：

已知连接到外部调试板上的I2C9下挂载有LM75(0x48)、LM75(0x4f)、PCA9546(0x70)，PCA9546的channel0下接有LM75(0x49)。通过/data目录下执行./i2cdetect 9可看出上述设备已经正确探测到。

通过执行./i2ctransfer 9 w2@0x70 0x01，使能PCA9546 channel0，再执行./i2cdetect 9可看出LM75(0x49)可以被探测到。

PCA9546控制寄存器低四位分别对应四个Channel，可以通过i2ctransfer使能指定Channel，查看指定Channel下I2C设备是否连接正常。

通过以下命令可独立使能PCA9546 对应四个channel，通过向PCA9546写入0x00，则可禁用所有Channel。

Channel ID	命令
Channel 0	`i2ctransfer <i2cbus> w1@0x70 0x01`
Channel 1	`i2ctransfer <i2cbus> w1@0x70 0x02`
Channel 2	`i2ctransfer <i2cbus> w1@0x70 0x04`
Channel 3	`i2ctransfer <i2cbus> w1@0x70 0x08`

传感器的配置

CSR配置以board name为openUBMC为例，vpd/vendor/Huawei/Server/Kunpeng/openUBMC/root.sr 中配置如下：

ManagementTopology-> Anchor->Buses内增加 I2c_9
I2c_9下增加LM75传感器芯片和Connectors配置， Connector下配置Connector_DemoCard，以表示PCA9546位于下级组件DemoCard的CSR。
Objects下配置LM75对象、Entity、ThresholdSensor，因该传感器是定时轮询获取数值，故配置Scanner。
Objects下配置Connector_DemoCard，IdentifyMode配置为2表示下一级组件非天池组件，非天池组件由Bom、Id、AuxId三项配置决定下一级组件CSR名称: Bom_Id_AuxId.csr，本例中下一级组件CSR名称为14100513_DemoCard_0.sr。Buses中配置的I2c_9表示和下一级板卡连接的总线为I2C9，需注意同一个CSR文件中的任意两个连接器Position不能重复。

{
    "ManagementTopology": {
        "Anchor": {
            "Buses": [
                "I2c_1",
                "I2c_2",
                "I2c_3",
                "I2c_4",
                "I2c_5",
                "I2c_6",
                "I2c_7",
                "I2c_8",
                "I2c_9",
                "I2c_11"
            ]
        },
        "I2c_9": {
            "Chips": [
                "Lm75_1",
                "Lm75_2"
            ],
            "Connectors": [
                "Connector_DemoCard"
            ]
       }
    },
    "Objects": {
        "I2c_9": {
            "Id": 9
        },
        "Lm75_1": {
            "OffsetWidth": 1,
            "AddrWidth": 1,
            "Address": 144
        },
        "Lm75_2": {
            "OffsetWidth": 1,
            "AddrWidth": 1,
            "Address": 158
        },
        "Scanner_InletLM75": {
            "Chip": "#/Lm75_1",
            "Size": 1,
            "Offset": 0,
            "Mask": 255,
            "Period": 1000
        },
        "Scanner_OutletLM75": {
            "Chip": "#/Lm75_2",
            "Size": 1,
            "Offset": 0,
            "Mask": 255,
            "Period": 1000
        },
        "ThresholdSensor_InletTemp": {
            "AssertMask": 516,
            "DeassertMask": 516,
            "ReadingMask": 4626,
            "Linearization": 0,
            "M": 100,
            "RBExp": 224,
            "UpperCritical": 60,
            "LowerCritical": 5,
            "PositiveHysteresis": 2,
            "NegativeHysteresis": 2,
            "OwnerId": 32,
            "OwnerLun": 0,
            "EntityId": "<=/Entity_InletTemp.Id",
            "EntityInstance": "<=/Entity_InletTemp.Instance",
            "Initialization": 127,
            "Capabilities": 104,
            "SensorType": 1,
            "ReadingType": 1,
            "SensorName": "Inlet_Temp",
            "Unit": 128,
            "BaseUnit": 1,
            "ModifierUnit": 0,
            "Analog": 1,
            "MaximumReading": 127,
            "MinimumReading": 128,
            "Reading": "<=/Scanner_InletLM75.Value"
        },
        "Entity_InletTemp": {
            "Id": 99,
            "Name": "Inlet_Temp",
            "PowerState": 1,
            "Presence": 1,
            "Instance": 96
        },
        "ThresholdSensor_OutletTemp": {
            "AssertMask": 29312,
            "DeassertMask": 29312,
            "ReadingMask": 6168,
            "Linearization": 0,
            "M": 100,
            "RBExp": 224,
            "UpperCritical": 65,
            "UpperNoncritical": 50,
            "PositiveHysteresis": 2,
            "NegativeHysteresis": 2,
            "OwnerId": 32,
            "OwnerLun": 0,
            "EntityId": "<=/Entity_OutletTemp.Id",
            "EntityInstance": "<=/Entity_OutletTemp.Instance",
            "Initialization": 127,
            "Capabilities": 104,
            "SensorType": 1,
            "ReadingType": 1,
            "SensorName": "Outlet_Temp",
            "Unit": 128,
            "BaseUnit": 1,
            "ModifierUnit": 0,
            "Analog": 1,
            "MaximumReading": 127,
            "MinimumReading": 128,
            "Reading": "<=/Scanner_OutletLM75.Value"
        },
        "Entity_OutletTemp": {
            "Id": 99,
            "Name": "OutletTemp",
            "PowerState": 1,
            "Presence": 1,
            "Instance": 97
        },
        "Connector_DemoCard": {
            "Bom": "14100513",
            "Slot": 2,
            "Position": 4,
            "Presence": 1,
            "Id": "DemoCard",
            "AuxId": "0",
            "Buses": [
                "I2c_9"
            ],
            "SystemId": 1,
            "ManagerId": "1",
            "ChassisId": "1",
            "IdentifyMode": 2
        }
    }
}

因新增了CSR文件，需要在vpd/vendor/Huawei/Server/Kunpeng/openUBMC/profile.txt中增加14100513_DemoCard_0.sr文件所在路径。本例中配置如下：

Huawei/Server/Kunpeng/openUBMC/PSR/14100513_DemoCard_0.sr

PCA9546可使用Pca9545配置，需注意Objects->I2cMux_Pca9545_i2c9_chan0配置ChannelId，

14100513_DemoCard_0.sr配置如下：

{
    "FormatVersion": "3.00",
    "DataVersion": "3.00",
    "ManagementTopology": {
        "Anchor": {
            "Buses": [
                "I2c_9"
             ]
        },
        "I2c_9": {
            "Chips": [
                "Pca9545_i2c9_chip"
            ]
        },
        "Pca9545_i2c9_chip": {
            "Buses": [
                "I2cMux_Pca9545_i2c9_chan0"
            ]
        },
        "I2cMux_Pca9545_i2c9_chan0": {
            "Chips": [
                "Lm75_3"
            ]
        }
    },
    "Objects": {
        "Pca9545_i2c9_chip": {
            "OffsetWidth": 0,
            "AddrWidth": 1,
            "Address": 224,
            "WriteTmout": 0,
            "ReadTmout": 0,
            "HealthStatus": 0
        },
        "I2cMux_Pca9545_i2c9_chan0": {
            "ChannelId": 0
        },
        "Lm75_3": {
            "OffsetWidth": 1,
            "AddrWidth": 1,
            "Address": 146
        },
        "Scanner_NicLM75": {
            "Chip": "#/Lm75_3",
            "Size": 1,
            "Offset": 0,
            "Mask": 255,
            "Period": 1000
        },
        "ThresholdSensor_DemoTemp": {
            "AssertMask": 31381,
            "DeassertMask": 31381,
            "ReadingMask": 16191,
            "Linearization": 0,
            "M": 100,
            "RBExp": 224,
            "UpperNonrecoverable": 70,
            "UpperCritical": 65,
            "UpperNoncritical": 55,
            "LowerNonrecoverable": 0,
            "LowerCritical": 5,
            "LowerNoncritical": 10,
            "PositiveHysteresis": 2,
            "NegativeHysteresis": 2,
            "OwnerId": 32,
            "OwnerLun": 0,
            "EntityId": "<=/Entity_NicTemp.Id",
            "EntityInstance": "<=/Entity_NicTemp.Instance",
            "Initialization": 127,
            "Capabilities": 104,
            "SensorType": 1,
            "ReadingType": 1,
            "SensorName": "Nic_Temp",
            "Unit": 128,
            "BaseUnit": 1,
            "ModifierUnit": 0,
            "Analog": 1,
            "MaximumReading": 127,
            "MinimumReading": 128,
            "Reading": "<=/Scanner_NicLM75.Value"
        },
        "Entity_NicTemp": {
            "Id": 9,
            "Name": "Nic_Temp",
            "PowerState": 1,
            "Presence": 1,
            "Instance": 98
        }
    }
}

传感器Web显示

经过上述配置后，可看到传感器Web已显示正常。

【免责声明】本文仅代表作者本人观点，与本网站无关。本网站对文中陈述、观点判断保持中立，不对所包含内容的准确性、可靠性或完整性提供任何明示或暗示的保证。本文仅供读者参考，由此产生的所有法律责任均由读者本人承担。

关于作者

郭馨

任职于昆仑太科（北京）技术股份有限公司，是openUBMC项目组组长。