Erste Schritte

Info-Videos

www.youtube.com/@shining-man
Bitte beachten: Aufgrund der Weiterentwicklung des BSC, ist nicht mehr alles im Video aktuell!
Das im Video erwähnte "neue WebUi" steht aktuell nicht zur Verfügung. Auch nicht für Sponsoren!

Weiterführende Informationen

Für erste Informationen und die Inbetriebnahme zuerst folgende weitere Kapitel lesen:
Hardware
Konfiguration des BSC

Wer die BSC Software ohne orginale Hardware testen möchte, sollte das Kapitel Test ohne orig. Hardware lesen.

Hochrüstungen oder häufige Probleme sind im Kapitel Troubleshooting beschrieben.

Installation der Firmware

Flashen einer Platine von Lilygo

Der derzeitige Platinen-Lieferant versendet diese mit einer speziellen Firmware, die beim Kunden auf die aktuelle Release gebracht werden muss.
Laden Sie dazu zuerst das aktuelle Release (bsc_firmware.zip) von hier herunter um dieses zu entpacken. Nun findet man eine Datei namens "firmware.bin", die die zu flashende Firmware repräsentiert.

Das Upgraden der Firmware geschieht wie folgt:

1. Beim ersten Start der Firmware stellt der BSC einen WLAN-Accesspoint mit dem Namen "ESP-*" (ohne WLAN-Passphrase) zur Verfügung. Mit diesem WLAN bitte nun verbinden.
2. Nun die Webadresse "http://192.168.4.1/update" aufrufen. Achte Sie dabei auf die genaue Eingabe der URL.
   Falls ein Smartphone verwendet wird, könnte es sein, dass die Webadresse nicht aufgelöst werden kann. Wenn es zu diesem Problem kommen sollte, bitte die mobilen Daten des Smartphones für den Prozess ausschalten.
3. Laden Sie die zuvor entpackte Datei "firmware.bin" nun hoch. Weitere Dateien, wie z.B. das Dateisystem, werden nicht benötigt.
4. Nun dauert es ein paar Sekunden, bis das Gerät neu gestartet hat.
5. War der Prozess erfolgreich, blinkt eine LED auf der Platine. Sie können Sich nun wie hier beschrieben mit dem BSC verbinden um Ihre Konfigurationen vorzunehmen.

Flashen einer unprogrammierten Platine

• Für die Erstinbetriebnahme einer unprogrammierten Platine müssen die vier herunterladbaren Dateien manuell geflasht werden.
  Die aktuellen Releases findet man hier.
  Bei der BSC-Hardware muss hierzu auf der dreipoligen Stiftleiste J2 (links oben auf dem Board; mit "Prog" beschriftet) ein USB-Seriell Konverter mit 3,3V-Pegel angeschlossen werden.
  Ein 5V-Konverter kann den Controller schädigen.
  

Bei den ESP32-Dev-Boards ist meistens direkt ein USB-Port vorhanden. Spätere Updates können über die Weboberfläche gemacht werden.

• Vor dem Flashen der Firmware muss das Board in den Download-Modus versetzt werden. Hierzu die Spannungsversorgung trennnen, dem Jumper J4 stecken und die Spannungsversorgung wieder einschalten. Nach erfolgreichem Flashen muss der Jumper J4 wieder entfernt werden, damit das Board normal anläuft.
• PCB Version >= V2.3: Der Jumper J6 darf während des Flashens nicht gesteckt werden, muss aber anschließend wieder gesteckt werden.
• Als Baudrate können Sie 921600baud verwenden. Wenn dies zu Problemen führt, kann diese auch auf 230400baud herab gesetzt werden
• Bitte löschen Sie den aktuellen Speicher des Moduls vor der Programmierung mit Hilfe der folgenden Tools.

Flash-Möglichkeiten

Nutzen des Hersteller-Download-Tools (only Windows)

• Die Software zum Flashen (Flash Download Tools) kann von der Hersteller-Webseite des ESP32 bezogen werden.
  Link: https://www.espressif.com/en/support/download/other-tools
• Die Einstellungen in dem Download-Tool wie in den folgenden Screenshot zu sehen vornehmen:
  
  
• Den Upload-Vorgang mit einem Klick auf "Start" starten

Flashen mit dem esptool (Linux, Windows) inkl. zuvorigen Löschen

esptool.py --port /dev/ttyUSB0 --chip auto write_flash -e -ff 80m -fm dio 0x01000 bootloader.bin 0x08000 partitions.bin 0x0e000 boot_app0.bin 0x10000 firmware.bin

Flashen über den Browser

Bei Verwendung eines Chrome Browsers kann auch das durch Adafruit zu Verfügung gestelltes Online-Tool zum Flashen verwendet werden.

Nach erfolgreicher Verbindung zu dem Controller können die 4 Dateien der aktuellen Firmware mit den passenden Zieladressen geflashed werden:

• bootloader.bin - 0x1000
• partitions.bin - 0x8000
• boot_app0.bin - 0xe000
• firmware.bin - 0x10000

Beta-Versionen flashen

Für das Flashen von Beta-Versionen gibt es zwei Möglichkeiten:

1. Sie können das einzelne Beta-Firmware-File "firmware.bin" direkt über den Web-Browser und der OTA-Funktionalität innerhalb des BSC-Webfrontend flashen.
   Diese finden Sie im Menü /Einstellungen/Update.
2. Andernfalls können Sie die jeweilige "firmware.bin" zusammen mit den drei weiteren Dateien aus dem Release hierzu verwenden.
   Das weiter oben beschriebene Gesamt-Flash-Prozedere bleibt hierbei unverändert.

Verbinden mit dem BSC

Voraussetzung ist, dass die Platine programmiert ist!

• Beim ersten Start der Firmware stellt der BSC einen Accesspoint mit dem Namen "bsc_*" zur Verfügung.
• Nach dem Verbinden mit dem Accesspoint ist dieser unter der IP-Adresse 192.168.4.1 oder bsc.info erreichbar und kann konfiguriert werden.
• Zugangsdaten:
  • Benutzername: bsc
  • Passwort: admin