A couple notes on my build:

1. I am working in the Documents directory of the current macOS user. I am using the relative user path in all shell commands below for clarity even though that’s not how I actually work.

2. I am building Apple II firmware that loads the excellent Wizardry 3.1 ProDos shell which is distributed as a 3.5" 800K disk image that can be mounted as a hard drive (.hdv). The file itself (see below) needs to be present on a USB drive attached to the Neo6502 on boot.

3. Open the Terminal app and cd to the Documents directory

cd ~/Documents

1. Clone the Reload Emulator repo

git clone <https://github.com/vsladkov/reload-emulator.git>

1. Checkout pico-sdk, PicoDVI, and tinyusb as git submodules

cd ~/Documents/reload-emulator/platforms/pico-6502/lib
git submodule update --init -- pico-sdk PicoDVI tinyusb

1. Copy the apple2_images.h.example file then open the new file with nano

cd ~/Documents/reload-emulator/src/images
cp apple2_images.h.example apple2_images.h
nano apple2_images.h

1. Add the name of the .hdv image then type ctrl-x followed by Y to save

uint8_t* apple2_nib_images[] = {};

uint8_t* apple2_po_images[] = {};

uint32_t apple2_po_image_sizes[] = {};

char* apple2_msc_images[] = {
    wizardry_3_1.hdv
};

1. Make the firmware

cd ~/Documents/reload-emulator/platforms/pico-6502/
mkdir build && cd build
cmake ..
make apple2

Once the make process successfully completes, connect the Neo6502 to the Mac with a USB A to USB A cable and drop the apple2.uf2 file at ~/Documents/reload-emulator-a1/platforms/pico-6502/build/systems/apple2 in the RPI-RP2 drive that shows up on the Mac. The drive will eject on it’s own when the copy process is complete.

wizardry_3_1.hdv

Additional Notes (mainly for myself):