# Electrolux Appliance Binding This is a binding for Electrolux appliances. ## Supported Things This binding supports the following thing types: - api: Bridge - Implements the Electrolux Group API that is used to communicate with the different appliances - air-purifier: The Electrolux Air Purifier - washing-machine: The Electrolux Washing Machine ## Discovery After the configuration of the `api` bridge, your Electrolux appliances will be automatically discovered and placed as a thing in the inbox. ### Configuration Options Only the bridge requires manual configuration. The Electrolux appliance things can be added by hand, or you can let the discovery mechanism automatically find them. #### `api` Bridge | Parameter | Description | Type | Default | Required | |--------------|--------------------------------------------------------|--------|----------|----------| | apiKey | Your created API key on developer.electrolux.one | String | NA | yes | | refreshToken | Your created refresh token on developer.electrolux.one | String | NA | yes | | refresh | Specifies the refresh interval in second | Number | 600 | yes | #### `air-purifier` Electrolux Air Purifier | Parameter | Description | Type | Default | Required | |--------------|--------------------------------------------------------------------------|--------|----------|----------| | serialNumber | Serial Number of your Electrolux appliance found in the Electrolux app | Number | NA | yes | #### `washing-machine` Electrolux Washing Machine | Parameter | Description | Type | Default | Required | |--------------|--------------------------------------------------------------------------|--------|----------|----------| | serialNumber | Serial Number of your Electrolux appliance found in the Electrolux app | Number | NA | yes | ## Channels ### Electrolux Air Purifier The following channels are supported: | Channel Type ID | Item Type | Description | |-----------------------------|-----------------------|--------------------------------------------------------------------------------| | temperature | Number:Temperature | This channel reports the current temperature. | | humidity | Number:Dimensionless | This channel reports the current humidity in percentage. | | tvoc | Number:Dimensionless | This channel reports the total Volatile Organic Compounds in ppb. | | pm1 | Number:Density | This channel reports the Particulate Matter 1 in microgram/m3. | | pm2_5 | Number:Density | This channel reports the Particulate Matter 2.5 in microgram/m3. | | pm10 | Number:Density | This channel reports the Particulate Matter 10 in microgram/m3. | | co2 | Number:Dimensionless | This channel reports the CO2 level in ppm. | | fan-speed | Number | This channel sets and reports the current fan speed (1-9). | | filter-life | Number:Dimensionless | This channel reports the remaining filter life in %. | | ionizer | Switch | This channel sets and reports the status of the Ionizer function (On/Off). | | door-state | Contact | This channel reports the status of the door (Opened/Closed). | | work-mode | String | This channel sets and reports the current work mode (Auto, Manual, PowerOff.) | | ui-light | Switch | This channel sets and reports the status of the UI Light function (On/Off). | | safety-lock | Switch | This channel sets and reports the status of the Safety Lock function. | | status | String | This channel is used to fetch latest status from the API. | ### Electrolux Washing Machine The following channels are supported: | Channel Type ID | Item Type | Description | |------------------------------|-----------------------|--------------------------------------------------------------------------------| | door-state | Contact | This channel reports the status of the door (Opened/Closed). | | door-lock | Contact | This channel reports the status of the door lock. | | time-to-start | Number:Time | This channel reports the remaining time for a delayed start washing program. | | time-to-end | Number:Time | This channel reports the remaining time to the end for a washing program. | | cycle-phase | String | This channel reports the washing cycle phase. | | analog-temperature | String | This channel reports the washing temperature. | | steam-value | String | This channel reports the washing steam value. | | programs-order | String | This channel reports the washing program. | | analog-spin-speed | String | This channel reports the washing spin speed. | | appliance-state | String | This channel reports the appliance state. | | appliance-mode | String | This channel reports the appliance mode. | | appliance-total-working-time | Number:Time | This channel reports the total working time for the washing machine. | | appliance-ui-sw-version | String | This channel reports the appliance UI SW version. | | optisense-result | String | This channel reports the optisense result. | | detergent-extradosage | String | This channel reports the detergent extra dosage. | | softener-extradosage | String | This channel reports the softener extra dosage. | | water-usage | Number:Volume | This channel reports the water usage in litres. | | total-wash-cycles-count | Number | This channel reports the total number of washing cycles. | | status | String | This channel is used to fetch latest status from the API. | ## Full Example ### `demo.things` Example ```java // Bridge configuration Bridge electroluxappliance:api:myAPI "Electrolux Group API" [apiKey="12345678", refreshToken="12345678", refresh="300"] { Thing air-purifier myair-purifier "Electrolux Pure A9" [ serialNummber="123456789" ] } ``` ## `demo.items` Example ```java // CO2 Number:Dimensionless electroluxapplianceCO2 "Electrolux Air CO2 [%d ppm]" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:co2"} // Temperature Number:Temperature electroluxapplianceTemperature "Electrolux Air Temperature" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:temperature"} // Door status Contact electroluxapplianceDoor "Electrolux Air Door Status" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:doorOpen"} // Work mode String electroluxapplianceWorkModeSetting "electroluxappliance Work Mode Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:workMode"} // Fan speed Number electroluxapplianceFanSpeed "Electrolux Air Fan Speed Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:fanSpeed"} // UI Light Switch electroluxapplianceUILight "Electrolux Air UI Light Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:uiLight"} // Ionizer Switch electroluxapplianceIonizer "Electrolux Air Ionizer Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:ionizer"} // Safety Lock Switch electroluxapplianceSafetyLock "Electrolux Air Safety Lock Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:safetyLock"} ```