更新记录

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 插件市场购买协议。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

BLUETOOTH ACCESS_FINE_LOCATION ACCESS_COARSE_LOCATION ACCESS_WIFI_STATE CHANGE_WIFI_STATE USB_PERMISSION

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

仅设备连接数据,不上传服务器

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。