Swift应用与Raspberry Pi Pico W的BLE通信故障排查求助

问题根源分析 #

从你的描述和广告数据可以确定两个核心问题：

1. Pico W的广播未包含服务UUID：导致iOS端通过scanForPeripherals(withServices: [picServiceUUID])无法匹配到设备，只能无过滤扫描发现
2. 服务/特征权限配置错误：连接后无法发送数据，大概率是Pico W的BLE特征未开启写入权限，或iOS端未正确完成服务/特征发现流程

一、修复Pico W的广播配置（让iOS能按指定UUID扫描到） #

在MicroPython代码中，必须将服务UUID加入广播数据，才能被iOS的指定服务扫描匹配到。以下是修改示例：

from ble import BLE
import bluetooth

# 替换为你和iOS端一致的服务UUID（16位或128位均可）
PIC_SERVICE_UUID = bluetooth.UUID("12345678-1234-5678-1234-56789abcdef0")

ble = BLE()
ble.active(True)

# 构建包含服务UUID的广播数据
adv_data = bytearray()
# 标记设备为可连接
adv_data += b'\x02\x01\x06'

# 加入服务UUID（根据UUID类型选择对应格式）
# 16位UUID示例：长度0x03 + 类型0x03（完整16位服务UUID列表）+ UUID字节
# adv_data += b'\x03\x03\xe0\xff'

# 128位UUID示例：长度0x11 + 类型0x07（完整128位服务UUID列表）+ UUID二进制数据
adv_data += b'\x11\x07' + PIC_SERVICE_UUID.bin

# 添加设备名称
adv_data += b'\x0b\x09RaspberryPico'

# 启动广播
ble.gap_advertise(100_000, adv_data=adv_data)

二、修复数据发送问题（配置正确的服务与特征权限） #

连接后无法发送数据，核心是确保Pico W的BLE特征开启写入权限，同时iOS端完成完整的服务发现流程。

1. 修改Pico W的服务/特征配置 #

确保特征添加bluetooth.FLAG_WRITE权限，示例：

# 替换为你和iOS端一致的特征UUID
PIC_CHAR_UUID = bluetooth.UUID("87654321-1234-5678-1234-56789abcdef0")

# 创建服务：包含一个可写入的特征
service = (
    PIC_SERVICE_UUID,
    (
        PIC_CHAR_UUID,
        bluetooth.FLAG_WRITE | bluetooth.FLAG_NOTIFY,  # 必须包含FLAG_WRITE
    ),
)
ble.gap_service( (service,) )

2. iOS端Swift代码检查点 #

确保连接后完成服务发现→特征发现的完整流程，再执行写入：

var targetCharacteristic: CBCharacteristic?

func centralManager(_ central: CBCentralManager, didConnect peripheral: CBPeripheral) {
    peripheral.delegate = self
    // 发现指定服务
    peripheral.discoverServices([picServiceUUID])
}

func peripheral(_ peripheral: CBPeripheral, didDiscoverServices error: Error?) {
    guard let services = peripheral.services else { return }
    for service in services where service.uuid == picServiceUUID {
        // 发现目标特征
        peripheral.discoverCharacteristics([picCharUUID], for: service)
    }
}

func peripheral(_ peripheral: CBPeripheral, didDiscoverCharacteristicsFor service: CBService, error: Error?) {
    guard let characteristics = service.characteristics else { return }
    for char in characteristics where char.uuid == picCharUUID {
        targetCharacteristic = char
        // 测试写入数据
        let testData = "Hello Pico".data(using: .utf8)!
        peripheral.writeValue(testData, for: char, type: .withResponse)
    }
}

// 监听写入结果
func peripheral(_ peripheral: CBPeripheral, didWriteValueFor characteristic: CBCharacteristic, error: Error?) {
    if let error = error {
        print("写入失败：\(error.localizedDescription)")
    } else {
        print("写入成功")
    }
}

验证步骤 #

1. 重新上传修改后的MicroPython代码到Pico W，重启设备
2. iOS端用scanForPeripherals(withServices: [picServiceUUID])扫描，确认能直接发现设备
3. 连接后检查服务、特征发现回调是否正常触发
4. 写入数据时查看didWriteValueFor回调的结果，根据错误信息调整

内容的提问来源于stack exchange，提问作者E. Tocchi