Netatmox

A simple wrapper around the Netatmo Weather API. Currently just two functions are supported. One to retrieve the station data and another to update the tokens.

Tokens

You need an access token with the scope read_station to get the data from your weather station. The token is right now only 3h valid and needs to be refreshed with an refresh token. You can either use something like Netatmo-Auth-Cli to do the inital OAuth2 flow to retrieve the tokens or you can generate an access and refresh from the app page in the Netatmo dev portal.

Make sure to save both access and refresh token after every refresh as both will invalidate after 3h and you need the refreh token to do so.

Usage

Get station data:

Netatmox.station_data("18e982cb723c36c7b...")
{:ok,
 %{
   "body" => %{
     "devices" => [
       %{
         "co2_calibrating" => false,
         "dashboard_data" => %{
           "AbsolutePressure" => 985.3,
           "CO2" => 1449,
           "Humidity" => 65,
           "Noise" => 35,
           "Pressure" => 1008.1,
           "Temperature" => 21.3,
           "date_max_temp" => 1702422085,
           "date_min_temp" => 1702429337,
           "max_temp" => 21.4,
           "min_temp" => 20.9,
           "pressure_trend" => "up",
           "temp_trend" => "stable",
         }
         # ...
       }
     ]
   }
 }
}

Refresh tokens:

Netatmox.refresh_token(client_id, client_secret, refresh_token)
{:ok,
 %{
   "access_token" => "18e982cb723c36c7b...",
   "expire_in" => 10800,
   "expires_in" => 10800,
   "refresh_token" => "18e982cb723c36c7b...",
   "scope" => ["read_station"]
 }}

Installation

The package can be installed by adding netatmox to your list of dependencies in mix.exs:

def deps do
  [
    {:netatmox, "~> 0.1.0"}
  ]
end