README.md

ioBroker.dysonAirPurifier

ioBroker Adapter for Dyson Air Purifiers and fans

This adapter connects ioBroker to various Dyson Air Purifiers. Fan-Icon in Logo created by Freepik from www.flaticon.com.

If you like this adapter and consider supporting me
>

supported devices

• Dyson Pure Humidify+Cool (PH01, ProductType 358)
• Dyson Pure Humidify+Cool (PH03, ProductType 358E)
• Dyson Pure Humidify+Cool Formaldehyde (PH04, ProductType 358K)
• Dyson Pure Cool Tower, 2018 model (TP04, ProductType 438)
• Dyson Pure Cool Tower Formaldehyde, 2018 model (TP07, ProductType 438E)
• Dyson Pure Cool Tower Formaldehyde, 2018 model (TP07, ProductType 438K)
• Dyson Pure Hot+Cool Link (HP02, ProductType 455)
• Dyson Pure Hot+Cool Link New (ProductType 455A)
• Dyson Pure Cool Link Desk (DP01, ProductType 469)
• Dyson Pure Cool Link Tower (TP02, ProductType 475)
• Dyson Pure Cool Desk, 2018 model (DP04, ProductType 520)
• Dyson Pure Hot+Cool, 2018 model (HP04, ProductType 527)
• Dyson Pure Hot+Cool (HP07, ProductType 527E)
• Dyson Pure Hot+Cool Formaldehyde (HP09, ProductType 527K)
• Dyson Purifier Big+Quiet Formaldehyde (BP03, Produce type 664)

Features

Connects your Dyson fans, fan heaters, air purifiers, and air humidifiers to ioBroker.

• Reads values from devices and sensors
• Can control devices by giving you the ability to change some values (main power, oscillation, heating, fan speed, ...)
• Reads device list from Dyson servers
• Handles an unlimited number of fans (for sure in fact the resources of your ioBroker host limit the number).

How it works

On startup the dyson cloud gets queried for all known devices bound to your account and their MQTT passwords. With that list in hands the adapter connects to all devices locally and interacts with them.

• The connection to the dyson cloud is only needed to get the list of devices bound to your account and their MQTT passwords.
• Therefor new devices are only recognized on adapter startup.
• The dyson cloud only gets queried once during adapter startup.
• dyson fans act as a MQTT server and the adapter acts as client.
• All the communication between devices and the adapter happens locally only.
• All connection information in the adapter gets dropped and build anew during restart.

Installation

Prerequisites

• This adapter needs Node.js >= version 18.2
• At least js-Controller 3.0.0 is required
• At least Admin 6.0.0 is required
• To get this adapter running you'll need a Dyson account.
• Make sure to add your fan to your account. Either via App or online.

Adapter installation

Using npm

Run npm install iobroker.dysonairpurifier on your ioBroker installation to grab the latest version of this adapter from the npm repository.

Alternative: Using GitHub URL

Install through the ioBroker Admin UI by pointing it to the latest stable release on GitHub: https://github.com/Grizzelbee/ioBroker.dysonairpurifier/tarball/master/

You can also install older release versions using these methods (by pointing to a version tag, e.g., v0.6.0 instead of masterin the URL), but the most recent one is generally preferred.

Config-data needed

• Dyson account username
• Dyson account password (this adapter can handle passwords up to 32 characters)
• your fans/air purifiers IP address in your LAN (not in all cases).

The dyson username and password are general config data which need to be entered in the config page of the adapter. In difference the IP is entered into the field Hostname in the device tree on the devices tab page.

How to config the adapter

On the first regular start of this adapter the Dyson API is queried for all your devices and all supported devices will be created in the device tree -- with their basic information provided by the API and an additional field Hostaddress.

So please run the adapter once, and your Dyson devices will be created in the device tree with their basic settings.

Then stop the adapter, enter the IP(s) into the Hostaddress field(s) in the device tree and restart the adapter. After that your Dyson devices in the device tree should be populated with data.

Please note: Due to a non conform mDNS implementation by Dyson you'll need to provide the local IP of the device after the first run.

Additional Note: Since Version 0.7.1 the adapter tries to connect to the device by its hostname (serial number) as long as no host address/IP is given. This will work under two prerequisites:

1. There is a DNS Server running in your LAN. Either in your router (e.g. FritzBoxes have a DNS running) or a dedicated one.
2. You haven't changed the default device name.
3. The device name is properly mapped to its IP (in case you manage your DNS manually).

2-factor Authentication (since V0.9.0)

