homebridge-smartika 1.0.0

package/src/accessories/SmartikaFanAccessory.js

@@ -0,0 +1,162 @@
+'use strict';
+
+/**
+ * Smartika Fan Accessory
+ * 
+ * Exposes Smartika ceiling fan devices to HomeKit with support for:
+ * - On/Off control
+ * - Rotation Speed
+ */
+class SmartikaFanAccessory {
+    /**
+     * @param {import('../SmartikaPlatform')} platform
+     * @param {import('homebridge').PlatformAccessory} accessory
+     * @param {Object} device - Device info from hub
+     */
+    constructor(platform, accessory, device) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.device = device;
+        this.log = platform.log;
+
+        // HAP references
+        this.Service = platform.api.hap.Service;
+        this.Characteristic = platform.api.hap.Characteristic;
+
+        // Current state
+        this.state = {
+            active: false,
+            rotationSpeed: 0,
+        };
+
+        // Configure the fan service
+        this.configureService();
+    }
+
+    /**
+     * Configure the Fanv2 service
+     */
+    configureService() {
+        // Use Fanv2 for better HomeKit support
+        this.service = this.accessory.getService(this.Service.Fanv2) ||
+            this.accessory.addService(this.Service.Fanv2, this.device.typeName);
+
+        // Set the service name
+        this.service.setCharacteristic(this.Characteristic.Name, this.device.typeName);
+
+        // Configure Active characteristic (on/off)
+        this.service.getCharacteristic(this.Characteristic.Active)
+            .onGet(this.getActive.bind(this))
+            .onSet(this.setActive.bind(this));
+
+        // Configure RotationSpeed characteristic
+        this.service.getCharacteristic(this.Characteristic.RotationSpeed)
+            .onGet(this.getRotationSpeed.bind(this))
+            .onSet(this.setRotationSpeed.bind(this))
+            .setProps({
+                minValue: 0,
+                maxValue: 100,
+                minStep: 1,
+            });
+
+        this.log.debug(`Configured fan accessory: ${this.device.typeName} (0x${this.device.shortAddress.toString(16)})`);
+    }
+
+    /**
+     * Handle GET Active
+     * @returns {number} - 0 (INACTIVE) or 1 (ACTIVE)
+     */
+    getActive() {
+        this.log.debug(`GET Active for ${this.device.typeName}: ${this.state.active}`);
+        return this.state.active ? 1 : 0;
+    }
+
+    /**
+     * Handle SET Active
+     * @param {number} value - 0 (INACTIVE) or 1 (ACTIVE)
+     */
+    async setActive(value) {
+        const active = value === 1;
+        this.log.info(`SET Active for ${this.device.typeName}: ${active}`);
+
+        try {
+            await this.platform.hub.setDevicePower(active, [this.device.shortAddress]);
+            this.state.active = active;
+
+            // If turning on and speed is 0, set a default speed
+            if (active && this.state.rotationSpeed === 0) {
+                this.state.rotationSpeed = 50;
+                this.service.updateCharacteristic(this.Characteristic.RotationSpeed, 50);
+            }
+        } catch (error) {
+            this.log.error(`Failed to set power for ${this.device.typeName}:`, error.message);
+            throw new this.platform.api.hap.HapStatusError(
+                this.platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE,
+            );
+        }
+    }
+
+    /**
+     * Handle GET RotationSpeed
+     * @returns {number} - Speed percentage (0-100)
+     */
+    getRotationSpeed() {
+        this.log.debug(`GET RotationSpeed for ${this.device.typeName}: ${this.state.rotationSpeed}%`);
+        return this.state.rotationSpeed;
+    }
+
+    /**
+     * Handle SET RotationSpeed
+     * @param {number} value - Speed percentage (0-100)
+     */
+    async setRotationSpeed(value) {
+        this.log.info(`SET RotationSpeed for ${this.device.typeName}: ${value}%`);
+
+        try {
+            // Convert 0-100% to 0-255
+            const speed255 = Math.round(value / 100 * 255);
+            await this.platform.hub.setFanSpeed(speed255, [this.device.shortAddress]);
+            this.state.rotationSpeed = value;
+
+            // Update active state based on speed
+            if (value > 0 && !this.state.active) {
+                this.state.active = true;
+                this.service.updateCharacteristic(this.Characteristic.Active, 1);
+            } else if (value === 0 && this.state.active) {
+                this.state.active = false;
+                this.service.updateCharacteristic(this.Characteristic.Active, 0);
+            }
+        } catch (error) {
+            this.log.error(`Failed to set fan speed for ${this.device.typeName}:`, error.message);
+            throw new this.platform.api.hap.HapStatusError(
+                this.platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE,
+            );
+        }
+    }
+
+    /**
+     * Update state from hub status
+     * @param {Object} status - Status from hub
+     */
+    updateStatus(status) {
+        // Update Active state
+        if (status.on !== undefined && status.on !== this.state.active) {
+            this.state.active = status.on;
+            this.service.updateCharacteristic(this.Characteristic.Active, status.on ? 1 : 0);
+            this.log.debug(`Updated ${this.device.typeName} Active: ${status.on}`);
+        }
+
+        // Update RotationSpeed
+        if (status.speed !== undefined) {
+            // Convert 0-255 to 0-100%
+            const speed = Math.round(status.speed / 255 * 100);
+            if (speed !== this.state.rotationSpeed) {
+                this.state.rotationSpeed = speed;
+                this.service.updateCharacteristic(this.Characteristic.RotationSpeed, speed);
+                this.log.debug(`Updated ${this.device.typeName} RotationSpeed: ${speed}%`);
+            }
+        }
+    }
+}
+
+module.exports = SmartikaFanAccessory;

