https://github.com/jromaing/driving-force-shifter-usb-adapter
Arduino-based USB adapter for the Logitech Driving Force Shifter
https://github.com/jromaing/driving-force-shifter-usb-adapter
arduino logitech-gaming simracing
Last synced: 3 months ago
JSON representation
Arduino-based USB adapter for the Logitech Driving Force Shifter
- Host: GitHub
- URL: https://github.com/jromaing/driving-force-shifter-usb-adapter
- Owner: JRomainG
- License: gpl-3.0
- Created: 2020-10-24T09:07:04.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-10-23T09:42:29.000Z (over 3 years ago)
- Last Synced: 2023-02-27T04:18:01.414Z (over 2 years ago)
- Topics: arduino, logitech-gaming, simracing
- Language: C++
- Homepage:
- Size: 1.22 MB
- Stars: 17
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Logitech Driving Force Shifter USB Adapter
Project to turn an Arduino board into a USB adapter for the Logitech G29 Driving Force Shifter.
Inspired by [this project](https://github.com/armandoiglesias/g29Shifter) and [this video](https://www.youtube.com/watch?v=dLpWEu8kCec). Code rewritten to use the [UnoJoy](https://github.com/AlanChatham/UnoJoy) library and work on a non-Leonardo board.
**Note:** If you are having trouble with the UnoJoy library, check out [this branch](https://github.com/JRomainG/Driving-Force-Shifter-USB-Adapter/tree/ArduinoJoystickLibrary) which uses the [ArduinoJoystickLibrary](https://github.com/MHeironimus/ArduinoJoystickLibrary) library instead as well as [this issue](https://github.com/JRomainG/Driving-Force-Shifter-USB-Adapter/issues/1)
## Prerequisites
* A [Logitech Driving Force shifter](https://www.logitechg.com/en-us/products/driving/driving-force-shifter.941-000119.html).
* An Arduino Uno, Mega, or Leonardo.
* The [Arduino IDE](https://www.arduino.cc/en/Main/Software).
* The [UnoJoy library](https://github.com/AlanChatham/UnoJoy) and its drivers.
## Arduino setup
Connect the pins from the shifter's serial connector to the Arduino:
More details can be found in [this video by AMStudio](https://www.youtube.com/watch?v=dLpWEu8kCec). It also shows how the finished product should look like, though the code base is different.
## Flashing
Download the [UnoJoy](https://github.com/AlanChatham/UnoJoy) library. Copy the `UnoJoy.h` file in the same directory as `G29_Shifter.ino`, and flash `G29_Shifter.ino` to your board using the Arduino IDE.
Make sure to read UnoJoy's project page, which describes the steps to install the library and to program your Arduino.
Just as a helpful reminder, here are the steps required to turn your Arduino into a gamepad:
### DFU mode
Put your Arduino in [DFU mode](https://www.arduino.cc/en/Hacking/DFUProgramming8U2): Using a piece of wire or other small metal object,
connect the 2 pins closest to the USB connector together. You should hear a "beep" when the board enters DFU mode.
DFU stands for "Device Firmware Update". This mode is used by UnoJoy to change your Arduino's firmware, and either make it act as a regular Arduino board or as a controller.
### TurnIntoAJoystick / TurnIntoAnArduino
Now that your board is in DFU mode, you can update the firmware.
You simply need to run (by double clicking) UnoJoy's `TurnIntoAJoystick` (`.bat` for Windows, `.sh` for Linux, and `.command` for macOS).
**Note:** To reprogram your board as an Arduino instead of a joystick, simply run `TurnIntoAnArduino` instead.
This should open the shell and log information about the process. If it ends with `passed`, you're all good! If you see `failed`, your board probably wasn't in DFU mode. If you're sure that it was, head over to [UnoJoy's project page](https://github.com/AlanChatham/UnoJoy) for more information or to open an issue.
### Restart the Arduino
Simply unplug and replug your Arduino and you should be good to go!
Once your Arduino is in "Joystick mode", you can no longer reprogram it using the IDE. To turn it back into an Arduino (and be able to reprogram it), the steps are identical, but you need to run `TurnIntoAnArduino` instead of `TurnIntoAJoystick`.
## Testing
Once you have flashed your Arduino, if you're running Windows, you can check that the gears are working correctly from the control panel:
* Open Control Panel from the Start Menu.
* Under "Hardware and Sound", click "View devices and printers".
* The Arduino board should appear as a gamepad controller. Right click it and select the UnoJoy Joystick's properties.
* Select "Properties". You should be able to view the gamepad's active buttons in the "Test" tab.
Try to switch into each gear and check that they are correctly recognized. The first gear should show up as button 1, the second gear as button 2, and so on and so forth. The reverse gear should show up as button 7.
If that's not the case, please checkout the "Debugging" section.
## Debugging
### Shifter not recognized by the system
Make sure you have correcty programmed the Arduino using UnoJoy's `TurnIntoAJoystick`. You **must** set it to DFU mode **before** running `TurnIntoAJoystick`, and you **must** unplug and replug the Arduino afterwards.
### Wrong gears detected
If the wrong buttons are selected when you shift gears (e.g. gear 1 enables button 3, or gear 6 enables button 4), the thresholds are probably wrong. You need to recalibrate the values as they depend on your setup (e.g. length of the cables between the shifter and the Arduino).
You'll need to open `G29_Shifter.ino` and change the following values:
```C
#define XAXIS_LEFT_THRESH
#define XAXIS_RIGHT_THRESH
#define YAXIS_UP_THRESH
#define YAXIS_DOWN_THRESH
```
Here's how the thresholds work:
When the gear is perfectly centered (in neutral), its X and Y values should be around 500. If the X value goes under `XAXIS_LEFT_THRESH` (300 by default), then you are probably switching into first or second gear. At the contrary, if it goes above `XAXIS_RIGHT_THRESH`, you are probably switching into fifth, sixth, or reverse.
Here are a few examples of symptoms and how to fix them:
* *I'm in 3rd gear but the input shows up as 1rst gear*: Decrease the `XAXIS_LEFT_THRESH`.
* *I'm in 1rst gear but the input shows up as 3rd gear*: Increase the `XAXIS_LEFT_THRESH`.
* *I'm in 3rd gear but the input shows up as neutral*: Decrease the `YAXIS_UP_THRESH`.
* *I'm in 4th gear but the input shows up as neutral*: Increase the `YAXIS_DOWN_THRESH`.
To know which values you should use, you can flash `Test_Arduino_Shifter.ino` and observe the values read by opening the serial port in the Arduino IDE (baud rate is 9600).
### No gear detected
Check your wiring. Make sure to watch [this video by AMStudio](https://www.youtube.com/watch?v=dLpWEu8kCec) which explains precisely how to connect the shifter to the Arduino.
Flash `Test_Arduino_Shifter.ino` to your Arduino board and make sure that the outputs on the serial port change when you switch gears. Check that those values are coherent with the defined thresholds (see above).