After installation of the adapter it should be started automatically - if not please start it first. After an update it will also restart automatically. In both cases it will remain in "yellow" state and probably show some errors in the log - that's fine for now.

• Open the config dialog of the adapter
• At least fill in your eMail address, the password and the country code - the rest is optional
• Click the 2FA-Code Email button to initiate the process
• You'll receive a "challengeId" automatically in the according field, an eMail and a dialog with further instructions
• enter the 6-digit code from the eMail into the field "dyson one time password"
• Click the "Finish" button
• after that you should have received a token from dyson (invisible for security purposes)
• Click save & close after you have completed your setup - the adapter should start anew and turn green.

All the values will be saved and shown furthermore.

Usually you don't need to do this 2 FA on a scheduled basis - but you may repeat it when needed.

If you are facing the 401 issue during 2-FA. Please try this workaround:

1. Log out of your dyson smartphone app
2. Wait a few minutes
3. Enter your login data to the adapter (if not already done) and follow the 2FA procedure to the end.
4. Adapter should start and turn green.
5. wait a while (up to an hour or maybe more since dyson has a blocker for too many requests in a short time frame)
6. Login back into your dyson smartphone app if you like to use it.

Controlling your device(s)

This adapter is currently able to control the following states of your devices:

• FanMode , Mode of device (Manual, Auto, Off)
• FanSpeed , Current fan speed
• Nightmode , Night mode state
• Oscillation , Oscillation of fan (On, Off).
• OscillationRight , OscillationAngle Upper Boundary
• OscillationLeft , OscillationAngle Lower Boundary
• OscillationAngle , OscillationAngle
• ContinuousMonitoring , Continuous Monitoring of environmental sensors even if device is off.
• MainPower , Main Power of fan.
• AutomaticMode , Fan is in automatic mode.
• Flowdirection , Direction the fan blows to. ON=Front; OFF=Back (aka Jet focus)
• Jetfocus , Direction the fan blows to. ON=Front; OFF=Back (aka Jet focus)
• HeatingMode , Heating Mode [ON/OFF]
• HeatingTargetTemp , Target temperature for heating
• AirQualityTarget , Target air quality for auto mode.
• HumidificationMode , On / Off
• HumidifyAutoMode , Auto / Off
• AutoHumidificationTarget , Auto HumidificationTarget
• HumidificationTarget , Manual HumidificationTarget
• TemperatureUnit , Unit to display temperature values in (Fan display).
• WaterHardness , Soft, Medium, Hard

Possible values for these states are documented below, as far as known. Fan speed only allows values from 1 to 10 and Auto. If you like to set your fan speed down to 0 you'll need to power off the main power. Which is what the dyson app does also.

SystemStates folder (since 2.4.0)

The devices are capable of reporting failures. This feature has been added in adapter version 2.4.0. For now there are only rough information on the failures, and the data points vary from device to device. If you have better information on a failure don't hesitate to report it to me to improve the adapter. All states report whether there is a failure or not. True means a failure, false means "No failure".

Poll Intervall

• Starting with v3.2.2 a poll intervall of 0 definitely disables polling. It may have worked before due to mathematics - but not for sure and with unknown side effects. This is nice to know because the devices usually send (at least mine do) their state by themself when it changes. Using this setting helps reducing your network traffic by stopping unnecessary polling.

Known issues

• No automatic IP detection of devices
• Still many unknown device messages (mostly failures and warnings)
• Filter Reset does not work since the correct mqtt message is unknown
• Sometimes the adapter loses the MQTT connection to a fan and isn't able to reconnect. This is usually no issue of the adapter itself, but an issue in your local network!
  • In some cases it's sufficient to unplug the fan for approximately 10 seconds to reset it and plug it in again. Just give it a try!
  • In other cases it has been an IP/DNS issue. Resetting the DHCP/DNS server (router) solved the issue.

Changelog

3.2.6 (2024-11-13)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: Fixed issues mentioned by adapter checker regarding responsive design

3.2.5 (2024-10-08)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: Fixed GUI issues
• (grizzelbee) Fix: Added missing files to files-section in package.json

3.2.4 (2024-10-01)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Fix: Removed plugin-sentry
• (grizzelbee) Fix: #318 Added tests for node 22
• (grizzelbee) Upd: #315 Fixed some issues mentioned by adapter-checker

3.2.3 (2024-06-21) (Marching on)

• (grizzelbee) Fix: Added missing clearInterval in onUnload

3.2.2 (2024-06-18) (Marching on)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Upd: #286 Fixed polling which got broken in v3.1.10
• (grizzelbee) Upd: Poll intervall of 0 disables polling

