规格配置文件定义

配置文件介绍

OM SDK中的DEVM通过模组和设备两个层级的架构对设备管理进行建模。一个边缘产品包含多个模组，一个模组支持管理多个设备。例如Atlas 500 A2 智能小站作为一个边缘产品，包含了CPU、NPU、mainboard、u_disk等多个模组。一个u_disk模组支持同时管理usb0、usb1、usb2等多个设备。

开发者通过定义配置文件中的产品和模组信息，从而适配模组驱动的开发。一组配置文件由一个产品规格配置文件以及若干个模组规格配置文件组成。

产品规格配置文件：产品规格配置文件定义了产品中所有的设备，对每个设备要定义设备名称并指定所属的模组。样例请参见附录A.1。
模组规格配置文件：一个模组对应一个以“module_”开头的配置文件，开发者需要定义其动态链接库文件的路径以及模组支持的属性等信息。样例请参见附录A.2。

关键字段说明

产品规格配置文件和模组规格配置文件中的关键字段说明请参见下表。

表1 产品参数说明
参数	可选或必选	说明
name	必选	产品名称。
modules	必选	产品模组字典。
module_name	必选	模组名称，需要确保不与已有模组名重复即可。
devices	必选	设备列表。

表2 模组参数说明
参数	必选或可选	说明
name	必选	模组名称，需要确保不与已有模组名称重复。
id	必选	模组ID，需要确保不与已有模组ID重复。
category	必选	模组类别，分为以下三种： internal：内置模组 extend：外设模组 addition：拓展模组二次开发的模组都属于拓展模组，都要写addition类别。
driver	必选	模组驱动（动态链接库）的路径。当前驱动的默认安装路径为“/usr/local/lib”，假设自定义模组的驱动文件名为libxxx.so，则路径应填写“/usr/local/lib/libxxx.xo”。
dynamic	必选	用来区分设备是否支持动态插拔属性，“true”代表支持动态插拔，“false”代表不支持动态插拔。热插拔的设备包括SD卡、USB接口的设备等。
attributes	必选	模组支持的属性表，为key-value结构，key为属性名，value仍是一个表，里面各字段配置属性关键信息。详细介绍请参见表3。

表3 模组属性参数说明
参数	必选或可选	说明
id	必选	属性ID，正整数，保证不与同级属性ID重复即可。
type	必选	数据类型，支持以下类型： string int long long float bool json
accessMode	必选	访问模式。 Read：只读 ReadWrite：读写 Write：只写
description	可选	属性说明。

父主题： （可选）模组开发