二次开发

概述

如果透传云的管理后台无法满足您的个性化需求，可以利用SDK和API接口实现二次开发，用户只需制作界面，从透传云调数据就可以完成项目。
基于二次开发可自主实现目前透传云后台全部功能。

两种二次开发方式

1. 基于云组态开发

服务器采集和解析，程序二次开发获取解析好的数据。
添加设备时选择透传云支持的协议，用户程序可按JSON格式与透传云交互，透传云将自动转换为设备的协议。
以Modbus为例，服务器向设备主动发送读取指令，设备返回数据根据数据点规则完成解析、存储、报警等，并转换为JSON格式推送给SDK，程序也可发送JSON格式完成主动控制。
SDK实现JSON格式采集和控制：

• 设置设备数据点值
• 设备数据点变化推送
• 查询设备数据点值
• 设备上下线推送
• 设备报警推送

API实现业务管理：

• 注册登录
• 获取设备列表
• 获取设备在线状态
• 获取设备信息
• 获取历史数据
• 获取报警记录
• …

2. 基于云交换机开发

服务器只中转原始数据流，程序二次开发获取单台、多台设备数据流。
添加透传设备，服务器将不做协议处理，设备发送的数据流通过SDK主动推送用户程序，同时用户程序使用SDK发送的数据流也中转给设备。
SDK实现数据流收发：

• 向指定单台设备发送数据流
• 订阅单台设备，接收设备发送的数据流
• 向账号下全部设备发送数据流
• 订阅账号下全部设备，接收账号下全部设备发送的数据流

API实现业务管理：

• 注册登录
• 获取设备列表
• 获取设备在线状态
• 获取设备信息
• …（由于未使用服务器做协议处理，无法使用历史数据、报警记录等功能）

二次开发介绍

1、SDK开发介绍
SDK连接服务器

服务器地址：clouddata.usr.cn
TCP端口：1883
Websocket端口：8080、443（Websocket SSL）

SDK包和文档

名称	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字节整型

使用SDK包Demo收发测试：

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

00007867000000000001

发送Modbus RTU查询指令（十六进制格式发送）：

01 03 00 63 00 03 F5 D5

收到设备回复（十六进制格式接收）：

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