Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
GitHub4Eddy committed Jan 1, 2022
1 parent 45d6583 commit 1acfc3c
Showing 1 changed file with 22 additions and 6 deletions.
28 changes: 22 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,35 @@
# tibber_monitor
This QuickApp gets todays an tomorrows energy prices from the Tibber platform.
Next to the current prices the lowest and highest price for the next 12 hours is calculated.
Tax and fees are included in the hourly, daily and yearly cost.
Tax and extra cost (cable owner) are included in the hourly, daily, monthly, yearly and total cost.
All values are displayed in the labels.

Child devices are available for:
- Hourly energy usage
- Hourly energy cost
- Todays energy usage (com.fibaro.energyMeter with automatic rateType=consumption for Fibaro Energy Panel)
- Todays energy cost (including fees)
- Monthly energy usage
- Monthly energy cost
- Yearly energy usage
- Yearly energy cost
- Total energy usage
- Total energy cost
- Actual price now
- Minumum price today (for the next 12 hours)
- Maximum price today (for the next 12 hours)
- Percentage +1 hour (compaired to actual price now, positive value means a increase of the price, negative value means a decrease of the price)
- Percentage +1 hour (compaired to actual price now, positive value means an increase of the price, negative value means a decrease of the price)
- Percentage +2 hour
- Percentage +3 hour
- Percentage +4 hour
- Percentage +5 hour

These values can be used to control appliances according to the lowest and forecast prices during the day.

To communicate with the API you need to acquire a OAuth access token and pass this along with every request passed to the server.
A Personal Access Token give you access to your data and your data only.
This is ideal for DIY people that want to leverage the Tibber platform to extend the smartness of their home.
Such a token can be acquired here: https://thewall.tibber.com
Such a token can be acquired here: https://developer.tibber.com

When creating your access token or OAuth client you’ll be asked which scopes you want the access token to be associated with.
These scopes tells the API which data and operations the client is allowed to perfom on the user’s behalf.
Expand All @@ -33,10 +38,19 @@ If you for example need access to user information you add the USER scope.
If information about the users homes is needed you add the appropiate HOME scopes.

Tomorrow values are available from 13:00 hour

If you have more than one home in your subscription, you need to fill in your home number the change between your homes.

Tibber API documentation: https://developer.tibber.com/docs/guides/calling-api
Tibber API explorer: https://developer.tibber.com/explorer

Changes version 0.5 (1st Januari 2021)
- Changed main device to generic.device
- Changed Tax calculations
- Added child devices monthly and total energy and cost
- Calculated the daily, monthly, yearly and total energy, cost and tax to get this day, this month, this year and total values
- Solved a bug showing more than 12 prices just after midnight
- Solved handling nil values at beginning of year, etc

Changes version 0.2 (29th December 2021)
- Added all child devices
- Added QuickApp variable for extra cost and added the cost to the calculations
Expand All @@ -47,8 +61,10 @@ Changes version 0.1 (23rd December 2021)
- Initial version

Variables (mandatory and created automatically):
- token = Authorization token (see the Tibber website: https://thewall.tibber.com)
- token = Authorization token (see the Tibber website: https://developer.tibber.com)
- homeNr = Tibber home (nodes) number if you have more than one home (default = 1)
- extraCost = Extra cost per kWh for Tibber and Cable owner, decimals with dot, not komma (default = 0)
- interval = Interval in seconds to get the data from the Tibber Platform. The default request interval is 3600 seconds (60 minutes).
- interval = Interval in seconds to get the data from the Tibber Platform. The default is 3600 seconds (60 minutes). (Tibber has a rate limit of 100 requests in 5 minutes per IP address)
- debugLevel = Number (1=some, 2=few, 3=all, 4=simulation mode) (default = 1)
- setGlobalVar = true or false, whether you want tu use the Global Variables (default = false)
- icon = User defined icon number (add the icon via another device and lookup the number) (default = 0)

0 comments on commit 1acfc3c

Please sign in to comment.