npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

homebridge-mercedesme

v2.1.2

Published

homebridge-mercedesme

Downloads

63

Readme

homebridge-mercedesme

npm npm GitHub last commit verified-by-homebridge Discord Donate

Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to "Star" or donate.

Click here to review more of my plugins.

Info

This dynamic platform plugin allows control of Mercedes Me capable cars. At the moment it is only possible to get information like vehicle status, lock status, fuel status etc. If in the future the possibility of e.g. locking or unlocking the car becomes possible, this will also be implemented.

Any system capable of running Homebridge can be used to run homebridge-mercedesme. The only need is Mercedes Me capable car.

Installation instructions

After Homebridge has been installed:

sudo npm install -g homebridge-mercedesme@latest

First steps (obtain Client ID and Client Secret)

In order to use this plugin, you must first log in with your Mercedes Me account on Mercedes Developer. After logging in go to Console and press on Add new app if you dont have already an existing app for this plugin.

Enter Application Name (e.g. Homebridge) Business Purposes (e.g. homebridge-mercedesme) and press Create

Now we need to add the API endpoints to our App.

  1. Visit Vehicle Status API and press Get access.
  2. Choose Bring your own car and press Next
  3. Choose Standard and press Next
  4. Choose your existing app and press Next
  5. On Edit Application leave everything as it is and press Submit

Congratulation. Now you have added the Vehicle Status endpoint to your app. You need also to add Lock Status endpoint, Pay as your drive endpoint, Electric Vehicle Status endpoint and Fuel status endpoint to your app by following the above steps.

Requested endpoints:

Once you have added all the API endpoints to your application, visit Console again. You should see your Client ID, Client Secret and Redirect Url.

Important

Add your Config UI X ip address with port as your Redirect Url (eg http://192.168.178.11:8080). If you have multiple ip addresses to your config ui x, please add them all as redirect uri !

Copy your Client ID and Client Secret and put it in your config.json (Config UI > Plugins > Homebridge Mercedesme Settings > Client ID/Client Secret)

First start

The Version 2 is completely new designed. It supports Config UI X Plugin UI Utils and is full integrated in your homebridge system via Config UI X. The custom config will guide you through the process! Generating or refreshing access token was never easier! Below you can see how easy it is to create, edit or delete a new car for the config.json using the custom user interface. To use the custom user interface you need at least homebridge-config-ui-x v4.34.0!

Configuration

Please setup your config in Config UI X under Plugins > Homebridge Mercedes Me > Settings.

Example config.json:

{
  "bridge": {
      ...
  },
  "platforms": [
    {
      "platform": "MercedesPlatform",
      "debug": false,
      "cars": [
        {
          "name": "Mercedes A200",
          "clientID": "1b851746-2x58-7y8r-6548-12ft58w159zu",
          "clientSecret": "d896ct55-c85c-6363-9999-25iu6985mo10",
          "vin": "WDD1234567N123456",
          "model": "Mercedes A200",
          "manufacturer": "Mercedes",
          "maxRange": 800,
          "polling": 60,
          "tankBatteryType": "LIGHTBULB"
        },
        {
          "name": "Mercedes CLA250",
          "clientID": "1b851746-2x58-7y8r-6548-12ft58w159zu",
          "clientSecret": "d896ct55-c85c-6363-9999-25iu6985mo10",
          "vin": "WDD1234567N123456",
          "model": "Mercedes B180",
          "manufacturer": "Mercedes",
          "maxRange": 600,
          "polling": 120,
          "electricVehicle": true,
          "tankBatteryType": "HUMIDITY"
        },
        {
          "name": "Mercedes B200",
          "clientID": "1b851746-2x58-7y8r-6548-12ft58w159zu",
          "clientSecret": "d896ct55-c85c-6363-9999-25iu6985mo10",
          "vin": "WDD1234567N123456",
          "model": "Mercedes B180",
          "manufacturer": "Mercedes",
          "maxRange": 600,
          "polling": 120,
          "hybridVehicle": true,
          "tankBatteryType": "HUMIDITY"
        }
      ]
    }
  ]
}

See Example Config for more details.

Settings

  • platform - required : Must be 'MercedesPlatform'
  • cars.name - required : Name of the Accessory (unique)
  • cars.clientID - required : Client ID obtained from https://developer.mercedes-benz.com
  • cars.clientSecret - required : Client Secret obtained from https://developer.mercedes-benz.com
  • cars.vin - required : Vehicle Identification Number (VIN)
  • cars.manufacturer - not required : Car Manufacturer
  • cars.model - not required : Model of the car (Default: Mercedes)
  • cars.maxRange - not required : Maximum distance after full tank load (for calculating range in % for battery state if API doesnt send the percentage)
  • cars.polling - not required : Time in seconds for polling Mercedes API (Default: 60s)
  • cars.electricVehicle - not required : Enable if your car is a electric vehicle (Default: false)
  • cars.hybridVehicle - not required : Enable if your car is a hybrid vehicle (Default: false)
  • cars.tankBatteryType - not required : Choose between several accessory types (HUMIDITY | LIGHTBULB) to show the remaining tank load and/or electric vehicle battery value in percent

Supported clients

This plugin has been verified to work with the following apps on iOS 14:

  • Apple Home
  • All 3rd party apps like Elgato Eve etc.
  • Homebridge >= v1.1.6

TODO

  • [ ] If it should be possible to control the doors in the future > Changing Door (Contact Service) to Door Service
  • [ ] If it should be possible to control the windows in the future > Changing Window (Contact Service) to Window Service

Troubleshooting

If you have any issues with the plugin, you can enable the debug mode, which will provide some additional information. This might be useful for debugging issues. Open your config.json and set "debug": true

Token Issues

If you experiencing issues with your generated token, you can easily refresh it via Config UI X. Below you can see how to do it.

Changelog

See the changelog for changes between versions of this package.

Contributing

You can contribute to this homebridge plugin in following ways:

  • Report issues and help verify fixes as they are checked in.
  • Review the source code changes.
  • Contribute bug fixes.
  • Contribute changes to extend the capabilities
  • Pull requests are accepted.

Disclaimer

All product and company names are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.