nirenjan
0cb137bbe0
Prior to this change, the libx52util_convert_utf8_string function had a limited set of characters that it would convert to the MFD character map, these characters were derived from the x52_char_map.cfg file. However, this is a tiny subset of the actual supported characters in the Basic Multilingual Plane (BMP), since many characters in the BMP can be normalized to a different character (or character sequence) that has a corresponding glyph on the X52 MFD. One example of this is the half-width Katakana characters which are mapped in the display, however the corresponding full-width characters were not explicitly mapped. With this commit, the generator script now automatically detects that the half-width characters can be normalized to the corresponding full width forms, and maps the full width forms back to the correct characters on the MFD. A second benefit of this change is that the MFD can now show characters that would otherwise never be seen, for example, the 3/4 symbol or 5/8 symbol have no corresponding glyph in the MFD, but they can be translated to the sequence `3` `/` `4`, giving us much more flexibility on the characters that can actually be displayed. Finally, with this change, the function also maps missing or unsupported characters to the box character (0xDB in the display), making it clearer that there was something there that could not be displayed. Earlier, it would have simply skipped that character. |
||
|---|---|---|
| .github | ||
| bugreport | ||
| cli | ||
| daemon | ||
| docs | ||
| evtest | ||
| joytest | ||
| kernel_module | ||
| libusbx52 | ||
| libx52 | ||
| libx52io | ||
| libx52util | ||
| m4 | ||
| po | ||
| subprojects | ||
| udev | ||
| .gitattributes | ||
| .gitignore | ||
| AUTHORS | ||
| CONTRIBUTING.md | ||
| ChangeLog.md | ||
| Doxyfile.in | ||
| DoxygenLayout.xml | ||
| INSTALL.md | ||
| LICENSE | ||
| Makefile.am | ||
| PRIVACY.md | ||
| README.md | ||
| SECURITY.md | ||
| Version | ||
| autogen.sh | ||
| config.h.meson | ||
| configure.ac | ||
| gettext.h | ||
| meson.build | ||
| meson_options.txt | ||
| usb-ids.h | ||
| version-info | ||
README.md
Saitek X52Pro joystick driver for Linux
This project adds a new driver for the Saitek/MadCatz X52 Pro flight control system. The X52 pro is a HOTAS (hand on throttle and stick) with 7 axes, 39 buttons, 1 hat and 1 thumbstick and a multi-function display which is programmable.
Currently, only Windows drivers are available from Saitek PLC, which led me to develop a new Linux driver which can program the MFD and the individual LEDs on the joystick. The standard usbhid driver is capable of reading the joystick, but it cannot control the MFD or LEDs.
Most of the extra functionality can be handled from userspace. See the individual folders for README information.
For data handling and privacy (e.g. GDPR/CCPA), see PRIVACY.md.
Note: This repository currently only provides commandline interfaces to control the MFD and LEDs. If you are not comfortable working in the commandline, then the gx52 project might be a better fit for your needs as it provides a graphical interface to control the MFD and LEDs.
Installing released versions
Beginning from version v0.2.3, prebuilt packages are available on Ubuntu PPA and the Arch User Repository.
Ubuntu
This project has been released as a PPA on Ubuntu. To install the package, run the following commands in the terminal.
sudo apt-add-repository ppa:nirenjan/libx52
sudo apt update
sudo apt install libx52-1
Arch Linux
This is available on the AUR
Building and installing from source
See INSTALL.md