Firmware
Firmware ist die Bezeichnung für Software, die auf eingebetteten Systemen wie dem ESP32 und anderen Mikroprozessoren läuft, und dort für die Funktionalität der Hardware verantwortlich ist. Beim OpenBikeSensor ist dies also ein Programm das wir selbst schreiben, mit dem der ESP32 bespielt wird, und das sich um die Aufzeichnung der zu messenden Daten, die Anzeige im Display und die ganze Konfigurationsoberfläche kümmert.
Die Firmware wird, wie alle Softwareteile, unter Open-Source-Lizenz auf GitHub entwickelt: openbikesensor/OpenBikeSensorFirmware. Für die Weiterentwicklung sind alle eingeladen, die sich für Mikroprozessorprogrammierung interessieren.
Featurewünsche oder Fehlerberichte sammeln wir im Issue Tracker auf GitHub.
Installation / Flashen
Ein etwas komplizierter Schritt beim Aufbau des Sensors, den alle Bastler:innen mindestens einmal mit ihrem neuen Gerät durchlaufen müssen, ist die initiale Installation der Firmware auf dem ESP32. Dies wird auch als “Flashen” (engl. to flash) bezeichnet.
Hierfür muss das Mikroprozessor-Board aus dem OpenBikeSensor ausgebaut und mit einem USB-Kabel an einen Computer angeschlossen werden. Die Anleitungen für das Übertragen der Firmware auf den Mikroprozessor unterscheidet sich stark nach Betriebssystem des Computers, daher haben wir sie hier getrennt aufgeführt:
Versionsupgrade
Eine neue Version der Firmware kann direkt über die Bedienoberfläche eingespielt werden. Hierfür gibt es entsprechende Menüpunkte im Hauptmenü. Ein Auseinanderbauen des Geräts und der Anschluss an einen Computer sind dafür nicht mehr nötig.
GGF musst du zunächst das “Flashtool” (über die OpenBikeSensor Oberfläche) installieren. Danach kannst du, wenn dein OpenBikeSensor in einem internetfähigen WLAN eingebucht ist über das Wlan-Menü deines OpenBikeSensors Firmwareupdates anstoßen.
Firmware aus Quelltext kompilieren
Du kannst die Firmware auch selbst bauen und flashen, wenn du dir den Quelltext aus dem GitHub-Repository herunterlädst.
Zunächst musst du VS Code und darin die
Erweiterung PlatformIO installieren. Clone dann den
gewünschten Stand der OBS-Firmware aus dem
github-Repository
und öffne das Verzeichnis in VS Code. Dann kannst du mit dem Upload-Befehl
(Pfeil nach rechts in der Fußzeile von VS Code) oder per pio run -t upload in
der PlatformIO CLI die Firmware kompilieren und auf den ESP32 flashen.
Flashen mit platformio
Hast du git und python3 installiert, sowie im Fall von Windows ggf den Treiber, kannst du mit folgenden Kommandos die OpenBikeSensor Firmware bauen und flashen. Vorbereiten des Firmwareverzeichnisses: # Git-Repo klonen git clone https://github.com/openbikesensor/OpenBikeSensorFirmware.git cd OpenBikeSensorFirmware # Platformio in einem virtuellen Python Environment installieren python3 -m venv venv # unter macos und linux: venv/bin/pip install platformio # oder unter windows: venv\scripts\pip install platformio Flashen Nun kannst du den ESP (nicht den OpenBikeSensor) per USB-Kabel mit deinem Rechner verbinden und mit folgendem Kommando die Firmware flashen (je nach Systemkonfiguration benötigst du dafür root-rechte).
Flashen unter Linux
Alternative 1: Installation via Browser Der einfachste Weg, deinen OpenBikeSensor zu flashen, ist den Web-Installer in Google Chrome oder Chromium zu öffnen und der Schritt-Für-Schritt Anleitung dort zu folgen. Funktioniert das für dich nicht, probiere eine der Alternativen. Alternative 2: In der Allgemeinen Installationsanleitung wird der betriebssystemunabhängige Weg über Visual Studio Code und Platformio geschildert. Alternative 3: Installation mit esptool Vorbereitung Lade das neueste Release-Archiv der OBS-Firmware von GitHub herunter.
Flashen unter Windows
Installation via Browser Der einfachste Weg, deinen OpenBikeSensor zu flashen, ist den Web-Installer in Google chrome zu öffnen und der Schritt-Für-Schritt anleitung dort zu folgen. Funktioniert das für dich nicht, folge den Schritten unten. Firmware herunterladen Lade das neueste Release-Archiv der OBS-Firmware von GitHub herunter. Du benötigst die größere ZIP-Datei mit dem Namen obs-v9.9.9.9999-initial-flash.zip. Entpacke die Dateien in einen temporären Ordner, sie heißen 0x??????.bin. Die Zahlen sind die Basisadresse, an die die Daten geflasht werden sollen.
Flashen unter macOS
Installation via Browser Der einfachste Weg, deinen OpenBikeSensor zu flashen, ist den Web-Installer in Google Chrome zu öffnen und der Schritt-Für-Schritt anleitung dort zu folgen. Funktioniert das für dich nicht, folge den Schritten unten. Vorbereitung Lade das neueste Release-Archiv der OBS-Firmware von GitHub herunter. Du benötigst die größere ZIP-Datei mit dem Namen obs-v9.9.9.9999-initial-flash.zip. Entpacke die Dateien in einen temporären Ordner, sie heißen 0x??????.bin. Die Zahlen sind die Basisadresse, an die die Daten geflasht werden sollen.