Play retro color 8-bit games on your TV from an Arduino
Arduinocade features old-school color 8-bit graphics (tiles, sprites, smooth scrolling, simple 3D) and sound (four-voice wavetable synthesis). All video and audio signals are generated with three resistors, an upgraded crystal, and a little software. By overclocking the Arduino to 28.6363MHz, we can directly manipulate NTSC to generate 27 simultaneous colors. An IR receiver supports a wide variety of keyboards, joysticks, and remote controls.
Video of Arduinocade in action: https://www.youtube.com/watch?v=nGIujZiEu_o
Code, tools, schematics, and more detail: https://github.com/rossumur/Arduinocade
These games are sketches of what is possible on the Arduinocade hardware and a far from the polished pieces that inspired them.
A one-on-one sports-style game inspired by the brilliant 1984 game Ballblazer. This uses a simple physics model and a 2D/3D rendering pipeline to produce 60fps animation. Try to grab the ball and shoot it into your opponent’s goal.
What can I say? "Pakku pakku pakku."
Fly around on ostrich thingies. Poke each other with sticks. It's a nice example of using the sprite engine to generate lots of large multicolor sprites.
Caverns of Titan
Homage to the Atari classic Caverns of Mars. Smooth scrolling, sprites, and animation.
Building the Hardware
Lots of different ways to build this beastie. The design is simple enough to build on a breadboard with a DIP ATmega328; alternatively, you might want to add a 28.6363MHz crystal to a $2 Arduino Pro Mini or even build on a custom PCB.
You will need
- Arduino Pro Mini, ATmega328P or equivalent
- 28.6363MHz Crystal (from Adafruit, eBay, etc.)
- RCA audio/video cable (eBay)
- 470-, 1k-, and 100k-ohm resistors
- IR receiver: TSOP38238, TSOP4838 or equivalent (from Adafruit, Mouser Electronics, etc.)
IR input device (see below)
+----------------+ | Arduino | | Uno or Pro | | 28MHz | 5v <--+-+ IR Receiver | | GND <--| ) TSOP4838 | 8 |-------------+-+ | | | 6 |----[ 100k ]--------> AUDIO | | | 9 |----[ 1k ]----+---> VIDEO | | | | 1 |----[ 470 ]----+ | | | 3 | | 2 | | | +----------------+
We will be upgrading the crystal/resonator on these boards from 16MHz to 28.6363MHz. The easiest ones to modify have big silver cans on them. Others use a ceramic resonator, which requires a bit of SMD fiddling.
If you want to get silly and build a custom board, you can get a video console down to about the size of a quarter. Board and schematics can be found in /sim/docs/eagle.
Left to right: Retcon IR Controller, Atari Flashback 4 joysticks, Apple TV remote
A number of IR input devices are supported. The IR Wireless Controllers from Atari Flashback 4 work well and have that classic joystick feel, as do the Retron IR controllers. These can be readily found on eBay for a few bucks. The Apple TV remote is also supported, but you might feel a little silly. Edit config.h to select your input of choice.
Upgrading the bootloader
If you want to use the Arduino IDE, you should upgrade the bootloader to be able to work at 115200 baud with the faster crystal installed. The optibootatmega3228.hex image has been rebuilt with F_CPU=28636363 and a slower watchdog reset, so baud rate calculations will be correct for our overclocked device. Install the image with Avrdude and your favorite ISP.
avrdude -c usbtiny -p atmega328p -e -u -U lock:w:0x3f:m -U efuse:w:0x05:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -c usbtiny -p atmega328p -U flash:w:optiboot_atmega328_28Mhz.hex -U lock:w:0x0f:m
Once the modified Optiboot is installed, the device will behave like an Uno, so remember to select that from the boards menu in the Arduino IDE.
Using the Arduino IDE
Note: The current code does not work correctly with Arduino IDEs later than 1.5.6. Compiler optimizations in later versions interfere with hand-timed loops in the video kernels. I will fix that soon.
Arduinocade folder into the IDE libraries folder, and relaunch IDE. You should be able to open the example games from File->Examples->Arduinocade. Edit the config.h file to enable or disable the custom
How it works
Upgrading the crystal to 28.6363MHz allows us to run at a multiple (8x CPU clock, 4x SPI output) of the NTSC subcarrier frequency. By spitting out bits in the right pattern at the right time, we can generate NTSC colorburst and different colors based on the relative phase of the pattern.
Black (0000), White (1111), gray5 (0101) and gray10 (1010) don’t have a chroma component; the other 12 colors do. By inserting or skipping an extra NOP in rendering kernel, we can select between two different phases at the start of a line yielding 12+12+ (black,white,gray) = 27 colors on screen simultaneously. You can then add more by dithering, etc.
The Art of Artifacts
Left: Pixels being emitted from the TX port. Right: Colors as they appear on NTSC.
With every HSYNC interrupt, the CPU emits a 3.57MHz ColorBurst signal, then sends pixel data from carefully timed tile or RLE video kernels. These are tricky to maintain in C, as helpful compiler optimizations often alter timing in unexpected ways. They probably all need to move to ASM at some point. See note above.
The higher layer code uses an RLE format (Ballblaster) or tiles to represent game content. Because we don’t have enough memory for a full-frame buffer, individual lines of tiles and sprites are composed in a loop that is in lock step with the HSYNC interrupt.
The Audio driver has two parts. The low-level kernel runs every HSYNC, stepping each of the four voices through its wavetable, mixing the sampled voices together based on their current volume, and emitting a sample to the PWM/resistor single-bit DAC. This corresponds to a sample rate of 15734Hz.
The high level task runs every frame at 60Hz, and it adjusts envelope, modulates frequency of the underlying channels, etc. It is responsible for parsing data structures containing music tracks and sound effects, adjusting volume envelopes and frequencies, swapping wavetables for different instruments, etc.
IR input Joysticks, Keyboards etc
The GPIO attached to the IR sensor is sampled at HSYNC and fed to one of a number of IR decoders. The 15734Hz sample rate is enough to accurately parse nearly all IR protocols. For performance reasons, only one is enabled at a time; check the #ifdefs in
Let me know if you have some fun with it.