Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 48 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,54 @@ changes to the sysfs surface, minor versions add supported wheels or
new attributes, patch versions are bug fixes and documentation. Pre-1.0
the contract is "it works on RS50 and G Pro as listed here".

## 0.43.0 - 2026-11-09

**The Logitech RS H-Shifter works on the RS50 and the G PRO.** Plug it into
an accessory port on the wheel base. The driver finds it when the module
loads and when you plug it in later. The seven gates and reverse report as
buttons 12 to 20; button 19 is not used, and reverse is button 20 (evdev
`0x2c4`). In desktop mode, with no game running, the driver turns
on the base's routing for the shifter, so the gates also work on the
desktop. The Info page in logi-wheel shows the gate that is in, and whether
the shifter sits on the base or on its own USB cable. Written and tested on
real hardware by gonzaloadrio ([#140](../../pull/140)).

**The Logitech Racing Adapter works on the base, and the Test page reads
two more devices on USB.** The driver finds a Racing Adapter plugged into an
accessory port, confirms it by its device name, and turns on the base's
routing for it in desktop mode, as it does for the H-Shifter. Its pedals and
its DB9 Driving Force Shifter then reach games through the base. The Info /
Testing page in logi-wheel also reads an RS Shifter & Handbrake and a Racing
Adapter plugged straight into the computer: handbrake lever and shift
direction for the one, three pedals and the 6+R shifter for the other.
Written and tested on real hardware by gonzaloadrio
([#139](../../pull/139)).

**`wheel_accessory` now lists every attached accessory.** A read of the
attribute re-checks the accessory ports, so an accessory plugged in after
boot shows up on the next read. With more than one attached, the attribute
names them all, separated by commas, for example
`RS Shifter & Handbrake, RS H-Shifter, Racing Adapter`. Closes
[#144](../../issues/144).

**Module load did not get slower.** The H-Shifter probe runs inside the one
accessory pass that already existed, so a wheel without accessories pays
nothing extra.

**pulldown-cmark 0.13.6** clears advisory RUSTSEC-2026-0414 in the Rust
workspace ([#142](../../pull/142)).

**Troubleshooting now covers a wheel that never enumerates.** A front-panel
USB port can fail the USB link before any driver runs. The kernel log shows
`disabled by hub (EMI?)` or `error -71`. A rear port fixes it
([#141](../../issues/141)).

Thanks to gonzaloadrio for the shifter and adapter work and the hot-plug
test runs, to
kangaro0 for the first power-up report that found the port problem, and to
fenixadam for the Windows captures in
[#134](../../issues/134) and [#135](../../issues/135).

## 0.42.6 - 2026-10-22

**A kernel oops on the G923 PS edition when the wheel is unplugged or the
Expand Down
9 changes: 8 additions & 1 deletion CREDITS.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,10 @@ until the last round.
([#83](../../issues/83)) is his too. And after weeks of a freeze that
left nothing in any log, he disabled his iGPU to see the panic on screen
and photographed it, which named the stale reply buffer fixed in 0.42.5
([#128](../../issues/128)).
([#128](../../issues/128)). The Windows captures in
[#134](../../issues/134) and [#135](../../issues/135) then showed that the
wire traffic is the same on both systems, which put the pedal inversion
on the Windows side and closed a long thread with evidence.
- **[DaveDos95](https://github.com/DaveDos95)** - RaceRoom on an RS50 under
SteamOS ([#92](../../issues/92)): read the game's own profile file to rule
out the first diagnosis, then produced the proxy logs that proved the real
Expand Down Expand Up @@ -93,6 +96,10 @@ until the last round.

## Sustained bug reporting

- **[kangaro0](https://github.com/kangaro0)** - an RS50 that never showed
up on first power-up ([#141](../../issues/141)). The kernel log in that report
named the real cause, a front-panel USB port failing the link before any
driver ran, which is now a troubleshooting entry for everyone after him.
- **[Ismael-Torresan](https://github.com/Ismael-Torresan)** - the only
quantitative measurements the force engine has: a fixed push over a fixed
travel, timed, for damper, friction and inertia on both the firmware's
Expand Down
900 changes: 486 additions & 414 deletions README.md

Large diffs are not rendered by default.

62 changes: 35 additions & 27 deletions docs/BUTTON_MAPPING.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,22 @@
# Button Mapping

The physical controls on the RS50 / G PRO wheel and hub, and the joystick button
index each one reports. Buttons use sequential indices matching Windows
DirectInput, so bindings stay consistent across platforms.
This page lists the physical controls on the RS50 / G PRO wheel and hub. It
gives the joystick button index each one reports. Buttons use sequential
indices that match Windows DirectInput (the Windows game-input interface).
So bindings stay the same across platforms.

This is the reference for binding controls in a game. The wire-level bitmask
(which report bit encodes which button) is in
[PROTOCOL_SPECIFICATION.md](PROTOCOL_SPECIFICATION.md). The G923 has its own
table below: it reports its own classic button layout straight from its HID
descriptor, not the RS50/G PRO one.
table below. It reports its own classic button layout straight from its HID
descriptor (the device's own list of its controls), not the RS50/G PRO one.

![RS50 button layout](images/rs-wheel-hub-button-layout.png)

The **Index** column is the joystick button number games show when binding
(sequential, matching Windows DirectInput). The **Diagram #** column is the
numbered callout box in the layout image above - the two numbering systems
are unrelated, so a button's index and its diagram number usually differ.
numbered callout box in the layout image above. The two numbering systems
are unrelated. So a button's index and its diagram number usually differ.

| Index | Button | Diagram # |
|-------|--------|-----------|
Expand All @@ -41,18 +42,22 @@ are unrelated, so a button's index and its diagram number usually differ.
| 28 | GL | 13 |
| 29 | GR | 7 |

GL and GR are their own buttons, not aliases of the shifter paddles
(hardware-verified 2026-07-20 by guided capture: evdev 0x2cc / 0x2cd,
sequential after G1).
GL and GR are their own buttons, not aliases of the shifter paddles. This
was hardware-verified on 2026-07-20 by guided capture: evdev 0x2cc / 0x2cd,
sequential after G1. evdev is the Linux input event interface.

The D-pad reports as a hat switch (`ABS_HAT0X` / `ABS_HAT0Y`), not as four
buttons - diagram callout "D".
buttons. It is diagram callout "D".

## RS H-Shifter (046d:c26b)

### Connected to the Wheel Base

When connected to a wheel base accessory port, gears 1 to 7 and Reverse report on DirectInput button indices 12 to 19 (hardware-verified 2026-10-29). Index 20 is used by the Racing Adapter DB9 Reverse.
When you connect the shifter to a wheel base accessory port, gears 1 to 7
and Reverse report on DirectInput button indices 12 to 20
(hardware-verified 2026-10-29 and 2026-11-09). Index 19 is not used. A DB9
Driving Force Shifter on the Racing Adapter reports its Reverse on the same
index 20.

| Index | Button / Gear | evdev Code | Wire bitmask (Report 0x08) |
|---|---|---|---|
Expand All @@ -63,12 +68,14 @@ When connected to a wheel base accessory port, gears 1 to 7 and Reverse report o
| 16 | RS H-Shifter: Gear 5 | `0x2c0` (`BTN_TRIGGER_HAPPY1`) | Byte 2 bit 4 (`0x10`) |
| 17 | RS H-Shifter: Gear 6 | `0x2c1` (`BTN_TRIGGER_HAPPY2`) | Byte 2 bit 5 (`0x20`) |
| 18 | RS H-Shifter: Gear 7 | `0x2c2` (`BTN_TRIGGER_HAPPY3`) | Byte 2 bit 6 (`0x40`) |
| 19 | RS H-Shifter: Reverse | `0x2c3` (`BTN_TRIGGER_HAPPY4`) | Byte 3 bit 0 (`0x01`) |
| 20 | Racing Adapter DB9 Reverse | `0x2c4` (`BTN_TRIGGER_HAPPY5`) | Byte 3 bit 1 (`0x02`) |
| 19 | not used | `0x2c3` (`BTN_TRIGGER_HAPPY4`) | Byte 2 bit 7 (`0x80`) |
| 20 | RS H-Shifter: Reverse (also Racing Adapter DB9 Reverse) | `0x2c4` (`BTN_TRIGGER_HAPPY5`) | Byte 3 bit 0 (`0x01`) |

### Connected Directly to PC via USB

When connected directly to the PC via USB (`046d:c26b Logitech RS H-Shifter`), it enumerates as an independent joystick reporting 8 digital buttons:
When you connect the shifter directly to the PC via USB
(`046d:c26b Logitech RS H-Shifter`), it enumerates as an independent
joystick. It reports 8 digital buttons:
- Buttons 0 to 6 (`0x120`..`0x126`): 1st through 7th gear
- Button 7 (`0x127`): Reverse (R)

Expand All @@ -79,7 +86,7 @@ Dual-mode sim accessory featuring a physical toggle switch between progressive a
### Connected to the Wheel Base

When connected to a direct-drive wheel base accessory port (RS50 / G PRO):
- **Handbrake Mode**: Reports as the wheel base's handbrake axis (progressive 0–100%).
- **Handbrake Mode**: Reports as the wheel base's handbrake axis (progressive 0 to 100%).
- **Sequential Shifter Mode**: Shift Up (pull back) and Shift Down (push forward) are routed directly by base firmware to the wheel paddle button codes:
- Shift Up: Right Paddle (`0x124`, `BTN_TOP2`)
- Shift Down: Left Paddle (`0x125`, `BTN_PINKIE`)
Expand Down Expand Up @@ -123,7 +130,7 @@ Connected via the adapter's DB9 shifter port when the adapter is plugged directl

When the Racing Adapter is plugged into an RS50 / G PRO wheel base USB port (`wheel_accessory` reports `Racing Adapter`):
- **Pedals**: Routed through the wheel base's standard pedal axes (`ABS_RX` Throttle, `ABS_RY` Brake, `ABS_RZ` Clutch).
- **DB9 Driving Force Shifter**: Routed through the wheel base's standard H-shifter button slots (`0x12c`..`0x12f` for 1st–4th, `0x2c0`..`0x2c1` for 5th–6th, and `0x2c4` (`BTN_TRIGGER_HAPPY5`) for Reverse, hardware-verified 2026-11-09). In Desktop mode (`profile 0`), the kernel driver automatically enables `0x8120` (`GAMING_ATTACHMENTS`) slot routing and `0x1BC0` (`SYNC`) when the Racing Adapter sub-device is detected.
- **DB9 Driving Force Shifter**: Routed through the wheel base's standard H-shifter button slots (`0x12c`..`0x12f` for 1st to 4th, `0x2c0`..`0x2c1` for 5th to 6th, and `0x2c4` (`BTN_TRIGGER_HAPPY5`) for Reverse, hardware-verified 2026-11-09). In Desktop mode (`profile 0`), the kernel driver automatically enables `0x8120` (`GAMING_ATTACHMENTS`) slot routing and `0x1BC0` (`SYNC`) when the Racing Adapter sub-device is detected.

## Pedals Connected to Wheel Base

Expand All @@ -137,12 +144,13 @@ When pedals (and optional RS Shifter & Handbrake) are connected to a wheel base'

## G923

The G923's own button layout, hardware-captured 2026-07-27 by a guided live
capture (every physical button pressed in turn, its joystick index
recorded) on a PS-edition unit (PID 0xc266). It reports the same sequential
DirectInput indexing as the RS50/G PRO above, but a different set of
buttons: no G1/GL/GR, and only one dial (right hand; the G923 has no left
encoder at all).
This is the G923's own button layout. It was hardware-captured on
2026-07-27 by a guided live capture on a PS-edition unit (PID 0xc266, the
USB product id). Every physical button was pressed in turn, and its
joystick index recorded. The G923 reports the same sequential DirectInput
indexing as the RS50/G PRO above, but a different set of buttons. It has no
G1/GL/GR. It has only one dial (right hand); the G923 has no left encoder
at all.

| Index | Button |
|-------|--------|
Expand All @@ -165,9 +173,9 @@ encoder at all).
| 23 | Dial Push |
| 24 | PS |

Indices 12 to 18 are gaps in the HID descriptor (unused). Indices 19-20
(Plus/Minus) are real buttons on the G923, unlike the RS50/G PRO, which
have no buttons there at all.
Indices 12 to 18 are gaps in the HID descriptor (unused). Indices 19 to 20
(Plus/Minus) are real buttons on the G923. The RS50/G PRO have no buttons
there at all.

The D-pad reports as a hat switch (`ABS_HAT0X` / `ABS_HAT0Y`), not as four
buttons, same as the RS50/G PRO.
buttons, the same as the RS50/G PRO.
Loading
Loading