params:
  - name: title
    description:
      de: Titel
      en: Title
    help:
      de: Wird in der Benutzeroberfläche angezeigt
      en: Will be displayed in the user interface
  - name: usage
    description:
      de: Verwendung
      en: Usage
  - name: modbus
    description:
      en: Modbus Type
      de: Modbus Typ
    required: true
  - name: host
    required: true
    description:
      de: IP-Adresse oder Hostname
      en: IP address or hostname
    example: 192.0.2.2
    pattern:
      regex: "^[^\\/\\s]+(:[0-9]{1,5})?$" # any char except slash/space, optional :port
      examples: ["192.168.1.100", "example.com", "server.local:8080"]
  - name: ip
    description:
      de: IP-Adresse
      en: IP address
    example: 192.0.2.2
  - name: port
    description:
      de: Port
      en: Port
    type: int
  - name: interface
    description:
      de: Netzwerkschnittstelle
      en: Network interface
    advanced: true
    example: eth0
  - name: schema
    description:
      generic: Schema
    type: choice
    choice: ["https", "http"]
    default: https
  - name: user
    private: true
    description:
      de: Benutzerkonto
      en: Username
    help:
      de: bspw. E-Mail Adresse, User Id, etc.
      en: e.g. email address, user id, etc.
  - name: password
    description:
      de: Passwort
      en: Password
    help:
      de: Zugangspasswort des Dienstes
      en: Service account password
    mask: true
  - name: capacity
    unit: kWh
    description:
      de: Akkukapazität
      en: Battery capacity
    example: 50
    type: float
    usages: ["vehicle", "battery"]
  - name: maxacpower
    unit: W
    description:
      de: Maximale AC Leistung des Hybrid-Wechselrichters
      en: Maximum AC power of the hybrid inverter
    default: 0
    example: 5000
    type: float
    usages: ["pv"]
    advanced: true
  - name: vin
    private: true
    description:
      de: Fahrzeugidentifikationsnummer
      en: Vehicle Identification Number
    help:
      de: Wenn mehrere Fahrzeuge eines Herstellers vorhanden sind
      en: If you own multiple vehicles from the same manufacturer
    example: W...
  - name: phases
    description:
      de: Maximale Phasenanzahl
      en: Maximum number of phases
    help:
      de: Wird für die Bestimmung des minimalen Solar-Überschusses und der Planungsdauer verwendet.
      en: Used to determine the minimum solar surplus and plan duration.
    type: choice
    choice: ["1", "2", "3"]
  - name: connector
    type: int
    description:
      en: Connector number
      de: Anschlussnummer
    help:
      en: For multi-connector stations. Numbering starts at 1.
      de: Bei Ladestationen mit mehreren Anschlüssen. Zählung beginnt bei 1.
    advanced: true
    default: 1
  - name: cache
    description:
      de: Cache
      en: Cache
    help:
      de: Zeitintervall für erneute Datenabfrage
      en: Time interval for data refresh
    advanced: true
    type: duration
    example: 5m
  - name: timeout
    description:
      de: Zeitüberschreitung
      en: Timeout
    example: 10s
    type: duration
  - name: mode
    description:
      de: Standardlademodus
      en: Default charging mode
    help:
      de: Wird beim Anschließen eines Fahrzeugs gesetzt. Leer lassen, um den aktuellen Modus beizubehalten.
      en: Applied when a vehicle is connected. Leave empty to keep the current mode.
    type: chargemodes
  - name: minsoc
    unit: "%"
    description:
      de: Minimaler Ladestand
      en: Minimum charge
    help:
      de: Untere Grenze beim Entladen der Batterie im normalen Betrieb
      en: Lower limit when discharging the battery in normal operation
    example: 25
    type: int
    usages: ["battery", "vehicle"]
  - name: maxsoc
    unit: "%"
    description:
      de: Maximaler Ladestand
      en: Maximum charge
    help:
      de: Oberes Limit beim Laden der Batterie aus dem Netz
      en: Upper limit when charging the battery from the grid
    example: 95
    type: int
    usages: ["battery"]
  - name: mincurrent
    unit: A
    description:
      de: Minimale Stromstärke
      en: Minimum current
    help:
      de: Definiert die minimale Stromstärke pro angeschlossener Phase die genutzt werden kann
      en: The minimum current per connected phase that can be used
    example: 6
    type: int
  - name: maxcurrent
    unit: A
    description:
      de: Maximale Stromstärke
      en: Maximum current
    help:
      de: Definiert die maximale Stromstärke pro angeschlossener Phase die genutzt werden kann
      en: The maximum current per connected phase that can be used
    example: 16
    type: int
  - name: maxpower
    unit: W
    description:
      de: Ladeleistungs-Hinweis
      en: Maximum charging power hint
    help:
      de: Definiert die maximale Ladeleistung des Fahrzeugs. Hilft, die Ladeplanung zu verbessern, wenn das Fahrzeug üblicherweise weniger Strom nutzt als angeboten oder höhere Ströme bei einphasigem Laden erlaubt als bei dreiphasigem. _Der bereitgestellte Strom des Ladepunktes wird nicht beeinflusst._
      en: Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. _The offered current of the loadpoint is not affected._
    type: int
    example: 10000
  - name: identifiers
    description:
      de: RFID-Identifikation
      en: RFID identification
    help:
      de: "Für die Zuordnung des Fahrzeugs an einen Ladepunkt via RFID-Karte. Die Kennung wird am Ladepunkt angezeigt. Übernehme den Wert von dort. [Mehr erfahren.](https://docs.evcc.io/docs/features/vehicle)"
      en: "Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. [Learn more.](https://docs.evcc.io/en/docs/features/vehicle)"
    type: list
  - name: priority
    description:
      de: Priorität
      en: Priority
    help:
      de: Priorität des Ladepunktes oder Fahrzeugs in Relation zu anderen Ladepunkten oder Fahrzeugen für die Zuweisung von Überschussenergie (höhere Werte, höhere Priorität).
      en: Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority).
    type: int
  - name: standbypower
    unit: W
    description:
      de: Standby-Leistung
      en: Standby power
    help:
      de: Leistung oberhalb des angegebenen Wertes wird als Ladeleistung und damit Status "laden" gewertet. Negative Werte deaktivieren die Statuserkennung.
      en: Power values above this value will be considered as charging power and hence status "charging". Negative values deactivate status detection.
    type: int
  - name: language
    description:
      de: Sprache
      en: Language
    default: en
    type: choice
    choice: ["en", "de"]
  - name: icon
    description:
      de: Icon
      en: Icon
    help:
      de: Wird in der Benutzeroberfläche angezeigt
      en: Will be displayed in the user interface
    type: choice
    choice:
      - car
      - bike
      - bus
      - moped
      - motorcycle
      - rocket
      - scooter
      - taxi
      - tractor
      - rickshaw
      - shuttle
      - van
      - airpurifier
      - battery
      - bulb
      - climate
      - coffeemaker
      - compute
      - cooking
      - cooler
      - desktop
      - device
      - dishwasher
      - dryer
      - floorlamp
      - generic
      - heater
      - heatexchange
      - heatpump
      - kettle
      - laundry
      - laundry2
      - machine
      - meter
      - microwave
      - pump
      - smartconsumer
      - tool
      - waterheater

  - name: ski
    required: true
    private: true
    description:
      en: Subject Key Identifier (SKI)
      de: Identifikationsschlüssel (SKI)
    help:
      en: Usually found on the web interface of the wallbox
      de: Üblicherweise im Web Interface der Wallbox zu finden
    service: eebus/services
  - name: uri
    private: true
    description:
      generic: URI
    help:
      en: HTTP(S) address
      de: HTTP(S) Adresse
  - name: url
    private: true
    description:
      generic: URL
  - name: ain
    private: true
    required: true
    example: "307788992233"
    description:
      en: Actor Identification Number (AIN)
      de: Aktoridentifikationsnummer (AIN)
    help:
      en: Printed on the type label on the back of the device.
      de: Ist auf dem Typenschild auf der Geräterückseite aufgedruckt.
  - name: coarsecurrent
    type: bool
    description:
      en: 1A current control
      de: 1A Ladestromvorgabe
    help:
      en: Vehicle supports 1A current steps only
      de: Fahrzeug unterstützt nur 1A Schritte der Ladestromvorgabe
  - name: streaming
    type: bool
    description:
      en: Supports streaming
      de: Unterstützt Streaming
    help:
      en: Streaming data is received asynchronously
      de: Streaming Datenempfang erfolgt asynchron
  - name: welcomecharge
    type: bool
    advanced: true
    description:
      en: Charge on connection
      de: Laden bei Verbindung
    help:
      en: Charger will enable charging for short time when vehicle is connected, irrespective of configured charge mode. This is useful for vehicles that require power supply when connecting.
      de: Wallbox gibt kurzzeitige Ladefreigabe bei Fahrzeugverbindung. Das ermöglicht es Fahrzeugen, die eine Stromversorgung beim Anschließen benötigen, einen Fehlerzustand zu vermeiden.
  - name: climaterdisabled
    type: bool
    description:
      en: Disable climater detection
      de: Klimatisierungserkennung deaktivieren
    help:
      en: Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request.
      de: Klimatisierungsstatus des Fahrzeugs für die Ladesteuerung ignorieren, sodass der Ladevorgang am SoC- oder Energielimit endet, auch wenn das Fahrzeug einen aktiven Klimatisierungswunsch signalisiert.
  - name: autodetectdisabled
    type: bool
    description:
      en: Exclude from auto detection
      de: Von automatischer Erkennung ausschließen
    help:
      en: Ignore the vehicle for auto detection of connected vehicles
      de: Das Fahrzeug von der automatischen Erkennung beim Anschließen eines Fahrzeugs ausschließen
  - name: heating
    type: bool
    description:
      en: Heating device
      de: Wärmeerzeuger
    help:
      en: Shows °C instead of %
      de: Zeigt °C anstatt % an
  - name: integrateddevice
    type: bool
    description:
      en: Integrated device
      de: Integriertes Gerät
    help:
      en: Integrated device. No charging sessions
      de: Fest angeschlossenes Gerät. Keine Ladevorgänge
  - name: insecure
    type: bool
    advanced: true
    description:
      en: Accept self-signed certificates
      de: Selbstsignierte Zertifikate akzeptieren
  - name: defaultmode
    type: int
    advanced: true
    usages: ["battery"]
    description:
      de: Standardmodus für die aktive Batteriesteuerung
      en: Default mode for battery control
    help:
      de: Wechselrichter fällt nach einem Laden des Speichers oder Unterbinden der Entladung zurück auf diesen Modus.
      en: Inverter falls back to this mode after charging the battery or after stopping discharge.
  - name: maxchargepower
    unit: W
    type: int
    usages: ["battery"]
    description:
      en: Maximum charge power
      de: Maximale Ladeleistung
    help:
      en: For forced charging of the battery.
      de: Für erzwungenes Laden des Speichers.
    advanced: true
  - name: maxchargerate
    unit: "%"
    type: int
    usages: ["battery"]
    description:
      en: Maximum charge rate
      de: Maximale prozentuale Ladeleistung
    help:
      en: For forced charging of the battery in percent in relation to the maximum charge power of the battery inverter.
      de: Für erzwungenes Laden des Speichers in Prozent in Relation zur maximalen Ladeleistung des Batteriewechselrichters.
    default: 100
    advanced: true
  - name: maxdischargepower
    unit: W
    type: int
    usages: ["battery"]
    description:
      en: Maximum discharge power
      de: Maximale Entladeleistung
    help:
      en: Maximum discharge power of the storage.
      de: Maximale Entladeleistung des Speichers.
    advanced: true

  - name: accesstoken
    mask: true
    description:
      generic: Access token
  - name: refreshtoken
    mask: true
    description:
      generic: Refresh token
  - name: serial
    private: true
    description:
      en: Serial
      de: Seriennummer
  - name: region
    description:
      generic: Region
  - name: channel
    description:
      en: Channel
      de: Kanal
    type: int
  - name: clientid
    required: true
    description:
      generic: Client ID
  - name: clientsecret
    mask: true
    required: true
    description:
      generic: Client Secret
  - name: token
    mask: true
    description:
      generic: Token
  - name: interval
    description:
      de: Intervall
      en: Interval
  - name: mac
    private: true
    description:
      en: MAC Address
      de: MAC Adresse
  - name: pin
    mask: true
    description:
      generic: PIN
  - name: watchdog
    type: duration
    advanced: true
    description:
      generic: Watchdog
  - name: uuid
    private: true
    description:
      generic: UUID
  - name: zip
    private: true
    description:
      en: ZIP code
      de: Postleitzahl
  - name: storageunit
    type: int
    default: 1
    advanced: true
    usages: ["battery"]
    description:
      en: Battery storage unit index
      de: Nummer des Batteriespeichers
  - name: delay
    description:
      en: Delay
      de: Verzögerung
  - name: id
    description:
      generic: ID
  - name: stationid
    type: string
    description:
      generic: Station ID
    help:
      en: Unique identifier of the charger. Automatically detected once the charger connects.
      de: Eindeutige Wallbox-Kennung. Wird automatisch erkannt, sobald sich die Wallbox verbindet.
    example: EVB-P12354
    private: true
  - name: meter
    description:
      en: Meter ID
      de: Zählernummer
  - name: domain
    description:
      generic: Domain
  - name: apikey
    description:
      generic: API Key
    mask: true
  - name: tempsource
    description:
      de: Temperaturquelle
      en: Temperature source
  - name: lat
    private: true
    description:
      en: Latitude
      de: Breitengrad
    type: float
    example: 55.7351
    service: location/lat
  - name: lon
    private: true
    description:
      en: Longitude
      de: Längengrad
    type: float
    example: 9.1275
    service: location/lon
  - name: zones
    type: zones
    description:
      en: Price zones
      de: Preiszonen
  - name: baudrate
    description:
      de: Baudrate
      en: Baudrate
    help:
      de: Typische Werte sind 9600, 19200, 38400, 57600, 115200
      en: Typical values are 9600, 19200, 38400, 57600, 115200
    default: 9600
    type: int
  - name: currency
    type: choice
    default: EUR
    required: true
    description:
      en: Currency
      de: Währung
  - name: redirecturi
    required: true
    description:
      generic: Redirect URI

