Skip to content

Latest commit

 

History

History
77 lines (61 loc) · 2.81 KB

README.md

File metadata and controls

77 lines (61 loc) · 2.81 KB
Raw

A linux kernel driver that aims to add support for FANATEC devices.

Known devices

The Wheel Base should be set to 'PC mode' for the driver to be selected (CSL Elite: red LED)

  • 0EB7:0E03 FANATEC CSL Elite Wheel Base
  • 0EB7:0005 FANATEC CSL Elite Wheel Base PS4
  • 0EB7:6204 FANATEC CSL Elite Pedals
  • (experimental: 0EB7:0001 FANATEC ClubSport Wheel Base V2)
  • (experimental: 0EB7:0004 FANATEC ClubSport Wheel Base V2.5)
  • (experimental: 0EB7:0006 Podium Wheel Base DD1)
  • (experimental: 0EB7:0007 Podium Wheel Base DD2)
  • (experimental: 0EB7:0011 CSR Elite Wheel Base)
  • (experimental: 0EB7:0020 CSL DD Wheel Base)

Installation

Compile and install the driver

make
sudo make install

This installs the kernel module hid-fanatec.ko in the hid dir of the running kernel and puts fanatec.rules into /etc/udev/rules.d. These rules allows access to the device for users group and sets deadzone/fuzz to 0 so that any wheel input is detected immediately. The driver should get loaded automatically when the wheel is plugged.

Status

General

Support for a bunch of effects, mostly copy-pasted from https://github.com/berarma/new-lg4ff. Note: only tested with CSL Elite Wheelbase. Currently not supported effects: FF_FRICTION, FF_INERTIA

FFB in specific Games

Games I test (more or less regularly) and that are expected to work:

  • AC / ACC
  • Dirt2
  • rFactor2

Games that don't work properly:

  • F1 202X (#22)
  • BeamNG.drive (#23)

Device specific

Advanced functions of wheels/bases are available via sysfs. Base sysfs path: /sys/module/hid_fanatec/drivers/hid:ftec_csl_elite/0003:0EB7:0005.*/

Common:

  • set/get range: echo number in degrees to range
  • get id of mounted wheel: wheel_id

CSL Elite Base:

  • RPM LEDs: leds/0003:0EB7:0005.*::RPMx/brightness (x from 1 to 9)
  • tuning menu:
    • get/set tuning menu slot: echo number into SLOT
    • values get/set: BLI DPR DRI FEI FF FOR SEN SHO SPR
    • reset all tuning sets by echoing anything into RESET

CSL Elite pedals:

  • loadcell adjustment: load (no readback yet)

ClubSport Forumla1 wheel:

  • RPM LEDs (combined with base)
  • display: display (negative value turns display off)

ClubSport Pedals V3

  • pedal vibration: rumble
    • 16776960 -> both pedals should rumble
    • 16711680 -> throttle pedal rumble
    • 65280 -> break pedal rumble
    • 0 -> stop rumble

To access advanced functions from user space please see the hid-fanatecff-tools project which also aims to support LED/Display access from games.

Planned

  • support more effects
  • support more devices / advances functions of devices

Disclaimer

I take absolutly no responsibility for any malfunction of this driver and their consequences. If your device breaks or your hands get ripped off I'm sorry, though ;)