@hangtime/grip-connect 0.3.5 → 0.3.7

package/dist/data/progressor.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles data received from the Progressor device.
+ * @param {DataView} data - The received data.
+ */
+export declare const handleProgressorData: (data: DataView) => void;

package/dist/data/progressor.js

@@ -0,0 +1,72 @@
+import { notifyCallback } from "./../notify";
+import { applyTare } from "./../tare";
+import { ProgressorCommands, ProgressorResponses } from "./../commands/progressor";
+import { lastWrite } from "./../write";
+import struct from "./../struct";
+import { DownloadPackets } from "./../download";
+// Constants
+let MASS_MAX = "0";
+let MASS_AVERAGE = "0";
+let MASS_TOTAL_SUM = 0;
+let DATAPOINT_COUNT = 0;
+/**
+ * Handles data received from the Progressor device.
+ * @param {DataView} data - The received data.
+ */
+export const handleProgressorData = (data) => {
+    const receivedTime = Date.now();
+    const [kind] = struct("<bb").unpack(data.buffer.slice(0, 2));
+    if (kind === ProgressorResponses.WEIGHT_MEASURE) {
+        const iterable = struct("<fi").iter_unpack(data.buffer.slice(2));
+        // eslint-disable-next-line prefer-const
+        for (let [weight, seconds] of iterable) {
+            if (typeof weight === "number" && !isNaN(weight) && typeof seconds === "number" && !isNaN(seconds)) {
+                // Add data to downloadable Array: sample and mass are the same
+                DownloadPackets.push({
+                    received: receivedTime,
+                    sampleNum: seconds,
+                    battRaw: 0,
+                    samples: [weight],
+                    masses: [weight],
+                });
+                // Tare correction
+                weight -= applyTare(weight);
+                // Check for max weight
+                MASS_MAX = Math.max(Number(MASS_MAX), Number(weight)).toFixed(1);
+                // Update running sum and count
+                const currentMassTotal = Math.max(-1000, Number(weight));
+                MASS_TOTAL_SUM += currentMassTotal;
+                DATAPOINT_COUNT++;
+                // Calculate the average dynamically
+                MASS_AVERAGE = (MASS_TOTAL_SUM / DATAPOINT_COUNT).toFixed(1);
+                notifyCallback({
+                    massMax: MASS_MAX,
+                    massAverage: MASS_AVERAGE,
+                    massTotal: Math.max(-1000, weight).toFixed(1),
+                });
+            }
+        }
+    }
+    else if (kind === ProgressorResponses.COMMAND_RESPONSE) {
+        if (!lastWrite)
+            return;
+        let value = "";
+        if (lastWrite === ProgressorCommands.GET_BATT_VLTG) {
+            const vdd = new DataView(data.buffer, 2).getUint32(0, true);
+            value = `ℹ️ Battery level: ${vdd} mV`;
+        }
+        else if (lastWrite === ProgressorCommands.GET_FW_VERSION) {
+            value = new TextDecoder().decode(data.buffer.slice(2));
+        }
+        else if (lastWrite === ProgressorCommands.GET_ERR_INFO) {
+            value = new TextDecoder().decode(data.buffer.slice(2));
+        }
+        console.log(value);
+    }
+    else if (kind === ProgressorResponses.LOW_BATTERY_WARNING) {
+        console.warn("⚠️ Low power detected. Please consider connecting to a power source.");
+    }
+    else {
+        console.error(`❌ Error: Unknown message kind detected: ${kind}`);
+    }
+};

package/dist/data/wh-c06.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles data received from the WH-C06 device.
+ * @param {DataView} data - The received data.
+ */
+export declare const handleWHC06Data: (data: DataView) => void;

package/dist/data/wh-c06.js

