home-assistant.io/source/_components/sensor.netatmo.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category
page	Netatmo Sensor	Instructions how to integrate Netatmo sensors into Home Assistant.	2016-01-14 08:10	true	false	true	true	netatmo.png	Sensor

The netatmo sensor platform is consuming the information provided by a Netatmo device.

To enable the Netatmo sensor, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
sensor:
  platform: netatmo
  api_key: YOUR_API_KEY
  secret_key: YOUR_SECRET_KEY
  username: YOUR_USERNAME
  password: YOUR_PASSWORD
  modules:
    module_name1:
      - temperature
      - humidity
      - noise
      - pressure
      - co2
      - rain
      - sum_rain_1
      - sum_rain_24
    module_name2:
      - temperature
    rainmeter_name3:
      - rain
      - sum_rain_1
      - sum_rain_24

Configuration variables:

• api_key (Required): The API key for your netatmo account.
• secret_key (Required): Your netatmo secret key
• username (Required): Username for the netatmo account.
• password (Required): Password for the netatmo account.
• modules (Required): Modules to use. Multiple entries allowed.
  • module_name array (Required): Name of the module.
    • temperature: Current temperature.
    • co2: CO2 concentration in ppm.
    • pressure: Pressure in mbar.
    • noise: Noise level in dB.
    • humidity: Humidity in %.
    • rain: Estimated rainfall for today in mm.
    • sum_rain_1: Rainfall in the last hour in mm.
    • sum_rain_24: Rainfall in mm from 00:00am - 23:59pm.

{% linkable_title Get API and Secret Key %}

To get your API credentials, you have to declare a new application in the NetAtmo Developer Page. Sign in using your username and password from your regular NetAtmo account. Click on 'Create an App' at the top of the page.

You have to fill the form, but only two fields are required : Name and Description. It doesn't really matter what you put into those. Just write something that make sense to you. To submit your new app, click on create at the bottom of the form.

That's it. You can copy and paste your new API and secret keys in your Home Assistant configuration file just as said above.

{% linkable_title Find your modules name %}

You can find your modules name in your online NetAtmo account. These names can be found and changed in parameters (See screenshot) You have to provide these name in your Home Assistant configuration file.

The Home Assistant NetAtmo platform has only be tested with the classic indoor, outdoor module and rainmeter. There is no support for the windmeter module at this time because developers does not own these modules.