本文档主要介绍如何适配板卡。

使用前准备 ​

• 已安装bingo工具。

• BMC Studio工具能正常启动。

• 已创建工作空间并进行一键仓库部署或手动导入业务组件的MDS文件、vpd、mdb_interface和rackmount代码仓到工作空间。

拓扑视图化 ​

当前将CSR页面划分为“管理视图”，“业务视图”和“告警事件”三大板块，大大提升了配置页面的易用性。

板卡适配 ​

以适配一款硬件为例：

1. 在BMC Studio首页，选择CSR，进入CSR配置界面。

2. 在vpd仓库进入vendor/Huawei/Server/Kunpeng/openUBMC路径，选择root.sr文件。

3. 将LM75芯片拖拽到I2c_8上。

4. 拖拽完成后，单击M75芯片上方的扳手图标，配置参数，鼠标停在对应字段的"?"图标上即可查看字段类型和描述。

   • 配置基本信息：填写“器件别名”,并自定义properties中的Address、AddrWidth、OffsetWidth参数。
   • 配置传感器读数：按照属性进行配置，选择Scanner，配置“名称”、“偏移”、“长度”、“掩码”、“扫描周期”，配置完成后，单击“操作”列下的“保存”按钮。

5. 选择业务视图，进入软件对象配置页面。

6. 单击左上角“+新增”按钮，弹出“新增功能器件”窗口。

7. 搜索Entity，并进行配置。

8. 新增ThresholdSensor进行配置。

   • 对于需要使用动态应用的场景，在下拉框中选择动态引用，并关联到对应的对象。
   • 对于需要使用数据同步的场景，在下拉框中选择数据同步，并关联到对应Scanner的value值。

9. 配置完成后，在管理视图中单击“查看代码”，即可查看新增CSR配置的内容。

CSR可视化配置 ​

以板卡适配为例：

1. 在BMC Studio首页，选择CSR，进入CSR配置界面。

2. 新增组件，模板选择"RiserCard"，具体操作方法可参考《BMC Studio用户指南》中的“配置CSR模块”章节。

3. 添加“I2c总线”。

4. 将器件和连接器拖拽到总线上或9545芯片的不同channel上，创建拓扑并进行配置，配置完成后，拓扑和Riser卡拓扑图一致。

   说明：
   如果需要将总线传到Connector中，可以拖拽总线连接到Connector。
   将光标移动到总线上，并单击红色叉号，可以删除这条传入的总线。
   单击右侧“查看代码”可查看生成的CSR内容。
   

5. 双击框图的空白处配置板卡对象RiserCard_1。

6. 在页面上方选择“业务视图”配置Chip_MCU和MCU升级的对象。

7. 配置Eeprom_IEU并在业务视图中配置SRUpgrade_1对象，由于SRUpgrade_1对象的WriteProtect需要从Pca9555芯片获取，因此需要在pca9555芯片上配置读取器Scanner类型对象。

事件定制 ​

以板卡适配中配置Riser卡电源失效事件为例：

配置事件前，需先配置要关联的组件， 当前组件为Riser卡，如果配置Riser卡的电子标签信息和部件信息，需要在业务视图中完成Fru_IEU对象和FruDate_IEU对象的配置。

说明：
Fru_IEU对象的每个属性的配置描述可以参考板卡适配中的“对象配置 > fru类”中的Fur。
FruData_IEU对象的每个属性的配置描述可参考板卡适配中的“对象配置 > fru类”中的FruData。

![告警所需对象配置](../images/board_integration_guide/告警所需对象配置.png)

1. 在CSR配置页面选择“告警事件”，并选择需要配置的告警项。

2. 对内容进行配置，Reading字段取值可以从Scanner对象获取。

3. 创建事件需要关联Component，在事件配置中选择Component配置关联。

4. 如果需要配置新的事件告警，可以在页面右上角选择自定义添加，手动配置告警。EvenKeyld需要手动配置，告警信息和修复信息分别支持10个参数。

告警可视化配置 ​

告警事件页面支持查看现有告警定义及告警描述信息，同时也可以直观查看当前板卡中已配置的告警内容。

说明：
特性需要较高版本的社区vpd仓，对于历史版本的工作空间，可以手动下载社区vpd仓库中vendor路径下的event_def.json文件，放在工作空间中的vpd/vendor路径下。
支持从预定义模板添加现有事件，添加事件自动关联事件ID和类型。