Skip to content

Instantly share code, notes, and snippets.

@jj1bdx

jj1bdx/neo6502.md

Last active March 8, 2025 07:42
Show Gist options
  • Save jj1bdx/db717142eeb03278628a47b14e3684b2 to your computer and use it in GitHub Desktop.
Save jj1bdx/db717142eeb03278628a47b14e3684b2 to your computer and use it in GitHub Desktop.
Download ZIP
Neo6502 installation tips and caveats
Raw
neo6502.md

Using Neo6502.md

Note well: no guarantee for the following hardware contents.

Hardware caveats

You need a working USB keyboard and a USB memory together, presumably with a USB hub.

HHKB Pro 2 + USB memory

  • HHKB Professional 2 (PFU PD-KB400W) will work as a hub for Neo6502
  • A decent USB memory (e.g.: Buffalo RUF2-K4G 4GB USB memory) with FAT16 format will be recognized, when plugged into the USB hub of the HHKB
    • In macOS, this will cause an error of insufficient power current for the memory
    • In Neo6502, nevertheless, the memory will be recognized without problems

Firmware update

USB A-A cable is required for the firmware update (to Morpheus).

How to update:

  • Disconnect USB-C power from Neo6502
  • Connect USB A-A cable from Net6502 keyboard connector to the host computer
  • Press BOOT1 button (with a thin stick) and keep it pressed
  • Connect USB-C power to Neo6502 and hold for a few seconds
  • Release BOOT1 button
  • Neo6502 will be mounted as "RPI-RP2" USB disk volume
  • Copy the new firmware image to the RPI-RP2 disk volume (Neo6502 will be immediately rebooted after finishing the copy)

Installing emulator

Prerequisites in my case for macOS

  • pip install gitpython pillow pyserial
  • brew install tass64
  • brew install arm-none-eabi-gcc

How to build

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment