GIMX - User contributions [en]

RPi

2016-02-07T13:51:48Z

Maxaille:

<languages />
<translate>

'''Warning: RPi support should be considered as experimental. Be prepared to face issues if you try GIMX on the RPi.'''

GIMX can run on many Linux targets, and the [http://www.raspberrypi.org/ the Raspberry Pi] is one of them!
== Tested setup == 
* Raspberry Pi: model B, 256MB
* Distro: [http://www.raspberrypi.org/downloads Raspbian Jessie] (2015-09-24)
* '''Self-powered USB hub''': Belkin 7 ports F4U017 (self-powered = with an external power supply)
* Keyboard: n25te plugged on the USB hub
* Mouse: Logitech G500 plugged on the USB hub
* PS3: FAT - FW 4.41


* Bluetooth dongle: Pluscom BT20 (CSR Bluecore4-rom) plugged on the USB hub


* DIY USB adapter: Teensy 2.0 + CP2102 plugged on the USB hub

== Firmware update == 
As early firmwares had severe USB issues it is recommended to update the firmware before using GIMX. 
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). 
Type the following command:
<pre>sudo rpi-update</pre>
And don't forget to reboot:
<pre>sudo reboot</pre>
Tested Rpi firmware:
<pre>pi@raspberrypi ~ $ uname -a
Linux raspberrypi 4.1.9+ #819 PREEMPT Thu Oct 1 20:31:26 BST 2015 armv6l
GNU/Linux</pre>

If you plan to use a Logitech force feedback wheel, you will have to build the uhid.ko module for your kernel. 
Install the right version of gcc, as explained here: [https://github.com/notro/rpi-source/wiki link]. 
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. 
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>'. 
To speed up the compilation, you can disable all other modules in the HID support section and subsections. 
Save the config to the default location and exit. 
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>-->


== GIMX installation == 
<pre>sudo apt-get install gdebi
wget http://gimx.fr/download/gimx-raspbian -O gimx.deb
sudo gdebi gimx.deb</pre>


If you get a "Dependency is not satisfiable: ..." error message, upgrade Raspbian:
<pre>sudo apt-get update && sudo apt-get upgrade</pre>

== Stop/disable triggerhappy service == 
[https://github.com/wertarbyte/triggerhappy/blob/master/README Triggerhappy] is a daemon that opens every input device for reading, and that consumes a few percent of the CPU time.


It seems a good idea to stop it while running GIMX.


To stop triggerhappy:
sudo service triggerhappy stop
To disable triggerhappy:
sudo update-rc.d triggerhappy disable

== Run GIMX == 
Read the [[Quick_Start|Quick start page]] to learn how to run GIMX through the GUI. 
A good idea is to run GIMX directly from a terminal, without starting a graphical session. 
This can be done over the network, using a ssh client. 
Ideally, GIMX should be launched without using the Ethernet port (because it is connected on the USB bus). 
More details on command line options on [[Command_line|this page]]. 
=== Bluetooth ===
In a terminal:
gimx -t Sixaxis -c <config file> -b <PS3 bdaddr>
The dongle address has to be changed before running the above commands.

=== DIY USB adapter === 
In a terminal:
gimx -c <config file> -p /dev/<ttyUSB port>

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

==== Hardware requirements ====

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). 
Connecting the RPi and the AVR USB board directly may damage the hardware! 
One cheap solution is to use a voltage divider: 
* 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. 
This can be done with a simple resistive divider:
<div class="image200px">[http://gimx.fr/img/wiki/Resistive_divider.png http://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!

=== Without DIY USB adapter === 

====RPi preparation==== 


This manipulation is compatible with:
Raspberry Pi A+
Raspberry Pi B
Raspberry Pi B+
Raspberry Pi 2
Raspberry Pi Zero


By default, the RPi send debug messages on the UART port. To use it for GIMX, we should execute:
<pre>
sudo raspi-config
</pre>
Then select:
<pre>
"Advanced Options", "Serial", "No", "Finish"
</pre>
We should now change the baudrate from 3MHz to 8MHz:
<pre>
sudo nano /boot/config.txt
==========================
init_uart_clock=8000000
</pre>
We will now install GIMX:
<pre>
sudo apt-get install gdebi
wget http://gimx.fr/download/gimx-raspbian -O gimx.deb
sudo gdebi gimx.deb
sudo service triggerhappy stop
sudo update-rc.d triggerhappy disable
sudo reboot
</pre>
If there is no X server running after reboot, execute:
<pre>
startx
</pre>
And we will bind AMA0 to the USB port
<pre>
sudo ln -s /dev/ttyAMA0 /dev/ttyUSB0
</pre>

==== Схема подключения ==== 
Данная схема работает только у меня!!!
Как сказал автор опасно применять схему, из за 5 вольт на UART Teensy возможно это можно решить прошивкой... 
Либо делителем описание тут [http://gimx.fr/forum/viewtopic.php?p=4485#p4485] 
</translate>

RPi

2016-02-07T13:30:49Z

Maxaille:

<languages />
<translate>

'''Warning: RPi support should be considered as experimental. Be prepared to face issues if you try GIMX on the RPi.'''

GIMX can run on many Linux targets, and the [http://www.raspberrypi.org/ the Raspberry Pi] is one of them!
== Tested setup == 
* Raspberry Pi: model B, 256MB
* Distro: [http://www.raspberrypi.org/downloads Raspbian Jessie] (2015-09-24)
* '''Self-powered USB hub''': Belkin 7 ports F4U017 (self-powered = with an external power supply)
* Keyboard: n25te plugged on the USB hub
* Mouse: Logitech G500 plugged on the USB hub
* PS3: FAT - FW 4.41


* Bluetooth dongle: Pluscom BT20 (CSR Bluecore4-rom) plugged on the USB hub


* DIY USB adapter: Teensy 2.0 + CP2102 plugged on the USB hub

== Firmware update == 
As early firmwares had severe USB issues it is recommended to update the firmware before using GIMX. 
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). 
Type the following command:
<pre>sudo rpi-update</pre>
And don't forget to reboot:
<pre>sudo reboot</pre>
Tested Rpi firmware:
<pre>pi@raspberrypi ~ $ uname -a
Linux raspberrypi 4.1.9+ #819 PREEMPT Thu Oct 1 20:31:26 BST 2015 armv6l
GNU/Linux</pre>

If you plan to use a Logitech force feedback wheel, you will have to build the uhid.ko module for your kernel. 
Install the right version of gcc, as explained here: [https://github.com/notro/rpi-source/wiki link]. 
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. 
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>'. 
To speed up the compilation, you can disable all other modules in the HID support section and subsections. 
Save the config to the default location and exit. 
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>-->


== GIMX installation == 
<pre>sudo apt-get install gdebi
wget http://gimx.fr/download/gimx-raspbian -O gimx.deb
sudo gdebi gimx.deb</pre>


If you get a "Dependency is not satisfiable: ..." error message, upgrade Raspbian:
<pre>sudo apt-get update && sudo apt-get upgrade</pre>

== Stop/disable triggerhappy service == 
[https://github.com/wertarbyte/triggerhappy/blob/master/README Triggerhappy] is a daemon that opens every input device for reading, and that consumes a few percent of the CPU time.


It seems a good idea to stop it while running GIMX.


To stop triggerhappy:
sudo service triggerhappy stop
To disable triggerhappy:
sudo update-rc.d triggerhappy disable

== Run GIMX == 
Read the [[Quick_Start|Quick start page]] to learn how to run GIMX through the GUI. 
A good idea is to run GIMX directly from a terminal, without starting a graphical session. 
This can be done over the network, using a ssh client. 
Ideally, GIMX should be launched without using the Ethernet port (because it is connected on the USB bus). 
More details on command line options on [[Command_line|this page]]. 
=== Bluetooth ===
In a terminal:
gimx -t Sixaxis -c <config file> -b <PS3 bdaddr>
The dongle address has to be changed before running the above commands.

=== DIY USB adapter === 
In a terminal:
gimx -c <config file> -p /dev/<ttyUSB port>

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

==== Hardware requirements ====

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). 
Connecting the RPi and the AVR USB board directly may damage the hardware! 
One cheap solution is to use a voltage divider: 
* 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. 
This can be done with a simple resistive divider:
<div class="image200px">[http://gimx.fr/img/wiki/Resistive_divider.png http://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!

=== Without DIY USB adapter (RU) === 

====RPi preparation==== 


This manipulation is compatible with:
Raspberry Pi A+
Raspberry Pi B
Raspberry Pi B+
Raspberry Pi 2
Raspberry Pi Zero


By default, the RPi send debug messages on the UART port. To use it for GIMX, we should execute:
<pre>
sudo raspi-config
</pre>
Then select:
<pre>
"Advanced Options", "Serial", "No", "Finish"
</pre>
We should now change the baudrate from 3MHz to 8MHz:
<pre>
sudo nano /boot/config.txt
==========================
init_uart_clock=8000000
</pre>
We will now install GIMX:
<pre>
sudo apt-get install gdebi
wget http://gimx.fr/download/gimx-raspbian -O gimx.deb
sudo gdebi gimx.deb
sudo service triggerhappy stop
sudo update-rc.d triggerhappy disable
sudo reboot
</pre>
If there is no X server running after reboot, execute:
<pre>
startx
</pre>
And we will bind AMA0 to the USB port
<pre>
sudo ln -s /dev/ttyAMA0 /dev/ttyUSB0
</pre>

==== Схема подключения ==== 
Данная схема работает только у меня!!!
Как сказал автор опасно применять схему, из за 5 вольт на UART Teensy возможно это можно решить прошивкой... 
Либо делителем описание тут [http://gimx.fr/forum/viewtopic.php?p=4485#p4485] 
</translate>