Grip Connect

Force-Sensing Climbing Training

The objective of this project is to create a Web Bluetooth API client that can establish connections with various Force-Sensing Hangboards / Dynamometers / Plates / LED system boards used by climbers. Examples of such tools include the Griptonite Motherboard, Tindeq Progressor, PitchSix Force Board, Weiheng WH-C06, Entralpi, Climbro, or mySmartBoard

And LED system boards from Aurora Climbing like the Kilter Board, Tension Board, Grasshopper Board, Decoy Board, Touchstone Board and So iLL Board.

Learn more: Docs - Browser Support

This project is provided "as-is" without any express or implied warranties. By using this software, you assume all risks associated with its use, including but not limited to hardware damage, data loss, or any other issues that may arise. The developers and contributors are not responsible for any harm or loss incurred. Use this software at your own discretion and responsibility.

Try it out

Chart - Flappy Bird - Kilter Board

Install

This project can be found in the NPM package registry.

$ npm install @hangtime/grip-connect

Example usage (with a Motherboard)

Simply importing the utilities you need from @hangtime/grip-connect.

<button id="motherboard" type="button">Connect Motherboard</button>

import { Motherboard, active, battery, connect, disconnect, firmware, notify, stream } from "@hangtime/grip-connect"

const motherboardButton = document.querySelector("#motherboard")

motherboardButton.addEventListener("click", () => {
  connect(
    Motherboard,
    async () => {
      // Listen for stream notifications
      notify((data) => {
        // { massTotal: "0", massMax: "0", massAverage: "0", massLeft: "0", massCenter: "0", massRight: "0" }
        console.log(data)
      })

      // Reactive check if device is active
      active(
        (isActive) => {
          console.log(isActive)
        },
        // Optionally using a weight threshold and duration
        { threshold: 2.5, duration: 1000 },
      )

      // Read info: battery + firmware
      const batteryLevel = await battery(Motherboard)
      console.log(batteryLevel)

      const firmwareVersion = await firmware(Motherboard)
      console.log(firmwareVersion)

      // LEDs: "green", "red", "orange", or no argument to turn off
      // await led(Motherboard, "red")
      // await led(Motherboard)

      // Start weight streaming (for a minute) remove parameter for a continues stream
      await stream(Motherboard, 60000)

      // Manualy tare the device when the stream is running
      // await tare(5000)

      // Manually call stop method if stream is continues
      // await stop(Motherboard)

      // Download data as CSV, JSON, or XML (default: CSV) format => timestamp, frame, battery, samples, masses
      // download('json')

      // Disconnect from device after we are done
      disconnect(Motherboard)
    },
    (error) => {
      // Optinal custom error handeling
      console.error(error.message)
    },
  )
})

Device support

✅ Griptonite - Motherboard
✅ Tindeq - Progressor
✅ Weiheng - WH-C06
- By default watchAdvertisements isn't supported . For Chrome, enable it at chrome://flags/#enable-experimental-web-platform-features.
✅ Kilter Board
⏳ Entralpi
⏳ PitchSix Force Board
➡️ Climbro
➡️ Smartboard Climbing - mySmartBoard

Features

Help wanted: Do you own any of the missing devices? Use Google Chrome's Bluetooth Internals chrome://bluetooth-internals/#devices and press Start Scan to look for your device, click on Inspect and share all available services with us.

	Motherboard	Progressor	WH-C06	Entralpi	Kilter Board
Battery	✅	✅
Calibration	✅
Connect	✅	✅	✅	✅	✅
Disconnect	✅	✅	✅	✅	✅
Download	✅	✅
Firmware	✅	✅
Hardware	✅
isActive	✅	✅	✅	✅
isConnected	✅	✅	✅	✅	✅
isDevice	✅	✅	✅	✅	✅
Led	✅				✅
Manufacturer	✅
Notify	✅	✅	✅	✅
Read	✅
Serial	✅
Stop	✅	✅
Stream	✅	✅
Tare	✅	✅	✅	✅
Text	✅
Write	✅	✅

Development

git clone https://github.com/Stevie-Ray/hangtime-grip-connect
cd hangtime-grip-connect
npm install

Credits

A special thank you to:

@CassimLadha for sharing insights on reading the Motherboards data.
@donaldharvey for a valuable example on connecting to the Motherboard.
@ecstrema for providing examples on how to play games with the Entralpi.
Tindeq for providing an open Progressor API.
@StuartLittlefair for his PyTindeq implementation.
@Phil9l for his research and providing a blog on how to connect with the Kilter Board.
@1-max-1 for the docs on his Kilter Board simulator that I coverted to hangtime-arduino-kilterboard.
@sebws for a code sample of the Weiheng WH-C06 App.

Disclaimer

THIS SOFTWARE IS NOT OFFICIALLY SUPPORTED, SUPPLIED OR MAINTAINED BY THE DEVICE MANUFACTURER. BY USING THE SOFTWARE YOU ARE ACKNOWLEDGING THIS AND UNDERSTAND THAT USING THIS SOFTWARE WILL INVALIDATE THE MANUFACTURERS WARRANTY.

Stevie-Ray / hangtime-grip-connect

readme