ultimatedarktower 1.0.0

package/dist/src/udtHelpers.d.ts

@@ -0,0 +1,82 @@
+import { type TowerState } from './udtTowerState';
+/**
+ * Converts battery voltage in millivolts to percentage number (0-100).
+ * @param mv - Battery voltage in millivolts
+ * @returns Battery percentage as number (0-100)
+ */
+export declare function milliVoltsToPercentageNumber(mv: number): number;
+/**
+ * Converts battery voltage in millivolts to percentage.
+ * Tower returns sum total battery level in millivolts for all batteries.
+ * @param mv - Battery voltage in millivolts
+ * @returns Battery percentage as formatted string (e.g., "75%")
+ */
+export declare function milliVoltsToPercentage(mv: number): string;
+/**
+ * Extracts battery voltage in millivolts from a tower battery response.
+ * @param {Uint8Array} command - Battery response packet from tower
+ * @returns {number} Battery voltage in millivolts
+ */
+export declare function getMilliVoltsFromTowerResponse(command: Uint8Array): number;
+/**
+ * Converts a command packet to a hex string representation for debugging.
+ * @param {Uint8Array} command - Command packet to convert
+ * @returns {string} Hex string representation of the command packet
+ */
+export declare function commandToPacketString(command: Uint8Array): string;
+/**
+ * Utility function to get the tower position and direction for a given layer and light index
+ * Updated based on LED channel lookup table and corrected architecture:
+ * - Layers 0-2: Ring LEDs with cardinal directions (N,E,S,W)
+ * - Layers 3-5: Ledge/Base LEDs with ordinal directions (NE,SE,SW,NW)
+ * @param layerIndex - The layer index (0-5)
+ * @param lightIndex - The light index within the layer (0-3)
+ * @returns Object containing the tower level, direction, and LED channel
+ */
+export declare function getTowerPosition(layerIndex: number, lightIndex: number): {
+    level: string;
+    direction: string;
+    ledChannel?: number;
+};
+/**
+ * Utility function to get all active lights in a tower state
+ * @param state - The tower state object
+ * @returns Array of objects describing each active light
+ */
+export declare function getActiveLights(state: TowerState): Array<{
+    level: string;
+    direction: string;
+    effect: number;
+    loop: boolean;
+}>;
+/**
+ * Interface for parsed differential readings
+ */
+export interface ParsedDifferentialReadings {
+    irBeam: number;
+    drum1: number;
+    drum2: number;
+    drum3: number;
+    timestamp: number;
+    rawData: Uint8Array;
+}
+/**
+ * Parses a tower response containing differential readings into individual components.
+ * The firmware packs 4 differential readings into a 32-bit value and transmits as bytes:
+ * - Firmware: (signals_smoothed[0] << 24) | (signals_smoothed[1] << 16) | (signals_smoothed[2] << 8) | signals_smoothed[3]
+ * - signals_smoothed[0] = IR beam (drop sensor)
+ * - signals_smoothed[1] = Drum 1 (top)
+ * - signals_smoothed[2] = Drum 2 (middle)
+ * - signals_smoothed[3] = Drum 3 (bottom)
+ *
+ * Transmitted as: [cmd_byte][IR_beam][drum1][drum2][drum3]
+ *
+ * @param response - Tower response packet (should be MESSAGE_DIFFERENTIAL_READINGS with command value 6)
+ * @returns Parsed differential readings or null if not a valid differential response
+ */
+export declare function parseDifferentialReadings(response: Uint8Array): ParsedDifferentialReadings | null;
+/**
+ * Creates a default/empty tower state with all settings reset to defaults
+ * @returns A default TowerState object with all lights off, no audio, etc.
+ */
+export declare function createDefaultTowerState(): TowerState;

