Add support to HORI Racing Wheel Apex for Sony Playstation

Signed-off-by: Douglas Schilling Landgraf <[email protected]>
autosd-vss-mw · Sep 19, 2024 · 00e9234 · 00e9234
1 parent 1c5514e
commit 00e9234
Show file tree

Hide file tree

Showing 2 changed files with 41 additions and 9 deletions.
diff --git a/docs/joysticks/tools/README.md b/docs/joysticks/tools/README.md
@@ -11,10 +11,11 @@
     - [Nintendo Switch Pro Controller](#nintendo-switch-pro-controller)
     - [Stadia Controller (Google)](#stadia-controller-google)
     - [Xbox One Elite 2 Controller](#xbox-one-elite-2-controller)
+    - [HORI Racing Wheel Apex](#hori-racing-wheel-apex)
 
 ## Overview
 
-This tool detects connected PS4, PS5 (DualSense), PS VR Aim controllers, Nintendo Switch Pro Controller, Stadia Controller, PNX Flight Simulator PC Game Controller, and Xbox One Elite 2 Controller, tracks their inputs, and manages the special features of the DualSense controller (PS5). It is built using Pygame for general input handling and pydualsense for controlling the advanced features of the PS5 DualSense controller.
+This tool detects connected PS4, PS5 (DualSense), PS VR Aim controllers, Nintendo Switch Pro Controller, Stadia Controller, PNX Flight Simulator PC Game Controller, Xbox One Elite 2 Controller, or HORI Racing Wheel Apex, tracks their inputs, and manages the special features of the DualSense controller (PS5). It is built using Pygame for general input handling and pydualsense for controlling the advanced features of the PS5 DualSense controller.
 
 The tool also checks if the `vss-dbus` service is running, which could cause conflicts with the joystick device, and exits if the service is active.
 
@@ -28,6 +29,7 @@ The tool also checks if the `vss-dbus` service is running, which could cause con
 - **Nintendo Switch Pro Controller Support**: Logs inputs from the Nintendo Switch Pro Controller.
 - **Stadia Controller Support**: Logs inputs from the Stadia Controller by Google.
 - **Xbox One Elite 2 Controller Support**: Logs inputs from the Xbox One Elite 2 Controller, supporting general input logging.
+- **HORI Racing Wheel Apex Support**: Logs inputs from the HORI Racing Wheel Apex, recognized as a gamepad.
 - **vss-dbus Conflict Detection**: Ensures the tool does not run if the `vss-dbus` service is active to avoid device conflicts.
 - **Graceful Exit**: The tool handles `Ctrl + C` signals to exit gracefully, stopping any active vibration and releasing resources.
 
@@ -48,8 +50,6 @@ Ensure that the `vss-dbus` service is stopped before running the tool:
 sudo systemctl stop vss-dbus
 ```
 
-The tool will detect a connected PS4, PS5 (DualSense), Stadia, PNX Flight Simulator, Nintendo Switch Pro, or Xbox One Elite 2 Controller, log its inputs, and allow motor vibration control for PS4 and PS5 controllers.
-
 ```bash
 sudo ./gaming-controllers
 pygame 2.6.0 (SDL 2.28.4, Python 3.12.5)
@@ -128,10 +128,10 @@ Bus 003 Device 021: ID 054c:0bb2 Sony Corp. PS VR Aim Controller
 [100945.936850] usb 3-1: New USB device strings: Mfr=1, Product=2, SerialNumber=0
 [100945.936851] usb 3-1: Product: PS VR Aim Controller
 [100945.936852] usb 3-1: Manufacturer: Sony Interactive Entertainment
-[100945.939224] input: Sony Interactive Entertainment PS VR Aim Controller as /devices/pci0000:00/0000:00:14.0/usb3/3-1/3-1:1.0/0003:054C:0BB2.0014/input/input70
-[100945.939475] hid-generic 0003:054C:0BB2.0014: input,hidraw0: USB HID v1.11 Gamepad [Sony Interactive Entertainment PS VR Aim Controller] on
+[100945.939224] input: Sony Interactive Entertainment PS VR Aim Controller as /devices/pci0000:00/0000:00:14.0/usb3/3-1/3-1:1.0/0003:054C:0BB2.0014/input
 
- usb-0000:00:14.0-1/input0
+/input70
+[100945.939475] hid-generic 0003:054C:0BB2.0014: input,hidraw0: USB HID v1.11 Gamepad [Sony Interactive Entertainment PS VR Aim Controller] on usb-0000:00:14.0-1/input0
 ```
 
 ### PNX Flight Simulator PC Game Controller
@@ -226,3 +226,25 @@ Bus 003 Device 041: ID 045e:0b00 Microsoft Corp. Xbox One Elite 2 Controller
 [183717.391822] usb 3-1: SerialNumber: 3032363330313133383232313433
 [183717.393388] input: Microsoft X-Box One Elite 2 pad as /devices/pci0000:00/0000:00:14.0/usb3/3-1/3-1:1.0/input/input86
 ```
+
+### HORI Racing Wheel Apex
+
+Recognized as a USB HID gamepad, logs inputs from the HORI Racing Wheel Apex.
+
+#### `lsusb` Output:
+
+```
+Bus 003 Device 048: ID 0f0d:0156 HORI CO.,LTD. HORI Racing Wheel Apex
+```
+
+#### `dmesg` Output:
+
+```
+[186875.331973] usb 3-1: new full-speed USB device number 48 using xhci_hcd
+[186875.461355] usb 3-1: New USB device found, idVendor=0f0d, idProduct=0156, bcdDevice= 1.15
+[186875.461359] usb 3-1: New USB device strings: Mfr=1, Product=2, SerialNumber=0
+[186875.461360] usb 3-1: Product: HORI Racing Wheel Apex
+[186875.461361] usb 3-1: Manufacturer: HORI CO.,LTD.
+[186875.463351] input: HORI CO.,LTD. HORI Racing Wheel Apex as /devices/pci0000:00/0000:00:14.0/usb3/3-1/3-1:1.0/0003:0F0D:0156.0039/input/input93
+[186875.463647] hid-generic 0003:0F0D:0156.0039: input,hiddev96,hidraw0: USB HID v1.11 Gamepad [HORI CO.,LTD. HORI Racing Wheel Apex] on usb-0000:00:14.0-1/input0
+```
diff --git a/docs/joysticks/tools/gaming-controllers b/docs/joysticks/tools/gaming-controllers
@@ -14,8 +14,8 @@
 
 """
 Usage:
-    This script detects a connected PS4, PS5, PS VR Aim, Gembird, Nintendo Switch Pro, Stadia, or Xbox One Elite 2 controller,
-    tracks inputs, and controls features such as motor vibration for supported controllers.
+    This script detects a connected PS4, PS5, PS VR Aim, Gembird, Nintendo Switch Pro, Stadia, Xbox One Elite 2,
+    or HORI Racing Wheel Apex controller, tracks inputs, and controls features such as motor vibration for supported controllers.
     It ensures that the vss-dbus service is not running to avoid conflicts with the joystick device.
 
     Ensure the vss-dbus service is stopped before running this tool:
@@ -32,6 +32,7 @@ Usage:
     - Nintendo Switch Pro Controller
     - Stadia Controller (Google)
     - Xbox One Elite 2 Controller
+    - HORI Racing Wheel Apex
 """
 
 import os
@@ -40,7 +41,6 @@ import signal
 import pygame
 import pydualsense  # For PS5 DualSense controller
 
-
 class JoystickController:
     AXIS_THRESHOLD = 0.05  # Threshold to avoid small fluctuations
 
@@ -105,6 +105,9 @@ class JoystickController:
         elif "Xbox One Elite" in controller_name or "Microsoft" in controller_name:
             self.controller_type = "Xbox"
             self.initialize_xbox_controller()
+        elif "HORI Racing Wheel Apex" in controller_name:
+            self.controller_type = "HORI"
+            self.initialize_hori_controller()
         else:
             print(f"Unsupported controller: {controller_name}")
             sys.exit(1)
@@ -148,6 +151,11 @@ class JoystickController:
         print("Initializing Xbox One Elite 2 controller features.")
         # If vibration support is available for Xbox controller, it can be implemented here
 
+    def initialize_hori_controller(self):
+        """Initializes the HORI Racing Wheel Apex controller features."""
+        print("Initializing HORI Racing Wheel Apex features.")
+        # Custom handling for HORI Racing Wheel Apex can be added here.
+
     def handle_vibration_with_button_10(self):
         """Handles motor vibration with Button 10 (Options button) for supported controllers."""
         button_10_state = self.joystick.get_button(10)  # Button 10 (Options button)
@@ -170,6 +178,8 @@ class JoystickController:
                         print("Vibration support for Nintendo Switch Pro is not implemented.")
                     elif self.controller_type == "Stadia":
                         print("Vibration support for Stadia Controller is not implemented.")
+                    elif self.controller_type == "HORI":
+                        print("Vibration support for HORI Racing Wheel Apex is not implemented.")
                     self.is_motor_vibrating = True
                 else:
                     print("Stopping motor vibration with Button 10")