关于阿里云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