package/src/accessories/SmartikaLightAccessory.js

@@ -0,0 +1,203 @@
+'use strict';
+
+/**
+ * Smartika Light Accessory
+ * 
+ * Exposes Smartika light devices to HomeKit with support for:
+ * - On/Off control
+ * - Brightness (dimming)
+ * - Color Temperature
+ */
+class SmartikaLightAccessory {
+    /**
+     * @param {import('../SmartikaPlatform')} platform
+     * @param {import('homebridge').PlatformAccessory} accessory
+     * @param {Object} device - Device info from hub
+     */
+    constructor(platform, accessory, device) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.device = device;
+        this.log = platform.log;
+
+        // HAP references
+        this.Service = platform.api.hap.Service;
+        this.Characteristic = platform.api.hap.Characteristic;
+
+        // Current state
+        this.state = {
+            on: false,
+            brightness: 100,
+            colorTemperature: 200, // HomeKit: 140-500 mireds
+        };
+
+        // Configure the lightbulb service
+        this.configureService();
+    }
+
+    /**
+     * Configure the Lightbulb service
+     */
+    configureService() {
+        // Get or create the Lightbulb service
+        this.service = this.accessory.getService(this.Service.Lightbulb) ||
+            this.accessory.addService(this.Service.Lightbulb, this.device.typeName);
+
+        // Set the service name
+        this.service.setCharacteristic(this.Characteristic.Name, this.device.typeName);
+
+        // Configure On characteristic
+        this.service.getCharacteristic(this.Characteristic.On)
+            .onGet(this.getOn.bind(this))
+            .onSet(this.setOn.bind(this));
+
+        // Configure Brightness characteristic
+        this.service.getCharacteristic(this.Characteristic.Brightness)
+            .onGet(this.getBrightness.bind(this))
+            .onSet(this.setBrightness.bind(this));
+
+        // Configure Color Temperature characteristic (if device supports it)
+        // Most Smartika lights support color temperature
+        this.service.getCharacteristic(this.Characteristic.ColorTemperature)
+            .onGet(this.getColorTemperature.bind(this))
+            .onSet(this.setColorTemperature.bind(this))
+            .setProps({
+                minValue: 140,  // ~7142K (cool white)
+                maxValue: 500,  // ~2000K (warm white)
+            });
+
+        this.log.debug(`Configured light accessory: ${this.device.typeName} (0x${this.device.shortAddress.toString(16)})`);
+    }
+
+    /**
+     * Handle GET On
+     * @returns {boolean}
+     */
+    getOn() {
+        this.log.debug(`GET On for ${this.device.typeName}: ${this.state.on}`);
+        return this.state.on;
+    }
+
+    /**
+     * Handle SET On
+     * @param {boolean} value
+     */
+    async setOn(value) {
+        this.log.info(`SET On for ${this.device.typeName}: ${value}`);
+
+        try {
+            await this.platform.hub.setDevicePower(value, [this.device.shortAddress]);
+            this.state.on = value;
+        } catch (error) {
+            this.log.error(`Failed to set power for ${this.device.typeName}:`, error.message);
+            throw new this.platform.api.hap.HapStatusError(
+                this.platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE,
+            );
+        }
+    }
+
+    /**
+     * Handle GET Brightness
+     * @returns {number} - Brightness percentage (0-100)
+     */
+    getBrightness() {
+        this.log.debug(`GET Brightness for ${this.device.typeName}: ${this.state.brightness}%`);
+        return this.state.brightness;
+    }
+
+    /**
+     * Handle SET Brightness
+     * @param {number} value - Brightness percentage (0-100)
+     */
+    async setBrightness(value) {
+        this.log.info(`SET Brightness for ${this.device.typeName}: ${value}%`);
+
+        try {
+            // Convert 0-100% to 0-255
+            const brightness255 = Math.round(value / 100 * 255);
+            await this.platform.hub.setLightBrightness(brightness255, [this.device.shortAddress]);
+            this.state.brightness = value;
+
+            // If brightness is set to > 0, ensure light is on
+            if (value > 0 && !this.state.on) {
+                this.state.on = true;
+                this.service.updateCharacteristic(this.Characteristic.On, true);
+            }
+        } catch (error) {
+            this.log.error(`Failed to set brightness for ${this.device.typeName}:`, error.message);
+            throw new this.platform.api.hap.HapStatusError(
+                this.platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE,
+            );
+        }
+    }
+
+    /**
+     * Handle GET ColorTemperature
+     * @returns {number} - Color temperature in mireds (140-500)
+     */
+    getColorTemperature() {
+        this.log.debug(`GET ColorTemperature for ${this.device.typeName}: ${this.state.colorTemperature} mireds`);
+        return this.state.colorTemperature;
+    }
+
+    /**
+     * Handle SET ColorTemperature
+     * @param {number} value - Color temperature in mireds (140-500)
+     */
+    async setColorTemperature(value) {
+        this.log.info(`SET ColorTemperature for ${this.device.typeName}: ${value} mireds`);
+
+        try {
+            // Convert mireds to Smartika temperature (0=warm, 255=cool)
+            // HomeKit: 140 (cool/7142K) to 500 (warm/2000K)
+            // Smartika: 0 (warm) to 255 (cool)
+            // So we need to invert: higher mireds = warmer = lower Smartika value
+            const temp255 = Math.round((500 - value) / (500 - 140) * 255);
+            await this.platform.hub.setLightTemperature(temp255, [this.device.shortAddress]);
+            this.state.colorTemperature = value;
+        } catch (error) {
+            this.log.error(`Failed to set color temperature for ${this.device.typeName}:`, error.message);
+            throw new this.platform.api.hap.HapStatusError(
+                this.platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE,
+            );
+        }
+    }
+
+    /**
+     * Update state from hub status
+     * @param {Object} status - Status from hub
+     */
+    updateStatus(status) {
+        // Update On state
+        if (status.on !== undefined && status.on !== this.state.on) {
+            this.state.on = status.on;
+            this.service.updateCharacteristic(this.Characteristic.On, status.on);
+            this.log.debug(`Updated ${this.device.typeName} On: ${status.on}`);
+        }
+
+        // Update Brightness
+        if (status.brightness !== undefined) {
+            // Convert 0-255 to 0-100%
+            const brightness = Math.round(status.brightness / 255 * 100);
+            if (brightness !== this.state.brightness) {
+                this.state.brightness = brightness;
+                this.service.updateCharacteristic(this.Characteristic.Brightness, brightness);
+                this.log.debug(`Updated ${this.device.typeName} Brightness: ${brightness}%`);
+            }
+        }
+
+        // Update Color Temperature
+        if (status.temperature !== undefined) {
+            // Convert Smartika temperature (0=warm, 255=cool) to mireds (140-500)
+            // Invert: lower Smartika = warmer = higher mireds
+            const mireds = Math.round(500 - (status.temperature / 255 * (500 - 140)));
+            if (mireds !== this.state.colorTemperature) {
+                this.state.colorTemperature = mireds;
+                this.service.updateCharacteristic(this.Characteristic.ColorTemperature, mireds);
+                this.log.debug(`Updated ${this.device.typeName} ColorTemperature: ${mireds} mireds`);
+            }
+        }
+    }
+}
+
+module.exports = SmartikaLightAccessory;

