|
| 1 | +# Electrolux Appliance Binding |
| 2 | + |
| 3 | +This is a binding for Electrolux appliances. |
| 4 | + |
| 5 | +## Supported Things |
| 6 | + |
| 7 | +This binding supports the following thing types: |
| 8 | + |
| 9 | +- api: Bridge - Implements the Electrolux Group API that is used to communicate with the different appliances |
| 10 | +- air-purifier: The Electrolux Air Purifier |
| 11 | +- washing-machine: The Electrolux Washing Machine |
| 12 | + |
| 13 | +## Discovery |
| 14 | + |
| 15 | +After the configuration of the `api` bridge, your Electrolux appliances will be automatically discovered and placed as a thing in the inbox. |
| 16 | + |
| 17 | +### Configuration Options |
| 18 | + |
| 19 | +Only the bridge requires manual configuration. |
| 20 | +The Electrolux appliance things can be added by hand, or you can let the discovery mechanism automatically find them. |
| 21 | + |
| 22 | +#### `api` Bridge |
| 23 | + |
| 24 | +| Parameter | Description | Type | Default | Required | |
| 25 | +|--------------|--------------------------------------------------------|--------|----------|----------| |
| 26 | +| apiKey | Your created API key on developer.electrolux.one | String | NA | yes | |
| 27 | +| refreshToken | Your created refresh token on developer.electrolux.one | String | NA | yes | |
| 28 | +| refresh | Specifies the refresh interval in second | Number | 600 | yes | |
| 29 | + |
| 30 | +#### `air-purifier` Electrolux Air Purifier |
| 31 | + |
| 32 | +| Parameter | Description | Type | Default | Required | |
| 33 | +|--------------|--------------------------------------------------------------------------|--------|----------|----------| |
| 34 | +| serialNumber | Serial Number of your Electrolux appliance found in the Electrolux app | Number | NA | yes | |
| 35 | + |
| 36 | +#### `washing-machine` Electrolux Washing Machine |
| 37 | + |
| 38 | +| Parameter | Description | Type | Default | Required | |
| 39 | +|--------------|--------------------------------------------------------------------------|--------|----------|----------| |
| 40 | +| serialNumber | Serial Number of your Electrolux appliance found in the Electrolux app | Number | NA | yes | |
| 41 | + |
| 42 | +## Channels |
| 43 | + |
| 44 | +### Electrolux Air Purifier |
| 45 | + |
| 46 | +The following channels are supported: |
| 47 | + |
| 48 | +| Channel Type ID | Item Type | Description | |
| 49 | +|-----------------------------|-----------------------|--------------------------------------------------------------------------------| |
| 50 | +| temperature | Number:Temperature | This channel reports the current temperature. | |
| 51 | +| humidity | Number:Dimensionless | This channel reports the current humidity in percentage. | |
| 52 | +| tvoc | Number:Dimensionless | This channel reports the total Volatile Organic Compounds in ppb. | |
| 53 | +| pm1 | Number:Density | This channel reports the Particulate Matter 1 in microgram/m3. | |
| 54 | +| pm2_5 | Number:Density | This channel reports the Particulate Matter 2.5 in microgram/m3. | |
| 55 | +| pm10 | Number:Density | This channel reports the Particulate Matter 10 in microgram/m3. | |
| 56 | +| co2 | Number:Dimensionless | This channel reports the CO2 level in ppm. | |
| 57 | +| fan-speed | Number | This channel sets and reports the current fan speed (1-9). | |
| 58 | +| filter-life | Number:Dimensionless | This channel reports the remaining filter life in %. | |
| 59 | +| ionizer | Switch | This channel sets and reports the status of the Ionizer function (On/Off). | |
| 60 | +| door-state | Contact | This channel reports the status of the door (Opened/Closed). | |
| 61 | +| work-mode | String | This channel sets and reports the current work mode (Auto, Manual, PowerOff.) | |
| 62 | +| ui-light | Switch | This channel sets and reports the status of the UI Light function (On/Off). | |
| 63 | +| safety-lock | Switch | This channel sets and reports the status of the Safety Lock function. | |
| 64 | +| status | String | This channel is used to fetch latest status from the API. | |
| 65 | + |
| 66 | +### Electrolux Washing Machine |
| 67 | + |
| 68 | +The following channels are supported: |
| 69 | + |
| 70 | +| Channel Type ID | Item Type | Description | |
| 71 | +|------------------------------|-----------------------|--------------------------------------------------------------------------------| |
| 72 | +| door-state | Contact | This channel reports the status of the door (Opened/Closed). | |
| 73 | +| door-lock | Contact | This channel reports the status of the door lock. | |
| 74 | +| time-to-start | Number:Time | This channel reports the remaining time for a delayed start washing program. | |
| 75 | +| time-to-end | Number:Time | This channel reports the remaining time to the end for a washing program. | |
| 76 | +| cycle-phase | String | This channel reports the washing cycle phase. | |
| 77 | +| analog-temperature | String | This channel reports the washing temperature. | |
| 78 | +| steam-value | String | This channel reports the washing steam value. | |
| 79 | +| programs-order | String | This channel reports the washing program. | |
| 80 | +| analog-spin-speed | String | This channel reports the washing spin speed. | |
| 81 | +| appliance-state | String | This channel reports the appliance state. | |
| 82 | +| appliance-mode | String | This channel reports the appliance mode. | |
| 83 | +| appliance-total-working-time | Number:Time | This channel reports the total working time for the washing machine. | |
| 84 | +| appliance-ui-sw-version | String | This channel reports the appliance UI SW version. | |
| 85 | +| optisense-result | String | This channel reports the optisense result. | |
| 86 | +| detergent-extradosage | String | This channel reports the detergent extra dosage. | |
| 87 | +| softener-extradosage | String | This channel reports the softener extra dosage. | |
| 88 | +| water-usage | Number:Volume | This channel reports the water usage in litres. | |
| 89 | +| total-wash-cycles-count | Number | This channel reports the total number of washing cycles. | |
| 90 | +| status | String | This channel is used to fetch latest status from the API. | |
| 91 | + |
| 92 | +## Full Example |
| 93 | + |
| 94 | +### `demo.things` Example |
| 95 | + |
| 96 | +```java |
| 97 | +// Bridge configuration |
| 98 | +Bridge electroluxappliance:api:myAPI "Electrolux Group API" [apiKey="12345678", refreshToken="12345678", refresh="300"] { |
| 99 | + Thing air-purifier myair-purifier "Electrolux Pure A9" [ serialNummber="123456789" ] |
| 100 | +} |
| 101 | +``` |
| 102 | + |
| 103 | +## `demo.items` Example |
| 104 | + |
| 105 | +```java |
| 106 | +// CO2 |
| 107 | +Number:Dimensionless electroluxapplianceCO2 "Electrolux Air CO2 [%d ppm]" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:co2"} |
| 108 | +// Temperature |
| 109 | +Number:Temperature electroluxapplianceTemperature "Electrolux Air Temperature" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:temperature"} |
| 110 | +// Door status |
| 111 | +Contact electroluxapplianceDoor "Electrolux Air Door Status" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:doorOpen"} |
| 112 | +// Work mode |
| 113 | +String electroluxapplianceWorkModeSetting "electroluxappliance Work Mode Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:workMode"} |
| 114 | +// Fan speed |
| 115 | +Number electroluxapplianceFanSpeed "Electrolux Air Fan Speed Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:fanSpeed"} |
| 116 | +// UI Light |
| 117 | +Switch electroluxapplianceUILight "Electrolux Air UI Light Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:uiLight"} |
| 118 | +// Ionizer |
| 119 | +Switch electroluxapplianceIonizer "Electrolux Air Ionizer Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:ionizer"} |
| 120 | +// Safety Lock |
| 121 | +Switch electroluxapplianceSafetyLock "Electrolux Air Safety Lock Setting" {channel="electroluxappliance:air-purifier:myAPI:myair-purifier:safetyLock"} |
| 122 | +``` |
0 commit comments