3.2.1 (2024-06-04) (Marching on)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Upd: #286 Fixed polling which got broken in v3.1.10

3.2.0 (2024-05-28) (Marching on)

• (grizzelbee) Chg: Lamps (Product type 552a) won't generate a warning on startup any longer but show an info that they are not supported by this adapter.
• (grizzelbee) Chg: Vacuum cleaner robots (Product types 276 and 277) won't generate a warning on startup any longer but show an info that they are not supported by this adapter.
• (grizzelbee) New: #289 Added Support for Dyson Purifier Big+Quiet Formaldehyde (BP03, Produce type 664)
• (grizzelbee) Fix: #287 Added Switzerland again to config
• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Chg: removed obsolete index_m.html
• (grizzelbee) Fix: Fixed broken NO2Index
• (grizzelbee) Fix: Fixed broken fan speeds 0-10
• (grizzelbee) Fix: Fixed polling of sensor data
• (grizzelbee) Fix: setting fan speed = Auto works

3.1.10 (2024-05-14) (Marching on)

• (grizzelbee) Fix: #281 Removed duplicate Sleeptimer field from config
• (grizzelbee) New: Enabled editing of field Sleeptimer
• (grizzelbee) Fix: #283 Late config of fields
• (grizzelbee) Fix: Mapping text values in fields Sleeptimer & fanspeed to numerical values

3.1.9 (2024-05-13) (Marching on)

• (arcticon) Fix: #278 Changeable fields are working again.

3.1.8 (2024-05-10) (Marching on)

• (arcticon) Upd: Dependencies got updated
• (grizzelbee) Chg: code refactoring
• (arcticon) Chg: code refactoring
• (arcticon) Chg: #273 Performance improvements
• (arcticon) Chg: #274 Update of outdated certificate

3.1.7 (2024-04-24) (Marching on)

• (grizzelbee) Upd: dependencies got updated
• (grizzelbee) Fix: #266 HeatingMode switch is now working correctly

3.1.6 (2024-04-24) (Marching on)

• (grizzelbee) Upd: dependencies got updated
• (grizzelbee) Fix: #266 HeatingMode switch is now working correctly

3.1.5 (2024-04-16) (Marching on)

• (grizzelbee) Fix: Requesting at least admin v6.13.16 as dependency

3.1.4 (2024-03-22) (Marching on)

• (grizzelbee) Fix: Lamps (Product type 552) won't generate a warning on startup anymore but show an info that they are not supported by this adapter.

3.1.3 (2024-02-28) (Marching on)

• (grizzelbee) Fix: 2FA Process is working again - truely

3.1.2 (2024-02-26) (Marching on)

• (grizzelbee) Upd: dependencies got updated
• (grizzelbee) Fix: 2FA Process is working again
• (grizzelbee) New: At least nodeJs V18.2.0 is required

3.1.1 (2024-02-01) (Marching on)

• (grizzelbee) Upd: dependencies got updated
• (grizzelbee) Fix: #244 Fixed PM2.5, PM10, VOC Values to be compliant to the dyson App
• (grizzelbee) Fix: #113 Fixed NO2 Values to be compliant to the dyson App
• (grizzelbee) Fix: #244 Fixed PM2.5, PM10, VOC Indexes
• (grizzelbee) New: Changed admin user interface to jsonConfig
• (grizzelbee) Upd: Code cleanup

3.0.0 (2024-01-11) (Marching on)

• (grizzelbee) Upd: dependencies got updated
• (grizzelbee) Upd: updated year of copyright in license
• (grizzelbee) New: #244 Added HCHO-Index
• (grizzelbee) Chg: BREAKING CHANGES:
  • Replaced values in field pm25 with values from pm25r and calculating them accordingly to the dyson App
  • Replaced values in field pm10 with values from pm10r and calculating them accordingly to the dyson App
  • #244 Replaced values in field hcho with values from hchr and calculating them accordingly to the dyson App
  • Fields pm25r and pm10r are now deprecated and will be removed

2.5.9 (2023-08-21) (Halo of the dark)

• (grizzelbee) Fix: Updated year in license- and readme file to make adapter checker happy

2.5.8 (2023-08-09) (Halo of the dark)

• (grizzelbee) Fix: Fixed calculation of hmax temperatures for heater models.

2.5.7 (2022-12-06) (Halo of the dark)

• (grizzelbee) New: Added support for Dyson Pure Humidify+Cool Formaldehyde (PH04, ProductType 358K)
• (grizzelbee) Upd: Upgraded axios to 1.2.1

