mg2mqtt

← Vehicles

Required MQTT broker configuration and a SAIC/MQTT Gateway (github.com/SAIC-iSmart-API/saic-python-mqtt-gateway or github.com/SAIC-iSmart-API/saic-java-client)

Parameters

Name	Description	Level
`user`	Username e.g. email address, user id, etc.	optional
`vin`	Vehicle Identification Number If you own multiple vehicles from the same manufacturer Example: `W...`	optional
`title`	Title Will be displayed in the user interface	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`timeout`	Timeout Default: `1h` Example: `10s`	optional
`icon`	Icon Will be displayed in the user interface Default: `car`	advanced
`phases`	Maximum number of phases The maximum number of phases which can be used Example: `3`	advanced
`mode`	Default charging mode Used when a vehicle is connected. Possible values are Off, Now, MinPV and PV, or empty if none should be set	advanced
`minCurrent` [A]	Minimum amperage The minimum amperage per connected phase that can be used Example: `6`	advanced
`maxCurrent` [A]	Maximum amperage The maximum amperage per connected phase that can be used Example: `16`	advanced
`maxPower` [W]	Maximum charging power hint 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. Example: `10000`	advanced
`identifiers`	Identification Mostly this can be added later, see: https://docs.evcc.io/en/docs/features/vehicle	advanced
`priority`	Priority Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating pv energy	advanced

Configuration example for evcc.yaml

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

vehicles:
    - name: my_car
      type: template
      template: mg2mqtt
      user: # Username, e.g. email address, user id, etc.
      vin: W... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer
      title: # Title, Will be displayed in the user interface (optional)
      capacity: 50 # Battery capacity (kWh), optional
      timeout: 1h # Timeout, optional
      icon: car # Icon, Will be displayed in the user interface [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] (optional)
      phases: 3 # Maximum number of phases, The maximum number of phases which can be used (optional)
      mode: # Default charging mode, Used when a vehicle is connected. Possible values are Off, Now, MinPV and PV, or empty if none should be set (optional)
      minCurrent: 6 # Minimum amperage (A), The minimum amperage per connected phase that can be used (optional)
      maxCurrent: 16 # Maximum amperage (A), The maximum amperage per connected phase that can be used (optional)
      maxPower: 10000 # Maximum charging power hint (W), 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._ (optional)
      identifiers: # Identification, Mostly this can be added later, see: https://docs.evcc.io/en/docs/features/vehicle (optional)
      priority: # Priority, Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating pv energy (optional)