码迷,mamicode.com
首页 > 其他好文 > 详细

cumulocityiot mqtt静态模板

时间:2020-04-03 12:31:53      阅读:123      评论:0      收藏:0      [点我收藏+]

标签:强制   param   relay   电池   显示   ever   清除   基本   mmu   

MQTT静态模板

总览

为了简化设备集成,Cumulocity IoT已经支持许多静态模板,任何客户端都可以使用它们,而无需创建自己的模板。这些模板专注于用于设备管理目的的最常用消息。

要使用下面列出的模板,您需要将消息发布到主题s/ust/us用于临时处理已发布内容,q/us用于静态处理已发布内容或c/us用于CEP处理已发布内容。有关更多信息,请参阅参考指南中的SmartREST>处理模式。信息。

您需要预订主题s/ds才能接收使用静态模板的操作。

自动创建设备

静态模板主题支持自动创建设备。每当没有与您的MQTT ClientID关联的子级并发送数据时,Cumulocity IoT都会自动为MQTT ClientID创建设备。如果要自己创建设备,则第一条消息必须是设备创建。在这种情况下,Cumulocity IoT将根据模板创建设备。

第一级子设备也支持自动创建设备。对于更深层次的子设备,您必须使用模板来创建子设备,方法是将其发送到要放置新子设备的子设备下的子设备主题。

不处理任何强制性参数

如果未将参数声明为必需参数,则客户端可以在该位置发送空字符串。

100,,myType

不需要尾部逗号。下面的两行结果相同。

100,,
100

发布模板

以下模板可用于发布有关主题s/us以及的数据t/us参阅SmartRest>处理模式的参考指南中有关的更多信息t/用于瞬时数据处理主题。

库存模板(1xx)

设备创建(100)

如果清单中的序列号尚不存在,请为其创建一个新设备。将为类型为c8y_Serial的设备创建一个externalId ,并将MQTT clientId的设备标识符作为值。

位置参数强制性的默认
1个 设备名称 没有 MQTT设备<serialNumber>
2 设备类型 没有 c8y_MQTTDevice

100,myDevice,myType
创建子设备(101)

为当前设备创建一个新的子设备。新创建的对象将添加为子设备。此外,将使用c8y_Serial类型创建该子项的externaId,其值是根设备的序列号和唯一子项ID的组合。

位置参数强制性的默认
1个 唯一的孩子ID  
2 设备名称 没有 MQTT设备<serialNumber>
3 设备类型 没有 c8y_MQTTChildDevice

101,uniqueChildId,myChildDevice,myChildType
获取子设备(105)

触发设备子设备的发送。

105
清除设备的碎片(107)

从设备上移除一个或多个碎片。

位置参数强制性的
1… fragmentName

107,c8y_Position,c8y_Configuration
配置硬件(110)

更新设备的硬件属性。

位置参数强制性的
1个 序列号 没有
2 模型 没有
3 修订版 没有

110,1234567890,myModel,1.2.3
配置手机(111)

更新设备的移动属性。

位置参数强制性的
1imei 没有  
2 iccid 没有
3 imsi 没有
4 中冶 没有
5 跨国公司 没有
6 紫胶 没有
7 cellId 没有

111,1234567890,,54353
配置位置(112)

更新设备的位置属性。

位置参数强制性的
1个 纬度 没有
2 经度 没有
3 高度 没有
4 准确性 没有

112,50.323423,6.423423
设置配置(113)

更新设备的配置属性。

位置参数强制性的
1个 组态 没有

113,"??val1=1\nval2=2"
设置支持的操作(114)

设置设备支持的操作。

位置参数强制性的
1… 支持的操作列表 没有

114,c8y_Restart,c8y_Configuration,c8y_SoftwareList
设定固件(115)

设置设备上安装的固件。

位置参数强制性的
1个 名称 没有
2 没有
3 网址 没有

115,firmwareName,firmwareVersion,firmwareUrl
设定软件列表(116)

