picoarch uses libpicofe and SDL to create a small frontend to libretro cores. It's designed for small (320x240 2.0-2.4") screen, low-powered devices like the Trimui Model S (PowKiddy A66) and FunKey S.
picoarch can be run by specifying the core library and the content to run:
./picoarch /path/to/core_name_libretro.so /path/to/game.gba
If you do not specify core or content, picoarch will have you select a core from the current directory and content using the built-in file browser.
The frontend can currently be built for the TrimUI Model S, FunKey S, and Linux (useful for testing and debugging).
First, fetch the repo with submodules:
git clone --recurse-submodules https://git.crowdedwood.com/picoarch
To build picoarch itself, you need libSDL 1.2, libpng, and libasound. Different cores may need additional dependencies.
After that, make builds picoarch and all supported cores into this directory.
To build for TrimUI, you need to set up the toolchain first.
To build generic binaries:
make platform=trimui
If you want to build for MinUI, you need to install libmmenu into the toolchain. Then:
make platform=trimui MINUI=1
MINUI=1 will change save/config/system paths to match MinUI standards. If you just want to include mmenu, you can run:
make platform=trimui MMENU=1
To build for distribution:
make platform=trimui dist-gmenu
make platform=trimui MINUI=1 dist-minui
These will output a directory structure that can be moved onto the SD card into pkg/gmenunx or pkg/MinUI.
Or run
make platform=trimui picoarch.zip
To build a .zip file ready for SD card.
To build for FunKey S, you need a toolchain first, following instructions on the FunKey wiki.
To build generic binaries:
make platform=funkey-s
To build a specific core as .opk file:
make platform=funkey-s picoarch-gambatte.opk
Or run
make platform=funkey-s picoarch-funkey-s.zip
To build a .zip file containing all .opk files.
To debug:
make DEBUG=1
To build a specific supported core:
make gpsp_libretro.so
To clean a core so it will be built again:
make clean-gpsp
To completely clean the repo (will delete, pull, and patch all core repos from scratch)
make force-clean
To build profiles for profile-guided optimization:
make PROFILE=GENERATE
To apply the generated profiles:
make PROFILE=APPLY
PGO can give noticeable speed improvements with some emulators.
In order to make development and testing easier, the Makefile will pull and build supported cores.
You will have to make changes when adding a core, since TrimUI is not a supported libretro platform. picoarch has a patches/ directory containing needed changes to make cores work well in picoarch. Patches are applied in order after checking out the repository.
At a minimum, you need to add a platform=trimui section to the core Makefile if you are building for trimui.
Some features and fixes are also included in patches -- it would be best to try to upstream them.
picoarch keeps the running core name in a global variable. This is used to override defaults and core settings to work more nicely within picoarch. Overrides based on core name are kept in overrides/ and referenced in overrides.c. These are used to:
- Shorten core option text and change defaults for small screen / low power devices
- Rename buttons to match the core's system
- Reference frameskip core options to make fast-forward faster
- Display extra options or hide unnecessary options