阿里云IoT平台CoAP接入 3 了解下物模型

关于阿里云IoT平台CoAP接入，可见笔记阿里云IoT平台CoAP接入

小能手另外分享了NB-IoT的应用开发心得，先从模组端对几个常见模块进行试用分析，接着对更上层具体的CoAP协议进行研究，并且演示如何对接主流的第三方物联网平台，可以见NB-IoT应用开发笔记

1 前言

上一篇使用基础版产品进行接入，此种应用，阿里云IoT平台作为一个数据管道。另外阿里云物联网套件中还提供了高级版产品，使用物模型(TSL)来细化产品定义，可以在阿里云平台直接操作产品。

物联网套件高级版中，对物理空间中的实体进行了数字化建模，物理实体可以是各类传感器、车载装置、工业切片机等，也可以是“楼宇”、“房间”甚至“工厂”等等。现阶段，物联网中与人发生直接交互的物，更多是一个个具体的设备，因此，我们将设备抽象为“物”（Thing），通过物模型对设备是什么、能做什么、可以对外提供哪些服务进行描述。一般情况下，物模型表现为设备的“功能”，包括至少一个“属性”（Property）或“服务”（Service）或“事件”（Event）。开发者完成产品的功能定义后，系统将自动生成该产品的“物模型”，以JSON格式表述，称之为 TSL（即 Thing Specification Language），请参考文档产品功能定义。

具体关于物模型的介绍可以查看官方帖子，阿里云物联网套件 > 快速入门 > 高级版快速开始 > 基于物模型开发设备

这篇笔记将会介绍官方的物模型示例，官方花了较多篇幅介绍物模型，我就不搬运了。但是物模型如何转化为 Alink Json 才是接入时最重要的一点，也是最容易出错的地方，本能手花了好几天，在阿里云伙伴的帮助下终于成功上报了数据。为了其他朋友少走一些弯路，本能手创建了一个烟感产品，演示如何把TSL转化为 Alink Json。这为下一步高级版的 CoAP 接入测试做好协议准备。

2 官方物模型解析

官方将 Alink Json 协议的介绍，放在了开发指南里面，阿里云物联网套件 > 开发指南 > 设备协议，其中有属性、事件、服务的 Alink Json 通信格式介绍。

我这边搬运一个设备属性上报的示例，其他例子大家可以多看看，特别是再处理具体协议时，可以到这边做个比对。

{"id" : "123","version":"1.0","params" : {"Power" : {"value":"on"，"time":1524448722000    }"WF" : {"value":{}，"time":1524448722000   }},"method":"thing.event.property.post"
}

具体字段的细节定义如下：

有几点要注意下，如果没有严格按照这个格式来，后台就无法解析：

物模型字段必须完全一致。

id、version、method、time 等等这些字段一个都不能少。开发者可变的就是“请求参数”下的“属性名称”和“属性的值”这些键值对。
各个属性的字段一定要注意看其定义的数据类型

比如 time 字段的数值是UTC毫秒，是长整形数，不用加双引号。是的，本能手一定犯过这个错，才会重点写出来告诉大家。

3 烟感产品物模型解析

本能手这边举例的设备定义是烟感设备。

属性   烟雾检测状态  SmokeSensorState    enum    枚举值：0-正常; 1-检测到烟雾;
事件  故障上报        Error                   -   事件类型：信息

3.1 烟感设备属性上报

{"id":"123","version":"1.0","params":{"SmokeSensorState":{"value":1,"time":1524448722000}},"method":"thing.event.property.post"
}

3.2 烟感设备事件上报

{"id":"123","version":"1.0","params":{"Error":{"value":1,"time":1524448722000}},"method":"thing.event.property.post"
}

4 增强型的烟雾报警器

官方模版比较简单，只有1个属性和1个事件。我再定义相对完备的烟雾报警器。

4.1 物模型描述

                {"identifier": "SmokeSensorState","dataType": {"specs": {"0": "正常","1": "检测到烟雾"},"type": "enum"},"name": "烟雾检测状态"},{"identifier": "RemoveState","dataType": {"specs": {"0": "正常","1": "拆卸报警"},"type": "bool"},"name": "拆卸报警状态"},{"identifier": "BatteryPercentage","dataType": {"specs": {"unit": "%","min": "0","unitName": "百分比","max": "100"},"type": "double"},"name": "电池电量"},{"identifier": "Period","dataType": {"specs": {"unit": "″","min": "10","unitName": "秒","max": "79800"},"type": "int"},"name": "心跳上报周期"}

4.2 CoAP 上报 payload

Alink Json 整理如下：

{"id":"123","version":"1.0","params":{"SmokeSensorState":{"value":0,"time":1526051254000},"RemoveState":{"value":0,"time":1526051254000},"BatteryPercentage":{"value":99,"time":1526051254000},"Period":{"value":10,"time":1526051254000}},"method":"thing.event.property.post"
}

5 END