View source for RaceCapture on Raspberry Pi

=Introduction=

We designed the RaceCapture app to run nearly anywhere - even a Raspberry Pi. And now, for about $100 you can create a hardwired, dedicated dash for your RaceCapture system. 

[[image:racecapture_raspberry_pi.jpg|1024px]]

==Benefits==
You get all of the benefits of a dedicated dash:
* '''Automatically runs upon power up''' - you can configure the dash to automatically launch the RaceCapture App - just as you'd expect it to work.
* '''Hard-wired data connection to RaceCapture''' - no wireless connections to configure, with the reliability of a direct wire.
* '''Runs on the bare metal''' - The RaceCapture app runs without Android or iOS; there's no other apps competing for resources, or compromising system stability. 
* '''Overheating resistance''' -  Your typical mobile device requires extra care in very hot weather to prevent damage to it's internal battery, and will shut down if overheated. With proper heat-sinking, the Raspberry Pi should handle the heat.

==Compatibility==
The RaceCapture app running on the Raspberry Pi is compatible with any hardware version of RaceCapture or PodiumConnect. 

[[image:racecapture_raspberry_pi_backside.jpg|1024px]]

==Experimental!==
While the results are pretty great, these instructions are ''currently'' for those adventurous race car hackers who know their away around a command line, comfortable working with hardware and want to dig in.  '''Think it's cool, but too much to tackle?''' Rope in your nearest computer/electronics geek - you need one on your race team, anyway. :)  '''Or, just use the plug and play option''' and use an Android or iOS device via Bluetooth or WiFi.

==Current status and future plans==
Even though this is brand new and officially experimental in nature, we still made it as easy as reasonably possible: we wrapped up the RaceCapture App into as close to a self-running installer, that can run on a bone stock Raspberry Pi image - only a few changes are required to the default image, detailed below.

'''However''', in the near future we will create a dedicated Raspberry Pi image that you can burn to an SD card and simply boot up, and move towards more official support as we iron out the issues. 


