{"id":1487,"date":"2026-07-11T13:28:27","date_gmt":"2026-07-11T13:28:27","guid":{"rendered":"https:\/\/justanotherelectronicsblog.com\/?p=1487"},"modified":"2026-07-11T13:28:29","modified_gmt":"2026-07-11T13:28:29","slug":"running-varvara-on-a-pi-pico-2","status":"publish","type":"post","link":"https:\/\/justanotherelectronicsblog.com\/?p=1487","title":{"rendered":"Running Varvara on a Pi Pico 2"},"content":{"rendered":"\n
\"\"<\/a><\/figure>\n\n\n\n

What’s a “Varvara” and why does that pi pico 2 look a little different? Let’s dive into that!<\/p>\n\n\n\n

Varvara<\/a> is a specification for a computer system, which uses the Uxn<\/a> virtual machine and describes how things like a display, mouse, keyboard and such should react. Uxn, in term, is a spec for a virtual machine or virtual CPU. It’s a stack based 8 bit CPU that is meant to be easy to learn and emulate. <\/p>\n\n\n\n

It’s essentially a graphical computer specification! The goal is to have an easy to implement and emulate computer with it’s own programming language, so programs can be written once and run on everything. And the computer is made to be easy to program for, as all the devices like files, screen and such are very abstract.<\/p>\n\n\n\n

For example, there is no notion of a file system. There are just commands to read, write and delete files. The emulator handles the rest. For the display, to draw a sprite, the address of the sprite is placed in the right location and then a command is issued to draw it.<\/p>\n\n\n\n

This feels very much like an 8 bit home computer done right, not having to care too much about hardware limitations of that era. There is also a ton<\/a> of programs and guides for it, from small tools like a calendar and notepad to quite some games. There is also a great tutorial on programming for the Varvara computer here<\/a> which I highly recommend to check out!<\/p>\n\n\n\n

Of course, my brain went: Huh. can I run this on a micro-controller?<\/p>\n\n\n\n

So I tried in the past using a Pi Pico, but it just wasn’t meant to be. The Pi Pico 1 felt just a bit too small and limited. But then the Pi Pico 2 launched, with twice the RAM. So let’s try again :)<\/p>\n\n\n\n

OK and make a custom RP2350 board because I got annoyed at the Pi Pico 2, can’t have a project without a little yak shaving<\/a>!<\/p>\n\n\n\n\n\n\n\n

Uxn\/Varvara nitty gritty<\/h2>\n\n\n\n

First of all, let’s look at Uxn! There is a spec<\/a> on what this all contains. Essentially, we need to emulate an 8 bit stack CPU. This means there are no registers, instead there is a working stack and a return stack, each is 256 bytes big. By default, there is 64KB of memory. <\/p>\n\n\n\n

Uxn has 32 instructions, and as this is a stack based computer, they all operate on the stack. For example, the ADD instruction adds the top two values of the stack and pushes the result to the stack.
Each instruction can have a flag to operate in short mode to operate on 16 bit numbers, a flag to use the return stack instead of the working stack, and a flag to not remove the values read from stack.
This means every instruction is just a single byte big! 5 bit for the operand and 3 bits for the flags.<\/p>\n\n\n\n

Luckily, there are a ton of great, tried and tested, implementations<\/a> for Uxn in C, which should just run on any machine with a C compiler and enough RAM.<\/p>\n\n\n\n

Varvara is a tad more involved though!<\/p>\n\n\n\n

Turn the CPU into a computer<\/h2>\n\n\n\n

Varvara<\/a> is the spec for the computer system so to say, think mouse, keyboard, display, sound and more. It’s divided into 16 possible devices, each having 16 bytes of addressable memory called ports. From a programmers point of view, it’s very similar to memory mapped peripherals that many micro-controllers have.<\/p>\n\n\n\n

Currently, there are 8 devices in Varvara:<\/p>\n\n\n\n