This nodes for Node-RED allow to control devices which are connected to the Home Connect system.
To use the HomeConnect nodes a Client ID and Client Secret are required. Those can be received from the home connect developer page:
https://developer.home-connect.com/
- After setting up an account, register a new application and select Authorization Code Grant Flow as the OAuth Flow.
- Set the Redirect URI to
http://<ip-address>:<port>/oauth2/auth/callback. Set theip-addressandportto match your Node-RED installation.
To install HomeConnect nodes for Node-RED, run the following command inside your Node-RED folder:
npm install node-red-contrib-homeconnect
The OAuth2 node handles the authentication for the HomeConnect Developer API.
Once the node is set up and deployed, press the button to receive the required tokens. You will be forwared to the HomeConnect Developer Portal where you will be asked to sign in and provide the necessary access rights.
| Property | Information |
|---|---|
| Name | Name of the node (optional) |
| Client Id | Enter the Client ID available on the HomeConnect Developer Portal |
| Client Secret | Enter the Client Secret available on the HomeConnect Developer Portal |
| Use Simulation | Wheter or not simulation or real appliances shall be used |
The Request node requires an OAuth2 node as an input to recevice an access token.
Additionally a second input triggers the request to the HomeConnect API.
| Property | Information |
|---|---|
| Name | Name of the node (optional) |
| Tag | Category you want to control |
| Action | Action you want to perform |
| HAID | HAID of the home appliance |
| Option Key | Option Key in case you want to control a specific option |
| Body | JSON data in case you want to set e.g. a program or option |