Network and SD card storage cartridge for the Atari ST, STE, Mega ST(E), TT and Falcon, built around an ESP32-S3 and a Lattice iCE40UP5K FPGA. Successor of SideTNFS.
| Path | Contents |
|---|---|
hardware/dev-v2/ |
KiCad project and JLCPCB production files of the development board (ESP32-S3-DevKitC) |
hardware/prod-v2/ |
KiCad project of the production board (ESP32-S3 module on the board, native USB, not ordered yet) |
fpga/ |
FPGA gateware (Verilog), pin constraints, simulation |
esp32/ |
ESP32-S3 firmware (ESP-IDF); embeds the bitstream, GEMDRIVE and the built-in files of the flash drive |
atari/gemdrive/ |
GEMDRIVE: the cartridge code the Atari runs (68000 assembly) |
atari/config/ |
Configuration program for the Atari (GEM, C) |
atari/sting/ |
CART_NET.STX: STinG driver for TheHulk's network bridge (C) |
atari/stingins/ |
STINGINS.TOS: STinG installer on the flash drive, see docs/NETWORK.md |
tools/ |
Development helpers |
docs/ |
Documentation: hardware, drives, internet with STinG, web page, cartridge emulator, floppy emulator |
./build.sh # everything
./build.sh flash /dev/ttyACM0 # and flash the ESP32, then open the serial monitor
./build.sh sim # gateware simulation
Requirements:
- FPGA: yosys, nextpnr-ice40 and icepack.
build.shinstalls the YoWASP builds from PyPI in.venv-fpgawhen no native tools are found. - GEMDRIVE:
stcmdfrom atarist-toolkit-docker (Docker imagelogronoide/atarist-toolkit-docker). - Configuration program:
m68k-atari-mint-gccwith gemlib. STinG driver and installer:m68k-atari-mint-gcc. - ESP32: ESP-IDF 5.5 in
~/esp/esp-idf(or setIDF_PATH).
- The ESP32 waits until the Atari powers the FPGA side of the board, then loads the bitstream into the FPGA over SPI (~50 ms at 20 MHz).
- It writes the cartridge image (GEMDRIVE) into the FPGA's SPRAM and enables the cartridge. The FPGA keeps the data bus updated with the word at the current address; the data buffer is enabled in hardware by /ROM3 or /ROM4.
- When the Atari is switched off, the ESP32 drives all FPGA lines low and waits for the next power-up.
Status LED (on the DevKitC): see docs/WEB.md. The web page
(http://thehulk.local/) shows the state and all settings; button 1 held 10 s switches AP
mode on, TheHulk's own Wi-Fi network for use away from home.
GPL-3.0, see LICENSE. GEMDRIVE is based on the SidecarTridge Multi-device project by Diego Parrilla Santamaría (GOODDATA LABS SL).