PitchSix Force Board

The PitchSix Force Board Portable is a portable force plate. It supports battery, humidity/temperature, streaming, tare (by characteristic or mode), Quick Start mode, and threshold configuration.

Basic usage

import { ForceBoard } from "@hangtime/grip-connect"

const device = new ForceBoard()
device.notify((data) => console.log(data.current))

await device.connect(
  async () => {
    console.log("Battery:", await device.battery())
    await device.stream(30000)
    device.download("json")
    device.disconnect()
  },
  (err) => console.error(err),
)

Methods

Force Board supports all shared methods (connect, disconnect, isConnected, notify, active, read, write, tare, download). See Device interface for details.

Device-specific

Method	Returns	Description
battery()	Promise<string | undefined>	Battery/voltage.
humidity()	Promise<string | undefined>	Humidity level.
manufacturer()	Promise<string | undefined>	Manufacturer info.
stop()	Promise<void>	Stop stream (Idle mode).
stream(duration?)	Promise<void>	Start stream. duration in ms; 0 or omit for continuous.
tareByCharacteristic()	Promise<void>	Tare via characteristic.
tareByMode()	Promise<void>	Tare via Device Mode (0x05).
threshold(thresholdLbs)	Promise<void>	Set Quick Start threshold (lbs).
temperature()	Promise<string | undefined>	Temperature.
quick(duration?)	Promise<void>	Start Quick Start mode. duration in ms; 0 or omit for indefinite.

See Device interface for shared tare(duration?) and Guide for patterns.

Official API

PitchSix publishes the Force Board GATT specification for direct integration: Force Board Public API v1.0 (PDF). It describes Device Mode, Force, Threshold, and Tare characteristics, streaming and Quick Start workflows, and data packet format.