Youliq One

Local access to the Youliq One battery storage via HTTPS API. The device uses a self-signed certificate.

Supported features

Battery control: External control of home battery charging and discharging via evcc.

Usage areas

Battery

Parameters

Name	Description	Level
`host`	IP address or hostname Example: `192.0.2.2`	optional
`capacity` [kWh]	Battery capacity Default: `10.24` Example: `50`	optional
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Default: `0` Example: `25`	optional
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. Default: `100` Example: `95`	optional
`cache`	Cache Time interval for data refresh Default: `5s` Example: `5m`	advanced
`maxchargepower` [W]	Maximum charge power Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power. Default: `2000`	advanced
`maxdischargepower` [W]	Maximum discharge power Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging.	advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

meters:
    - name: my_battery
      type: template
      template: youliq-one
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      capacity: 10.24 # Battery capacity (kWh), optional
      minsoc: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. (optional)
      cache: 5s # Cache, Time interval for data refresh (optional)
      maxchargepower: 2000 # Maximum charge power (W), Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power. (optional)
      maxdischargepower: # Maximum discharge power (W), Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging. (optional)