更新记录
1.0.0(2026-07-10)
首次发布
功能
- BLE 蓝牙连接(CH9141 / ESP32 NUS 双适配器)
- USB CH340 串口驱动(Android + 鸿蒙)
- TCP/IP 以太网桥接(ESP32 WebSocket/ETH)
- WiFi 热点扫描与配网
- Modbus RTU 协议栈(读写帧构建/解析/CRC)
- DL645 电表协议
- CJ188 协议
- BLE GATT 操作串行化队列
- 统一串口通信层(轮询/超时/健康检查)
- 跨平台支持:Android / HarmonyOS / 微信小程序
平台兼容性
uni-app(4.62)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| × |
√ |
× |
× |
√ |
√ |
√ |
- |
√ |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
edatahub 数据连接 SDK
武汉数熵科技有限公司 · edatahub 数据中台 — 数据连接基础层
适用武汉数熵科技有限公司的产品
数熵EB-N1-RS485,串口蓝牙调试器,RS485接口,内置可充电的锂电池,36小时续航,电源指示灯,通讯,蓝牙,电量(具备低电量提醒功能);
数熵EC-N1-RS485,串口调试器,RS485接口,支持安卓、鸿蒙手机Type-C接口接入进行串口通讯的调试;
数熵ED-Slink,多功能调试器,有RS485、RS232、CAN和TCP/IP通讯接口,支持广泛的电气物理接口,兼具对齐协议的支持;
工业串口统一连接 SDK,为物联网设备提供 BLE/USB/TCP 数据连接能力,支持 Modbus/DL645/CJ188 工业协议。
平台支持
| 平台 |
Android |
HarmonyOS |
微信小程序 |
iOS |
| 支持情况 |
√ |
√ |
√ |
- |
快速开始
安装
在 HBuilderX 中通过插件市场导入 srh-edatahub-link,或手动将本插件放入项目的 uni_modules/ 目录。
基本用法
import {
useConnectionStore,
CONNECTION_TYPES,
adapterManager,
SerialComm,
SerialConfig
} from '@/uni_modules/srh-edatahub-link'
// 1. 设置连接类型
const store = useConnectionStore()
store.setConnectionType(CONNECTION_TYPES.ED_BLE_RS485)
// 2. 连接设备
const adapter = adapterManager.activeAdapter
await adapter.open()
await adapter.connect(deviceId)
// 3. 配置串口参数
const config = SerialConfig.fromStore()
await adapterManager.applyConfigFromStore()
// 4. 创建串口通信实例
const comm = new SerialComm()
comm.init(adapter)
comm.onData((event) => {
console.log('收到数据:', event.hex, '长度:', event.length)
})
// 5. 发送数据
await comm.send(yourData)
// 6. 断开连接
await comm.destroy()
await adapter.disconnect()
核心模块
适配器层
| 模块 |
说明 |
BaseConnectionAdapter |
适配器基类,定义统一接口 |
ebBleAdapter |
数熵EB N1-RS485 BLE 适配器 |
edBleAdapter |
数熵ED Slink 适配器(支持配网) |
ecUsbAdapter |
数熵EC N1-RS485 USB 适配器 |
adapterManager |
适配器管理器(单例) |
ADAPTER_CAPABILITIES |
适配器能力标志位 |
ADAPTER_CTRL |
控制命令常量 |
ADAPTER_ERRORS |
错误码常量 |
BLE 核心服务
| 模块 |
说明 |
BLEAdapter |
BLE 适配器(跨平台) |
bluetoothService |
BLE 服务单例 |
ConnectionManager |
BLE 连接管理 |
platform / isHarmonyApp / isAndroid |
平台检测 |
通信层
| 模块 |
说明 |
SerialComm |
统一串口通信(轮询/超时/健康检查) |
SerialConfig |
串口参数配置 |
GattOperationQueue |
BLE GATT 操作串行化队列 |
EVENTS |
事件总线常量 |
parseProvisioningStatus |
WiFi 配网状态解析 |
协议栈
| 模块 |
说明 |
buildReadHoldingRegistersFrame |
构建 Modbus RTU 读帧 |
parseModbusResponse |
解析 Modbus RTU 响应 |
buildWriteSingleRegisterFrame |
构建 Modbus RTU 写帧 |
decodeGbk |
GBK 编码解码(DL645) |
calculateCRC |
CRC16 校验 |
ESP32 TCP 工具
| 模块 |
说明 |
getAllTcpConfig |
获取全部 TCP 配置 |
setEthStatic |
设置以太网静态 IP |
setTcpTarget |
设置 TCP 目标地址 |
ensureSameSegment |
自动纠正同网段 |
连接类型
import { CONNECTION_TYPES } from '@/uni_modules/srh-edatahub-link'
// 可用类型:
CONNECTION_TYPES.EB_BLE_RS485 // 数熵EB - RS485串口蓝牙调试器 BLE协议
CONNECTION_TYPES.EC_USB_RS485 // 数熵EC - RS485Type-C串口调试器 USB-C接口
CONNECTION_TYPES.ED_BLE_RS485 // 数熵ED - 多功能调试器基于ESP32 BLE协议的RS485接口功能
CONNECTION_TYPES.ED_TCP_RS485 // 数熵ED - 多功能调试器基于 TCP/IP协议
WiFi 配网
import { edBleAdapter, ADAPTER_CTRL } from '@/uni_modules/srh-edatahub-link'
// 配网命令
await edBleAdapter.control(ADAPTER_CTRL.SET_WIFI_PROV, {
ssid: 'MyWiFi',
password: '12345678'
})
健康检查与保活
SDK 内置自动健康检查机制:
- BLE: 10 秒无数据自动重订阅 notify
- USB: 读线程存活检测,断线自动通知
- TCP: WebSocket 心跳保活
技术支持
-
- 公司: 武汉数熵科技有限公司
- 产品: edatahub 数据中台
许可证
本插件为付费插件,购买后绑定 appid 和包名。详见 DCloud 插件市场购买协议。