package/src/accessories/SmartikaPlugAccessory.js

@@ -0,0 +1,112 @@
+'use strict';
+
+/**
+ * Smartika Plug Accessory
+ * 
+ * Exposes Smartika smart plug devices to HomeKit with support for:
+ * - On/Off control
+ */
+class SmartikaPlugAccessory {
+    /**
+     * @param {import('../SmartikaPlatform')} platform
+     * @param {import('homebridge').PlatformAccessory} accessory
+     * @param {Object} device - Device info from hub
+     */
+    constructor(platform, accessory, device) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.device = device;
+        this.log = platform.log;
+
+        // HAP references
+        this.Service = platform.api.hap.Service;
+        this.Characteristic = platform.api.hap.Characteristic;
+
+        // Current state
+        this.state = {
+            on: false,
+        };
+
+        // Configure the outlet service
+        this.configureService();
+    }
+
+    /**
+     * Configure the Outlet service
+     */
+    configureService() {
+        // Get or create the Outlet service
+        this.service = this.accessory.getService(this.Service.Outlet) ||
+            this.accessory.addService(this.Service.Outlet, this.device.typeName);
+
+        // Set the service name
+        this.service.setCharacteristic(this.Characteristic.Name, this.device.typeName);
+
+        // Configure On characteristic
+        this.service.getCharacteristic(this.Characteristic.On)
+            .onGet(this.getOn.bind(this))
+            .onSet(this.setOn.bind(this));
+
+        // Configure OutletInUse characteristic (we'll assume it's in use if it's on)
+        this.service.getCharacteristic(this.Characteristic.OutletInUse)
+            .onGet(this.getOutletInUse.bind(this));
+
+        this.log.debug(`Configured plug accessory: ${this.device.typeName} (0x${this.device.shortAddress.toString(16)})`);
+    }
+
+    /**
+     * Handle GET On
+     * @returns {boolean}
+     */
+    getOn() {
+        this.log.debug(`GET On for ${this.device.typeName}: ${this.state.on}`);
+        return this.state.on;
+    }
+
+    /**
+     * Handle SET On
+     * @param {boolean} value
+     */
+    async setOn(value) {
+        this.log.info(`SET On for ${this.device.typeName}: ${value}`);
+
+        try {
+            await this.platform.hub.setDevicePower(value, [this.device.shortAddress]);
+            this.state.on = value;
+
+            // Update OutletInUse when power state changes
+            this.service.updateCharacteristic(this.Characteristic.OutletInUse, value);
+        } catch (error) {
+            this.log.error(`Failed to set power for ${this.device.typeName}:`, error.message);
+            throw new this.platform.api.hap.HapStatusError(
+                this.platform.api.hap.HAPStatus.SERVICE_COMMUNICATION_FAILURE,
+            );
+        }
+    }
+
+    /**
+     * Handle GET OutletInUse
+     * @returns {boolean}
+     */
+    getOutletInUse() {
+        // We'll assume the outlet is in use if it's on
+        // (Smartika plugs don't report power consumption)
+        return this.state.on;
+    }
+
+    /**
+     * Update state from hub status
+     * @param {Object} status - Status from hub
+     */
+    updateStatus(status) {
+        // Update On state
+        if (status.on !== undefined && status.on !== this.state.on) {
+            this.state.on = status.on;
+            this.service.updateCharacteristic(this.Characteristic.On, status.on);
+            this.service.updateCharacteristic(this.Characteristic.OutletInUse, status.on);
+            this.log.debug(`Updated ${this.device.typeName} On: ${status.on}`);
+        }
+    }
+}
+
+module.exports = SmartikaPlugAccessory;

package/src/index.js

@@ -0,0 +1,12 @@
+'use strict';
+
+const { PLATFORM_NAME, PLUGIN_NAME } = require('./settings');
+const SmartikaPlatform = require('./SmartikaPlatform');
+
+/**
+ * Homebridge plugin entry point
+ * @param {API} api - Homebridge API
+ */
+module.exports = (api) => {
+    api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, SmartikaPlatform);
+};

package/src/settings.js

@@ -0,0 +1,16 @@
+'use strict';
+
+/**
+ * Platform name - must match the "pluginAlias" in config.schema.json
+ */
+const PLATFORM_NAME = 'Smartika';
+
+/**
+ * Plugin name - must match the "name" in package.json
+ */
+const PLUGIN_NAME = 'homebridge-smartika';
+
+module.exports = {
+    PLATFORM_NAME,
+    PLUGIN_NAME,
+};