@hangtime/grip-connect 0.3.10 → 0.4.0

package/README.md

@@ -46,7 +46,7 @@ Simply importing the utilities you need from `@hangtime/grip-connect`.
 ```
 
 ```js
-import { Motherboard, active, battery, connect, disconnect, info, notify, stream } from "@hangtime/grip-connect"
+import { Motherboard, active, battery, connect, disconnect, firmware, notify, stream } from "@hangtime/grip-connect"
 
 const motherboardButton = document.querySelector("#motherboard")
 
@@ -65,12 +65,15 @@ motherboardButton.addEventListener("click", () => {
         console.log(value)
       })
 
-      // Read battery + device info
-      await battery(Motherboard)
-      await info(Motherboard)
+      // Read info: battery + firmware
+      const batteryLevel = await battery(Motherboard)
+      console.log(batteryLevel)
+
+      const firmwareVersion = await firmware(Motherboard)
+      console.log(firmwareVersion)
 
       // trigger LEDs
-      // await led(device)
+      // await led(Motherboard)
 
       // Start weight streaming (for a minute) remove parameter for a continues stream
       await stream(Motherboard, 60000)
@@ -113,23 +116,27 @@ motherboardButton.addEventListener("click", () => {
 `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 | Climbro | mySmartBoard |
-| --------------------------------------------------------------------------------------- | ----------- | ---------- | ------ | -------- | ------------ | ------- | ------------ |
-| [Battery](https://stevie-ray.github.io/hangtime-grip-connect/api/battery.html)          | ✅          | ✅         |        |          |              |         |              |
-| [Calibration](https://stevie-ray.github.io/hangtime-grip-connect/api/calibration.html)  | ✅          |            |        |          |              |         |              |
-| [Connect](https://stevie-ray.github.io/hangtime-grip-connect/api/connect.html)          | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
-| [Disconnect](https://stevie-ray.github.io/hangtime-grip-connect/api/disconnect.html)    | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
-| [Download](https://stevie-ray.github.io/hangtime-grip-connect/api/download.html)        | ✅          | ✅         |        |          |              |         |              |
-| [Info](https://stevie-ray.github.io/hangtime-grip-connect/api/info.html)                | ✅          | ✅         |        |          |              |         |              |
-| [isActive](https://stevie-ray.github.io/hangtime-grip-connect/api/is-active.html)       | ✅          | ✅         | ✅     | ✅       |              |         |              |
-| [isConnected](https://stevie-ray.github.io/hangtime-grip-connect/api/is-connected.html) | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
-| [Led](https://stevie-ray.github.io/hangtime-grip-connect/api/led.html)                  | ✅          |            |        |          | ✅           |         |              |
-| [Notify](https://stevie-ray.github.io/hangtime-grip-connect/api/notify.html)            | ✅          | ✅         | ✅     | ✅       |              |         |              |
-| [Read](https://stevie-ray.github.io/hangtime-grip-connect/api/read.html)                | ✅          |            |        |          |              |         |              |
-| [Stop](https://stevie-ray.github.io/hangtime-grip-connect/api/stop.html)                | ✅          | ✅         |        |          |              |         |              |
-| [Stream](https://stevie-ray.github.io/hangtime-grip-connect/api/stream.html)            | ✅          | ✅         |        |          |              |         |              |
-| [Tare](https://stevie-ray.github.io/hangtime-grip-connect/api/tare.html)                | ✅          | ✅         | ✅     | ✅       |              |         |              |
-| [Write](https://stevie-ray.github.io/hangtime-grip-connect/api/write.html)              | ✅          | ✅         |        |          |              |         |              |
+|                                                                                          | Motherboard | Progressor | WH-C06 | Entralpi | Kilter Board | Climbro | mySmartBoard |
+| ---------------------------------------------------------------------------------------- | ----------- | ---------- | ------ | -------- | ------------ | ------- | ------------ |
+| [Battery](https://stevie-ray.github.io/hangtime-grip-connect/api/battery.html)           | ✅          | ✅         |        |          |              |         |              |
+| [Calibration](https://stevie-ray.github.io/hangtime-grip-connect/api/calibration.html)   | ✅          |            |        |          |              |         |              |
+| [Connect](https://stevie-ray.github.io/hangtime-grip-connect/api/connect.html)           | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
+| [Disconnect](https://stevie-ray.github.io/hangtime-grip-connect/api/disconnect.html)     | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
+| [Download](https://stevie-ray.github.io/hangtime-grip-connect/api/download.html)         | ✅          | ✅         |        |          |              |         |              |
+| [Firmware](https://stevie-ray.github.io/hangtime-grip-connect/api/firmware.html)         | ✅          | ✅         |        |          |              |         |              |
+| [Hardware](https://stevie-ray.github.io/hangtime-grip-connect/api/hardware.html)         | ✅          |            |        |          |              |         |              |
+| [isActive](https://stevie-ray.github.io/hangtime-grip-connect/api/is-active.html)        | ✅          | ✅         | ✅     | ✅       |              |         |              |
+| [isConnected](https://stevie-ray.github.io/hangtime-grip-connect/api/is-connected.html)  | ✅          | ✅         | ✅     | ✅       | ✅           |         |              |
+| [Led](https://stevie-ray.github.io/hangtime-grip-connect/api/led.html)                   | ✅          |            |        |          | ✅           |         |              |
+| [Manufacturer](https://stevie-ray.github.io/hangtime-grip-connect/api/manufacturer.html) | ✅          |            |        |          |              |         |              |
+| [Notify](https://stevie-ray.github.io/hangtime-grip-connect/api/notify.html)             | ✅          | ✅         | ✅     | ✅       |              |         |              |
+| [Read](https://stevie-ray.github.io/hangtime-grip-connect/api/read.html)                 | ✅          |            |        |          |              |         |              |
+| [Serial](https://stevie-ray.github.io/hangtime-grip-connect/api/serial.html)             | ✅          |            |        |          |              |         |              |
+| [Stop](https://stevie-ray.github.io/hangtime-grip-connect/api/stop.html)                 | ✅          | ✅         |        |          |              |         |              |
+| [Stream](https://stevie-ray.github.io/hangtime-grip-connect/api/stream.html)             | ✅          | ✅         |        |          |              |         |              |
+| [Tare](https://stevie-ray.github.io/hangtime-grip-connect/api/tare.html)                 | ✅          | ✅         | ✅     | ✅       |              |         |              |
+| [Text](https://stevie-ray.github.io/hangtime-grip-connect/api/text.html)                 | ✅          |            |        |          |              |         |              |
+| [Write](https://stevie-ray.github.io/hangtime-grip-connect/api/write.html)               | ✅          | ✅         |        |          |              |         |              |
 
 ## Development
 

package/dist/battery.d.ts

@@ -1,7 +1,12 @@
 import type { Device } from "./types/devices";
 /**
  * Retrieves battery or voltage information from the device.
- * @param {Device} board - The device.
- * @returns {Promise<void>} A Promise that resolves when the information is successfully retrieved.
+ * - For Motherboard devices, it reads the battery level.
+ * - For Progressor devices, it sends a command to retrieve battery voltage information.
+ *
+ * @param {Device} board - The device from which to retrieve battery information.
+ * @returns {Promise<string | undefined>} A Promise that resolves with the battery or voltage information,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
  */
-export declare const battery: (board: Device) => Promise<void>;
+export declare const battery: (board: Device) => Promise<string | undefined>;

package/dist/battery.js

@@ -5,8 +5,13 @@ import { Motherboard, Progressor } from "./devices";
 import { ProgressorCommands } from "./commands";
 /**
  * Retrieves battery or voltage information from the device.
- * @param {Device} board - The device.
- * @returns {Promise<void>} A Promise that resolves when the information is successfully retrieved.
+ * - For Motherboard devices, it reads the battery level.
+ * - For Progressor devices, it sends a command to retrieve battery voltage information.
+ *
+ * @param {Device} board - The device from which to retrieve battery information.
+ * @returns {Promise<string | undefined>} A Promise that resolves with the battery or voltage information,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
  */
 export const battery = async (board) => {
     // Check if the device is connected
@@ -14,12 +19,19 @@ export const battery = async (board) => {
         // If the device is connected and it is a Motherboard device
         if (board.filters.some((filter) => filter.name === "Motherboard")) {
             // Read battery level information from the Motherboard
-            await read(Motherboard, "battery", "level", 250);
+            return await read(Motherboard, "battery", "level", 250);
         }
         // If the device is connected and its name starts with "Progressor"
         if (board.filters.some((filter) => filter.namePrefix === "Progressor")) {
             // Write command to get battery voltage information to the Progressor
-            await write(Progressor, "progressor", "tx", ProgressorCommands.GET_BATT_VLTG, 250);
+            let response = undefined;
+            await write(Progressor, "progressor", "tx", ProgressorCommands.GET_BATT_VLTG, 250, (data) => {
+                response = data;
+            });
+            return response;
         }
+        // If device is not found, return undefined
+        return;
     }
+    throw new Error("Not connected.");
 };

package/dist/calibration.js

@@ -13,7 +13,9 @@ export const calibration = async (board) => {
         // If the device is connected, and it is a Motherboard device
         if (board.filters.some((filter) => filter.name === "Motherboard")) {
             // Write the command to get calibration data to the device
-            await write(Motherboard, "uart", "tx", MotherboardCommands.GET_CALIBRATION, 2500);
+            await write(Motherboard, "uart", "tx", MotherboardCommands.GET_CALIBRATION, 2500, (data) => {
+                console.log(data);
+            });
         }
     }
 };

package/dist/commands/kilterboard.js

@@ -59,7 +59,7 @@ export const KilterBoardPlacementRoles = [
         position: 4,
         name: "foot",
         full_name: "Foot Only",
-        led_color: "FFA500",
+        led_color: "FFB600",
         screen_color: "FFA500",
     },
 ];

package/dist/data/motherboard.d.ts

@@ -1,6 +1,10 @@
 export declare const CALIBRATION: never[][];
 /**
- * Handles data received from the Motherboard device.
- * @param {string} receivedData - The received data string.
+ * Handles data received from the Motherboard device. Processes hex-encoded streaming packets
+ * to extract samples, calibrate masses, and update running averages of mass data.
+ * If the received data is not a valid hex packet, it returns the unprocessed data.
+ *
+ * @param {string} receivedData - The raw data received from the Motherboard device.
+ * @returns {void}
  */
 export declare const handleMotherboardData: (receivedData: string) => void;

package/dist/data/motherboard.js

@@ -1,4 +1,5 @@
 import { notifyCallback } from "./../notify";
+import { writeCallback } from "./../write";
 import { applyTare } from "./../tare";
 import { MotherboardCommands } from "./../commands";
 import { checkActivity } from "./../is-active";
@@ -51,8 +52,12 @@ const applyCalibration = (sample, calibration) => {
     return sign * final;
 };
 /**
- * Handles data received from the Motherboard device.
- * @param {string} receivedData - The received data string.
+ * Handles data received from the Motherboard device. Processes hex-encoded streaming packets
+ * to extract samples, calibrate masses, and update running averages of mass data.
+ * If the received data is not a valid hex packet, it returns the unprocessed data.
+ *
+ * @param {string} receivedData - The raw data received from the Motherboard device.
+ * @returns {void}
  */
 export const handleMotherboardData = (receivedData) => {
     const receivedTime = Date.now();
@@ -131,6 +136,6 @@ export const handleMotherboardData = (receivedData) => {
     }
     else {
         // unhandled data
-        console.log(receivedData);
+        writeCallback(receivedData);
     }
 };

package/dist/data/progressor.d.ts

@@ -1,5 +1,9 @@
 /**
- * Handles data received from the Progressor device.
- * @param {DataView} data - The received data.
+ * Handles data received from the Progressor device, processes weight measurements,
+ * and updates mass data including maximum and average values.
+ * It also handles command responses for retrieving device information.
+ *
+ * @param {DataView} data - The raw binary data received from the Progressor device.
+ * @returns {void}
  */
 export declare const handleProgressorData: (data: DataView) => void;

package/dist/data/progressor.js

@@ -2,7 +2,7 @@ import { notifyCallback } from "./../notify";
 import { applyTare } from "./../tare";
 import { checkActivity } from "./../is-active";
 import { ProgressorCommands, ProgressorResponses } from "./../commands/progressor";
-import { lastWrite } from "./../write";
+import { lastWrite, writeCallback } from "./../write";
 import struct from "./../struct";
 import { DownloadPackets } from "./../download";
 // Constants
@@ -11,8 +11,12 @@ 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.
+ * Handles data received from the Progressor device, processes weight measurements,
+ * and updates mass data including maximum and average values.
+ * It also handles command responses for retrieving device information.
+ *
+ * @param {DataView} data - The raw binary data received from the Progressor device.
+ * @returns {void}
  */
 export const handleProgressorData = (data) => {
     const receivedTime = Date.now();
@@ -55,8 +59,7 @@ export const handleProgressorData = (data) => {
             return;
         let value = "";
         if (lastWrite === ProgressorCommands.GET_BATT_VLTG) {
-            const vdd = new DataView(data.buffer, 2).getUint32(0, true);
-            value = `ℹ️ Battery level: ${vdd} mV`;
+            value = new DataView(data.buffer, 2).getUint32(0, true).toString();
         }
         else if (lastWrite === ProgressorCommands.GET_FW_VERSION) {
             value = new TextDecoder().decode(data.buffer.slice(2));
@@ -64,12 +67,12 @@ export const handleProgressorData = (data) => {
         else if (lastWrite === ProgressorCommands.GET_ERR_INFO) {
             value = new TextDecoder().decode(data.buffer.slice(2));
         }
-        console.log(value);
+        writeCallback(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}`);
+        throw new Error(`Unknown message kind detected: ${kind}`);
     }
 };

