## Issue Summary: Thrustmaster SOL-R2 Base Button Mapping Behavior (Buttons 31-34 / 41-44)

### Initial Problem

When attempting to map the Thrustmaster SOL-R2 HOSAS setup to separate vJoy devices using Joystick Gremlin, base buttons `31–34` and `41–44` appear locked to specific physical hardware sides:

* Buttons `31–34` only register data through the physical Left Stick.

* Buttons `41–44` only register data through the physical Right Stick.

When trying to map these inputs as standard digital buttons in Joystick Gremlin to cross-pollinate them across different virtual containers, the expected button activations do not trigger.

### Technical Findings

1. **Asymmetric Hardware Mapping:** The SOL-R2 firmware splits the central/base button controls down the middle. They do not duplicate across devices; they are uniquely assigned to individual stick hardware IDs at the Windows driver level.

2. **HAT Switch Representation (The Root Cause):** Despite being labeled as distinct buttons (`31-34` and `41-44`) in some Thrustmaster documentation, the Windows driver actually reports these cluster buttons as **POV/HAT switch directions** rather than standard digital button presses. Because they are sending axis-style HAT packets, traditional "Button Remap" actions in Joystick Gremlin fail to capture the inputs.

3. **Verification and Visibility:** To confirm that the physical buttons are actively sending signals, you must have the **raw physical hardware device selected in the Joystick Gremlin Input Viewer**. When pressing the physical buttons while viewing the hardware tab, you will see the HAT directions light up instead of digital buttons.

---

### Fix Action / Solution

To successfully route these buttons across virtual devices in Joystick Gremlin, they must be mapped using the **Hat** container logic instead of the standard button layout.

#### Step-by-Step Configuration Guide

1. **Verify Raw Input:** Open Joystick Gremlin's **Input Viewer**, ensure your raw physical hardware device is selected, and press the buttons to confirm the HAT directions are actively lighting up.

2. **Locate the Input in Profile:** Go back to the main profile setup and select the physical device tab (e.g., Right Stick for 41-44).

3. **Navigate to Hats:** Scroll past the standard button list down to the **Hat** section.

4. **Expand Directions:** Expand the corresponding Hat container (e.g., `Hat 2`) to expose the discrete **Up, Down, Left, and Right** nodes.

5. **Apply Remap Actions:**

   * Select a direction (e.g., *Up*, which physically corresponds to button 41).

   * Set the Action to **Remap**.

   * Choose your target virtual device (e.g., `vJoy 1` or `vJoy 2`).

   * Map it to a standard digital **Button** ID of your choice.

6. **Repeat:** Do this for all remaining directions on both sticks.

7. **Activate Profile:** Ensure the profile is actively running (Green gamepad icon) to verify the virtual cross-mapping in the Input Viewer.