Netatmo Multi  

Developer: Alan Carter     Like this plugin? Show your appreciation!
Category: Weather and Environmental Sensors
Assistance: Get help!   
Plugin ID: com.racarter.indigoplugin.netatmo-welcome
Latest release: v2022.4.9 released on May 12, 2023
Requires: Indigo v2022.1.0 or higher
(Check the Releases tab below for older releases that may have different requirements)
  Download latest release

* PLEASE NOTE * If you are moving from another Netatmo weather plugin it is strongly recommended that you delete/rename old weather devices in Indigo AND delete the preference file for the old plugin before running this plugin. This helps avoid problems with creation of new weather devices. New users should be aware that old devices may have dependencies which will be lost when the devices are deleted, so it may be advisable to rename these devices first, and delete them only when dependencies have been transferred to the new devices.

Due to changes in the Netatmo API authentication method this plugin now requires an up to date Indigo reflector.

The plugin supports Netatmo weather stations, cameras, doorbells, smoke detectors, Heathy Home monitors, thermostats and TRVs.

Weather Station: creates an Indigo device for each weather station module. Also supports third-party stations set up as favourites in your Netatmo account.

Welcome Camera: creates a device for each camera. Also creates a variable for each person previously set up in the Netatmo mobile app and sets each to 'Home' or 'Away'. An additional 'Occupants' variable specifies the total number of persons currently 'Home'. Device states include 'last event' text and 'last event' time, so in addition to creating triggers when someone arrives 'Home' you can also trigger on things like 'Unknown face seen'.

Presence Camera: currently basic support due to limited API.

Smoke detector: currently basic support due to limited API.

Doorbell: currently basic support due to limited API.

Healthy Home: each measurement is copied to a device state.

Thermostats and TRVs: full support.

NOTE THAT THE PLUGIN CREATES ALL DEVICES; IT IS NOT NECESSARY FOR YOU TO DO SO.

Release details
Released on: May 12, 2023
Requires: Indigo v2022.1.0+
Changes in this release

Make user authentication message an error message to allow event triggering, for example to generate an email to alert the user that authentication is required.

Release details
Released on: April 4, 2023
Requires: Indigo v2022.1.0+
Changes in this release

Add support for web hook power supply messages

Release details
Released on: March 7, 2023
Requires: Indigo v2022.1.0+
Changes in this release

Fix processing of offline modules. An offline module caused remaining module processing to be skipped.

Release details
Released on: Jan. 23, 2023
Requires: Indigo v2022.1.0+
Changes in this release

Don't check for Netatmo folder ID if no camera or energy devices

Release details
Released on: Jan. 19, 2023
Requires: Indigo v2022.1.0+
Changes in this release

Fix re Netatmo folder ID required for limescale protection state

Release details
Released on: Jan. 17, 2023
Requires: Indigo v2022.1.0+
Changes in this release

Exclude TRVs in manual mode from limescale protection cycle.

Fix set point override cancellation (should cancel only the override on the specified device).

Release details
Released on: Nov. 17, 2022
Requires: Indigo v2022.1.0+
Changes in this release

Revise code to deal with missing vpn_url field in Netatmo camera response.

Release details
Released on: Sept. 18, 2022
Requires: Indigo v2022.1.0+
Changes in this release

Add code to handle smoke detector sound test messages

Release details
Released on: Sept. 10, 2022
Requires: Indigo v2022.1.0+
Changes in this release

Netatmo have withdrawn the authorisation method used by the old plugin. The new plugin will work the same as the old one except for the authorisation process. If you're already running the plugin and you install this update you shouldn't notice a difference, but if you're installing it for the first time, or you've installed it after the expiration of your Netatmo tokens, you'll have to use the new authorisation method.

As before, you'll need a Netatmo developer account, where you create an app to obtain a Client ID and a Client Secret.

Authorisation can only be done from the Indigo server machine, and now requires a working Indigo Reflector and REST API KEY.

