Differences

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

--- proton:raspi_setup [2016/06/19 12:35] – seth
+++ proton:raspi_setup [2019/01/28 09:45] – seth
@@ Line 1: / Line 1: @@
-** Experimental and for linux pros only **
+** Compiling Proton and its examples on the Raspberry Pi with GL ES **
-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)
+As a base, I started with a [[https://retropie.org.uk/download/|RetroPi image]] [[https://www.balena.io/etcher/|written]] to an SD card (tested with 4.4 on 1/28/2019) on a Raspberry 3B.  Why?  Because it comes with SDL2 pre-installed and pre configured so SDL will properly send mouse and keyboard input which saves a lot of hassle. (don't ask me why, but the version the standard stretch has on apt-get doesn't)
-From my tests I got it working two ways:
+If you REALLY want to use a standard Raspbian stretch install you can, just do these commands first to get ready:
-.  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]]
+<code bash>
+sudo apt-get install cmake
+sudo apt-get install libsdl2-2.0-0 libsdl2-dev
+</code>
-.  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
+Also, I think the GL driver needs to be set to "Legacy" to work, which is the default, but worth mentioning if you've changed it using raspi-config.
+---- End Raspbian stretch part ----
+First, make sure you gave git installed. SSH into your PI and:
+<code bash>
+sudo apt-get install git
+</code>
+Next, install Proton and compile its RTPack utility:
+<code bash>
+cd ~
+git clone https://github.com/SethRobinson/proton.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.
+Now let's build Proton's RTPack utility, will come in handle later.
-  * Give the video card more memory on the pi.  Run raspi-config and give it 128 or 256 (good for the pi3)
+<code bash>
-  * Also enable the experimental OpenGL driver under the Advanced section in raspi-config
+cd ~/proton/RTPack/linux
-  * Install cmake on the pi (sudo apt-get install cmake)
+sh linux_compile.sh
-  * Do "sudo rpi-update" to make sure your firmware is updated
+</code>
-  * Run the following from a shell:
-<code>
+Now let's compile and run RTBareBones:
-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
+<code bash>
+cd ~/proton/RTBareBones/linux
+sh linux_compile.sh
+cd ../bin
+./RTBareBones
 </code>
-  * Do the following from a shell window to install SDL2 from source:
+If that worked, enjoy the spinning triangle and text stretching!
-<code>
+Now let's do RTSimpleApp, same thing but it needs SDL2_mixer for its audio, so let's get that installed:
-cd ~
-wget https://www.libsdl.org/release/SDL2-2.0.4.tar.gz
+<code bash>
-tar zxvf SDL2-2.0.4.tar.gz
+sudo apt-get install libsdl2-mixer-dev
-cd SDL2-2.0.4 && mkdir build && cd build
-../configure --disable-pulseaudio --disable-esd --disable-video-mir --disable-video-wayland
-make -j 5
-sudo make install
 </code>
-  * To test, type "glxgears" from a shell inside of the GUI desktop
+Great.  Now we compile and run like before, but we're adding a step - compiling media with the RTPack utility.
+<code bash>
+cd ~/RTSimpleApp/linux
+sh linux_compile.sh
+cd ../media
+sh update_media.sh
+cd ../bin
+./RTSimpleApp
+</code>
-Step 2: Proton stuff
+If that worked, enjoy the app.  If it didn't... off to the forums and yell at Seth!
-  * Install linux tools for Windows, rsync and ssh should work from the command line
-  * 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_OPENGL "Compile for Raspi 3 OpenGL" ON)" is uncommented
-  * 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.
+=== State of Proton on the Pi ===
+  - It runs fullscreen only both in or out of the desktop environment
+  - If SDL isn't compiled a certain way, mouse and keyboard won't work right. (use the RetroPi dist!)
+  - Even though mouse and keyboard can work, there is no mouse cursor, you'd need to draw it yourself
+  - Video acceleration works, audio works (see my [[https://www.youtube.com/watch?v=bk6jVk7t4i4|Atari PaperCart project]])
+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.