2.5.6 (2022-11-28) (Halo of the dark)

• (grizzelbee) Fix: #213 Fixed warning due to wrong data type on field FILTER_REPLACEMENT

2.5.4 (2022-11-27) (Halo of the dark)

• (grizzelbee) Upd: #207 Downgraded axios to 0.27.2 due to an error in version 1.x returning data as binary instead of string.

2.5.3 (2022-11-26) (Halo of the dark)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Chg: #207 better and easier detection of supported devices

2.5.2 (2022-11-17) (Halo of the dark)

• (grizzelbee) Upd: Dependencies got updated
• (grizzelbee) Chg: Moved log message "requesting new state of device" from info to debug
• (grizzelbee) New: Added Dyson Pure Hot+Cool Formaldehyde (Type 527K) to device list.
• (grizzelbee) New: Added Dyson Pure Cool Tower Formaldehyde (Type 438K) to device list.

2.5.1 (2022-03-23) (Halo of the dark)

• (grizzelbee) Fix: Improved layout of config page and added tooltips to the checkboxes

2.5.0 (2022-03-22) (Halo of the dark)

• (grizzelbee) New: #185 Added config option to disable logging of reconnect events

2.4.1 (2022-03-20) (Echo from the past)

• (grizzelbee) New: Changed SystemState from text to boolean data points

2.4.0 (2022-03-17) (Echo from the past)

• (grizzelbee) New: Added warning code to device tree
• (grizzelbee) New: Added Device-faults as SystemState to device tree
• (grizzelbee) New: Added donate button to readme and config page
• (grizzelbee) Upd: Switched "Sending data to device" message from loglevel info to debug
• (grizzelbee) Upd: reduced amount of debug messages
• (grizzelbee) Upd: Updated dependencies

2.3.2 (2022-03-04) (Fairytale of doom)

• (grizzelbee) Fix: Fixed: Sentry-Error: DYSONAIRPURIFIER-D
• (grizzelbee) Upd: Updated dependencies

2.3.1 (2022-01-14) (Fairytale of doom)

• (grizzelbee) Upd: Updated dependencies
• (grizzelbee) Upd: Updated documentation

2.3.0 (2021-12-02) (Fairytale of doom)

• (grizzelbee) New: Added some GUI elements for air quality in folder icons
• (grizzelbee) New: Added support for HEPA PTFE filters
• (grizzelbee) New: Added support for Combined PTFE filters
• (grizzelbee) Chg: Fanspeed is now a number (not string anymore) to work properly with IoT-Adapter. Please delete this data point and let get recreated.

2.2.0 (2021-11-07) (Welcome to my wasteland)

• (grizzelbee) New: #154 Added support for dyson Humidify+Cool PH03/358E.

2.1.4 (2021-10-20) (Running to the edge)

• (grizzelbee) New: #152 Added token-indicator to config page in admin to show whether a token has already been received and saved or not.

2.1.3 (2021-10-17) (Running to the edge)

• (grizzelbee) Fix: #148 Hostaddress is used properly when given.
• (grizzelbee) Fix: #149 OscillationAngle "Breeze" is working now
• (grizzelbee) Fix: #150 Strange delay and jumping of boolean switches is fixed

2.1.2 (2021-10-07) (Running to the edge)

• (grizzelbee) New: Removed NO2 from general AirQuality to be more compliant to dyson-app
• (grizzelbee) Upd: Code cleanup
• (grizzelbee) Upd: Removed delay between sending a command and new values getting displayed (max 30 Secs)

2.1.1 (2021-10-05) (Running to the edge)

• (grizzelbee) New: Added some more data points
• (grizzelbee) New: Added switch for temperature unit of the fan display
• (grizzelbee) New: Improved logging of unknown data points
• (germanBluefox) Fix: Fixed icon links
• (grizzelbee) Fix: fixed dependencies badge
• (grizzelbee) Fix: added missing dependency plugin-sentry
• (grizzelbee) Fix: Setting HumidificationTarget now works

2.0.1 (2021-10-04) (Lost in forever)

• (grizzelbee) Fix: Turning on HeatingMode should work now
• (grizzelbee) Fix: Sentry-error DYSONAIRPURIFIER-7 -> Cannot read property '3' of undefined
• (grizzelbee) Upd: Updated dependencies

2.0.0 (2021-09-26) (Lost in forever)

