DBS 程控仪蓝牙 SDK 接口清单

1. 文档说明

本文档基于 ~/StudioProjects/dbs_gp02_control 项目源码整理，面向第三方对接方。

蓝牙相关接口分两层：

主要源码：

2. 核心数据类型

2.1 DeviceInfo

2.2 ReqData

3. 底层蓝牙 SDK：Ble

3.1 属性

3.2 接口总表

3.3 接口明细

init(context: Application, buId: Byte = 0x02, sendId: Byte = 0x03, connectOverTime: Long = 60000, operateTimeout: Int = 10000): Unit

接口说明：初始化 BLE 框架、注册配对广播、配置超时参数。

入参说明：

出参说明：

startSan(cedScanCallback: CedScanCallback, maxTime: Long = 30000): Unit

接口说明：开始扫描 BLE 设备。

入参说明：

出参说明：

stopScanNow(): Unit

接口说明：立即停止扫描。

入参说明：

出参说明：

bleConnect(mac: String? = null, bleDevice: BleDevice? = null): BleDevice?

接口说明：连接设备，成功时返回连接成功的 BleDevice。

入参说明：

出参说明：

disconnectBle(device: BleDevice): Unit

接口说明：断开指定设备连接。

入参说明：

出参说明：

disconnectedAll(): Unit

接口说明：断开所有已连接设备。

入参说明：

出参说明：

setBleStatus(callback: BleStatusCallback): Unit

接口说明：监听系统蓝牙开关状态变化。

入参说明：

出参说明：

startBond(bleDevice: BleDevice): Boolean

接口说明：发起设备配对。

入参说明：

出参说明：

setUUIDs(bleDevice: BleDevice): List<UUIDTAG>

接口说明：发现并设置通信 UUID。

入参说明：

出参说明：

printServiceData(bleDevice: BleDevice): Unit

接口说明：打印设备的 GATT 服务和特征信息。

入参说明：

出参说明：

requestCommonLock(reqData: ReqData, maxTime: Long = 10000, delayTime: Long = 200, errorMsg: ErrorMsg): ByteBuffer?

接口说明：带互斥锁的通用请求发送接口。

入参说明：

出参说明：

requestCommon(reqData: ReqData, maxTime: Long = 10000, delayTime: Long = 200, errorMsg: ErrorMsg): ByteBuffer?

接口说明：不带互斥锁的通用请求发送接口。

入参说明：

出参说明：

registerAndAuth(mac: DeviceInfo, showMsg: (String) -> Unit): Boolean

接口说明：执行注册与鉴权流程。

入参说明：

出参说明：

logSign(desMac: DeviceInfo): Array<Long>?

接口说明：读取日志起止标记。

入参说明：

出参说明：

readLog(localStart: Long, maxLen: Int, desMac: DeviceInfo): MutableList<String>?

接口说明：读取设备日志内容。

入参说明：

出参说明：

stopReadLog(desMac: DeviceInfo): Unit

接口说明：停止读取日志。

入参说明：

出参说明：

readWave(desMac: DeviceInfo, timeout: Long, callBack: (String) -> Unit): Unit

接口说明：读取波形数据。

入参说明：

出参说明：

readCheckImu(desMac: DeviceInfo, callBack: (String) -> Unit): Unit

接口说明：读取 IMU 检测数据。

入参说明：

出参说明：

stopCheckImu(desMac: DeviceInfo): Boolean

接口说明：停止 IMU 检测。

入参说明：

出参说明：

released(): Unit

接口说明：释放 BLE 管理器资源。

入参说明：

出参说明：

blePermission(): Boolean

接口说明：申请或检查 BLE 所需权限。

入参说明：

出参说明：

4. 业务协议层：BleApi

4.1 属性

4.2 接口总表

4.3 接口明细

ipgRequest(reqData: ReqData, maxTime: Long = 10000, errorMsg: (String) -> Unit): ByteBuffer?

接口说明：业务侧统一请求发送入口。

入参说明：

出参说明：

activation(): ByteBuffer?

接口说明：发送激活命令。

入参说明：

出参说明：

readWorkStatus(): WorkInfo?

接口说明：读取设备工作状态，并同步更新 workInfo 缓存。

入参说明：

出参说明：

writeHwVersion(data: ByteArray): ByteBuffer?

接口说明：写入设备硬件版本号。

入参说明：

出参说明：

writeHwSn(data: ByteArray): ByteBuffer?

接口说明：写入设备硬件编号。

入参说明：

出参说明：

readSwVersion(desMac: DeviceInfo = Ble.currentBleDevice): DoctorDeviceInfo?

接口说明：读取软件版本信息。

入参说明：

出参说明：

writeSwVersion(data: ByteArray): ByteBuffer?

接口说明：写入软件版本号。

入参说明：

出参说明：

writeModel(data: ByteArray): ByteBuffer?

接口说明：写入产品型号。

入参说明：

出参说明：

writeSn(data: ByteArray): ByteBuffer?

接口说明：写入产品序列号。

入参说明：

出参说明：

readDeviceAll(desMac: DeviceInfo = Ble.currentBleDevice): BleDeviceInfo?

