weewx-netatmo/readme

49 lines
1.8 KiB
Text
Raw Normal View History

2016-04-27 13:14:00 +02:00
netatmo - weewx driver for netatmo weather stations
Copyright 2015 Matthew Wall
Distributed under terms of the GPLv3
2016-04-27 13:14:00 +02:00
2016-04-27 13:20:09 +02:00
This driver has two modes of operation. It can use the netatmo API to obtain
2016-04-27 13:14:00 +02:00
data from the netatmo servers, or it can parse the packets sent from a netatmo
2016-04-27 13:20:09 +02:00
station. The latter works only with netatmo firmware 101 (circa early 2015).
Firmware 102 introduced arbitrary encryption in response to a poorly chosen
decision to include the wifi password in network traffic sent to the netatmo
servers. Unfortunately, the encryption blocks end-users from accessing their
data, while the netatmo stations might still send information such as the wifi
password to the netatmo servers.
2016-04-27 13:14:00 +02:00
2016-04-27 13:20:09 +02:00
By default this driver will operate in 'cloud' mode.
Communication with the netatmo servers requires 4 things: username, password,
client_id, and client_secret. The username and password are the credentials
used to access data at netatmo.com. The client_id and client_secret must be
obtained via the dev.netatmo.com web site. Using these 4 things, the driver
2016-04-27 13:51:15 +02:00
automatically obtains and updates the tokens needed to get data from the
server.
2016-04-27 13:14:00 +02:00
[bricebou]
This fork aims to be compatible with weewx 4.* and has been "rewritten" in Python 3 thanks to the `2to3` tool.
[/bricebou]
2016-04-27 13:14:00 +02:00
===============================================================================
2016-04-27 13:14:00 +02:00
Installation instructions:
1) download the driver:
2016-04-27 13:14:00 +02:00
wget -O weewx-netatmo.zip https://github.com/bricebou/weewx-netatmo/archive/master.zip
2) install the driver:
2016-04-27 13:51:15 +02:00
sudo wee_extension --install weewx-netatmo.zip
2016-04-27 13:14:00 +02:00
3) select and configure the driver:
2016-04-27 13:14:00 +02:00
sudo wee_config --reconfigure
2016-04-27 13:14:00 +02:00
[bricebou]
It seems that the configuration isn't written so you have to manually edit the ``/etc/weewx/weewx.conf` file.
[/bricebou]
4) start weewx:
2016-04-27 13:14:00 +02:00
sudo /etc/init.d/weewx start