更新记录

1.0.0（2026-04-24） 下载此版本

phy-ble-ota

PHY BLE OTA 固件升级SDK — 基于 uni-app BLE API 实现，支持 SLB (PHY6222) 和 SBK/SBH 两种蓝牙设备的 OTA 无线固件升级。

功能特点

• 支持 BLE 设备扫描、连接、断开
• 支持 SLB 设备（PHY6222 芯片）OTA 固件升级（.bin 文件）
• 支持 SBK/SBH 设备 OTA 固件升级（.hex / .hex16 文件）
• 自动识别设备类型和服务特性
• 支持多设备批量升级
• 支持 App 模式 → OTA 模式自动切换（SBK设备）
• 支持固件版本校验
• 完整的升级进度回调
• 兼容 Android 和 iOS 平台

适用平台

安装

方式一：DCloud 插件市场（推荐）

1. 在 DCloud 插件市场搜索 phy-ble-ota
2. 点击"使用插件"导入到你的 uni-app 项目
3. 或直接在项目中 npm install（如果已发布到 npm）

方式二：手动安装

将 uni_modules/phy-ble-ota 目录复制到你的 uni-app 项目根目录。

快速开始

1. 导入 SDK

import {
  handleSearchDevice,
  handleStopScanBleDevices,
  handleListenOTACallBack,
  selectOTAFile,
  selectOTADevice,
  otaDeviceList,
} from '@/uni_modules/phy-ble-ota/js_sdk'

2. 初始化并注册回调

onLoad() {
  // 注册OTA事件回调
  handleListenOTACallBack((errCode, errMsg, deviceID) => {
    console.log(`[${deviceID}] ${errCode}: ${errMsg}`)
    // 处理进度更新、错误、成功等事件
    switch (errCode) {
      case 11027: // 进度更新
        const progress = errMsg.match(/进度条：(\d+\.?\d*)%/)
        if (progress) {
          this.upgradeProgress = parseFloat(progress[1])
        }
        break
      case 11032: // 升级完成
        console.log('升级成功!')
        break
      case 10001: // 错误
      case 11030:
        console.error('升级错误:', errMsg)
        break
    }
  })
}

3. 扫描设备

// 开始扫描
handleSearchDevice(
  true,           // repeat - 是否重复上报
  this.isAndroid, // 是否Android平台
  (devices) => {  // 发现设备回调
    devices.forEach(device => {
      if (device.name && device.deviceId) {
        console.log('发现设备:', device.name, device.deviceId)
      }
    })
  },
  () => {         // 扫描启动成功回调
    console.log('扫描已启动')
  }
)

// 停止扫描
handleStopScanBleDevices(() => {
  console.log('扫描已停止')
})

4. 选择固件文件

// 从本地读取文件后传入
uni.readFile({
  filePath: '/static/firmware.bin',
  success: (res) => {
    selectOTAFile(
      'firmware.bin',     // 文件名（根据后缀自动识别设备类型）
      this.isAndroid,     // 是否Android
      res.data            // 文件内容
    )
  }
})

5. 选择设备并开始升级

// 添加到升级列表
const deviceInfo = {
  name: device.localName || device.name,
  deviceId: device.deviceId,
  mac: device.deviceId,
  disconnectTimes: 0,
  OTAType: 0,
  famewareCheck: false
}
otaDeviceList.push(deviceInfo)

// 开始升级
selectOTADevice(otaDeviceList)

API 参考

蓝牙扫描与连接

固件升级

SLB 设备专用

SBK/SBH 设备专用

工具函数

UUID 常量

回调事件码

支持的设备

SLB 设备 (PHY6222)

• 固件格式: .bin
• 蓝牙服务: FEB3
• 特征值: FED5(写), FED7(写无响应), FED8(通知)

SBK/SBH 设备

• 固件格式: .hex / .hex16
• 蓝牙服务: 5833FF01
• 特征值: FF02(写), FF03(通知), FF04(写无响应)
• 支持 App → OTA 模式自动切换

项目结构

uni_modules/phy-ble-ota/
├── package.json          # 插件清单
├── readme.md             # 本文档
└── js_sdk/
    ├── index.js          # 统一入口，重新导出所有公开API
    ├── blemanager.js     # BLE管理器 - 设备扫描/连接/服务发现
    ├── bleuniapi.js      # uni-app BLE API 底层封装
    ├── sbk_ota.js        # SBK/SBH 设备 OTA 协议实现
    ├── slb_ota.js        # SLB 设备 OTA 协议实现
    └── util.js           # 工具函数（CRC、Hex转换等）

开发指南

导入方式

// 方式1：从入口文件导入（推荐）
import { handleSearchDevice, selectOTAFile } from '@/uni_modules/phy-ble-ota/js_sdk'

// 方式2：按需导入具体模块
import { handleWriteAction } from '@/uni_modules/phy-ble-ota/js_sdk/bleuniapi.js'

完整升级流程

1. 初始化 → 注册 handleListenOTACallBack 监听升级事件
2. 选择文件 → selectOTAFile(fileName, isAndroid, fileData)
3. 扫描设备 → handleSearchDevice(true, isAndroid, onDeviceFound, onScanStart)
4. 选择设备 → 创建 deviceInfo 对象，添加到 otaDeviceList
5. 开始升级 → selectOTADevice(otaDeviceList) — 自动连接并开始升级
6. 监控进度 → 通过回调中的事件码 11027 获取进度百分比
7. 升级完成 → 收到事件码 11032 表示升级成功

