Mirrored_Repos/G27_Pedals_and_Shifter
1
0
Fork 0
mirror of https://github.com/n-e-y-s/G27_Pedals_and_Shifter.git synced 2024-08-30 18:22:10 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'n-e-y-s_devel' of https://github.com/n-e-y-s/G27_Pedals_and_Shifter into n-e-y-s_devel

Browse Source
This commit is contained in:
n-e-y-s
2020-06-15 16:26:00 +02:00
parent ebc2e80aed f4e3f75c41
commit fd6fb19b53
1 changed files with 22 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
README.md
View File

@ -2,8 +2,8 @@
Arduino-based USB interface for Logitech G27 pedals and shifter:
![on breadboard](https://raw.githubusercontent.com/functionreturnfunction/G27_Pedals_and_Shifter/master/Breadboard.jpg)
![in altoids tin](https://raw.githubusercontent.com/functionreturnfunction/G27_Pedals_and_Shifter/master/Altoids Tin.jpg)
![on breadboard](Breadboard.jpg)
![in altoids tin](Altoids Tin.jpg)
## Required Parts/Materials
@ -27,16 +27,17 @@ Open the .ino file in the Arduino IDE, select the proper board type and COM port
After the firmware has been uploaded to the arduino, you want to calibrate and configure the SW for your specific device. There is a python-based graphical user interface available in this project.
### GUI installation
This description assumes a windows operating system. Other operating systems are similar. You need python for running this GUI, I suggest to get the interpreter at http://winpython.github.io/. I'd choose the minimal python 3.7 64 bit version, but other versions or distributions should also work. When you have a python interpreter in place, I suggest to create a virtual environment using the shell commands:
This description assumes a windows operating system. Other operating systems are similar. You need python3 for running this GUI, I suggest to get the interpreter at http://winpython.github.io/. I'd choose the minimal python 3.7 64 bit version, but other versions or distributions should also work. When you have a python interpreter in place, I suggest to create a virtual environment using the shell commands:
cd <a path of your choice>
python -m venv g27calib
This command creates a virtual python environment in the directory g27calib. Afterwards you can install the GUI with (assuming Windows platform)
This command creates a virtual python environment in the directory g27calib. Afterwards you can install the GUI with
.\g27calib\Scripts\pip install -e git+https://github.com/n-e-y-s/G27_Pedals_and_Shifter@n-e-y-s_devel#egg=G27_Pedals_and_Shifter_GUI
.\g27calib\Scripts\pip install git+https://github.com/n-e-y-s/G27_Pedals_and_Shifter@n-e-y-s_devel#egg=G27_Pedals_and_Shifter_GUI
The python packager downloads some stuff from the internet and finally you are able to start
Of course you can also specify a local path alternatively to the git path above. Pip downloads some packages from the internet and finally you should be able to start
g27calib/Scripts/g27calib
@ -44,4 +45,18 @@ and the gui should open.
### Calibration process
TODO
At first you need to select the Arduino serial device. On linux platforms, it is also necessary to select the joystick device of the G27, otherwise the GUI might be very slow:
[device selector](screenshots/device_selector.png)
When everything is set correctly, press the Start button. You are presented with the calibration/configurtion GUI:
[gui screenshot](screenshots/gui_in_action.png)
On the upper right, you get some help text about what to do next. Using that everything shall be pretty self-explaining. The graphs in the lower part are for the pedals and the shifter respectively. You see the measurements over the last second depicted with the "+" marks.
The first step is to decide for a suitable filtering. Depending on the wear of your device, the measurements can be quite noisy and so it might be desirable to enable the median filtering in the options panel. When changing the values you will see the immediate effect on the measurements.
Afterwards you probably want at least to calibrate your shifter by selecting the calibration values for the shifter on the upper left panel. Optionally you can also pre-calibrate your pedals such that the values are stored on the Arduino. The default is to use auto-calibration for the pedals.
Note that there is the status line output with some profiling output on the left side and the final output values of the axis, buttons and gear value as delivered to the games.