点点控开发者设备接入说明

开发者接入介绍
点点控APP平台是一个中性的工控物联网APP，为工控用户和单片机硬件开发人员提供完善的APP连接服务，让硬件开发者按自己的想法开发产品，无需自己开发平台和APP，以降低开发成本，专注产品实现。

点点控平台为硬件开发者及工控开发者提供简单易用的设备接入服务，功能完善的点点控APP服务等软件平台及相关服务。

硬件开发者只需要将自己的设备按平台的数据传输协议要求接入平台，即可使用完整的点点控平台功能。硬件开发者及工控开发者只需要将精力投入到产品开发、销售和维护即可，便于硬件开发者快速出产品，满足市场需求。

点点控开发者平台目前已经正式对外提供服务。
点点控平台目前支持开发者自己编辑设备功能，自己生成设备序列号，只需将设备序列号写入到开发者自己开发的设备中，即可将设备接入平台，使用完整的点点控平台服务、APP、管理平台等功能。
目前平台只开放了MODBUS RTU协议的设备接入，需要开发者的设备支持 MODBUS RTU协议，全部功能均使用0x03功能码读取，0x06/0x10功能码写入数据。
为便于一些有数据同步要求的设备主动上报设备信息，平台支持扩展了0x33功能码，由设备使用0x33功能码上报数据，平台解析后在APP上展示。设备主动上报帧格式为：SlaveID CMD ADDR SIZE DATA CRCL CRCH。

如下示例：

设备上报（HEX）： 01 33 00 00 00 02 01 03 00 04 E8 CC

服务器返回（HEX）：01 33 00 00 00 02 84 0F

设备上报的数据中：

01为从站站号

33为主动上报功能码

00 00为起始寄存器地址

00 02为寄存器上报个数

01 03 00 04 为设备上报的数据

E8 CC CRC校验

设备接入方式

目前点点控平台只开通了一种设备接入方式：通过TCP连接建立时的注册包进行设备识别。

用户可以使用GPRS/CAT1/NB模块、WIFI模块、以太网模块等支持TCP CLIENT连接的模块接入平台。对于工控开发者，也可以使用串口服务器、DTU等设备，通过串口连接设备，通过网络接入平台使用。

平台接入地址： modbusv2.devcld.com:4949

注册包格式为：ID:KEY:ICCID

其中，ID为开发者通过 “开发产品”->“生产管理”生成的设备ID。

KEY为开发者通过 “开发产品”->“生产管理”生成的设备ID所对应的唯一KEY。

ICCID为移动网络设备的SIM卡序列号，序列号上传平台后便于开发者后续向用户收取流量服务年费。ICCID不是必须的参数，注册包只上传ID:KEY即可连接到平台，ICCID作为可选参数，便于开发者记录SIM卡号。

设备正常接入平台后，平台会将当前服务器的时间以时间戳方式返回给设备，设备可以通过此数据同步网络时间，以支持设备的一些定时功能等。如设备没有时间同步需求，可以忽略此信息。如开发者在使用过程中遇到接入问题，或者技术沟通、商务合作等需求，欢迎发送邮件到 yijianfankui@inleeq.com （意见反馈全拼），或者加入QQ群758280259 交流沟通。

账号注册
- 如需注册为点点控开发者，需要先注册为点点控平台用户。
- 通过电脑端浏览器登陆 https://ddk.devcld.com 点“注册”使用手机号码或者邮箱注册，也可以点“验证码登陆”使用手机号和验证码直接登录。
账号注册
- 如需注册为点点控开发者，需要先注册为点点控平台用户。
- 通过电脑端浏览器登陆 https://ddk.devcld.com 点“注册”使用手机号码或者邮箱注册，也可以点“验证码登陆”使用手机号和验证码直接登录。

登录点点控设备管理平台，主页左侧为功能导航列表，右侧为平台消息及报警消息列表。点击“开发者中心”，即可开通开发者账号。

登录开发者账号，可以从点点控设备管理平台按上图所示进入开发者中心，也可以电脑浏览器输入 https://developer.devcld.com/#/login 登录开发者中心。

首次登陆需要填写开发者厂家名称和手机号码进行绑定。后续点点控APP会在用户设备管理页展示厂家信息，以便于用户和开发者沟通和寻找售后、洽谈合作。

进入开发者中心后，可以对开发者自己生成的设备进行管理和操作。

创建产品后，可以在产品信息列表查看所创建的产品。点对应产品的右侧“功能管理”，进入产品功能管理页面。

添加完善需要的功能点，如下示例中，添加了3个功能点，一个温度数据展示，一个开关输出，一个报警信号采集。其中，报警信号采集开启了报警功能。用户绑定设备后，可以选择是否开启平台报警功能，以及选择报警方式。

生产管理

点击左侧导航栏 “开发产品”->“生产管理”，即可进入平台生产管理页面。生产管理页面可以查看开发者所创建的所有产品型号。

点击需要生产的设备型号右侧的“生成设备”，填入需要生成的设备序列号数量，即可生成对应的设备序列号。

生成设备序列号以后，即进入设备生成列表。开发者可以点击左上角“导出”按钮将生成的设备序列号信息导出为excel，可以将此信息批量打印为二维码，以便于用户通过点点控APP扫码绑定设备。导出后需要点击“清除”按钮清除当前是信息，否则下次生成设备仍然会保留上一次的信息，造成重复导出和打印。

开发者点击“设备管理”->“设备信息”栏，可以查看所有生成的设备序列号。其中，设备ID和SN用于提供给用户绑定设备使用，ID和KEY设置到设备里用于设备连接鉴权。
设备接入平台示例
- 我们以刚生成的温湿度传感器的数据，使用网络调试助手进行连接测试。将网络调试助手设置为TCP client，远程主机地址填写modbusv2.devcld.com解析到的IP地址，端口填写为4949