noble/bleno 开源项目教程

noble/bleno 开源项目教程

项目地址:https://gitcode.com/gh_mirrors/bl/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解决方案。

---

请注意，实际操作可能因环境而异，遇到问题时，建议查阅项目官方文档和社区资源。

bleno A Node.js module for implementing BLE (Bluetooth Low Energy) peripherals 项目地址: https://gitcode.com/gh_mirrors/bl/bleno