MercedesME platform as a Custom Component for Home Assistant.

IMPORTANT:

• Please login once in the MercedesME IOS or Android app before you install this component. (For North America, the app name is Mercedes Me Connect)

• Tested Countries: AT, AU, BE, CA, CH, CN, DE, DK, ES, FI, FR, IN, IT, IR, NL, NO, NZ, PT, SE, TH, UK, US

• North America: For Cars 2019 or newer only

• Thailand, India: Please use region "Europe".

• China: support of China is in early stage

• First: This is not a Home Assistant Add-On. It's a custom component.
• There are two ways to install. First you can download the folder custom_component and copy it into your Home-Assistant config folder. Second option is to install HACS (Home Assistant Custom Component Store) and select "MercedesME 2020" from the Integrations catalog.
• How to install a custom component?
• How to install HACS?
• Restart HA after the installation
• Make sure that you refresh your browser window too
• Use the "Add Integration" in Home Assistant, Settings, Devices & Services and select "MercedesME 2020".
• Use your MB-login email address. Your will receive a 6-digit code via email (valid for 15min).

See Options dialog in the Integration under Home-Assistant/Configuration/Integration.

Excluded Cars: comma-separated list of VINs.
PIN: Security PIN to execute special services. Please use your MB mobile app to setup
Disable Capability Check: By default the component checks the capabilities of a car. Active this option to disable the capability check. (For North America)
Debug Save Messages: Enable this option to save all relevant received message into the messages folder of the component

Depends on your own car or purchased Mercedes Benz licenses.

• warningwashwater

• warningcoolantlevellow

• warningbrakefluid

• warningenginelight

  attributes: 
  warningbrakefluid, warningwashwater, warningcoolantlevellow, warninglowbattery
  

• parkbrakestatus

  attributes: 
  preWarningBrakeLiningWear
  

• tirewarninglamp

  attributes: 
  tirepressureRearLeft, tirepressureRearRight, tirepressureFrontRight, tirepressureFrontLeft, tireMarkerFrontRight, tireMarkerFrontLeft,tireMarkerRearLeft, tireMarkerRearRight, tirewarningsrdk, tirewarningsprw, tireTemperatureRearLeft, tireTemperatureFrontRight,
  tireTemperatureRearRight, tireTemperatureFrontLeft
  

• windowsClosed

  attributes: 
  windowstatusrearleft, windowstatusrearright, windowstatusfrontright, windowstatusfrontleft
  

• remoteStartActive

• engineState

attributes:
positionHeading

• lock

  PIN setup in MB App is required. If the pin is not set in the integration options then the lock asks for the PIN.

• lock

  attributes: 
  decklidstatus, doorStatusOverall, doorLockStatusOverall, doorlockstatusgas, doorlockstatusvehicle, doorlockstatusfrontleft,doorlockstatusfrontright, doorlockstatusrearright, doorlockstatusrearleft, doorlockstatusdecklid, doorstatusrearleft, doorstatusfrontright, doorstatusrearright, doorstatusfrontleft, rooftopstatus, sunroofstatus, engineHoodStatus
  

  Internal value: doorlockstatusvehicle

  Values: 0: vehicle unlocked 1: vehicle internal locked 2: vehicle external locked 3: vehicle selective unlocked

• Fuel Level (%)

  attributes: 
  tankLevelAdBlue
  

• Geofencing Violation

  attributes: 
  Last_event_zone
  

  Values: ENTER LEAVE

• odometer

  attributes: 
  distanceReset, distanceStart, averageSpeedReset, averageSpeedStart, distanceZEReset, drivenTimeZEReset, drivenTimeReset, drivenTimeStart, ecoscoretotal, ecoscorefreewhl, ecoscorebonusrange, ecoscoreconst, ecoscoreaccel, gasconsumptionstart, gasconsumptionreset, gasTankRange, gasTankLevel, liquidconsumptionstart, liquidconsumptionreset, liquidRangeSkipIndication, rangeliquid, serviceintervaldays, tanklevelpercent, tankReserveLamp, batteryState, tankLevelAdBlue
  