presets:
  vehicle-base:
    - name: user
      required: true
    - name: password
      required: true
    - name: vin
    - name: title
    - name: icon
      default: car
      advanced: true
    - name: capacity
    - name: phases
      advanced: true
    - name: mode
      advanced: true
    - name: minCurrent
      advanced: true
    - name: maxCurrent
      advanced: true
    - name: maxPower
      advanced: true
    - name: identifiers
      advanced: true
    - name: priority
      advanced: true
    - name: cache
      default: 15m
      advanced: true
  vehicle-common:
    - name: title
    - name: icon
      default: car
      advanced: true
    - name: capacity
    - name: phases
      advanced: true
    - name: mode
      advanced: true
    - name: minCurrent
      advanced: true
    - name: maxCurrent
      advanced: true
    - name: maxPower
      advanced: true
    - name: identifiers
      advanced: true
    - name: priority
      advanced: true
  vehicle-features:
    - name: coarsecurrent
      advanced: true
    - name: streaming
      advanced: true
    - name: welcomecharge
      advanced: true
    - name: climaterdisabled
      advanced: true
    - name: autodetectdisabled
      advanced: true
  vehicle-climater:
    - name: climaterdisabled
      advanced: true
  charger-features:
    - name: heating
      advanced: true
    - name: integrateddevice
      advanced: true
  vehicle-language:
    - name: language
  tariff-base:
    - name: charges
      type: pricePerKWh
      advanced: true
      description:
        en: Charge
        de: Aufschlag
      help:
        de: Zusätzlicher fester Aufschlag pro kWh
        en: Additional fixed charge per kWh
    - name: chargesZones
      type: zones
      advanced: true
      description:
        en: Charges zones
        de: Aufschlagszonen
      help:
        de: Zeitabhängige Aufschläge, die den Standardaufschlag überschreiben.
        en: Time-based grid fees that override the default charge.
    - name: tax
      type: float
      advanced: true
      description:
        en: Tax
        de: Steuer
      help:
        de: Zusätzlicher prozentualer Aufschlag (z.B. 0.2 für 20%)
        en: Additional percentage charge (e.g. 0.2 for 20%)
    - name: formula
      type: string
      description:
        en: Formula
        de: Formel
      advanced: true
      help:
        de: Individuelle Formel zur Berechnung des Preises
        en: Individual formula for calculating the price
      example: "math.Max((price + charges) * (1 + tax), 0.0)"
  tariff-features:
    - name: average
      type: bool
      description:
        en: Average by hour
        de: Stündliche Durchschnittskosten verwenden
      advanced: true
  forecast-base:
    - name: lat
      required: true
    - name: lon
      required: true
    - name: az
      description:
        en: Azimuth
        de: Azimut
      help:
        en: Orientation of PV modules in degree. -180 = north, -90 = east, 0 = south, 90 = west, 180 = north
        de: Ausrichtung der PV-Module in Grad. -180 = Norden, -90 = Osten, 0 = Süden, 90 = Westen, 180 = Norden
      type: int
      example: 0
      required: true
    - name: dec
      description:
        en: Decline
        de: Neigung
      help:
        en: 0 = horizontal, 90 = vertical
        de: 0 = horizontal, 90 = vertikal
      type: int
      example: 25
      required: true
    - name: kwp
      description:
        en: Maximum generator power
        de: Maximale Generatorleistung
      unit: kWp
      type: float
      example: 9.8
      required: true

  eebus:
    - name: ski
    - name: ip
  switchsocket:
    - name: standbypower
      default: 15
    - name: integrateddevice
      advanced: true
    - name: heating
      advanced: true
    - name: icon
      advanced: true

  ocpp:
    - name: stationid
    - name: connector
    - name: remotestart
      advanced: true
      type: bool
      description:
        de: Remote-Transaktion bei Fahrzeugverbindung starten
        en: Start remote transaction on vehicle connection
      help:
        de: Diese Option nur aktivieren wenn keinerlei Möglichkeit besteht Transaktionen seitens des Ladepunktes zu initiieren! Das ist nur der Fall wenn z. B. kein RFID-Lesegerät vorhanden ist und Ladevorgänge grundsätzlich einzeln per App freigeschaltet werden müssten. Normalerweise sollte der Ladepunkt am Gerät immer so konfiguriert werden, dass entweder eine RFID-Karte zur Freischaltung verwendet wird oder der Ladepunkt auf "Autostart", "Freies Laden" o.ä. eingestellt ist. Zunächst die Dokumentation und die Konfigurationsmöglichkeiten des Ladepunktes prüfen, ggf. beim Hersteller nachfragen! (Verwendet OCPP RemoteStartTransaction)
        en: Only enable this option if there is no way to initiate transactions from the charger side! This is only the case if e.g. no RFID reader is available and charging processes would have to be released individually via app. Normally, the charger should always be configured at the device so that either an RFID card is used for activation or the charger is set to "Autostart", "Free Charging" or similar. First check the documentation and configuration possibilities of the charger, ask the manufacturer if necessary! (Uses OCPP RemoteStartTransaction)
    - name: idtag
      advanced: true
      private: true
      type: string
      description:
        en: Authentication token
        de: Authentifizierungs-Token
      help:
        de: "Diese Option ist nur in Ausnahmefällen erforderlich wenn der Ladepunkt für die Annahme externer Transaktionen einen spezifischen Token erfordert. (Verwendet OCPP RemoteStartTransaction)"
        en: "This option is only required in exceptional cases if the charger requires a specific token for accepting external transactions. (Uses OCPP RemoteStartTransaction)"
      example: evcc
    - name: connecttimeout
      advanced: true
      type: duration
      default: 5m
      description:
        de: Zeitlimit für die Registrierung
        en: Timeout for registration
      help:
        de: "Zeitlimit für die Registrierung des Ladepunktes"
        en: "Timeout for the registration of the charging point"
    - name: timeout
      advanced: true
      type: duration
      deprecated: true
    - name: meterinterval
      advanced: true
      type: duration
      default: 10s
      description:
        de: Übertragungsintervall der Zählerwerte
        en: Transmission interval for meter values
      help:
        de: "Zeitintervall für die Übertragung der Zählerwerte (MeterValueSampleInterval)"
        en: "Time interval for transmission of meter values (MeterValueSampleInterval)"
    - name: metervalues
      advanced: true
      type: string
      description:
        de: Zählerwerte für die Übertragung
        en: Meter values for transmission
      help:
        de: "Manuelle Vorgabe der zu konfigurierenden Zählerwerte (MeterValuesSampledData)"
        en: "Manual specification of the meter values to be configured (MeterValuesSampledData)"
      example: Energy.Active.Import.Register,Power.Active.Import,SoC,Current.Offered,Power.Offered,Current.Import,Voltage

  mqtt:
    - name: host
      help:
        de: IP Adresse oder der Hostname des MQTT Brokers
        en: IP address or hostname of the MQTT broker
      pattern:
        regex: "^(tls://)?[^\\/\\s]+(:[0-9]{1,5})?$" # optional tls:// prefix, any char except slash/space, optional :port
        examples:
          ["192.168.1.100", "example.com", "server.local:8080", "tls://mqtt.example.com:8883"]
    - name: port
      default: 1883
      help:
        de: MQTT Broker Port
        en: MQTT broker port
    - name: user
      advanced: true
    - name: password
      advanced: true
    - name: topic
      description:
        generic: Topic
      help:
        de: Topic (ohne / am Anfang)
        en: Topic (omit leading /)
    - name: timeout
      default: 30s
      help:
        de: Akzeptiere keine Daten die älter sind als dieser Wert
        en: Don't accept values older than this value

  battery-params:
    - name: capacity
    - name: minsoc
    - name: maxsoc
    - name: maxchargepower
    - name: maxdischargepower