package/dist/firmware.d.ts

@@ -0,0 +1,12 @@
+import type { Device } from "./types/devices";
+/**
+ * Retrieves firmware version from the device.
+ * - For Motherboard devices, it reads the firmare version.
+ * - For Progressor devices, it sends a command to retrieve firware version.
+ *
+ * @param {Device} board - The device from which to retrieve firmware version.
+ * @returns {Promise<string>} A Promise that resolves with the firmware version,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export declare const firmware: (board: Device) => Promise<string | undefined>;

package/dist/firmware.js

@@ -0,0 +1,37 @@
+import { write } from "./write";
+import { read } from "./read";
+import { isConnected } from "./is-connected";
+import { Motherboard, Progressor } from "./devices";
+import { ProgressorCommands } from "./commands";
+/**
+ * Retrieves firmware version from the device.
+ * - For Motherboard devices, it reads the firmare version.
+ * - For Progressor devices, it sends a command to retrieve firware version.
+ *
+ * @param {Device} board - The device from which to retrieve firmware version.
+ * @returns {Promise<string>} A Promise that resolves with the firmware version,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export const firmware = async (board) => {
+    // Check if the device is connected
+    if (isConnected(board)) {
+        // If the device is connected and it is a Motherboard device
+        if (board.filters.some((filter) => filter.name === "Motherboard")) {
+            // Read firmware version from the Motherboard
+            return await read(Motherboard, "device", "firmware", 250);
+        }
+        // If the device is connected and its name starts with "Progressor"
+        if (board.filters.some((filter) => filter.namePrefix === "Progressor")) {
+            // Write command to get firmware version information to the Progressor
+            let response = undefined;
+            await write(Progressor, "progressor", "tx", ProgressorCommands.GET_FW_VERSION, 250, (data) => {
+                response = data;
+            });
+            return response;
+        }
+        // If device is not found, return undefined
+        return;
+    }
+    throw new Error("Not connected.");
+};

package/dist/hardware.d.ts

@@ -0,0 +1,11 @@
+import type { Device } from "./types/devices";
+/**
+ * Retrieves hardware version from the device.
+ * - For Motherboard devices, it reads the hardware version.
+ *
+ * @param {Device} board - The device from which to retrieve hardware version.
+ * @returns {Promise<string>} A Promise that resolves with the hardware version,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export declare const hardware: (board: Device) => Promise<string | undefined>;

package/dist/hardware.js

@@ -0,0 +1,25 @@
+import { read } from "./read";
+import { isConnected } from "./is-connected";
+import { Motherboard } from "./devices";
+/**
+ * Retrieves hardware version from the device.
+ * - For Motherboard devices, it reads the hardware version.
+ *
+ * @param {Device} board - The device from which to retrieve hardware version.
+ * @returns {Promise<string>} A Promise that resolves with the hardware version,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export const hardware = async (board) => {
+    // Check if the device is connected
+    if (isConnected(board)) {
+        // If the device is connected and it is a Motherboard device
+        if (board.filters.some((filter) => filter.name === "Motherboard")) {
+            // Read hardware version from the Motherboard
+            return await read(Motherboard, "device", "hardware", 250);
+        }
+        // If device is not found, return undefined
+        return;
+    }
+    throw new Error("Not connected.");
+};

package/dist/index.d.ts

@@ -1,12 +1,16 @@
 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 { active, isActive } from "./is-active";
 export { isConnected } from "./is-connected";
-export { info } from "./info";
+export { battery } from "./battery";
+export { firmware } from "./firmware";
+export { hardware } from "./hardware";
+export { manufacturer } from "./manufacturer";
+export { text } from "./text";
+export { serial } from "./serial";
 export { led } from "./led";
 export { notify } from "./notify";
 export { stop } from "./stop";

package/dist/index.js

@@ -1,7 +1,5 @@
 // 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
@@ -11,8 +9,14 @@ export { connect } from "./connect";
 export { disconnect } from "./disconnect";
 export { active, isActive } from "./is-active";
 export { isConnected } from "./is-connected";
-// Export information retrieval function
-export { info } from "./info";
+// Export information retrieval functions
+export { battery } from "./battery";
+export { firmware } from "./firmware";
+// Export "Motherboard exclusive" functions
+export { hardware } from "./hardware";
+export { manufacturer } from "./manufacturer";
+export { text } from "./text";
+export { serial } from "./serial";
 // Export led retrieval function
 export { led } from "./led";
 // Export notification related function

package/dist/led.js

@@ -181,15 +181,15 @@ export const led = async (board, placement) => {
     if (board.filters.some((filter) => filter.name === "Motherboard")) {
         console.log("Green");
         await write(Motherboard, "led", "red", new Uint8Array([0x00]));
-        await write(Motherboard, "led", "green", new Uint8Array([0x01]), 2500);
+        await write(Motherboard, "led", "green", new Uint8Array([0x01]), 1250);
         console.log("Red");
         await write(Motherboard, "led", "red", new Uint8Array([0x01]));
-        await write(Motherboard, "led", "green", new Uint8Array([0x00]), 2500);
+        await write(Motherboard, "led", "green", new Uint8Array([0x00]), 1250);
         console.log("Orage");
         await write(Motherboard, "led", "red", new Uint8Array([0x01]));
-        await write(Motherboard, "led", "green", new Uint8Array([0x01]), 2500);
+        await write(Motherboard, "led", "green", new Uint8Array([0x01]), 1250);
         console.log("Off");
         await write(Motherboard, "led", "red", new Uint8Array([0x00]));
-        await write(Motherboard, "led", "green", new Uint8Array([0x00]), 2500);
+        await write(Motherboard, "led", "green", new Uint8Array([0x00]), 1250);
     }
 };

package/dist/manufacturer.d.ts

@@ -0,0 +1,11 @@
+import type { Device } from "./types/devices";
+/**
+ * Retrieves manufacturer information from the device.
+ * - For Motherboard devices, it reads the manufacturer information.
+ *
+ * @param {Device} board - The device from which to retrieve manufacturer information.
+ * @returns {Promise<string>} A Promise that resolves with the manufacturer information,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export declare const manufacturer: (board: Device) => Promise<string | undefined>;

package/dist/manufacturer.js

@@ -0,0 +1,25 @@
+import { read } from "./read";
+import { isConnected } from "./is-connected";
+import { Motherboard } from "./devices";
+/**
+ * Retrieves manufacturer information from the device.
+ * - For Motherboard devices, it reads the manufacturer information.
+ *
+ * @param {Device} board - The device from which to retrieve manufacturer information.
+ * @returns {Promise<string>} A Promise that resolves with the manufacturer information,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export const manufacturer = async (board) => {
+    // Check if the device is connected
+    if (isConnected(board)) {
+        // If the device is connected and it is a Motherboard device
+        if (board.filters.some((filter) => filter.name === "Motherboard")) {
+            // Read manufacturer information from the Motherboard
+            return await read(Motherboard, "device", "manufacturer", 250);
+        }
+        // If device is not found, return undefined
+        return;
+    }
+    throw new Error("Not connected.");
+};

package/dist/read.d.ts

@@ -5,6 +5,6 @@ import type { Device } from "./types/devices";
  * @param {string} serviceId - The service ID where the characteristic belongs.
  * @param {string} characteristicId - The characteristic ID to read from.
  * @param {number} [duration=0] - The duration to wait before resolving the promise, in milliseconds.
- * @returns {Promise<void>} A promise that resolves when the read operation is completed.
+ * @returns {Promise<string>} A promise that resolves when the read operation is completed.
  */
