mirror of
https://github.com/Akkudoktor-EOS/EOS.git
synced 2026-09-03 14:36:37 +00:00
7bafc8d02d
* feat: add PVForecastHomeAssistant provider
Reads a PV forecast time series directly from a Home Assistant entity
attribute (matching the {"forecast": [{"datetime", "watts"}]} shape
already exposed by common HA PV forecast integrations, e.g. Helios
Forecast and Solcast) and feeds it into pvforecast_ac_power, following
the same self-polling provider pattern as PVForecastVrm.
Closes #1232.
* fix: use MagicMock instead of monkeypatched Response for mypy
requests.Response().json is a typed bound method; reassigning it to a
lambda fails mypy's method-assign check. Use MagicMock(spec=...) instead,
which mocks the response without fighting its static type.
* fix: address PR review on PVForecastHomeAssistant provider
Fixes two issues raised in review on PR #1258:
- _update_data() left stale pvforecast_ac_power values in place when a
refreshed forecast was empty or shorter than a previous one; it now
clears the active forecast window before writing and raises instead
of silently no-op'ing when the response has no usable data.
- pvforecast.homeassistant.entity_id used a "select" widget with no
manual-entry fallback in EOSdash, leaving it unusable in standalone
mode where the entity list can't be resolved without SUPERVISOR_TOKEN;
switched to a plain text field.
Also fills in the config docs and openapi.json for the new
pvforecast.homeassistant.* fields, which were missing from the
original commit.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
* fix: preserve retained forecast history when clearing stale entries
The previous fix cleared pvforecast_ac_power from start-of-day, but
PredictionProvider deliberately retains historical records back to
keep_datetime (prediction.historic_hours). Since Home Assistant
forecasts are future-only, that clear wiped out retained history
between midnight and the EMS start on every refresh.
Narrow the clear to [ems_start_datetime, end_datetime) - the actual
active forecast window, DST-adjusted - instead of the day boundary.
Addresses review feedback from @NormannK on PR #1258.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---------
Co-authored-by: Mathias <mathias@Mathiass-MacBook-Air.local>
Co-authored-by: Mathias <mathias@Mathiass-Air.localdomain>
Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
339 lines
9.9 KiB
Markdown
339 lines
9.9 KiB
Markdown
## Full example Config
|
|
|
|
<!-- pyml disable line-length -->
|
|
```json
|
|
{
|
|
"adapter": {
|
|
"provider": [
|
|
"HomeAssistant"
|
|
],
|
|
"homeassistant": {
|
|
"config_entity_ids": null,
|
|
"load_emr_entity_ids": null,
|
|
"grid_export_emr_entity_ids": null,
|
|
"grid_import_emr_entity_ids": null,
|
|
"pv_production_emr_entity_ids": null,
|
|
"device_measurement_entity_ids": null,
|
|
"device_instruction_entity_ids": null,
|
|
"solution_entity_ids": null
|
|
},
|
|
"nodered": {
|
|
"host": "127.0.0.1",
|
|
"port": 1880
|
|
}
|
|
},
|
|
"cache": {
|
|
"subpath": "cache",
|
|
"cleanup_interval": 300.0
|
|
},
|
|
"database": {
|
|
"provider": "LMDB",
|
|
"compression_level": 0,
|
|
"initial_load_window_h": 48,
|
|
"keep_duration_h": 48,
|
|
"autosave_interval_sec": 5,
|
|
"compaction_interval_sec": 3600,
|
|
"batch_size": 100
|
|
},
|
|
"devices": {
|
|
"batteries": [
|
|
{
|
|
"device_id": "battery1",
|
|
"capacity_wh": 8000,
|
|
"charging_efficiency": 0.88,
|
|
"discharging_efficiency": 0.88,
|
|
"levelized_cost_of_storage_kwh": 0.0,
|
|
"max_charge_power_w": 5000,
|
|
"min_charge_power_w": 50,
|
|
"charge_rates": [
|
|
0.0,
|
|
0.1,
|
|
0.2,
|
|
0.3,
|
|
0.4,
|
|
0.5,
|
|
0.6,
|
|
0.7,
|
|
0.8,
|
|
0.9,
|
|
1.0
|
|
],
|
|
"min_soc_percentage": 0,
|
|
"max_soc_percentage": 100
|
|
}
|
|
],
|
|
"max_batteries": 1,
|
|
"electric_vehicles": [
|
|
{
|
|
"device_id": "battery1",
|
|
"capacity_wh": 8000,
|
|
"charging_efficiency": 0.88,
|
|
"discharging_efficiency": 0.88,
|
|
"levelized_cost_of_storage_kwh": 0.0,
|
|
"max_charge_power_w": 5000,
|
|
"min_charge_power_w": 50,
|
|
"charge_rates": [
|
|
0.0,
|
|
0.1,
|
|
0.2,
|
|
0.3,
|
|
0.4,
|
|
0.5,
|
|
0.6,
|
|
0.7,
|
|
0.8,
|
|
0.9,
|
|
1.0
|
|
],
|
|
"min_soc_percentage": 0,
|
|
"max_soc_percentage": 100
|
|
}
|
|
],
|
|
"max_electric_vehicles": 1,
|
|
"inverters": [],
|
|
"max_inverters": 1,
|
|
"home_appliances": [],
|
|
"max_home_appliances": 1
|
|
},
|
|
"elecfee": {
|
|
"provider": "ElecFeeFixed",
|
|
"elecfeefixed": {
|
|
"consumption_amt_kwh": {
|
|
"windows": []
|
|
},
|
|
"consumption_percent_amt": {
|
|
"windows": []
|
|
},
|
|
"feedin_amt_kwh": {
|
|
"windows": []
|
|
},
|
|
"feedin_percent_amt": {
|
|
"windows": []
|
|
}
|
|
},
|
|
"elecfeeimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
}
|
|
},
|
|
"elecprice": {
|
|
"provider": "ElecPriceAkkudoktor",
|
|
"akkudoktor": {},
|
|
"elecpricefixed": {
|
|
"elecprice_marketprice_amt_kwh": {
|
|
"windows": []
|
|
}
|
|
},
|
|
"elecpriceimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"energycharts": {
|
|
"bidding_zone": "DE-LU"
|
|
},
|
|
"smard": {
|
|
"filter_id": 4169,
|
|
"region": "DE"
|
|
},
|
|
"tibber": {
|
|
"access_token": null,
|
|
"home_id": null
|
|
}
|
|
},
|
|
"ems": {
|
|
"startup_delay": 5.0,
|
|
"interval": 300.0,
|
|
"mode": "OPTIMIZATION"
|
|
},
|
|
"feedintariff": {
|
|
"provider": "FeedInTariffFixed",
|
|
"feedintarifffixed": {
|
|
"feed_in_tariff_amt_kwh": {
|
|
"windows": []
|
|
}
|
|
},
|
|
"feedintariffimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"dvhubonline": {
|
|
"base_url": "https://dvhub.online",
|
|
"zone": "DE-LU"
|
|
},
|
|
"energycharts": {
|
|
"bidding_zone": "DE-LU"
|
|
},
|
|
"smard": {}
|
|
},
|
|
"general": {
|
|
"config_save_mode": "AUTOMATIC",
|
|
"config_save_interval_sec": 60,
|
|
"version": "0.0.0",
|
|
"data_folder_path": "/home/user/.local/share/net.akkudoktoreos.net",
|
|
"data_output_subpath": "output",
|
|
"latitude": 52.52,
|
|
"longitude": 13.405
|
|
},
|
|
"load": {
|
|
"provider": "LoadAkkudoktor",
|
|
"loadakkudoktor": {
|
|
"loadakkudoktor_year_energy_kwh": null
|
|
},
|
|
"loadimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"vrm": {
|
|
"token": "your-token",
|
|
"site_id": 12345
|
|
}
|
|
},
|
|
"logging": {
|
|
"api_level": "TRACE",
|
|
"console_level": "TRACE",
|
|
"file_level": "TRACE"
|
|
},
|
|
"measurement": {
|
|
"historic_hours": 17520,
|
|
"load_emr_keys": [
|
|
"load0_emr"
|
|
],
|
|
"grid_export_emr_keys": [
|
|
"grid_export_emr"
|
|
],
|
|
"grid_import_emr_keys": [
|
|
"grid_import_emr"
|
|
],
|
|
"pv_production_emr_keys": [
|
|
"pv1_emr"
|
|
]
|
|
},
|
|
"optimization": {
|
|
"algorithm": "GENETIC",
|
|
"genetic": {
|
|
"interval_sec": 3600,
|
|
"horizon_hours": 24,
|
|
"individuals": 400,
|
|
"generations": 400,
|
|
"seed": null,
|
|
"penalties": {
|
|
"ev_soc_miss": 10
|
|
}
|
|
},
|
|
"genetic0": {
|
|
"horizon_hours": 24,
|
|
"individuals": 400,
|
|
"generations": 400,
|
|
"seed": null,
|
|
"penalties": {
|
|
"ev_soc_miss": 10
|
|
}
|
|
}
|
|
},
|
|
"prediction": {
|
|
"hours": 48,
|
|
"historic_hours": 48
|
|
},
|
|
"pvforecast": {
|
|
"provider": "PVForecastAkkudoktor",
|
|
"pvforecastimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
},
|
|
"vrm": {
|
|
"token": "your-token",
|
|
"site_id": 12345
|
|
},
|
|
"homeassistant": {
|
|
"entity_id": "sensor.pv_forecast",
|
|
"attribute": "forecast",
|
|
"datetime_key": "datetime",
|
|
"value_key": "watts",
|
|
"value_unit": "W",
|
|
"base_url": null,
|
|
"token": null
|
|
},
|
|
"pvlib": {},
|
|
"pvnode": {
|
|
"api_key": "",
|
|
"site_id": null,
|
|
"forecast_days": 2
|
|
},
|
|
"forecastsolar": {
|
|
"api_key": null
|
|
},
|
|
"solcast": {
|
|
"api_key": "",
|
|
"site_id": ""
|
|
},
|
|
"planes": [
|
|
{
|
|
"surface_tilt": 10.0,
|
|
"surface_azimuth": 180.0,
|
|
"userhorizon": [
|
|
10.0,
|
|
20.0,
|
|
30.0
|
|
],
|
|
"peakpower": 5.0,
|
|
"pvtechchoice": "crystSi",
|
|
"mountingplace": "free",
|
|
"loss": 14.0,
|
|
"trackingtype": 0,
|
|
"optimal_surface_tilt": false,
|
|
"optimalangles": false,
|
|
"albedo": null,
|
|
"module_model": null,
|
|
"inverter_model": null,
|
|
"inverter_paco": 6000,
|
|
"modules_per_string": 20,
|
|
"strings_per_inverter": 2
|
|
},
|
|
{
|
|
"surface_tilt": 20.0,
|
|
"surface_azimuth": 90.0,
|
|
"userhorizon": [
|
|
5.0,
|
|
15.0,
|
|
25.0
|
|
],
|
|
"peakpower": 3.5,
|
|
"pvtechchoice": "crystSi",
|
|
"mountingplace": "free",
|
|
"loss": 14.0,
|
|
"trackingtype": 1,
|
|
"optimal_surface_tilt": false,
|
|
"optimalangles": false,
|
|
"albedo": null,
|
|
"module_model": null,
|
|
"inverter_model": null,
|
|
"inverter_paco": 4000,
|
|
"modules_per_string": 20,
|
|
"strings_per_inverter": 2
|
|
}
|
|
],
|
|
"max_planes": 1
|
|
},
|
|
"server": {
|
|
"host": "127.0.0.1",
|
|
"port": 8503,
|
|
"verbose": false,
|
|
"startup_eosdash": true,
|
|
"eosdash_host": "127.0.0.1",
|
|
"eosdash_port": 8504,
|
|
"eosdash_supervise_interval_sec": 10,
|
|
"run_as_user": null,
|
|
"reload": true
|
|
},
|
|
"utils": {},
|
|
"weather": {
|
|
"provider": "WeatherImport",
|
|
"weatherimport": {
|
|
"import_file_path": null,
|
|
"import_json": null
|
|
}
|
|
}
|
|
}
|
|
```
|
|
<!-- pyml enable line-length -->
|