g29py

python driver for logitech g29 wheel/pedals

Install

pip install g29py

g29py depends on the PyPI hidapi package, which provides prebuilt wheels on common platforms.

If a wheel is not available for your platform and pip falls back to a source build on Linux, you may still need system HID dependencies such as:

sudo apt install libusb-1.0-0-dev libudev-dev

Use

import time

from g29py import G29


g29 = G29()

try:
    g29.set_range(500)
    g29.set_friction(0.5)
    g29.listen()

    while True:
        state = g29.get_state()
        events = g29.get_events()
        print(state["steering"], state["accelerator"], state["brake"])
        if events:
            print(events)
        time.sleep(0.01)
except KeyboardInterrupt:
    pass
finally:
    g29.force_off()
    g29.stop()

Read

State vs Events

The driver exposes two read models:

• get_state()
  • latest snapshot
  • use for steering, pedals, and held buttons
• get_events()
  • buffered transient input events
  • use for button edges and dial pulses

Rule of thumb:

• if you want to know what is true now, use state
• if you want to know what happened since the last poll, use events

Pedals/Steering

Buttons

State is returned in a flattened shape:

state = {
    "steering": 0.0,
    "accelerator": -1.0,
    "clutch": -1.0,
    "brake": -1.0,
    "buttons": {
        "up": 0,
        "down": 0,
        "left": 0,
        "right": 0,
        "X": 0,
        "O": 0,
        "S": 0,
        "T": 0,
        "R2": 0,
        "R3": 0,
        "L2": 0,
        "L3": 0,
        "right_paddle": 0,
        "left_paddle": 0,
        "Share": 0,
        "Options": 0,
        "+": 0,
        "-": 0,
        "back": 0,
        "PS": 0,
    },
}

Events

Transient inputs are exposed through get_events().

events = g29.get_events()

Current event shapes:

{"type": "button_down", "control": "X"}
{"type": "button_up", "control": "X"}
{"type": "dial", "delta": 1}
{"type": "dial", "delta": -1}

get_events() clears the buffered event queue on read.

Write

Torque Simulation

g29py.advanced includes a higher-level steering feel controller built from set_anticenter() and set_friction().

import time

from g29py import G29
from g29py.advanced import SteeringTorqueController


g29 = G29()
controller = SteeringTorqueController(g29)

try:
    g29.listen()

    while True:
        state = g29.get_state()
        speed_m_s = get_vehicle_speed_m_s()
        command = controller.update(
            longitudinal_velocity_m_s=speed_m_s,
            steering=state["steering"],
        )
        print(command.target_position, command.force, command.friction)
        time.sleep(0.05)
finally:
    g29.force_off()
    g29.stop()

Behavior:

• parked: target holds the current wheel position with high friction
• rolling: target is center, force ramps with speed, friction drops with speed
• caller owns speed input; feed real vehicle speed in meters per second when available

To make the wheel follow an external steering target, pass target_steering. The target uses the same normalized -1.0..1.0 steering range as state["steering"].

command = controller.update(
    longitudinal_velocity_m_s=speed_m_s,
    steering=state["steering"],
    target_steering=model_steering,
)

With target_steering=None, the controller keeps the default speed-based behavior. With target_steering set, that target replaces the rolling center target while speed still controls force and friction.

Development

Use Python 3.9+

Setup:

poetry install

Useful commands:

make test
make build
make twine-check
make release-test

Examples:

poetry run python -u examples/dial_events.py
poetry run python scripts/test_effects.py set_friction --val 0.5 --hold 5

Support

Only Logitech G29 Driving Force Racing Wheels & Pedals kit supported on linux in ps3 mode.

On linux, remove sudo requirements by adding udev rule.

echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="c24f", MODE="0664", GROUP="plugdev"' \
    | sudo tee /etc/udev/rules.d/99-g29py.rules
sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=usb --attr-match=idVendor=046d --attr-match=idProduct=c24f

Sources

• Effect behavior has been hand-checked against a real Logitech G29 on Linux; see docs/effect-map.md.
• Commands were originally informed by nightmode's logitech-g29 node.js driver.
• Effects/layout were cross-checked against WiiBrew's Logitech USB steering wheel reference.
• HID access is provided by the Python hidapi package.