Skip to content

About

WiFi-enabled floppy drive emulator with web interface

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RadioFloppy

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).

RadioFloppy in a Gotek case: OLED display, micro SD card, two buttons and the activity LED

Hardwaretests

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.

The RadioFloppy web page: current floppy, temporary load, new disk and the SD card list

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.

Welke USB-poort?

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

Compileren, flashen en monitor

. ~/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 monitor

Vervang /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.

About

WiFi-enabled floppy drive emulator with web interface

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages