2025-11-13 22:53:46 +01:00
## Energy Management Configuration
<!-- pyml disable line-length -->
:::{table} ems
:widths: 10 20 10 5 5 30
:align: left
| Name | Environment Variable | Type | Read-Only | Default | Description |
| ---- | -------------------- | ---- | --------- | ------- | ----------- |
2026-02-22 14:12:42 +01:00
| interval | `EOS_EMS__INTERVAL` | `float` | `rw` | `300.0` | Intervall between EOS energy management runs [seconds]. |
2026-08-07 13:13:17 +02:00
| mode | `EOS_EMS__MODE` | `<enum 'EnergyManagementMode'>` | `rw` | `required` | Energy management mode [DISABLED | PREDICTION | OPTIMIZATION]. Defaults to DISABLED. |
| modes | | `list[str]` | `ro` | `N/A` | Available energy management modes. |
2026-10-11 10:48:04 +02:00
| notify_url | `EOS_EMS__NOTIFY_URL` | `Optional[str]` | `rw` | `None` | URL that receives an HTTP POST with a small JSON event after every completed optimization, so a client can fetch the new solution right away instead of polling for it. None = off. |
2025-11-13 22:53:46 +01:00
| startup_delay | `EOS_EMS__STARTUP_DELAY` | `float` | `rw` | `5` | Startup delay in seconds for EOS energy management runs. |
:::
<!-- pyml enable line-length -->
<!-- pyml disable no-emphasis-as-heading -->
2026-08-07 13:13:17 +02:00
**Example Input**
2025-11-13 22:53:46 +01:00
<!-- pyml enable no-emphasis-as-heading -->
<!-- pyml disable line-length -->
```json
{
"ems" : {
"startup_delay" : 5.0 ,
"interval" : 300.0 ,
2026-10-11 10:48:04 +02:00
"mode" : "OPTIMIZATION" ,
"notify_url" : null
2025-11-13 22:53:46 +01:00
}
}
```
<!-- pyml enable line-length -->
2026-08-07 13:13:17 +02:00
<!-- pyml disable no-emphasis-as-heading -->
**Example Output**
<!-- pyml enable no-emphasis-as-heading -->
<!-- pyml disable line-length -->
```json
{
"ems" : {
"startup_delay" : 5.0 ,
"interval" : 300.0 ,
"mode" : "OPTIMIZATION" ,
2026-10-11 10:48:04 +02:00
"notify_url" : null ,
2026-08-07 13:13:17 +02:00
"modes" : [
"DISABLED" ,
"PREDICTION" ,
"OPTIMIZATION"
]
}
}
```
<!-- pyml enable line-length -->