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 and CSL DD: red LED)

• 0EB7:0E03 FANATEC CSL Elite Wheel Base
• 0EB7:0005 FANATEC CSL Elite Wheel Base PS4
• 0EB7:0020 FANATEC CSL DD / DD Pro Wheel Base
• 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:183b FANATEC ClubSport Pedals V3)
• (experimental: 0EB7:0006 Podium Wheel Base DD1)
• (experimental: 0EB7:0007 Podium Wheel Base DD2)
• (experimental: 0EB7:0011 CSR Elite/Forza Motorsport 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.

Packaging

If you don't want to compile and install manually, following is a list of known packaged distributions.

Status

General

Support for a bunch of effects, mostly copy-pasted from 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 / WRC
• rFactor2
• F1 22/23

Games that don't work properly:

• F1 2020/2021 (#22)
• BeamNG.drive (proton) (#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

ClubSport Forumla1 wheel

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

CSL Elite pedals

• loadcell adjustment: load (no readback yet)

ClubSport Pedals V3

• pedal vibration: rumble
  • 0xFFFF00 -> both pedals should rumble
  • 0xFF0000 -> throttle pedal rumble
  • 0xFF00 -> 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. ;)