Uxnds

uxnds
General
Author	asiekierka
Type	Computer
Version	0.3.6
License	MIT License
Last Updated	2023/02/18
Links
Download
Website
Source

unxds is a port of the Unx virtual machine to the NDS. Uxn is a portable 8-bit virtual computer inspired by forth-machines, capable of running simple tools and games programmable in its own assembly language.

This emulator allows you run to your uxn projects on the DS, also ideal for developers who want to learn how to program little 8-bit things, such as text editors, music trackers, illustration programs and games.

Installation

There are three binaries provided:

• uxnds.nds - faster, but best used only with known-good software,
• uxnds_debug.nds - slower, but provides debugging information, profiling information and performs CPU stack bounds checks.
• uxnds_profile.nds - almost as fast as uxnds.nds - with debugging/profiling information, no CPU stack bounds checks.

By default, uxnds will run /uxn/boot.rom. It also supports reading files from within /uxn.

Note: When using a real DS/DSi/3DS console, it is recommended to launch this program via nds-hb-menu - though, as it currently doesn't use argc/argv, it doesn't really change much.

User guide

On start, a keyboard is presented on the bottom screen, and the uxn display is on the top screen.

Resources

• Uxn Roms (repo) - Uxn roms by Rekka Bellum and Devine Lu Linvega.
• Unx tutorial - Unx programming guide.

Controls

L/R - Swap top and bottom screens

Touchscreen - Mouse input

Media

Noodle - Magic Brush (Devine Lu Linvega)

Compatibility

Tested on iDeaS.

Changelog

v0.3.6

• uxn VM updates:
  • implemented JCI/JMI/JSI opcodes
• updated datetime, file and system devices to (mostly) match mainline
  • now with MMU support!
• properly implemented "quit" option
• bundled the correct-for-this-release version of uxn "essentials"
• other minor improvements

v0.3.5

• uxn VM updates:
  • implemented opcode table order changes
  • implemented new two-device file I/O
  • implemented new changes to screen I/O
• uxnds will now look for "launcher.rom" if "boot.rom" is not present

v0.3.4

• Add directory reading support. (contributed by DeltaF1)
• Add reset key combo (START+SELECT), with confirmation prompt. (with contributions from DeltaF1)
• Fix inaccurate mouse device implementation. (contributed by Hoolean)
• Minor fixes/toolchain updates.

v0.3.3

• Update to match latest mainline changes.

v0.3.2

• Update PPU logic to match latest spec changes.

v0.3.1

• Updates to the "console" device to bring it in line with latest uxnemu (somewhat).
• Fixed only the first APU channel working.

v0.3.0

• Updated CPU core to be compatible with the latest uxn specification changes. (SFT2)
• Minor performance improvements (3-5%), thanks alderwick.
• Reduced the .nds size by ~4-25KB, depending on build.

Release notes.

External links

• GitHub - https://github.com/asiekierka/uxnds
• Reddit - https://www.reddit.com/r/3dshacks/comments/nhj5xa/uxn_retrostyle_fantasy_computer_ported_to_ds