m4gnv5 / docgreenesa5000-dashboard

e-Scooter protocol reversing, custom dashboard and tuning chip for the Doc Green scooters sold by e.g. Lidl

DocGreenESA5000-Dashboard

This repository contains some utilities and selfmade documentation of the DocGreen ESA 5000 sold by Lidl. Lidl also sold the Explorer ESA 1919, which is identical protocol wise, but the front light is connected to the dashboard instead of the motor controller. The scooter is similar to the Xiaomi M365 however there are some differences:

• the lights are mounted elsewhere
• the light does not change when braking
• it has no connecivity (no bluetooth, no proprietary app, no activation)
• it has a "Zulassung nach eKFV" making it legal to drive on german roads when equipped with an insurance license plate
• the internal communication uses the same scheme, but the addresses and contents are different.

In this repository

• docgreen-protocol: a list of bus messages and the meaning of some of the bytes
• MegaSniffer: a small arduino program to sniff the internal bus using an Arduino Mega
• TinyTuning: ATtiny45/85 program for tuning ESA Scooters (bus read and write)
• TinyTuningButton: ATtiny45/85 program for tuning ESA Scooters (bus write-only variant)
• DocGreenDisplay: a replacement for the stock head unit using an Arduino Nano or ESP32 and a 128x32 OLED display.

TinyTuning(Button)

A small PCB with an ATTiny45 which is connected between dashboard and ECU allowing to set the max speed.

Dashboard PCB

The initial solution was a perfboard + Arduino Nano + diode & resistor solution using this circuit. It worked well, but was too large to fit into the dashboard place. Thus, after using a duct tape solution for a few months i decided to create a custom PCB with the same size as the original dashboard.

On https://jakobloew.me/scooter one can find the manual for the dashboard, with a detailed description of all features and functionality.

Further Reading

Other ESA 5000/1919 Projects

• https://github.com/Bert-Tec/xbot_display
• https://github.com/ands/EsaBusModule
• https://github.com/mxbode/ESA5000SetSpeedButton
• https://github.com/crexodon/ESA5000_Dashboard

Projects for other Scooters

• https://github.com/augisbud/m365_dashboard
• https://github.com/etransport/ninebot-docs/wiki/protocol M365 protocol documentation.
• https://github.com/camcamfresh/Xiaomi-M365-BLE-Controller-Replacement
• https://scooterhacking.org/

Pictures

Photos of Prototypes & Development

LICENSE

This project is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This project is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this project. If not, see https://www.gnu.org/licenses/.

docgreenesa5000-dashboard's Issues

Which connector are they using for the dashboard to connect to the scooter?

Hi,
does anyone know what the name of the 4-pin connector is, that is used to connect the dashboard to the motor-controller in the steering column?
Its not a JST PH
But it is also 2.0mm and 4 pin.

DocGreenESA5000 Bluetooth Protocol

Do you have any work for original bluetooth protocol or do you plan to ad bluetooth for using with same morobot app?

missing file "webinterface/bundle.hpp"

Hello M4GNV5, I cannot find bundle.hpp file. I want to try this codes for my scooter. And moreover, can you share arduino version bcs i dont want to use bluetooth and wifi and esp32 devkitc too big for dashboard place

Latest PCB Design

Hi,

I just get this scooter and I love your dashboard project. Is the latest pcb design available?
Can you send a link to it?
Thank you and congrats!

Controlling the dashboard buzzer

Do you think it is possible to make use of the dashboards buzzer?
I think the controller is doing that, when the immobilizer / lock mode is enabled.

ESA 5000 Protocol: any other commands discovered?

Hi, just asking: are there any other commands available? Some in this repo are labeled "unsure": were any other commands/data_field discovered afterwards?

I'd be interested in the Temperature (if any) - and what about the current (A), I see that field in 2 commands, which one should be used?

Tnx!

Intensity of electric brake system

Hey,

nice work on your dashboard and all the reverse engineering!

I don't know how relevant my question is to your project but I was wondering if you think that it would be possible to somehow adjust the electric brake intensity in firmware? My experience with the scooter so far is that the brake is really sudden as if the brake potentiometer is just binary (even though in your protocol documentation it says that the brake lever ranges from 2C to B5). Do you have the same experience or is it just me (I have the ESA 1919, but as far as I can tell the differences are just appearance).

Greetings

Schematics, wiring diagram or better documentation

Hello Jakob, incredible work you did here 👍 I would love to build this display for me and maybe also to contribute and participate on the development. Would you be so kind and improve your documentation, so it includes detailed schematics or wiring diagram and also part listing (arduino board type, LCD module ... )

Name of the connectors

Hello and thank you for sharing your work.

Can you tell us what is the exact name of the used connectors at the TinyTuning(Button)?