@leonardojc/capacitor-ioboard 1.2.8 → 2.0.0

package/dist/esm/definitions.d.ts

@@ -1,4 +1,12 @@
 export interface CapacitorIoboardPlugin {
+    /**
+     * List available serial ports
+     */
+    listPorts(): Promise<{
+        success: boolean;
+        ports: string[];
+        error?: string;
+    }>;
     /**
      * Open serial connection to IOBOARD device
      * @param options Serial connection parameters
@@ -14,6 +22,26 @@ export interface CapacitorIoboardPlugin {
     isConnected(): Promise<{
         connected: boolean;
     }>;
+    /**
+     * Get connection status and device info
+     */
+    getConnectionStatus(): Promise<{
+        success: boolean;
+        isConnected: boolean;
+        deviceInfo?: string;
+        lastError?: string;
+    }>;
+    /**
+     * Send raw command to serial port
+     */
+    sendRawCommand(options: {
+        command: string;
+    }): Promise<{
+        success: boolean;
+        command: string;
+        hexSent?: string;
+        error?: string;
+    }>;
     /**
      * Query the status of an IOBOARD device
      * @param options Device address and timeout

package/dist/esm/index-v2.d.ts

@@ -0,0 +1,266 @@
+import type { CapacitorIoboardPlugin, RGBColor } from './definitions-v2';
+declare const COLOR_PRESETS: {
+    readonly RED: {
+        readonly red: 255;
+        readonly green: 0;
+        readonly blue: 0;
+    };
+    readonly GREEN: {
+        readonly red: 0;
+        readonly green: 255;
+        readonly blue: 0;
+    };
+    readonly BLUE: {
+        readonly red: 0;
+        readonly green: 0;
+        readonly blue: 255;
+    };
+    readonly YELLOW: {
+        readonly red: 255;
+        readonly green: 255;
+        readonly blue: 0;
+    };
+    readonly MAGENTA: {
+        readonly red: 255;
+        readonly green: 0;
+        readonly blue: 255;
+    };
+    readonly CYAN: {
+        readonly red: 0;
+        readonly green: 255;
+        readonly blue: 255;
+    };
+    readonly WHITE: {
+        readonly red: 255;
+        readonly green: 255;
+        readonly blue: 255;
+    };
+    readonly OFF: {
+        readonly red: 0;
+        readonly green: 0;
+        readonly blue: 0;
+    };
+    readonly ORANGE: {
+        readonly red: 255;
+        readonly green: 165;
+        readonly blue: 0;
+    };
+    readonly PURPLE: {
+        readonly red: 128;
+        readonly green: 0;
+        readonly blue: 128;
+    };
+    readonly PINK: {
+        readonly red: 255;
+        readonly green: 192;
+        readonly blue: 203;
+    };
+    readonly LIME: {
+        readonly red: 50;
+        readonly green: 205;
+        readonly blue: 50;
+    };
+};
+declare const CapacitorIoboard: CapacitorIoboardPlugin;
+/**
+ * IOBoard v2.0 - Integrated Serial + Protocol Plugin
+ *
+ * This plugin provides a unified interface for IOBoard devices with integrated
+ * serial communication and complete MTC3P08L protocol support.
+ *
+ * Key Features:
+ * - Direct serial port management
+ * - Complete MTC3P08L protocol implementation
+ * - OTA firmware update support
+ * - RGB LED control for 8 pallets
+ * - Event-driven architecture
+ * - No external dependencies
+ */
+declare class IOBoard {
+    private plugin;
+    private isConnected;
+    private currentPort;
+    /**
+     * Connect to IOBoard device
+     * @param portPath Serial port path (default: '/dev/ttyS2')
+     * @param baudRate Baud rate (default: 115200)
+     */
+    connect(portPath?: string, baudRate?: number): Promise<import("./definitions-v2").ConnectionResponse>;
+    /**
+     * Disconnect from IOBoard device
+     */
+    disconnect(): Promise<import("./definitions-v2").BasicResponse>;
+    /**
+     * Check connection status
+     */
+    isDeviceConnected(): Promise<import("./definitions-v2").ConnectionStatusResponse>;
+    /**
+     * List available serial ports
+     */
+    listPorts(): Promise<import("./definitions-v2").PortListResponse>;
+    /**
+     * Get device status
+     * @param address Device address (1-255)
+     */
+    getStatus(address?: number): Promise<import("./definitions-v2").StatusResponse>;
+    /**
+     * Unlock specific pallet with color
+     * @param address Device address
+     * @param palletNumber Pallet number (0-7)
+     * @param color RGB color or color name
+     * @param options Additional LED options
+     */
+    unlockPallet(address: number, palletNumber: number, color?: RGBColor | keyof typeof COLOR_PRESETS, options?: {
+        intensity?: number;
+        blinkTimes?: number;
+        blinkSpeed?: number;
+    }): Promise<import("./definitions-v2").BasicResponse>;
+    /**
+     * Set color for all pallets
+     * @param address Device address
+     * @param color RGB color or color name
+     * @param options Additional LED options
+     */
+    setAllPalletsColor(address: number, color: RGBColor | keyof typeof COLOR_PRESETS, options?: {
+        intensity?: number;
+        blinkTimes?: number;
+        blinkSpeed?: number;
+    }): Promise<import("./definitions-v2").BasicResponse>;
+    /**
+     * Control multiple LEDs individually
+     * @param address Device address
+     * @param ledConfigs Array of LED configurations for 8 pallets
+     */
+    controlMultipleLEDs(address: number, ledConfigs: Array<{
+        color: RGBColor | keyof typeof COLOR_PRESETS;
+        intensity?: number;
+        blinkTimes?: number;
+        blinkSpeed?: number;
+    }>): Promise<import("./definitions-v2").BasicResponse>;
+    /**
+     * Start OTA firmware update
+     * @param address Device address
+     * @param fileName Firmware file name
+     * @param fileSize File size in bytes
+     */
+    startOTAUpdate(address: number, fileName: string, fileSize: number): Promise<import("./definitions-v2").BasicResponse>;
+    /**
+     * Send OTA data packet
+     * @param address Device address
+     * @param packetNumber Packet sequence number
+     * @param data Data payload (up to 128 bytes)
+     */
+    sendOTAData(address: number, packetNumber: number, data: number[]): Promise<import("./definitions-v2").BasicResponse>;
+    /**
+     * Perform complete OTA update with progress callback
+     * @param address Device address
+     * @param file File to upload
+     * @param onProgress Progress callback
+     */
+    performOTAUpdate(address: number, file: File, onProgress?: (progress: number, packet: number, total: number) => void): Promise<{
+        success: boolean;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        message?: undefined;
+    }>;
+    /**
+     * Add data received event listener
+     */
+    addDataReceivedListener(callback: (event: any) => void): Promise<import("./definitions-v2").PluginListenerHandle>;
+    /**
+     * Add connection state changed event listener
+     */
+    addConnectionStateListener(callback: (event: any) => void): Promise<import("./definitions-v2").PluginListenerHandle>;
+    /**
+     * Add serial error event listener
+     */
+    addSerialErrorListener(callback: (event: any) => void): Promise<import("./definitions-v2").PluginListenerHandle>;
+    /**
+     * Remove all event listeners
+     */
+    removeAllListeners(): Promise<void>;
+    /**
+     * Get current connection info
+     */
+    getConnectionInfo(): {
+        isConnected: boolean;
+        currentPort: string | null;
+    };
+    /**
+     * Create RGB color object
+     */
+    static createColor(red: number, green: number, blue: number): RGBColor;
+    /**
+     * Get predefined colors
+     */
+    static getColorPresets(): {
+        readonly RED: {
+            readonly red: 255;
+            readonly green: 0;
+            readonly blue: 0;
+        };
+        readonly GREEN: {
+            readonly red: 0;
+            readonly green: 255;
+            readonly blue: 0;
+        };
+        readonly BLUE: {
+            readonly red: 0;
+            readonly green: 0;
+            readonly blue: 255;
+        };
+        readonly YELLOW: {
+            readonly red: 255;
+            readonly green: 255;
+            readonly blue: 0;
+        };
+        readonly MAGENTA: {
+            readonly red: 255;
+            readonly green: 0;
+            readonly blue: 255;
+        };
+        readonly CYAN: {
+            readonly red: 0;
+            readonly green: 255;
+            readonly blue: 255;
+        };
+        readonly WHITE: {
+            readonly red: 255;
+            readonly green: 255;
+            readonly blue: 255;
+        };
+        readonly OFF: {
+            readonly red: 0;
+            readonly green: 0;
+            readonly blue: 0;
+        };
+        readonly ORANGE: {
+            readonly red: 255;
+            readonly green: 165;
+            readonly blue: 0;
+        };
+        readonly PURPLE: {
+            readonly red: 128;
+            readonly green: 0;
+            readonly blue: 128;
+        };
+        readonly PINK: {
+            readonly red: 255;
+            readonly green: 192;
+            readonly blue: 203;
+        };
+        readonly LIME: {
+            readonly red: 50;
+            readonly green: 205;
+            readonly blue: 50;
+        };
+    };
+    private checkConnection;
+}
+export declare const ioboard: IOBoard;
+export { CapacitorIoboard };
+export * from './definitions-v2';
+export default ioboard;

package/dist/esm/index-v2.js

@@ -0,0 +1,295 @@
+import { registerPlugin } from '@capacitor/core';
+// Define color presets as constant object
+const COLOR_PRESETS = {
+    RED: { red: 255, green: 0, blue: 0 },
+    GREEN: { red: 0, green: 255, blue: 0 },
+    BLUE: { red: 0, green: 0, blue: 255 },
+    YELLOW: { red: 255, green: 255, blue: 0 },
+    MAGENTA: { red: 255, green: 0, blue: 255 },
+    CYAN: { red: 0, green: 255, blue: 255 },
+    WHITE: { red: 255, green: 255, blue: 255 },
+    OFF: { red: 0, green: 0, blue: 0 },
+    ORANGE: { red: 255, green: 165, blue: 0 },
+    PURPLE: { red: 128, green: 0, blue: 128 },
+    PINK: { red: 255, green: 192, blue: 203 },
+    LIME: { red: 50, green: 205, blue: 50 }
+};
+const CapacitorIoboard = registerPlugin('CapacitorIoboard', {
+    web: () => import('./web').then(m => new m.CapacitorIoboardWeb()),
+});
+/**
+ * IOBoard v2.0 - Integrated Serial + Protocol Plugin
+ *
+ * This plugin provides a unified interface for IOBoard devices with integrated
+ * serial communication and complete MTC3P08L protocol support.
+ *
+ * Key Features:
+ * - Direct serial port management
+ * - Complete MTC3P08L protocol implementation
+ * - OTA firmware update support
+ * - RGB LED control for 8 pallets
+ * - Event-driven architecture
+ * - No external dependencies
+ */
+class IOBoard {
+    constructor() {
+        this.plugin = CapacitorIoboard;
+        this.isConnected = false;
+        this.currentPort = null;
+    }
+    // ================== CONNECTION METHODS ==================
+    /**
+     * Connect to IOBoard device
+     * @param portPath Serial port path (default: '/dev/ttyS2')
+     * @param baudRate Baud rate (default: 115200)
+     */
+    async connect(portPath = '/dev/ttyS2', baudRate = 115200) {
+        const result = await this.plugin.connect({
+            portPath,
+            baudRate,
+            dataBits: 8,
+            stopBits: 1,
+            parity: 'none'
+        });
+        if (result.success) {
+            this.isConnected = true;
+            this.currentPort = portPath;
+        }
+        return result;
+    }
+    /**
+     * Disconnect from IOBoard device
+     */
+    async disconnect() {
+        const result = await this.plugin.disconnect();
+        if (result.success) {
+            this.isConnected = false;
+            this.currentPort = null;
+        }
+        return result;
+    }
+    /**
+     * Check connection status
+     */
+    async isDeviceConnected() {
+        const status = await this.plugin.isConnected();
+        this.isConnected = status.connected;
+        return status;
+    }
+    /**
+     * List available serial ports
+     */
+    async listPorts() {
+        return await this.plugin.listPorts();
+    }
+    // ================== IOBoard DEVICE METHODS ==================
+    /**
+     * Get device status
+     * @param address Device address (1-255)
+     */
+    async getStatus(address = 1) {
+        this.checkConnection();
+        return await this.plugin.getStatus({ address });
+    }
+    /**
+     * Unlock specific pallet with color
+     * @param address Device address
+     * @param palletNumber Pallet number (0-7)
+     * @param color RGB color or color name
+     * @param options Additional LED options
+     */
+    async unlockPallet(address, palletNumber, color = 'GREEN', options = {}) {
+        var _a, _b, _c;
+        this.checkConnection();
+        const rgbColor = typeof color === 'string' ? COLOR_PRESETS[color] : color;
+        return await this.plugin.unlockPallet({
+            address,
+            palletNumber,
+            red: rgbColor.red,
+            green: rgbColor.green,
+            blue: rgbColor.blue,
+            intensity: (_a = options.intensity) !== null && _a !== void 0 ? _a : 100,
+            blinkTimes: (_b = options.blinkTimes) !== null && _b !== void 0 ? _b : 0,
+            blinkSpeed: (_c = options.blinkSpeed) !== null && _c !== void 0 ? _c : 1
+        });
+    }
+    /**
+     * Set color for all pallets
+     * @param address Device address
+     * @param color RGB color or color name
+     * @param options Additional LED options
+     */
+    async setAllPalletsColor(address, color, options = {}) {
+        this.checkConnection();
+        const rgbColor = typeof color === 'string' ? COLOR_PRESETS[color] : color;
+        // Create LED configuration for all 8 pallets
+        const leds = Array(8).fill(null).map(() => {
+            var _a, _b, _c;
+            return ({
+                red: rgbColor.red,
+                green: rgbColor.green,
+                blue: rgbColor.blue,
+                intensity: (_a = options.intensity) !== null && _a !== void 0 ? _a : 100,
+                blinkTimes: (_b = options.blinkTimes) !== null && _b !== void 0 ? _b : 0,
+                blinkSpeed: (_c = options.blinkSpeed) !== null && _c !== void 0 ? _c : 1
+            });
+        });
+        return await this.plugin.controlMultiple({ address, leds });
+    }
+    /**
+     * Control multiple LEDs individually
+     * @param address Device address
+     * @param ledConfigs Array of LED configurations for 8 pallets
+     */
+    async controlMultipleLEDs(address, ledConfigs) {
+        this.checkConnection();
+        const leds = ledConfigs.map(config => {
+            var _a, _b, _c;
+            const rgbColor = typeof config.color === 'string' ? COLOR_PRESETS[config.color] : config.color;
+            return {
+                red: rgbColor.red,
+                green: rgbColor.green,
+                blue: rgbColor.blue,
+                intensity: (_a = config.intensity) !== null && _a !== void 0 ? _a : 100,
+                blinkTimes: (_b = config.blinkTimes) !== null && _b !== void 0 ? _b : 0,
+                blinkSpeed: (_c = config.blinkSpeed) !== null && _c !== void 0 ? _c : 1
+            };
+        });
+        return await this.plugin.controlMultiple({ address, leds });
+    }
+    // ================== OTA UPDATE METHODS ==================
+    /**
+     * Start OTA firmware update
+     * @param address Device address
+     * @param fileName Firmware file name
+     * @param fileSize File size in bytes
+     */
+    async startOTAUpdate(address, fileName, fileSize) {
+        this.checkConnection();
+        const totalPackets = Math.ceil(fileSize / 128);
+        return await this.plugin.startOTAUpdate({
+            address,
+            fileName,
+            fileSize,
+            totalPackets
+        });
+    }
+    /**
+     * Send OTA data packet
+     * @param address Device address
+     * @param packetNumber Packet sequence number
+     * @param data Data payload (up to 128 bytes)
+     */
+    async sendOTAData(address, packetNumber, data) {
+        this.checkConnection();
+        // Ensure data is exactly 128 bytes
+        const paddedData = [...data];
+        while (paddedData.length < 128) {
+            paddedData.push(0);
+        }
+        return await this.plugin.sendOTAData({
+            address,
+            packetNumber,
+            data: paddedData.slice(0, 128)
+        });
+    }
+    /**
+     * Perform complete OTA update with progress callback
+     * @param address Device address
+     * @param file File to upload
+     * @param onProgress Progress callback
+     */
+    async performOTAUpdate(address, file, onProgress) {
+        this.checkConnection();
+        try {
+            // Start OTA update
+            const startResult = await this.startOTAUpdate(address, file.name, file.size);
+            if (!startResult.success) {
+                throw new Error(`Failed to start OTA: ${startResult.error}`);
+            }
+            // Read file data
+            const arrayBuffer = await file.arrayBuffer();
+            const fileData = new Uint8Array(arrayBuffer);
+            const totalPackets = Math.ceil(file.size / 128);
+            // Send data packets
+            for (let packetNumber = 0; packetNumber < totalPackets; packetNumber++) {
+                const start = packetNumber * 128;
+                const end = Math.min(start + 128, fileData.length);
+                const chunk = Array.from(fileData.slice(start, end));
+                const result = await this.sendOTAData(address, packetNumber, chunk);
+                if (!result.success) {
+                    throw new Error(`Failed to send packet ${packetNumber}: ${result.error}`);
+                }
+                // Report progress
+                const progress = ((packetNumber + 1) / totalPackets) * 100;
+                onProgress === null || onProgress === void 0 ? void 0 : onProgress(progress, packetNumber + 1, totalPackets);
+                // Small delay to prevent overwhelming device
+                await new Promise(resolve => setTimeout(resolve, 10));
+            }
+            return { success: true, message: 'OTA update completed successfully' };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error during OTA update'
+            };
+        }
+    }
+    // ================== EVENT METHODS ==================
+    /**
+     * Add data received event listener
+     */
+    async addDataReceivedListener(callback) {
+        return await this.plugin.addListener('dataReceived', callback);
+    }
+    /**
+     * Add connection state changed event listener
+     */
+    async addConnectionStateListener(callback) {
+        return await this.plugin.addListener('connectionStateChanged', callback);
+    }
+    /**
+     * Add serial error event listener
+     */
+    async addSerialErrorListener(callback) {
+        return await this.plugin.addListener('serialError', callback);
+    }
+    /**
+     * Remove all event listeners
+     */
+    async removeAllListeners() {
+        return await this.plugin.removeAllListeners();
+    }
+    // ================== UTILITY METHODS ==================
+    /**
+     * Get current connection info
+     */
+    getConnectionInfo() {
+        return {
+            isConnected: this.isConnected,
+            currentPort: this.currentPort
+        };
+    }
+    /**
+     * Create RGB color object
+     */
+    static createColor(red, green, blue) {
+        return { red, green, blue };
+    }
+    /**
+     * Get predefined colors
+     */
+    static getColorPresets() {
+        return COLOR_PRESETS;
+    }
+    checkConnection() {
+        if (!this.isConnected) {
+            throw new Error('Not connected to IOBoard device. Call connect() first.');
+        }
+    }
+}
+// Export singleton instance and types
+export const ioboard = new IOBoard();
+export { CapacitorIoboard };
+export * from './definitions-v2';
+export default ioboard;

