1. 项目概述与核心价值

如果你手头有一块吃灰的树莓派，又恰好对智能家居感兴趣，那么今天这个项目绝对能让你把它重新利用起来。我们这次要做的，是一个基于树莓派和BLE 5.0蓝牙模块的智能家居远程控制系统。简单来说，就是让你能用手机上的一个APP，随时随地控制家里的一盏灯、一个风扇，或者任何你能通过继电器接上去的电器。这听起来像是智能家居的入门“Hello World”，但麻雀虽小，五脏俱全，它背后涉及了物联网（IoT）的几大核心要素：边缘计算节点（树莓派）、低功耗无线通信（BLE 5.0）、设备控制（GPIO）以及一个简单的应用层协议。

这个方案的价值非常明确。首先，它 完全去中心化 ，不依赖任何云服务或第三方平台，所有数据都在你的本地网络内流转，隐私和安全有保障。其次， 成本极低 ，核心硬件就是树莓派和一块几十元的BLE USB Dongle。最重要的是，它 极具可扩展性 。今天你学会了控制一盏灯，明天就能用同样的原理，通过增加继电器模块和修改代码，控制窗帘、空调、加湿器，甚至组合成复杂的场景联动。对于嵌入式开发者、物联网爱好者，或是任何想亲手搭建一个可控、可玩智能系统的朋友来说，这都是一个绝佳的起点。整个项目的逻辑清晰：手机APP通过蓝牙向树莓派上的BLE模块发送指令，树莓派上的Python脚本解析指令，并操作对应的GPIO引脚输出高/低电平，从而驱动继电器吸合或断开，最终控制强电设备。接下来，我们就从硬件选型开始，一步步拆解实现过程。

2. 硬件选型与电路设计解析

2.1 核心控制器：为什么是Raspberry Pi？

在众多开发板中，选择树莓派作为本项目的核心控制器，是基于多方面的考量。首先，树莓派本质上是一台运行Linux系统的微型电脑，这带来了巨大的灵活性。我们可以轻松地使用Python这样高级语言来编写控制逻辑，调用丰富的库（如 RPi.GPIO , serial ），远比在单片机上用C语言开发要快速和便捷。其次，树莓派拥有完整的USB主机接口，可以即插即用地连接像BLEUIO这样的USB蓝牙适配器，省去了焊接和调试UART、SPI等底层通信接口的麻烦。最后，树莓派的GPIO引脚驱动能力虽然有限（通常3.3V，最大16mA），但用于驱动一个继电器模块的控制端（通常需要5V或3.3V，电流仅几毫安）绰绰有余，并且其社区支持庞大，遇到任何问题几乎都能找到解决方案。

注意 ：树莓派型号建议选择3B+、4B或更新的型号。它们内置的Wi-Fi和蓝牙可能与本项目的外置Dongle冲突，但我们可以通过系统设置禁用内置蓝牙，确保外置Dongle稳定工作。对于Zero系列，虽然更小巧省电，但需要额外的USB HUB来连接Dongle，增加了复杂度。

2.2 无线通信核心：深入理解BLEUIO与BLE 5.0

项目使用了BLEUIO这款专用的蓝牙低能耗（BLE）USB Dongle。它不仅仅是一个蓝牙适配器，更是一个集成了蓝牙协议栈的智能模块。其核心优势在于，它通过虚拟串口（VCP）与树莓派通信，开发者只需要向这个串口发送简单的AT指令（如 AT+ADVSTART 开始广播），就能完成复杂的蓝牙操作（如广播、连接、数据收发），而无需深入研究晦涩难懂的蓝牙HCI协议或GATT数据库设计。这极大地降低了蓝牙开发的门槛。

BLE 5.0相比之前的版本，在传输距离、速度和广播数据包容量上都有显著提升。对于智能家居控制这种小数据量（开关指令只有几个字节）、低频率（几分钟甚至几小时一次）的场景，BLE的低功耗特性是核心优势。手机作为中心设备（Central），BLEUIO作为外围设备（Peripheral），手机可以主动扫描并连接BLEUIO，然后通过写入特定的GATT特征值来发送指令。