• Range Electric

  attributes: 
  rangeelectric, chargingstatus, chargingPower, distanceElectricalReset, distanceElectricalStart, ecoElectricBatteryTemperature,
  electricconsumptionstart, electricconsumptionreset, endofchargetime, precondActive, precondNow, maxrange, selectedChargeProgram, soc
  

• Starter Battery State

  Internal Name: starterBatteryState
  
  Values     Description_short     Description_long
  "0"        "green"               "Vehicle ok"
  "1"        "yellow"              "Battery partly charged"
  "2"        "red"                 "Vehicle not available"
  "3"        "serviceDisabled"     "Remote service disabled"
  "4"        "vehicleNotAvalable"  "Vehicle no longer available"
  

• State of Charge (soc)

  Internal Name: soc
  
  State of charge (SoC) is the level of charge of an electric battery relative to its capacity. The units of SoC are percentage points (0% = empty; 100% = full). 
  
  attributes: 
  maxSocLowerLimit, maxSoc, chargingPower
  
  

• Ignition state

  Internal Name: ignitionstate
  
  Values     Description_short     Description_long
  "0"        "lock"                "Ignition lock"
  "1"        "off"                 "Ignition off"
  "2"        "accessory"           "Ignition accessory"
  "4"        "on"                  "Ignition on"
  "5"        "start"               "Ignition start"
  

• Aux Heat Status

  Internal Name: auxheatstatus
  
  Values    Description
  "0"       inactive
  "1"       normal heating
  "2"       normal ventilation
  "3"       manual heating
  "4"       post heating
  "5"       post ventilation
  "6"       auto heating
  
  attributes:
  auxheattime1, auxheattime2, auxheattime3, auxheattimeselection, auxheatActive, auxheatwarnings, auxheattime2: '00:00'
  
  

Diagnostic sensors are hidden by default, check the devices page to see the current values

• Car

  attributes: 
  full_update_messages_received, partital_update_messages_received, last_message_received, last_command_type, last_command_state, last_command_error_code, last_command_error_message
  

• RCP_Features

  Sensor shows true if extended configuration like interior lighting is available. This feature requires a reauthentication in case you used a version <0.6 before (We need some more permissions...). Shows False in case reauthentication has not happened or the feature is not available for your car.

  attributes: 
  rcp_supported_settings (List of all remote configuration options, I'll implement them step by step as services or buttons)
  

Some services require that the security PIN is created in your mobile Android/IOS app. Please store the pin to the options-dialog of the integration

• refresh_access_token: Refresh the API access token

• auxheat_start: Start the auxiliary heating of a car defined by a vin.

• auxheat_stop: Stop the auxiliary heating of a car defined by a vin.

• battery_max_soc_configure: Configure the maximum value for the state of charge of the HV battery of a car defined by a vin.

• doors_unlock: Unlock a car defined by a vin. PIN required.

• doors_lock: Lock a car defined by a vin.

• engine_start: Start the engine of a car defined by a vin. PIN required.

• engine_stop: Stop the engine of a car defined by a vin.

• preheat_start: Start the preheating of a zero emission car defined by a vin.

• preheat_start_departure_time: Start the preheating of a zero emission car defined by a vin and the departure time in minutes since midnight

• preheat_stop: Stop the preheating of a zero emission car defined by a vin.

• send_route: Send a route to a car defined by a vin.

• sigpos_start: Start light signaling of a car defined by a vin.

• sunroof_open: Open the sunroof of a car defined by a vin. PIN required.

• sunroof_close: Close the sunroof of a car defined by a vin.

• windows_open: Open the windows of a car defined by a vin. PIN required.

• windows_close: Close the windows of a car defined by a vin.

• AuxHeat - Start/Stop the auxiliary heating of the car

Set the logging to debug with the following settings in case of problems.

logger:
  default: warn
  logs:
    custom_components.mbapi2020: debug

• Add missing Sensors (Theft)

• In case of problems after a restore of Home Assistant, please delete the file .mercedesme-token-cache in your HA-config folder and restart HA

• Forum post