@@ -0,0 +1,35 @@
+import { notifyCallback } from "./../notify";
+import { applyTare } from "./../tare";
+// Constants
+let MASS_MAX = "0";
+let MASS_AVERAGE = "0";
+let MASS_TOTAL_SUM = 0;
+let DATAPOINT_COUNT = 0;
+const WEIGHT_OFFSET = 10;
+// const STABLE_OFFSET = 14
+/**
+ * Handles data received from the WH-C06 device.
+ * @param {DataView} data - The received data.
+ */
+export const handleWHC06Data = (data) => {
+    const weight = (data.getUint8(WEIGHT_OFFSET) << 8) | data.getUint8(WEIGHT_OFFSET + 1);
+    // const stable = (data.getUint8(STABLE_OFFSET) & 0xf0) >> 4
+    // const unit = data.getUint8(STABLE_OFFSET) & 0x0f
+    let numericData = weight / 100;
+    // Tare correction
+    numericData -= applyTare(numericData);
+    // Update MASS_MAX
+    MASS_MAX = Math.max(Number(MASS_MAX), numericData).toFixed(1);
+    // Update running sum and count
+    const currentMassTotal = Math.max(-1000, numericData);
+    MASS_TOTAL_SUM += currentMassTotal;
+    DATAPOINT_COUNT++;
+    // Calculate the average dynamically
+    MASS_AVERAGE = (MASS_TOTAL_SUM / DATAPOINT_COUNT).toFixed(1);
+    // Notify with weight data
+    notifyCallback({
+        massMax: MASS_MAX,
+        massAverage: MASS_AVERAGE,
+        massTotal: Math.max(-1000, numericData).toFixed(1),
+    });
+};

package/dist/devices/climbro.d.ts

@@ -0,0 +1,6 @@
+import type { Device } from "../types/devices";
+/**
+ * Represents a Climbro device
+ * TODO: Add services, do you own a Climbro? Help us!
+ */
+export declare const Climbro: Device;

package/dist/devices/climbro.js

@@ -0,0 +1,8 @@
+/**
+ * Represents a Climbro device
+ * TODO: Add services, do you own a Climbro? Help us!
+ */
+export const Climbro = {
+    filters: [{ name: "Climbro" }],
+    services: [],
+};

package/dist/devices/entralpi.d.ts

@@ -0,0 +1,5 @@
+import type { Device } from "../types/devices";
+/**
+ * Represents a Entralpi device
+ */
+export declare const Entralpi: Device;

package/dist/devices/entralpi.js

@@ -0,0 +1,59 @@
+/**
+ * Represents a Entralpi device
+ */
+export const Entralpi = {
+    filters: [
+        {
+            name: "ENTRALPI",
+        },
+    ],
+    services: [
+        {
+            name: "Device Information",
+            id: "device",
+            uuid: "0000180a-0000-1000-8000-00805f9b34fb",
+            characteristics: [],
+        },
+        {
+            name: "Battery Service",
+            id: "battery",
+            uuid: "0000180f-0000-1000-8000-00805f9b34fb",
+            characteristics: [],
+        },
+        {
+            name: "Generic Attribute",
+            id: "attribute",
+            uuid: "00001801-0000-1000-8000-00805f9b34fb",
+            characteristics: [],
+        },
+        {
+            name: "UART ISSC Transparent Service",
+            id: "uart",
+            uuid: "0000fff0-0000-1000-8000-00805f9b34fb",
+            characteristics: [
+                {
+                    name: "TX",
+                    id: "tx",
+                    uuid: "0000fff5-0000-1000-8000-00805f9b34fb",
+                },
+                {
+                    name: "RX",
+                    id: "rx",
+                    uuid: "0000fff4-0000-1000-8000-00805f9b34fb",
+                },
+            ],
+        },
+        {
+            name: "Weight Scale",
+            id: "weight",
+            uuid: "0000181d-0000-1000-8000-00805f9b34fb",
+            characteristics: [],
+        },
+        {
+            name: "Generic Access",
+            id: "access",
+            uuid: "00001800-0000-1000-8000-00805f9b34fb",
+            characteristics: [],
+        },
+    ],
+};

