node-red-contrib-philips-airjs 0.4.0
NodeRed node for Philips Air purifier in js.
node-red-contrib-philips-airjs
NodeRed node for Philips Air purifier in js.
What is AirJS ?
This is a node for Node-Red to view the status and send commands to Philips Air purifiers that use the COAP protocol (Encrypted). It is based on work by @biemond ( https://github.com/biemond/com.athom.philipsair.git ) and @betaboon ( https://github.com/betaboon/aioairctrl.git ).
There are other nodes in NodeRed for COAP based Philips Air purifiers but these use Python and bridge 'aioairctrl', so are not native JS implementations.
Configuration
In the IP/Host property of the node enter the IP address or Hostname of the air purifier. In the timeout property of the node enter the timeout (optional), default is 500 seconds. When not receiving a response from the device within this timeout, the node will to reconnect.
Usage
The Node will observe and receive status message with all the current state information from the device. The output of these message is in JSON format with topic 'status', content will depend on your device type.
From version 0.4.0 the node will always go in observe mode with the ability to disable it.
Commands
The input of the node accepts two type of commands.
Device control commands
These are device specific commands.
Format: key value (example: pwr 0 switches the device off).
If succesful a message will be sent to the output with topic 'command' and payload {"status":"success"}
(This means that the command has been received by the device, not that it is executed. An incompatible or not understood command can still have status of success).
In case of failure the payload will be an error message.
Some commands (device specific):
Modes (Manual, Auto, Turbo, sleep)
mode M, mode AG, mode T, mode S
Fan speed
om 1, om 2
Power On/Off
pwr 1, pwr 0
Child lock On, Off
cl True, cl False
Buttons light: ON, Off
uil 1, uil 0
Other devices might have more and other commands. For some devices you first need to set the device to manual before adjusting fan speed.
Status
The output json object is also device specific. Here are some of the outputs I use.
om - Fan speed
pwr - Power
cl - Child loc
aqil - Light brightness: 100
uil -Buttons light
mode - Mode
pm25 - PM25
iaql - Allergen
tvoc - tvoc
fltt1 - HEPA filter type
fltt2 - Active carbon filter
fltsts0 - Pre-filter and Wick: clean in ? hours
fltsts1 - HEPA filter: replace in ? hours
fltsts2 - Active carbon filter: replace in ? hours
Compatibility
The node has been tested on an AC3039.
It should be compatible with more Philips Air purifiers with COAP support like :
- AC1214
- AC2729
- AC2889
- AC2939
- AC3059
- AC3829
- AC3858
- AC4236