2.3 强弱电桥梁：继电器模块的选择与安全接线

这是整个项目中最需要谨慎对待的环节，因为涉及到220V家用交流电。 安全永远是第一位的 。

继电器选型 ：我们通常选用“树莓派继电器模块”，这种模块是专为微控制器设计的。它一般具备以下特点：

  1. 控制端 ：使用光耦隔离，输入电压为3.3V或5V（与树莓派GPIO电平兼容），驱动电流极小（~5mA），可以直接由树莓派GPIO驱动。
  2. 被控端 ：通常是常开（NO）、常闭（NC）和公共端（COM）接口，可以承受250V交流电、10A的电流，足以控制大多数灯具和小家电。
  3. 指示灯 ：模块上会有电源指示灯和继电器状态指示灯，方便调试。

电路连接详解（至关重要） ： 请务必在 完全断电 的情况下操作！

  1. 树莓派与继电器模块 ：

    • VCC引脚 -> 连接到树莓派的 5V引脚 （如Pin 2或4）。这为继电器模块的内部电路供电。
    • GND引脚 -> 连接到树莓派的 任意GND引脚 （如Pin 6, 9, 14, 20等）。确保共地。
    • IN引脚（或标注为SIG, CTRL等） -> 连接到树莓派的 某个GPIO引脚 （例如GPIO 4，对应物理引脚Pin 7）。这个引脚将输出高/低电平来控制继电器的开关。

  2. 继电器模块与负载（以灯泡为例） ：

    • 将 家用220V电源的火线（L） 剪断。
    • 将剪断的 一端 接入继电器模块的 公共端（COM） 。
    • 将剪断的 另一端 接入继电器模块的 常开端（NO） 。
    • 家用220V电源的零线（N） 直接接到灯泡上， 不要经过继电器 。
    • 灯泡的另一端再接回电源的零线（或通过继电器模块的零线端子，如果模块有的话）。实际上，我们通常只通过继电器控制火线的通断，这是标准且安全的做法。

警告 ：此部分操作涉及高压电，有致命风险！如果你不是持证电工或对强电没有充分了解和实践经验，强烈建议只完成低压部分（树莓派控制继电器模块“滴答”吸合），而将强电部分接线交由专业电工完成，或者使用 12V或24V的直流低压灯泡/设备 进行实验，完全避开220V交流电。

3. 软件环境搭建与核心脚本剖析

3.1 树莓派系统与Python环境准备

首先，确保你的树莓派已经安装了Raspberry Pi OS（原Raspbian）系统。通过终端进行以下操作：

# 1. 更新系统软件包列表
sudo apt update
sudo apt upgrade -y

# 2. 安装必要的Python库
# RPi.GPIO 用于控制GPIO引脚
# pyserial 用于通过串口与BLEUIO Dongle通信
sudo apt install python3-pip -y
sudo pip3 install pyserial
# RPi.GPIO 通常已预装，如果没有则安装
sudo apt install python3-rpi.gpio -y

# 3. 禁用树莓派内置蓝牙（避免与外置Dongle冲突）
# 编辑配置文件
sudo nano /boot/config.txt
# 在文件末尾添加一行
dtoverlay=disable-bt
# 保存并退出 (Ctrl+X, 然后 Y, 然后 Enter)
# 重启树莓派使更改生效
sudo reboot

重启后，内置蓝牙将被禁用，USB端口将专用于BLEUIO Dongle。

3.2 核心Python脚本深度解读

项目提供的脚本是控制逻辑的核心。我们来逐段分析其工作原理和关键点。

1. 导入库与初始化： 

import time
import serial.tools.list_ports
import serial
import RPi.GPIO as io

switch = 7  # 关键参数：控制引脚
io.setmode(io.BOARD)  # 使用物理引脚编号模式
io.setup(switch, io.OUT)  # 将引脚设置为输出模式
  • switch = 7 ：这里使用的是 物理引脚编号（BOARD模式） ，Pin 7对应的是BCM编码下的GPIO 4。你可以使用 pinout 命令在终端查看树莓派的引脚图。如果你想使用BCM编码（更常见），可以改为 switch = 4 ，并将模式设置为 io.setmode(io.BCM) 。
  • io.setup(switch, io.OUT) ：将指定引脚初始化为输出模式，意味着我们将通过程序控制它输出高电平（3.3V）或低电平（0V）。

