Differences

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

--- proton:raspi_setup [2016/06/19 13:07] – seth
+++ proton:raspi_setup [2023/12/03 06:42] (current) – seth
@@ Line 1: / Line 1: @@
-** Experimental and for linux pros only **
+** Compiling Proton and its examples on the Raspberry Pi with OpenGL 2**
-Here is how to setup the Raspberry Pi to support normal OpenGL or GLES (both with acceleration) and be able to compile the Proton SDK examples.   (tested with Raspbian "Jessie" on 6/18/2016)
+Test with the latest Raspberry Pi OS and RetroPi as of June 9th, 2023.
-From my tests I got it working two ways:
+These should run both in the desktop GUI, or directly from bash. (Fullscreen)  I guess it's all identical to running on Ubuntu Linux/etc these days, no special stuff is needed.
-.  Set it up using the OpenGL experimental driver.  Result: Proton examples only work in X11 in windows mode.  Fullscreen (using the SDL2 harness) didn't work.  [[proton:raspi_opengl_setup|Directions to setup]]
+First, install some tools/libs you'll need:
-.  Set it up using GL ES, won't work in X11, works full screen by starting from console.  This is more useful for me as it's more pedal to the metal and easier to get 60 fps, no x overhead.  With this method we're setting up our own EGL context manually, but still using the SDL2 harness for other things
+<code bash>
+sudo apt-get install cmake zlib1g-dev
+sudo apt-get install libsdl2-2.0-0 libsdl2-dev
+</code>
-** Instructions to setup GLES with Raspberry Pi and run Proton SDK examples **
+Don't forget git!
+<code bash>
+sudo apt-get install git
+</code>
-These steps are what I use to compile stuff by copying things from my Windows computer.  A normal user would probably just grab the svn tree and run .sh files.
+Next, install Proton.
-  * Give the video card more memory on the pi.  Run raspi-config and give it at least 128 or so to be safe.
+<code bash>
-  * Install cmake on the pi (sudo apt-get install cmake)
+cd ~
-  * Do "sudo rpi-update" to make sure your firmware is updated
+git clone https://github.com/SethRobinson/proton.git
-  * Run the following from a shell:
+</code>
-<code>
+Now let's build Proton's RTPack utility, will come in handle later to build and optimize resources.
-sudo apt-get -y install xcompmgr libgl1-mesa-dri && sudo apt-get -y install libalut0 libalut-dev && sudo apt-get -y install mesa-utils
-sudo apt-get install libglu1-mesa-dev freeglut3-dev mesa-common-dev libgles2-mesa-dev libgegl-dev
+<code bash>
+cd ~/proton/RTPack/linux
+sh linux_compile.sh
 </code>
-  * Do the following from a shell window to install SDL2 from source:
+Now let's compile and run RTBareBones:
-<code>
+<code bash>
-cd ~
+cd ~/proton/RTBareBones/linux
-wget https://www.libsdl.org/release/SDL2-2.0.4.tar.gz
+sh linux_compile.sh
-tar zxvf SDL2-2.0.4.tar.gz
+cd ../bin
-cd SDL2-2.0.4 && mkdir build && cd build
+./RTBareBones
-../configure --host=armv7l-raspberry-linux-gnueabihf --disable-pulseaudio --disable-esd --disable-video-mir --disable-video-wayland --disable-video-x11 --disable-video-opengl
-make -j 5
-sudo make install
 </code>
-  * To test, type "glxgears" from a shell inside of the GUI desktop
+If that worked, enjoy the spinning triangle and text stretching!  It got 300+ fps on my Pi 4. Starting it from an ssh session worked for me as well.
+Now let's do RTSimpleApp, same thing but it needs SDL2_mixer for its audio, so let's get that installed:
-Step 2: Proton stuff
+<code bash>
+sudo apt-get install libsdl2-mixer-dev
+</code>
-  * Install linux tools for Windows, rsync and ssh should work from the command line
+Great.  Now we compile and run like before, but we're adding a step - compiling media with the RTPack utility.
-  * Setup a ssh key pair so you don't have to type passwords
-  * Edit SetupVars.bat and edit the IP to the pi
-  * Run CopyStuffToPi.bat.  There should now be a ~/proton tree on the pi
-  * Edit the RTBareBones/linux/CMakeLists.txt file and make sure OPTION(RASPBERRYPI_GLES11 OPTION(RASPBERRYPI_GLES11 "Compile for Raspberry PI GLES" ON) is uncommented and OPTION(RASPBERRYPI_OPENGL "Compile for Rasperry PI OpenGL" ON) is commented out.
-  * RTBareBones/CopyStuffToPiAndCompileLoop.bat and it should update that example and compile it in a loop
-The last step of the build copies the rtbarebones binary to /RTBareBones/bin (as that's where the media is), so go to that dir and run "./rtbarebones" and it should work.
+<code bash>
+cd ~/RTSimpleApp/linux
-RTSimpleApp is much the same, although you'll need SDL2's mixer as well.  Unlike with the base SDL2, we can just grab a pre-compiled one like this:
+sh linux_compile.sh
-<code>
+cd ../media
-sudo apt-get libsdl2-mixer-dev
+sh update_media.sh
+cd ../bin
+./RTSimpleApp
 </code>
-And that should compile ok. We don't have a mouse or anything but I can see it's running at 60 fps...
+If that worked, enjoy the app.  If it didn't... off to the forums and yell at Seth!
+=== Note from Dec 3rd, 2023 ===
+I updated things so pulseaudio is used by default instead of alsa when compiling on a pi, this fixes audio on the latest Raspberry Pi OS.  (in AudioManagerSDL.cpp)
+=== State of Proton on the Pi ===
+Hint: Using the RetroPi dist? You can edit the text file **/opt/retropie/configs/all/autostart.sh** and comment out where it runs emulationstation and change that to run your own app - or nothing at all, so it drops into the shell on boot.
+An easy way to replace the boot splash is replacing **/opt/retropie/supplementary/splashscreen/retropie-default.png**