noble/bleno 开源项目教程
1. 项目介绍
noble/bleno 是一个Node.js库,用于实现蓝牙低功耗(BLE)的外围设备角色。这个库允许你的设备模拟一个BLE外围设备,广播服务和特征,以及接收来自中心设备的连接请求。它主要在Linux上进行测试,但也支持其他操作系统。
2. 项目快速启动
安装依赖
确保你已安装了以下依赖:
bluetooth
和bluez
包(例如,在Ubuntu或Debian系统中)libbluetooth-dev
和libudev-dev
编译开发包- Node.js
在Ubuntu/Debian/Raspbian上执行:
sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev
安装bleno
库
通过npm安装bleno
:
npm install bleno
启动示例
创建一个简单的广告示例:
const bleno = require('bleno');
bleno.on('stateChange', function(state) {
console.log('on -> stateChange:', state);
if (state === 'poweredOn') {
bleno.startAdvertising('myPeripheral', [], function(err) {
if (err) {
console.error('startAdvertising error:', err);
}
});
} else {
bleno.stopAdvertising();
}
});
bleno.on('advertisingStart', function(error) {
console.log('on -> advertisingStart:', error ? 'error' : 'success');
});
运行上面的脚本以开始广播设备。
node your_advertising_script.js
3. 应用案例和最佳实践
- iBeacon 模式:在OS X中,启用iBeacon模式时,设备不可连接。
- 自定义EIR数据:在Linux上,可以使用EIR数据来广播更复杂的信息。
- 设置服务:定义主要的服务以便客户端连接后可以访问。
- 处理连接:当客户端连接到设备时,提供适当的服务并处理数据交换。
示例:自定义EIR数据广告
var scanData = new Buffer( ); // 最大31字节
var advertisementData = new Buffer( ); // 最大31字节
bleno.startAdvertisingWithEIRData(advertisementData, scanData, function(error) {
if (error) {
console.error('startAdvertisingWithEIRData error:', error);
} else {
console.log('advertising started');
}
});
4. 典型生态项目
- Bleno 的替代实现:如Python的PyBleno,可以在
pybleno
仓库找到,它提供了类似的功能但用Python语言实现。 - Noble:作为Bleno的对应,Noble是用于实现BLE中心角色的库,可以用来扫描和连接到BLE外围设备。
这两个项目通常一起使用,构建完整的BLE解决方案。
请注意,实际操作可能因环境而异,遇到问题时,建议查阅项目官方文档和社区资源。