logitech-g29

This library is no longer being tested or updated as I no longer have access to the hardware.

Logitech G29 Racing Wheel for Node

Bring your Logitech G29 Racing Wheel into the wonderful world of Node.

• Subscribe to wheel, pedal, and shifter events.
• Activate simple force feedback effects.
• Set wheel auto-centering and range.
• Customize shift indicator LEDs.

Requirements

Node version 10.16 or the Node version required by any dependency, whichever is greater.

Make sure the Logitech G29 mode switch is set to PS3. The switch is located above the middle of the steering wheel.

Install

This library uses node-hid behind the scenes. Depending on your OS and Node version, you may have an effortless install. If not, you may want to consult node-hid's compiling from source guide for assistance.

npm install logitech-g29

Windows users who are having trouble connecting to a wheel may need to run the Logitech G Hub software one time to setup drivers.

Ubuntu users will most likely want to remove the sudo requirement of interfacing with the wheel. This can be accomplished by creating a file at /etc/udev/rules.d/99-hidraw-permissions.rules with the following code. After saving the file, reboot and then you can move on to more fun tasks.

KERNEL=="hidraw*", SUBSYSTEM=="hidraw", MODE="0664", GROUP="plugdev"

Example

Let's have some fun and make our wheel LEDs light up when we press the gas pedal.

const g = require('logitech-g29')

g.connect(function(err) {
    g.on('pedals-gas', function(val) {
        g.leds(val)
    })
})

Vroom vroom sounds optional but encouraged. ^_^

API

• connect
  • options
• events
  • event map
  • on
  • once
• force
  • forceConstant
  • forceFriction
  • forceOff
• leds
• disconnect
• advanced
  • emitter
  • relay
  • relayOS

License

CC0 1.0 Universal

This work has been marked as dedicated to the public domain.