https://github.com/emischorr/mqtt_netatmo_gw

A gateway service written in Elixir connecting the HTTP API of Netatmo weather station to MQTT
https://github.com/emischorr/mqtt_netatmo_gw

elixir iot mqtt netatmo smarthome weather

Last synced: about 5 hours ago
JSON representation

A gateway service written in Elixir connecting the HTTP API of Netatmo weather station to MQTT

• Host: GitHub
• URL: https://github.com/emischorr/mqtt_netatmo_gw
• Owner: emischorr
• License: mit
• Created: 2023-12-18T10:43:34.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-10-25T13:48:57.000Z (14 days ago)
• Last Synced: 2024-10-26T16:35:55.595Z (13 days ago)
• Topics: elixir, iot, mqtt, netatmo, smarthome, weather
• Language: Elixir
• Homepage:
• Size: 15.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# MqttNetatmoGw

A MQTT gateway that brings weather station data from a netatmo account over to MQTT.

It connects and updates weather information ("CO2", "Temperature", "Humidity", "Noise") every 5 minutes.

Features

- Supports multiple sensors/modules

- Battery level monitoring

- Automatic token management

- Fault tolerant

## ENV vars

Required:

`NETATMO_CLIENT_ID`

`NETATMO_CLIENT_SECRET`

`NETATMO_REFRESH_TOKEN`

Optional:

`MQTT_HOST` default "127.0.0.1"

`MQTT_PORT` default 1883

`MQTT_USER`

`MQTT_PW`

`MQTT_EVENT_TOPIC_NS` default "home/get/netatmo_gw"

## Installation / Running

docker run \

  -d \

  --name='MQTTNetatmoGW' \

  --net='bridge' \

  -e TZ="Europe/Berlin" \

  -e 'MQTT_HOST'='<192.168.0.100>' \

  -e 'MQTT_USER'='' \

  -e 'MQTT_PW'='' \

  -e 'NETATMO_CLIENT_ID'='' \

  -e 'NETATMO_CLIENT_SECRET'='' \

  -e 'NETATMO_REFRESH_TOKEN'='' \

  -v '':'/home/elixir/app/lib/mqtt_netatmo_gw-0.1.0/priv':'rw' 'emischorr/mqtt_netatmo_gw:latest'

You need to have a app created at the Netatmo Developer Portal: https://dev.netatmo.com/apps/

There you can find the needed client id and client secret.

Then also on the same page generate a token pair (with at least `read_station` scope) for your application and copy the refresh token.

All three (id, secret and refresh token) have to be supplied at the start via ENV vars.

If you don't supply any ENV vars for the MQTT connection it tries to connect to a instance running on localhost on the default port without access control.

Authentication with Netatmo is automatically renewed.

NOTICE: the tokens will be stored to disk in clear text.