有人透传云

二次开发

一、二次开发概述

透传云为用户更方便远程获取“有人”所有设备的数据流而生,用户可利用透传云二次开发接口实现数据和业务管理。

利用MQTT协议实现数据流的收发

  • 向指定单台设备发送数据;
  • 向帐号下全部设备发送数据;

有人已将MQTT协议封装为SDK包(包括:DLL、Websocket包、java包)。用户无需开发协议,直接利用SDK即可。

利用HTTPS协议实现业务管理

  • 获取设备列表、获取设备在线状态、添加删除编辑设备、帐号注册…等透传云管理后台全部功能。

业务服务器同时支持HTTP和HTTPS协议。

二、协议介绍

2.1. 数据服务器(MQTT协议)

协议约定:

服务器地址:clouddata.usr.cn

TCP连接端口:1883

Websocket连接端口:8080

SDK包:

名称 SDK形式 使用文档 Demo下载
PC端开发 DLL(下载地址) 查看 (C#) (Delphi) (LabView)
Web网页端开发 Js包(下载地址) 查看 (在线演示)
安卓手机端开发 Jar包(下载地址) 查看 (APK) (源码)

协议文档: 数据服务器基于MQTT协议,透传云定义了Topic规则,上述SDK均遵守本协议,用户也可自行实现本协议来接入透传云(文档见2.3)。

2.2. 业务服务器(HTTPS协议)

协议约定:

服务器地址:cloudapi.usr.cn

端口:443(HTTPS)、80(HTTP)

协议文档:见2.3下载

2.3. 协议文档下载(MQTT+HTTPS)

下载地址

三、如何测试

透传云提供一台测试设备,配置如下:

  • 设备ID:00007867000000000001
  • 所属帐号:sdktest 密码:sdktest
  • 设备协议:Modbus RTU(从机)
  • 从机号:1
  • 数据类型:2字节整型
  • 寄存器值
寄存器地址
40100 1
40101 随机(0~32767
40102 2

使用SDK包Demo收发测试:

  • 初始化
  • 连接
  • 订阅设备

00007867000000000001

发送Modbus RTU查询指令(十六进制格式发送):

01 03 00 63 00 03 F5 D5

收到设备回复(十六进制格式接收):

01 03 06 00 01 28 9C 00 02 54 FA