Bleno 项目使用教程

Bleno 项目使用教程

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

1. 项目的目录结构及介绍

Bleno 是一个用于实现 BLE（Bluetooth Low Energy）外设的 Node.js 模块。以下是 Bleno 项目的目录结构及其介绍：

bleno/
├── examples/          # 示例代码目录
│   ├── advertisement-data/
│   ├── battery-service/
│   ├── echo/
│   ├── hrp/
│   ├── ibeacon/
│   ├── primary-service/
│   ├── rssi/
│   └── uuids/
├── lib/               # 核心库文件目录
│   ├── bindings/
│   ├── hci-socket/
│   ├── resolve-bindings.js
│   └── bleno.js
├── test/              # 测试文件目录
│   ├── bindings/
│   ├── hci-socket/
│   └── test.js
├── .gitignore         # Git 忽略文件配置
├── .npmignore         # npm 忽略文件配置
├── .travis.yml        # Travis CI 配置文件
├── LICENSE            # 许可证文件
├── README.md          # 项目说明文档
├── appveyor.yml       # AppVeyor CI 配置文件
├── binding.gyp        # Node.js 绑定配置文件
├── package.json       # 项目依赖和脚本配置文件
└── index.js           # 项目入口文件

目录结构说明

• examples/: 包含多个示例代码，展示了如何使用 Bleno 实现不同的 BLE 服务和特性。
• lib/: 包含项目的核心库文件，包括与蓝牙硬件交互的绑定和逻辑处理。
• test/: 包含项目的测试文件，用于确保代码的正确性和稳定性。
• .gitignore: 配置 Git 忽略的文件和目录。
• .npmignore: 配置 npm 忽略的文件和目录。
• .travis.yml: 配置 Travis CI 的持续集成任务。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档，包含安装和使用指南。
• appveyor.yml: 配置 AppVeyor CI 的持续集成任务。
• binding.gyp: 配置 Node.js 的绑定文件，用于编译原生模块。
• package.json: 项目的依赖和脚本配置文件，包含项目的元数据和运行脚本。
• index.js: 项目的入口文件，用于启动和初始化 Bleno 模块。

2. 项目的启动文件介绍

Bleno 项目的启动文件是 index.js，它是整个项目的入口点。以下是 index.js 的简要介绍：

// index.js
const bleno = require('./lib/bleno');

// 初始化 Bleno 实例
const BlenoPrimaryService = bleno.PrimaryService;
const BlenoCharacteristic = bleno.Characteristic;

// 定义服务和特性
const serviceUUID = '1234';
const characteristicUUID = '12345678-1234-5678-1234-567812345678';

const MyCharacteristic = class extends BlenoCharacteristic {
  constructor() {
    super({
      uuid: characteristicUUID,
      properties: ['read', 'write', 'notify'],
      value: null
    });
    this._value = new Buffer(0);
  }

  onReadRequest(offset, callback) {
    console.log('MyCharacteristic - onReadRequest: value = ' + this._value.toString('hex'));
    callback(this.RESULT_SUCCESS, this._value);
  }

  onWriteRequest(data, offset, withoutResponse, callback) {
    this._value = data;
    console.log('MyCharacteristic - onWriteRequest: value = ' + this._value.toString('hex'));
    callback(this.RESULT_SUCCESS);
  }
};

const myService = new BlenoPrimaryService({
  uuid: serviceUUID,
  characteristics: [
    new MyCharacteristic()
  ]
});

// 启动 Bleno
bleno.on('stateChange', (state) => {
  console.log('on -> stateChange: ' + state);
  if (state === 'poweredOn') {
    bleno.startAdvertising('MyBleno', [serviceUUID

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