WiFi-floppy-emulator voor de Atari ST op basis van een ESP32-S3 (Otronic DevKitC-clone,
16 MB flash, 8 MB PSRAM) op de RadioFloppy-PCB revisie 2 (opvolger in hardware/v1.2: dezelfde pinnen, plus GPIO3).
Framework: ESP-IDF v5.5.5 (C).
main/main.c kiest welke test draait (roep de gewenste functie uit main/tests.h aan):
| Test | Bestand | Wat |
|---|---|---|
floppy_emu_run() (actief) |
main/floppy_app.c, sd_card.c, disk_copy.c, drive_emu.c, flux_stream.c, mfm_track.c, disk_image.c |
Floppy-emulatie als drive B: (EMU_SELECT_LINE). De image (.ST of HFE) komt van de SD-kaart (J5), bij opstarten zonder kaart uit de kopie van de laatste disk op de externe SPI-flash U2 (zie docs/FLASH_LAYOUT.md), of uit een tijdelijke PSRAM-upload (.ST). Alle 168 sporen worden bij het opstarten naar MFM gecodeerd in PSRAM (FlashFloppy-layout voor .ST: geen IAM, GAP4a 80, GAP2 22, GAP3 84). RMT+DMA speelt de fluxstroom op GPIO41 (0,8 us pulsen, 10 MHz), een tweede RMT-kanaal de INDEX-puls op GPIO1 (3 ms per 200 ms, synchroon gestart). WPROT volgt de schrijfbeveiliging van de disk; geschreven sectoren worden opgeslagen (zie docs/API.md → Writing). |
(oud) legacy/input_monitor.c |
niet gebouwd | Selectiebewuste monitor met TRACK0 uit de vorige fase, ter referentie. |
loopback_test_run() |
main/loopback_test.c |
Zoekt continu welke Shugart-uitgang (ULN2003A) via een jumper op J1 met welke ingang (SN74LVC245A) verbonden is. |
Loopbacktest: de Shugart-lijnen hebben op de PCB geen pull-ups (behalve DS0/DS1). Plaats op de jumper een pull-up van 4,7–10 kΩ naar +3V3 (bijv. J3 pin 3, displayconnector), anders komt de lijn na het vrijgeven van de uitgang niet betrouwbaar HIGH en wordt er niets gemeld.
Webinterface: http://<ip>/ — Current Floppy, tijdelijk laden (PSRAM), New disk en het SD-kaartblok (mappen, uploaden, inserten, verwijderen) vanuit de browser
(web/index.html, in de firmware ingebouwd); tandwiel rechtsboven = instellingen (hostnaam,
firmware). Knoppen: links = vorige disk, rechts = volgende, binnen de map van de laatst gekozen disk (geen rondgang); beide 3 s = hostnaam en IP op het
display; beide 10 s = WiFi-setupmodus.
WiFi-setupmodus: zonder ingesteld netwerk (of na 10 s beide knoppen) opent RadioFloppy een
eigen WiFi-netwerk met één setup-pagina (netwerk, beveiliging, wachtwoord). De diskemulatie is dan
uit; het display toont netwerknaam en adres; het netwerk is open (geen sleutel). Zie docs/API.md → WiFi setup mode.
WiFi en HTTP API: docs/API.md — images uploaden (tijdelijk naar PSRAM of als bestand op de SD-kaart),
images van de SD-kaart inserten, mappen en bestanden beheren via /api/v1/. Hostnaam en WiFi-netwerk staan op de
externe flash (instellingen, setupmodus); idf.py menuconfig → RadioFloppy geeft alleen de
standaardwaarden en het optionele API-token, en staat alleen in sdkconfig (git-ignored). Standaard is de
API open op het thuisnetwerk. Tests:
tests/host/run.sh (op de PC), tests/api/api_test.py en tests/web/ui_test.py (tegen het board).
STEP-geluid en LED's: bij iedere verwerkte STEP-puls van drive B: geeft de buzzer (GPIO46) een tik van 3 ms (main/step_sound.h). De LED's (main/leds.h, instelling Front panel LEDs: 1 of 2): de LED op J4 pin 3 (GPIO20) brandt zolang drive B: geselecteerd is en MOTOR actief is. De WiFi-status staat met 2 LED's op J4 pin 1 (GPIO48), met 1 LED op de RGB-LED van het ESP32-bord (blauw): uit = verbonden, knippert = verbinding zoeken, brandt = na 60 s nog geen verbinding (of geen netwerk ingesteld), snel knipperen = WiFi-setupmodus.
Buzzer: hangt aan het +5V-net van de PCB, dat alleen via J2 (floppyvoeding / Atari) gevoed wordt: de 5V-pin van de Otronic-clone is alleen een ingang. Bij voeding via USB alleen is de buzzer dus stil.
Veiligheid Shugart-uitgangen: bootloader_components/early_pins zet de zes uitgangs-GPIO's
(ULN2003A-ingangen) al in de bootloader op LOW; shugart_outputs_release() doet dat opnieuw als
eerste stap in app_main().
Floppy images: de firmware bevat geen images. De images staan als bestanden op de SD-kaart,
onder de ingestelde root directory. De externe flash bevat alleen de instellingen en een kopie van
de laatste disk (docs/FLASH_LAYOUT.md), zodat RadioFloppy ook zonder kaart met die disk start.
De oude imagebibliotheek op de flash wordt bij de eerste start van deze firmware gewist. De Atari
kan schrijven naar .ST-bestanden zonder het FAT-kenmerk alleen-lezen (slotje op de website); een
save gaat eerst naar de kopie in de flash (journaal) en dan naar het bestand op de kaart. images/RETROLOFT_TEST_720K.ST is alleen een testbestand in de
repository. Commerciële images blijven lokaal (.gitignore).
Volledige pinmapping: main/board_pins.h.
Gebruik uitsluitend de USB-poort van de USB-naar-UART-brug (op het board meestal
gemarkeerd als COM of UART). De andere poort (USB) is de native USB van de ESP32-S3 en
zit direct op GPIO19/GPIO20. Die poort mag niet worden aangesloten: de host trekt D-/D+
via 15 kΩ naar GND, waardoor de knop SW_NEXT (GPIO19) permanent "ingedrukt" leest.
Controle onder Linux na het insteken:
lsusb
ls -l /dev/ttyUSB* /dev/ttyACM*lsusb toont |
Poort |
|---|---|
10c4:ea60 Silicon Labs CP210x |
UART-brug → goed (/dev/ttyUSB0) |
1a86:55d3 / 1a86:7523 QinHeng CH343/CH340 |
UART-brug → goed (/dev/ttyACM0 of /dev/ttyUSB0) |
303a:1001 Espressif USB JTAG/serial |
native USB → verkeerde poort |
. ~/esp/esp-idf/export.sh # eenmalig per terminal
cd FloppyEmulator-ESP32S3
idf.py set-target esp32s3 # alleen de eerste keer
idf.py build
idf.py -p /dev/ttyUSB0 flash monitorVervang /dev/ttyUSB0 door de poort die hierboven is gevonden. Stoppen van de monitor:
Ctrl+].
Verwachte uitvoer: de opstartmelding van RadioFloppy met de imagebibliotheek, de actieve disk en het IP-adres.

