北向资源协议概览
RHILEX 支持将数据推送到多种目的地，包括 MQTT Broker、UDP Server、TCP Server、HTTP Server、MongoDB、TDengine、串口和Semtech UDP Forwarder。这些目的地涵盖了物联网（IoT）和工业自动化的主要数据存储和通信需求。这些丰富的推送目的地特性使得 RHILEX 在物联网和工业自动化领域具有广泛的适用性和高度的灵活性。
数据推送到 MQTT Broker
此功能允许设备通过 MQTT 协议将数据发送到 MQTT 代理（Broker）。MQTT 是一种轻量级的消息传输协议，广泛应用于物联网（IoT）场景，特别适合于带宽有限和延迟敏感的应用。
资源配置
| 参数 | 说明 |
|---|---|
| 主机地址 | MQTT 服务器的地址 |
| 端口 | MQTT 服务器的端口 |
| 客户端ID | 连接 MQTT 服务器所用的客户端ID |
| 上报 Topic | 数据上报 MQTT 服务器的 Topic |
| 连接账户 | 连接 MQTT 服务器所用的 MQTT 账号 |
| 连接密码 | 连接 MQTT 服务器所用的 MQTT 密码 |
数据推送
Actions = {
function(args)
local exampleData = "....." -- 示例数据
local err1 = data:ToMqtt('$UUID', exampleData)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}
数据推送到 UDP Server
支持将数据通过用户数据报协议（UDP）发送到 UDP 服务器。UDP 是一种无连接的传输协议，常用于需要快速传输但不要求可靠到达的应用，如视频流或多播通信。
资源配置
| 参数 | 说明 |
|---|---|
| 主机地址 | UDP 服务器的地址 |
| 端口 | UDP 服务器的端口 |
| 心跳包内容 | 用户定时发送的心跳包数据 |
数据推送
Actions = {
function(args)
local exampleData = "....." -- 示例数据
local err1 = data:ToUdp('$UUID', exampleData)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}数据推送到 TCP Server
允许设备使用传输控制协议（TCP）将数据发送到 TCP 服务器。TCP 是一种面向连接的、可靠的传输协议，适用于需要确保数据完整性和顺序性的应用。
资源配置
| 参数 | 说明 |
|---|---|
| 主机地址 | TCP 服务器的地址 |
| 端口 | TCP 服务器的端口 |
| 心跳包内容 | 用户定时发送的心跳包数据 |
数据推送
Actions = {
function(args)
local exampleData = "....." -- 示例数据
local err1 = data:ToTcp('$UUID', exampleData)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}数据推送到 HTTP Server
此功能支持通过超文本传输协议（HTTP）将数据发送到 HTTP 服务器。HTTP 是 Web 服务的基石，常用于 RESTful API 的实现，适用于需要通过 Web 进行数据交换的场景。
资源配置
| 参数 | 说明 |
|---|---|
| 请求地址 | HTTP 服务器 API 接口的地址，默认是 POST 请求 |
| Header | HTTP 请求所用的 Headers，是一个 Map 结构 |
| 心跳包内容 | 用户定时发送的心跳包数据 |
数据推送
Actions = {
function(args)
local exampleData = "....." -- 示例数据
local err1 = data:ToHttp('$UUID', exampleData)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}数据推送到 MongoDB
支持将数据存储到 MongoDB 数据库中。MongoDB 是一个基于文档的 NoSQL 数据库，适用于大数据和实时 Web 应用，提供高性能、高可用性和自动化的水平扩展能力。
资源配置
| 参数 | 说明 |
|---|---|
| MongoDB URL | MongoDB 的标准 URL 格式 |
| MongoDB 数据库 | 指定要保存的数据库名 |
| MongoDB 集合 | 数据保存的集合名 |
数据推送
Actions = {
function(args)
local exampleData = "....." -- 示例数据
local err1 = data:ToMongo('$UUID', exampleData)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}数据推送到 TDengine
允许将数据存储到 TDengine 时序数据库中。TDengine 是一个专为时序数据优化的高性能数据库，适用于物联网（IoT）和大数据分析场景，特别适合处理时间序列数据。
资源配置
| 参数 | 说明 |
|---|---|
| FQDN | TDengine 服务器的地址 |
| 端口 | TDengine 服务器的端口 |
| 用户名 | 连接 TDengine 服务器所用的账号，默认是 root |
| 密码 | 连接 TDengine 服务器所用的密码，默认是 taos |
数据推送
Actions = {
function(args)
local exampleData = "....." -- 示例数据
local err1 = data:ToTdEngine('$UUID', exampleData)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}数据推送到串口
此功能支持将数据发送到串口设备。串口通信是一种传统的数据传输方式，广泛用于工业控制、传感器数据采集等领域。
资源配置
| 参数 | 说明 |
|---|---|
| 心跳包内容 | 用户定时发送的心跳包数据 |
| 传输模式 | 选择数据以十六进制字符串传输还是以原始字节传输 |
| 系统串口 | 指定要发送数据到哪个串口 |
数据推送
Actions = {
function(args)
local err1 = data:ToUart('$UUID', data)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}数据推送到 Semtech UDP Forwarder
支持将数据通过 Semtech UDP Forwarder 发送。Semtech UDP Forwarder 通常用于 LoRaWAN 网络，将数据从 LoRaWAN 节点转发到 LoRaWAN 服务器，如 Chirp Stack，适用于低功耗广域网（LPWAN）应用。
资源配置
| 参数 | 说明 |
|---|---|
| 主机地址 | Semtech UDP 服务器的地址 |
| 端口 | Semtech UDP 服务器的端口 |
| MAC 地址 | 连接 Semtech UDP 服务器所用的网关 ID，一般在对应的平台可以找到 |
数据推送
Actions = {
function(args)
local exampleData = "....." -- 示例数据
local err1 = data:ToSemtechUdp('$UUID', exampleData)
if err1 ~= nil then
-- DO YOUR FAILED HANDLE
Throw(err1)
end
return true, args
end
}