谷雨云透传平台接入指南
谷雨物联网的使命是让联网通信更简单，正因为这个使命，我们开发了【谷雨云透传平台】，面向广大开发者免费提供。
开发云透传还有一些重要原因：
- 降低NB-IOT的学习门槛。电信NB有定向IP访问限制，要求设备必须接入电信平台。
- 提供一款好用的免费的远程网络调试助手。并提供简单透传功能。
1 适用群体
谷雨云透传平台的定位是：极客的小创意、小产品的远程联网需求，网络连接测试。例如，使用NB-IOT技术，快速实现家庭烟雾报警的功能演示；或者远程温湿度监控等等。
因此我们的云透传平台的适用群体为：
- 学生
- 极客
- 开发者（处于学习或者Demo调研演示阶段）
当前版本虽然未2.0，但定位仍然为测试，量产产品建议接入华为、电信或阿里云IOT等企业级云平台，更有安全性和稳定性的保障。
2 平台能力
谷雨云透传平台具有下面几大能力：
- 支持本地UDP/TCP协议接入。设备直连谷雨云透传。
- 支持电信/华为平台对接（LwM2M或CoAP协议）。设备直连华为/电信平台，消息路由到谷雨云透传。
- 支持上述设备之间的数据透传能力。支持任意两个网络设备之间的数据透传。
3 平台接口
设备直连谷雨云透传采用最简单最原始的Socket连接，电信华为平台对接采用LwM2M或CoAP协议。
| 类型 | IP地址 | 端口号 |
|---|---|---|
| 设备直连（UDP协议） | 115.29.240.46 | 6000 |
| 设备直连（TCP协议） | 115.29.240.46 | 9000 |
| 电信平台对接（LwM2M或CoAP协议） | 117.60.157.137 | 5683 |
 |
注意，由于电信NB网络有定向IP访问限制，使用电信NB网络的用户需要使用电信平台对接的方式接入。没有访问限制的移动NB网络，或者其他网络，使用设备直连UDP/TCP协议接入。 |
4 注册包机制
平台为了鉴别接入设备的合法性，需要额外的一些信息或数据包来辅助判断。该信息或数据包，需要在平台上预先配置，因此设备接入平台之前，必须要在平台上先创建设备。
4.1 直连设备
Socket采用服务器/客户端的机制通信，客户端只要知道服务器的IP地址和端口号，就可以建立链接。
建立链接后，谷雨云透传为了识别客户端设备的合法性，使用了一种注册包机制，即客户端每次与平台建立链接后，首先需要发送一包数据，这包数据需要按照我们规定的格式来发送。平台通过该数据包的内容来识别设备。这个数据包，我们称之为注册包。
注册包格式为：ep=deviceId&pw=devicePw
deviceId（设备编号）和devicePw（设备密码）是两个变量。由云平台自动分配或客户自定义。
4.2 电信平台设备
电信平台采用验证模块IMEI码的方式，因此，创建电信平台设备时，设备编号，必须使用NB模块的IMEI码，否则无法通信。