Once you have started the plugin it will open a web browser showing your Netatmo developer page, where you must authorise the plug to access your Netatmo data. Once you have done this you can close the browser. Keep an eye on the Indigo event log to see what's going on.

Requirements

Indigo Reflector and REST API key.

Release details
Released on: Aug. 27, 2022
Requires: Indigo v2022.1.0+
Changes in this release

Weekly limescale protection scheduling has been replaced by limescale protection actions which can be used by Indigo schedules. This allows more flexible scheduling of limescale protection.

Note that if you currently have weekly limescale protection enabled you will need to create an Indigo schedule to do this, or it will no longer happen.

Release details
Released on: Aug. 11, 2022
Requires: Indigo v2022.1.0+
Changes in this release

Add support for Netatmo Doorbell. This functionality requires an Indigo Reflector, as it uses webhooks.

The use of webhooks also allows faster responses to camera events, so I've added movement detector icons to the camera devices.

Requirements

Up to date Indigo Reflector account

Release details
Released on: May 11, 2022
Requires: Indigo v2022.1.0+
Changes in this release

Updated for Indigo 2022.1 and later

Requirements

Requires Indigo 2022.1 or later

Release details
Released on: Jan. 18, 2022
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add code to handle cases where weather outdoor module has not been named in the Netatmo phone app

