Fork me on GitHub

pimatic-netatmo by Lukas Reinhart (thex) | github | npm

Pimatic Netatmo plugin

For this plugin to work you need to register an application with netatmo. This only takes a few seconds on the netatmo developer page with your normal netatmo account.

https://dev.netatmo.com/dev/createapp

Just provide a Name and a Description and accept the "terms of use" and click create. You will be immediately presented with the needed credentials.

Example config.json entries:

  "plugins": [
    {
      "plugin": "netatmo",
      "client_id": "1293484deadbeef1112344de",
      "client_secret": "SoM3f4NcyS3crE7fR0mN3t4Tm0",
      "username": "blah@blub.com",
      "password": "TheMostSecurePasswordInTheWorld42"
    }
  ],

  "devices": [
    {
      "id": "netatmo-test",
      "name": "My Netatmo Base",
      "class": "NetatmoBase",
      "device_id": "XX:XX:XX:XX:XX:XX",
      "interval": 60
    },
    {
      "id": "netatmo-otdoor",
      "name": "My Netatmo Outdoor",
      "class": "NetatmoOutdoorModule",
      "device_id": "XX:XX:XX:XX:XX:XX",
      "module_id": "XX:XX:XX:XX:XX:XX",
      "interval": 60
    }
    ,
    {
      "id": "netatmo-wind",
      "name": "My Netatmo Wind Gauge",
      "class": "NetatmoWindGauge",
      "device_id": "XX:XX:XX:XX:XX:XX",
      "module_id": "XX:XX:XX:XX:XX:XX",
      "interval": 60
    }
    ,
    {
      "id": "netatmo-rain",
      "name": "My Netatmo Rain Sensor",
      "class": "NetatmoRainSensor",
      "device_id": "XX:XX:XX:XX:XX:XX",
      "module_id": "XX:XX:XX:XX:XX:XX",
      "interval": 60
    }
  ]

I also added support for NetatmoIndoorModule, NetatmoRainSensor and NetatmoWindGauge but as I don't have the hardware this is completely untested. Feel free to donate hardware.

Plugin Config Options

Netatmo Settings
OptionDescriptionDefault
client_id
string
Netatmo client id obtained via https://dev.netatmo.com/dev/createapp
""
client_secret
string
Netatmo client secret obtained via https://dev.netatmo.com/dev/createapp
""
username
string
Netatmo username
""
password
string
Netatmo password
""

Device Config Options

pimatic-netatmo device config schemas

NetatmoBase

Netatmo Base Station
OptionDescriptionDefault
device_id
string
Device ID retrieved from plugin startup output
interval
number
Polling interval for current measurements (>60s recommended)
60

NetatmoOutdoorModule

Netatmo Outdoor Module
OptionDescriptionDefault
device_id
string
Base Station Device ID retrieved from plugin startup output
module_id
string
Module ID retrieved from plugin startup output
interval
number
Polling interval for current measurements (>60s recommended)
60

NetatmoIndoorModule

Netatmo Indoor Module
OptionDescriptionDefault
device_id
string
Base Station Device ID retrieved from plugin startup output
module_id
string
Module ID retrieved from plugin startup output
interval
number
Polling interval for current measurements (>60s recommended)
60

NetatmoRainSensor

Netatmo Rain Sensor
OptionDescriptionDefault
device_id
string
Base Station Device ID retrieved from plugin startup output
module_id
string
Module ID retrieved from plugin startup output
interval
number
Polling interval for current measurements (>60s recommended)
60

NetatmoWindGauge

Netatmo Wind Gauge
OptionDescriptionDefault
device_id
string
Base Station Device ID retrieved from plugin startup output
module_id
string
Module ID retrieved from plugin startup output
interval
number
Polling interval for current measurements (>60s recommended)
60
pimatic-netatmo is written by Lukas Reinhart (thex)