===Reporting issues and getting support===
Chances are you'll encounter an issue you'll want to report. Before you do that, [https://github.com/autosportlabs/RaceCapture_App/issues?q=is%3Aopen+is%3Aissue+label%3A%22raspberry+pi%22 check the issue log] to see if it's already known.

Otherwise - the best place for support, feedback and sharing success stories is [http://forum.autosportlabs.com on the  forums] .  Drop us a note there so we can see the progress of your project!

=Hardware Selection=
===Raspberry Pi===
We recommend the Raspberry Pi 4 2GB and higher for best performance and support.

===Display===
The RaceCapture app package is designed to recognize the following screens:

* [https://www.raspberrypi.org/products/raspberry-pi-touch-display/ Official Raspberry Pi display] with capacitive touch screen;
* Displays supporting the AR1100 resistive touch screen controller.  


Other displays can work as well, and additional work may be needed to support the screen's touch controller. If unsure, just pick the [https://www.raspberrypi.org/products/raspberry-pi-touch-display/ Official Raspberry Pi display]
===Enclosure===
A recommended enclosure is the [http://https://www.amazon.com/dp/B01HV97F64 Smart Pi Touch Case]

You can 3D print a sun shade for this enclosure  [[file:P001 Raspberry Pi Display Sun Shade.stl.zip|download the .stl file]] (''Courtesy of Michael Lee'')

[[image:SmartPi_touch_case.jpg|400px]] [[image:RaceCapture_Sun_shade_3dprinted_preview.jpg|400px]]

[[image:RaceCapture_RaspberryPi_sun_shade_dashboard.jpg|800px]]

Installed on Dashboard

===Power Supply===
The Raspberry Pi dashboard requires its own power supply.  You'll need a high quality 5v power supply with 2 amps minimum capacity; 3 amps is highly recommended, and ideally one with a low drop out voltage, so power is not cut to the Raspberry Pi when you're loading the main battery, such as when cranking the engine.

'''Suggested Power Supplies'''
* [https://www.amazon.com/Jabinco-LM2596-Converter-3-0-40V-1-5-35V/dp/B0817P8BGB/ Buck Converter based on the LM2596]

====Powering RaceCapture====
After you have power to the Raspberry Pi dashboard, you may notice your RaceCapture device will be powered by the USB cable connected to the Pi, just as if you're powering RaceCapture from your laptop.  '''You will still want to power your RaceCapture via 12v'''; see the respective installation guides for information on how to power your device.

===Heat sinking===
If you're running in hot weather, we recommend the standard Raspberry Pi heatsink kit to keep your system cool.

For Pi4 users, we recommend active fan cooling in addition to the heat sink.

=Installation=
==Installing Rasbian OS==
At the moment we recommend Buster Lite - problems have been reported with later versions. 

Download from [https://www.raspberrypi.org/downloads/raspbian/ download from the official site] and follow the instructions for burning to an SD card. 

Once you've created your image, boot up your Raspberry Pi and log in with the default username of 'pi' and password 'raspberry'.

===Updating to latest packages===
It is always good form to update the latest packages after a fresh install. Enter this at the command line:
<pre>
sudo apt-get update
sudo apt-get dist-upgrade
</pre>

==Raspberry Pi support==
The RaceCapture app is compatible with Raspberry Pi 4 and 3.


===Enable GPU driver===
Enable Fake KMS under advanced boot options:

<pre>
sudo raspi-config
</pre>

Go to Advanced Options -> GL Driver -> Select OpenGL desktop driver with fake KMS

* Be sure to reboot after exiting raspi-config

==Installing dependencies==
===Activate ssh===
Ssh is used to store passwords used by the app. Steps to ensure it is running:

<pre>
sudo raspi-config
</pre>
Go under Interfacing Options or Advanced Options and start the ssh service. 

Next, at the command prompt enter
<pre>
ssh-add
</pre>
to create at least one key.

===Install package dependencies===
<pre>
sudo apt-get install mesa-utils libgles2 libegl1-mesa libegl-mesa0
</pre>
===Change the default password===
For maximum security, change the password for the default user 'pi'

<pre>
> passwd
</pre>

and specify a new, secure password.

===Configure Raspberry Pi base settings===
====Enable Hardware rendering====
Enter the following line to enable hardware accelerated rendering.
<pre>
> sudo adduser pi render
</pre>
* '''Notes''':
** Without this setting, UI rendering will be extremely slow.
** Assumes RaceCapture is launched as pi. If not, replace pi with the user you are logging in as.
** If you're coming in to fix this after the fact, you'll need to reboot/re-login to take effect.

====Enable WiFi====
If you want network capability in addition to the ethernet connection, [https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md enable and configure WiFi per the official documentation]

====(Optional) Enable SSH====
You can optionally enable SSH for remote management from the comfort of your main computer's keyboard and screen. 

[https://www.raspberrypi.org/documentation/remote-access/ssh/ Enable and configure ssh per the official documentation]

====Install multi-touch tools====
Install the packages that enable multi-touch interfaces.  Enter the following at the command line:

<pre>
> sudo apt-get install mtdev-tools
</pre>

====Configure memory split====
You'll need to bump up the memory made available to the GPU. Increase the default value of 64 to '''256'''.

* '''Via raspi-config tool'''
You can adjust the memory split by running the raspi-config tool. See the [https://www.raspberrypi.org/documentation/configuration/raspi-config.md official documentation]

* '''Editing /boot/config.txt'''

You can adjust the value directly by editing the /boot/config.txt file. 

<pre>
> sudo nano /boot/config.txt
</pre>

Find the line containing gpu_mem=64 and change the number to 256

<pre>
gpu_mem=256
</pre>

''Save the file by pressing '''ctrl-x''' then  press '''Y'''  to confirm.''

==Installing the RaceCapture app package==

Download the latest [http://podium.live/software RaceCapture app package for Raspberry Pi] and place it in the /opt/ directory of the Raspberry Pi.

* '''Directly downloading to the Raspberry Pi'''
You can download it directly by getting the URL of the package by right-clicking the download link and copying the URL to your clipboard. Then, use it in the command below:

<pre>
cd /opt
sudo wget <package URL>
</pre>

===Extract the package===
Now extract the downloaded package :

<pre>
sudo tar -xjvf <downloaded file>
</pre>

===Launch the app===
Launch the RaceCapture app by running the following command:

<pre>
/opt/racecapture/run_racecapture.sh
</pre>

===Launching with Watchdog===
You can enable an automatic watchdog that re-launches the app in case a crash occurs. 

<pre>
/opt/racecapture/run_racecapture.sh -w 1
</pre>


* '''Note:''' You can break out of the application by issuing '''Alt + PrntScn + k''' to the application. 

You can further stop all racecapture processes by issuing the following command (e.g. via ssh)
<pre>
killall -9 run_racecapture
</pre>

===Enabling on screen keyboard===
If you don't have a wireless keyboard attached via usb, you can enable an on-screen keyboard.

Edit the kivy config.ini file with:
<pre>
sudo nano ~/.kivy/config.ini
</pre>

and update the keyboard_mode line with:

keyboard_mode = multi

==Automatic start upon power up==
To get the full dedicated dashboard experience, you can enable automatic launch of the RaceCapture app upon power up. 

To do this, edit the system's startup file:

<pre>
sudo nano /etc/rc.local
</pre>

and add the following line '''before the exit 0''' line.

<pre>
/opt/racecapture/boot_racecapture.sh pi

exit 0
</pre>

''Save the file by pressing '''ctrl-x''' then  press '''Y'''  to confirm.''

=Connecting to your RaceCapture system=
[[image:racecapture_raspberry_pi_connections.jpg|900px]]
===Powering up===
* Connect the power to your display and power up. 
* Connect your RaceCapture/Pro or RaceCapture/Track to the Raspberry Pi using the USB cable.  

* Launch the RaceCapture app by running:

<pre>
/opt/racecapture/run_racecapture.sh
</pre>

If you have it set to launch automatically, simply let it start upon power-up.

===Connection and usage===

Once the RaceCapture App is running, it will connect automatically over USB.  You can use the app just as you would on Android or iOS.

=Extra Features=

===Hardwire buttons===

The RaceCapture app responds to keyboard commands for certain behaviors. You can use a USB keyboard - or a device that emulates keyboard commands - to control the RaceCapture App.

Currently there are keyboard commands for the following:
* '''Navigating dashboard screens'''  - Use the left and right arrow keys to switch between screens
* '''Escaping from screens / menus''' - The Escape key can be used to exit out of screens and options, just like the 'back' button on Android.
* '''Acknowledging alerts''' - Use the following keys to acknowledge alerts, including responding to pit-to-car alerts:
** K : to indicate 'Yes' or 'OK'
** N : to indicate 'No"


=Additional Tips=
See this link for additional tips on how to setup the Pi and speed up the boot times.  This should be especially helpful for beginners.

https://wiki.autosportlabs.com/Raspberry_Pi_Tips