Release details
Released on: Aug. 22, 2021
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix bug introduced in version 1.6.0 (#facepalm)

Release details
Released on: Aug. 22, 2021
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add ability to adjust TRV cycle time for limescale protection

Release details
Released on: June 6, 2021
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Increase default timeout for API responses from 10 secs to 20 secs to cater for times when Netatmo server response is slow. The 10 second timeout was sometimes resulting in missed updates.

Please note that due to a Netatmo API team screw-up battery levels are not currently being reported. This will be fixed by Netatmo in due course.

Release details
Released on: May 7, 2021
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Added code to handle situations when thermostat battery level and preheat data are missing from Netatmo server response. Omission of this data prevented completion of updates for the devices concerned.

Release details
Released on: Jan. 25, 2021
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix processing of multiple weather stations with same owner. This necessitated changing the address nomenclature for weather station modules.

* PLEASE NOTE * Before installing this release it is necessary to delete or rename all existing weather station modules (but not stations) with addresses starting 'WSM' to allow creation of new modules with a revised address nomenclature. Failure to do this will result in 'name not unique' errors. Note that any renamed devices will no longer be updated.

Requirements

* PLEASE NOTE * Before installing this release it is necessary to delete or rename all existing weather station modules (but not stations) with addresses starting 'WSM' to allow creation of new modules with a revised address nomenclature. Failure to do this will result in 'name not unique' errors. Note that any renamed devices will no longer be updated.

Release details
Released on: Nov. 28, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix camera snapshot bug

Release details
Released on: Nov. 27, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Expand processing of third party weather stations to include wind and rain modules

Release details
Released on: Nov. 23, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix for forthcoming Netatmo deprecation of station_name field. Use new field home_name instead.

Handle cases where weather station last_upgrade field is absent from Netatmo server response.

Release details
Released on: July 12, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Change camera addresses to MAC addresses to avoid issues under certain circumstances where new cameras are added to an existing system.

* PLEASE NOTE * Before installing this update, camera users should DELETE all Netatmo cameras in Indigo, then install and enable the plugin. New camera devices will be created with the same names as set in the Netatmo app.

Release details
Released on: June 16, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Improved handling of third-party weather station timeouts. Now tries three times before publishing an error message.

Release details
Released on: June 6, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Allows creation of an Indigo device for each weather station favourited on the Netatmo map. Tick the box in config to enable.

Release details
Released on: May 1, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Improve set point change error handling

Release details
Released on: Jan. 9, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

No other changes.

Release details
Released on: Dec. 6, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix to handle missing Last Upgrade field in Healthy Home data

Release details
Released on: Dec. 5, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix to handle non-ASCII characters in device names

Release details
Released on: April 10, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Change camera URLs from device custom states to variables to allow easier use of Jay's variable_url_redirect plugin.

(Netatmo change the URLs of the camera feeds every three hours, hence the need for a dynamic value.)

Release details
Released on: April 9, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Added support for Netatmo Presence outdoor cameras.

Added snapshot and video URLs as device custom states for ease of access.

Added Valve Position as device custom state for TRVs.

Release details
Released on: April 1, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add C to F conversion for weather station temperatures.

Turns out Netatmo's API returns degC no matter what units the user has selected in the phone app!

Release details
Released on: March 30, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add code to determine Current Zone and include as custom state.

Release details
Released on: March 14, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Speed up detection of heating schedule changes. Previously heating schedules were only updated hourly.

Release details
Released on: March 10, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix bug in Set Setpoint action callback.

Release details
Released on: March 8, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix erroneous error message when processing first TRV in the device list after an unreachable thermostat. (A bit esoteric, this one!)

Release details
Released on: March 3, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add calculated dew point custom state for weather station outdoor module

Release details
Released on: March 2, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add action to initiate limescale protection for individual TRVs

Release details
Released on: Feb. 18, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add battery levels for thermostats and TRVs.

Fix to publish correct error message if a TRV becomes unreachable

Release details
Released on: Feb. 17, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Bug fix for error message on start-up if tokens had expired

Release details
Released on: Feb. 15, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Added config option to display thermostat and TRV setpoints in Indigo Home Window Notes column.

Tweaks to TRV Limescale Protection Code.

Release details
Released on: Feb. 11, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

This release adds support for Netatmo Thermostats and TRVs. Please note that this new functionality is still in testing and development so bugs may occur.

* Personal circumstances mean that I cannot offer much support for the next few weeks but if serious issues are found I'll do my best to resolve them.

Release details
Released on: Feb. 11, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Remove plugin update checking, per latest Indigo developer guidelines. This functionality will be included in future Indigo releases.

Release details
Released on: Jan. 23, 2019
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add UI values to temperature, pressure, humidity and CO2 readings for display and control page purposes.

Release details
Released on: Dec. 15, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add support for Netatmo Smart Smoke Detector.

Netatmo's API documentation for the smoke detector is a little sparse, so this is a first attempt.

Release details
Released on: Dec. 10, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Fix problem when starting plugin for the first time with no config

Release details
Released on: Dec. 7, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add support for battery level for battery-operated modules

Release details
Released on: Dec. 7, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Bug fix following recent Netatmo API changes.

Release details
Released on: Dec. 1, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Amend device creation code to include 'SupportsBatteryLevel' for battery-operated devices.

Fix bug in 'Last Update' check in cases where there hasn't been an update yet!

Release details
Released on: Dec. 1, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Netatmo no longer returns dashboard data for unreachable devices. Plugin has been updated to cater for this.

Release details
Released on: Nov. 20, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Improve error handling for Healthy Home and Weather Station devices when Netatmo API responses are bad.

Release details
Released on: Aug. 24, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Added a menu option to make saving of Access and Refresh Tokens optional. If unticked, new tokens will be requested on every startup.

Release details
Released on: Aug. 24, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add code to replace spaces in persons' names with underscores.

Release details
Released on: Aug. 22, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Add menu option to request a new Access Token.

Add code to request new token automatically if Netatmo devices are added by user.

Add last update time to Welcome Camera custom device states.

Release details
Released on: July 13, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Store Access and Refresh Tokens in plugin preferences to avoid unnecessary authentication calls on plugin startup.

Release details
Released on: July 5, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Bug fix

Release details
Released on: July 4, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Starting the plugin with a disconnected camera could cause an exception. This has been addressed.

Release details
Released on: July 2, 2018
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Store separate Last Event details for each Welcome camera.

Requirements

Requires a Netatmo account.