package/dist/devices/index.d.ts

@@ -0,0 +1,7 @@
+export { Climbro } from "./climbro";
+export { Entralpi } from "./entralpi";
+export { KilterBoard } from "./kilterboard";
+export { Motherboard } from "./motherboard";
+export { mySmartBoard } from "./mysmartboard";
+export { WHC06 } from "./wh-c06";
+export { Progressor } from "./progressor";

package/dist/devices/index.js

@@ -0,0 +1,7 @@
+export { Climbro } from "./climbro";
+export { Entralpi } from "./entralpi";
+export { KilterBoard } from "./kilterboard";
+export { Motherboard } from "./motherboard";
+export { mySmartBoard } from "./mysmartboard";
+export { WHC06 } from "./wh-c06";
+export { Progressor } from "./progressor";

package/dist/devices/kilterboard.d.ts

@@ -0,0 +1,6 @@
+import type { Device } from "../types/devices";
+/**
+ * Represents a Aurora Climbing device
+ * Kilter Board, Tension Board, Decoy Board, Touchstone Board, Grasshopper Board, Aurora Board, So iLL Board
+ */
+export declare const KilterBoard: Device;

package/dist/devices/kilterboard.js

@@ -0,0 +1,30 @@
+/**
+ * Represents a Aurora Climbing device
+ * Kilter Board, Tension Board, Decoy Board, Touchstone Board, Grasshopper Board, Aurora Board, So iLL Board
+ */
+export const KilterBoard = {
+    filters: [
+        {
+            services: ["4488b571-7806-4df6-bcff-a2897e4953ff"], // Aurora Climbing Advertising service
+        },
+    ],
+    services: [
+        {
+            name: "UART Nordic Service",
+            id: "uart",
+            uuid: "6e400001-b5a3-f393-e0a9-e50e24dcca9e",
+            characteristics: [
+                {
+                    name: "TX",
+                    id: "tx",
+                    uuid: "6e400002-b5a3-f393-e0a9-e50e24dcca9e",
+                },
+                // {
+                //   name: "RX",
+                //   id: "rx",
+                //   uuid: "6e400003-b5a3-f393-e0a9-e50e24dcca9e",
+                // },
+            ],
+        },
+    ],
+};

package/dist/devices/motherboard.d.ts

@@ -0,0 +1,5 @@
+import type { Device } from "../types/devices";
+/**
+ * Represents a Griptonite Motherboard device
+ */
+export declare const Motherboard: Device;

package/dist/devices/motherboard.js

@@ -0,0 +1,81 @@
+/**
+ * Represents a Griptonite Motherboard device
+ */
+export const Motherboard = {
+    filters: [{ name: "Motherboard" }],
+    services: [
+        {
+            name: "Device Information",
+            id: "device",
+            uuid: "0000180a-0000-1000-8000-00805f9b34fb",
+            characteristics: [
+                // {
+                //     name: 'Serial Number (Blocked)',
+                //     id: 'serial'
+                //     uuid: '00002a25-0000-1000-8000-00805f9b34fb'
+                // },
+                {
+                    name: "Firmware Revision",
+                    id: "firmware",
+                    uuid: "00002a26-0000-1000-8000-00805f9b34fb",
+                },
+                {
+                    name: "Hardware Revision",
+                    id: "hardware",
+                    uuid: "00002a27-0000-1000-8000-00805f9b34fb",
+                },
+                {
+                    name: "Manufacturer Name",
+                    id: "manufacturer",
+                    uuid: "00002a29-0000-1000-8000-00805f9b34fb",
+                },
+            ],
+        },
+        {
+            name: "Battery Service",
+            id: "battery",
+            uuid: "0000180f-0000-1000-8000-00805f9b34fb",
+            characteristics: [
+                {
+                    name: "Battery Level",
+                    id: "level",
+                    uuid: "00002a19-0000-1000-8000-00805f9b34fb",
+                },
+            ],
+        },
+        {
+            name: "LED Service",
+            id: "led",
+            uuid: "10ababcd-15e1-28ff-de13-725bea03b127",
+            characteristics: [
+                {
+                    name: "Red LED",
+                    id: "red",
+                    uuid: "10ab1524-15e1-28ff-de13-725bea03b127",
+                },
+                {
+                    name: "Green LED",
+                    id: "green",
+                    uuid: "10ab1525-15e1-28ff-de13-725bea03b127",
+                },
+            ],
+        },
+        {
+            name: "UART Nordic Service",
+            id: "uart",
+            uuid: "6e400001-b5a3-f393-e0a9-e50e24dcca9e",
+            characteristics: [
+                {
+                    name: "TX",
+                    id: "tx",
+                    uuid: "6e400002-b5a3-f393-e0a9-e50e24dcca9e",
+                },
+                {
+                    name: "RX",
+                    id: "rx",
+                    uuid: "6e400003-b5a3-f393-e0a9-e50e24dcca9e",
+                },
+            ],
+        },
+    ],
+};

