hame_victron-bridge

Display your MercedesME data on VenusOS
Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
2. Getting Started
   • Prerequisites
   • Installation
3. Contributing
4. License
5. Contact
6. Acknowledgments

About The Project

I own a campervan with a built in Victron Energy system, including a Touch Display for the Venus OS. In the future I plan to replace my Truma Combi 4 with a Truma Combi D 6 E. As I would like to stay remote for several days in a row, i would like to have the Diesel Level of my Mercedes Sprinter VS30 (W910 but this also applies to the W907) directly on my Venus OS Touch Display.

Getting Started

You can feed more data to your Victron than i do. But for Adblue and Diesel, just follow this guide.

• It works with Venus GUIv2!
• THIS REPLACES THE HOMEASSISTANT MQTT BROKER WITH THE VENUS OS!
  • If you have many MQTT devices, it could eventually cause performance issues on the VENUS OS

Prerequisites

This setup requires the following things.

• Car
  • Mercedes ME compatible car
  • Mercedes ME account
• Home Assistant
  • HomeAssistant instance
  • HACS
  • https://github.com/ReneNulschDE/mbapi2020
  • FileEditor or VSC addon
  • Mosquitto broker addon (MQTT Broker)
• Victron
  • Cerbo or RPi with VenusOS
  • https://github.com/freakent/dbus-mqtt-devices
  • MQTT Enabled

Installation

1. Venus OS (v3.50+)
   1. install https://github.com/freakent/dbus-mqtt-devices
   2. enable MQTT (Settings -> services -> MQTT Access)
2. Home Assistant
   1. install HACS
   2. install https://github.com/ReneNulschDE/mbapi2020
   3. install and setup Mosquitto broker addon (to be checked if even requried)
   4. setup MQTT integration
      1. Broker: venus.local or IP of VenusOS
      2. Port: 1883
      3. Username: empty
      4. Password: empty
   5. edit script.py
      1. check "mqtt_host" and "mqtt_port"
      2. replace all "tbd" with actual sensor
         1. change "sensor.tbd_fuel_level" to actual MercedesME sensor name
         2. change "sensor.tbd_adblue_level" to actual MercedesME sensor name

Success, that was all required to get your data transmitted from your Mercedes to any Victron Venus installation!

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Top contributors:

(back to top)

License

Distributed under the Unlicense License. See LICENSE.txt for more information.

(back to top)

Contact

Project Link: https://github.com/CzarofAK/hame_victron-bridge

(back to top)

Acknowledgments

Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!

• Home Assistant - Mercedes ME integration
• MQTT VenusOS - bridge
• Readme Template

(back to top)