Änderungen
Aus Hackerspace Ffm
/* Anleitungen für den Aufbau */
* CR123A 3V Zelle und Halter zur Versorgung
== Anleitungen für den Aufbau mit Laufkarte ==Besucher kaufen ein Badge und erhalten die Roh-PCB, beim Speaker-Add-On einen Speaker sowie eine Laufkarte:
== Software / Funktionen ==
*** Serieller Port für Logs (aber vermutlich nicht so stabil)
*** Video-Grabber: Displayinhalt könnte als "Webcam" gezeigt werden (sehr experimentel derzeit)
== Feature Wünsche / Ideen ==
* Volle CircuitPython Unterstützung und Integration in die CircuitPython-Bibliothek (Basis für ein Teil mit OLED könnte [https://github.com/adafruit/circuitpython/tree/main/ports/espressif/boards/heltec_esp32s3_wifi_lora_v3 das] sein)
* Arduboy Spiele portieren
* Benachbarte Badge finden
* Uhrzeit beim Start Syncen und dann Uhrzeit anzeigen
== Konzept der Software und HackFFMBadge Bibliothek ==
** Alle Pinne werden automatisch zugeordnet - es muss aber ein OLED-Display richtig angeschlossen werden, denn daran richtet sich die Hardware-Erkennung
** Nicht so zuverlässig wird das schwarze "ESP32-S3 Super Mini" Modul vom blauen "ESP32-S3-Zero" Modul unterschieden allein auf Grund eines Spannungsteilers an GPIO3 (weshalb dort Touch nicht geht...)
* OLED Funktionen:
** Es steht ein "u8g2" zur Verfügung
** Displayauswahl derzeit über einen Eintrag in der platformio.ini
** Initialisierung des Displays, Logoanzeige beim Start
* Face Objekt:
** Ein fertig eingerichtetes Face-Objekt steht als Objekt-Member zur Verfügung, Zugriff über
** Der Aufruf von Badge.face().Draw(); bringt das aktuelle Face aufs Display - und sonst nichts.
** Der Aufruf von Badge.face().UpdateBuffer(); zeichnet das aktuelle Face in den u8g2-Buffer, der aber vorher mit u8g2.clearBuffer(); manuel gelöscht werden muss und danach manuel mit u8g2.sendBuffer(); aufs Display gebracht werden muss. Hiermit können noch Veränderungen vorgenommen werden, bevor das Face gemalt wird...
* Door Funktionen:
** Die Bibliothek erstellt einen zufälligen ED25519 Private key zur Signierung der Tür-Kommandos, sofern noch kein Key vorhanden ist.
** Mit dem Kommandobefehl pXX.64HEXDIGITS..XX kann ein anderer private Key hinterlegt werden
** Es gibt dann einige Funktionen in der Lib um die Tür zu finden und ggf zu öffnen/zu schliessen.
== FAQ / Probleme ==
* F: Die LED auf dem MCU Board blinkt rot-blau beim Einschalten A: Das OLED wurde nicht gefunden und die restliche Hardware kann damit nicht initialisiert werden. Kontrolliere das OLED bzw. die Verbindungen dazu.
* F: OLED geht nicht/wird heiß/Pin-Belegung ist nicht VDD an Pin1. A: VDD muss Pin 1 sein, falls nicht gibt es aber bei einigen Displays auf der Rückseite 0-Ohm Jumper, die umgesetzt werden können, um VDD und GND zu tauschen.
* F: Kann ich CircuitPython nutzen? A: Noch gibt es keine Variante genau für das Badge. Am nächsten ist das [https://circuitpython.org/board/waveshare_esp32_s3_zero/ Waveshare ESP32 S3 Zero] oder das [https://circuitpython.org/board/adafruit_feather_esp32s3_4mbflash_2mbpsram/ Feather ESP32-S3 4MB Flash 2MB PSRAM] - das CircuitPython lief bei mir bereits auf dem MCU-Board des Badge. Ist dann aber Handarbeit (Power-Hold-Leitung, Display, Touch, Audio etc richtig bedienen per Python).
== PlatformIO ==
*Upload FS
platformio run --target uploadfs --environment esp32s3
== Optional: Aufbau in der Vollversion ==
=== Stationen für Vollversion incl. SMD Löten, ca. 90 Minuten ===
Damit mehrere Badges parallel aufgebaut werden können sind die Bauschritte auf [[Hackerspace-FFM Badge - Stationen|Stationen]] verteilt:
* '''REFLOW-LÖTEN''': [[Datei:Hackerspace-FFM Badge - REFLOW-LÖTEN.pdf]]
* '''HANDLÖTEN''': [[Datei:Hackerspace-FFM Badge - HANDLÖTEN.pdf]] (Update)
* '''PROGRAMMIEREN''': [[Datei:Hackerspace-FFM_Badge_-_PROGRAMMIEREN.pdf]]
* '''MECHANIK''': [[Datei:Hackerspace-FFM_Badge_-_MECHANIK.pdf]] (Update)
=== Laufkarte ===
Besucher kaufen ein Badge und erhalten die Roh-PCB, beim Speaker-Add-On einen Speaker sowie eine Laufkarte:
* KID (ohne AUDIO): [[Datei:Laufkarte_KID_4_x_A6.odg]]
* AUDIO: [[Datei:Laufkarte AUDIO - 4 x A6.odg]]
[[Image:Laufkarte_AUDIO_-_A6.png|320px]]
# Reflow-Löten: Lotpaste wird aufgetragen, SMDs werden bestückt (bei Speaker-Add-On auch die Teile des Speaker-Bereichs), gelötet wird im Reflow-Ofen oder auf der heißen Platte
# Handlöten: Display-Connector, ESP-Modul, Neopixel, CR123 Halter, ggf. PCB-Patches, ggf. Speaker-Buchse werden per Hand gelötet
# Mechanischer Aufbau: Display einschrauben, PCB montieren, Neopixel platzieren, Halsband anbringen, ggf. Speaker montieren
# Programmieren: Grundprogram wird per USB-C eingespielt, Funktionen werden kontrolliert: Display, Neopixel, ggf. Speaker
# Testen: Batterie wird eingelegt: Test das Ein-Taster funktioniert und Touch Funktioniert
# Personalisieren: Name wird hinterlegt, Benutzergrafik (mit Name) kann erstellt und übertragen werden