package/dist/esm/web.d.ts

@@ -1,17 +1,14 @@
-import { WebPlugin } from '@capacitor/core';
-import type { CapacitorIoboardPlugin, IOBoardResponse, IOBoardStatusResponse, DeviceOptions, UnlockPalletOptions, MultiplePalletOptions, ScanOptions, ScanResponse, OTANotificationOptions, OTADataOptions, SerialConnectionOptions } from './definitions';
-export declare class CapacitorIoboardWeb extends WebPlugin implements CapacitorIoboardPlugin {
-    private isConnectedState;
-    connect(options: SerialConnectionOptions): Promise<IOBoardResponse>;
-    disconnect(): Promise<IOBoardResponse>;
-    isConnected(): Promise<{
-        connected: boolean;
-    }>;
-    getStatus(options: DeviceOptions): Promise<IOBoardStatusResponse>;
-    unlockPallet(options: UnlockPalletOptions): Promise<IOBoardResponse>;
-    controlMultiplePallets(options: MultiplePalletOptions): Promise<IOBoardResponse>;
-    scanDevices(options: ScanOptions): Promise<ScanResponse>;
-    sendOTANotification(options: OTANotificationOptions): Promise<IOBoardResponse>;
-    sendOTAData(options: OTADataOptions): Promise<IOBoardResponse>;
-    private getMaskBits;
+import { WebPlugin } from "@capacitor/core";
+export declare class CapacitorIoboardWeb extends WebPlugin {
+    constructor();
+    connect(options: any): Promise<any>;
+    disconnect(): Promise<any>;
+    isConnected(): Promise<any>;
+    listPorts(): Promise<any>;
+    getStatus(options: any): Promise<any>;
+    unlockPallet(options: any): Promise<any>;
+    controlMultiplePallets(options: any): Promise<any>;
+    controlMultiple(options: any): Promise<any>;
+    startOTAUpdate(options: any): Promise<any>;
+    sendOTAData(options: any): Promise<any>;
 }