-export declare const read: (board: Device, serviceId: string, characteristicId: string, duration?: number) => Promise<void>;
+export declare const read: (board: Device, serviceId: string, characteristicId: string, duration?: number) => Promise<string>;

package/dist/read.js

@@ -6,7 +6,7 @@ import { isConnected } from "./is-connected";
  * @param {string} serviceId - The service ID where the characteristic belongs.
  * @param {string} characteristicId - The characteristic ID to read from.
  * @param {number} [duration=0] - The duration to wait before resolving the promise, in milliseconds.
- * @returns {Promise<void>} A promise that resolves when the read operation is completed.
+ * @returns {Promise<string>} A promise that resolves when the read operation is completed.
  */
 export const read = (board, serviceId, characteristicId, duration = 0) => {
     return new Promise((resolve, reject) => {
@@ -21,17 +21,15 @@ export const read = (board, serviceId, characteristicId, duration = 0) => {
                     switch (characteristicId) {
                         case "level":
                             // TODO: This is Motherboard specific.
-                            decodedValue = value.getUint8(0);
+                            decodedValue = value.getUint8(0).toString();
                             break;
                         default:
                             decodedValue = decoder.decode(value);
                             break;
                     }
-                    // TODO: Create Read callback
-                    console.log(decodedValue);
                     // Resolve after specified duration
                     setTimeout(() => {
-                        resolve();
+                        return resolve(decodedValue);
                     }, duration);
                 })
                     .catch((error) => {

package/dist/serial.d.ts

@@ -0,0 +1,11 @@
+import type { Device } from "./types/devices";
+/**
+ * Retrieves serial number from the device.
+ * - For Motherboard devices, it reads the serial number.
+ *
+ * @param {Device} board - The device from which to retrieve serial number.
+ * @returns {Promise<string>} A Promise that resolves with the serial number,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export declare const serial: (board: Device) => Promise<string | undefined>;

package/dist/serial.js

@@ -0,0 +1,30 @@
+import { write } from "./write";
+import { isConnected } from "./is-connected";
+import { Motherboard } from "./devices";
+import { MotherboardCommands } from "./commands";
+/**
+ * Retrieves serial number from the device.
+ * - For Motherboard devices, it reads the serial number.
+ *
+ * @param {Device} board - The device from which to retrieve serial number.
+ * @returns {Promise<string>} A Promise that resolves with the serial number,
+ *                            or rejects with an error if the device is not connected.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export const serial = async (board) => {
+    // Check if the device is connected
+    if (isConnected(board)) {
+        // If the device is connected and it is a Motherboard device
+        if (board.filters.some((filter) => filter.name === "Motherboard")) {
+            // Write serial number command to the Motherboard and read output
+            let response = undefined;
+            await write(Motherboard, "uart", "tx", MotherboardCommands.GET_SERIAL, 250, (data) => {
+                response = data;
+            });
+            return response;
+        }
+        // If device is not found, return undefined
+        return;
+    }
+    throw new Error("Not connected.");
+};

package/dist/text.d.ts

@@ -0,0 +1,14 @@
+import type { Device } from "./types/devices";
+/**
+ * Retrieves the entire 320 bytes of non-volatile memory from the device.
+ *
+ * The memory consists of 10 segments, each 32 bytes long. If any segment was previously written,
+ * the corresponding data will appear in the response. Unused portions of the memory are
+ * padded with whitespace.
+ *
+ * @param {Device} board - The device from which to retrieve text information.
+ * @returns {Promise<string>} A Promise that resolves with the 320-byte memory content as a string,
+ *                            which includes both the written data and any unused, whitespace-padded segments.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export declare const text: (board: Device) => Promise<string | undefined>;

package/dist/text.js

@@ -0,0 +1,33 @@
+import { write } from "./write";
+import { isConnected } from "./is-connected";
+import { Motherboard } from "./devices";
+import { MotherboardCommands } from "./commands";
+/**
+ * Retrieves the entire 320 bytes of non-volatile memory from the device.
+ *
+ * The memory consists of 10 segments, each 32 bytes long. If any segment was previously written,
+ * the corresponding data will appear in the response. Unused portions of the memory are
+ * padded with whitespace.
+ *
+ * @param {Device} board - The device from which to retrieve text information.
+ * @returns {Promise<string>} A Promise that resolves with the 320-byte memory content as a string,
+ *                            which includes both the written data and any unused, whitespace-padded segments.
+ * @throws {Error} Throws an error if the device is not connected.
+ */
+export const text = async (board) => {
+    // Check if the device is connected
+    if (isConnected(board)) {
+        // If the device is connected and it is a Motherboard device
+        if (board.filters.some((filter) => filter.name === "Motherboard")) {
+            // Write text information command to the Motherboard and read output
+            let response = undefined;
+            await write(Motherboard, "uart", "tx", MotherboardCommands.GET_TEXT, 250, (data) => {
+                response = data;
+            });
+            return response;
+        }
+        // If device is not found, return undefined
+        return;
+    }
+    throw new Error("Not connected.");
+};