package/dist/devices/mysmartboard.d.ts

@@ -0,0 +1,6 @@
+import type { Device } from "../types/devices";
+/**
+ * Represents a mySmartBoard device
+ * TODO: Add services, do you own a mySmartBoard? Help us!
+ */
+export declare const mySmartBoard: Device;

package/dist/devices/mysmartboard.js

@@ -0,0 +1,8 @@
+/**
+ * Represents a mySmartBoard device
+ * TODO: Add services, do you own a mySmartBoard? Help us!
+ */
+export const mySmartBoard = {
+    filters: [{ name: "mySmartBoard" }],
+    services: [],
+};

package/dist/devices/progressor.d.ts

@@ -0,0 +1,5 @@
+import type { Device } from "../types/devices";
+/**
+ * Represents a Tindeq Progressor device
+ */
+export declare const Progressor: Device;

package/dist/devices/progressor.js

@@ -0,0 +1,37 @@
+/**
+ * Represents a Tindeq Progressor device
+ */
+export const Progressor = {
+    filters: [{ namePrefix: "Progressor" }],
+    services: [
+        {
+            name: "Progressor Service",
+            id: "progressor",
+            uuid: "7e4e1701-1ea6-40c9-9dcc-13d34ffead57",
+            characteristics: [
+                {
+                    name: "Notify",
+                    id: "rx",
+                    uuid: "7e4e1702-1ea6-40c9-9dcc-13d34ffead57",
+                },
+                {
+                    name: "Write",
+                    id: "tx",
+                    uuid: "7e4e1703-1ea6-40c9-9dcc-13d34ffead57",
+                },
+            ],
+        },
+        {
+            name: "Nordic Device Firmware Update (DFU) Service",
+            id: "dfu",
+            uuid: "0000fe59-0000-1000-8000-00805f9b34fb",
+            characteristics: [
+                {
+                    name: "Buttonless DFU",
+                    id: "dfu",
+                    uuid: "8ec90003-f315-4f60-9fb8-838830daea50",
+                },
+            ],
+        },
+    ],
+};

package/dist/devices/wh-c06.d.ts

@@ -0,0 +1,6 @@
+import type { Device } from "../types/devices";
+/**
+ * Represents a  Weiheng - WH-C06 (or MAT Muscle Meter) device
+ * Enable 'Experimental Web Platform features' Chrome Flags.
+ */
+export declare const WHC06: Device;

package/dist/devices/wh-c06.js

@@ -0,0 +1,17 @@
+/**
+ * Represents a  Weiheng - WH-C06 (or MAT Muscle Meter) device
+ * Enable 'Experimental Web Platform features' Chrome Flags.
+ */
+export const WHC06 = {
+    filters: [
+        {
+            // namePrefix: "IF_B7",
+            manufacturerData: [
+                {
+                    companyIdentifier: 0x0100, // 256
+                },
+            ],
+        },
+    ],
+    services: [],
+};

