Het project mister-tty2oled-esp32 is een protocol-compatibele re-implementatie van venice1200/MiSTer_tty2oled, waarmee betaalbare ESP32-boards (zoals de ESP32-C3 en de 'Cheap Yellow Display') kunnen worden gebruikt als full-colour marquee voor een MiSTer FPGA-systeem.
Belangrijkste functionaliteiten:
- Compatibiliteit: Werkt direct met de bestaande
tty2oled.sh en logo-bibliotheken van MiSTer.
- Visuele mogelijkheden: Ondersteunt full-colour artwork met overgangseffecten (wipe, iris, fade), bewerkbaar via een web-app.
- Connectiviteit: Aansturing is mogelijk via USB of WiFi, waarbij één MiSTer tot drie schermen gelijktijdig kan bedienen.
- Integraties: Biedt MQTT-meldingen voor systemen zoals Home Assistant.
- Installatie: Eenvoudig te installeren via een browser-gebaseerde flasher zonder extra tools.
Het project is open-source (GPLv3) en bevat naast de firmware ook 3D-printbare behuizingen en een speciaal art pack met 77 logo's.
mister-tty2oled-esp32
Belangrijkste kenmerken
- Compatibiliteit: Werkt met de standaard
tty2oled. De ongewijzigde tty2oled.sh op je MiSTer stuurt het scherm aan via USB. De bestaande grijswaarden logo-bibliotheek werkt direct (optioneel getint met een vaste kleur, gradiënt of willekeurige kleuren).
- Artwork: Full-colour art met overgangen zoals wipe, iris en fade, die gebouwd en bekeken kunnen worden in een browser-app.
- Connectiviteit: Ondersteunt USB of WiFi. Eén MiSTer kan tot drie schermen tegelijk aansturen via WiFi.
- Integraties: MQTT-meldingen voor Home Assistant en andere systemen.
- Installatie: Flashen vanuit de browser; er hoeven geen tools te worden geïnstalleerd en WiFi-instellingen blijven bewaard bij updates.
- Extra's:
- Een gratis kleuren art pack (77 logo's uit publiek domein) dat geïnstalleerd kan worden via de MiSTer Downloader.
- 3D-printbare behuizingen voor het Sunton-board.
Aan de slag
- Flashen: Flas je board via de web flasher (gebruik Chrome, Edge of Opera op een desktop). Houd de BOOT-knop ingedrukt bij het aansluiten van een C3-board. Zie de sectie 'Flashing' voor details.
- WiFi verbinden (optioneel): Het display opent een eigen setup-netwerk en toont een QR-code. Zie 'First boot and settings'.
- Aansturen via MiSTer: Sluit het board aan via USB en de standaard
tty2oled.sh werkt direct, of installeer de WiFi-daemon om de kabel over te slaan.
- Artwork maken (optioneel): Gebruik de marquee web-app om eigen art te maken.
In actie
Bekijk de demo op YouTube voor voorbeelden van grijswaarden, gradiënt en willekeurige kleuren logo's, gevolgd door full-colour art op drie tegelijkertijd aangestuurde schermen vanaf één MiSTer.
Op een echte MiSTer, gebruikmakend van de ongewijzigde tty2oled.sh via USB met de Sunton ESP32-2424S012C als display (bij het openen van enkele autoboot console cores): mister-demo.mp4.
Ondersteunde boards
Alle ondersteunde boards gebruiken hetzelfde protocol en tonen dezelfde rond-native 240×240 art (gecentreerd op het bredere scherm van de CYD). Informatie over bedrading, pinnen en specifieke board-notities zijn te vinden onder 'Hardware'.
| Board | Display | Build env | CMDHWINF id |
|---|
| ESP32-C3 Super Mini, met onboard OLED | separate GC9A01 1.28" round | esp32c3 | HWGC9A01C |
| ESP32-C3 Super Mini, zonder OLED | separate GC9A01 1.28" round | esp32c3_nooled | HWGC9A01C |
| Sunton ESP32-2424S012C | 1.28" round GC9A01, soldered on | esp32c3_2424s012 | HWGC9A01C |
| CYD ESP32-2432S028 | 2.8" 320×240 ILI9341, touch | esp32_cyd | HWCYD28 |
Documentatie
- Hardware: Boards, bedrading, pinnen en onboard OLED.
- Case: De 3D-printbare behuizing en bureaustandaard.
- Flashing: Web flasher, esptool en bouwen vanuit broncode.
- First boot, settings and MQTT: WiFi-setup, de instellingenpagina en meldingen.
- MiSTer daemon over WiFi: Het aansturen van maximaal drie schermen zonder kabel.
- Marquee web app: Het maken en bekijken van art, displayprofielen en de lokale bibliotheek.
- Wire protocol: Commando's via USB-serieel en WiFi.
- Compatibility notes: Hoe dit project verschilt van het origineel en waarom er een custom display driver is gebruikt.
- Roadmap: Wat er gepland staat en bekende problemen.
- License details: Wat de GPL-toekenning wel en niet dekt.
Inhoud van deze repository
firmware/: Het PlatformIO project (voor ESP32-C3 boards en de klassieke-ESP32 CYD).web/: De Vite + TypeScript marquee web app.mister/: t2o-wifi, de daemon aan de MiSTer-zijde (geschreven in Go).tools/: De conversie-pipeline en release-scripts.case/: 3D-printbare bestanden voor de behuizing.reference/: Het upstream MiSTer_tty2oled project als git submodule, uitsluitend gebruikt als referentie voor het protocol en formaat.
Licentie
GPLv3 of later (GPL-3.0-or-later), copyright 2026 Erico Mendonca; zie LICENSE. Let op: De art packs van derden, de reference/ submodule en sommige init-data vallen niet onder deze licentie; zie 'License details'.
Dankwoord
Dit project is gebouwd op het protocol- en hardware-ontwerp van venice1200 en ojaksch, de oorspronkelijke auteurs van het tty2oled-project. De ondersteuning voor de onboard status OLED is geport van een WLED usermod voor hetzelfde paneel.
De reliëf-mascot op de behuizingsstandaard is MiSTer-Kun, gemaakt door HeWhoisRed en geremasterd door baxysquare (misterkun); zie case/misterkun_CREDITS.txt. Deze valt niet onder de GPL-licentie van dit project.
Transformeer een ESP32 en een kleurenscherm (rond GC9A01, de Sunton all-in-one, of het 2.8" "Cheap Yellow Display") in een full-colour MiSTer marquee. Dit project is een protocol-compatibele re-implementatie van venice1200/MiSTer_tty2oled voor betaalbare ESP32-boards: een ESP32-C3 met een ronde GC9A01, de Sunton all-in-one, of de 2.8" "Cheap Yellow Display" (CYD).
mister-tty2oled-esp32
Belangrijkste kenmerken
- Compatibiliteit: Werkt met de standaard
tty2oled. De ongewijzigde tty2oled.sh op je MiSTer stuurt het scherm aan via USB. De bestaande grijswaarden logo-bibliotheek werkt direct (optioneel getint met een vaste kleur, gradiënt of willekeurige kleuren).
- Artwork: Full-colour art met overgangen zoals wipe, iris en fade, die gebouwd en bekeken kunnen worden in een browser-app.
- Connectiviteit: Ondersteunt USB of WiFi. Eén MiSTer kan tot drie schermen tegelijk aansturen via WiFi.
- Integraties: MQTT-meldingen voor Home Assistant en andere systemen.
- Installatie: Flashen vanuit de browser; er hoeven geen tools te worden geïnstalleerd en WiFi-instellingen blijven bewaard bij updates.
- Extra's:
- Een gratis kleuren art pack (77 logo's uit publiek domein) dat geïnstalleerd kan worden via de MiSTer Downloader.
- 3D-printbare behuizingen voor het Sunton-board.
Aan de slag
- Flashen: Flas je board via de web flasher (gebruik Chrome, Edge of Opera op een desktop). Houd de BOOT-knop ingedrukt bij het aansluiten van een C3-board. Zie de sectie 'Flashing' voor details.
- WiFi verbinden (optioneel): Het display opent een eigen setup-netwerk en toont een QR-code. Zie 'First boot and settings'.
- Aansturen via MiSTer: Sluit het board aan via USB en de standaard
tty2oled.sh werkt direct, of installeer de WiFi-daemon om de kabel over te slaan.
- Artwork maken (optioneel): Gebruik de marquee web-app om eigen art te maken.
In actie
Bekijk de demo op YouTube voor voorbeelden van grijswaarden, gradiënt en willekeurige kleuren logo's, gevolgd door full-colour art op drie tegelijkertijd aangestuurde schermen vanaf één MiSTer.
Op een echte MiSTer, gebruikmakend van de ongewijzigde tty2oled.sh via USB met de Sunton ESP32-2424S012C als display (bij het openen van enkele autoboot console cores): mister-demo.mp4.
Ondersteunde boards
Alle ondersteunde boards gebruiken hetzelfde protocol en tonen dezelfde rond-native 240×240 art (gecentreerd op het bredere scherm van de CYD). Informatie over bedrading, pinnen en specifieke board-notities zijn te vinden onder 'Hardware'.
| Board | Display | Build env | CMDHWINF id |
|---|
| ESP32-C3 Super Mini, met onboard OLED | separate GC9A01 1.28" round | esp32c3 | HWGC9A01C |
| ESP32-C3 Super Mini, zonder OLED | separate GC9A01 1.28" round | esp32c3_nooled | HWGC9A01C |
| Sunton ESP32-2424S012C | 1.28" round GC9A01, soldered on | esp32c3_2424s012 | HWGC9A01C |
| CYD ESP32-2432S028 | 2.8" 320×240 ILI9341, touch | esp32_cyd | HWCYD28 |
Documentatie
- Hardware: Boards, bedrading, pinnen en onboard OLED.
- Case: De 3D-printbare behuizing en bureaustandaard.
- Flashing: Web flasher, esptool en bouwen vanuit broncode.
- First boot, settings and MQTT: WiFi-setup, de instellingenpagina en meldingen.
- MiSTer daemon over WiFi: Het aansturen van maximaal drie schermen zonder kabel.
- Marquee web app: Het maken en bekijken van art, displayprofielen en de lokale bibliotheek.
- Wire protocol: Commando's via USB-serieel en WiFi.
- Compatibility notes: Hoe dit project verschilt van het origineel en waarom er een custom display driver is gebruikt.
- Roadmap: Wat er gepland staat en bekende problemen.
- License details: Wat de GPL-toekenning wel en niet dekt.
Inhoud van deze repository
firmware/: Het PlatformIO project (voor ESP32-C3 boards en de klassieke-ESP32 CYD).web/: De Vite + TypeScript marquee web app.mister/: t2o-wifi, de daemon aan de MiSTer-zijde (geschreven in Go).tools/: De conversie-pipeline en release-scripts.case/: 3D-printbare bestanden voor de behuizing.reference/: Het upstream MiSTer_tty2oled project als git submodule, uitsluitend gebruikt als referentie voor het protocol en formaat.
Licentie
GPLv3 of later (GPL-3.0-or-later), copyright 2026 Erico Mendonca; zie LICENSE. Let op: De art packs van derden, de reference/ submodule en sommige init-data vallen niet onder deze licentie; zie 'License details'.
Dankwoord
Dit project is gebouwd op het protocol- en hardware-ontwerp van venice1200 en ojaksch, de oorspronkelijke auteurs van het tty2oled-project. De ondersteuning voor de onboard status OLED is geport van een WLED usermod voor hetzelfde paneel.
De reliëf-mascot op de behuizingsstandaard is MiSTer-Kun, gemaakt door HeWhoisRed en geremasterd door baxysquare (misterkun); zie case/misterkun_CREDITS.txt. Deze valt niet onder de GPL-licentie van dit project.
Groetjes,