物模型接入价值与实践（三）

物模型接入价值与实践（三）

物模型接入流程详细介绍

流程图

以下是客户详细接入流程，主要分为：云端配置、设备开发、服务端开发、设备运行时管理四大部分。平台会提供一些工具，使各部分流程更高效。接下来进行详细介绍。

本文试图手把手介绍从0到1接入物模型，还会配套介绍一些接入过程中有帮助的平台能力，所以文章篇幅比较长，事实上客户接入流程还是非常简单的，真正开发只需要涉及到图中红色三个模块。

1 云端配置

1.1 创建产品（P0）

1.登录物联网平台。

2.创建产品。

说明：

• 所属品类：标准品类库提供了一些供参考的模板，选择后可以修改，建议使用。

• 节点类型：根据实际选择即可。

• 数据格式：“ICA标准数据格式(Alink JSON)”表示设备使用标准Alink JSON格式上报数据；“透传/自定义”表示设备可以使用自定义格式，通过Alink特定Topic上报物联网平台，该模式客户需要写脚本进行转换，透传模式在此不做展开，后面单独起文章介绍。

1.2 物模型建模（P0）

1.模型查看。

已有的模型是继承自创建产品时选择的“充电桩”品类模板。

2.编辑模型。

通过“编辑草稿”，进行修改和添加，最后需要对物模型“发布上线”。

说明：

• 定义物模型非常重要，物模型通过属性、事件、服务三要素描述了设备所有能力，设备和云交互、客户服务器访问设备通过物模型都可以实现协议标准化。如果客户定义的物模型如果足够通用和专业，阿里可以帮助作为ICA行业标准进行推广。

• 服务的调用方式有：同步调用、异步调用两种模式。客户云端开发调用下行控制API，同步调用和异步调用获取返回结果方式不一样，在后文“3.3”章节详细介绍。

物模型概念介绍
物模型介绍文档请参见这里

了解物模型概念，能够帮助您更好对设备建模。

1.3 物模型配置

当前默认是物模型强校验模式，即设备上报数据在IoT平台会进行物模型数据规范强校验，如果不符合规范会报错。

另外物模型弱校验、免校验、去重等规则也会在近期陆续开放，后期进行文档补充。

配置之后，会在设备运行时生效。

关联阅读：4.2 物模型扩展规则校验。

1.4 注册三元组（P0）

1.注册设备。

说明：
• 添加设备：测试阶段使用较多，单个添加。
• 批量添加：量产阶段使用，有两种模式，“自动生成”表示设备标识符(deviceName)由平台按照一定的规则随机颁发；“批量上传”支持客户自定义设备标识符(deviceName)。
2.查看设备列表。
可以通过“设备列表”、“批次管理”两种方式查看创建的设备列表。

通过“批次管理”查看这一批次设备详情，并且支持下载三元组列表。

注意：此处设备标识符(deviceName)非常重要，与productKey, deviceSecret一起称为设备的“三元组”，作为设备的唯一身份，大部分情况需要烧录到设备上。