modbus:
  interfaces:
    rs485: ["rs485serial", "rs485tcpip"]
    tcpip: ["tcpip"]
    udp: ["udp"]
  definitions:
    - name: id
      description:
        generic: Modbus ID
      default: 1
      type: int
    - name: device
      description:
        de: Gerätename
        en: Device name
      help:
        de: USB-RS485 Gerätename
        en: USB-RS485 device name
      service: hardware/serial # not actually used
      example: /dev/ttyUSB0
    - name: baudrate
      description:
        de: Baudrate
        en: Baudrate
      help:
        de: Typische Werte sind 9600, 19200, 38400, 57600, 115200
        en: Typical values are 9600, 19200, 38400, 57600, 115200
      default: 9600
      type: int
    - name: comset
      description:
        de: ComSet
        en: ComSet
      help:
        de: Kommunikationsparameter des Adapters
        en: Communication parameter for the adapter
      default: 8N1
    - name: port
      description:
        de: Port
        en: Port
      default: 502
      type: int
  types:
    rs485serial:
      description:
        generic: Serial (USB-RS485 Adapter)
      params:
        - name: id
        - name: device
        - name: baudrate
        - name: comset
    rs485tcpip:
      description:
        generic: Serial (Ethernet-RS485 Adapter)
      params:
        - name: id
        - name: host
        - name: port
          default: 502
    tcpip:
      description:
        generic: TCP/IP
      params:
        - name: id
        - name: host
        - name: port
          default: 502
    udp:
      description:
        generic: UDP
      params:
        - name: id
        - name: host
        - name: port
          default: 502

devicegroups:
  generic:
    de: Generische Unterstützung
    en: Generic support
  heating:
    de: Wärmeerzeuger
    en: Heating devices
  heatinggeneric:
    de: Generische Unterstützung
    en: Generic support
  switchsockets:
    de: Schaltbare Steckdosen
    en: Switchable sockets
  scooter:
    de: Scooter
    en: Scooter
  price:
    de: Dynamischer Strompreis
    en: Dynamic electricity price
  co2:
    de: CO₂ Vorhersage
    en: CO₂ forecast
  solar:
    de: PV Vorhersage
    en: PV forecast