package/dist/disconnect.d.ts

@@ -0,0 +1,6 @@
+import type { Device } from "./types/devices";
+/**
+ * Disconnects the device if it is connected.
+ * @param {Device} board - The device to disconnect.
+ */
+export declare const disconnect: (board: Device) => void;

package/dist/disconnect.js

@@ -0,0 +1,12 @@
+import { isConnected } from "./is-connected";
+/**
+ * Disconnects the device if it is connected.
+ * @param {Device} board - The device to disconnect.
+ */
+export const disconnect = (board) => {
+    // Check if the device is connected
+    if (isConnected(board)) {
+        // Disconnect the device using optional chaining
+        board.device?.gatt?.disconnect();
+    }
+};

package/dist/download.d.ts

@@ -0,0 +1,10 @@
+import type { DownloadPacket } from "./types/download";
+/**
+ * Array of DownloadPacket entries.
+ */
+export declare const DownloadPackets: DownloadPacket[];
+export declare const emptyDownloadPackets: () => void;
+/**
+ * Exports the data as a CSV file.
+ */
+export declare const download: () => void;

package/dist/download.js

@@ -0,0 +1,50 @@
+/**
+ * Array of DownloadPacket entries.
+ */
+export const DownloadPackets = []; // Initialize an empty array of DownloadPacket entries
+// Function to empty DownloadPackets array
+export const emptyDownloadPackets = () => {
+    DownloadPackets.length = 0; // Set the length of the array to 0 to empty it
+};
+/**
+ * Converts an array of DownloadPacket objects to a CSV string.
+ * @param data - Array of DownloadPacket objects.
+ * @returns CSV string representation of the data.
+ */
+const packetsToCSV = (data) => {
+    return data
+        .map((packet) => [
+        packet.received.toString(),
+        packet.sampleNum.toString(),
+        packet.battRaw.toString(),
+        ...packet.samples.map(String),
+        ...packet.masses.map(String),
+    ]
+        .map((v) => v.replace(/"/g, '""'))
+        .map((v) => `"${v}"`)
+        .join(","))
+        .join("\r\n");
+};
+/**
+ * Exports the data as a CSV file.
+ */
+export const download = () => {
+    // Generate CSV string from DownloadPackets array
+    const csvContent = packetsToCSV(DownloadPackets);
+    // Create a Blob object containing the CSV data
+    const blob = new Blob([csvContent], { type: "text/csv" });
+    // Create a URL for the Blob
+    const url = window.URL.createObjectURL(blob);
+    // Create a link element
+    const link = document.createElement("a");
+    // Set link attributes
+    link.href = url;
+    link.setAttribute("download", "data.csv");
+    // Append link to document body
+    document.body.appendChild(link);
+    // Programmatically click the link to trigger the download
+    link.click();
+    // Clean up: remove the link and revoke the URL
+    document.body.removeChild(link);
+    window.URL.revokeObjectURL(url);
+};

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { Climbro, Entralpi, KilterBoard, Motherboard, mySmartBoard, WHC06, Progressor } from "./devices/index";
+export { battery } from "./battery";
+export { calibration } from "./calibration";
+export { download } from "./download";
+export { connect } from "./connect";
+export { disconnect } from "./disconnect";
+export { isConnected } from "./is-connected";
+export { info } from "./info";
+export { led } from "./led";
+export { notify } from "./notify";
+export { stop } from "./stop";
+export { stream } from "./stream";
+export { tare } from "./tare";

package/dist/index.js

@@ -0,0 +1,22 @@
+// Export device types
+export { Climbro, Entralpi, KilterBoard, Motherboard, mySmartBoard, WHC06, Progressor } from "./devices/index";
+// Export battery related functions
+export { battery } from "./battery";
+// Export calibration function
+export { calibration } from "./calibration";
+// Export download function
+export { download } from "./download";
+// Export connection related functions
+export { connect } from "./connect";
+export { disconnect } from "./disconnect";
+export { isConnected } from "./is-connected";
+// Export information retrieval function
+export { info } from "./info";
+// Export led retrieval function
+export { led } from "./led";
+// Export notification related function
+export { notify } from "./notify";
+// Export stream related functions
+export { stop } from "./stop";
+export { stream } from "./stream";
+export { tare } from "./tare";

package/dist/info.d.ts

@@ -0,0 +1,7 @@
+import type { Device } from "./types/devices";
+/**
+ * Retrieves device information.
+ * @param {Device} board - The device to retrieve information from.
+ * @returns {Promise<void>} A promise that resolves when the information retrieval is completed.
+ */
+export declare const info: (board: Device) => Promise<void>;

package/dist/info.js

@@ -0,0 +1,30 @@
+import { write } from "./write";
+import { read } from "./read";
+import { isConnected } from "./is-connected";
+import { Motherboard, Progressor } from "./devices";
+import { MotherboardCommands, ProgressorCommands } from "./commands";
+/**
+ * Retrieves device information.
+ * @param {Device} board - The device to retrieve information from.
+ * @returns {Promise<void>} A promise that resolves when the information retrieval is completed.
+ */
+export const info = async (board) => {
+    if (isConnected(board)) {
+        if (board.filters.some((filter) => filter.name === "Motherboard")) {
+            // Read manufacturer information
+            await read(Motherboard, "device", "manufacturer", 250);
+            // Read hardware version
+            await read(Motherboard, "device", "hardware", 250);
+            // Read firmware version
+            await read(Motherboard, "device", "firmware", 250);
+            // Get text from Motherboard
+            await write(Motherboard, "uart", "tx", MotherboardCommands.GET_TEXT, 250);
+            // Get serial number from Motherboard
+            await write(Motherboard, "uart", "tx", MotherboardCommands.GET_SERIAL, 250);
+        }
+        if (board.filters.some((filter) => filter.namePrefix === "Progressor")) {
+            // Get firmware version from Progressor
+            await write(Progressor, "progressor", "tx", ProgressorCommands.GET_FW_VERSION, 250);
+        }
+    }
+};

package/dist/is-connected.d.ts

@@ -0,0 +1,7 @@
+import type { Device } from "./types/devices";
+/**
+ * Checks if a Bluetooth device is connected.
+ * @param {Device} board - The device to check for connection.
+ * @returns {boolean} A boolean indicating whether the device is connected.
+ */
+export declare const isConnected: (board?: Device) => boolean;

package/dist/is-connected.js

@@ -0,0 +1,13 @@
+/**
+ * Checks if a Bluetooth device is connected.
+ * @param {Device} board - The device to check for connection.
+ * @returns {boolean} A boolean indicating whether the device is connected.
+ */
+export const isConnected = (board) => {
+    // Check if the device is defined and available
+    if (!board?.device) {
+        return false;
+    }
+    // Check if the device is connected
+    return !!board.device.gatt?.connected;
+};

package/dist/led.d.ts

@@ -0,0 +1,20 @@
+import type { Device } from "./types/devices";
+declare class ClimbPlacement {
+    position: number;
+    role_id: string;
+    constructor(position: number, role_id: string);
+}
+/**
+ * Prepares byte arrays for transmission based on a list of climb placements.
+ * @param climbPlacementList - The list of climb placements containing position and role ID.
+ * @returns The final byte array ready for transmission.
+ */
+export declare function prepBytesV3(climbPlacementList: ClimbPlacement[]): number[];
+/**
+ * Sets the LEDs on the specified device.
+ * @param {Device} board - The device on which to set the LEDs.
+ * @param {ClimbPlacement[]} [placement] - An optional array of climb placements for LED positioning.
+ * @returns {Promise<number[] | undefined>} A promise that resolves with the payload array if LED settings were applied, or `undefined` if no action was taken.
+ */
+export declare const led: (board: Device, placement?: ClimbPlacement[]) => Promise<number[] | undefined>;
+export {};