openubmc 新增硬件资源对象

新增硬件资源对象 ​CSR中的对象定义来源于MDS模型通过实例化MDS类定义我们便可以很方便的在对应的设备配置中将所需要的硬件管理数据配置齐全然后在组件中对资源对象进行业务逻辑编写。MDS对象定义 ​首先我们需要在my_app组件的MDS模型中定义资源类。打开在《新增一个组件》中创建的my_app组件的mds/model.json, 添加下面的模型定义MyCSRModel: { path: /bmc/demo/MyCSRModel/${id}, interfaces: { bmc.demo.OpenUBMC.Reading: { properties: { TemperatureCelsius: { usage: [ CSR ] } } } } }完整代码{ MyMDSModel: { path: /bmc/demo/MyMDSModel/${id}, interfaces: { bmc.demo.OpenUBMC.Community: { properties: { WelcomeMessage: {} } } }, properties: { SecretNumber: { baseType: U32 } } }, MyCSRModel: { path: /bmc/demo/MyCSRModel/${id}, interfaces: { bmc.demo.OpenUBMC.Reading: { properties: { TemperatureCelsius: { usage: [ CSR ] } } } } } }与普通的组件MDS对象定义不同这里新增了usage: [CSR]的声明。这个表示在某个CSR中存在一个叫做MyCSRModel的对象包含TemperatureCelsius的属性。CSR对象添加关于硬件自发现的具体设计请参考《硬件自发现》在上述的usage的定义中可以看到TemperatureCelsius来源于CSR因此需要在上述的CSR中定义一个MyCSRModel通过硬件自发现将CSR对象分发给my_app。命名规则是前缀_后缀前缀必须与mds里一样后缀可以随便命名在vpd/vendor/Huawei/Server/Kunpeng/openUBMC/root.sr的Objects里添加下面代码MyCSRModel_DemoSensor: { TemperatureCelsius: /Scanner_GetTemperature.Value }Scanner_GetTemperature对象是在《openubmc 新增一个 IPMI Sensor》中添加的自动生成代码 ​由于新增了模型定义我们需要通过自动代码生成辅助代码。在my_app中执行如下命令cd /home/workspace/my_app bingo gen代码编写 ​由于MyCSRModel的实例已经在root.sr中“创建”因此我们需要等待对象的分发而非主动去创建。可以通过如下的方法在代码中获取对象的分发。打开my_app_app.lua在app:init()中添加对象添加回调函数。local object_manage require mc.mdb.object_managefunction app:init() -- 组件的初始化函数 app.super.init(self) -- 先调用基类的初始化函数 self.my_mds_model self:CreateMyMDSModel(1, function(object) -- 创建一个mds对象实例 object.ObjectName MyMDSModel_1 -- 在回调函数中进行对象的属性赋值 object.WelcomeMessage Hello OpenUBMC! object.SecretNumber 330 end) self:register_ipmi() self:register_mds_callback() -- 新增mds方法回调 end function app:register_mds_callback() object_manage.on_add_object(self.bus, function(class_name, object, position) if class_name MyCSRModel then self.my_csr_model object end end) object_manage.on_add_object_complete(self.bus, function(position) end) object_manage.on_delete_object(self.bus, function(class_name, object, position) if self.my_csr_model object then self.my_csr_model nil end end) object_manage.on_delete_object_complete(self.bus, function(position) end) end组件构建 ​由于修改了my_app仓库因此我们需要进行构建。为了和之前版本进行区分我们需要手动将mds目录下的service.json中的version字段进行更新通常会在原有版本号的最后一位上加一。随后再执行组件构建命令。bingo build --stagerc因为vpd仓库也被修改了所以也需要重新构建。修改版本号然后执行构建命令。bingo build --stagerc整包构建 ​在manifest中找到之前my_app声明位置将版本改至对应的构建版本然后再进行整包构建。bingo build整包测试 ​检查产物.sr打进整包后落在/opt/bmc/sr/root.sr(package()按扩展名拷到opt/bmc/sr)。执行以下命令可以检查是否被包含到整包中grep -o MyCSRModel_DemoSensor home/workspace/manifest/temp/build_openUBMC_debug_dev/buildimg/rtos_with_driver/rootfs/opt/bmc/sr/root.srMyCSRModel_DemoSensor整包升级整包升级后可以查看资源协作接口对象source /etc/profile busctl --user tree bmc.kepler.my_app└─/bmc |─/bmc/demo | |─/bmc/demo/MyCSRModel | | └─/bmc/demo/MyCSRModel/MyCSRModel_DemoSensor_01 | └─/bmc/kepler/MyMDSModel | └─/bmc/kepler/MyMDSModel/1 └─/bmc/kepler | └─/bmc/kepler/IpmiCmds | └─/bmc/kepler/IpmiCmds/30 | └─/bmc/kepler/IpmiCmds/30/90 | |─/bmc/kepler/IpmiCmds/30/90/GetSecretNumber | └─/bmc/kepler/IpmiCmds/30/90/SetSecretNumber └─/bmc/kepler/my_app └─/bmc/kepler/my_app/MicroComponent通过busctl --user tree我们发现多了一个对象这个便是CSR中配置的对象。我们可以通过busctl --user introspect命令对对象进行查看busctl --user introspect bmc.kepler.my_app /bmc/demo/MyCSRModel/MyCSRModel_DemoSensor_01NAME TYPE SIGNATURE RESULT/VALUE FLAGS bmc.kepler.OpenUBMC.Reading interface - - - .TemperatureCelsius property n 28 emits-change writable bmc.kepler.Object.Properties interface - - - .GetAllWithContext method a{ss}s a{sv} - .GetOptions method a{ss}ss a{ss} - .GetPropertiesByNames method a{ss}sas a{sv}a{sv} - .GetPropertiesByOptions method a{ss}sa{ss} as - .GetWithContext method a{ss}ss v - .SetWithContext method a{ss}ssv - - .ClassName property s MyCSRModel emits-change .ObjectIdentifier property (ysss) 0 1 01 emits-change .ObjectName property s MyCSRModel_DemoSensor_01 emits-change org.freedesktop.DBus.Introspectable interface - - - .Introspect method - s - org.freedesktop.DBus.ObjectManager interface - - - .GetManagedObjects method - a{oa{sa{sv}}} - org.freedesktop.DBus.Peer interface - - - .GetMachineId method - s - .Ping method - - - org.freedesktop.DBus.Properties interface - - - .Get method ss v - .GetAll method s a{sv} - .Set method ssv - - .PropertiesChanged signal sa{sv}as - -MDS 对象与 CSR 对象区别MDS 对象是管理面对象在组件的mds/model.json里定义代码生成后挂到D-Bus资源树(例如/bmc/demo/MyMDSModel/1)。北向Redfish/IPMI/Web读的是它。生命周期由应用管CreateMyMDSModel创建Lua里给WelcomeMessage、SecretNumber赋值。CSR 对象是硬件面对象写在VPD的.sr里(openUBMC/root.sr)例如Lm75_DemoSensor、Scanner_GetTemperature、ThresholdSensor_DemoSensor、Entity_DemoSensor。描述芯片、总线、扫描周期、门限。由hwdiscovery解析、hwproxy按Scanner去读寄存器。它本身不是北向资源。中间用usage: [CSR]粘起来MDS属性声明后框架按同名属性把CSR对象的值灌进MDS应用不用再写。sensor组件就是这样MDS类ThresholdSensor的SensorName、Reading、UpperCritical全是usage: [CSR]对应.sr里ThresholdSensor_*。一句话总结MDS 是给北向看的软件对象CSR 是给南向扫硬件的描述。带 usage: CSR 的 MDS 只是把硬件读值接到管理树上并没有变成另一种对象。