## 1. 树莓派4蓝牙开发：从零开始的无线世界 如果你手头有一块树莓派4，却只把它当个迷你电脑用，那可真是有点“大材小用”了。它内置的蓝牙模块，就像是一个隐藏的无线超能力，能让你轻松连接耳机、手柄、传感器，甚至打造自己的智能家居中枢。我刚开始玩树莓派蓝牙的时候，也以为会很复杂，但实际用Python捣鼓下来，发现从扫描设备到传数据，整个过程比想象中顺畅得多。这篇文章，我就把自己踩过的坑、试出来的经验，用最“小白”的方式分享给你。不管你是想做个蓝牙遥控小车，还是想连接手机传点数据，跟着这篇实战指南，你都能快速上手，把树莓派4的蓝牙功能真正用起来。 ## 2. 环境准备：让你的树莓派“蓝牙就绪” 在开始写代码之前，我们得先把树莓派4的“硬件开关”和“软件工具”都准备好。这就像你要做饭，得先确认煤气灶能点火，锅碗瓢盆也得齐全。别小看这一步，很多新手卡住，问题都出在环境没配好。 ### 2.1 硬件与系统检查 首先，确保你的树莓派4已经正常启动并连接了网络。树莓派4的蓝牙模块是板载的，不需要额外购买USB适配器，这点非常方便。你可以通过一个简单的命令来确认蓝牙硬件是否被系统识别。打开终端，输入： ```bash hciconfig ``` 如果看到类似 `hci0` 的设备信息，并且状态是 `UP RUNNING`，那就恭喜你，硬件基础没问题。如果状态是 `DOWN`，别慌，输入 `sudo hciconfig hci0 up` 就能把它启动起来。 我遇到过一种情况，系统升级后蓝牙服务偶尔会抽风。这时候可以尝试重启蓝牙服务： ```bash sudo systemctl restart bluetooth ``` 还有一个更彻底的方法，如果上述命令无效，可以尝试卸载并重新加载蓝牙内核模块（这不会删除你的配置）： ```bash sudo rmmod btusb sudo modprobe btusb ``` ### 2.2 安装必备的Python库和工具 树莓派默认的Raspbian系统（现在叫Raspberry Pi OS）通常已经包含了蓝牙的基础服务（`bluetoothd`守护进程）。但我们用Python开发，还需要一个关键的库：`pybluez`。不过，直接 `pip install pybluez` 在树莓派上大概率会失败，因为编译它需要一些系统依赖。 最稳妥的方法是通过系统包管理器来安装。打开终端，依次执行以下命令： ```bash sudo apt update sudo apt upgrade -y sudo apt install python3-pip libbluetooth-dev sudo pip3 install pybluez ``` 这里解释一下：`libbluetooth-dev` 是 `pybluez` 编译时需要的开发头文件，必须先装好。安装完成后，你可以在Python环境中导入 `bluetooth` 模块试试：`python3 -c “import bluetooth; print(bluetooth.__version__)”`，如果没有报错，就说明安装成功了。 除了Python库，安装一些蓝牙调试工具也很有帮助，比如 `bluetoothctl`（一个交互式蓝牙管理工具）和 `hcitool`（底层工具）。它们能帮你手动扫描、配对设备，当代码出问题时，用这些工具排查非常高效。 ```bash sudo apt install bluez bluez-tools ``` 装好这些，你的树莓派4就已经是全副武装的蓝牙开发平台了。 ## 3. 核心第一步：扫描与发现周围的蓝牙设备 环境搭好了，我们就要开始“探索”周围的蓝牙世界了。扫描设备是蓝牙通信的起点，就像用对讲机前要先调到正确的频道，听听都有谁在说话。 ### 3.1 理解蓝牙设备发现机制 蓝牙设备为了能被发现，会定期广播自己的存在，广播包里包含了设备地址、名称、所能提供的服务等信息。我们的扫描，其实就是监听这些广播包。这里有个关键参数叫 **`duration`**，也就是扫描持续时间，单位是秒。设得太短，可能漏掉响应慢的设备；设得太长，又会让你等得心急。根据我的经验，在普通家庭或办公室环境，8到10秒是比较合适的，能覆盖到绝大多数设备。 扫描时，你可能会发现有些设备有名字（比如“Mi Band 4”），有些则显示一串地址（如“XX:XX:XX:XX:XX:XX”）。设备名是可选的，有些设备为了省电或隐私，会选择不广播名称。所以，在后续连接时，更可靠的标识是那个唯一的 **MAC地址**（也叫BD_ADDR）。 ### 3.2 编写你的第一个设备扫描脚本 让我们动手写一个增强版的扫描脚本。原始文章的例子有点太基础了，我们加点实用的功能，比如过滤特定类型的设备，或者显示信号强度（RSSI）。 ```python import bluetooth import time def discover_devices_with_details(duration=8): """ 扫描周围蓝牙设备，并获取详细信息。 :param duration: 扫描持续时间（秒） :return: 设备列表，每个元素是 (地址, 名称, 设备类, RSSI信号强度) 的元组 """ print(f“开始扫描，持续 {duration} 秒...“) # discover_devices 返回的是地址列表，要获取名字需要配合 lookup_names nearby_devices = bluetooth.discover_devices(duration=duration, lookup_names=True, flush_cache=True, lookup_class=True) device_list = [] for addr, name in nearby_devices: # 获取设备类（Device Class），这能告诉你它是手机、电脑还是音频设备等 device_class = bluetooth.lookup_class(addr) # 注意：简单的discover_devices不直接返回RSSI，需要更底层的方法，这里先留空 rssi = None # 实际获取RSSI需要调用hcitool等，稍复杂 device_list.append((addr, name, device_class, rssi)) print(f“扫描结束，共发现 {len(device_list)} 个设备。“) print(“-” * 40) for i, (addr, name, device_class, _) in enumerate(device_list): # 将设备类数字转换为可读的字符串（简单示例） class_str = hex(device_class) if device_class else “Unknown” print(f“{i+1}. 设备名: {name or ‘[未知]’}”) print(f“ 地址: {addr}”) print(f“ 设备类: {class_str}”) print(“-” * 40) return device_list if __name__ == “__main__“: # 执行扫描 devices = discover_devices_with_details(10) # 你可以在这里把扫描到的设备地址存下来，供后续连接使用 if devices: print(“\n提示：将你想连接的设备地址复制下来，用于下一步的连接。“) ``` 运行这个脚本，你就能看到一个清晰的设备列表。这里我用了 `flush_cache=True` 参数，它会清除之前的扫描缓存，确保每次获取的都是最新结果。**设备类**是一个三位十六进制数，它能粗略告诉你设备的类型（如手机、电脑、音频设备、电话等），这在过滤设备时很有用。 ## 4. 建立稳定可靠的蓝牙连接 扫描到目标设备后，下一步就是和它“握手”建立连接了。蓝牙连接有多种“协议”或“服务”，最常用的一种叫 **RFCOMM**，它模拟了串口通信，简单易用，非常适合传输数据流。我们连接蓝牙耳机用的A2DP、传输文件用的OBEX则复杂得多，需要专门的库。 ### 4.1 理解RFCOMM与端口号 你可以把RFCOMM想象成设备上虚拟出来的多个“串口插座”。每个插座都有一个编号，就是**端口号（Channel）**。不同的服务会“占用”不同的端口。很多经典蓝牙设备（如一些老式蓝牙模块、 Arduino HC-05）的串口服务默认就开在端口1上。所以原始文章里写 `port = 1` 是一个常见的尝试。 但这不是绝对的！更规范的做法是，先查询目标设备到底在哪个端口上提供了我们需要的服务。这需要用到 **服务发现（SDP）**。 ### 4.2 通过服务发现找到正确端口 让我们写一个更健壮的连接函数，它先查找服务，再连接。 ```python import bluetooth def find_rfcomm_port(device_address): """ 查询指定蓝牙设备上可用的RFCOMM服务端口。 :param device_address: 目标设备的MAC地址 :return: 第一个找到的RFCOMM端口号，如果没找到则返回None """ print(f“正在查询设备 {device_address} 的服务...“) services = bluetooth.find_service(address=device_address) if not services: print(“未找到任何服务。“) return None for svc in services: # 检查服务是否是RFCOMM类型 if svc[‘protocol’] == ‘RFCOMM’: port = svc[‘port’] name = svc[‘name’] print(f“找到RFCOMM服务: ‘{name}’ 在端口 {port}“) return port print(“未找到RFCOMM服务。“) return None def connect_with_service_discovery(device_address): """ 通过服务发现连接设备。 """ port = find_rfcomm_port(device_address) if port is None: print(“无法找到可用的RFCOMM端口，连接终止。“) return None sock = bluetooth.BluetoothSocket(bluetooth.RFCOMM) try: print(f“正在尝试连接到 {device_address}:{port} ...“) sock.connect((device_address, port)) print(“*** 连接成功！ ***“) # 这里可以设置socket超时，避免recv操作无限等待 sock.settimeout(10.0) return sock except bluetooth.btcommon.BluetoothError as e: print(f“连接失败: {e}“) # 常见错误：设备未开启、不在范围内、已配对但拒绝连接等 if “Connection refused” in str(e): print(“提示：连接被拒绝。请确认设备已处于可连接状态（如蓝牙耳机进入配对模式）。“) elif “Device or resource busy” in str(e): print(“提示：设备或资源忙。可能端口已被占用，尝试重启树莓派蓝牙或目标设备。“) return None except Exception as e: print(f“发生未知错误: {e}“) return None # 使用示例 if __name__ == “__main__“: # 替换成你扫描到的设备地址，例如你的手机蓝牙地址 target_addr = “DC:A6:32:XX:XX:XX” # 这是一个示例地址，请替换 socket = connect_with_service_discovery(target_addr) if socket: # 连接成功，可以进行后续数据传输 # ... 你的代码 ... socket.close() ``` 这个脚本就靠谱多了。`find_service` 函数会向目标设备询问它提供了哪些服务。找到RFCOMM服务对应的端口再连接，成功率远高于盲目尝试端口1。代码里还加入了一些常见的错误处理，能帮你快速定位问题。 ## 5. 双向数据传输实战：发送与接收 连接建立后，最激动人心的部分来了——传数据！`BluetoothSocket` 的使用方式和Python标准的TCP Socket非常像，主要就是用 `send()` 和 `recv()`。 ### 5.1 基础数据收发 假设我们连接了一个简单的蓝牙串口模块，它可能期待接收文本指令，并返回文本响应。 ```python def simple_data_exchange(sock): """ 一个简单的数据收发示例。 """ if sock is None: print(“Socket无效，无法进行数据传输。“) return try: # 发送数据 message_to_send = “Hello, Bluetooth!\\n” # 注意加换行符，很多设备以换行作为命令结束 print(f“发送: {message_to_send.strip()}“) sock.send(message_to_send.encode(‘utf-8’)) # 需要将字符串编码为字节 # 接收数据 # recv参数是最大接收字节数 data = sock.recv(1024) if data: print(f“收到: {data.decode(‘utf-8’).strip()}“) else: print(“连接已关闭。“) except bluetooth.btcommon.BluetoothError as e: print(f“数据传输错误: {e}“) except Exception as e: print(f“其他错误: {e}“) # 在连接成功后调用 # simple_data_exchange(socket) ``` 这里有几个**坑点**我踩过： 1. **编码问题**：蓝牙传输的是字节（bytes），不是字符串。所以发送前要 `.encode()`，接收后要 `.decode()`。务必统一编码，比如UTF-8。 2. **粘包问题**：和网络通信一样，对方快速发送“Hello”和“World”，你一次 `recv(1024)` 可能会收到“HelloWorld”。所以需要设计简单的**应用层协议**，比如用特定的分隔符（如换行符`\\n`）来区分每条消息。 3. **超时设置**：`sock.settimeout(10.0)` 非常重要。否则 `recv()` 会一直阻塞，直到收到数据或连接断开，程序就像“卡死”了一样。 ### 5.2 实现一个简单的聊天循环 让我们结合连接和收发，写一个能和蓝牙串口终端对话的小程序。 ```python def chat_with_device(device_address): """ 与蓝牙设备进行简单的命令行聊天。 """ sock = connect_with_service_discovery(device_address) if not sock: return print(“\\n*** 进入聊天模式 ***“) print(“输入你要发送的文字（输入 ‘quit’ 退出）:“) try: while True: # 获取用户输入 send_text = input(“> “).strip() if send_text.lower() == ‘quit’: print(“退出聊天。“) break if send_text: # 发送数据，自动加上换行符作为消息边界 sock.send((send_text + ‘\\n’).encode(‘utf-8’)) # 尝试接收数据（非阻塞方式，等待一小段时间） sock.settimeout(2.0) # 设置2秒超时 try: data = sock.recv(1024) if data: print(f“设备回复: {data.decode(‘utf-8’).strip()}“) except bluetooth.btcommon.BluetoothError as e: # 超时是预期内的，没有数据就不打印 if “timed out” not in str(e): print(f“接收错误: {e}“) # 恢复较长的超时，等待用户下一次输入 sock.settimeout(30.0) except KeyboardInterrupt: print(“\\n用户中断。“) except Exception as e: print(f“聊天过程发生错误: {e}“) finally: print(“关闭连接。“) sock.close() # 使用 # chat_with_device(“DC:A6:32:XX:XX:XX”) ``` 这个例子就更实用了。它创建了一个简单的交互循环，你可以打字发送，并等待设备回复。超时机制保证了程序不会傻等，用户体验更好。你可以用这个脚本去连接手机上的蓝牙串口APP（如“Serial Bluetooth Terminal”）进行测试，效果立竿见影。 ## 6. 项目进阶：打造一个蓝牙温湿度监测站 光说不练假把式。我们用一个综合项目把前面学的串起来：用树莓派4连接一个蓝牙温湿度传感器（比如市面上常见的“蓝牙温湿度计”或使用HC-08模块的DIY传感器），定期读取数据并记录到文件。 这个项目假设你已经有一个能通过蓝牙RFCOMM发送数据的传感器。如果没有，你可以用另一块树莓派或者手机APP模拟一个数据发送端。 ### 6.1 设计数据协议与解析 为了可靠地解析数据，我们需要和传感器约定一个简单的格式。例如，传感器每秒发送一次数据，格式为：`TEMP:25.6,HUM:60.5\\n` ```python import bluetooth import time import json from datetime import datetime def parse_sensor_data(raw_data): """ 解析从传感器接收到的数据。 示例格式：TEMP:25.6,HUM:60.5 """ try: data_str = raw_data.decode(‘utf-8’).strip() # 简单的键值对解析 data_dict = {} pairs = data_str.split(‘,’) for pair in pairs: if ‘:’ in pair: key, value = pair.split(‘:’, 1) data_dict[key.strip()] = float(value.strip()) return data_dict except Exception as e: print(f“解析数据失败 ‘{raw_data}’: {e}“) return None def monitor_bluetooth_sensor(device_address, log_file=“sensor_log.json”): """ 主监控函数：连接传感器，持续读取并记录数据。 """ print(f“启动蓝牙传感器监控，目标设备: {device_address}“) print(f“数据将记录到: {log_file}“) print(“按 Ctrl+C 停止监控。\\n”) sock = None reconnect_interval = 10 # 连接失败后重试间隔（秒） read_interval = 2 # 读取数据间隔（秒） while True: try: if sock is None: print(“尝试连接传感器...“) sock = connect_with_service_discovery(device_address) if sock is None: print(f“连接失败，{reconnect_interval}秒后重试...“) time.sleep(reconnect_interval) continue print(“传感器连接成功，开始读取数据。\\n“) # 设置接收超时 sock.settimeout(read_interval * 2) # 超时时间稍长于读取间隔 # 尝试读取数据 data = sock.recv(1024) if data: sensor_data = parse_sensor_data(data) if sensor_data: # 添加时间戳 sensor_data[‘timestamp’] = datetime.now().isoformat() print(f“[{sensor_data[‘timestamp’]}] 温度: {sensor_data.get(‘TEMP’, ‘N/A’)}°C, 湿度: {sensor_data.get(‘HUM’, ‘N/A’)}%“) # 记录到JSON文件（追加模式） with open(log_file, ‘a’) as f: json.dump(sensor_data, f) f.write(‘\\n’) # 每行一个JSON对象 else: # 收到空数据，通常表示连接被远端关闭 print(“传感器断开连接。“) sock.close() sock = None except bluetooth.btcommon.BluetoothError as e: if “timed out” in str(e): # 接收超时是正常的，可能传感器发送间隔较长，继续循环 pass else: print(f“蓝牙通信错误: {e}，尝试重新连接...“) if sock: sock.close() sock = None except KeyboardInterrupt: print(“\\n监控被用户中断。“) break except Exception as e: print(f“发生未知错误: {e}“) if sock: sock.close() sock = None time.sleep(5) # 退出循环，清理连接 if sock: sock.close() print(“监控程序已停止。“) # 运行监控（替换为你的传感器地址） # monitor_bluetooth_sensor(“00:11:22:33:44:55”, “my_sensor_data.json”) ``` ### 6.2 项目运行与优化建议 这个脚本已经具备了生产级应用的雏形：**自动重连**、**数据解析**、**带时间戳的日志记录**。运行后，它会持续工作，直到你按下Ctrl+C。 在实际部署时，你还可以考虑以下优化： 1. **加入看门狗（Watchdog）**：使用 `systemd` 或 `cron` 监控脚本运行状态，如果脚本意外退出则自动重启。 2. **数据可视化**：用 `matplotlib` 或将数据导入到 `Grafana` 等工具，实时绘制温湿度曲线图。 3. **异常报警**：当温度或湿度超过阈值时，发送邮件或推送通知到手机。 我自己的第一个树莓派蓝牙项目就是一个车库门状态监测器，用的就是类似的框架。从最开始的连接不稳定，到后来能稳定运行几个月，这个过程让我对蓝牙开发的细节有了更深的理解。蓝牙开发就是这样，入门容易，但要做好、做稳定，就需要在这些连接管理、错误处理和协议设计上下功夫。希望这个实战指南能帮你少走弯路，快速实现你的蓝牙创意。