StickBridge 1.6.0 – ESP32-S3-LCD-1.47 Der Stick verbindet eine FAT32-Speicherkarte mit zwei Zugängen: Die Maschine liest über USB; iPad und Windows lesen und schreiben über WLAN. Die Freigabe heißt SD. Benutzername: stick. Gerätepasswort: am Display. Die Weboberfläche bedienen Dateien: Ordner öffnen, über die Pfadleiste zurückgehen, Dateien herunterladen, neue Ordner anlegen und Dateien löschen. „Dateien hochladen“ öffnet die Dateiauswahl und überträgt die ausgewählten Dateien in den aktuellen Ordner. Netzlaufwerk: iPad oder Windows wählen. Dort stehen die passende Adresse, Schritte zum Verbinden und die Zugangsdaten. Das Gerätepasswort ist zunächst verdeckt und lässt sich über „Passwort anzeigen“ einblenden. WLAN: verfügbare Netzwerke suchen und den Stick verbinden. Weitere Optionen zum Einrichtungs-WLAN und Zurücksetzen sind separat aufklappbar. Gerät: Verbindung prüfen, Hilfe lesen und Software aktualisieren. Die vier Bereiche passen sich an kleine Bildschirme an. Benötigt werden keine externen Schriftarten, Bilder, Dienste oder Internetverbindung. WLAN einrichten Ohne gespeicherten WLAN-Zugang startet der Stick sein eigenes WLAN sofort. Name und Passwort stehen auf dem Display. Mit diesem WLAN verbinden und http://192.168.4.1 öffnen. Mit stick und dem Gerätepasswort anmelden. Unter „WLAN“ nach WLANs suchen, das 2,4-GHz-Netz auswählen, dessen Passwort eingeben und speichern. Sobald die Heimnetz-Verbindung steht, schaltet sich das eigene WLAN aus. Danach ist die Oberfläche unter http://stickbridge.local erreichbar. Falls der Name im Netzwerk nicht aufgelöst wird, die IP vom Display verwenden. Aktuelle Adresse: im Display ablesen; die IP wird vom Router vergeben. Ist ein Heimnetz gespeichert, wird beim Start zunächst nur dieses gesucht. Nach 20 Sekunden ohne Verbindung startet das eigene WLAN als Rückfall. Das gilt auch, wenn die Heimnetz-Verbindung später abbricht. Das Heimnetz wird weiterhin gesucht. Bei Erfolg geht das eigene WLAN aus. Am iPad verbinden 1. Das iPad mit demselben erreichbaren Netzwerk verbinden wie den Stick. 2. Dateien öffnen. In der Seitenleiste „Durchsuchen“ beziehungsweise die Seitenleistentaste wählen, dann … → Mit Server verbinden. 3. Server: smb://stickbridge.local/SD Alternativ: smb://192.168.1.42/SD – aktuelle IP vom Display verwenden. 4. „Registrierter Benutzer“ wählen. Benutzername: stick. 5. Gerätepasswort vom Display eingeben und verbinden. 6. Falls zuerst der Server erscheint, dessen Freigabe SD öffnen. Diese zusätzliche Freigabeauswahl steuert die Dateien-App. Nach einem Update oder bei einer alten, festhängenden Verbindung zuerst das Auswerfen-Symbol neben dem Server antippen und dann neu verbinden. Unter Windows verbinden 1. Windows + E drücken. Das öffnet den Explorer. 2. In die Adresszeile oben klicken, nicht in das Suchfeld. 3. Für direkten Zugriff eingeben: \\stickbridge.local\SD Alternativ: \\192.168.1.42\SD – aktuelle IP vom Display verwenden. Nur \\192.168.1.42 zeigt zunächst den Server mit der Freigabe SD. 4. Falls erforderlich „Weitere Optionen → Anderes Konto verwenden“ wählen. Benutzername: stick. Passwort: das Gerätepasswort vom Display. Unter Windows wird kein smb:// vor den Pfad gesetzt. Als dauerhaftes Windows-Laufwerk Im Explorer „Dieser PC“ auswählen, dann … → Netzlaufwerk verbinden/zuordnen. Alternativ „Dieser PC“ rechts anklicken und den Menüpunkt wählen. Unter Windows 10 findet sich die Funktion auch im Reiter „Computer“. Einen freien Laufwerksbuchstaben wählen und als Ordner \\stickbridge.local\SD eintragen. „Bei Anmeldung erneut verbinden“ nach Bedarf aktivieren, „Verbindung mit anderen Anmeldeinformationen herstellen“ wählen und mit stick sowie dem Gerätepasswort anmelden. Der Stick muss eingeschaltet sein. Namen funktionieren nur, wenn das Netzwerk die Namensauflösung zulässt; der IP-Pfad bleibt als Alternative. Bedienung am eingeschalteten Stick BOOT kurz drücken und loslassen: Übersicht → Windows-Adresse → iPad-Adresse → QR-Code zur Weboberfläche. Nach 30 Sekunden kehrt die Übersicht automatisch zurück. BOOT mindestens 3 Sekunden halten und loslassen: Einrichtungs-WLAN für 10 Minuten öffnen. Die gespeicherten Heimnetz-Daten bleiben erhalten. BOOT mindestens 10 Sekunden halten und loslassen: nur den gespeicherten WLAN-Zugang löschen und das Einrichtungs-WLAN öffnen. Das Display zeigt vor dem Loslassen, welche Aktion ausgelöst wird. Dateien und Gerätepasswort bleiben bei beiden WLAN-Aktionen erhalten. Nach Speichern/erneutem Verbinden wird ein manuell geöffneter Hotspot bei erfolgreicher Heimnetz-Verbindung wieder abgeschaltet. Die gleichen WLAN-Funktionen stehen unter „WLAN → Weitere WLAN-Optionen“ in der Weboberfläche bereit. Das Zurücksetzen fragt dort noch einmal nach. Anzeige und Hilfe Benutzer und Gerätepasswort stehen in großen, getrennten Feldern. Bei Aktivität zeigt die Übersicht Übertragung, USB-Aktualisierung, USB-Lesezugriff oder eine abgebrochene Übertragung an. Beim Vorbereiten und Übertragen werden Bytes, Prozent bei bekannter Größe und die Übertragungsrate gezeigt. Unbekannte Dateigrößen erhalten keine erfundene Prozentangabe. Browser-Uploads lassen sich abbrechen. Die Hilfeseiten bleiben per BOOT erreichbar. Im Heimnetz wird dessen IP angezeigt, sonst die Adresse des eigenen WLANs. Die Weboberfläche enthält getrennte iPad-/Windows-Anleitungen und Kopiertasten für Adresse, Benutzer und Gerätepasswort. Unter „Gerät → Verbindung prüfen“ siehst du WLAN, tatsächlichen SD-Lesezugriff, laufenden Netzlaufwerk-Dienst, USB-Freigabe und gestartete Namensauflösung getrennt. Der Test vom Stick kann keine WLAN-Isolation oder Namensauflösung auf dem entfernten iPad prüfen. Bei Namensproblemen die angegebene IP verwenden. Dateiübertragung und USB Neue/ersetzte SMB-Dateiinhalte werden zunächst separat zwischengespeichert. Eine erfolgreiche SMB-Dateischließung übernimmt den neuen Inhalt. Bei unerwartetem Verbindungsabbruch wird eine angefangene neue Datei verworfen; beim Ersetzen bleibt der alte Dateiinhalt erhalten. Ein absichtlich geschlossener kurzer/leer angelegter Inhalt ist eine gültige Datei: SMB übermittelt nicht allgemein eine verbindliche Sollgröße. Der Schutz betrifft Dateiinhalt-Übertragungen; Verzeichnisänderungen und Apple-Metadaten sind keine vollständigen, rückgängig machbaren Transaktionen. Für das Ersetzen wird zusätzlicher freier Platz für die neue Datei benötigt. USB liest währenddessen einen stabilen vorherigen Dateistand. Erst wenn keine schreibbare SMB-Datei mehr offen ist und etwa 1,5 Sekunden keine Speicheränderung erfolgte UND mindestens zwei Sekunden keine USB-Leseanfrage ankam, wird der neue Stand veröffentlicht. Mehrere aufeinanderfolgende Dateien können so gemeinsam übernommen werden. Dazu wird USB kurz getrennt und etwa 0,3 Sekunden später neu angemeldet. Eine Lesepause ist kein sicherer Nachweis, dass ein Maschinenauftrag beendet ist. Benötigt die Maschine später weitere Daten, kann auch die verzögerte Neuanmeldung den Auftrag stören. Bei vollem USB-Schutzspeicher muss die USB-Ansicht vor weiteren Schreibzugriffen sofort getrennt werden. Ein Dateidialog an der Maschine muss eventuell erneut geöffnet werden. Die automatische Dateiauswahl-Aktualisierung der Bernette wurde noch nicht am Gerät geprüft. BOOT ist seit 1.4.0 die Anzeige-/WLAN-Taste; zum Aktualisieren ist kein Tastendruck erforderlich. Die Weboberfläche veröffentlicht automatisch. Warum USB nur lesen kann Die Maschine und der Stick verwalten jeweils eigene Ansichten der FAT32-Verzeichnisstruktur. Unabhängiges gleichzeitiges Schreiben beider Seiten könnte Dateien beschädigen. Deshalb schreibt nur der WLAN-Zugang. USB erhält eine geschützte Leseansicht mit 4 MiB Sektorsicherung im PSRAM. Wird deren Speicher knapp, wird USB vor weiterem Schreiben getrennt und erst nach Abschluss neu angemeldet. Ohne Schutzspeicher bleibt USB aus. Verbindungsstabilität Höchstens acht SMB-Verbindungen halten Platz für die Weboberfläche frei. Unangemeldete Verbindungen laufen nach 15 Sekunden ab. TCP-Keepalive erkennt verschwundene Gegenstellen. Geschlossene Verbindungen werden einschließlich ihrer Dateiobjekte aufgeräumt. Beendet sich der SMB-Dienst, wird er nach fünf Sekunden neu gestartet. Bleibt seine Verarbeitung stehen, wird zuerst ein Dienstneustart angefordert; ohne schreibbare Dateiobjekte folgt nach zusätzlicher Schonfrist ein Geräte-Neustart. Ein Neustart unterbricht Verbindungen. Eingeschlafene iPads können bei Bedarf über Auswerfen und erneutes Verbinden wieder angemeldet werden. Speicher und Grenzen Die 32-GB-SD-Karte wurde nicht neu formatiert. FAT32 erlaubt höchstens 4 GiB minus 1 Byte pro Datei. Interne Arbeitsdaten liegen versteckt unter .sb-work, Apple-Datenströme in versteckten .sb-stream-Ordnern. Diese internen Ordner nicht von Hand bearbeiten. Ein Übertragungsjournal hilft beim Aufräumen nach einem Neustart; FAT32 selbst ist kein transaktionssicheres Dateisystem und bietet keinen allgemeinen Schutz vor Stromverlust während eines physischen Schreibens. SMB 3.0.2 verwendet Benutzeranmeldung und Signierung. Keine Gastfreigabe. Dateisperren und Änderungsbenachrichtigungen werden nicht vollständig unterstützt. Für Dateitransfer geeignet, kein allgemeiner NAS-Ersatz. Der beschreibbare schnelle Speicher eines Bambu H2D wird durch diesen USB-Lesemodus nicht ersetzt. USB-Schreibschutz bleibt absichtlich aktiv. Firmware aktualisieren / wiederherstellen Unter „Gerät → Software aktualisieren“ die passende binaries/StickBridge.ino.bin auswählen. Dateien vorher schließen. Das Update erhält SD-Dateien und WLAN-Zugang. Für Kabel-Flash: Build.ps1 und die erzeugten Binärdateien verwenden. BOOT halten, RESET kurz drücken, BOOT loslassen, ROM-Port auswählen. Dieses Paket enthält ausschließlich die StickBridge-Software und ihre Quellen. Build.ps1 prüft Arduino-ESP32 3.3.8; zusätzlich werden die Bibliotheken Adafruit GFX Library und Adafruit ST7735 and ST7789 Library samt ihrer Abhängigkeiten benötigt. Die angepasste SMB-Bibliothek liegt vollständig unter libraries/StickSMB bei, einschließlich LGPL-Lizenz und Quellen. Anleitungsquellen (Menünamen können sich mit Betriebssystemversionen ändern): https://support.apple.com/de-de/guide/ipad/ipad8139864c/ipados https://support.microsoft.com/de-de/windows/experience/connectivity-networking/file-sharing-over-a-network-in-windows Neu in 1.5.0 Die Übersicht zeigt den tatsächlichen WLAN-Namen. iPad und Rechner müssen im selben erreichbaren Netzwerk sein; ein anderes WLAN oder isoliertes Gastnetz kann trotz identischer Serveradresse die Verbindung verhindern. Der QR-Code auf der vierten Displayseite öffnet die lokale Weboberfläche. Er enthält keine Zugangsdaten und richtet kein Netzlaufwerk automatisch ein. SMB-Signaturen verwenden den AES-Beschleuniger des ESP32. Ein Selbsttest prüft bekannte Testvektoren; bei einem Fehler steht die Referenzroutine zur Verfügung. Die Signierung bleibt eingeschaltet. Im gemessenen Windows-Test benötigten 4 MB etwa 11 statt 22 Sekunden; die tatsächliche Geschwindigkeit hängt vom WLAN, der Karte und dem Client ab. Ein Commit-Marker unterscheidet fertig übernommene leere Dateien von neuen, unvollständigen Dateien. Die Startbereinigung sammelt Journalnamen vor dem Löschen und kann mehrere unterbrochene Übertragungen abarbeiten. Vor einem geplanten Neustart wird eine laufende Dateisystem-/SPI-Operation abgewartet. Das ersetzt kein transaktionssicheres Dateisystem und keine Datensicherung. Automatische Update-Suche, Firmware-Signierung und Rollback wurden in dieser Version wie vereinbart nicht ergänzt. Neu in 1.5.5 iPad: Dateigröße bleibt nach dem Kopieren korrekt, ohne Auswerfen. Kompatible Schreibzugriffe derselben Datei teilen eine Transaktion; erst nach dem letzten Schreibzugriff wird die vollständige Datei übernommen. Reine Metadatenzugriffe erzeugen keine unnötige vollständige Dateikopie. Änderungsbenachrichtigungen und bestehende Lesezugriffe werden aktualisiert. Zusammengehörige SMB-Anfragen können keine fremden Dateihandles schließen. Zeitprüfungen berücksichtigen gleichzeitig laufende Prozessorkerne. USB liest weiterhin eine stabile Ansicht; nach einer Lesepause erscheinen fertige WLAN-Änderungen durch automatische USB-Neuanmeldung. SMB-Authentifizierung und Signaturen bleiben aktiv. Keine automatische Update-Suche, Firmware-Signierung oder Rollback ergänzt. Neu in 1.6.0: Eigene Gerätenamen Eigener Anzeigename auf Display und Weboberfläche. Eigener Netzwerkname für mDNS, DHCP und SMB, z. B. bernette-b70.local. Auch das Einrichtungs-WLAN übernimmt den Netzwerknamen. Windows- und iPad-Adressen passen sich an. Name schon im USB-Installer vergeben oder später unter Gerät ändern. Neue Installationen erhalten ohne Namenseingabe einen eigenen Standardnamen. Bestehende Sticks behalten beim Update ihre bisherige Adresse. Für jeden Stick einen anderen Netzwerknamen wählen. Anzeigename: maximal 32 Zeichen und 63 UTF-8-Bytes. Netzwerkname: maximal 15 Kleinbuchstaben, Ziffern oder Bindestriche. Beim Übernehmen startet der Stick neu; laufende SMB-Schreibzugriffe blockieren die Änderung. Ein Neustart wartet laufende Übertragungen und eine USB-Lesepause ab. Trotzdem nur im Maschinenleerlauf umbenennen. WLAN, Gerätepasswort und SD-Dateien bleiben erhalten. Beispiel: Name „Bernette b70“, Netzwerkname „bernette-b70“. Windows: \\bernette-b70.local\SD iPad/Mac: smb://bernette-b70.local/SD Browser: http://bernette-b70.local/ Bestehende Netzlaufwerk-Verbindungen nach dem Umbenennen mit der neuen Adresse einrichten. Falls .local nicht aufgelöst wird, die IP vom Display verwenden. Die Freigabe bleibt SD und der Benutzer bleibt stick.