【openbmc添加fru信息通过ipmitool命令读取】【后续】

openbmc的fru配置

一、service

将eeprom数据读取到bus上的service

1-1 路径

xxx-project\meta-phosphor\recipes-phosphor\ipmi\phosphor-ipmi-fru\obmc-read-eeprom@.service

1-2 文件内容

[Unit] Description=Read %I EEPROM Wants=mapper-wait@-xyz-openbmc_project-inventory.service After=mapper-wait@-xyz-openbmc_project-inventory.service StartLimitBurst=10 [Service] Restart=on-failure Type=oneshot EnvironmentFile={ 
     envfiledir}/obmc/eeproms/%I ExecStartPre={ 
     bindir}/of-name-to-eeprom.sh { 
     envfiledir}/obmc/eeproms/%I ExecStart=/usr/bin/env phosphor-read-eeprom --eeprom $SYSFS_PATH --fruid $FRUID SyslogIdentifier=phosphor-read-eeprom [Install] WantedBy=multi-user.target 

1-3 of-name-to-eeprom.sh

#!/bin/bash -eu [ -n "${OF_NAME+1}" ] || exit 0 path="$(grep -xl "$OF_NAME" /sys/bus/i2c/devices/*/of_node/name)" eeprom="${path%/of_node/name}/eeprom" sed -i "s,^SYSFS_PATH=.*$,SYSFS_PATH=$eeprom," "$1" 

这里结合service文件来看，是根据OF_NAME从i2c下的”of_node/name”参数grep出绝对路径，对SYSFS_PATH重新做了赋值，防止SYSFS_PATH参数错误导致service失败，所以要么保证OF_NAME对，要么保证SYSFS_PATH对，并且不用OF_NAME，用了OF_NAME，SYSFS_PATH参数值就不重要了

1-4 基于service的配置参数文件

SYSFS_PATH=/sys/bus/i2c/devices/8-0050/eeprom FRUID=50 OF_NAME=eeprom 

参数前面有说明

二、fru数据模板-yaml文件

2-1 路径

meta-ibm\recipes-phosphor\configuration\acx22-yaml-config\mihawk\acx22-ipmi-fru-bmc.yaml

2-2 内容

fru.yaml文件数据介绍

75: /system/chassis/motherboard/powersupply0: entityID: 10 entityInstance: 1 interfaces: xyz.openbmc_project.Inventory.Item: PrettyName: IPMIFruProperty: Board Name IPMIFruSection: Board PartNumber: IPMIFruProperty: Part Number IPMIFruSection: Board SerialNumber: IPMIFruProperty: Serial Number IPMIFruSection: Board Model: IPMIFruProperty: Model Number IPMIFruSection: Board Manufacturer: IPMIFruProperty: Manufacturer IPMIFruSection: Board BuildDate: IPMIFruProperty: Mfg Date IPMIFruSection: Board 76: /system/chassis/motherboard/powersupply1: entityID: 10 entityInstance: 2 interfaces: xyz.openbmc_project.Inventory.Item: PrettyName: IPMIFruProperty: Board Name IPMIFruSection: Board PartNumber: IPMIFruProperty: Part Number IPMIFruSection: Board SerialNumber: IPMIFruProperty: Serial Number IPMIFruSection: Board Model: IPMIFruProperty: Model Number IPMIFruSection: Board Manufacturer: IPMIFruProperty: Manufacturer IPMIFruSection: Board BuildDate: IPMIFruProperty: Mfg Date IPMIFruSection: Board 

2-3 yaml文件数据解析

