homebridge-solaxcloud-api 2.3.2 → 2.4.0

package/dist/platformInverter.js

@@ -1,344 +1,349 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SolaxCloudAPIPlatformInverter = exports.ACCESSORY_KEYS = exports.INVERTER_BRAND = void 0;
-const solaxcloudapi_1 = require("./solaxcloudapi");
-const outletAccessory_1 = require("./outletAccessory");
-const lightSensorAccessory_1 = require("./lightSensorAccessory");
-const motionAccessory_1 = require("./motionAccessory");
-const batteryAccessory_1 = require("./batteryAccessory");
-/**
- * Inverter brand.
- */
-exports.INVERTER_BRAND = {
-    SOLAX: 0,
-    QCELLS: 1,
-};
-/**
- * Standard names for accessories.
- */
-exports.ACCESSORY_KEYS = {
-    pv: 'pv',
-    inverterToBattery: 'inverterToBattery',
-    inverterFromBattery: 'inverterFromBattery',
-    inverterAC: 'inverterAC',
-    inverterToGrid: 'inverterToGrid',
-    inverterToHouse: 'inverterToHouse',
-    gridToHouse: 'gridToHouse',
-};
-/**
- * Standard names for accessories.
- */
-const ACCESSORY_NAMES = {
-    pv: 'PV',
-    inverterToBattery: 'To Battery',
-    inverterFromBattery: 'From Battery',
-    inverterAC: 'AC',
-    inverterToGrid: 'To Grid',
-    inverterToHouse: 'To House',
-    gridToHouse: 'From Grid',
-};
-/**
- * Standar prefixes for accessory serials.
- */
-const ACCESSORY_SERIAL_PREFIXES = {
-    pv: 'pv',
-    inverterToBattery: 'inv-tobat',
-    inverterFromBattery: 'inv-frombat',
-    inverterAC: 'inv-ac',
-    inverterToGrid: 'inv-grid',
-    inverterToHouse: 'inv-house',
-    gridToHouse: 'grid-house',
-};
-/**
- * SolaxCloudAPIPlatformInverter.
- * This class is the main constructor for your inverter accessories
- * to be used by Homebridge.
- */
-class SolaxCloudAPIPlatformInverter {
-    /**
-      * Platform inverter constructor.
-      * @param log
-      * @param config
-      * @param api
-      * @param brand
-      * @param tokenId
-      * @param sn
-      * @param name
-      * @param hasBattery
-      * @param smoothingWindow
-      * @returns
-      */
-    constructor(log, config, api, brand, tokenId, sn, name, hasBattery, smoothingWindow) {
-        /** Array with all accessories */
-        this.solaxAccessories = [];
-        // store values in properties
-        this.log = log;
-        this.config = config;
-        this.api = api;
-        // setup inverter data
-        this.brand = brand;
-        this.sn = sn.toLowerCase();
-        this.name = name;
-        this.smoothingWindow = smoothingWindow;
-        this.batteryInstalled = hasBattery;
-        this.log.info(`Initialing acessories for inverter "${name}" (SN="${sn}") from ${SolaxCloudAPIPlatformInverter.getInverterBrandName(brand)}...`);
-        // init new Solax Cloud API object with give tokenID and sn
-        this.solaxCloudAPI = new solaxcloudapi_1.SolaxCloudAPI(brand, tokenId, sn);
-        // initial data set
-        const apiData = this.solaxCloudAPI.getAPIData();
-        this.log.debug(`apiData = ${JSON.stringify(apiData)}`);
-        let inverterModel;
-        if (apiData.success) {
-            inverterModel = solaxcloudapi_1.SolaxCloudAPI.getInverterType(apiData.result.inverterType);
-        }
-        else {
-            this.log.info(`Could not retrieve initial values from ${SolaxCloudAPIPlatformInverter.getInverterBrandName(brand)} ` +
-                'Cloud, accessory Serial Number and Model properties deferred...');
-            inverterModel = 'Unknown';
-        }
-        // setup raw outlet accessories
-        this.rawOutlets = {
-            pv: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv}`, `${ACCESSORY_SERIAL_PREFIXES.pv}-${this.sn}`, inverterModel),
-            inverterFromBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery}`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-${this.sn}`, inverterModel),
-            inverterToBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery}`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-${this.sn}`, inverterModel),
-            inverterAC: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC}`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-${this.sn}`, inverterModel),
-            inverterToGrid: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid}`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-${this.sn}`, inverterModel),
-            inverterToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse}`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-${this.sn}`, inverterModel),
-            gridToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse}`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-${this.sn}`, inverterModel),
-        };
-        // setup update motion sensor
-        this.motionUpdate =
-            new motionAccessory_1.SolaxMotionAccessory(this.log, this.api, `${this.name} Update`, `update-${this.sn}`, inverterModel);
-        // create array with all valid base accessories
-        this.solaxAccessories =
-            [this.rawOutlets.pv, this.rawOutlets.inverterAC, this.rawOutlets.inverterToGrid,
-                this.rawOutlets.inverterToHouse, this.rawOutlets.gridToHouse, this.motionUpdate];
-        if (this.hasBattery()) {
-            this.battery = new batteryAccessory_1.SolaxBatteryAccessory(this.log, this.api, `${this.name} Battery`, `bat-${this.sn}`, inverterModel);
-            this.solaxAccessories.push(this.battery, this.rawOutlets.inverterFromBattery, this.rawOutlets.inverterToBattery);
-        }
-        // check if "pure" Home App accessories are needed
-        if (this.config.pureHomeApp) {
-            // add raw light sensors
-            this.rawLightSensors = {
-                pv: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv} sensor`, `${ACCESSORY_SERIAL_PREFIXES.pv}-light-${this.sn}`, inverterModel),
-                inverterFromBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-light-${this.sn}`, inverterModel),
-                inverterToBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-light-${this.sn}`, inverterModel),
-                inverterAC: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-light-${this.sn}`, inverterModel),
-                inverterToGrid: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-light-${this.sn}`, inverterModel),
-                inverterToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-light-${this.sn}`, inverterModel),
-                gridToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse} sensor`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-light-${this.sn}`, inverterModel),
-            };
-            this.solaxAccessories.push(this.rawLightSensors.pv, this.rawLightSensors.inverterAC, this.rawLightSensors.inverterToGrid, this.rawLightSensors.inverterToHouse, this.rawLightSensors.gridToHouse);
-            if (this.batteryInstalled) {
-                this.solaxAccessories.push(this.rawLightSensors.inverterFromBattery, this.rawLightSensors.inverterToBattery);
-            }
-            if (this.config.smoothMeters) {
-                // add smooth light sensors
-                this.smoothLightSensors = {
-                    pv: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.pv}-light-smooth-${this.sn}`, inverterModel),
-                    inverterFromBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-light-smooth-${this.sn}`, inverterModel),
-                    inverterToBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-light-smooth-${this.sn}`, inverterModel),
-                    inverterAC: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-light-smooth-${this.sn}`, inverterModel),
-                    inverterToGrid: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-light-smooth-${this.sn}`, inverterModel),
-                    inverterToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-light-smooth-${this.sn}`, inverterModel),
-                    gridToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-light-smooth-${this.sn}`, inverterModel),
-                };
-                this.solaxAccessories.push(this.smoothLightSensors.pv, this.smoothLightSensors.inverterAC, this.smoothLightSensors.inverterToGrid, this.smoothLightSensors.inverterToHouse, this.smoothLightSensors.gridToHouse);
-                if (this.batteryInstalled) {
-                    this.solaxAccessories.push(this.smoothLightSensors.inverterFromBattery, this.smoothLightSensors.inverterToBattery);
-                }
-            }
-        }
-        else {
-            if (this.config.smoothMeters) {
-                // setup smooth outlet accessories
-                this.smoothOutlets = {
-                    pv: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.pv}-smooth-${this.sn}`, inverterModel),
-                    inverterFromBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-smooth-${this.sn}`, inverterModel),
-                    inverterToBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-smooth-${this.sn}`, inverterModel),
-                    inverterAC: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-smooth-${this.sn}`, inverterModel),
-                    inverterToGrid: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-smooth-${this.sn}`, inverterModel),
-                    inverterToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-smooth-${this.sn}`, inverterModel),
-                    gridToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-smooth-${this.sn}`, inverterModel),
-                };
-                this.solaxAccessories.push(this.smoothOutlets.pv, this.smoothOutlets.inverterAC, this.smoothOutlets.inverterToGrid, this.smoothOutlets.inverterToHouse, this.smoothOutlets.gridToHouse);
-                if (this.batteryInstalled) {
-                    this.solaxAccessories.push(this.smoothOutlets.inverterFromBattery, this.smoothOutlets.inverterToBattery);
-                }
-            }
-        }
-    }
-    /**
-     * Gets the inverter brand name.
-     * @param {number} brand Inverter brand type.
-     * @returns Inverter brand name.
-     */
-    static getInverterBrandName(brand) {
-        switch (brand) {
-            case exports.INVERTER_BRAND.QCELLS:
-                return 'QCells';
-            default:
-                return 'Solax';
-        }
-    }
-    /**
-      * Update all platform accessory status based on the values read from the API.
-      * @param {SolaxCloudAPIResponse} apiData API data from Solax Cloud.
-      */
-    updateAccessories(apiData) {
-        // update raw sensors
-        this.setRawPower(exports.ACCESSORY_KEYS.pv, solaxcloudapi_1.SolaxCloudAPI.getPVPower(apiData.result));
-        this.setRawPower(exports.ACCESSORY_KEYS.inverterFromBattery, solaxcloudapi_1.SolaxCloudAPI.getInverterPowerFromBattery(apiData.result));
-        this.setRawPower(exports.ACCESSORY_KEYS.inverterToBattery, solaxcloudapi_1.SolaxCloudAPI.getInverterPowerToBattery(apiData.result));
-        this.setRawPower(exports.ACCESSORY_KEYS.inverterAC, solaxcloudapi_1.SolaxCloudAPI.getInverterACPower(apiData.result));
-        this.setRawEnergy(exports.ACCESSORY_KEYS.inverterAC, solaxcloudapi_1.SolaxCloudAPI.getYieldTotal(apiData.result));
-        this.setRawPower(exports.ACCESSORY_KEYS.inverterToGrid, solaxcloudapi_1.SolaxCloudAPI.getInverterPowerToGrid(apiData.result));
-        this.setRawPower(exports.ACCESSORY_KEYS.inverterToHouse, solaxcloudapi_1.SolaxCloudAPI.getInverterPowerToHouse(apiData.result));
-        this.setRawPower(exports.ACCESSORY_KEYS.gridToHouse, solaxcloudapi_1.SolaxCloudAPI.getGridPowerToHouse(apiData.result));
-        if (this.config.smoothMeters) {
-            // update smooth light sensors from raw outlets by applying smoothing function to power consumption
-            this.setSmoothPower(exports.ACCESSORY_KEYS.pv);
-            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterFromBattery);
-            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterToBattery);
-            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterAC);
-            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterToGrid);
-            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterToHouse);
-            this.setSmoothPower(exports.ACCESSORY_KEYS.gridToHouse);
-        }
-        // check for battery
-        if (this.hasBattery()) {
-            this.setBatteryLevel(solaxcloudapi_1.SolaxCloudAPI.getBatterySoC(apiData.result));
-            if (this.getRawPower(exports.ACCESSORY_KEYS.inverterToBattery) > 0) {
-                this.setBatteryChargeState(batteryAccessory_1.BATTERY_CHARGING_STATE.CHARGING);
-            }
-            else if (this.getRawPower(exports.ACCESSORY_KEYS.inverterFromBattery) > 0) {
-                this.setBatteryChargeState(batteryAccessory_1.BATTERY_CHARGING_STATE.NOT_CHARGING);
-            }
-            else {
-                this.setBatteryChargeState(batteryAccessory_1.BATTERY_CHARGING_STATE.NOT_CHARGEABLE);
-            }
-        }
-        // notify update with motion sensor
-        this.setMotionUpdate();
-    }
-    /**
-     * Sets the battery charge state for this inverter.
-     * @param {number} state The desired battery charge state.
-     */
-    setBatteryChargeState(state) {
-        this.battery.setChargeState(state);
-    }
-    /**
-     * Gets the battery charge state for this inverter.
-     * @returns {number} Battery charge state.
-     */
-    getBatteryChargeState() {
-        return this.battery.getChargeStateValue();
-    }
-    /**
-     * Sets the current battery level for this inverter.
-     * @param {number} percentage Battery level to set (percentage).
-     */
-    setBatteryLevel(percentage) {
-        this.battery.setLevel(percentage);
-    }
-    /**
-     * Gets the current battery level for this inverter.
-     * @returns {number} The current battery level (percentage).
-     */
-    getBatteryLevel() {
-        return this.battery.getLevelValue();
-    }
-    /**
-     * Sets virtual update motion detector to true to notify of new data update.
-     */
-    setMotionUpdate() {
-        this.motionUpdate.setState(true);
-    }
-    /**
-     * Gets raw accessory power for this inverter.
-     * @param {string} key Accessory key.
-     * @returns {number} Power consumptions for this accessory.
-     */
-    getRawPower(key) {
-        return this.rawOutlets[key].getPowerConsumptionValue();
-    }
-    /**
-     * Sets raw accessory power for this inverter.
-     * @param {string} key Accessory key.
-     * @param {number} power Power to set (in Watt).
-     */
-    setRawPower(key, power) {
-        this.rawOutlets[key].setPowerConsumption(power);
-        if (this.config.pureHomeApp) {
-            this.rawLightSensors[key].setAmbientLightLevel(power);
-        }
-    }
-    /**
-     * Gets raw accessory energy for this inverter.
-     * @param {string} key Accessory key.
-     * @returns {number} The energy consumption for the desired acessory (in Wh).
-     */
-    getRawEnergy(key) {
-        return this.rawOutlets[key].getTotalEnergyConsumptionValue();
-    }
-    /**
-     * Sets raw accessory energy for this inverter.
-     * @param {string} key Accessory key.
-     * @param {number} energy Energy consumption to set (in Wh).
-     */
-    setRawEnergy(key, energy) {
-        this.rawOutlets[key].setTotalEnergyConsumption(energy);
-    }
-    /**
-     * Sets smooth accessory power from raw accessory power for this inverter.
-     * @param {string} key Accessory key.
-     */
-    setSmoothPower(key) {
-        const smoothPower = this.rawOutlets[key].getSmoothPowerConsumption(this.config.smoothingMethod, this.smoothingWindow);
-        if (this.config.pureHomeApp) {
-            this.smoothLightSensors[key].setAmbientLightLevel(smoothPower);
-        }
-        else {
-            this.smoothOutlets[key].setPowerConsumption(smoothPower);
-        }
-    }
-    /**
-     * Update data from this inverter by using the Solax Cloud API
-     */
-    updateInverterDataFromCloud() {
-        try {
-            this.log.info(`Retrieving data from ${SolaxCloudAPIPlatformInverter.getInverterBrandName(this.brand)} ` +
-                `Cloud API for inverter "${this.name}" (SN="${this.sn}")`);
-            const apiData = this.solaxCloudAPI.getAPIData();
-            if (apiData.success) {
-                this.log.debug(`Retrieved inverter status: ${JSON.stringify(apiData.result)}`);
-                this.updateAccessories(apiData);
-            }
-            else {
-                throw new Error(apiData.exception);
-            }
-        }
-        catch (error) {
-            this.log.error(`Failed to read from ${SolaxCloudAPIPlatformInverter.getInverterBrandName(this.brand)} ` +
-                `Cloud API for inverter "${this.name}" (SN="${this.sn})". Error: ${error}`);
-        }
-    }
-    /**
-     * Returns whether this inverter has a battery installed.
-     * @returns {boolean} Whether this inverter battery has a battery installed.
-     */
-    hasBattery() {
-        return this.batteryInstalled;
-    }
-    /**
-     * Get array with full list of accessories for this inverter.
-     * @returns {AccessoryPlugin[]} Array of accessories for this inverter.
-     */
-    getAccessories() {
-        return this.solaxAccessories;
-    }
-}
-exports.SolaxCloudAPIPlatformInverter = SolaxCloudAPIPlatformInverter;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolaxCloudAPIPlatformInverter = exports.ACCESSORY_KEYS = exports.INVERTER_BRAND = void 0;
+const solax_cloud_api_1 = require("solax-cloud-api");
+const outletAccessory_1 = require("./outletAccessory");
+const lightSensorAccessory_1 = require("./lightSensorAccessory");
+const motionAccessory_1 = require("./motionAccessory");
+const batteryAccessory_1 = require("./batteryAccessory");
+/**
+ * Inverter brand.
+ */
+exports.INVERTER_BRAND = {
+    SOLAX: 0,
+    QCELLS: 1,
+};
+/**
+ * Standard names for accessories.
+ */
+exports.ACCESSORY_KEYS = {
+    pv: 'pv',
+    inverterToBattery: 'inverterToBattery',
+    inverterFromBattery: 'inverterFromBattery',
+    inverterAC: 'inverterAC',
+    inverterToGrid: 'inverterToGrid',
+    inverterToHouse: 'inverterToHouse',
+    gridToHouse: 'gridToHouse',
+};
+/**
+ * Standard names for accessories.
+ */
+const ACCESSORY_NAMES = {
+    pv: 'PV',
+    inverterToBattery: 'To Battery',
+    inverterFromBattery: 'From Battery',
+    inverterAC: 'AC',
+    inverterToGrid: 'To Grid',
+    inverterToHouse: 'To House',
+    gridToHouse: 'From Grid',
+};
+/**
+ * Standar prefixes for accessory serials.
+ */
+const ACCESSORY_SERIAL_PREFIXES = {
+    pv: 'pv',
+    inverterToBattery: 'inv-tobat',
+    inverterFromBattery: 'inv-frombat',
+    inverterAC: 'inv-ac',
+    inverterToGrid: 'inv-grid',
+    inverterToHouse: 'inv-house',
+    gridToHouse: 'grid-house',
+};
+/**
+ * SolaxCloudAPIPlatformInverter.
+ * This class is the main constructor for your inverter accessories
+ * to be used by Homebridge.
+ */
+class SolaxCloudAPIPlatformInverter {
+    /**
+      * Platform inverter constructor.
+      * @param log
+      * @param config
+      * @param api
+      * @param brand
+      * @param tokenId
+      * @param sn
+      * @param name
+      * @param hasBattery
+      * @param smoothingWindow
+      * @returns
+      */
+    constructor(log, config, api, brand, tokenId, sn, name, hasBattery, smoothingWindow, virtual = false, brandName = SolaxCloudAPIPlatformInverter.getInverterBrandName(brand)) {
+        /** Array with all accessories */
+        this.solaxAccessories = [];
+        // store values in properties
+        this.log = log;
+        this.config = config;
+        this.api = api;
+        // setup inverter data
+        this.sn = sn.toLowerCase();
+        this.name = name;
+        this.brandName = brandName;
+        this.virtual = virtual;
+        this.smoothingWindow = smoothingWindow;
+        this.batteryInstalled = hasBattery;
+        this.log.info(`Initialing acessories for inverter "${name}" (SN="${sn}") from ${this.brandName}...`);
+        let inverterModel = 'Unknown';
+        if (!this.virtual) {
+            // init new Solax Cloud API object with give tokenID and sn
+            this.solaxCloudAPI = new solax_cloud_api_1.SolaxCloudAPI(brand, tokenId, sn);
+            // initial data set
+            const apiData = this.solaxCloudAPI.getAPIData();
+            this.log.debug(`apiData = ${JSON.stringify(apiData)}`);
+            if (apiData.success) {
+                inverterModel = solax_cloud_api_1.SolaxCloudAPI.getInverterType(apiData.result.inverterType);
+            }
+            else {
+                this.log.info(`Could not retrieve initial values from ${this.brandName} ` +
+                    'Cloud, accessory Serial Number and Model properties deferred...');
+            }
+        }
+        // setup raw outlet accessories
+        this.rawOutlets = {
+            pv: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv}`, `${ACCESSORY_SERIAL_PREFIXES.pv}-${this.sn}`, inverterModel),
+            inverterFromBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery}`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-${this.sn}`, inverterModel),
+            inverterToBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery}`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-${this.sn}`, inverterModel),
+            inverterAC: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC}`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-${this.sn}`, inverterModel),
+            inverterToGrid: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid}`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-${this.sn}`, inverterModel),
+            inverterToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse}`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-${this.sn}`, inverterModel),
+            gridToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse}`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-${this.sn}`, inverterModel),
+        };
+        // setup update motion sensor
+        this.motionUpdate =
+            new motionAccessory_1.SolaxMotionAccessory(this.log, this.api, `${this.name} Update`, `update-${this.sn}`, inverterModel);
+        // create array with all valid base accessories
+        this.solaxAccessories =
+            [this.rawOutlets.pv, this.rawOutlets.inverterAC, this.rawOutlets.inverterToGrid,
+                this.rawOutlets.inverterToHouse, this.rawOutlets.gridToHouse, this.motionUpdate];
+        if (this.hasBattery()) {
+            this.battery = new batteryAccessory_1.SolaxBatteryAccessory(this.log, this.api, `${this.name} Battery`, `bat-${this.sn}`, inverterModel);
+            this.solaxAccessories.push(this.battery, this.rawOutlets.inverterFromBattery, this.rawOutlets.inverterToBattery);
+        }
+        // check if "pure" Home App accessories are needed
+        if (this.config.pureHomeApp) {
+            // add raw light sensors
+            this.rawLightSensors = {
+                pv: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv} sensor`, `${ACCESSORY_SERIAL_PREFIXES.pv}-light-${this.sn}`, inverterModel),
+                inverterFromBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-light-${this.sn}`, inverterModel),
+                inverterToBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-light-${this.sn}`, inverterModel),
+                inverterAC: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-light-${this.sn}`, inverterModel),
+                inverterToGrid: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-light-${this.sn}`, inverterModel),
+                inverterToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse} sensor`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-light-${this.sn}`, inverterModel),
+                gridToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse} sensor`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-light-${this.sn}`, inverterModel),
+            };
+            this.solaxAccessories.push(this.rawLightSensors.pv, this.rawLightSensors.inverterAC, this.rawLightSensors.inverterToGrid, this.rawLightSensors.inverterToHouse, this.rawLightSensors.gridToHouse);
+            if (this.batteryInstalled) {
+                this.solaxAccessories.push(this.rawLightSensors.inverterFromBattery, this.rawLightSensors.inverterToBattery);
+            }
+            if (this.config.smoothMeters) {
+                // add smooth light sensors
+                this.smoothLightSensors = {
+                    pv: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.pv}-light-smooth-${this.sn}`, inverterModel),
+                    inverterFromBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-light-smooth-${this.sn}`, inverterModel),
+                    inverterToBattery: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-light-smooth-${this.sn}`, inverterModel),
+                    inverterAC: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-light-smooth-${this.sn}`, inverterModel),
+                    inverterToGrid: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-light-smooth-${this.sn}`, inverterModel),
+                    inverterToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-light-smooth-${this.sn}`, inverterModel),
+                    gridToHouse: new lightSensorAccessory_1.SolaxLightSensorAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse} sensor (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-light-smooth-${this.sn}`, inverterModel),
+                };
+                this.solaxAccessories.push(this.smoothLightSensors.pv, this.smoothLightSensors.inverterAC, this.smoothLightSensors.inverterToGrid, this.smoothLightSensors.inverterToHouse, this.smoothLightSensors.gridToHouse);
+                if (this.batteryInstalled) {
+                    this.solaxAccessories.push(this.smoothLightSensors.inverterFromBattery, this.smoothLightSensors.inverterToBattery);
+                }
+            }
+        }
+        else {
+            if (this.config.smoothMeters) {
+                // setup smooth outlet accessories
+                this.smoothOutlets = {
+                    pv: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.pv} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.pv}-smooth-${this.sn}`, inverterModel),
+                    inverterFromBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterFromBattery} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterFromBattery}-smooth-${this.sn}`, inverterModel),
+                    inverterToBattery: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToBattery} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToBattery}-smooth-${this.sn}`, inverterModel),
+                    inverterAC: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterAC} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterAC}-smooth-${this.sn}`, inverterModel),
+                    inverterToGrid: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToGrid} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToGrid}-smooth-${this.sn}`, inverterModel),
+                    inverterToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.inverterToHouse} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.inverterToHouse}-smooth-${this.sn}`, inverterModel),
+                    gridToHouse: new outletAccessory_1.SolaxOutletAccessory(this.log, this.api, `${this.name} ${ACCESSORY_NAMES.gridToHouse} (smooth)`, `${ACCESSORY_SERIAL_PREFIXES.gridToHouse}-smooth-${this.sn}`, inverterModel),
+                };
+                this.solaxAccessories.push(this.smoothOutlets.pv, this.smoothOutlets.inverterAC, this.smoothOutlets.inverterToGrid, this.smoothOutlets.inverterToHouse, this.smoothOutlets.gridToHouse);
+                if (this.batteryInstalled) {
+                    this.solaxAccessories.push(this.smoothOutlets.inverterFromBattery, this.smoothOutlets.inverterToBattery);
+                }
+            }
+        }
+    }
+    /**
+     * Gets the inverter brand name.
+     * @param {number} brand Inverter brand type.
+     * @returns Inverter brand name.
+     */
+    static getInverterBrandName(brand) {
+        switch (brand) {
+            case exports.INVERTER_BRAND.QCELLS:
+                return 'QCells';
+            default:
+                return 'Solax';
+        }
+    }
+    /**
+      * Update all platform accessory status based on the values read from the API.
+      * @param {SolaxCloudAPIResponse} apiData API data from Solax Cloud.
+      */
+    updateAccessories(apiData) {
+        // update raw sensors
+        this.setRawPower(exports.ACCESSORY_KEYS.pv, solax_cloud_api_1.SolaxCloudAPI.getPVPower(apiData.result));
+        this.setRawPower(exports.ACCESSORY_KEYS.inverterFromBattery, solax_cloud_api_1.SolaxCloudAPI.getInverterPowerFromBattery(apiData.result));
+        this.setRawPower(exports.ACCESSORY_KEYS.inverterToBattery, solax_cloud_api_1.SolaxCloudAPI.getInverterPowerToBattery(apiData.result));
+        this.setRawPower(exports.ACCESSORY_KEYS.inverterAC, solax_cloud_api_1.SolaxCloudAPI.getInverterACPower(apiData.result));
+        this.setRawEnergy(exports.ACCESSORY_KEYS.inverterAC, solax_cloud_api_1.SolaxCloudAPI.getYieldTotal(apiData.result));
+        this.setRawPower(exports.ACCESSORY_KEYS.inverterToGrid, solax_cloud_api_1.SolaxCloudAPI.getInverterPowerToGrid(apiData.result));
+        this.setRawPower(exports.ACCESSORY_KEYS.inverterToHouse, solax_cloud_api_1.SolaxCloudAPI.getInverterPowerToHouse(apiData.result));
+        this.setRawPower(exports.ACCESSORY_KEYS.gridToHouse, solax_cloud_api_1.SolaxCloudAPI.getGridPowerToHouse(apiData.result));
+        if (this.config.smoothMeters) {
+            // update smooth light sensors from raw outlets by applying smoothing function to power consumption
+            this.setSmoothPower(exports.ACCESSORY_KEYS.pv);
+            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterFromBattery);
+            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterToBattery);
+            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterAC);
+            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterToGrid);
+            this.setSmoothPower(exports.ACCESSORY_KEYS.inverterToHouse);
+            this.setSmoothPower(exports.ACCESSORY_KEYS.gridToHouse);
+        }
+        // check for battery
+        if (this.hasBattery()) {
+            this.setBatteryLevel(solax_cloud_api_1.SolaxCloudAPI.getBatterySoC(apiData.result));
+            if (this.getRawPower(exports.ACCESSORY_KEYS.inverterToBattery) > 0) {
+                this.setBatteryChargeState(batteryAccessory_1.BATTERY_CHARGING_STATE.CHARGING);
+            }
+            else if (this.getRawPower(exports.ACCESSORY_KEYS.inverterFromBattery) > 0) {
+                this.setBatteryChargeState(batteryAccessory_1.BATTERY_CHARGING_STATE.NOT_CHARGING);
+            }
+            else {
+                this.setBatteryChargeState(batteryAccessory_1.BATTERY_CHARGING_STATE.NOT_CHARGEABLE);
+            }
+        }
+        // notify update with motion sensor
+        this.setMotionUpdate();
+    }
+    /**
+     * Sets the battery charge state for this inverter.
+     * @param {number} state The desired battery charge state.
+     */
+    setBatteryChargeState(state) {
+        this.battery.setChargeState(state);
+    }
+    /**
+     * Gets the battery charge state for this inverter.
+     * @returns {number} Battery charge state.
+     */
+    getBatteryChargeState() {
+        return this.battery.getChargeStateValue();
+    }
+    /**
+     * Sets the current battery level for this inverter.
+     * @param {number} percentage Battery level to set (percentage).
+     */
+    setBatteryLevel(percentage) {
+        this.battery.setLevel(percentage);
+    }
+    /**
+     * Gets the current battery level for this inverter.
+     * @returns {number} The current battery level (percentage).
+     */
+    getBatteryLevel() {
+        return this.battery.getLevelValue();
+    }
+    /**
+     * Sets virtual update motion detector to true to notify of new data update.
+     */
+    setMotionUpdate() {
+        this.motionUpdate.setState(true);
+    }
+    /**
+     * Gets raw accessory power for this inverter.
+     * @param {string} key Accessory key.
+     * @returns {number} Power consumptions for this accessory.
+     */
+    getRawPower(key) {
+        return this.rawOutlets[key].getPowerConsumptionValue();
+    }
+    /**
+     * Sets raw accessory power for this inverter.
+     * @param {string} key Accessory key.
+     * @param {number} power Power to set (in Watt).
+     */
+    setRawPower(key, power) {
+        this.rawOutlets[key].setPowerConsumption(power);
+        if (this.config.pureHomeApp) {
+            this.rawLightSensors[key].setAmbientLightLevel(power);
+        }
+    }
+    /**
+     * Gets raw accessory energy for this inverter.
+     * @param {string} key Accessory key.
+     * @returns {number} The energy consumption for the desired acessory (in Wh).
+     */
+    getRawEnergy(key) {
+        return this.rawOutlets[key].getTotalEnergyConsumptionValue();
+    }
+    /**
+     * Sets raw accessory energy for this inverter.
+     * @param {string} key Accessory key.
+     * @param {number} energy Energy consumption to set (in Wh).
+     */
+    setRawEnergy(key, energy) {
+        this.rawOutlets[key].setTotalEnergyConsumption(energy);
+    }
+    /**
+     * Sets smooth accessory power from raw accessory power for this inverter.
+     * @param {string} key Accessory key.
+     */
+    setSmoothPower(key) {
+        const smoothPower = this.rawOutlets[key].getSmoothPowerConsumption(this.config.smoothingMethod, this.smoothingWindow);
+        if (this.config.pureHomeApp) {
+            this.smoothLightSensors[key].setAmbientLightLevel(smoothPower);
+        }
+        else {
+            this.smoothOutlets[key].setPowerConsumption(smoothPower);
+        }
+    }
+    /**
+     * Update data from this inverter by using the Solax Cloud API
+     */
+    updateInverterDataFromCloud() {
+        try {
+            if (this.virtual || !this.solaxCloudAPI) {
+                return;
+            }
+            this.log.info(`Retrieving data from ${this.brandName} ` +
+                `Cloud API for inverter "${this.name}" (SN="${this.sn}")`);
+            const apiData = this.solaxCloudAPI.getAPIData();
+            if (apiData.success) {
+                this.log.debug(`Retrieved inverter status: ${JSON.stringify(apiData.result)}`);
+                this.updateAccessories(apiData);
+            }
+            else {
+                throw new Error(apiData.exception);
+            }
+        }
+        catch (error) {
+            this.log.error(`Failed to read from ${this.brandName} ` +
+                `Cloud API for inverter "${this.name}" (SN="${this.sn})". Error: ${error}`);
+        }
+    }
+    /**
+     * Returns whether this inverter has a battery installed.
+     * @returns {boolean} Whether this inverter battery has a battery installed.
+     */
+    hasBattery() {
+        return this.batteryInstalled;
+    }
+    /**
+     * Get array with full list of accessories for this inverter.
+     * @returns {AccessoryPlugin[]} Array of accessories for this inverter.
+     */
+    getAccessories() {
+        return this.solaxAccessories;
+    }
+}
+exports.SolaxCloudAPIPlatformInverter = SolaxCloudAPIPlatformInverter;
 //# sourceMappingURL=platformInverter.js.map