2. 自动发现并连接BLEUIO Dongle： 

dongle_port = ""
while len(master_array) == 0:
    m_ports = serial.tools.list_ports.comports(include_links=False)
    for port in m_ports:
        if str(port.hwid).__contains__("VID:PID=2DCF"):
            ... # 找到特定VID/PID的设备

这段代码的核心是遍历系统所有串口设备，通过硬件ID（VID:PID）来识别哪个是BLEUIO Dongle（其VID/PID为2DCF:6002）。这是一个非常稳健的做法，即使Dongle插在不同的USB口，脚本也能自动找到它，无需手动指定串口号（如 /dev/ttyUSB0 ）。

3. 配置BLEUIO并启动广播： 

dongle_conn.write("AT+GAPDISCONNECTALL\rAT+DUAL\rAT+ADVSTART\rATI\r".encode())

这里通过串口向Dongle发送了一系列AT指令：

  • AT+GAPDISCONNECTALL ：断开所有现有蓝牙连接，确保一个干净的状态。
  • AT+DUAL ：此指令含义需查阅BLEUIO具体手册，可能是设置双模或某种工作模式。 这是脚本中一个需要验证的点 ，根据BLEUIO的官方文档，启动广播可能只需要 AT+ADVSTART 。
  • AT+ADVSTART ：命令Dongle开始广播，使其可以被手机扫描到。
  • ATI ：查询Dongle信息，用于确认连接和状态。

4. 主循环：监听指令并控制GPIO： 

while True:
    try:
        dongle_resp = dongle_conn.readline().decode()
        if "SW=0" in dongle_resp:
            print("Turn Switch off!")
            io.output(switch, io.LOW)  # 输出低电平，继电器断开
        if "SW=1" in dongle_resp:
            print("Turn Switch on!")
            io.output(switch, io.HIGH) # 输出高电平，继电器吸合

这是脚本的心脏。它在一个无限循环中不断读取来自BLEUIO串口的数据。当收到手机APP发来的“SW=0”字符串时，控制引脚输出低电平（ io.LOW ），继电器关闭，灯熄灭。收到“SW=1”时，输出高电平（ io.HIGH ），继电器打开，灯点亮。这里的逻辑简单直接，但非常有效。

实操心得 ：脚本中的 dongle_conn.readline() 默认使用 \n 作为行结束符。务必确保手机APP发送的指令末尾有换行符（ \n 或 \r\n ），否则脚本可能无法正确读取到完整指令。许多BLE调试APP在发送文本时可以选择添加换行符。

4. 手机端操作与通信协议揭秘

4.1 BLE调试APP的选择与使用

项目原文提到了nRF Connect和BLE Scanner。这里我强烈推荐 nRF Connect （由Nordic Semiconductor开发），因为它功能强大、免费且跨平台（iOS和Android）。以下是详细操作步骤：

  1. 安装与打开 ：在手机应用商店搜索“nRF Connect”并安装。打开APP，授予位置和蓝牙权限（Android上蓝牙扫描需要位置权限）。
  2. 扫描设备 ：点击右上角的“SCAN”按钮。你应该能在设备列表中看到一个名为“BleuIO”的设备。如果没看到，检查树莓派脚本是否已运行并打印了“Starting Advertising...”。
  3. 连接设备 ：点击“BleuIO”设备旁边的“CONNECT”按钮。连接成功后，APP会跳转到服务详情页面，展示该设备提供的所有GATT服务（Service）和特征值（Characteristic）。

4.2 理解GATT通信：如何发送开关指令

