logo

二次开发


二次开发教程

概述

如果透传云的管理后台无法满足您的个性化需求,可以利用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网页端
Js包 Js包
查看
在线演示
微信小程序开发
Js包 Js包 
查看
小程序 小程序 
PC端开发
DLL(下载地址
查看
C++ Demo C++ Demo
Delphi Demo Delphi Demo
C# Demo C# Demo
JAVA或安卓开发
Jar包(下载地址
查看
APK and 源码 APK and 源码 
注:若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