Skip to content
This repository has been archived by the owner on Aug 11, 2020. It is now read-only.
/ mbapipy Public archive

MercedesME platform as a Custom Component for Home Assistant.

License

Notifications You must be signed in to change notification settings

ReneNulschDE/mbapipy

Repository files navigation

mbapipy

  • ⚠️ Update 2020-08-01: The car vendor has disabled the API endpoints. This integration does not work currently.

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 US/CA the app name is "MercedesME Connect" (only newer cars are supported in this region)

Configuration:

mercedesmeapi:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD

Optional configuration values

mercedesmeapi:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD
  pin: XXXX                           # required to open the lock or to start the engine, please use the Mercedes web or app to set-up the pin
  
  country_code: DE                    # two digts country code
  accept_lang: en_DE                  # four digits country code
  save_car_details: true              # save a json to the HA config directory with the features and states, please use this for debug only 
  cars:                               # Optional block to overwrite car specific options
    - vin: FINXXXXXXXXXXXXX1          # required finorvin
      tire_warning: tirewarninglamp   # optional attributname for tire_warning binary sensor. some cars use tireWarningRollup or tirewarninglamp
      name: Some Car                  # Optional name of the car to overwrite the default naming. Use "" to remove the name
    - vin: FINXXXXXXXXXXXXX2
      tire_warning: tireWarningRollup

Available components:

  • Lock

  • Remote Start Switch

  • Aux Heat Switch

  • Binary Sensors:

* warningwashwater
  
* warningcoolantlevellow
  
* warninglowbattery
  
* warningbrakefluid

* liquidRangeCritical

* warningenginelight
  attributes: warningbrakefluid, warningwashwater, warningcoolantlevellow, warninglowbattery

* parkbrakestatus
  attributes: preWarningBrakeLiningWear

* windowsClosed
  attributes: windowstatusrearleft, windowstatusrearright, windowstatusfrontright, windowstatusfrontleft

* tirewarninglamp
  attributes: tirepressureRearLeft, tirepressureRearRight, tirepressureFrontRight, tirepressureFrontLeft, tirewarningsrdk, tirewarningsprwtireMarkerFrontRight, tireMarkerFrontLeft, tireMarkerRearLeft, tireMarkerRearRight, tireWarningRollup, lastTirepressureTimestamp
  • Sensors:
* lock
  attributes: doorStateFrontLeft, doorStateFrontRight, doorStateRearLeft, doorStateRearRight, frontLeftDoorLocked, frontRightDoorLocked, rearLeftDoorLocked, rearRightDoorLocked, frontLeftDoorClosed, frontRightDoorClosed, rearLeftDoorClosed, rearRightDoorClosed, rearRightDoorClosed, doorsClosed, trunkStateRollup, sunroofstatus, fuelLidClosed, engineHoodClosed

* rangeElectricKm
  attributes: rangeelectric, rangeElectricKm, criticalStateOfSoc, maxrange, stateOfChargeElectricPercent, endofchargetime, criticalStateOfDeparturetimesoc, warninglowbattery, electricconsumptionreset, maxStateOfChargeElectricPercent, supplybatteryvoltage, electricChargingStatus, chargingstatus, soc, showChargingErrorAndDemand, electricconsumptionstart
  
* auxheatstatus
  attributes: auxheatActive, auxheatwarnings, auxheatruntime, auxheatwarningsPush, auxheattimeselection, auxheattime1, auxheattime2, auxheattime3

* tanklevelpercent
  attributes: tankLevelAdBlue

* 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

* car alarm
  attributes: lastTheftWarning, towSensor, theftSystemArmed, parkEventType, parkEventLevel, carAlarmLastTime, towProtectionSensorStatus, theftAlarmActive, lastTheftWarningReason, lastParkEvent, collisionAlarmTimestamp, interiorSensor, carAlarmReason
  

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

logger:
  default: warn
  logs:
    custom_components.mercedesmeapi: debug
    custom_components.mercedesmeapi.sensor: info
    custom_components.mercedesmeapi.apicontroller: debug
    custom_components.mercedesmeapi.OAuth: debug

Notes:

  • Tested countries: CA, DE, DK, ES, FI, NL, PL, UK, US
  • For Canada please use Country Code US currently
  • Cars out of North America and Europe can't be used at the same time