Export translations

Settings

Group
Language
Format	Export for off-line translation Export in native format

{{DISPLAYTITLE:RPi}}<languages />
'''Attention : le support de la RPi doit être considéré comme expérimental. Soyez prêt à  affronter des problèmes si vous exécutez GIMX sur la RPi.'''

GIMX peut s'exécuter sur beaucoup de cibles GNU/Linux, et le [http://www.raspberrypi.org/ Raspberry Pi] est l'une d'entre elles !
== Considérations matérielles ==

Utiliser un HUB USB seulement si tous les ports USB sont occupés sur la RPi.<br />
Il est fortement recommandé d'utiliser un HUB avec alimentation externe.

== Firmware update ==
As early firmwares had severe USB issues it is recommended to update the firmware before using GIMX.<br />
Updating the firmware may also be useful if you plan to use a Logitech force feedback wheel (the uhid kernel module was missing in earlier firmwares).<br />
Type the following command:
<pre>sudo rpi-update
sudo reboot</pre>
If you have issues with the latest firmware, install the following instead:
<pre>sudo rpi-update 771a503cfc2a1130e2df2a4ddfc45ffa0f592b3f
sudo reboot</pre>
Tested Rpi firmware:
<pre>pi@raspberrypi ~ $ uname -a
Linux raspberrypi 4.1.21+ #873 Mon Apr 11 18:00:37 BST 2016 armv6l GNU/Linux</pre>
<!--== UHID kernel module ==