• (grizzelbee) New: Added DeepCleanCycle to known data points
• (grizzelbee) Fix: Switching water hardness now really works
• (grizzelbee) BREAKING CHANGES: Please recreate your object tree and test your scripts!
• (grizzelbee) Chg: All ON/OFF switches are now boolean types to be more compliant to ioBroker standards for VIS and other adapters. Please delete those data points and let them being recreated if necessary.
• (grizzelbee) Chg: All angles are numbers now
• (grizzelbee) Chg: All 2-way switches are boolean now

V1.1.0 (2021-09-15) (Coming home)

• (grizzelbee) New: Added correct tier-level to io-package
• (grizzelbee) New: improved logging of unknown data points
• (grizzelbee) New: Added support for dyson Pure Hot+Cool Link (ProductType 455A)
• (grizzelbee) New: Added support for formaldehyde sensor
• (grizzelbee) New: oscillation angles can be set
• (grizzelbee) Upd: Improved OscillationAngle data point to display only the values supported by the current model
• (grizzelbee) Fix: removed info: undefined is not a valid state value for id "Hostaddress"

V1.0.0 (2021-08-26) (Dim the spotlight)

• (grizzelbee) Fix: #130 Fixed the newly introduced bug showing wrong values for temperatures
• (grizzelbee) Upd: Pushed to version 1.0.0
• (grizzelbee) Upd: Updated dependencies

V0.9.5 (2021-08-23) (Marching on)

• (grizzelbee) Doc: #124 Documented workaround for 2FA 401 Issue in ReadMe
• (grizzelbee) Fix: #128 Fixed saving of config data
• (grizzelbee) Fix: #107 Fixed type error on temperatures
• (grizzelbee) Fix: fixed warnings on startup

V0.9.4 (2021-08-20) ()

• (grizzelbee) New: #124 Credentials won't get logged but shown in a popup in admin when failing 2FA process.
• (grizzelbee) New: Added adminUI tag to io-package
• (grizzelbee) New: Cleanup of io-package

V0.9.3 (2021-08-19) (Paralyzed)

• (grizzelbee) New: #124 Leading and trailing whitespaces will be removed from all config values when saving
• (grizzelbee) New: #124 Password will be logged in clear text in case of a http 401 (unauthorized) error during 2FA
• (grizzelbee) Chg: #124 Removed general debug logging of 2FA login data

V0.9.2 (2021-08-15) (Pearl in a world of dirt)

• (bvol) New: #114 Added Switzerland to country selection in config , Thanks, @BVol, for his code!
• (grizzelbee) Fix: #119 Updated dyson certificate to enable connection again. Thanks, @Krobipd, for helping with the link
• (grizzelbee) Upd: Updated dependencies

V0.9.1 (2021-05-17) (Still breathing)

• (grizzelbee) New: #105 TP02, HP02 and others supporting the fmod token are now able to switch from Off to Auto- and manual-mode

V0.9.0 (2021-05-15) (Still breathing)

• (grizzelbee) New: Added ioBroker sentry plugin to report errors automatically
• (grizzelbee) New: Added support for Dyson Pure Cool TP07 (438E)
• (grizzelbee) New: Added support for Dyson 2-factor login method
• (grizzelbee) New: Added "keep Sensorvalues" to config to prevent destroying old values when continuous monitoring is off and fan is switched off (TP02)
• (grizzelbee) Fix: FilterLife should now be correctly in hours and percent in two separate data fields for fans supporting this (e.g. TP02)

V0.8.2 (2021-04-09) (Still breathing)

• (grizzelbee) Fix: #80 fixed npm install hint in documentation
• (grizzelbee) Fix: #82 fixed common.dataSource type with type >poll<
• (grizzelbee) Fix: #95 Added support for dyson Hot+Cool Formaldehyde (527E)
• (grizzelbee) Fix: #94 Fixed dustIndex

V0.8.1 (2021-02-19) (Fall into the flames)

• (grizzelbee) New: added icons to each fan type in device tree
• (grizzelbee) New: Showing Filter type correctly - not as code anymore
• (grizzelbee) Upd: updated dependencies

V0.8.0 (2021-02-18) (Beyond the mirror)

• (grizzelbee) New: Log as info if account is active on login; else log as warning.
• (grizzelbee) New: #21 Improvement for humidifier support
• (grizzelbee) Fix: #67 Adapter sometimes wrote objects instead of values.

