|
|
(186 intermediate revisions by 6 users not shown)
|
Line 1: |
Line 1: |
| <languages /> | | <languages /> |
− | <translate><!--T:11--> | + | <translate> |
− | Welcome on the GIMX wiki!<br /> | + | <!--T:88--> |
− | Feel free to create an account and to contribute!<br /> | + | {{Deprecated}} |
| + | |
| + | <!--T:11--> |
| + | Welcome to the GIMX wiki!<br /> |
| + | Feel free to create an account and contribute!<br /> |
| Check [[Translate|this page]] for translation instructions. | | Check [[Translate|this page]] for translation instructions. |
| | | |
− | <!--T:12--> | + | ==About GIMX== <!--T:13--> |
− | The documentation is slowly moving from [http://gimx.fr/forum/viewforum.php?f=4 the forum], to this wiki.</translate>
| |
| | | |
− | ==<translate><!--T:13-->
| + | <!--T:14--> |
− | About GIMX</translate>==
| + | GIMX stands for Game Input MultipleXer or Game Input MatriX. The purpose of this free software is to control a video game console with a computer (e.g. a PC or a [http://www.raspberrypi.org/ Raspberry Pi]). It works with the PS3, the Xbox 360, the PS4 and the Xbox One.<br /> |
− | | |
− | <translate><!--T:14-->
| |
− | GIMX stands for Game Input MultipleXer or Game Input MatriX. The purpose of this software is to control a video game console with a PC. It works with the PS3 and there is experimental support for the Xbox 360. | |
| | | |
| <!--T:15--> | | <!--T:15--> |
| It operates: | | It operates: |
− | * over bluetooth: works with Linux (PS3) only. A compatible bluetooth dongle is required. | + | * over bluetooth: works with GNU/Linux (PS3, PS4) only. A compatible bluetooth dongle is required. A USB development board such as a Teensy 2.00 is required for pairing the bluetooth dongle with the PS4. |
− | * over usb: works with Linux (PS3, 360) and Windows (PS3). A DIY USB adapter is required. | + | * over usb: works with GNU/Linux and Windows (PS3, PS4, 360, XOne). A USB adapter is required. |
| | | |
| <!--T:16--> | | <!--T:16--> |
− | The application gets data from the PC peripherals (mice, keyboards and joysticks) and sends controls to the PS3 over bluetooth or usb.<br/> | + | The application gets data from the peripherals (mice, keyboards and joysticks) and sends controls to the console over bluetooth or usb.<br /> |
− | Other controls such as gesture or voice are possible through the use of external software that emulate PC peripherals. | + | Other controls such as gesture or voice are possible through the use of external software that emulate peripherals. |
| | | |
| <!--T:17--> | | <!--T:17--> |
| GIMX features are further described on the [[Features|Features page]]. | | GIMX features are further described on the [[Features|Features page]]. |
| + | |
| + | <!--T:60--> |
| + | Compatibility issues are listed on the [[Compatibility|Compatibility page]]. |
| | | |
| <!--T:18--> | | <!--T:18--> |
− | The source code of GIMX is available under the [http://www.gnu.org/copyleft/gpl.html GPLv3] [http://code.google.com/p/diyps3controller/source/checkout there]. | + | The source code of GIMX is available under the [https://www.gnu.org/copyleft/gpl.html GPLv3] [https://gimx.fr/source here]. |
| | | |
| <!--T:19--> | | <!--T:19--> |
− | There's also a [http://blog.gimx.fr/ blog] with a few posts about the GIMX development, and a [http://forum.gimx.fr support forum]. | + | There's also a [https://blog.gimx.fr/ blog] with a few posts about the GIMX development, and a [https://forum.gimx.fr support forum]. |
| | | |
| <!--T:20--> | | <!--T:20--> |
Line 37: |
Line 40: |
| ==Hardware requirements== <!--T:21--> | | ==Hardware requirements== <!--T:21--> |
| | | |
− | <!--T:22--> | + | ===Computer=== <!--T:22--> |
− | '''PC'''<br/>
| + | |
− | GIMX is designed to run on a PC with Ubuntu or Windows. This is a strong requirement.<br/> | + | <!--T:68--> |
− | GIMX can probably run with minor adaptations on smaller targets such as the Raspberry pi or Thin clients running a small Linux distro. | + | <div class="mw-collapsible mw-collapsed"> |
| + | |
| + | <!--T:69--> |
| + | GIMX is designed to run on a computer running Ubuntu-based GNU/Linux distributions or Windows (7 or later). '''This is a strong requirement'''.<br /> |
| + | GIMX can run on smaller targets such as the [https://en.wikipedia.org/wiki/Raspberry_Pi Raspberry Pi] or Thin clients running a small Linux distro. |
| | | |
| <!--T:23--> | | <!--T:23--> |
− | About Ubuntu:<br/> | + | '''About Ubuntu and Raspbian''':<br /> |
− | :The currently supported version is [http://releases.ubuntu.com/11.10/ 11.10] (do not use version 12.04 for bluetooth, it makes GIMX lag).<br/> | + | :The only supported versions are [http://releases.ubuntu.com/16.04/ Ubuntu 16.04] and [https://www.raspberrypi.org/downloads/raspbian/ Raspbian Stretch], to use with [https://gimx.fr/downloads latest GIMX].<br /> |
− | :Running GIMX in a virtual machine (vmware, virtualbox...) is NOT OFFICIALY supported (no help will be given for that).<br/> | + | :It's also possible to use Ubuntu derivates such as [http://www.linuxmint.com/download.php Linux Mint].<br /> |
− | :It's possible to run Ubuntu from a live usb disk (nothing is saved on the hard drive).<br/> | + | :Running GIMX in a virtual machine (vmware, virtualbox...) '''is NOT OFFICIALY supported''' (no help will be given for that).<br /> |
− | :Feel free to install Ubuntu on your PC! If you have a Windows OS installed, you can [https://help.ubuntu.com/community/WindowsDualBoot read this page] if you want to install Ubuntu on your hard drive without erasing the Windows OS.<br/> | + | :It's possible to run Ubuntu from a live usb disk (nothing is saved on the hard drive).<br /> |
− | :Another way to use the GIMX is to run it from a Ubuntu [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/ Live USB Persistent Flash Drive]. | + | :Feel free to install Ubuntu on your computer! If you have a Windows OS installed, you can [https://help.ubuntu.com/community/WindowsDualBoot read this page] if you want to install Ubuntu on your hard drive without erasing the Windows OS.<br /> |
| + | :Another way to use GIMX is to run it from a Ubuntu [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/ Live USB Persistent Flash Drive]. |
| + | |
| + | <!--T:70--> |
| + | </div> |
| + | |
| + | ===Connector=== <!--T:71--> |
| + | |
| + | <!--T:72--> |
| + | <div class="mw-collapsible"> |
| + | |
| + | ====Bluetooth dongle==== <!--T:24--> |
| + | |
| + | <!--T:73--> |
| + | <div class="mw-collapsible mw-collapsed"> |
| + | |
| + | <!--T:74--> |
| + | :OS compatibility: Ubuntu-based GNU/Linux distributions only (there is no appropriate access to the bluetooth stack on Windows).<br /> |
| + | |
| + | <!--T:65--> |
| + | :Using a bluetooth dongle or an internal bluetooth module, GIMX can emulate the following controllers: |
| + | :*Dualshock 3, for PS3 |
| + | :*Dualshock 4, for PS4 |
| + | :While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common. Check the [[Bluetooth_dongle|compatibility list]]. |
| + | :For PS4 only: |
| + | :*A genuine Dualshock 4 controller is required because GIMX has to authenticate to the PS4. |
| + | :*An AVR USB board such as the Teensy 2.0 is also required for the bluetooth pairing procedure. |
| + | |
| + | <!--T:75--> |
| + | </div> |
| + | |
| + | ====USB adapter==== <!--T:25--> |
| + | |
| + | <!--T:76--> |
| + | <div class="mw-collapsible"> |
| + | |
| + | <!--T:87--> |
| + | :OS compatibility: Ubuntu-based GNU/Linux distributions and Windows (7 or later).<br /> |
| | | |
− | <!--T:24--> | + | =====GIMX adapter===== <!--T:77--> |
− | '''[[Bluetooth_dongle|Bluetooth dongle]]'''<br/>
| + | :This is an adapter that you can either build yourself or buy from the GIMX shop: |
− | GIMX can emulate a sixaxis using a bluetooth dongle or an internal bluetooth module.<br/>
| + | :* [[DIY_USB_adapter|Build yourself a GIMX adapter]] |
− | This obviously only works with the PS3.<br/>
| + | :* '''[https://blog.gimx.fr/product/gimx-adapter/ Buy a ready to use GIMX adapter from the official GIMX shop.]''' |
− | This doesn't work with Windows because there is no appropriate access to the bluetooth stack.<br/>
| + | <!-- |
− | While all bluetooth dongles/modules can't work with GIMX, working dongles are quite common.<br/>
| + | Matlo 2017-03-30: |
− | Check the [[Bluetooth_dongle|compatibility list]].
| + | Links to third party adapters won't be allowed from now. |
| + | Third party adapters add workload, especially more questions on the forum, which tends to slow down the GIMX development. |
| + | The official GIMX shop generates some revenue to the GIMX creator and helps keeping up the GIMX development. |
| + | --> |
| + | :With a GIMX adapter, the following emulations are available: |
| + | :{{Firmwares/en}} |
| + | :All Logitech wheel emulations have [[Force_Feedback|force feedback support]]. |
| + | :{{Third_party_adapters}} |
| + | :Notes: |
| + | ::Forget about using any other USB to USB cable (like file transfer cables, or direct cables), they are not suited to this use.<br /> |
| + | ::For 360: a genuine wired 360 controller is required because the USB adapter has to authenticate to the console. A wireless 360 controller with a play and charge kit will NOT work. |
| + | ::For PS4: a genuine Dualshock 4 controller is required because GIMX has to authenticate to the console. |
| + | ::For Xbox One: a genuine Xbox One controller is required because GIMX has to authenticate to the console. Controllers with the 3.5mm jack are not supported yet. |
| | | |
− | <!--T:25--> | + | =====Titan One===== <!--T:67--> |
− | '''[[DIY_USB_adapter|Do-It-Yourself USB adapter]]'''<br/> | + | :GIMX can also emulate a '''gamepad''' (not a wheel) using a [http://www.consoletuner.com/ Titan One] (formerly known as GamepadProxy/Cronus/CronusMax). The Titan One can work with the PS3, the Xbox 360, the Xbox One, and the PS4.<br /> |
− | GIMX can emulate a joystick (for PS3) or a wired 360 pad, using a specific [[DIY_USB_adapter|Do-It-Yourself USB adapter]].<br/>
| |
− | Forget about using any other USB to USB cable (like file transfer cables, or direct cables), they are not suited to this use.<br/>
| |
− | For 360 only: a genuine wired 360 controller is required because the DIY USB adapter has to authenticate to the 360.
| |
| | | |
− | <!--T:26--> | + | <!--T:78--> |
− | '''Gaming mouse'''<br/>
| + | </div> |
− | If you want to play console FPS games with a mouse, forget about using a mouse with anything less than 2000DPI and 250Hz.<br/> | + | </div> |
− | A gaming mouse with 5000+ DPI and running at 500Hz is highly recommended.<br/> | + | |
− | Whereas a gaming mouse with more than 1600 DPI doesn't really make a difference on a PC, it's not the case with GIMX.<br/> | + | ===Gaming mouse=== <!--T:26--> |
− | GIMX can decelerate mouse movements so as to counteract the in-game acceleration.<br/> | + | |
| + | <!--T:79--> |
| + | <div class="mw-collapsible mw-collapsed"> |
| + | |
| + | <!--T:80--> |
| + | If you want to play console FPS games with a mouse, forget about using a mouse with anything less than 2000DPI and 250Hz.<br /> |
| + | A gaming mouse with 5000+ DPI and running at 500Hz is highly recommended.<br /> |
| + | Whereas a gaming mouse with more than 1600 DPI doesn't really make a difference on a computer, it's not the case with GIMX.<br /> |
| + | GIMX can decelerate mouse movements so as to counteract the in-game acceleration.<br /> |
| A high DPI mouse gives a better linearity (i.e. smoother movements) in this specific case. | | A high DPI mouse gives a better linearity (i.e. smoother movements) in this specific case. |
| + | |
| + | <!--T:89--> |
| + | '''''Tip''''': ''Some mouse may introduce interpolation on higher DPI settings. This is due to the mouse sensor not supporting higher DPI and mouse software have to emulate it. Try to avoid interpolation by setting your DPI to the highest supported by mouse hardware value.'' |
| + | |
| + | <!--T:81--> |
| + | </div> |
| | | |
| ==Tutorials== <!--T:27--> | | ==Tutorials== <!--T:27--> |
Line 79: |
Line 146: |
| <!--T:29--> | | <!--T:29--> |
| '''[[Quick_Start|Quick start]]''' | | '''[[Quick_Start|Quick start]]''' |
| + | |
| + | <!--T:82--> |
| + | '''[[Config_Index|Config index]]''' |
| | | |
| <!--T:30--> | | <!--T:30--> |
| '''[[Config_Editors|Config editors]]''' | | '''[[Config_Editors|Config editors]]''' |
| + | |
| + | <!--T:59--> |
| + | '''[[Axis_translation_parameters|Axis translation parameters]]''' |
| | | |
| <!--T:31--> | | <!--T:31--> |
| '''[[Mouse_Calibration|Mouse calibration]]''' | | '''[[Mouse_Calibration|Mouse calibration]]''' |
| + | |
| + | <!--T:58--> |
| + | '''[[Mouse_tweaks|Mouse tweaks]]''' |
| | | |
| <!--T:32--> | | <!--T:32--> |
| '''[[Macros|Macros]]''' | | '''[[Macros|Macros]]''' |
| + | |
| + | <!--T:54--> |
| + | '''[[DIY_USB_adapter|DIY USB adapter]]''' |
| + | |
| + | <!--T:57--> |
| + | '''[[DIY_USB_adapter_for_dummies|DIY USB adapter for dummies]]''' |
| + | |
| + | <!--T:63--> |
| + | '''[[Logitech_Wheels|Logitech force feedback wheels]]''' |
| + | |
| + | <!--T:64--> |
| + | '''[[RPi|Raspberry Pi setup hints]]''' |
| + | |
| + | <!--T:66--> |
| + | '''[[CHIP|C.H.I.P. Quick setup guide]]''' |
| | | |
| ==Troubleshooting== <!--T:33--> | | ==Troubleshooting== <!--T:33--> |
| | | |
| <!--T:34--> | | <!--T:34--> |
− | First make sure you have the latest GIMX version. | + | First make sure you have the latest GIMX version.<br /> |
− | Then look at the [[FAQ]] and the [http://code.google.com/p/diyps3controller/issues/list?can=1&q=status%3AAccepted+OR+status%3AFixed bug list], see if your problem is already known, and if it's not, [http://code.google.com/p/diyps3controller/issues/entry report it]. | + | Then look at the [[FAQ]] and the [https://gimx.fr/buglist bug list], see if your problem is already known, and if it's not, [https://gimx.fr/newissue report it].<br /> |
| + | If you think you may have misconfigured something, ask for help on the [https://gimx.fr/forum/viewforum.php?f=5 forum]. |
| | | |
| ==Old tutorials== <!--T:35--> | | ==Old tutorials== <!--T:35--> |
| + | |
| + | <!--T:83--> |
| + | <div class="mw-collapsible mw-collapsed"> |
| + | |
| + | <!--T:55--> |
| + | '''Translations''' |
| | | |
| <!--T:36--> | | <!--T:36--> |
Line 101: |
Line 199: |
| | | |
| <!--T:37--> | | <!--T:37--> |
− | * [http://forum.gimx.fr/viewtopic.php?f=4&t=10 French (outdated)]
| |
| * [http://forum.gimx.fr/viewtopic.php?f=4&t=13 German (outdated)] | | * [http://forum.gimx.fr/viewtopic.php?f=4&t=13 German (outdated)] |
| * [http://forum.gimx.fr/viewtopic.php?f=4&t=173 Spanish (outdated)] | | * [http://forum.gimx.fr/viewtopic.php?f=4&t=173 Spanish (outdated)] |
| * [http://forum.gimx.fr/viewtopic.php?f=4&t=34 Russian (outdated)] | | * [http://forum.gimx.fr/viewtopic.php?f=4&t=34 Russian (outdated)] |
| | | |
− | ==Configuration & Calibration== <!--T:38-->
| + | <!--T:38--> |
| + | '''Configuration & Calibration''' |
| | | |
| <!--T:39--> | | <!--T:39--> |
Line 114: |
Line 212: |
| * [http://forum.gimx.fr/viewtopic.php?f=4&t=39 English] | | * [http://forum.gimx.fr/viewtopic.php?f=4&t=39 English] |
| | | |
− | ==Mouse polling rate== <!--T:41-->
| + | <!--T:84--> |
| + | </div> |
| | | |
− | <!--T:42--> | + | ==GIMX "the hard way"== <!--T:56--> |
− | This tutorial explains how to change the mouse polling rate in Ubuntu and Windows.
| |
| | | |
− | <!--T:43--> | + | <!--T:49--> |
− | * [http://forum.gimx.fr/viewtopic.php?f=4&t=28 English]
| + | '''Running GIMX from the command line''' |
| | | |
− | ==DIY PC to PS3/360 USB adapter== <!--T:46-->
| + | <!--T:50--> |
| + | * [[Command_line|Command line]] |
| | | |
− | <!--T:53--> | + | <!--T:51--> |
− | This page explains how to easily build an adapter.
| + | '''Development''' |
| | | |
− | <!--T:45--> | + | <!--T:85--> |
− | * [http://forum.gimx.fr/viewtopic.php?f=4&t=405 English]
| + | <div class="mw-collapsible mw-collapsed"> |
− | | |
− | <!--T:47-->
| |
− | This page details all compatible hardware parts.
| |
− | | |
− | <!--T:48--> | |
− | * [[DIY_USB_adapter|English]]
| |
− | * [http://forum.gimx.fr/viewtopic.php?f=4&t=362 German]
| |
− | | |
− | ==Running GIMX from the command line== <!--T:49-->
| |
− | | |
− | <!--T:50-->
| |
− | * [[Command_line|English]]
| |
− | | |
− | ==Development== <!--T:51-->
| |
| | | |
| <!--T:52--> | | <!--T:52--> |
| * [[Development_on_Linux|Linux]] | | * [[Development_on_Linux|Linux]] |
| * [[Development_on_Windows|Windows]] | | * [[Development_on_Windows|Windows]] |
| + | * [[GUI_translation|GUI translation]] |
| + | * [[GE|The GIMX Event library]] |
| + | * [[gasync|The gasync library (evolution of the GE library)]] |
| + | * [[Network_API|Network API]] |
| + | * [https://github.com/matlo/serialusb Use the DIY USB adapter as a cheap USB proxy (~$5)] |
| + | * [[Bbb_sniffer|Use a BeagleBone Black as cheap a USB proxy (~$50)]] |
| + | * Controller protocols: |
| + | ** [http://eleccelerator.com/wiki/index.php?title=DualShock_3 Dualshock 3] |
| + | ** [http://eleccelerator.com/wiki/index.php?title=DualShock_4 Dualshock 4] |
| + | ** [[T300RS_PS4|T300RS PS4]] |
| + | ** [[G27_PS3|G27 PS3]] |
| + | |
| + | <!--T:86--> |
| + | </div> |
| </translate> | | </translate> |