设置设备上安装的软件列表。

位置参数强制性的
1… 每个软件3个值的列表 没有
1.1 名称 没有
1.2 没有
1.3 网址 没有

116,software1,version1,url1,software2,,url2,software3,version3
设置所需的可用性(117)

设置可用性监视所需的时间间隔。如果不存在,它将只设置该值。例如,通过用户界面输入的值不会被覆盖。

位置参数强制性的
1个 所需间隔 没有

117,60

测量模板(2xx)

创建自定义度量(200)

使用给定的片段和序列创建度量。

位置参数强制性的默认
1个 分段  
2 系列  
3  
4 单元 没有  
5 时间 没有 当前服务器时间

200,c8y_Temperature,T,25
创建信号强度测量(210)

创建类型为c8y_SignalStrength的度量

位置参数强制性的默认
1个 rssi值 是,如果未设置2  
2 误码率 是,如果未设置1  
3 时间 没有 当前服务器时间

210,-90,23,2016-06-22T17:03:14.000+02:00
创建温度测量值(211)

创建类型为c8y_TemperatureMeasurement的度量

位置参数强制性的默认
1个 温度值  
2 时间 没有 当前服务器时间

211,25,2016-06-22T17:03:14.000+02:00
创建电池测量值(212)

创建类型为c8y_Battery的度量

位置参数强制性的默认
1个 电池电量  
2 时间 没有 当前服务器时间

212,95,2016-06-22T17:03:14.000+02:00

警报模板(3xx)

创建严重警报(301)

创建一个严重警报。

位置参数强制性的默认
1个 类型  
2 文本 没有 警报类型为警报类型引发
3 时间 没有 当前服务器时间

301,c8y_TemperatureAlarm
创建主要警报(302)

创建一个主要警报。

位置参数强制性的默认
1个 类型  
2 文本 没有 警报类型为警报类型引发
3 时间 没有 当前服务器时间

302,c8y_TemperatureAlarm,"This is an alarm"
创建轻微警报(303)

创建一个MINOR警报。

位置参数强制性的默认
1个 类型  
2 文本 没有 警报类型为警报类型引发
3 时间 没有 当前服务器时间

303,c8y_TemperatureAlarm
创建警告警报(304)

创建一个警告警报。

位置参数强制性的默认
1个 类型  
2 文本 没有 警报类型为警报类型引发
3 时间 没有 当前服务器时间

304,c8y_TemperatureAlarm,,2013-06-22T17:03:14.000+02:00
更新现有警报的严重性(305)

更改现有警报的严重性。

位置参数强制性的
1个 类型
2 严重程度

305,c8y_TemperatureAlarm,CRITICAL
清除现有警报(306)

清除现有警报。

位置参数强制性的
1个 类型

306,c8y_TemperatureAlarm
清除警报的片段(307)

从特定类型的警报中删除一个或多个碎片。

位置参数强制性的
1个 AlarmType
2… fragmentName

307,c8y_TemperatureAlarm,c8y_Position,c8y_Configuration

活动模板(4xx)

创建基本事件(400)

创建给定类型和文本的事件。

位置参数强制性的默认
1个 类型  
2 文本  
3 时间 没有 当前服务器时间

400,c8y_MyEvent,"??Something was triggered"
创建位置更新事件(401)

创建包含c8y_Position的典型位置更新事件

位置参数强制性的默认
1个 纬度 没有  
2 经度 没有  
3 高度 没有  
4 准确性 没有  
5 时间 没有 当前服务器时间

401,51.151977,6.95173,67
使用设备更新创建位置更新事件(402)

创建包含c8y_Position的典型位置更新事件此外,设备将使用相同的c8y_Position片段进行更新

位置参数强制性的默认
1个 纬度 没有  
2 经度 没有  
3 高度 没有  
4 准确性 没有  
5 时间 没有 当前服务器时间

402,51.151977,6.95173,67
清除事件的片段(407)

从特定类型的事件中删除一个或多个片段。

