Open Battery Information

Het is zeer gebruikelijk dat fabrikanten het BMS (Battery Management System) vergrendelen wanneer er een fout wordt gedetecteerd, om zo het apparaat en de gebruiker te beschermen. Dit is een zeer belangrijke functie.

Het wordt echter een probleem wanneer deze beveiliging onterecht wordt geactiveerd, of wanneer een fout tijdelijk was of inmiddels is gerepareerd. In dergelijke gevallen zou het zonde zijn om een perfect functionerend BMS weg te gooien, enkel omdat de software aangeeft dat er een fout is. Dit is het probleem dat dit project probeert op te lossen.

Belangrijke mededeling

De desktopapplicatie is verouderd.

De oude desktopapplicatie (Python/Tkinter) is verwijderd uit deze repository en wordt niet langer ondersteund. De laatste versie van de Python-applicatie is nog te vinden onder de v0.2.3 tag. Deze is vervangen door een nieuwe webgebaseerde gebruikersinterface die direct in de browser draait:

De web-UI maakt via Web Serial verbinding met de Arduino en kan de firmware zelfs direct vanuit de browser flashen, waardoor de installatie van Python niet langer nodig is. Deze repository host nu uitsluitend de Arduino-firmware (zie de map ArduinoOBI/).

Contactinformatie

Voor vragen kun je een e-mail sturen naar: openbatteryinformation@gmail.com

Ondersteuning

Er is veel tijd in dit project gestoken en alle informatie is nu openbaar gemaakt in de hoop dat anderen hiermee batterijen en geld kunnen besparen. Indien je waardering wilt tonen voor dit werk, kun je overwegen om via een "coffee" of via GitHub Sponsor bij te dragen.

---

Instructies

Stap 1: ArduinoOBI instellen

  1. Navigeer naar de map ArduinoOBI in de projectdirectory.
  2. Volg de instructies in de bijbehorende README.md. In dit gedeelte wordt uitgelegd hoe je de firmware bouwt en flasht naar je Arduino Uno (of ESP32-C3), zodat alles correct is ingesteld.

Stap 2: De firmware flashen

Er zijn twee opties om de firmware op je board te zetten:

Optie 1: Flashen via de browser (Aanbevolen) Hiervoor is geen toolchain vereist. Open de firmware-uploader in Chrome of Edge, verbind je board via USB en flash de firmware direct vanuit je browser.

Optie 2: Bouwen en flashen met PlatformIO

  1. Installeer VS Code en de PlatformIO-extensie.
  2. Open de map ArduinoOBI als project in VS Code.
  3. Bouw en upload de firmware voor jouw board volgens de stappen in ArduinoOBI/README.md.

Let op: Vooraf gebouwde firmware-binaries (uno.hex / esp32.bin) zijn ook beschikbaar op de Releases-pagina van deze repository.

Stap 3: De OBI-1 tool gebruiken

Zodra de firmware op je board draait:

  1. Open de OBI-1 webtool in Chrome of Edge.
  2. Maak verbinding met de seriële poort van je Arduino (of ESP32-C3).
  3. Plaats een batterij en druk op Read battery om het model, de celspanningen, temperaturen, het aantal laadcycli en de status uit te lezen.