Differences

This shows you the differences between two versions of the page.

--- systems:pico8 [2021/11/25 01:07] – forgot some configuration atari
+++ systems:pico8 [2023/01/27 03:46] (current) – [Support for official Pico-8 engine] make instructions clearer atari
@@ Line 27: / Line 27: @@
   * **Emulator:** [[#retroarch|RetroArch]]
-  * **Core:** [[#libretro_retro8|libretro/retro8]]
+  * **Core:** [[#libretro:_retro8|libretro: retro8]]
   * **Folder:** ''/userdata/roms/pico8''
   * **Accepted ROM formats:** ''.p8'', ''.png'', ''.m3u''
@@ Line 47: / Line 47: @@
 ==== RetroArch ====
-[[https://docs.libretro.com/|RetroArch]] (formerly SSNES), is a ubiquitous frontend that can run multiple "cores", which are essentially the emulators themselves. The most common cores use the [[https://www.libretro.com/|libretro]] API, so that's why cores run in RetroArch in Batocera are referred to as "libretro/(core name)". RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform.
+[[https://docs.libretro.com/|RetroArch]] (formerly SSNES), is a ubiquitous frontend that can run multiple "cores", which are essentially the emulators themselves. The most common cores use the [[https://www.libretro.com/|libretro]] API, so that's why cores run in RetroArch in Batocera are referred to as "libretro: (core name)". RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform.
 === RetroArch configuration ===
@@ Line 61: / Line 61: @@
 | **THREADED VIDEO ''pico8.video_threaded''** | Improves performance at the cost of latency and more video stuttering. Use only if full speed cannot be obtained otherwise.\\ => On ''true'', Off ''false''. |
-=== libretro/retro8 ===
+=== libretro: retro8 ===
-== libretro/retro8 configuration ==
+== libretro: retro8 configuration ==
 There is no configuration to set.
@@ Line 71: / Line 71: @@
 Starting with Batocera **v32**, you can add the official commercial Lexaloffle Pico-8 engine to run all Pico-8 games and explore the Splore universe! In order to do so, you need to do a few manual steps:
-  - Buy it from [[https://www.lexaloffle.com/games.php?page=updates|the official Lexaloffle website]]
+  - Buy it from [[https://www.lexaloffle.com/games.php?page=updates|the official Lexaloffle website]].
-  - Download the corresponding Linux (x86_64/64 bits) or Raspberry Pi binary (32bit ELF, not sure if our Rpi1/2/3 are still on 32bits systems, I could test only the PC x86_64 version at the moment and I put a message on their forum to ask for a ARM 64 bit build, like many others). Extract the files from the zip into the ''/userdata/bios/pico-8/'' directory. The files in the archive are:<code>
+  - Download the corresponding binary (it's the ZIP file) appropriate to your platform:
-    lexaloffle-pico8.png
+    * **For PC/any x86_64 board:** The Linux (x86_64/64 bits) ZIP file.
-    license.txt
+    * **For any ARM-based board, such as RPi, Odroid N2/Go/Super, RockPro64, RK3326, etc.:** the Raspberry Pi ZIP file.
-    pico-8.txt
+  - Extract the files from the zip into the ''/userdata/bios/pico-8/'' directory on your Batocera machine.
-    pico8 (make sure this one is executable via "chmod +x", I assume nobody uses a filesystem for /userdata/ that would be incompatible with this...)
+    * **For PC x86_64**, the files in the archive are:<code>
-    pico8.dat
+ lexaloffle-pico8.png
-    pico8_dyn
+ license.txt
+ pico-8.txt
+ pico8 (make sure this one is executable via "chmod +x", the filesystem itself must support the executable bit)
+ pico8.dat
+ pico8_dyn
 </code>
+    * For ARM SBC and handhelds (Raspberry Pi, Odroid, RockPro...), the files are:<code>
+ lexaloffle-pico8.png
+ license.txt
+ pico-8_manual.txt
+ pico8 (make sure this one is executable via "chmod +x", the filesystem itself must support the executable bit)
+ pico8.dat
+ pico8_64 (make sure this one is executable via "chmod +x", the filesystem itself must support the executable bit)
+ pico8_dyn
+ pico8_gpio
+ readme_raspi.txt
+</code> <WRAP center round important>
+**For ARM64-based boards**, by default the 32-bit executable is named ''pico8''. 64-bit users will want to delete the 32-bit executable and rename ''pico8_64'' as ''pico8''. Make sure it's marked as executable with ''chmod +x pico8''.
+</WRAP>
   - Copy the following ES system addition into ''/userdata/system/configs/emulationstation/es_systems_pico8.cfg'':<code xml>
 <?xml version="1.0" encoding="UTF-8"?>
@@ Line 100: / Line 117: @@
 </systemList>
 </code>
-  - Restart ES (or reboot). Then you can select **LEXALOFFLE / PICO8 OFFICIAL** as a core for Pico-8 games in ES.
+  - Restart ES (or reboot). While in the pico8 gamelist, press ''[SELECT]'', go to **ADVANCED SYSTEM OPTIONS** -> **EMULATOR** and then select "LEXALOFFLE: PICO8 OFFICIAL".
-  - If you create a file ''splore.p8'' or ''console.p8'' and launch it from Batocera-ES, you'll get access to Pico-8 splore universe with all the games to play and download from inside Pico-8 (a simple ''touch /userdata/roms/pico8/splore.p8'' is sufficient to get access to splore).
+<WRAP center round tip>
+If you create a file ''splore.p8'' or ''console.p8'' and launch it from Batocera-ES, you'll get access to Pico-8 splore universe with all the games to play and download from inside Pico-8 (a simple ''touch /userdata/roms/pico8/splore.p8'' is sufficient to get access to splore).
+Press ''[START]'' to open Pico 8's menu, which can be used to exit the emulator and return to Batocera.
+</WRAP>
 ===== Controls =====