概述
如果透传云的管理后台无法满足您的个性化需求,可以利用SDK和API接口实现二次开发,用户只需制作界面,从透传云调数据就可以完成项目。基于二次开发可自主实现目前透传云后台全部功能。
两种二次开发方式
1. 基于云组态开发
添加设备时选择透传云支持的协议,用户程序可按JSON格式与透传云交互,透传云将自动转换为设备的协议。
以Modbus为例,服务器向设备主动发送读取指令,设备返回数据根据数据点规则完成解析、存储、报警等,并转换为JSON格式推送给SDK,程序也可发送JSON格式完成主动控制。
SDK实现JSON格式采集和控制:
- 设置设备数据点值
- 设备数据点变化推送
- 查询设备数据点值
- 设备上下线推送
- 设备报警推送
- 注册登录
- 获取设备列表
- 获取设备在线状态
- 获取设备信息
- 获取历史数据
- 获取报警记录
- …
服务器只中转原始数据流,程序二次开发获取单台、多台设备数据流。
添加透传设备,服务器将不做协议处理,设备发送的数据流通过SDK主动推送用户程序,同时用户程序使用SDK发送的数据流也中转给设备。
SDK实现数据流收发:
- 向指定单台设备发送数据流
- 订阅单台设备,接收设备发送的数据流
- 向账号下全部设备发送数据流
- 订阅账号下全部设备,接收账号下全部设备发送的数据流
- 注册登录
- 获取设备列表
- 获取设备在线状态
- 获取设备信息
- …(由于未使用服务器做协议处理,无法使用历史数据、报警记录等功能)
二次开发介绍
1、SDK开发介绍SDK连接服务器
服务器地址:clouddata.usr.cnSDK包和文档
TCP端口:1883
Websocket端口:8080、443(Websocket SSL)
名称 |
SDK形式 |
使用文档 |
Demo下载 |
Web网页端 |
|
查看 |
(在线演示) |
微信小程序开发 |
|
查看 |
|
PC端开发 |
DLL(下载地址) |
查看 |
|
JAVA或安卓开发 |
Jar包(下载地址) |
查看 |
如demo下载地址无法访问,请从备用地址获取。
若SDK无法满足您使用的语言,可基于SDK底层文档自主接入:《透传云二次开发SDK底层协议》。
2、API开发介绍
API连接服务器
服务器地址:cloudapi.usr.cn示例代码:
端口:443(HTTPS)
名称 |
Demo下载 |
Web网页端开发 |
(在线演示) |
开发文档
《透传云二次开发API接口协议》
如何测试
透传云提供一台测试设备,配置如下:
- 设备ID:00007867000000000001
- 所属帐号:sdktest 密码:sdktest
- 设备协议:Modbus RTU(从机)
- 从机号:1
- 数据类型:2字节整型
- 寄存器值:
寄存器地址 |
值 |
40100 |
2字节整型 |
40101 |
随机(0~32767) |
40102 |
2字节整型 |
- 初始化
- 连接
- 订阅设备
00007867000000000001
发送Modbus RTU查询指令(十六进制格式发送):
01 03 00 63 00 03 F5 D5
收到设备回复(十六进制格式接收):
01 03 06 00 01 28 9C 00 02 54 FA