README.md

Logger service for YouLess energy monitor

A YouLess energy monitor is a handy to device to monitor your power and gas usage. It has it's downsides though, one is a limited amount of historical data that is stored. This service aims to solve that problem by storing the monitored data of each interval for a much longer period of time. And does so for multiple YouLess devices. It also provides an API compatible with YouLess' own API so the service can easily be used by any existing client.

Key features are:

• no more limits on monitored data
• get data from multiple devices
• support older YouLess versions
• only monitor the data services you want
• configure update intervals
• cli to instant trigger an update
• classic api can serve older data

Installation

Setting up the service is pretty easy.

services:
  youless-logger-service:
    image: roeldev/casa-youless-logger:latest
    ports:
      - 80:80
    volumes:
      - ./config:/config/
      - ./data:/app/data/
      - ./log:/app/log/
    environment:
      - PGID=100
      - PUID=1000

Volumes

Path	Contains
/config	Config files
/app/data	Database (backup) files
/app/log	Log files

Configuration

Support for multiple YouLess devices means a little more configuration. Although it should be pretty self explanatory, most important stuff is mentioned in this chapter. But first, have a look at the [sample config] (rootfs/etc/default-configs/config.php) for a quick overview of possibilities.

Each device should have at least an ip option set so the logger can reach the device's API. All other values are not required. However this probably results in way too much useless data being saved. Therefore it's recommended to only enable the data service(s) that are actually monitored. and disables classic API support

Note: Latest YouLess devices support data from three different counters: power, gas and s0. Older versions only support power.

Below example adds two devices:

1. main which requires a password to access the API on 192.168.1.27 and provides data of power and gas consumption;
2. attic which is hosted on 192.168.1.32 and only provides data of the s0 pulse counter.

'devices' => [
    'main' => [
        'ip' => 'http://192.168.1.27',
        'password' => 'secret',
        'services' => [
            'power' => true,
            'gas' => true,
            's0' => false,
        ]
    ],
    'attic' => [
        'ip' => 'http://192.168.1.32'
        'services' => [ 's0' ]
    ]
]

CLI

A CLI tool is available to display info or communicate with the configured devices. Login to the Docker container and use yl list to list all available commands. It is also possible to run the tool outside of the Docker container via docker exec -it {container_name} yl {command}.

Stored data

A new SQLite database is created on first run. All data values are stored in the data table whitin this database.

Intervals

Id	Interval	API equiv.	LS110 history*	LS120 history*	Unit (power/s0)	Unit (gas)
1	minute	h	1 hour (2x30)	10 hours (20x30)	watt	n/a
2	10 mins	w	24 hours (3x48)	10 days (30x48)	watt	liter
3	hour	d	7 days (7x24)	70 days (70x24)	watt	liter
4	day	m	1 year (12x31)	1 year (12x31)	kWh	m3 (cubic meter)

• = max. history (amount of pages x data entries)

Units

Id	Unit	API equiv.	Service
1	watt	Watt	power/s0
2	kwh	kWh	power/s0
3	liter	l	gas
4	m3	m3	gas

Links

• GitHub: https://github.com/project-casa/youless-logger
• Docker Hub: https://hub.docker.com/r/roeldev/casa-youless-logger
• YouLess: https://youless.nl
• YouLess API info: http://wiki.td-er.nl/index.php?title=YouLess

Build with

License

GPL-3.0+ © 2019 Roel Schut