Uxn 12

A graphical emulator for the Varvara Computer, written in C.

Building

make run

You can run make install to build and install the files. By default, files are installed into ~/.local but this can be overridden using PREFIX:

# installs files into /opt/uxn/bin and /opt/uxn/share
$ make PREFIX=/opt/uxn install

Usage

The first parameter is the rom file, the subsequent arguments will be accessible to the rom, via the Console vector.

bin/uxn11 bin/example.rom arg1 arg2

• -l {x} {y} Layer shell

Manual

A manual page is provided documenting the Uxntal language:

man ./doc/man/uxntal.7

After running make install the man page should be found by man uxntal.

Assembler

This repository comes with a copy of the compiled Drifblim assembler.

cat etc/utils/drifblim.rom.txt | bin/uxn11 etc/utils/xh.rom > bin/drifblim.rom
bin/uxn11 bin/drifblim.rom etc/tests/opctest.tal bin/opctest.rom

Devices

The file device is not sandboxed, meaning that it will be able to read or write outside of the working directory. Use carefully.

• 00 system
• 10 console(+)
• 20 screen
• 80 controller
• 90 mouse
• a0 file(a)
• b0 file(b)
• c0 datetime

Emulator Controls

• F1 toggle zoom
• F2 toggle debugger
• F4 reboot
• F5 reboot(soft)

Buttons

• LCTRL A
• LALT B
• LSHIFT SEL
• HOME START

Need a hand?

The following resources are a good place to start:

• XXIIVV — uxntal
• XXIIVV — uxntal reference
• compudanzas — uxn tutorial