Building the hardware
ZX-V is not only an emulator: you can build the real machine and plug it into a TV. It is made from two Raspberry Pi Pico 2 boards, a handful of connectors and a few dozen small parts. You do not need to write any code: the software for both Picos comes ready to copy onto them.
Status. The first board works, with the two Picos together: it starts into BASIC on an HDMI screen, and the
boardtestprogram passes the picture and palettes, the sound, the USB keyboard, the gamepads, the mouse, the MODO button and the clock, and the microSD card reads, saves and updates the firmware. Still to be tried on it: the clock's coin cell. Nobody has built the machine on a protoboard yet. If you build one now, you will be among the first: read The board carefully.
What you need
- Two Raspberry Pi Pico 2 boards. They must be the Pico 2 (with the RP2350 chip): the original Raspberry Pi Pico does not run the firmware.
- The board, ordered assembled from JLCPCB, and the few parts you solder yourself (The board). Or, instead, a protoboard or breadboard and the parts in On a protoboard.
- The firmware: two
.uf2files, one for each Pico (The firmware). - A screen with an HDMI input (a TV or a monitor) and an HDMI cable.
- A USB keyboard. Optionally a USB mouse, one or two USB gamepads and a USB hub to plug them all in.
- A microSD card, to save your programs and load others.
- A USB-C phone charger of 5 V that can give 2 A, with its cable.
- Optionally, powered speakers for the audio output, and a CR2032 coin cell so the clock keeps the date and time.
- Optionally, a 3.3 V USB-serial adapter for the board's J5 header: with
it you send programs from the PC and run them without taking the card out,
debug BASIC on the board and serve a folder on the PC as the
EXT:drive (Loading programs from the PC). - A soldering iron, solder, and a computer with a micro-USB cable to put the firmware on the Picos.
Two ways to build it
| The PCB (recommended) | A protoboard or breadboard | |
|---|---|---|
| What it is | A 100 × 100 mm board with everything on it | The two Picos and modules wired by hand |
| Soldering | Only the two Picos, two buttons, a switch, two LEDs, the coin cell and, optionally, the J5 header for remote loading: all through-hole | Many wires; HDMI and the link between the Picos need short, tidy wiring |
| Connectors | HDMI, USB-A, microSD, audio jack, USB-C for power, real-time clock | Breakout boards and modules |
| Status | Works: the first board passes boardtest and uses the microSD card (the coin cell is still to be tried) |
Each Pico tested on its own; the wiring of the two together on a protoboard, not yet (together they work on the board) |
| Guide | The board | On a protoboard |
Both run the same firmware and behave the same.
What each Pico does
The two Picos split the work like the chips in the original Spectrum. The CPU Pico is the computer itself: it runs the BASIC and your programs, and looks after the keyboard, mouse and gamepads (through the USB-A port), the SD card and the clock. The ULA Pico makes the picture and the sound: it receives each finished image from the CPU Pico, sends it to the screen over HDMI, and plays the sound both on the HDMI and on the audio jack. It also carries the video mode button and the link LED. They talk over an 8-bit bus and a few extra wires. For your programs there is only one machine: they cannot tell that there are two chips.
Connecting it
The screen (HDMI)
Plug any HDMI TV or monitor into the HDMI connector. The picture is always 640 × 480 at 60 Hz, a mode every HDMI screen must accept, and the ULA Pico has two output modes:
| Mode | Output | Sound on the screen | The link LED blinks at start-up |
|---|---|---|---|
| 0 | HDMI (the default) | Yes | Once |
| 1 | DVI (the safe mode) | No | Twice |
- A short press of the MODE button switches to the other mode. The ULA Pico restarts with it (the BASIC carries on) and remembers it when you switch off.
- Holding MODE down while you switch on starts in the safe mode, just that once. Every screen should accept it, including old DVI monitors that reject HDMI.
- Programs cannot change the mode, only read it.
Sound
The sound comes out on the HDMI (in mode 0) and, always, on the
3.5 mm stereo jack (labelled AUDIO). The jack gives a line-level signal:
connect powered speakers, an amplifier or your TV's audio input. Headphones
need an amplifier.
Keyboard, mouse and gamepads
Plug them into the USB-A port at the front. For more than one device, use a USB hub (a powered hub is best). ZX-V understands ordinary USB keyboards, mice and most gamepads.
- Ctrl+Alt+F1, F2 and F3 choose the keyboard layout: Spanish, British or US. The machine remembers it.
- Ctrl+Alt+Del is the emergency reset: it restarts the machine, as if you switched it off and on, even if a program has hung. A BASIC program you have not saved is lost.
- Ctrl+Alt+F12 shows or hides the diagnostic page (see The firmware).
The machine explains how the keyboard, mouse and gamepads are seen by programs.
The SD card
Insert a microSD card in the slot on the right-hand side. It can be formatted FAT, FAT32 or exFAT (cards come formatted like this), of any size. You can take it out and put it back with the machine on. On the board the machine notices at once: a card that goes in is ready, and a file that was open when it came out can only be closed (what was already written to it is kept). Close your files before taking the card out. The green SD LED lights while the machine reads or writes the card.
The built-in examples are not on the card: they are in the ROM: drive, which
comes inside the CPU Pico's firmware.
Power
Plug a USB-C charger into the 5 V connector at the back, and slide the
power switch (at the front, on the left) to the right, to ON; to the left is
OFF. A 2 A charger is plenty: the whole machine uses
under 1 A, including the USB devices. The USB-C port only takes power; it does
not carry data.
The clock and the language
The board has a real-time clock with a CR2032 coin cell. It keeps the date and
time (used to date the files you save), the machine's language and the
keyboard layout while the power is off. To set the time, open the editor's
menu (EDIT, the Tab key) and choose Date and time (how it
works), or use CLOCK in the BASIC,
for example CLOCK 2026,10,20,18,30 (year, month, day, hour and minutes).
The machine starts in English. Type LANGUAGE "es" to switch to Spanish;
with the coin cell in place it is remembered.
In this section
- The board: ordering the PCB assembled from JLCPCB, the parts you solder, a checklist, the first power-on, and what every connector and control is.
- The firmware: getting the
.uf2files, putting them on each Pico, updating, building them yourself, and what to check if there is no picture or no sound. - On a protoboard: building ZX-V without the PCB, with the wiring between the two Picos and to each connector.
- The protocol: what travels through J5, for anyone who
wants to write their own server for the
EXT:drive or talk to the board.