Modern 8-bit microcomputer
X65 is an effort to build an 8-bit microcomputer for the modern era. It uses best of breed components and strives to keep 8-bit feeling, while being usable for daily basis computing activities.
This is only for building the Pi Pico software. For writing 6502 software, see rp6502-vscode.
Install the C/C++ toolchain for the Raspberry Pi Pico. For more information, read Getting started with the Raspberry Pi Pico.
sudo apt install cmake gcc-arm-none-eabi libnewlib-arm-none-eabi build-essential gdb-multiarch
All dependencies are submodules. The following will download the correct version of all SDKs. It will take an extremely long time to recurse the project, so do this instead:
git submodule update --init
cd src/pico-sdk
git submodule update --init
cd ../..
To debug Pico RIA or Pico VPU code, you need a Debug Probe or a third Pi Pico as a Picoprobe.
The VSCode launch settings connect to a remote debug session. I use multiple terminals for the debugger and console. You'll also want to add a udev rule to avoid a sudo nightmare. The following are rough notes, you may need to install software which is beyond the scope of this README.
Create /etc/udev/rules.d/99-pico.rules with:
#Picoprobe
SUBSYSTEM=="usb", ATTRS{idVendor}=="2e8a", MODE="0666"
Debug terminal:
openocd -f interface/cmsis-dap.cfg -c "adapter speed 5000" -f target/rp2040.cfg -s tcl
Console terminal:
minicom -c on -b 115200 -o -D /dev/ttyACM0
WSL (Windows Subsystem for Linux) can forward the Picoprobe to Linux:
PS> usbipd list
BUSID DEVICE
7-4 CMSIS-DAP v2 Interface, USB Serial Device (COM6)
PS> usbipd wsl attach --busid 7-4
WSL needs udev started. Create /etc/wsl.conf with:
[boot]
command="service udev start"