DualSense on Windows [API]

Windows API for the PS5 DualSense controller. Written in C++ for C++. This API will help you using the DualSense controller in your windows C++ Applications / Projects.

:exclamation: ​Warning: The current release state is still a preview release. The library may not work as intended!

Features

• Reading all button input from the controller
• Reading the analog sticks and analog triggers
• Reading the two finger touch positions
• Reading the Accelerometer and Gyroscope
• Using the haptic feedback for default rumbleing
• Controlling the adaptive triggers (3 Types of effects) and reading back the users force while active
• Controlling the RGB color of the lightbar
• Setting the player indication LEDs and the microphone LED

The library is still in active development and will be extended with additional features soon. Consider checking out our Road-map for further information.

Using the API

1. Download the DualSenseWindows_VX.X.zip file from the latest release found at the Release Page
2. Unzip the archive to your computer
3. Read the DualSenseWindows.pdf PDF documentation to get the specific information for your current release

If you don't want to waste time reading the documentation - this is the minimal example on how to use the library:

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

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;
    }

    // Main loop
    while(true){
        // Input state
        DS5W::DS5InputState inState;

        // Retrieve data
        if (DS5W_SUCCESS(DS5W::getDeviceInputState(&con, &inState))){
            // Check for the Logo button
            if(inState.buttonsB & DS5W_ISTATE_BTN_B_PLAYSTATION_LOGO){
                // Break from while loop
                break;
            }

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

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

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

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

    // Return zero
    return 0;
}

Known issues

• When the controller being shut down while connected via Bluetooth (Holding the PS button). The lib will encounter a dead lock within getDeviceInputState(...) call. The function will return as soon as the controller is getting reconnected. Not encountering over USB, over USB the expected DS5W_E_DEVICE_REMOVED error is returned.

Special thanks to

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

• The GitHub community on this project and https://github.com/Ryochan7/DS4Windows/issues/1545
• https://www.reddit.com/r/gamedev/comments/jumvi5/dualsense_haptics_leds_and_more_hid_output_report/
• https://gist.github.com/dogtopus/894da226d73afb3bdd195df41b3a26aa
• https://gist.github.com/Ryochan7/ef8fabae34c0d8b30e2ab057f3e6e039
• https://gist.github.com/Ryochan7/91a9759deb5dff3096fc5afd50ba19e2

Important Informations about Trademarks