package/dist/src/udtHelpers.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultTowerState = exports.parseDifferentialReadings = exports.getActiveLights = exports.getTowerPosition = exports.commandToPacketString = exports.getMilliVoltsFromTowerResponse = exports.milliVoltsToPercentage = exports.milliVoltsToPercentageNumber = void 0;
+const udtConstants_1 = require("./udtConstants");
+/**
+ * Internal function to calculate battery percentage from millivolts.
+ * @param mv - Battery voltage in millivolts
+ * @returns Battery percentage as number (0-100)
+ */
+function calculateBatteryPercentage(mv) {
+    const batLevel = mv ? mv / 3 : 0; // lookup is based on single AA
+    const levels = udtConstants_1.VOLTAGE_LEVELS.filter(v => batLevel >= v);
+    return levels.length * 5;
+}
+/**
+ * Converts battery voltage in millivolts to percentage number (0-100).
+ * @param mv - Battery voltage in millivolts
+ * @returns Battery percentage as number (0-100)
+ */
+function milliVoltsToPercentageNumber(mv) {
+    return calculateBatteryPercentage(mv);
+}
+exports.milliVoltsToPercentageNumber = milliVoltsToPercentageNumber;
+/**
+ * Converts battery voltage in millivolts to percentage.
+ * Tower returns sum total battery level in millivolts for all batteries.
+ * @param mv - Battery voltage in millivolts
+ * @returns Battery percentage as formatted string (e.g., "75%")
+ */
+function milliVoltsToPercentage(mv) {
+    return `${calculateBatteryPercentage(mv)}%`;
+}
+exports.milliVoltsToPercentage = milliVoltsToPercentage;
+/**
+ * Extracts battery voltage in millivolts from a tower battery response.
+ * @param {Uint8Array} command - Battery response packet from tower
+ * @returns {number} Battery voltage in millivolts
+ */
+function getMilliVoltsFromTowerResponse(command) {
+    const mv = new Uint8Array(4);
+    mv[0] = command[4];
+    mv[1] = command[3];
+    mv[2] = 0;
+    mv[3] = 0;
+    const view = new DataView(mv.buffer, 0);
+    return view.getUint32(0, true);
+}
+exports.getMilliVoltsFromTowerResponse = getMilliVoltsFromTowerResponse;
+/**
+ * Converts a command packet to a hex string representation for debugging.
+ * @param {Uint8Array} command - Command packet to convert
+ * @returns {string} Hex string representation of the command packet
+ */
+function commandToPacketString(command) {
+    if (command.length === 0) {
+        return "[]";
+    }
+    let cmdStr = "[";
+    command.forEach(n => cmdStr += n.toString(16) + ",");
+    cmdStr = cmdStr.slice(0, -1) + "]";
+    return cmdStr;
+}
+exports.commandToPacketString = commandToPacketString;
+/**
+ * Utility function to get the tower position and direction for a given layer and light index
+ * Updated based on LED channel lookup table and corrected architecture:
+ * - Layers 0-2: Ring LEDs with cardinal directions (N,E,S,W)
+ * - Layers 3-5: Ledge/Base LEDs with ordinal directions (NE,SE,SW,NW)
+ * @param layerIndex - The layer index (0-5)
+ * @param lightIndex - The light index within the layer (0-3)
+ * @returns Object containing the tower level, direction, and LED channel
+ */
+function getTowerPosition(layerIndex, lightIndex) {
+    const isRingLayer = layerIndex <= 2;
+    const ledChannel = udtConstants_1.LED_CHANNEL_LOOKUP[layerIndex * 4 + lightIndex];
+    if (isRingLayer) {
+        // Ring layers: cardinal directions (position 0 = North)
+        const directions = ['NORTH', 'EAST', 'SOUTH', 'WEST'];
+        const layerNames = ['TOP_RING', 'MIDDLE_RING', 'BOTTOM_RING'];
+        return {
+            level: layerNames[layerIndex],
+            direction: directions[lightIndex],
+            ledChannel
+        };
+    }
+    else {
+        // Ledge/Base layers: ordinal directions (position 0 = North-East)
+        const directions = ['NORTH_EAST', 'SOUTH_EAST', 'SOUTH_WEST', 'NORTH_WEST'];
+        const layerNames = ['LEDGE', 'BASE1', 'BASE2'];
+        return {
+            level: layerNames[layerIndex - 3],
+            direction: directions[lightIndex],
+            ledChannel
+        };
+    }
+}
+exports.getTowerPosition = getTowerPosition;
+/**
+ * Utility function to get all active lights in a tower state
+ * @param state - The tower state object
+ * @returns Array of objects describing each active light
+ */
+function getActiveLights(state) {
+    const activeLights = [];
+    state.layer.forEach((layer, layerIndex) => {
+        layer.light.forEach((light, lightIndex) => {
+            if (light.effect > 0) {
+                const position = getTowerPosition(layerIndex, lightIndex);
+                activeLights.push({
+                    level: position.level,
+                    direction: position.direction,
+                    effect: light.effect,
+                    loop: light.loop
+                });
+            }
+        });
+    });
+    return activeLights;
+}
+exports.getActiveLights = getActiveLights;
+/**
+ * Parses a tower response containing differential readings into individual components.
+ * The firmware packs 4 differential readings into a 32-bit value and transmits as bytes:
+ * - Firmware: (signals_smoothed[0] << 24) | (signals_smoothed[1] << 16) | (signals_smoothed[2] << 8) | signals_smoothed[3]
+ * - signals_smoothed[0] = IR beam (drop sensor)
+ * - signals_smoothed[1] = Drum 1 (top)
+ * - signals_smoothed[2] = Drum 2 (middle)
+ * - signals_smoothed[3] = Drum 3 (bottom)
+ *
+ * Transmitted as: [cmd_byte][IR_beam][drum1][drum2][drum3]
+ *
+ * @param response - Tower response packet (should be MESSAGE_DIFFERENTIAL_READINGS with command value 6)
+ * @returns Parsed differential readings or null if not a valid differential response
+ */
+function parseDifferentialReadings(response) {
+    // Check if this is a differential readings response (command value 6)
+    if (response.length < 5 || response[0] !== 6) {
+        return null;
+    }
+    // Based on debug output, the packet format is: [cmd][unknown/saturated][drum1][drum2][drum3]
+    // The 0xff (255) in byte 1 appears to be either a saturated value or different data
+    // The actual drum readings are in bytes 2, 3, 4 matching your log data
+    // Looking at your data pattern: "D1: 2, D2: 0, D3: 0" matches bytes [0x02, 0x00, 0x00]
+    // This suggests the IR beam might be calculated differently or is in a different position
+    // For now, let's extract what we can identify from the pattern:
+    const drum1 = response[2]; // Drum 1 - matches your "D1: 2" 
+    const drum2 = response[3]; // Drum 2 - matches your "D2: 0"
+    const drum3 = response[4]; // Drum 3 - matches your "D3: 0"
+    // The IR beam (drop sensor) might be derived differently or require calibration
+    // For now, we'll use byte 1 but this needs further investigation
+    const irBeam = response[1]; // This is the 255 value - might be saturated/inverted
+    return {
+        irBeam,
+        drum1,
+        drum2,
+        drum3,
+        timestamp: Date.now(),
+        rawData: new Uint8Array(response)
+    };
+}
+exports.parseDifferentialReadings = parseDifferentialReadings;
+/**
+ * Creates a default/empty tower state with all settings reset to defaults
+ * @returns A default TowerState object with all lights off, no audio, etc.
+ */
+function createDefaultTowerState() {
+    return {
+        drum: [
+            { jammed: false, calibrated: false, position: 0, playSound: false, reverse: false },
+            { jammed: false, calibrated: false, position: 0, playSound: false, reverse: false },
+            { jammed: false, calibrated: false, position: 0, playSound: false, reverse: false }
+        ],
+        layer: [
+            { light: [{ effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }] },
+            { light: [{ effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }] },
+            { light: [{ effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }] },
+            { light: [{ effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }] },
+            { light: [{ effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }] },
+            { light: [{ effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }, { effect: 0, loop: false }] }
+        ],
+        audio: { sample: 0, loop: false, volume: 0 },
+        beam: { count: 0, fault: false },
+        led_sequence: 0
+    };
+}
+exports.createDefaultTowerState = createDefaultTowerState;
+//# sourceMappingURL=udtHelpers.js.map

