Description

DS4Communicator is an interactive command-line program that allows users to communicate with a Dualshock 4 controller over Bluetooth. It can read input data from the controller as well as control the two rumble motors and set RGB values for the LED.

Requirements

DS4Communicator relies on hidapi. It can be built from source on all major OSs or installed on

• MacOS using homebrew: brew install hidapi
• GNU/Linux with package manager

Compile from Source

Download and build DS4Communicator:
git clone https://github.com/connorc0405/DS4Communicator.git
cd DS4Communicator/DS4Communicator
make

To run:
./bin/ds4communicator

Note: The controller must be paired with the computer over Bluetooth before DS4Communicator is executed

Usage

print : Read input data from the controller
rumble [0-255] [0-255] : Set rumble intensity for left and right motors, respectively
led [0-255] [0-255] [0-255] : Set red, green, and blue values for the LED, respectively
list : Get last updated rumble and LED values
send : Send an output report to set rumble and LED function
quit : Stop DS4Communicator

Issues

1. The Dualshock 4 does not include one of its input reports in the HID report descriptor, which is sent after an output report has been written. Because of this, input reports cannot be received after an output report is written, until:
   a) Dualshock 4 controller is disconnected
   b) Dualshock 4 is reconnected
   c) DS4Communicator is restarted

2. DS4Communicator has only been tested on MacOS. File an issue if it is broken on other platforms.