Multidevice-bluetooth-heart-rate-monitor NPM

Multidevice Bluetooth Heart Rate Monitor

A TypeScript library for managing multiple Bluetooth heart rate monitor devices simultaneously.

Documentation:

This package is based on the following:

@abandonware/noble

Features

Connect to multiple Bluetooth heart rate monitors
Real-time heart rate data streaming
Battery level monitoring (if supported by the device)
Automatic reconnection to known devices
Event-based architecture for easy integration

Installation

npm install multidevice-bluetooth-heart-rate-monitor

Usage

Here's a basic example of how to use the library:

import {
  MultiDeviceBluetoothHeartRateMonitor,
  BluetoothHeartRateDevice,
  DeviceData,
} from "multidevice-bluetooth-heart-rate-monitor";

const monitor = new MultiDeviceBluetoothHeartRateMonitor();
const discoveredDevices: Map<string, BluetoothHeartRateDevice> = new Map();

monitor.on("data", (data: DeviceData) => {
  console.log(
    `Heart rate for device ${data.deviceId}: ${JSON.stringify(data)}`
  );
});

monitor.on("deviceDiscovered", async (device: BluetoothHeartRateDevice) => {
  if (discoveredDevices.has(device.getDeviceInfo().deviceId)) {
    return;
  }
  discoveredDevices.set(device.getDeviceInfo().deviceId, device);
  console.log(`Device discovered: ${device.getDeviceInfo().deviceId}`);
  try {
    setTimeout(async () => {
      console.log("connecting to device...");
      try {
        await monitor.connectDevice(device);
      } catch (error) {
        console.error(error);
      }
    }, 10000);
  } catch (error) {
    console.error(error);
  }
});
monitor.startScanning();

API Reference

`MultiDeviceBluetoothHeartRateMonitor`

The main class for managing multiple heart rate monitor devices.

Methods

startScanning(): Start scanning for Bluetooth heart rate monitors.
stopScanning(): Stop scanning for devices.
getDiscoveredDevices(): Get an array of currently discovered devices.
getConnectedDevices(): Get an array of currently connected devices.
connectDevice(DeviceData): Connect a discovered device.
disconnectDeviceId(deviceId): Disconnected a device by id.

Events

'deviceDiscovered': Emitted when a new device is discovered.
'discoveredDeviceLost': Emitted when a discovered device isn't available anymore.
'data': Emitted when heart rate data is received from a device.
'deviceConnected': Emitted when a known device is reconnected.
'deviceDisconnected': Emitted when a known device is reconnected.
'scanStart': Emitted when scanning starts.
'scanStop': Emitted when scanning stops.
'error': Emitted when an error occurs.
'adapterReady': Emitted when the bluetooth adapter is ready.