连接成功后，我们需要找到正确的“管道”来发送数据。根据脚本和原文提示，需要操作两个特征值：

  1. 流控制特征（Flow Control） ：

    • UUID : 0783b03e-8535-b5a0-7140-a304d2495cb9
    • 操作 ：点击该特征值旁边的“向上箭头”（写）图标。在写入值的地方，输入 01 （即十六进制的0x01），编码格式选择 HEX 。然后点击“SEND”。这一步可以理解为“打开数据接收开关”，通知BLEUIO准备接收后续的应用数据。

  2. 服务器RX数据特征（Server RX Data） ：

    • UUID : 0783b03e-8535-b5a0-7140-a304d2495cba
    • 操作 ：这是真正发送控制指令的地方。点击其写图标。
      • 开灯 ：在输入框输入文本 SW=1 ，编码格式选择 UTF-8 ，然后点击“SEND”。
      • 关灯 ：输入文本 SW=0 ，编码格式选择 UTF-8 ，然后点击“SEND”。

协议解析 ：这实际上定义了一个极其简单的应用层协议。 SW 可以理解为“Switch”的缩写， = 是分隔符， 1 和 0 是状态值。这个协议非常易于扩展，例如，你可以定义 FAN=1 控制风扇， LED=255 控制LED亮度等。脚本只需要解析字符串前缀并执行相应动作即可。

注意事项 ：不同版本的BLEUIO固件，其服务UUID可能不同。如果上述UUID找不到，请查阅你购买的BLEUIO Dongle的最新官方文档。此外，写入 0x01 到流控制特征这一步至关重要，缺少它，后续发送的 SW=1 指令将被Dongle忽略。

5. 系统集成、调试与功能扩展

5.1 全流程联调与问题排查

将硬件连接好，软件准备妥当后，按照以下顺序启动和测试：

  1. 硬件上电 ：先给树莓派上电。 此时继电器模块连接的强电电路务必保持断开状态！
  2. 运行脚本 ：在树莓派终端，进入脚本所在目录，运行 python3 bleuio_rpi_switch_example.py 。观察输出，应该能看到“Found dongle...”和“Starting Advertising...”等成功信息。
  3. 手机操作 ：打开nRF Connect，扫描并连接“BleuIO”，按照4.2节步骤写入流控制值，然后尝试写入 SW=1 。
  4. 观察现象 ：
    • 树莓派终端 ：应打印出“Turn Switch on!”。
    • 继电器模块 ：应听到清晰的“滴答”吸合声，同时状态指示灯（如果有）亮起。
    • 万用表测量（可选但推荐） ：用万用表直流电压档，测量连接树莓派GPIO的继电器IN引脚和GND之间的电压。发送 SW=1 时应接近3.3V， SW=0 时应接近0V。
  5. 强电测试（极度谨慎） ：只有在确认低压控制部分（继电器可靠吸合/断开）完全正常后，才能在断电情况下接好强电线路，然后上电进行最终测试。

常见问题排查表 ：

现象 可能原因 排查步骤
手机扫描不到“BleuIO” 1. 脚本未运行或报错
2. 内置蓝牙未禁用，造成冲突
3. BLEUIO Dongle损坏或接触不良		 1. 检查脚本运行输出，确保有“Advertising”相关提示。
2. 运行 hciconfig 命令，确认只有BLEUIO一个蓝牙设备（如 hci1 ）。若有 hci0 ，说明内置蓝牙未禁用成功。
3. 重新插拔Dongle，或换一个USB口试试。
连接后找不到指定UUID的服务 BLEUIO固件版本或模式不同 1. 在nRF Connect中查看连接后显示的所有服务UUID，与官方文档核对。
2. 尝试在脚本中注释掉 AT+DUAL 指令再试。
发送 SW=1 后继电器无反应 1. 未写入流控制值 0x01
2. GPIO引脚定义错误
3. 继电器模块损坏或接线错误		 1. 确认已向Flow Control特征写入 01 （HEX）。
2. 确认脚本中 switch 变量对应的物理引脚是否正确，并用 pinout 命令核对。
3. 用万用表检查继电器模块VCC是否有5V电压，IN引脚电压是否随指令变化。
脚本报错“No module named 'serial'” Python库未安装 运行 sudo pip3 install pyserial 安装。

