You need to enable JavaScript to run this app. Python开发如何解码蓝牙低功耗Polar OH1的服务特征值原始字节数据
优惠活动
大模型
产品
解决方案
定价
更多

Python开发如何解码蓝牙低功耗Polar OH1的服务特征值原始字节数据

核心认知纠正

这串原始字节根本不是文本编码格式,你用UTF系所有编码尝试解码注定失败——它是传感器直接输出的二进制采样流,全程和字符编码没有任何关系。

你之前拿到的示例字节流首字节为\r(即0x0d),对照PMD报文的类型规则,这根本不是PPG采样数据,是其他类型的状态/测量块——因为没有给控制特征下发PPG启动指令,传感器默认推送了非目标类型的报文,这也是你解码全程失败的关键触发原因。


实操解决步骤(适配Ubuntu Python3 环境)

1. 先确认连接的目标特征是否正确

很多人连错了特征值,拿到的根本不是PPG采样流,自然解不出来:

  • Ubuntu下最稳定的Python BLE开发库是bleak,提前安装:pip install bleak,不要依赖老旧的pybluez,对BLE GATT特征的适配极差
  • Polar OH1的PPG数据根本不在通用的心率服务里,是走自定义的PMD(Polar测量数据)私有服务,UUID为6217ff4b-f623-445a-b30a-dfbc987bdefc
  • 该服务下两个核心特征:
    • 控制特征6217ff51-f623-445a-b30a-dfbc987bdefc:需要往这个特征写固定指令,才会启动PPG采样,不写指令默认拿到的是状态报文,不是有效采样值
    • 数据通知特征6217ff52-f623-445a-b30a-dfbc987bdefc:所有PPG采样的字节流都会通过这个特征推送给主机

2. 固定的字节流解码规则(无文档实测验证)

Polar PMD服务的所有报文都有统一的结构,和编码无关:

  1. 报文固定头占6个字节:
    • 偏移0:数据类型标识,PPG类数据固定为0x01,如果首字节不是这个值,说明你拿到的是加速度、R-R间隔等其他类型的传感器数据,不是PPG
    • 偏移1-4:小端序32位无符号整数,代表当前报文的采集时间戳
    • 偏移5:采样块序号,单字节
  2. 头部之后的所有采样值,都是小端序24位有符号整数——这是之前解码全错的核心原因:大家习惯用16位、32位整数切分字节,但OH1的PPG采样是3字节每值
    • OH1一共3个独立的PPG光通道,因此每一个实际采样点占9个字节(3通道 × 3字节/通道),所有PPG类报文字节长度一定能被9整除,可以用这个规则校验数据是否正确

3. 可直接运行的解码参考代码

import asyncio
from bleak import BleakClient, BleakScanner

# PMD服务固定UUID
PMD_CTRL_UUID = "6217ff51-f623-445a-b30a-dfbc987bdefc"
PMD_DATA_UUID = "6217ff52-f623-445a-b30a-dfbc987bdefc"
# 实测可触发OH1输出PPG的固定控制指令
START_PPG_CMD = bytes([0x02, 0x01, 0x00, 0x01, 0xb2, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00])

def decode_ppg_block(raw_data: bytearray):
    # 跳过6字节的报头
    offset = 6
    channel_vals = []
    while offset < len(raw_data):
        b0, b1, b2 = raw_data[offset], raw_data[offset+1], raw_data[offset+2]
        # 拼接为24位整数,处理有符号偏移
        raw_val = b0 | (b1 << 8) | (b2 << 16)
        if raw_val & 0x800000:
            raw_val -= 0x1000000
        channel_vals.append(raw_val)
        offset += 3
    # 按3个值一组拆分,对应每个采样点的3个光通道
    return [channel_vals[i:i+3] for i in range(0, len(channel_vals), 3)]

async def collect_oh1_ppg():
    # 自动扫描匹配OH1设备
    device = await BleakScanner.find_device_by_filter(
        lambda d, adv: d.name and "OH1" in d.name
    )
    async with BleakClient(device.address) as client:
        # 下发启动PPG采集的指令
        await client.write_gatt_char(PMD_CTRL_UUID, START_PPG_CMD)
        # 订阅数据流,拿到报文直接解码打印
        await client.start_notify(
            PMD_DATA_UUID,
            lambda char, payload: print(decode_ppg_block(payload))
        )
        # 持续采集30秒
        await asyncio.sleep(30)

if __name__ == "__main__":
    asyncio.run(collect_oh1_ppg())

常见踩坑提示
  • Ubuntu下运行bleak前,先把当前用户加入蓝牙用户组,避免权限报错:执行sudo usermod -aG bluetooth $USER,重启终端后生效
  • 所有PMD数据均为小端序,不要按大端序拼接字节,否则解出来的数值会完全错乱
  • 如果解出来的数值无波动,先核对控制特征写的指令是否正确,没启动采样的状态下,推过来的都是固定空值,不是真实PPG信号
  • 完全不要再在文本编码方向调试,这类传感器的原始采样流永远不会是文本格式

内容的提问来源于stack exchange,提问作者nepho5

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 11:54:07