netatmo-api-go/README.md

53 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2015-09-11 14:38:11 +00:00
# netatmo-api-go
2015-09-11 14:57:03 +00:00
Simple API to access Netatmo weather station data written in Go.
## Quickstart
2015-09-11 15:14:09 +00:00
- [Create a new netatmo app](https://dev.netatmo.com/dev/createapp)
2017-10-26 15:27:54 +00:00
- Edit ```test/sample.conf```with your credentials
- run ```go run test/netatmo-api-test.go -f test/sample.conf```
- Output shall look like :
2015-09-11 14:57:03 +00:00
```
Station : Home
Module : Chambre Elsa
BatteryPercent : 47 (updated 323s ago)
RFStatus : 68 (updated 323s ago)
Temperature : 22.8 (updated 323s ago)
Humidity : 53 (updated 323s ago)
CO2 : 446 (updated 323s ago)
Module : Chambre parents
BatteryPercent : 50 (updated 323s ago)
RFStatus : 71 (updated 323s ago)
Temperature : 19.9 (updated 323s ago)
Humidity : 61 (updated 323s ago)
CO2 : 428 (updated 323s ago)
Module : Chambre Jules
BatteryPercent : 46 (updated 323s ago)
RFStatus : 60 (updated 323s ago)
CO2 : 396 (updated 323s ago)
Temperature : 22 (updated 323s ago)
Humidity : 54 (updated 323s ago)
Module : Exterieur
BatteryPercent : 37 (updated 323s ago)
RFStatus : 66 (updated 323s ago)
Temperature : 23.4 (updated 323s ago)
Humidity : 52 (updated 323s ago)
Module : Pluie
BatteryPercent : 72 (updated 9684499s ago)
RFStatus : 54 (updated 9684499s ago)
Rain : 0.101 (updated 9684499s ago)
Module : Living
WifiStatus : 37 (updated 278s ago)
Temperature : 24 (updated 278s ago)
Humidity : 49 (updated 278s ago)
CO2 : 733 (updated 278s ago)
Noise : 50 (updated 278s ago)
Pressure : 1028.1 (updated 278s ago)
AbsolutePressure : 1008.4 (updated 278s ago)
2015-09-11 14:57:03 +00:00
```
2017-10-26 15:27:54 +00:00
2015-09-11 14:57:03 +00:00
## Tips
2016-07-29 13:54:09 +00:00
- Only Read() method actually do an API call and refresh all data at once
2015-09-11 14:57:03 +00:00
- Main station is handle as a module, it means that Modules() method returns list of additional modules and station itself.
2017-10-26 15:27:54 +00:00
- Data() returns sensors values (such as temperature) whereas Info() returns module status (such as battery level)