Files
captain-amygdala.pistorm/platforms/amiga/rtg
Andrew Hutchings ff69e7de23 Add symlinks for PiGFX Files directory
Some users are trying to run the PiGFX from git, this won't work without
the Files directory so I've recreated it just for them using symlinks.
2021-07-10 15:46:44 +01:00
..
2021-06-08 10:04:27 +02:00
2021-06-06 07:30:21 +01:00
2021-05-11 14:17:12 +02:00
2021-06-08 11:13:29 +02:00

PiGFX/PiStorm RTG driver for Amiga

A reasonably complete RTG driver for the PiStorm, compatible with P96 2.4 and above.

While it's not intended to be incompatible with the free Picasso96 available on AmiNet, there appears to be some issues with resolution switching among other things with it at the time of writing this.

The driver has support and acceleration for all common P96 features except for screen dragging hardware mouse cursor. Hardware mouse cursor is planned, but screen dragging... not at present, as it would require uploading two full screen size textures every single frame.

Some familiarity with P96 and AmigaOS is currently required, as you have to edit a Monitor file and create a Picasso96Settings file for the available resolutions.

(RTG video output is over the Raspberry Pi HDMI.)

Note: The RTG has been rewritten to use raylib instead of SDL. Precompiled raylib libraries are included, there is no need to install any additional dependencies when building the emulator.
For raylib to work in the console on a Pi 3, the OpenGL driver must not be enabled. If you have the line dtoverlay=vc4-kms-v3d enabled for your system setup in /boot/config.txt, either comment it out or remove the line.
If you are for some reason wanting to test the RTG on a Raspberry Pi 4, you are on your own. Not only can't I test it, you must also install a distro with some flavor of X window manager for it to perform well at all.

Instructions

Setup for PiGFX/PiStorm RTG is not entirely straightforward, unlike PiSCSI some files need to be transferred to the Amiga side. Here are the steps required to get PiStorm RTG up and running:

  • Install P96/Picasso96 on the Amiga side. Aminet Picasso96 requires at least Kickstart 2.05 (2.0?) and P96 2.4+ requires at least Kickstart 3.1 and a 68020 processor.
  • Select any graphics driver you want from the list of available ones in the installer, you will need to edit the tooltypes for the Monitor file it installs to load the PiGFX driver instead, something like the Picasso IV or CyberVision 64/3D is recommended for the other tooltypes to match up.
  • Grab pigfx020.card from the rtg_driver_amiga directory and copy it to the drawer LIBS:Picasso96 on the Amiga.
  • Edit the tooltypes for Monitor file you installed to load pigfx020.card instead, this will initialize the PiGFX driver on boot. You can also move the Monitor file out of the DEVS:Monitors driver and double click it from elsewhere to load the driver manually if so desired.
  • Once you've rebooted and loaded the PiGFX driver, launch Picasso96Mode from the Prefs drawer on your system volume, select PiStorm RTG from the list of boards and add the resolutions you want/need to the list.
  • Open ScreenMode in the Prefs drawer on your system volume and select the video mode you want, or launch an RTG game/application.
  • Enjoy! (Maybe... if it works...)