树莓派4B无法通过awoxmeshlight/bluepy连接EGLO BTLE灯泡

以下是针对Raspbian Buster树莓派4B连接EGLO BTLE灯泡的分步排查与解决方法：

1. 升级BlueZ版本（关键前提） #

Raspbian Buster默认的BlueZ版本可能不支持EGLO灯泡依赖的BLE Mesh特性，建议升级到最新稳定版：

# 卸载旧版本
sudo apt remove -y bluez bluez-tools
# 安装编译依赖
sudo apt install -y build-essential libdbus-1-dev libglib2.0-dev libudev-dev libical-dev libreadline-dev
# 下载并编译BlueZ 5.64（稳定版）
wget https://www.kernel.org/pub/linux/bluetooth/bluez-5.64.tar.xz
tar xf bluez-5.64.tar.xz
cd bluez-5.64
./configure --prefix=/usr --mandir=/usr/share/man --sysconfdir=/etc --localstatedir=/var --enable-mesh --enable-bluetoothd
make -j4
sudo make install
# 重启蓝牙服务
sudo systemctl daemon-reload
sudo systemctl restart bluetooth
# 验证版本
bluetoothd -v

2. 修复蓝牙权限与基础状态 #

• 将当前用户加入蓝牙组，避免权限问题：

  sudo usermod -aG bluetooth $USER
  

  执行后重新登录系统生效。
• 确保蓝牙服务正常运行：

  sudo systemctl status bluetooth
  # 异常时重启服务
  sudo systemctl restart bluetooth
  

3. 使用BlueZ原生Mesh工具配置灯泡 #

EGLO BTLE灯泡大多依赖BLE Mesh网络，而非普通BLE外设连接，用BlueZ自带的meshctl完成组网：

# 启动mesh服务
sudo systemctl start bluetooth-meshd
# 进入mesh控制台
meshctl
# 初始化本地Mesh网络
init
# 扫描Mesh节点（找到灯泡的MAC或节点ID）
scan
# 引导灯泡加入网络（替换<MAC>为灯泡地址，需输入说明书上的配对码，常见为000000/123456）
provision <MAC>
# 将灯泡添加到默认控制组（组地址0xc000）
add <node-id> 0xc000
# 测试控制
set 0xc000 on  # 打开灯泡
set 0xc000 off # 关闭灯泡

4. 手动配对排查（备选） #

如果Mesh组网失败，尝试用bluetoothctl执行普通BLE配对：

bluetoothctl
power on
agent on
default-agent
scan on
# 找到灯泡后执行
pair <MAC>
# 输入配对码（尝试0000/1234/123456/000000）
trust <MAC>
connect <MAC>

若提示Authentication Failed，说明灯泡仅支持Mesh连接，回到步骤3。

5. 硬件干扰排查 #

• 暂时关闭树莓派WiFi，避免2.4GHz频段干扰：

  sudo rfkill block wlan
  

• 尝试外接USB蓝牙适配器（需支持BLE 5.0以上），替代内置蓝牙模块测试。

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