SaveEcoBot sensor for Home Assistant

SaveEcoBot is a nice Ukrainian environmental project.

Home Assistant is an awesome home automation system

This piece of code adds SaveEcoBot API info with Home Assistant.

Initial steps

1. Copy this repo's files into <home assistant config directory>/custom_components/save_eco_bot (don't forget to install HASS first)

2. Enable SaveEcoBot platform in configuration.yaml:

sensor:
 - platform: save_eco_bot

3. Restart Home Asssistant

Customizing configuration

After initial configuration (and if SaveEcoBot data available, of course, check the logs) you'll see two new HASS services:

• save_eco_bot.show_cities
• save_eco_bot.show_city_stations

(See the Developer tools - Services page of your HASS at <HASS_url>:<HASS_PORT>/developer-tools/service)

Calling these services will give you an additional info for filtering available data. Service calls will create a notifications in notifications area:

save_eco_bot.show_cities will show the list of available cities

save_eco_bot.show_city_stations will show stations for certain city. You'll have to provide the city name as shown in save_eco_bot.show_cities call in service parameters:

city: Kyiv

the output will give you Stations IDs, e.g.

SaveEcoBot Stations
Stations in Kyiv:

SAVEDNIPRO_010 - Mykhaila Lomonosova Street, 73
SAVEDNIPRO_1004 - vulytsia Henerala Zhmachenka, 4
SAVEDNIPRO_1266 - vulytsia Kostiantynivska, 73
SAVEDNIPRO_1274 - prospekt Heroiv Stalinhrada, 6K8
...

Final settings

Update your configuration.yaml with filtering parameters and restart HASS. This will create all available sensors for all chosen stations. All three filters are applied together, so i wouldn't recommend you to use them all, consider getting all IDs you need, or provide city name only

Example config

sensor:
 - platform: save_eco_bot
   station_ids:
     - SAVEDNIPRO_3422
     - SAVEDNIPRO_1294
     - SAVEDNIPRO_1004
   city_names:
     - Kyiv
     - Lviv
     - Odesa
   station_names:
     - "prospekt Slobozhanskyi, 127A"

Have fun!