ESP32蓝牙无法连接iOS求助（现有代码仅支持Android）

核心问题原因 #

iOS的BLE连接机制比Android更严格，官方示例的默认配置存在以下不符合iOS规范的点：

• 未明确广播UART服务UUID，iOS无法识别设备提供的服务类型
• 特征属性权限不全，缺少iOS要求的读写标识
• 广告数据未搭配扫描响应补充信息，导致iOS无法完整获取设备元数据
• 广告间隔不在iOS偏好的范围内

具体修复步骤及代码修改 #

1. 添加必要的常量定义 #

在原有常量区补充以下内容：

_FLAG_WRITE_NO_RESPONSE = const(0x0004)
_FLAG_READ = const(0x0002)

2. 修改UART特征的属性配置 #

更新_UART_TX和_UART_RX的属性，确保符合iOS要求：

_UART_TX = (
    bluetooth.UUID("6E400003-B5A3-F393-E0A9-E50E24DCCA9E"),
    _FLAG_NOTIFY | _FLAG_READ,  # 增加_READ属性
)
_UART_RX = (
    bluetooth.UUID("6E400002-B5A3-F393-E0A9-E50E24DCCA9E"),
    _FLAG_WRITE | _FLAG_WRITE_NO_RESPONSE | _FLAG_READ,  # 补充_WRITE_NO_RESPONSE和_READ
)

3. 生成扫描响应数据，补充服务UUID广播 #

在BLEUART类的__init__方法中，添加扫描响应数据的生成，并在广告时同时发送：

# 主广告数据（保留原有配置）
self._payload = advertising_payload(name=name, appearance=_ADV_APPEARANCE_GENERIC_COMPUTER)
# 扫描响应数据，用于广播UART服务UUID
self._scan_response = advertising_payload(services=[_UART_UUID])

4. 修改广告方法，同时发送主广告和扫描响应 #

更新_advertise方法：

def _advertise(self, interval_us=150000):  # 调整广告间隔到iOS偏好范围
    # adv_data为主广告，scan_response为扫描响应数据
    self._ble.gap_advertise(interval_us, adv_data=self._payload, resp_data=self._scan_response)

5. 添加MTU设置（可选但建议） #

在__init__方法中，初始化BLE后设置MTU：

self._ble.active(True)
self._ble.config(mtu=256)  # 设置MTU为256，提升传输兼容性

修改后的完整代码 #

import bluetooth
from ble_advertising import advertising_payload

from micropython import const

_IRQ_CENTRAL_CONNECT = const(1)
_IRQ_CENTRAL_DISCONNECT = const(2)
_IRQ_GATTS_WRITE = const(3)

_FLAG_WRITE = const(0x0008)
_FLAG_NOTIFY = const(0x0010)
_FLAG_WRITE_NO_RESPONSE = const(0x0004)
_FLAG_READ = const(0x0002)

_UART_UUID = bluetooth.UUID("6E400001-B5A3-F393-E0A9-E50E24DCCA9E")
_UART_TX = (
    bluetooth.UUID("6E400003-B5A3-F393-E0A9-E50E24DCCA9E"),
    _FLAG_NOTIFY | _FLAG_READ,
)
_UART_RX = (
    bluetooth.UUID("6E400002-B5A3-F393-E0A9-E50E24DCCA9E"),
    _FLAG_WRITE | _FLAG_WRITE_NO_RESPONSE | _FLAG_READ,
)
_UART_SERVICE = (
    _UART_UUID,
    (_UART_TX, _UART_RX),
)

# org.bluetooth.characteristic.gap.appearance.xml
_ADV_APPEARANCE_GENERIC_COMPUTER = const(128)


class BLEUART:
    def __init__(self, ble, name="mpy-uart", rxbuf=100):
        self._ble = ble
        self._ble.active(True)
        self._ble.config(mtu=256)  # 设置MTU
        self._ble.irq(self._irq)
        ((self._tx_handle, self._rx_handle),) = self._ble.gatts_register_services((_UART_SERVICE,))
        # Increase the size of the rx buffer and enable append mode.
        self._ble.gatts_set_buffer(self._rx_handle, rxbuf, True)
        self._connections = set()
        self._rx_buffer = bytearray()
        self._handler = None
        # 主广告数据和扫描响应数据分开
        self._payload = advertising_payload(name=name, appearance=_ADV_APPEARANCE_GENERIC_COMPUTER)
        self._scan_response = advertising_payload(services=[_UART_UUID])
        self._advertise()

    def irq(self, handler):
        self._handler = handler

    def _irq(self, event, data):
        # Track connections so we can send notifications.
        if event == _IRQ_CENTRAL_CONNECT:
            conn_handle, _, _ = data
            self._connections.add(conn_handle)
        elif event == _IRQ_CENTRAL_DISCONNECT:
            conn_handle, _, _ = data
            if conn_handle in self._connections:
                self._connections.remove(conn_handle)
            # Start advertising again to allow a new connection.
            self._advertise()
        elif event == _IRQ_GATTS_WRITE:
            conn_handle, value_handle = data
            if conn_handle in self._connections and value_handle == self._rx_handle:
                self._rx_buffer += self._ble.gatts_read(self._rx_handle)
                if self._handler:
                    self._handler()

    def any(self):
        return len(self._rx_buffer)

    def read(self, sz=None):
        if not sz:
            sz = len(self._rx_buffer)
        result = self._rx_buffer[0:sz]
        self._rx_buffer = self._rx_buffer[sz:]
        return result

    def write(self, data):
        for conn_handle in self._connections:
            self._ble.gatts_notify(conn_handle, self._tx_handle, data)

    def close(self):
        for conn_handle in self._connections:
            self._ble.gap_disconnect(conn_handle)
        self._connections.clear()

    def _advertise(self, interval_us=150000):
        self._ble.gap_advertise(interval_us, adv_data=self._payload, resp_data=self._scan_response)


def demo():
    import time

    ble = bluetooth.BLE()
    uart = BLEUART(ble)

    def on_rx():
        print("rx: ", uart.read().decode().strip())

    uart.irq(handler=on_rx)
    nums = [4, 8, 15, 16, 23, 42]
    i = 0

    try:
        while True:
            uart.write(str(nums[i]) + "\n")
            i = (i + 1) % len(nums)
            time.sleep_ms(1000)
    except KeyboardInterrupt:
        pass

    uart.close()


if __name__ == "__main__":
    demo()

验证说明 #

修改后，iOS设备可以通过系统蓝牙设置或者BLE调试工具搜索到设备并建立连接，同时保持对Android设备的兼容性。

内容的提问来源于stack exchange，提问作者TaHaRock