IoT物联网-离线开发Profile（联通用户专用）:设备能力定义样例

时间：2025-02-12 14:52:35

IoT物联网

设备能力定义样例

devicetype-capability.json记录了该设备的基础信息：

{    "devices": [        {            "manufacturerId": "TestUtf8ManuId",            "manufacturerName": "HZYB",            "model": "NBIoTDevice",            "protocolType": "CoAP",            "deviceType": "WaterMeter",            "omCapability":{                           "upgradeCapability" : {                                "supportUpgrade":true,                               "upgradeProtocolType":"PCP"                         },                          "fwUpgradeCapability" : {                                                 "supportUpgrade":true,                                   "upgradeProtocolType":"LWM2M"                         },                         "configCapability" : {                                                 "supportConfig":true,                               "configMethod":"file",                               "defaultConfigFile": {                                  "waterMeterInfo" : {                                       "waterMeterPirTime" : "300"                                   }                               }                         }              },              "serviceTypeCapabilities": [                {                    "serviceId": "WaterMeterBasic",                    "serviceType": "WaterMeterBasic",                    "option": "Mandatory"                },                {                    "serviceId": "WaterMeterAlarm",                    "serviceType": "WaterMeterAlarm",                    "option": "Mandatory"                },                {                    "serviceId": "Battery",                    "serviceType": "Battery",                    "option": "Optional"                },                {                    "serviceId": "DeliverySchedule",                    "serviceType": "DeliverySchedule",                    "option": "Mandatory"                },                {                    "serviceId": "Connectivity",                    "serviceType": "Connectivity",                    "option": "Mandatory"                }            ]        }    ]}

各字段的解释：

字段	子字段		可选/必选	描述
devices			必选	包含了一个设备的完整能力信息（根节点不能修改）。
	manufacturerId		必选	指示设备的制造商ID。
	manufacturerName		必选	指示设备的制造商名称（只允许英文）。
	model		必选	指示设备的型号，考虑到一款设备下的多种型号，建议包含字母或数字以保证可扩展性。
	protocolType		必选	指示设备接入物联网平台的协议类型。如NB-IoT的设备取值为CoAP。
	deviceType		必选	指示设备的类型。
	omCapability		可选	定义设备的软件升级、固件升级和配置更新的能力，字段含义详情见下文中的：omCapability结构描述。如果设备不涉及软件/固件升级，本字段可以删除。
	serviceTypeCapabilities		必选	包含了设备具备的服务能力描述。
		serviceId	必选	服务的Id，如果设备中同类型的服务类型只有一个则serviceId与serviceType相同，如果有多个则增加编号，如三键开关 Switch01、Switch02、Switch03。
		serviceType	必选	服务类型，与servicetype-capability.json中serviceType字段保持一致。
		option	必选	标识服务字段的类型，取值范围：Master（主服务）, Mandatory（必选服务）, Optional（可选服务）。目前本字段为非功能性字段，仅起到描述作用。

omCapability结构描述

字段	子字段	可选/必选	描述
upgradeCapability		可选	设备软件升级能力。
	supportUpgrade	可选	true：设备支持软件升级。 false：设备不支持软件升级。
	upgradeProtocolType	可选	升级使用的协议类型，此处不同于设备的protocolType，例如CoAP设备软件升级协议使用PCP。
fwUpgradeCapability		可选	设备固件升级能力。
	supportUpgrade	可选	true：设备支持固件升级。 false：设备不支持固件升级。
	upgradeProtocolType	可选	升级使用的协议类型，此处不同于设备的protocolType，当前物联网平台仅支持LWM2M固件升级。
configCapability		可选	设备配置更新能力。
	supportConfig	可选	true：设备支持配置更新。 false：设备不支持配置更新。
	configMethod	可选	file：使用文件的方式下发配置更新。
	defaultConfigFile	可选	设备默认配置信息（Json格式），具体配置信息由设备商自定义。物联网平台只储存该信息供下发时使用，不解析处理配置字段的具体含义。