● entityID #指定传感器entityID，具体见ipmi协议2.0中的43.14小结节 ● entityInstance #示例标号，相同entityID的sensor，要有不同的entityInstance编号进行区分，每个类型从0开始，具体见ipmi协议2.0中的39.1小结节 ● sensorType #传感器类型，具体见ipmi协议2.0中42.2小节 ● path #传感器Dbus对象 ● sensorReadingType #传感器读类型具体见ipmi协议2.0中42.1小节 ● sensorNamePattern #可以给定字符串（最大长度为16），或者使用如下方式从path或者属性中获取 ○ nameLeaf：从path中解析（最后一个“/”后面的为传感器名）得到，一般用这个。 ○ nameParentLeaf：从path中解析，后两个为传感器名，例如“path：/xyz/openbmc_project/sensors/temperature/temp1”，怎传感器名为“temperature_temp1” ○ nameProperty：传感器名即interfaces的属性 ○ interfaces: ○ xyz.openbmc_project.Control.Boot.RebootAttempts: ○ AttemptsLeft: ○ Offsets: ○ 0xFF: ○ type: uint32_t ○ 则传感器名为“AttemptsLeft” ● multiplierM #ipmi协议中的算子，一般multiplierM*255 要稍大于可能的最大值，以保证精度 ● offsetB #偏移量 ● bExp #offsetB的指数，一般给0 ● unit #传感器单位，配置文件做了转换为字符串，具体见ipmi协议2.0中42.17小节 ● scale #缩放因子，是10的指数，一般温度电压等都是-3，即读取值是实际值的1000倍 ● rExp #和scale一样的指数，一般给0 1、scale是用于ipmid程序将从传感器中得到的值转化成实际值，一般hwmonz子系统中，传感器驱动创建的文件中存放的都是将实际值放大1000倍的值，因此sclae=-3 。如果自己写的驱动或者创建的文件中存放的值是实际值，则scale=0。 如hwmon子系统创建的文件 /sys/class/hwmon/hwmon1/temp1_input中的值是52000，则scal=-3。 如自己创建的文件/var/hwmon/hwmon0/temp1_input中值是52，则scale=0。 2、ipmi协议中一般阈值型传感器是有计算公式的(参见ipmi协议2.0的36.3小节)，在ipmid程序中需要通过计算得到公式的中x值，并返回给发起者（netfn=04,cmd=0x21）。 3、配置文件中配置这些值会转化到ipmi协议数据中（multiplierM一个字节，offsetB一个字节，bExp（低4bits）和rExp（高4bits）一个字节，具体参见ipmi协议第43小节），命令发起者得到数据后，利用公式计算得到实际值，计算值的范围是[ offsetB * 10 ^bExp, multiplierM255 + offsetB * 10 ^bExp] * 10 ^rExp。在不考虑rExp和offsetB的情况下（rExp=bExp=0），计算值y的最大范围是[0,65025]（此时 multiplierM=255）。 4、一般除了温度外，offsetB=0，rExp=-3，即计算值y的最大范围是[0, 65.25]，为了保证精度，我们可以调小multiplierM值，尽量使最大值稍大于阈值中设置的最大值。快速计算：multiplierM=(最大阈值 - offsetB10 ^bExp) /255向上取整数。 例如例如12V的电压传感器，假设阈值中设置最大上限值是14V，则可以设置 multiplierM = 14000/255 ≈55（向上取整），即配置文件中内容如下： ■ multiplierM=55 ■ offsetB=0 ■ bExp=0 ■ scale=-3 ■ rExp=-3 5、 一般温度传感器multiplierM=1，offsetB=-127，scale =-3， bExp =0，rExp=0，计算的y值范围是[-127,128]基本满足正常使用情况。 一般温度下限可能到不了-127，我们可以调整offsetB为-100，这样取值范围是[-100, 155]。 如果想提高精度，可以給rExp=-2， bExp=2，multiplierM=100，offsetB=-100，这样取值范围是[-100,155]，并且可以显示两位小数。 6、ipmi计算得到的值和ipmid程序获取到的值是有细微的差距，例如bmcweb页面上显示的阈值是配置文件设置的值（一般在/etc/default/obmc/hwmon下），但是ipmitool显示是略小于设置的阈值。这是因为在计算得到 multiplierM和x都是8bits的整数，为了包含最大的阈值，进行了稍微的放大（向上取整），这样ipmid在计算时以及ipmitool计算时会存在除法除不尽时候的舍去误差，因此为了尽量缩小误差，尽量取最小满足条件的 multiplierM值（ multiplierM越大，误差也越大（当然一些值和rExp也有关系））。 ● hasScale #是否缩放，取值“true”或者“false” ● mutability # Mutability::Read和 Mutability::Write，用于设置是否可读写 ● serviceInterface #传感器DBus服务接口，不同的 ○ org.freedesktop.DBus.Properties #属性类，set设置属性，get获取属性 ○ xyz.openbmc_project.Inventory.Manager #管理类，get获取，notify通知 ● readingType #获取dbus接口值或者属性等的方法，这里是指定的是调用的函数名 ○ readingType和 serviceInterface接口有关，get（netfn cmd 0x4 0x2D）方法有四种，set（netfn cmd 0x4 0x30）方法有6种，对于接口时xyz.openbmc_project.Inventory.Manager的只有assertion一种，对于yaml文件一定不要写错了，这几种对应的是函数。 ○ readingAssertion #传感器有效状态作为值类型 ○ readingData #读取值常用的温度电压传感器 ○ assertion #bool有效型 ○ eventdata # 紧set方法有 ○ eventdata1 # 紧set方法才有 ○ eventdata2 #属性值是字符串 ○ 更多请参看源码下的sensordatahandler.hpp和sensordatahandler.cpp文件 ● interfaces #获取传感器信息Dbus的接口 ○ xyz.openbmc_project.Sensor.Value #获取传感器值接口 ○ xyz.openbmc_project.State.Boot.Progress #启动进度 ○ xyz.openbmc_project.State.OperatingSystem.Status #系统启动方式 ○ xyz.openbmc_project.Inventory.Manager #资产类，比如内存条、CPU核等 ○ 。。。。更多见DBus接口（cmd：busctrl tree） ● Value #Dbus对应接口的的属性，常见的温度电压等传感器都是value ○ Present #在位 ○ Functional # ○ Prereqs # ● Offsets #指定数据偏移字节，不同传感器类型偏移不一样，具体见ipmi协议2.0中42.2小节 ● type #vlaue的类型，一般传感器值是int64_t或者double，离散量是bool或者string ● skipOn #指定跳过跟新类型，一般离散量不在位不能更新。 ○ xyz.openbmc_project.Inventory.Item: Present: Offsets: 0x07: assert: true deassert: false skipOn: deassert type: bool 

三、配置

3-1 yaml文件加载

TODO

3-4 属性配置文件xxx-fru-properties.yaml文件

/system/chassis/motherboard/bmc: xyz.openbmc_project.Inventory.Decorator.Cacheable: Cached: 'true' xyz.openbmc_project.Inventory.Decorator.Replaceable: Field Replaceable: 'true' xyz.openbmc_project.Inventory.Item: Present: 'true'