This is the main control logic configuration:

```
timezone: Europe/Berlin #your time zone. not optional.
time_resolution_minutes: 60 # Time resolution for forecasts: 15 (quarter-hourly) or 60 (hourly). Default: 60
loglevel: debug
logfile_enabled: true
log_everything: false # if false debug messages from fronius.auth and urllib3.connectionpool will be suppressed
max_logfile_size: 200 #kB
logfile_path: logs/batcontrol.log
```

## Time Resolution (with 0.6.0)
```
time_resolution_minutes: 60
```
This parameter controls the time resolution for all forecasts (solar production, consumption, and electricity prices). Valid values are:
* **60** (default) - Hourly intervals, backward compatible, lower memory usage
* **15** - Quarter-hourly intervals, higher accuracy for dynamic tariffs, 4x more data points

**Recommendation**: Use **15 minutes** if your dynamic tariff provider offers quarter-hourly prices (e.g., some Tibber or energyforecast.de plans). Use **60 minutes** for standard hourly tariffs or if you want to minimize resource usage.

**Technical Details**:
- 15-min mode: 192 intervals per 48 hours (~8 KB per forecast)
- 60-min mode: 48 intervals per 48 hours (~2 KB per forecast)
- All forecast providers automatically adapt to the configured resolution
- MQTT topics publish data at the configured interval

## Timezone
This parameter is used to calculate the correct time for your location, as some datasources deliver UTC based timeslots.
Valid values are [tz based(wikipedia)](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).

## Logfile
### Logpath
```
logfile_path: logs/batcontrol.log
```
Describes where logfiles are stored. The path can be relative or absolute.

### Log Level
```
loglevel: debug
```
Increases or decreases the verbosity of log messages. Valid entries are

* error
* warning
* info
* debug

The recommended settings are `info` and `debug`.
To reduce the noise in the default setup, we introduced
```
log_everything: false
```
Setting this to `true`, the logmessage from Fronius authentication logic + HTTP-Requests are visible in the logfile. These are very verbose messages, which is the reason to only enable it for debugging purposes.


### Enable / Disable logfile

```
logfile_enabled: true
```

This parameter is used to enable a pyhsical logfile. Console out is still active if this value is set to `false`. This can be useful in docker-based environments.

### Logsize

```
max_logfile_size: 200 #Kb
```
Amount of logsize bevore a logswitch is applied. The logs switches from log.1 to log.2 and back. Each file will be the size of `max_logfile_size`. This is used to avoid a filling up disk.

## Batcontrol alogrithm configuration

```
battery_control:
  min_price_difference: 0.05 
  min_price_difference_rel: 0.10
  always_allow_discharge_limit: 0.90
  max_charging_from_grid_limit: 0.89
  min_recharge_amount: 100          
```
Details about the Price configuration can be found on [price difference calculation](https://github.com/muexxl/batcontrol/wiki/Price-difference-calcualtion) page.
`always_allow_discharge_limit` & `max_charging_from_grid_limit` is explained [here](https://github.com/muexxl/batcontrol/wiki/How-batcontrol-works).

![Picture of different parameters on battery soc](https://camo.githubusercontent.com/95792e6b6a1da990e2468613cefbcda7cdc53c0805b0ccc9768c3ab2eac013c1/68747470733a2f2f76696c6c61696e2e626974636176652e63632f7e7374727562656c2f626174636f6e74726f6c2f626174746572795f6c696d6974735f706172616d657465722e706e67)

`min_recharge_amount` controls the minimum amount of Wh is needed to be recharged before batcontrol activates battery charging.

## Battery Control Expert Tuning Parameters

```
battery_control_expert:
  charge_rate_multiplier: 1.1
  soften_price_difference_on_charging: false
  soften_price_difference_on_charging_factor: 5
  round_price_digits: 4
  production_offset_percent: 1.0
```

These expert parameters allow fine-tuning of Batcontrol's behavior. See [Battery Control Expert](https://github.com/muexxl/batcontrol/wiki/battery_control_expert) for detailed explanations of each parameter:

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `charge_rate_multiplier` | float | 1.1 | Multiplier for calculated charge rate to compensate for charging inefficiencies |
| `soften_price_difference_on_charging` | boolean | false | Enable earlier charging based on more relaxed price difference calculations |
| `soften_price_difference_on_charging_factor` | integer | 5 | Factor to soften price difference requirements when enabled |
| `round_price_digits` | integer | 4 | Decimal places for price rounding in comparisons |
| `production_offset_percent` | float | 1.0 | Multiplier to adjust solar production forecast (1.0 = no change, 0.8 = 80%, etc.) |