If you plan to use a Logitech force feedback wheel, you will have to build the uhid.ko module for your kernel.<br />
Install the right version of gcc, as explained here: [https://github.com/notro/rpi-source/wiki link].<br />
Update your kernel:
<pre>sudo rpi-update</pre>
In case the kernel was updated, reboot:
<pre>sudo reboot</pre>
Install the rpi-source tool:
<pre>sudo wget https://raw.githubusercontent.com/notro/rpi-source/master/rpi-source -O /usr/bin/rpi-source && sudo chmod +x /usr/bin/rpi-source && /usr/bin/rpi-source -q --tag-update</pre>
Run rpi-source:
<pre>rpi-source</pre>
This step may take a while to complete.<br />
Install ncurses:
<pre>sudo apt-get install libncurses5-dev</pre>
Enable the UHID module compilation:
<pre>cd linux
make menuconfig</pre>
Select Device Drivers>HID support>User-space I/O driver support for HID subsystem. The line should start with '<M>'.<br />
To speed up the compilation, you can disable all other modules in the HID support section and subsections.<br />
Save the config to the default location and exit.<br />
Build the module:
<pre>make prepare
make scripts
make M=drivers/hid</pre>
Install it:
<pre>sudo cp drivers/hid/uhid.ko /lib/modules/`uname -r`/kernel/drivers/hid/
sudo depmod -a</pre>-->

== USB adapter using the on-board UART interface ==

=== Matériel requis ===

The on-board UART runs at 0V/3.3V levels, and the AVR USB board has to run at 5V to operate at 16MHz (running at 3.3V would only allow to operate at 8MHz).<br />
Connecting the RPi and the AVR USB board directly may damage the hardware!<br />
One cheap solution is to use a voltage divider:<br />
* Connect both GNDs
* It's safe to connect the TXD pin of the RPi to the Rx pin of the AVR USB board (the GIMX firmwares configure the Rx pin as an input)
* To connect the Tx pin of the AVR USB board to the RXD pin of the RPi, you'll need to convert the voltage level from 0..5V to 0..3.3V.<br />
This can be done with a simple resistive divider:
<div class="image200px">[https://gimx.fr/img/wiki/Resistive_divider.png https://gimx.fr/img/wiki/Resistive_divider.png]</div>
Vin is the Tx pin of the AVR USB board, Vout is the RXD pin of the RPi, R1=2.2kΩ , R2=3.3kΩ
* Do not connect any other pin!

=== Ajustements logiciels ===

By default, the RPi UART is configured as a serial console.<br />
Disable this serial console using raspi-config:
<pre>
sudo raspi-config 
</pre>
Then select:
<pre>
"Advanced Options", "Serial", "No", "Finish"
</pre>
The default configuration does not allow high baudrates.<br />
Enable high baudrates editing /boot/config.txt:
<pre>
sudo nano /boot/config.txt
</pre>
Add the following line at the end of the file:
<pre>
init_uart_clock=8000000 
</pre>
Reboot to apply the changes:
<pre>
sudo reboot
</pre>

== GIMX installation ==
<pre>wget https://gimx.fr/download/gimx-raspbian -O gimx.deb
sudo dpkg -i gimx.deb
sudo apt-get -f install</pre>

En cas de dépendance insatisfaite, mettre à jour Raspbian :
<pre>sudo apt-get update && sudo apt-get upgrade</pre>

== Arrêt/désactivation du service triggerhappy ==
[https://github.com/wertarbyte/triggerhappy/blob/master/README Triggerhappy] est un service qui ouvre tous les périphériques en lecture et qui consomme quelques pourcent du temps CPU.

Il est conseillé de l'arrêter lorsqu'on exécute GIMX.

Pour l'arrêter :
 sudo service triggerhappy stop
Pour le désactiver :
 sudo update-rc.d triggerhappy disable

== Run GIMX ==
Read the [[Quick_Start|Quick start page]] to learn how to run GIMX through the GUI.<br />
A good idea is to run GIMX directly from a terminal, without starting a graphical session, which can be done over the network, using a ssh client, or you can [[#Autostart GIMX at boot without GUI]]<br />
Ideally, GIMX should be launched without using the Ethernet port (because it is connected on the USB bus).<br />
More details on command line options on [[Command_line|this page]].<br />

== Autostart GIMX at boot without GUI ==
Simply create a file /etc/systemd/system/gimx.service (as root) with the following content:

<pre>
[Unit]
Description=GIMX  
After=syslog.target network.target

[Service]
User=pi  
Type=simple  
ExecStart=/usr/bin/gimx -p /dev/ttyUSB0 -c LogitechDrivingForceGT_G29.xml --nograb  
Restart=always  
RestartSec=5

[Install]
WantedBy=multi-user.target
</pre>

Replace ttyUSB0 with your device and LogitechDrivingForceGT_G29.xml with your mapping file (which should be available in the pi home directory as /home/pi/.gimx/config/LogitechDrivingForceGT_G29.xml)

Run <pre>sudo systemctl daemon-reload</pre> to notify systemd about the new file and <pre>sudo systemctl enable gimx && sudo systemctl start gimx</pre> to enable the gimx service start at boot and start it in the same line.

== Notify when GIMX is running using a led ==
In order to have a proper confirmation about if the gimx service is up and running, you can add a simple python script that turns a led on if the gimx service is running.

The file will be located at /home/pi/blink.py:

<pre>
#!/usr/bin/python
import os  
import time  
import RPi.GPIO as GPIO

led = 23  
button = 18  
GPIO.setmode(GPIO.BCM)  
GPIO.setup(led, GPIO.OUT)  
GPIO.setup(button, GPIO.IN, pull_up_down = GPIO.PUD_UP)

def Shutdown(channel):  
  GPIO.output(led, True)
  time.sleep(0.2)
  GPIO.output(led, False)
  time.sleep(0.2)
  GPIO.output(led, True)
  time.sleep(0.2)
  GPIO.output(led, False)
  os.system("sudo shutdown -h now")

GPIO.add_event_detect(18, GPIO.FALLING, callback = Shutdown, bouncetime = 2000)

while True:  
  found = False
  time.sleep(5)
  pids = [pid for pid in os.listdir('/proc') if pid.isdigit()]
  for pid in pids:
    try:
      cmd = open(os.path.join('/proc', pid, 'cmdline'), 'rb').read()
      if "gimx" in cmd:
        found = True
    except IOError: # proc has already terminated
      continue
  if found == True:
    GPIO.output(led, True)
  else:
    GPIO.output(led, False)
</pre>

As a bonus, you can add a button so when it is pressed, there is a little blink effect, and the pi is shutted down.

<div class="image200px">[https://gimx.fr/img/wiki/PiButtonLed.png https://gimx.fr/img/wiki/PiButtonLed.png]</div>

To start at boot, simply add it to the pi user crontab (crontab -e) as <pre>@reboot python /home/pi/blink.py &</pre>

Export translations

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools