Skip to content

Home automation node for Fritz!Box, Fritz!DECT and FRITZ!Powerline devices.

License

Notifications You must be signed in to change notification settings

l33tCod-er/node-red-contrib-fritzapi

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

node-red-contrib-fritzapi

Control your smart home DECT devices and guest wifi through an AVM Fritz!Box with node-RED.

These nodes are a simple Node-RED wrapper for andig's ever-popular fritzapi, see there a for feature description.

Installation

The recommended way is to install directly from Node-RED under Manage palette.

Manual installation:

cd ~/.node-red
npm install node-red-contrib-fritzapi

Configuration

Depending on your FRITZ!Box configuration, a user name may be needed. If your box is configured for password-only admin access, leave the user name blank and only provide the admin password. Make sure that smart home control is enabled on the FRITZ!Box.

Usage

The packages contains thermostat, switch and guest wifi nodes under the advanced section in the palette. Thermostats and switches expect an actuator identification number AIN as ain or topic on the input message. If both ain and topic are provided, ain has precedence. Nodes have an (optional) pre-set action. It can be overriden with the action attribute on input messages. See fritzapi for a list of supported action names.

Any payload is accepted for information retrieval. For switch and wifi updates, send the desired boolean value (on or off). For thermostat updates, send the target temperature or adjustment in degrees Celsius. Temperature and outlet adjustments are only made if the desired state differs from the actual state. All updates are logged.

There are two special cases: setTempComfort (Set to day temperature) and setTempNight (Set to night temperature) do not expect a temperature as payload, because they set the target temperature to the day / night preset.

All actions output the requested or updated value.

There is a comprehensive example flow which demonstrates all use cases of the thermostat node.

To Do

  • Switches are not tested, as I do not own any. All feedback appreciated.
  • Guest Wifi control does not seem to work with FRITZ!OS 7.x

Credits

License

MIT

About

Home automation node for Fritz!Box, Fritz!DECT and FRITZ!Powerline devices.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 52.9%
  • HTML 46.1%
  • Makefile 1.0%