许可证

MIT

平台兼容性

phy-ble-ota

PHY BLE OTA 固件升级SDK — 基于 uni-app BLE API 实现，支持 SLB (PHY6222) 和 SBK/SBH 两种蓝牙设备的 OTA 无线固件升级。

功能特点

• 支持 BLE 设备扫描、连接、断开
• 支持 SLB 设备（PHY6222 芯片）OTA 固件升级（.bin 文件）
• 支持 SBK/SBH 设备 OTA 固件升级（.hex / .hex16 文件）
• 自动识别设备类型和服务特性
• 支持多设备批量升级
• 支持 App 模式 → OTA 模式自动切换（SBK设备）
• 支持固件版本校验
• 完整的升级进度回调
• 兼容 Android 和 iOS 平台

适用平台

安装

方式一：DCloud 插件市场（推荐）

1. 在 DCloud 插件市场搜索 phy-ble-ota
2. 点击"使用插件"导入到你的 uni-app 项目
3. 或直接在项目中 npm install（如果已发布到 npm）

方式二：手动安装

将 uni_modules/phy-ble-ota 目录复制到你的 uni-app 项目根目录。

快速开始

1. 导入 SDK

import {
  handleSearchDevice,
  handleStopScanBleDevices,
  handleListenOTACallBack,
  selectOTAFile,
  selectOTADevice,
  otaDeviceList,
} from '@/uni_modules/phy-ble-ota/js_sdk'

2. 初始化并注册回调

onLoad() {
  // 注册OTA事件回调
  handleListenOTACallBack((errCode, errMsg, deviceID) => {
    console.log(`[${deviceID}] ${errCode}: ${errMsg}`)
    // 处理进度更新、错误、成功等事件
    switch (errCode) {
      case 11027: // 进度更新
        const progress = errMsg.match(/进度条：(\d+\.?\d*)%/)
        if (progress) {
          this.upgradeProgress = parseFloat(progress[1])
        }
        break
      case 11032: // 升级完成
        console.log('升级成功!')
        break
      case 10001: // 错误
      case 11030:
        console.error('升级错误:', errMsg)
        break
    }
  })
}

3. 扫描设备

// 开始扫描
handleSearchDevice(
  true,           // repeat - 是否重复上报
  this.isAndroid, // 是否Android平台
  (devices) => {  // 发现设备回调
    devices.forEach(device => {
      if (device.name && device.deviceId) {
        console.log('发现设备:', device.name, device.deviceId)
      }
    })
  },
  () => {         // 扫描启动成功回调
    console.log('扫描已启动')
  }
)

// 停止扫描
handleStopScanBleDevices(() => {
  console.log('扫描已停止')
})

4. 选择固件文件

// 从本地读取文件后传入
uni.readFile({
  filePath: '/static/firmware.bin',
  success: (res) => {
    selectOTAFile(
      'firmware.bin',     // 文件名（根据后缀自动识别设备类型）
      this.isAndroid,     // 是否Android
      res.data            // 文件内容
    )
  }
})

5. 选择设备并开始升级

// 添加到升级列表
const deviceInfo = {
  name: device.localName || device.name,
  deviceId: device.deviceId,
  mac: device.deviceId,
  disconnectTimes: 0,
  OTAType: 0,
  famewareCheck: false
}
otaDeviceList.push(deviceInfo)

// 开始升级
selectOTADevice(otaDeviceList)

API 参考

蓝牙扫描与连接

固件升级

SLB 设备专用

SBK/SBH 设备专用

工具函数

UUID 常量

回调事件码

支持的设备

SLB 设备 (PHY6222)

• 固件格式: .bin
• 蓝牙服务: FEB3
• 特征值: FED5(写), FED7(写无响应), FED8(通知)

SBK/SBH 设备

• 固件格式: .hex / .hex16
• 蓝牙服务: 5833FF01
• 特征值: FF02(写), FF03(通知), FF04(写无响应)
• 支持 App → OTA 模式自动切换

项目结构

uni_modules/phy-ble-ota/
├── package.json          # 插件清单
├── readme.md             # 本文档
└── js_sdk/
    ├── index.js          # 统一入口，重新导出所有公开API
    ├── blemanager.js     # BLE管理器 - 设备扫描/连接/服务发现
    ├── bleuniapi.js      # uni-app BLE API 底层封装
    ├── sbk_ota.js        # SBK/SBH 设备 OTA 协议实现
    ├── slb_ota.js        # SLB 设备 OTA 协议实现
    └── util.js           # 工具函数（CRC、Hex转换等）

开发指南

导入方式

// 方式1：从入口文件导入（推荐）
import { handleSearchDevice, selectOTAFile } from '@/uni_modules/phy-ble-ota/js_sdk'

// 方式2：按需导入具体模块
import { handleWriteAction } from '@/uni_modules/phy-ble-ota/js_sdk/bleuniapi.js'

完整升级流程

1. 初始化 → 注册 handleListenOTACallBack 监听升级事件
2. 选择文件 → selectOTAFile(fileName, isAndroid, fileData)
3. 扫描设备 → handleSearchDevice(true, isAndroid, onDeviceFound, onScanStart)
4. 选择设备 → 创建 deviceInfo 对象，添加到 otaDeviceList
5. 开始升级 → selectOTADevice(otaDeviceList) — 自动连接并开始升级
6. 监控进度 → 通过回调中的事件码 11027 获取进度百分比
7. 升级完成 → 收到事件码 11032 表示升级成功

许可证

MIT