位置参数强制性的
1个 事件类型
2… fragmentName 没有

407,c8y_MyEvent,c8y_Position,c8y_Configuration

操作模板(5xx)

获取待处理操作(500)

触发代理的所有挂起操作的发送。

500
将操作设置为EXECUTING(501)

将具有给定片段的最早的PENDING操作设置为EXECUTING。

位置参数强制性的
1个 分段

501,c8y_Restart
将操作设置为失败(502)

将给定片段的最早的EXECUTING操作设置为FAILED。

位置参数强制性的
1个 分段
2 失败原因 没有

502,c8y_Restart,"Could not restart"
将操作设置为成功(503)

将给定片段的最早的EXECUTING操作设置为SUCCESSFUL。

它使设备能够发送其他参数,这些参数会根据作为片段发送的操作类型来触发其他步骤(请参阅“ 更新操作”一)。

位置参数强制性的
1个 分段
2… 参数 没有

503,c8y_Restart

订阅模板

订阅时,客户端可以接收以下模板s/ds

库存模板(1xx)

获取设备的子代(106)

列出设备的所有子代。

位置参数
1… 儿童

106,child1,child2,child3

操作模板(5xx)

所有操作响应都具有相同的基本结构,以消息ID开头,后跟应该处理该操作的根设备或子代的ID。

重新启动(510)

重新启动设备。

510,DeviceSerial
指挥官(511)

运行操作中发送的命令。

位置参数
1个 命令文字

511,DeviceSerial,execute this
配置(513)

设置操作中要发送的配置。

位置参数
1个 组态

513,DeviceSerial,"?val1=1\nval2=2"
固件(515)

从URL安装固件。

位置参数
1个 固件名称
2 固件版本
3 网址

515,DeviceSerial,myFimrware,1.0,http://www.my.url
软件列表(516)

安装操作中发送的软件。

位置参数
1… 每个软件3个值的列表
1.1 名称
1.2
1.3 网址

516,DeviceSerial,softwareA,1.0,url1,softwareB,2.0,url2
测量请求操作(517)

发送由请求名称指定的测量。

位置参数
1个 要求名称

517,DeviceSerial,LOGA
接力赛(518)

打开或关闭继电器。

位置参数
1个 中继状态

518,DeviceSerial,OPEN
中继阵列(519)

打开或关闭阵列中的继电器。

位置参数
1… 中继状态列表

519,DeviceSerial,OPEN,CLOSE,CLOSE,OPEN
上传配置文件(520)

当前配置从Cumulocity IoT上传到设备。

520,DeviceSerial
下载配置文件(521)

从网址下载配置文件。

位置参数
1个 网址

521,DeviceSerial,http://www.my.url
日志文件请求(522)

上载给定参数的日志文件。

位置参数
1个 日志文件名
2 开始日期
3 结束日期
4 搜索文字
5 最大行数

522,DeviceSerial,logfileA,2013-06-22T17:03:14.000+02:00,2013-06-22T18:03:14.000+02:00,ERROR,1000
通讯模式(523)

更改通讯模式。

位置参数
1个 模式

523,DeviceSerial,SMS

更新操作

使用模板将操作设置为状态SUCCESSFUL时,它支持发送其他参数以触发服务器上的其他调用。下表显示了支持此功能的操作以及将使用参数执行的操作。

分段参量动作已触发
c8y_Command 结果 结果将被添加到操作中
c8y_RelayArray 中继状态 设备对象将更新为状态
c8y_CommunicationMode 无需参数 设备对象将使用模式更新
c8y_LogfileRequest 文件网址 文件网址将被添加到操作中
c8y_DownloadConfigFile (可选)时间戳 设备对象将使用配置转储的ID和时间戳(或服务器时间)进行更新。

 

cumulocityiot mqtt静态模板

标签:强制   param   relay   电池   显示   ever   清除   基本   mmu   

原文地址:https://www.cnblogs.com/quchunhui/p/12625421.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!