C++ Windows API for the PS5 DualSense controller written for C++ and C#.

Features

• Reading all button input from the controller
• Reading the analog sticks and analog triggers
• Reading the two finger touchpad positions
• Reading the accelerometer and gyroscope with device calibration
• Reading the battery level
• Controlling the left and right haptic feedback with variable strength
• Controlling the adaptive triggers and reading back the users force while active
• Controlling the RGB color of the lightbar
• Controlling the player indication LEDs and the microphone LED
• Access to the controller's internal timer

Using the API

This is the minimal example on how to use the library, for an in-depth look see the included documentation PDF.

#include <Windows.h>
#include <ds5w.h>

int main(int argc, char** argv) {
	// Array of controller infos
	DS5W::DeviceEnumInfo infos[16];

	// Number of controllers found
	unsigned int controllersCount = 0;

	// Call enumerate function and switch on return value
	switch (DS5W::enumDevices(infos, 16, &controllersCount)) {
	case DS5W_OK:
		// The buffer was not big enough. Ignore for now
	case DS5W_E_INSUFFICIENT_BUFFER:
		break;

		// Any other error will terminate the application
	default:
		// Insert your error handling
		return -1;
	}

	// Check number of controllers
	if (!controllersCount) {
		return -1;
	}

	// Context for controller
	DS5W::DeviceContext con;

	// Init controller and close application is failed
	if (DS5W_FAILED(DS5W::initDeviceContext(&infos[0], &con))) {
		return -1;
	}

	// Input state
	DS5W::DS5InputState inState;

	// Create struct and zero it
	DS5W::DS5OutputState outState;
	ZeroMemory(&outState, sizeof(DS5W::DS5OutputState));

	// Main loop
	while (true) {
		// Retrieve data
		if (DS5W_SUCCESS(DS5W::getDeviceInputState(&con, &inState))) {
			// Check if the Logo button is pressed (bit flag)
			if (inState.buttonMap & DS5W_ISTATE_BTN_PLAYSTATION_LOGO) {
				// Break from while loop
				break;
			}

			// Set output data
			outState.leftRumble = inState.leftTrigger;
			outState.rightRumble = inState.rightTrigger;

			// Send output to the controller
			DS5W::setDeviceOutputState(&con, &outState);
		}
	}

	// Shutdown controller
	DS5W::freeDeviceContext(&con);

	return 0;
}

Special thanks to

I have partially used the following sources to implement the functionality:

• The original repo by Ohjurot
• The GitHub community on this project and Ryochan7/DS4Windows#1545
• https://www.reddit.com/r/gamedev/comments/jumvi5/dualsense_haptics_leds_and_more_hid_output_report/
• https://gist.github.com/stealth-alex/10a8e7cc6027b78fa18a7f48a0d3d1e4
• https://gist.github.com/dogtopus/894da226d73afb3bdd195df41b3a26aa
• https://gist.github.com/Ryochan7/ef8fabae34c0d8b30e2ab057f3e6e039
• https://gist.github.com/Ryochan7/91a9759deb5dff3096fc5afd50ba19e2
• https://github.com/torvalds/linux/blob/master/drivers/hid/hid-sony.c
• https://elixir.bootlin.com/linux/latest/source/drivers/hid/hid-playstation.c
• https://controllers.fandom.com/wiki/Sony_DualSense#FFB_Trigger_Effect_Factories

Important Informations about Trademarks