noble: Bluetooth LE Library 深入指南

最新推荐文章于 2024-09-03 08:47:35 发布

惠淼铖

最新推荐文章于 2024-09-03 08:47:35 发布

阅读量895

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00188/article/details/141844962

noble: Bluetooth LE Library 深入指南

nobleA Node.js BLE (Bluetooth Low Energy) central module 项目地址:https://gitcode.com/gh_mirrors/no/noble

项目介绍

noble 是一个用于 Node.js 的蓝牙低功耗（Bluetooth LE，也称为 BLE 或 Bluetooth Smart）库。它提供了与 BLE 设备交互的强大接口，支持扫描设备、连接、读写特性值、监听通知等核心功能。noble 在物联网（IoT）、可穿戴技术以及其他依赖无线通信的应用中发挥着关键作用。通过这个库，开发者能够轻松地在 Node.js 环境下开发蓝牙低功耗应用。

项目快速启动

安装 noble

首先，确保你的开发环境已经安装了 Node.js。然后，你可以通过 npm 来安装 noble：

npm install noble

示例：简单的设备扫描

下面的代码示例展示了如何使用 noble 扫描附近的蓝牙 LE 设备：

const noble = require('noble');

noble.startScanning([], true);

noble.on('discover', function(peripheral) {
    console.log('Found peripheral:', peripheral.address);
    peripheral.stopScan();
    noble.stopScanning();
});

setTimeout(function() {
    console.log('Stopped scanning.');
    noble.stopScanning();
}, 5000); // 停止扫描五秒后

这段代码启动扫描，并在发现设备时打印其地址，之后停止扫描。设定的定时器用于演示自动停止扫描的概念。

应用案例与最佳实践

noble 的应用范围广泛，从智能家居控制到健康追踪设备的数据收集。最佳实践中，应关注：

资源管理：及时断开无用连接，释放资源。
错误处理：总是包围可能抛出错误的 noble API 调用以处理异常。
电源管理：对于移动设备，优化扫描周期以减少电池消耗。

示例：数据读取

读取特定服务和特性的值是常见的需求。假设你知道目标设备的服务 UUID 和特征 UUID，代码可能如下：

peripheral.connect(function(error) {
    if (error) {
        console.error("Connection error:", error);
        return;
    }
    
    peripheral.discoverServices(['service_UUID'], function(error, services) {
        if (error) {
            console.error("Service discovery error:", error);
            return;
        }

        let service = services[0];
        
        service.discoverCharacteristics(['characteristic_UUID'], function(error, characteristics) {
            if (error) {
                console.error("Characteristic discovery error:", error);
                return;
            }

            let characteristic = characteristics[0];

            characteristic.read(function(error, data) {
                if (!error) {
                    console.log("Read data:", data.toString('hex'));
                } else {
                    console.error("Reading error:", error);
                }
                
                // 完成后关闭连接
                peripheral.disconnect();
            });
        });
    });
});