OTHER License
This README is specific to the "pico" fork of unrealspeccyp. See here for the original unrealspeccyp readme.
If you want to know about pin usage and features, the best thing to do is run:
e.g.
$ picotool info -a khan128_usb.elf
File khan128_usb.elf:
Program Information
name: khan128_usb
features: SDL event forwarder support
USB keyboard support
UART stdin / stdout
binary start: 0x10000000
binary end: 0x1003b2ec
Fixed Pin Information
0-4: Red 0-5
6-10: Green 0-5
11-15: Blue 0-5
16: HSync
17: VSync
20: UART1 TX
21: UART1 RX
28: AY sound (PWM)
Build Information
sdk version: 1.5.1-develop
pico_board: vgaboard
boot2_name: boot2_w25q080
build date: May 29 2023
build attributes: Release
These video/audio pins match for example the Pimoroni Pico VGA Demo Base which itself is based on the suggested Raspberry Pi Documentation here and the design files zipped here.
USB Keyboard - Depending on the version you have, you can use a real USB keyboard (if supported by TinyUSB on
RP2040). I know
RaspberryPi keyboards work, and my old Dell keyboard. If in doubt, the older and crappier the better! USB keyboard
support is enabled for binaries with names ending in _usb
.
SDL Event Forwader - This is a simple app that tunnels input from a window on the host machine over UART to the RP2040: https://github.com/kilograham/sdl_event_forwarder. Note however this sometimes seems to get keys stuck on the spectrum. This is enabled by default in all builds.
Raw UART - Not very useful, but you can enable this, and allow typing a few keys on the spectrum (you need to
find this in the CMakeLists.txt
to enable it).
These are the same as regular unrealspeccyp. Good luck typing!
Use ESC to show or hide the menu. In the menu, use the arrow keys, Enter and ESC
You should use the latest develop
branch of
pico-sdk and
pico-extras.
This should work on Linux and Mac (and possibly Windows; I haven't tried).
To build, from the project root directory:
mkdir build
cd build
cmake -DPICO_SDK_PATH=path/to/pico-sdk -DPICO_BOARD=vgaboard ..
make -j4
This should work on Linux and Mac (and possibly Windows; I haven't tried).
To build:
mkdir build
cd build
cmake -DPICO_SDK_PATH=path/to/pico-sdk -DPICO_BOARD=vgaboard ..
make -j4
You need to specify PICO_EXTRAS_PATH
as well if pico-extras
isn't in a sibling directory of pico-sdk
.
Note the output binaries are in build/khan
.
You can run this on your Linux/macOS host if you have libsdl2-dev
etc. installed using the host
platform
mode of the SDK.
You need pico_host_sdl to replace the video/audio support with native.
To build:
mkdir native_build
cd native_build
cmake -DPICO_SDK_PATH=path/to/pico-sdk -DPICO_PLATFORM=host -DPICO_SDK_PRE_LIST_DIRS=/path/to/pico_host_sdl ..
make -j4
Note the output binaries are in native_build/khan
. There is no different between _usb
variants and non _usb
variants.
Not much here atm, sorry:
down
demo in kahn_turbo
sounds different on native.