V0.7.5 (2021-02-12) (I won't surrender)

• (grizzelbee) Fix: #65 Adapter get online again after changes to dyson cloud API login procedure.
• (grizzelbee) New: Adapter reconnects with new host address when it gets changed manually

V0.7.4 (2021-02-10) (Human)

• (grizzelbee) Fix: fixed adapter traffic light for info.connection
• (grizzelbee) Fix: Minor fixes

V0.7.3 (2021-02-10) (When angels fall)

• (theimo1221) Fix: #59 added default country
• (theimo1221) New: added function to mask password to dyson-utils.js
• (grizzelbee) New: extended config test and error logging
• (grizzelbee) New: added password to protectedNative in io-package.json
• (grizzelbee) Fix: fixed showing password in config (leftover from testing/fixing)
• (grizzelbee) Fix: fixed detection of needed js-controller features
• (grizzelbee) Fix: fixed detection if IP is given or not
• (grizzelbee) Upd: creating all data points with await

V0.7.2 (2021-02-10) (Songs of love and death)

• (grizzelbee) Fix: #59 Fixed bug while loading/saving config which led to wrong values displayed for country and temperature unit
• (grizzelbee) Upd: switched "Skipping unknown ..." message from info to debug

V0.7.1 (2021-02-06) (Horizons)

• (grizzelbee) New: When no host address is given - adapter tries to connect via default hostname of the device
• (grizzelbee) Fix: #13 Filterlifetime is now correctly displayed in hours and percent for devices supporting this
• (grizzelbee) Fix: #48 Fixed countrycodes for UK and USA
• (grizzelbee) Fix: #52 Fixed VOCIndex
• (grizzelbee) Fix: Removed option to control Fan state since it corresponds to the state of the fan in auto-mode. Controlling it is senseless.
• (grizzelbee) Fix: Fixed await...then antipattern.
• (grizzelbee) Fix: Fixed undefined roles
• (grizzelbee) Fix: Fixed some bad promises and moved code to dysonUtils
• (grizzelbee) Fix: Fixed encrypting password using js-controller 3.0 build-in routine
• (grizzelbee) Upd: Added topic "Controlling your device(s)" to readme
• (grizzelbee) Upd: Removed unnecessary saving of MQTT password
• (grizzelbee) Upd: #9 Added some more dyson codes for heaters and humidifiers

V0.7.0 (2021-01-08) (Afraid of the dark)

• (jpwenzel) New: Removing crypto from package dependency list (using Node.js provided version)
• (jpwenzel) New: Introducing unit tests
• (jpwenzel) New: At least NodeJs 10.0.0 is required
• (grizzelbee) New: #23 - Introduced new data field AirQuality which represents the worst value of all present indexes.
• (grizzelbee) New: BREAKING CHANGE! - switched over to the adapter-prototype build-in password encryption. Therefore, you'll need to enter your password again in config.
• (grizzelbee) New: At least js-controller 3.0.0 is required
• (grizzelbee) New: At least admin 4.0.9 is required
• (jpwenzel) Fix: General overhaul of readme
• (jpwenzel) Fix: Code refactoring
• (grizzelbee) Fix: fixed some datafield names - please delete the whole device folder and get them newly created.
• (grizzelbee) Fix: #18 - Fixed creating the indexes when there is no according sensor
• (grizzelbee) Fix: #13 - Displaying Filter life value in hours again
• (grizzelbee) Fix: #13 - Creating additional Filter life value in percent
• (grizzelbee) Fix: removed materializeTab from ioPackage
• (grizzelbee) Fix: calling setState now as callback in createOrExtendObject
• (grizzelbee) Fix: Removed non-compliant values for ROLE
• (grizzelbee) Fix: calling setState in callback of set/createObject now
• (grizzelbee) Fix: ensuring to clear all timeouts in onUnload-function

V0.6.0 (2020-10-29) (Rage before the storm)

• (grizzelbee) New: #17 - Added online-indicator for each device
• (grizzelbee) New: #19 - Extended Password length from 15 characters to 32
• (grizzelbee) New: #20 - Improved error handling on http communication with Dyson API
• (grizzelbee) Fix: Fixed typo within data field anchorpoint - please delete the old ancorpoint manually.
• (grizzelbee) Fix: #13 - Filter life value is now displayed in percent not in hours

V0.5.1 (2020-10-27) (Heart of the hurricane)

• (grizzelbee) Fix: Added missing clearTimeout

V0.5.0 (2020-10-27) (Heart of the hurricane)

• (grizzelbee) New: Editable data fields have now appropriate value lists
• (grizzelbee) New: Added more country codes
• (grizzelbee) New: Target temperature of heater can now be set - in the configured unit!
• (grizzelbee) Fix: #13 - Filter life value is now displayed in percent not in hours
• (grizzelbee) Fix: #6 - Changing the fanspeed does now fully work.

V0.4.1 (2020-10-16) (unbroken)

• (grizzelbee) New: #8 - Documented ProductTypes for better overview and user experience in ReadMe
• (grizzelbee) New: #9 - Added some Hot&Cool specific datafields
• (grizzelbee) New: Logging of from devices, when shutting down the adapter
• (grizzelbee) New: #10 - Polling device data every X (configurable) seconds for new data, hence sensors don't send updates on changing values
• (grizzelbee) New: #11 - Added Austria and France to Country-List
• (grizzelbee) Fix: Fixed bug in error handling when login to Dyson API fails
• (grizzelbee) Fix: #12 - Fixed Dyson API login by completely securing via HTTPS.
• (grizzelbee) Fix: Updated some descriptions in config

V0.4.0 (2020-09-29)

• (grizzelbee) New: devices are now controllable
• (grizzelbee) New: state-change-messages are processed correctly now
• (grizzelbee) Fix: Added missing °-Sign to temperature unit
• (grizzelbee) Fix: Terminating adapter when starting with missing Dyson credentials
• (grizzelbee) Fix: NO2 and VOC Indices should work now
• (grizzelbee) Fix: Fixed build errors

V0.3.0 (2020-09-27) - first version worth giving it a try

• (grizzelbee) New: Messages received via Web-API and MQTT getting processed
• (grizzelbee) New: datapoints getting created and populated
• (grizzelbee) New: Added config item for desired temperature unit (Kelvin, Fahrenheit, Celsius)
• (grizzelbee) New: Added missing product names to product numbers
• (grizzelbee) New: Hostaddress/IP is editable / configurable
• (grizzelbee) New: calculate quality indexes for PM2.5, PM10, VOC and NO2 according to Dyson App

V0.2.0 (2020-09-22) - not working! Do not install/use

• (grizzelbee) New: Login to Dyson API works
• (grizzelbee) New: Login to Dyson AirPurifier (2018 Dyson Pure Cool Tower [TP04]) works
• (grizzelbee) New: mqtt-Login to [TP04] works
• (grizzelbee) New: mqtt-request from [TP04] works
• (grizzelbee) New: mqtt-request to [TP04] is responding

V0.1.0 (2020-09-04) - not working! Do not install/use

• (grizzelbee) first development body (non-functional)

Explanation of Dyson API data (message payload)

Information copied and extended from https://github.com/shadowwa/Dyson-MQTT2RRD/blob/master/README.md

CURRENT-STATE

name	meaning	possible values	Unit
mode-reason	Current Mode has been set by RemoteControl, App, Scheduler	PRC, LAPP, LSCH, PUI
state-reason		MODE
rssi	WIFI Strength	-100 - 0	dBm
channel	WIFI Channel	52
fqhp		96704
fghp		70480

product-state

| name | meaning | possible values | Unit | | ---- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | --- | | ercd | Last Error Code | NONE , or some hexa values | | | filf | remaining Filter life | 0000 - 4300 | hours | | fmod | Mode | FAN , AUTO, OFF | | | fpwr | Main Power | ON, OFF | | | fnst | Fan Status | ON , OFF, FAN | | | fnsp | Fan speed | 0001 - 0010, AUTO | | | fdir | Fandirection aka. Jet focus/ ON=Front, OFF=Back | ON, OFF | | | ffoc | JetFocus | ON, OFF | | | nmod | Night mode | ON , OFF | | | oson | Oscillation | ON , OFF | | | osal | OscillationAngle Lower Boundary | 0005 - 355 | ° (degrees) | | osau | OscillationAngle Upper Boundary | 0005 - 355 | ° (degrees) | | oscs | OscillationActive | ON, OFF, IDLE | | | ancp | OscillationAngle | CUST, 0180 | ° (degrees) | | qtar | Air Quality target | 0001=Good, 0002=Normal, 0003=Bad, 0004=Very bad | | | rhtm | Continuous Monitoring | ON, OFF | | | auto | AutomaticMode | ON, OFF | | | nmdv | NightMode Max Fanspeed? | 0004 | | | cflr | Status Carbonfilter | 0000 - 0100 | Percent | | cflt | Carbonfilter | CARF, NONE | | | hflr | Status HEPA-Filter | 0000 - 0100 | Percent | | hflt | HEPA-Filter | GHEP, GCOM | | | sltm | Sleeptimer | ON, OFF | | | | hmod | Heater Mode [ON/OFF] | HEAT | | | hmax | Target temperature for heating | 0 .. 5000 | K | | hume | HumidificationMode | ON, OFF, | | | haut | Humidify Auto Mode | HUMIDIFY_AUTO_MODE_ON, HUMIDIFY_AUTO_MODE_OFF | | | humt | Humidification Target | HUMIDIFICATION_MODE_OFF, HUMIDIFICATION_MODE_THIRTY, HUMIDIFICATION_MODE_FORTY, HUMIDIFICATION_MODE_FIFTY, HUMIDIFICATION_MODE_SIXTY, HUMIDIFICATION_MODE_SEVENTY | | | cdrr | CleanDurationRemaining | integer | minutes | | rect | AutoHumidificationTarget | integer | % | | cltr | TimeRemainingToNextClean | integer | hours | | wath | WaterHardness | SOFT="2025", MEDIUM="1350", HARD="0675" | | | wacd | WarningCode | NONE... | | | rstf | reset filter lifecycle | 'RSTF', 'STET', RESET_FILTER_LIFE_IGNORE, RESET_FILTER_LIFE_ACTION | | | corf | Temperature format | ON=Celsius, OFF=Fahrenheit | | | clcr | DeepcleanCycle | CLNO=inactive, CLAC=Deep clean in progress, CLCM=Finished | | | hsta | Heating state | ACTIVE/IDLE | | | msta | Humidification state | Active/Idle OFF, HUMD | | | psta | [HP0x] Unknown | INIT, CLNG, INV, OFF | | | bril | unknown | 0002 | LEVEL_LOW, LEVEL_MEDIUM, LEVEL_HIGH | | fqhp | unknown | | | | tilt | [HP0x] Unknown | string | | | dial | [DP0x] Unknown | | |

Error-Codes	Meaning
NONE	There is no error active
57C2	unknown
11E1	Oscillation has been disabled. Please press Button "Oscillation" on your remote to continue.

scheduler

name	meaning	possible values	Unit
dstv	daylightSavingTime	0001...
srsc	?	7c68...
tzid	timezone?	0001...

ENVIRONMENTAL-CURRENT-SENSOR-DATA

data

name	meaning	possible values	Unit
hact	Humidity (%)	0000 - 0100	Percent
pact	Dust	0000 - 0009
sltm	Sleep timer	OFF... 9999	Minutes
tact	Temperature in Kelvin	0000 - 5000	K
vact	volatile organic compounds	0001 - 0009
hcho	Formaldehyde (not used)
hchr	Formaldehyde
pm25	PM2.5 (not used)	0018
pm10	PM10 (not used)	0011
va10	volatile organic compounds	0004
noxl	NO2	0000 - 0014
p25r	PM2.5 particulate matter	0019	µg/m³
p10r	PM10 particulate matter	0018	µg/m³

ENVIRONMENTAL-AND-USAGE-DATA

Redundant values?

data

| name | meaning | possible values | Unit | | ----------- | ------------------------------------------------------------------------ | ------------------------------------------- | ----------- | --- | | pal0 - pal9 | number of second spend in this level of dust since the beginning of hour | 0000 - 3600 | | | palm | seems to be a median value of palX | | | | vol0 - vol9 | number of second spend in this level of voc since the beginning of hour | 0000 - 3600 | | | volm | seems to be a median value of volX | | | | aql0 - aql9 | number of second spend in this level of air quality | max (pal, vol)) since the beginning of hour | 0000 - 3600 | | | aqlm | seems to be a median value of aqlX | | | | fafs | seems to be a number of seconds spend in a specific time | 0000 - 3600 | | | faos | seems to be a number of seconds spend in a specific time | 0000 - 3600 | | | fofs | seems to be a number of seconds spend in a specific time | 0000 - 3600 | | | fons | seems to be a number of seconds spend in a specific time | 0000 - 3600 | | | humm | humidity ? (%) | 0000 - 0100 | | | tmpm | temperature in kelvin ? | 0000 - 5000 | |

sentry.io

This adapter uses sentry.io to collect details on crashes and report it automated to the author. The ioBroker.sentry plugin is used for it. Please refer to the plugin homepage for detailed information on what the plugin does, which information is collected and how to disable it, if you don't like to support the author with your information on crashes.

Legal Notices

Dyson, pure cool, pure hot & cool, and others are trademarks or registered trademarks of Dyson Ltd. All other trademarks are the property of their respective owners.

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Copyright (c) 2024 Hanjo Hingsen open-source@hingsen.de