Netatmo: Difference between revisions

From Domoticz
Jump to navigation Jump to search
Walter vl (talk | contribs)
Updated fully
Walter vl (talk | contribs)
mNo edit summary
Line 1: Line 1:
<span id="Netatmo"></span>
== About Netatmo Hardware ==
= About Netatmo Hardware =
 
Features supported:
Features supported:
* Temperature sensor,
* Temperature sensor,
Line 15: Line 13:
* Alert Sensor for Security Events,
* Alert Sensor for Security Events,


== Installation ==
Be sure you have enabled "Accept new Hardware Devices" in menu Setup - Settings


<span id="Install :"></span>
= Install =


Enable "Accept new Hardware Devices" in Setup/Setting
''New Netatmo Authentication method implemented from 2024.1''
 
New Netatmo Authentication method implemented from 2024.1


Log in on dev.netatmo.com (https://dev.netatmo.com/)
Log in on dev.netatmo.com (https://dev.netatmo.com/)
Line 34: Line 30:




On the Hardware page from Domoticz;
On the Hardware page from Domoticz (menu Setup - Hardware):
 
select HardwareType 'Netatmo'


Fill in a Name
* '''Hardware Type''': Netatmo.


Fill in <code>Clientid</code> and <code>Clientsecret</code> from the Netatmo App
*'''Name''': This is the name you want for your Hardware module.
*  '''Log level''': Leave default
*  '''Data Timeout''': leave default
* '''Client ID''': <code>Client ID</code> obtained from Netatmo Development Site
* '''Client Secret''': <code>Client Secret</code> obtained from Netatmo Development Site.
* '''Scope''': Select here the Scope for your Netatmo Devices, make sure you only select scopes compatible with your devices!


Select the correct scope(s) for your devices
[[File:Netatmo-2.png|none|frame]]
[[File:Netatmo-2.png|none|frame]]




Press Button Login.
 
Press Button '''Login'''.


You can Login to Netatmo with E-mail and Password. (If you are already Login in you get directly to the Accept page.)
You can Login to Netatmo with E-mail and Password. (If you are already Login in you get directly to the Accept page.)
Line 61: Line 60:




And press Accept.
 
And press '''Accept'''.


This closes the window and when everything is correct the plugin works.
This closes the window and when everything is correct the plugin works.
Line 67: Line 67:
You get a message that nothing is selected.
You get a message that nothing is selected.


Click on the ADD button to add the Netatmo to Domoticz.
Click on the '''ADD''' button to add the Netatmo Hardware to Domoticz.


In menu Setup - Devices the connected devices should be shown (can take some time)
In menu Setup - Devices the connected devices should be shown (can take some time)


=== With a existing installation; ===
== With an existing Netatmo installation from older version ==
On the Hardware page from Domoticz;
On the Hardware page from Domoticz;


you select the Netatmo Hardware Line
Select the Netatmo Hardware Line


Fill in Clientid and clientsecret
Fill in Clientid and clientsecret
Line 80: Line 80:
Select the correct scope(s) for your devices
Select the correct scope(s) for your devices


Press Button Login.
Press Button '''Login'''.


You can Login to Netatmo with E-mail and Password. (If you are already Login in you get directly to The accept page.
You can Login to Netatmo with E-mail and Password. (If you are already Login in you get directly to The accept page.
Line 88: Line 88:
Then the Accept Page is displayed, You scroll to the bottom.
Then the Accept Page is displayed, You scroll to the bottom.


And press Accept.
And press '''Accept'''.


This closes the window and when everything is correct the plugin works.
This closes the window and when everything is correct the plugin works.


When you want to disable the plugin


you select the Hardware Line on the Hardware page from Domoticz
When you want to disable the gateway you select the Hardware Line on the Hardware page from Domoticz.


switch the Enable button to Red and press update
Switch the Enable button to Red and press '''Update'''


When you want to enable the plugin


you select the Hardware Line on the Hardware page from Domoticz
When you want to enable the gateway you select the Hardware Line on the Hardware page from Domoticz.


switch the Enable button to Green and press update
Switch the Enable button to Green and press '''Update'''


The Add button is not in use anymore but still visible, this is different as normal expected for Domoticz.
Do not use the Add button as it will create a new instance of the Netatmo gateway.


=== Problem situation ===
== Problem situation ==
When you restart Domoticz or enable the plugin to close to the authentication then Netatmo Blocks the request,
When you restart Domoticz or enable the gateway to close to the authentication then Netatmo Blocks the request,


and keeps blocking as long as there are continuous requests.
and keeps blocking as long as there are continuous requests.
Line 127: Line 125:
* Welkom camera  (Only Events),
* Welkom camera  (Only Events),
* Door Tag,
* Door Tag,
<span id="settings"></span>
= Settings =
Settings for Netatmo are found in the Domoticz GUI: '''Name: &gt; Client ID: &gt; Client Secret: &gt; Scope:''':
*  '''Name''': This is the name you wan't for your Hardware module.
*  '''Log level''',
*  '''Data Timeout''',
** '''Client ID''': Client ID obtained from Netatmo Development Site
** '''Client Secret''': Client Secret obtained from Netatmo Development Site.
** '''Scope''': Select here the Scope for your Netatmo Devices, make sure you only select scopes compatible with your devices!


<span id="troubleshooting"></span>
<span id="troubleshooting"></span>
= Troubleshooting =


== Troubleshooting ==
So, you think if you have done everything correctly but things do not work (in some way) as you expected. Here are a couple steps you can do to find the cause.
So, you think if you have done everything correctly but things do not work (in some way) as you expected. Here are a couple steps you can do to find the cause.


Line 156: Line 142:


The Domoticz forum is a great resource for help and solutions. Check the [https://forum.domoticz.com Forum].
The Domoticz forum is a great resource for help and solutions. Check the [https://forum.domoticz.com Forum].
<span id="wiki Netamo Domoticz."></span>
= History [https://wiki.domoticz.com/Netatmo link to wiki] =

Revision as of 14:53, 22 March 2025

About Netatmo Hardware

Features supported:

  • Temperature sensor,
  • Set point switch,
  • "away" mode switch,
  • Heating Status Switch,
  • Temperature & Humidity Sensor,
  • Barometer Sensor,
  • Rain Sensor,
  • Air QUality Sensor,
  • Sound Sensor,
  • Wind Sensor,
  • Alert Sensor for Security Events,

Installation

Be sure you have enabled "Accept new Hardware Devices" in menu Setup - Settings


New Netatmo Authentication method implemented from 2024.1

Log in on dev.netatmo.com (https://dev.netatmo.com/)

On dev.netatmo.com you create an App.

The Redirect_URI and Webhook URI should be empty.

Press save 2 times.

This gives you the Clientid and Clientsecret


On the Hardware page from Domoticz (menu Setup - Hardware):

  • Hardware Type: Netatmo.
  • Name: This is the name you want for your Hardware module.
  • Log level: Leave default
  • Data Timeout: leave default
  • Client ID: Client ID obtained from Netatmo Development Site
  • Client Secret: Client Secret obtained from Netatmo Development Site.
  • Scope: Select here the Scope for your Netatmo Devices, make sure you only select scopes compatible with your devices!


Press Button Login.

You can Login to Netatmo with E-mail and Password. (If you are already Login in you get directly to the Accept page.)


You see a configuration screen from Netatmo.


Then the Accept Page is displayed, You scroll to the bottom.


And press Accept.

This closes the window and when everything is correct the plugin works.

You get a message that nothing is selected.

Click on the ADD button to add the Netatmo Hardware to Domoticz.

In menu Setup - Devices the connected devices should be shown (can take some time)

With an existing Netatmo installation from older version

On the Hardware page from Domoticz;

Select the Netatmo Hardware Line

Fill in Clientid and clientsecret

Select the correct scope(s) for your devices

Press Button Login.

You can Login to Netatmo with E-mail and Password. (If you are already Login in you get directly to The accept page.

You see a configuration screen from Netatmo.

Then the Accept Page is displayed, You scroll to the bottom.

And press Accept.

This closes the window and when everything is correct the plugin works.


When you want to disable the gateway you select the Hardware Line on the Hardware page from Domoticz.

Switch the Enable button to Red and press Update


When you want to enable the gateway you select the Hardware Line on the Hardware page from Domoticz.

Switch the Enable button to Green and press Update

Do not use the Add button as it will create a new instance of the Netatmo gateway.

Problem situation

When you restart Domoticz or enable the gateway to close to the authentication then Netatmo Blocks the request,

and keeps blocking as long as there are continuous requests.

When I manually stop the system and wait 20 min then the Block is lifted and the authentication is OK

There is a access token and refresh token

supported Devices

At the moment, the supported Devices are;

  • Weather station,
  • Netatmo thermostat,
  • Netatmo Valves,
  • Homecoach,
  • CO2detector,
  • Smokedetector,
  • Presence camera (Only Events),
  • Welkom camera (Only Events),
  • Door Tag,

Troubleshooting

So, you think if you have done everything correctly but things do not work (in some way) as you expected. Here are a couple steps you can do to find the cause.

Turn on debug logging

Edit your /etc/systemd/system/domoticz.service file to;

ExecStart=/home/domoticz/domoticz -www 8484 -sslwww 8443 -log "/var/log/domoticz.log" -loglevel all -debuglevel normal,hardware,received,eventsystem WorkingDirectory=/home/domoticz


Get help

The Domoticz forum is a great resource for help and solutions. Check the Forum.