diff --git a/apps/predbat/config/apps.yaml b/apps/predbat/config/apps.yaml index e90eb0568..4c391e9b9 100644 --- a/apps/predbat/config/apps.yaml +++ b/apps/predbat/config/apps.yaml @@ -366,8 +366,8 @@ pred_bat: # Nordpool market energy rates #futurerate_url: 'https://www.nordpoolgroup.com/api/marketdata/page/325?currency=GBP' - #futurerate_adjust_import: False - #futurerate_adjust_export: True + #futurerate_adjust_import: True + #futurerate_adjust_export: False #futurerate_peak_start: "16:00:00" #futurerate_peak_end: "19:00:00" #futurerate_peak_premium_import: 14 diff --git a/apps/predbat/predbat.py b/apps/predbat/predbat.py index 7c53cb7d6..897256ba5 100644 --- a/apps/predbat/predbat.py +++ b/apps/predbat/predbat.py @@ -5375,7 +5375,9 @@ def rate_min_forward_calc(self, rates): for minute in range(self.minutes_now, self.forecast_minutes + 24 * 60 + self.minutes_now): rate_min_forward[minute] = min(rate_array[minute:]) - self.log("Rate min forward looking: now {} at end of forecast {}".format(rate_min_forward[self.minutes_now], self.dp2(rate_min_forward[self.forecast_minutes]))) + self.log( + "Rate min forward looking: now {}, and at end of forecast {}".format(self.dp2(rate_min_forward[self.minutes_now]), self.dp2(rate_min_forward[self.forecast_minutes])) + ) return rate_min_forward diff --git a/docs/apps-yaml.md b/docs/apps-yaml.md index 8933ab5b7..61729ac2b 100644 --- a/docs/apps-yaml.md +++ b/docs/apps-yaml.md @@ -241,6 +241,10 @@ These are described in detail in [Energy Rates](energy-rates.md) and are listed - **rates_export** - Export rates over a 24-hour period with start and end times - **rates_import_override** - Over-ride import rate for specific date and time range, e.g. Octopus Power-up events - **rates_export_override** - Over-ride export rate for specific date and time range +- **futurerate_url** - URL of future energy market prices for Agile users +- **futurerate_adjust_import** and **futurerate_adjust_export** - Whether tomorrow's predicted import or export prices should be adjusted based on market prices or not +- **futurerate_peak_start** and **futurerate_peak_end** - start/end times for peak-rate adjustment +- **futurerate_peak_premium_import** and **futurerate_peak_premium_export** - price premium to be added during the peak period ## Car Charging Integration diff --git a/docs/energy-rates.md b/docs/energy-rates.md index c4ddecd56..24205cc26 100644 --- a/docs/energy-rates.md +++ b/docs/energy-rates.md @@ -197,6 +197,13 @@ In the energy market it's possible to calculate the Octopus Agile rates from aro enable this in apps.yaml for Import, Export or both. This will approximate next day's rates based on the spot prices. The approximation is only used until the real Octopus Agile rates are released around 4pm. +- **futurerate_url** - URL of future energy market prices; this should not normally need to be changed +- **futurerate_adjust_import** and **futurerate_adjust_export** - Whether tomorrow's predicted import or export prices should be adjusted based on energy market prices or not. +Set these depending upon whether you have an agile tariff for import, export or both +- **futurerate_peak_start** and **futurerate_peak_end** - during the peak period Octopus apply an additional peak-rate price adjustment. +These configuration items enable the peak-rate hours to be adjusted +- **futurerate_peak_premium_import** and **futurerate_peak_premium_export** - the price premium (in pence) to be added to the energy market prices during the above-defined peak period + CAUTION: You may violate the terms and conditions of the Nordpool site if you use this data and as such the authors of Predbat accept no responsibility for any violations: @@ -205,7 +212,7 @@ Predbat accept no responsibility for any violations: ```yaml futurerate_url: '' futurerate_adjust_import: True -futurerate_adjust_export: True +futurerate_adjust_export: False futurerate_peak_start: "16:00:00" futurerate_peak_end: "19:00:00" futurerate_peak_premium_import: 14 diff --git a/docs/faq.md b/docs/faq.md index 3677bdf10..b4a870027 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -5,7 +5,7 @@ - First look at predbat.status in Home Assistant and the AppDaemon.log (which can be found in the list of log files in the System/Log area of the GUI). See if any errors are warnings are found. If you see an error it's likely something is configured wrongly, check your entity settings are correct. -- Make sure Solcast is installed and it's auto-updated at least a couple of times a day (see the Solcast instructions). +- Make sure Solcast is installed and it's auto-updated at least a couple of times a day (see the [Solcast instructions](install.md#solcast-install)). The default solcast sensor names maybe wrong, you might need to update the `apps.yaml` config to match your own names (some people don't have the solcast_ bit in their names) - Did you configure AppDaemon apps_dir correctly in `appdaemon.yaml`? @@ -35,7 +35,7 @@ a script that changes the reserve %, this will cause problems - please disable o ## I changed a config item but it made no difference? -- You might have to wait a few minutes until the next update cycle +- You might have to wait a few minutes until the next update cycle. Depending on the speed of the computer that Predbat is running on, it can take 1-5 minutes for Predbat to run through. ## It's all running but I'm not getting very good results @@ -46,7 +46,7 @@ especially if you have a small battery. If you set it to zero then predbat may n - Check your solar production is well calibrated (you can compare solcast vs actually in the Home Assistant energy tab or on the GivEnergy portal) - Make sure your inverter max AC rate has been set correctly - If you have an EV that you charge then you will want some sort of car charging sensor or use the basic car charging hold feature or your load predictions maybe unreliable -- Do you have a solar diverter? If so maybe you want to try using the IBoost model settings. +- Do you have a solar diverter? If so maybe you want to try using the iBoost model settings. - Perhaps set up the calibration chart and let it run for 24 hours to see how things line up - If your export slots are too small compared to expected check your inverter_limit is set correctly (see below) @@ -79,6 +79,23 @@ If the 'event' and 'sensor' entities are not consistently named then Predbat wil To fix this, uninstall the Octopus integration, reboot Home Assistant, delete all the old Octopus sensors, and [re-install the Octopus Integration](install.md#octopus-energy). +## WARN: No solar data has been configured + +If you get this warning message in the Predbat log file: + +- Ensure that you have [installed and configured Solcast correctly](install.md#solcast-install) +- Check the Solcast integration in Home Assistant is configured and enabled (go to Settings / Integrations / Solcast ) +- Verify the solar forecast has been populated in Home Assistant by going to Developer Tools / States, filtering on 'solcast', +and checking that you can see the half-hourly solar forecasts in the Solcast entities +- If you can see the solcast entities but there are no forecast PV figures, try running the 'Solcast update' automation you created, and check again the solcast entities +- Check **sensor.solcast_pv_api_limit** (it's normally 10 for new Solcast accounts) meaning you can call the Solcast API 10 times a day +(but if you have two solar arrays, e.g. East/West) then retrieving the forecast will count as two API calls. +Compare this to **sensor.solcast_pv_api_used** to see how many Solcast API calls you have made today +(alternatively, you can confirm how many API calls you have made today by logging into your solcast account). +If you've run out of API calls you will have to wait until midnight GMT for the API count to reset. +It's recommended that you don't include the Solcast forecast within your GivEnergy portal to avoid running out of API calls. +- Check the [Solcast server API status](https://status.solcast.com/) is OK + ## I have another problem not listed above If you are still having trouble feel free to raise a [Github ticket](https://github.com/springfall2008/batpred/issues) for support diff --git a/docs/video-guides.md b/docs/video-guides.md index 03cfb935d..23a0be94f 100644 --- a/docs/video-guides.md +++ b/docs/video-guides.md @@ -1,18 +1,18 @@ # Video Guides -All the video guides are now available on my Youtube channel: [Springfall2008](https://www.youtube.com/@springfall2008) +All the video guides are now available on my YouTube channel: [Springfall2008](https://www.youtube.com/@springfall2008) ## Basic installation -- [Installation playlist](https://www.youtube.com/playlist?list=PLTjtFJ0drtomKJzT7oZ3pCa0kzvFzUA_u) +[Playlist of Predbat installation videos](https://www.youtube.com/playlist?list=PLTjtFJ0drtomKJzT7oZ3pCa0kzvFzUA_u) - [Preparing Home Assistant (1) - GivTCP, MQTT & HACS](https://www.youtube.com/watch?v=AcDdpaIPm7I) -- [Preparing Home Assistant (2) -, Octopus, ApexChart, AppDaemon, Predbat](https://www.youtube.com/watch?v=0ML4L-GYjKI) +- [Preparing Home Assistant (2) - Octopus Energy Integration, ApexChart, AppDaemon, Predbat](https://www.youtube.com/watch?v=0ML4L-GYjKI) -- [Configuration of apps.yml](https://youtu.be/VE15l3maDOk) -- [Configuration inside HA](https://youtu.be/qsLWDd5SLkY) -- [Understanding historical Data](https://www.youtube.com/watch?v=LrhDRUhziC4) -- [Understand the charts](https://www.youtube.com/watch?v=KXiRzMyRZyM) +- [Configuration of apps.yaml](https://youtu.be/VE15l3maDOk) +- [Configuration of Predbat inside Home Assistant](https://youtu.be/qsLWDd5SLkY) +- [Understanding historical data](https://www.youtube.com/watch?v=LrhDRUhziC4) +- [Understanding the charts](https://www.youtube.com/watch?v=KXiRzMyRZyM) - [How to understand Predbat plans](https://www.youtube.com/watch?v=rAZ9s7n4kuY) - [AppDaemon log files](https://www.youtube.com/watch?v=2pVlGSuMVtA) @@ -25,21 +25,16 @@ All the video guides are now available on my Youtube channel: [Springfall2008](h ## Features -- [Features playlist](https://www.youtube.com/playlist?list=PLTjtFJ0drtokvs-H0nb1WBO49DNjbyuDb) - -- Configuration of apps.yaml: [https://www.loom.com/share/fa0db1b1fce34db09bb4af76b2e7edef?sid=6456019a-62e3-4e59-95f9-092474a8a5e5](https://www.loom.com/share/fa0db1b1fce34db09bb4af76b2e7edef?sid=6456019a-62e3-4e59-95f9-092474a8a5e5) -- Configuration inside HA: [https://www.loom.com/share/78e4b4f91fdb45068665e769334a934b?sid=0388e0c3-5cf1-42ee-8dd3-3992683c4c36](https://www.loom.com/share/78e4b4f91fdb45068665e769334a934b?sid=0388e0c3-5cf1-42ee-8dd3-3992683c4c36) -- Multiple cars: [https://www.loom.com/share/c8858d80ea334b2a885f09121dc72650?sid=f37aadc3-d804-4c4f-8c60-a3d0bc43298b](https://www.loom.com/share/c8858d80ea334b2a885f09121dc72650?sid=f37aadc3-d804-4c4f-8c60-a3d0bc43298b) -- Octopus Energy plugin >v9.0.0: [https://www.loom.com/share/f11e36eaa4784c6980c5a8a68ee4f674](https://www.loom.com/share/f11e36eaa4784c6980c5a8a68ee4f674?sid=195fc492-3c0a-4acf-9ed6-b6b8c5757ebe) +[Playlist of Predbat feature videos](https://www.youtube.com/playlist?list=PLTjtFJ0drtokvs-H0nb1WBO49DNjbyuDb) - [Intelligent Octopus car charging](https://www.youtube.com/watch?v=XGs_Rph5li0) - [Octopus Saving Sessions](https://www.youtube.com/watch?v=7fpCwKlRVJk) - [How to update Predbat](https://www.youtube.com/watch?v=Z6-Nds_dlyc) - [Predbat mode and read-only mode](https://www.youtube.com/watch?v=YNixY2cF8kE) -## Tariffs +## Energy Tariffs -- [Tariffs playlist](https://www.youtube.com/watch?v=eW1Nnk1TPAg&list=PLTjtFJ0drton-Yp_ZUGmzTfUo5xeaEoBS) +[Playlist of Tariff configuration videos](https://www.youtube.com/watch?v=eW1Nnk1TPAg&list=PLTjtFJ0drton-Yp_ZUGmzTfUo5xeaEoBS) - [Intelligent Octopus import + Agile export](https://www.youtube.com/watch?v=o1CZrM3S2w0) - [Intelligent Octopus import + Fixed export](https://www.youtube.com/watch?v=USyzJfIa0iQ) diff --git a/mkdocs.yml b/mkdocs.yml index e34d1a434..edc4bd421 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -8,16 +8,16 @@ nav: - 'Install summary': installation-summary.md - 'Install details': install.md - energy-rates.md + - apps-yaml.md - car-charge-planning.md - - config-yml-settings.md - configuration-guide.md - customisation.md - video-guides.md - faq.md - 'Viewing Predbat data': - output-data.md - - creating-charts.md - predbat-plan-card.md + - creating-charts.md - 'Predbat development': - other-inverters.md - todo-list.md