接口说明：读取全部设备基础信息，并更新 bleDeviceInfo 缓存。

入参说明：

出参说明：

writeElectrodeModel(data: ByteArray): ByteBuffer?

接口说明：写入电极型号。

入参说明：

出参说明：

writeElectrodePos(data: ByteArray): ByteBuffer?

接口说明：写入电极植入位置。

入参说明：

出参说明：

writeImplantPos(data: ByteArray): ByteBuffer?

接口说明：写入植入部位信息。

入参说明：

出参说明：

writeProdDate(data: ByteArray): ByteBuffer?

接口说明：写入生产日期。

入参说明：

出参说明：

writeImplantDate(data: ByteArray): ByteBuffer?

接口说明：写入植入日期。

入参说明：

出参说明：

writeValidDate(data: ByteArray): ByteBuffer?

接口说明：写入有效日期。

入参说明：

出参说明：

readElectrodeAll(desMac: DeviceInfo = Ble.currentBleDevice): ElectrodeInfo?

接口说明：读取全部电极信息，并更新 electrodeInfo 缓存。

入参说明：

出参说明：

writeBattVendor(data: ByteArray): ByteBuffer?

接口说明：写入电池厂商信息。

入参说明：

出参说明：

writeBattBatch(data: ByteArray): ByteBuffer?

接口说明：写入电池批号。

入参说明：

出参说明：

writeBattInstall(data: ByteArray): ByteBuffer?

接口说明：写入电池装机日期。

入参说明：

出参说明：

writeBattValid(data: ByteArray): ByteBuffer?

接口说明：写入电池有效期。

入参说明：

出参说明：

readBatteryAll(desMac: DeviceInfo = Ble.currentBleDevice): BatteryInfo?

接口说明：读取全部电池信息，并更新 batteryInfo 缓存。

入参说明：

出参说明：

writeHospital(data: ByteArray): ByteBuffer?

接口说明：写入医院名称。

入参说明：

出参说明：

writeDoctorName(data: ByteArray): ByteBuffer?

接口说明：写入医生姓名。

入参说明：

出参说明：

writePatientName(data: ByteArray): ByteBuffer?

接口说明：写入患者姓名。

入参说明：

出参说明：

writeDoctorContact(data: ByteArray): ByteBuffer?

接口说明：写入医生联系方式。

入参说明：

出参说明：

writeDiagnosis(data: ByteArray): ByteBuffer?

接口说明：写入诊断信息。

入参说明：

出参说明：

writePatientGender(data: ByteArray): ByteBuffer?

接口说明：写入患者性别。

入参说明：

出参说明：

writePatientBirth(data: ByteArray): ByteBuffer?

接口说明：写入患者出生日期。

入参说明：

出参说明：

writePatientSymptoms(data: ByteArray): ByteBuffer?

接口说明：写入患者症状或病症信息。

入参说明：

出参说明：

readPatientAll(desMac: DeviceInfo = Ble.currentBleDevice): PatientInfo?

接口说明：读取全部患者/临床信息，并更新 patientInfo 缓存。

入参说明：

出参说明：

syncRtc(data: ByteArray, desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：同步 RTC 时间。

入参说明：

出参说明：

readRtc(desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：读取 RTC 时间原始字节数据。

入参说明：

出参说明：

stopStim(stopType: Byte = 0x01, desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：停止刺激。

入参说明：

出参说明：

startGroupStim(data: ByteArray, desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：启动 Group 刺激。

入参说明：

出参说明：

resetMcu(desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：复位 MCU。

入参说明：

出参说明：

disconnectAll(desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：断开所有主机连接。

入参说明：

出参说明：

writeGroupParam(data: ByteArray, desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：写入 Group 参数。

入参说明：

出参说明：

readGroup(byteArray: ByteArray, desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：读取单个 Group 参数。

入参说明：

出参说明：

readAllGroup(byteArray: ByteArray, desMac: DeviceInfo = Ble.currentBleDevice): ByteBuffer?

接口说明：读取全部 Group 参数。

入参说明：

出参说明：

fullImpedanceMeasurement(data: ByteArray, desMac: DeviceInfo = Ble.currentBleDevice): MutableList<Int>?

接口说明：执行全阻抗测量。

入参说明：

出参说明：

therapyImpedanceMeasurement(data: ByteArray, desMac: DeviceInfo = Ble.currentBleDevice): MutableList<Float>?

接口说明：执行治疗阻抗测量。

入参说明：

出参说明：

readTimeInterval(desMac: DeviceInfo? = null): List<TimeIntervalInfo>?

接口说明：读取时段刺激配置列表。

入参说明：

出参说明：

writeTimeInterval(intervals: List<TimeIntervalInfo>, desMac: DeviceInfo? = null): Boolean

接口说明：写入时段刺激配置。

入参说明：

出参说明：

5. 主要返回模型字段说明

5.1 DoctorDeviceInfo

5.2 BleDeviceInfo

5.3 ElectrodeInfo

5.4 BatteryInfo

5.5 PatientInfo

5.6 WorkInfo

5.7 TimeIntervalInfo

6. 对接注意事项