5.2 功能扩展与实践建议

基础的单路控制实现后，你可以从这个框架出发，进行无限扩展：

  1. 多路控制 ：在脚本中定义多个GPIO引脚，分别控制不同的继电器。修改指令协议，如 SW1=1 、 SW2=0 ，并在解析部分增加对应的 if 判断。

    switch_light = 7
switch_fan = 11
io.setup(switch_light, io.OUT)
io.setup(switch_fan, io.OUT)
# 在解析循环中
if "LIGHT=1" in dongle_resp:
    io.output(switch_light, io.HIGH)
if "FAN=0" in dongle_resp:
    io.output(switch_fan, io.LOW)

  2. 状态反馈 ：目前系统是单向的（手机->树莓派）。你可以增加传感器（如温湿度传感器DHT11），让树莓派定期读取数据，并通过BLEUIO的“Server TX Data”特征（如果支持）主动通知手机，或者在手机端开启特征值通知（Notify）来读取状态。

  3. 打造专属APP ：使用nRF Connect测试只是第一步。你可以使用Flutter（配合 flutter_blue 库）、React Native或安卓原生的Bluetooth API开发一个简单的手机APP，界面化地展示开关按钮，点击时自动完成连接、写流控制、发送指令的全流程，体验更佳。

  4. 增加安全层 ：目前的协议是明文的。你可以为指令增加简单的校验码，或者在连接后进行一次“配对”握手（例如，手机发送一个随机数，树莓派计算后返回，双方验证），防止邻居误连你的设备。

  5. 系统服务化 ：让脚本在树莓派开机时自动后台运行。可以创建一个systemd服务：

    sudo nano /etc/systemd/system/ble-homeauto.service

    写入以下内容（修改 ExecStart 路径）：

    [Unit]
Description=Ble Home Automation Service
After=network.target

[Service]
ExecStart=/usr/bin/python3 /home/pi/your_script_path/bleuio_rpi_switch_example.py
WorkingDirectory=/home/pi/your_script_path
StandardOutput=inherit
StandardError=inherit
Restart=always
User=pi

[Install]
WantedBy=multi-user.target

    然后启用并启动服务：

    sudo systemctl enable ble-homeauto.service
sudo systemctl start ble-homeauto.service

这个项目就像一把钥匙，打开了用树莓派和蓝牙玩转智能硬件的大门。从最初的灯光明灭，到后来可以联动传感器、自定义协议、开发应用，每一步的探索都能带来实实在在的成就感。我自己的第一个版本就是控制书桌旁的台灯，后来陆续加上了温控风扇和下班自动开灯的小场景。过程中最深的体会是，硬件项目成功的关键在于 分段调试 和 耐心 ：先确保代码逻辑在终端里能打印出正确的信息，再测试GPIO能否控制LED闪烁，接着验证蓝牙指令能否收到，最后才接入继电器和强电。每次只增加一个变量，问题就永远能被定位在最小的范围里。

# 智能家居
Logo
脑启社区

脑启社区是一个专注类脑智能领域的开发者社区。欢迎加入社区，共建类脑智能生态。社区为开发者提供了丰富的开源类脑工具软件、类脑算法模型及数据集、类脑知识库、类脑技术培训课程以及类脑应用案例等资源。

更多推荐

具身智能VLA模型全景图：从Pi0到HoloBrain-0的15大开源力作

从Physical Intelligence的Pi0到地平线的HoloBrain-0，这15个模型不仅代表了当前VLA技术的水平，更展示了具身智能从‘单一任务’向‘通用操作’迈进的坚定步伐。无论是追求极致的灵巧控制，还是探索类脑架构的安全性，开源社区正在以前所未有的速度缩小仿真与现实的差距。同步开源了仅 0.2B 参数的端侧友好版本及全栈基础设施 RoboOrchard，提供从数据采集、标准化规范

avatar 脑启社区
cover

03-AI的下半场记忆引擎与大模型同样重要

avatar 脑启社区
cover

AI进入现实世界的新考验：类脑智能如何破解物理AI“跑不久”的难题

avatar 脑启社区