acgam-t02p v0.0.4

acgam-t02p

ACGAM T02P Treadmill BLE communication library for Node.js.

It can be easily used for instance on Raspberry Pi 4 with Raspbian OS to grab live stats from your treadmill.

Installation

npm i acgam-t02p

Example usage

import { BluetoothDeviceAddress, TreadmillConnection, TreadmillStatus } from 'acgam-t02p';

const DEVICE_ADDRESS = 'FF:FF:FF:FF:FF:FF'; // TODO: Change with your real device address

(async () => {
  const connection = await TreadmillConnection.forAddress(
    BluetoothDeviceAddress.fromString(DEVICE_ADDRESS)
  );

  connection.addStatusNotificationEventListener(handleNotification);
})();

function handleNotification(status: TreadmillStatus) {
  console.log(status);
}

API

TreadmillConnection

This is main class that enables you to maintain a connection and communication with treadmill device.

BluetoothDeviceAddress

Helper value object that stores valid bluetooth device address.

TreadmillStatus

It's data structure that will come into your treadmill status notification listener:

type TreadmillStatus
  = { status: 'STANDBY' }
  | { status: 'STOPPED' }
  | { status: 'WAKING_UP' }
  | { status: 'PRESTART' }
  | { status: 'STARTING'; countdown: number }
  | {
      status: 'RUNNING' | 'STOPPING';
      elapsedSeconds: number;
      distanceInMeters: number;
      speed: {
        currentKmh: number;
        targetKmh: number;
      };
    };

Example status data with its interpretation: