Debian与Buildroot依赖包对应及Node.js蓝牙应用故障排查

我在搭载DietPi（Debian）系统的Radxa Zero上运行一个基于Node.js和@abandonware/noble包的蓝牙设备控制应用。该包文档要求安装Debian包：sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev。我需要了解这些包在Buildroot中的等效名称，以及如何确保它们被安装到Buildroot镜像中。

目前已在镜像的Target packages中勾选了bluez-tools、bluez-utils，可通过bluetoothctl和hcitool lescan扫描到BLE设备，但运行应用时出现依赖缺失类报错：

# NOBLE_HCI_DEVICE_ID=1 node .

internal/modules/cjs/loader.js:1144
  return process.dlopen(module, path.toNamespacedPath(filename));
                 ^

Error: File not found
    at Object.Module._extensions..node (internal/modules/cjs/loader.js:1144:18)
    at Module.load (internal/modules/cjs/loader.js:950:32)
    at Function.Module._load (internal/modules/cjs/loader.js:790:12)
    at Module.require (internal/modules/cjs/loader.js:974:19)
    at require (internal/modules/cjs/helpers.js:101:18)
    at Object.<anonymous> (/root/client/node_modules/@abandonware/bluetooth-hci-socket/lib/native.js:6:15)
    at Module._compile (internal/modules/cjs/loader.js:1085:14)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:1114:10)
    at Module.load (internal/modules/cjs/loader.js:950:32)
    at Function.Module._load (internal/modules/cjs/loader.js:790:12) {
  code: 'ERR_DLOPEN_FAILED'
}

当前Node.js版本为14.20.1。另外，bluemoon命令输出异常，请问是否与此相关？

# bluemoon 
Bluemoon configuration utility ver 5.65
Failed to open HCI user channel

Buildroot等效包对应关系及安装配置 #

• Debian的bluetooth和bluez包：对应Buildroot中的bluez（核心蓝牙栈），需在Target packages -> Networking applications下勾选bluez。
• Debian的libbluetooth-dev：在Buildroot的bluez配置项中，勾选Install development files，确保编译时能获取头文件和静态库。
• Debian的libudev-dev：若系统使用eudev，在Target packages -> System tools -> eudev中勾选Install development files；若使用systemd，则在Target packages -> System tools -> systemd中勾选对应开发文件选项。

应用报错（ERR_DLOPEN_FAILED）排查与修复 #

该错误来自@abandonware/bluetooth-hci-socket原生模块加载失败，可从以下几点处理：

1. 检查共享库是否存在：确认目标系统/usr/lib目录下有libbluetooth.so和libudev.so，若缺失需重新配置Buildroot，确保bluez和eudev/systemd的运行时库被包含进镜像。
2. 原生模块编译问题：
   • 若在目标系统直接执行npm install，需确保系统安装了编译器（gcc、make）及上述开发库（通过Buildroot配置添加），让模块能编译链接依赖库。
   • 若为交叉编译Node.js模块，需配置交叉编译环境变量（如CC、CXX指向交叉编译器），确保模块编译时链接到Buildroot提供的目标架构库。
3. HCI设备权限问题：
   • 先执行hciconfig确认hci1设备存在，若不存在需检查蓝牙硬件是否正常加载。
   • 临时测试可执行chmod o+rw /dev/hci1开放设备权限；长期解决需添加udev规则：创建/etc/udev/rules.d/99-bluetooth.rules，写入SUBSYSTEM=="bluetooth", MODE="0666"，再执行udevadm control --reload-rules && udevadm trigger生效。

bluemoon异常与应用报错的关联 #

bluemoon的Failed to open HCI user channel错误和应用报错直接相关，两者均因无法正常访问HCI蓝牙设备导致。修复上述HCI设备权限、蓝牙服务状态问题后，两者的异常应均可解决：

• 先确认蓝牙服务启动：执行systemctl start bluetooth（systemd环境）或/etc/init.d/bluetooth start（SysVinit环境）。
• 执行hciconfig hci1 up确保HCI设备处于启用状态。

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