package/dist/src/udtHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"udtHelpers.js","sourceRoot":"","sources":["../../src/udtHelpers.ts"],"names":[],"mappings":"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"}

package/dist/src/udtLogger.d.ts

@@ -0,0 +1,76 @@
+import type { TowerState } from './udtTowerState';
+export type LogLevel = 'all' | 'debug' | 'info' | 'warn' | 'error';
+export interface LogOutput {
+    write(level: LogLevel, message: string, timestamp: Date): void;
+}
+export declare class ConsoleOutput implements LogOutput {
+    write(level: LogLevel, message: string): void;
+}
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+}
+export declare class BufferOutput implements LogOutput {
+    private buffer;
+    private maxEntries;
+    private clearCount;
+    constructor(maxEntries?: number, clearCount?: number);
+    write(level: LogLevel, message: string, timestamp: Date): void;
+    getBuffer(): LogEntry[];
+    getBufferSize(): number;
+    clearBuffer(): void;
+    getEntriesByLevel(level: LogLevel): LogEntry[];
+    getEntriesSince(timestamp: Date): LogEntry[];
+}
+export declare class DOMOutput implements LogOutput {
+    private container;
+    private maxLines;
+    private allEntries;
+    constructor(containerId: string, maxLines?: number);
+    write(level: LogLevel, message: string, timestamp: Date): void;
+    private refreshDisplay;
+    private getEnabledLevelsFromCheckboxes;
+    private getTextFilter;
+    private updateBufferSizeDisplay;
+    refreshFilter(): void;
+    clearAll(): void;
+    getEntryCount(): number;
+    getEnabledLevels(): string[];
+    debugEntries(): void;
+}
+export declare class Logger {
+    private outputs;
+    private enabledLevels;
+    private static instance;
+    constructor();
+    static getInstance(): Logger;
+    addOutput(output: LogOutput): void;
+    setMinLevel(level: LogLevel): void;
+    setEnabledLevels(levels: LogLevel[]): void;
+    enableLevel(level: LogLevel): void;
+    disableLevel(level: LogLevel): void;
+    getEnabledLevels(): LogLevel[];
+    private shouldLog;
+    private log;
+    debug(message: string, context?: string): void;
+    info(message: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    error(message: string, context?: string): void;
+    /**
+     * Logs tower state changes with detailed information about what changed.
+     * @param oldState - The previous tower state
+     * @param newState - The new tower state
+     * @param source - Source identifier for the update (e.g., "sendTowerState", "tower response")
+     * @param enableDetailedLogging - Whether to include detailed change descriptions
+     */
+    logTowerStateChange(oldState: TowerState, newState: TowerState, source: string, enableDetailedLogging?: boolean): void;
+    /**
+     * Computes the differences between two tower states for logging purposes.
+     * @param oldState - The previous tower state
+     * @param newState - The new tower state
+     * @returns Array of human-readable change descriptions
+     */
+    private computeStateChanges;
+}
+export declare const logger: Logger;