Skip to content
RetroLoftPublic

About

Network and SD card storage cartridge for the Atari ST, STE, Mega ST(E), TT and Falcon (ESP32-S3 + iCE40 FPGA)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

76 Commits

Folders and files

Repository files navigation

TheHulk

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.

Repository layout

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

Building

./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.sh installs the YoWASP builds from PyPI in .venv-fpga when no native tools are found.
  • GEMDRIVE: stcmd from atarist-toolkit-docker (Docker image logronoide/atarist-toolkit-docker).
  • Configuration program: m68k-atari-mint-gcc with gemlib. STinG driver and installer: m68k-atari-mint-gcc.
  • ESP32: ESP-IDF 5.5 in ~/esp/esp-idf (or set IDF_PATH).

How it works

  1. 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).
  2. 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.
  3. 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.

License

GPL-3.0, see LICENSE. GEMDRIVE is based on the SidecarTridge Multi-device project by Diego Parrilla Santamaría (GOODDATA LABS SL).

About

Network and SD card storage cartridge for the Atari ST, STE, Mega ST(E), TT and Falcon (ESP32-S3 + iCE40 FPGA)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages