mirror of
https://github.com/Akkudoktor-EOS/EOS.git
synced 2026-11-13 01:03:45 +01:00
A battery profile describes a battery model: the charge and discharge limit
maps over temperature and SoC, the charge and discharge efficiency curves
over C-rate, the technical SoC bounds, the hard temperature cutoffs and,
for a model, its nominal capacity and power limits. EOS packages the
generic profile generic-lfp; users add their own profiles.
A battery or electric vehicle selects its profile by battery_profile and
describes how the installation differs from it in profile_adjustment
(capacity, power limits of the installation, periodic full charge). The
effective values are resolved from both at the measured operating point
(temperature, SoC, power) and shown as effective_* fields.
The GENETIC simulation uses the limits and efficiencies of the profile over
SoC, with precomputed tables as a fast path; GENETIC0 gets the values at the
operating point. Optimization parameters are always valid: a battery whose
profile is missing, unreadable or invalid uses the packaged generic-lfp
profile, and the former defaults only if that is not usable either; each is
logged as error, and an optimization run is never cancelled because of a
battery.
Additional changes
- Add a generic device profile store: user and packaged profiles, atomic
saves, compiled profiles cached per file and checked again at most once a
second, plain file names as profile names ('schema' is reserved). On
Windows, a save or read that collides with the other is retried briefly.
- Add the REST API /v1/profile to list the profile kinds and to list, read
(document and JSON schema), save and delete profiles.
- Check the hard temperature cutoffs on the exact temperature.
- Resolve inhibited charging or discharging to a power of 0, e.g. for a cold
battery; give GENETIC0 its own discharge limit for that.
- Limit generic profiles without own power limits to the former 5000 W.
- Accept only the implemented units; current limits need the nominal
voltage.
- Migrate legacy battery settings into the profile adjustment, keep the
former charge power limit as discharge limit (also for a Home Assistant
entity on it) and report dropped efficiencies as errors.
- Limit GENETIC battery discharge by the discharge power.
- Allow battery profile lookups while the configuration is created.
- Resolve a battery once per configuration dump.
- Package the bundled profiles, document battery profiles and regenerate
the configuration and OpenAPI documentation.
- Ignore the report PDFs written by the visualization tests.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Assisted-by: Claude Code (claude-opus-5-5)
126 lines
3.2 KiB
JSON
126 lines
3.2 KiB
JSON
{
|
|
"general": {
|
|
"version": "__ANY__",
|
|
"data_output_subpath": "output"
|
|
},
|
|
"cache": {
|
|
"subpath": "cache"
|
|
},
|
|
"ems": {
|
|
"mode": "OPTIMIZATION"
|
|
},
|
|
"devices": {
|
|
"batteries": {
|
|
"battery1": {
|
|
"device_id": "battery1"
|
|
}
|
|
},
|
|
"max_batteries": 1,
|
|
"electric_vehicles": {
|
|
"ev11": {
|
|
"device_id": "ev11",
|
|
"profile_adjustment": {
|
|
"nominal_capacity_wh": 50000
|
|
},
|
|
"min_soc_percentage": 70
|
|
}
|
|
},
|
|
"max_electric_vehicles": 1,
|
|
"inverters": {
|
|
"inverter1": {
|
|
"device_id": "inverter1",
|
|
"max_power_w": 10000.0,
|
|
"battery_id": "battery1"
|
|
}
|
|
},
|
|
"max_inverters": 1,
|
|
"home_appliances": {
|
|
"dishwasher1": {
|
|
"device_id": "dishwasher1",
|
|
"consumption_wh": 2000
|
|
}
|
|
},
|
|
"max_home_appliances": 1
|
|
},
|
|
"elecprice": {
|
|
"provider": "ElecPriceAkkudoktor"
|
|
},
|
|
"feedintariff": {
|
|
"provider": "FeedInTariffFixed",
|
|
"feedintarifffixed": {
|
|
"feed_in_tariff_amt_kwh": {
|
|
"windows": [
|
|
{
|
|
"start_time": "00:00:00.000000",
|
|
"duration": "1 day",
|
|
"value": 0.078
|
|
}
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"load": {
|
|
"provider": "LoadAkkudoktorAdjusted",
|
|
"loadakkudoktor": {
|
|
"loadakkudoktor_year_energy_kwh": 3000.0
|
|
}
|
|
},
|
|
"pvforecast": {
|
|
"provider": "PVForecastAkkudoktor",
|
|
"planes": [
|
|
{
|
|
"surface_tilt": 7.0,
|
|
"surface_azimuth": 170.0,
|
|
"userhorizon": [
|
|
20.0,
|
|
27.0,
|
|
22.0,
|
|
20.0
|
|
],
|
|
"peakpower": 5.0,
|
|
"inverter_paco": 10000
|
|
},
|
|
{
|
|
"surface_tilt": 7.0,
|
|
"surface_azimuth": 90.0,
|
|
"userhorizon": [
|
|
30.0,
|
|
30.0,
|
|
30.0,
|
|
50.0
|
|
],
|
|
"peakpower": 4.8,
|
|
"inverter_paco": 10000
|
|
},
|
|
{
|
|
"surface_tilt": 60.0,
|
|
"surface_azimuth": 140.0,
|
|
"userhorizon": [
|
|
60.0,
|
|
30.0,
|
|
0.0,
|
|
30.0
|
|
],
|
|
"peakpower": 1.4,
|
|
"inverter_paco": 2000
|
|
},
|
|
{
|
|
"surface_tilt": 45.0,
|
|
"surface_azimuth": 185.0,
|
|
"userhorizon": [
|
|
45.0,
|
|
25.0,
|
|
30.0,
|
|
60.0
|
|
],
|
|
"peakpower": 1.6,
|
|
"inverter_paco": 1400
|
|
}
|
|
],
|
|
"max_planes": 4
|
|
},
|
|
"weather": {
|
|
"provider": "BrightSky"
|
|
}
|
|
}
|