Jump to content


JoyShockLibrary 3.0

¿Quieres enterarte al momento de las nuevas descargas? Síguenos en Twitter, Mastodon o Threads!

El DualShock 4 de Sony PlayStation, el DualSense, los Joy-Cons de Nintendo Switch (usados por parejas) y el mando Pro de Nintendo Switch tienen mucho en común. Tienen muchas de las características que se esperan de los mandos de juego modernos. También tienen una entrada increíblemente versátil e infrautilizada que su mayor rival (el mando de la Xbox One de Microsoft) no tiene: el giroscopio.

El objetivo con JoyShockLibrary es permitir a los desarrolladores de juegos soportar DS4, DS, Joy-Cons, y Pro Controllers de forma nativa en los juegos de PC. He compilado la biblioteca para Windows, pero utiliza herramientas agnósticas, y espero que otros desarrolladores puedan hacerla funcionar en otras plataformas (como Linux o Mac) sin demasiados problemas.

Reference

JoyShockLibrary.h has everything you need to use the library, but here's a breakdown of everything in there.

Structs

struct JOY_SHOCK_STATE - This struct contains the state for all the sticks, buttons, and triggers on the controller. If you're just using JoyShockLibrary to be able to use JoyCons, Pro Controllers, and DualShock 4s similarly to how you'd use other devices, this has everything you need to know.

  • int buttons contains the states of all the controller's buttons with the following masks:
    • 0x00001 - d-pad up
    • 0x00002 - d-pad down
    • 0x00004 - d-pad left
    • 0x00008 - d-pad right
    • 0x00010 - + on Nintendo devices, Options on DS4
    • 0x00020 - - on Nintendo devices, Share on DS4
    • 0x00040 - left-stick click on Nintendo devices, L3 on DS4
    • 0x00080 - right-stick click on Nintendo devices, R3 on DS4
    • 0x00100 - L on Nintendo devices, L1 on DS4
    • 0x00200 - R on Nintendo devices, R1 on DS4
    • 0x00400 - ZL on Nintendo devices, L2 on DS4
    • 0x00800 - ZR on Nintendo devices, R2 on DS4
    • 0x01000 - the South face-button: B on Nintendo devices, ⨉ on DS4
    • 0x02000 - the East face-button: A on Nintendo devices, ○ on DS4
    • 0x04000 - the West face-button: Y on Nintendo devices, □ on DS4
    • 0x08000 - the North face-button: X on Nintendo devices, △ on DS4
    • 0x10000 - Home on Nintendo devices, PS on DS4
    • 0x20000 - Capture on Nintendo devices, touchpad click on DS4
    • 0x40000 - SL on Nintendo JoyCons
    • 0x80000 - SR on Nintendo JoyCons
  • float lTrigger - how far has the left trigger been pressed? This will be 1 or 0 on Nintendo devices, which don't have analog triggers
  • float rTrigger - how far has the right trigger been pressed? This will be 1 or 0 on Nintendo devices, which don't have analog triggers
  • float stickLX, stickLY - left-stick X axis and Y axis, respectively, from -1 to 1
  • float stickRX, stickRX - right-stick X axis and Y axis, respectively, from -1 to 1

struct IMU_STATE - Each supported device contains an IMU which has a 3-axis accelerometer and a 3-axis gyroscope. IMU_STATE is where you find that info.

  • float accelX, accelY, accelZ - accelerometer X axis, Y axis, and Z axis, respectively, in g (g-force).
  • float gyroX, gyroY, gyroZ - gyroscope angular velocity X, Y, and Z, respectively, in dps (degrees per second), when correctly calibrated.

Functions

All these functions should be thread-safe, and none of them should cause any harm if given the wrong handle. If they do, please report this to me as an isuse.

int JslConnectDevices() - Register any connected devices. Returns the number of devices connected, which is helpful for getting the handles for those devices with the next function.

int JslGetConnectedDeviceHandles(int* deviceHandleArray, int size) - Fills the array deviceHandleArray of size size with the handles for all connected devices, up to the length of the array. Use the length returned by JslConnectDevices to make sure you've got all connected devices' handles.

void JslDisconnectAndDisposeAll() - Disconnect devices, no longer polling them for input.

JOY_SHOCK_STATE JslGetSimpleState(int deviceId) - Get the latest button + trigger + stick state for the controller with the given id.

IMU_STATE JslGetIMUState(int deviceId) - Get the latest accelerometer + gyroscope state for the controller with the given id.

int JslGetButtons(int deviceId) - Get the latest button state for the controller with the given id. If you want more than just the buttons, it's more efficient to use JslGetSimpleState.

float JslGetLeftX/JslGetLeftY/JslGetRightX/JslGetRightY(int deviceId) - Get the latest stick state for the controller with the given id. If you want more than just a single stick axis, it's more efficient to use JslGetSimpleState.

float JslGetLeftTrigger/JslGetRightTrigger(int deviceId) - Get the latest trigger state for the controller with the given id. If you want more than just a single trigger, it's more efficient to use JslGetSimpleState.

float JslGetGyroX/JslGetGyroY/JslGetGyroZ(int deviceId) - Get the latest angular velocity for a given gyroscope axis. If you want more than just a single gyroscope axis velocity, it's more efficient to use JslGetIMUState.

float JslGetAccelX/JslGetAccelY/JslGetAccelZ(int deviceId) - Get the latest acceleration for a given axis. If you want more than just a accelerometer axis, it's more efficient to use JslGetIMUState.

float JslGetStickStep(int deviceId) - Different devices use different size data types and different ranges on those data types when reporting stick axes. For some calculations, it may be important to know the limits of the current device and work around them in different ways. This gives the smallest step size between two values for the given device's analog sticks.

float JslGetTriggerStep(int deviceId) - Some devices have analog triggers, some don't. For some calculations, it may be important to know the limits of the current device and work around them in different ways. This gives the smallest step size between two values for the given device's triggers, or 1.0 if they're actually just binary inputs.

float JslGetTriggerStep(int deviceId) - Some devices have analog triggers, some don't. For some calculations, it may be important to know the limits of the current device and work around them in different ways. This gives the smallest step size between two values for the given device's triggers, or 1.0 if they're actually just binary inputs.

float JslGetPollRate(int deviceId) - Different devices report back new information at different rates. For the given device, this gives how many times one would usually expect the device to report back per second.

void JslResetContinuousCalibration(int deviceId) - JoyShockLibrary has helpful functions for calibrating the gyroscope by averaging out its input over time. This deletes all calibration data that's been accumulated, if any, this session.

void JslStartContinuousCalibration(int deviceId) - Start collecting gyro data, recording the ongoing average and using that to offset gyro output.

void JslPauseContinuousCalibration(int deviceId) - Stop collecting gyro data, but don't delete it.

void JslGetCalibrationOffset(int deviceId, float& xOffset, float& yOffset, float& zOffset) - Get the calibrated offset value for the given device's gyro. You don't have to use it; all gyro output for this device is already being offset by this vector before leaving JoyShockLibrary.

void JslSetCalibrationOffset(int deviceId, float xOffset, float yOffset, float zOffset) - Manually set the calibrated offset value for the given device's gyro.

void JslSetCallback(void(*callback)(int, JOY_SHOCK_STATE, JOY_SHOCK_STATE, IMU_STATE, IMU_STATE, float)) - Set a callback function by which JoyShockLibrary can report the current state for each device. This callback will be given the deviceId for the reporting device, its current button + trigger + stick state, its previous button + trigger + stick state, its current accelerometer + gyro state, its previous accelerometer + gyro state, and the amount of time since the last report for this device (in seconds).

int JslGetControllerType(int deviceId) - What type of controller is this device?

  • Left JoyCon
  • Right JoyCon
  • Switch Pro Controller
  • DualShock 4

int JslGetControllerSplitType(int deviceId) - Is this a half-controller or full? If half, what kind?

  • Left half
  • Right half
  • Full controller

int JslGetControllerColour(int deviceId) - Get the colour of the controller. Only Nintendo devices support this. Others will report white.

void JslSetLightColour(int deviceId, int colour) - Set the light colour on the given controller. Only DualShock 4s support this. Players will often prefer to be able to disable the light, so make sure to give them that option, but when setting players up in a local multiplayer game, setting the light colour is a useful way to uniquely identify different controllers.

void JslSetPlayerNumber(int deviceId, int number) - Set the lights that indicate player number. This only works on Nintendo devices.

void JslSetRumble(int deviceId, int smallRumble, int bigRumble) - DualShock 4s have two types of rumble, and they can be set at the same time with different intensities. These can be set from 0 to 255. Nintendo devices support rumble as well, but totally differently. They call it "HD rumble", and it's a great feature, but JoyShockLibrary doesn't yet support it.

Known and Perceived Issues

Bluetooth connectivity

JoyShockLibrary doesn't yet support setting rumble and light colour for the DualShock 4 via Bluetooth.

JoyCons and Pro Controllers can only be connected by Bluetooth. Some Bluetooth adapters can't keep up with these devices, resulting in laggy input. This is especially common when more than one device is connected (such as when using a pair of JoyCons). There is nothing JoyShockMapper or JoyShockLibrary can do about this.

Gyro poll rate on Nintendo devices

The Nintendo devices report every 15ms, but their IMUs actually report every 5ms. Every 15ms report includes the last 3 gyro and accelerometer reports. When creating the latest IMU state for Nintendo devices, JoyShockLibrary averages out those 3 gyro and accelerometer reports, so that it can best include all that information in a sensible format. For things like controlling a cursor on a plane, this should be of little to no consequence, since the result is the same as adding all 3 reports separately over shorter time intervals. But for representing real 3D rotations of the controller, this causes the Nintendo devices to be slightly less accurate than they could be, because we're combining 3 rotations in a simplistic way.

In a future version I hope to either combine the 3 rotations in a way that works better in 3D, or to add a way for a single controller event to report several IMU events at the same time.

Credits

I'm Jibb Smart, and I made JoyShockLibrary.

JoyShockLibrary uses substantial portions of mfosse's JoyCon-Driver, a vJoy feeder for most communication with Nintendo devices, building on it with info from dekuNukem's Nintendo Switch Reverse Engineering page in order to (for example) unpack all gyro and accelerometer samples from each report.

JoyShockLibrary's DualShock 4 support would likely not be possible without the info available on PSDevWiki and Eleccelerator Wiki. chrippa's ds4drv was also a handy reference for getting rumble and lights working right away.

This software also relies on and links signal11's HIDAPI to connect to USB and Bluetooth devices. Since HIDAPI is linked statically, .objs are included. Since .objs may need to be compiled with the same compiler version as the dll itself, HIDAPI itself is included in a .zip.


Que novedades incluye la versión 3.0

Released

La versión 3 mejora la seguridad de los hilos y el comportamiento de JslConnectDevices para que pueda ser llamado sin restablecer las conexiones actuales. También mejora la calibración automática y añade funciones para ayudar a obtener una entrada de giroscopio útil y de alta resolución. También incluye un montón de nuevas características de calidad de vida.

Busque estas nuevas funciones en el README:

  • JslSetGyroSpace (opciones de giroscopio que se adaptan a la orientación preferida del controlador del jugador)
  • JslGetAndFlushAccumulatedGyro (obtiene el movimiento completo del giroscopio incluso cuando se sondea a baja velocidad)
  • JslSetConnectCallback
  • JslSetDisconnectCallback
  • JslGetTimeSinceLastUpdate
  • JslGetControllerInfoAndSettings
  • JslGetAutoCalibrationStatus

No te pierdas nada, síguenos en Twitter, Mastodon o Threads!
Preguntas, aportes y peticiones en el foro.

  • Contenido similar

    • Por Dekuwa
      shadPS4 es un emulador de PS4 para Windows, macOS y Linux escrito en C++.
      Está en sus primeras etapas de desarrollo. Actualmente, sólo puede cargar archivos ELF de PS4.

      El progreso se centra en videoout_basic.elf de las demos SDK. Actualmente, puede cargar con gráficos completamente funcionales. Otros probablemente no se ejecutarán, ya que podría no ser capaz de reubicar todas las funciones necesarias.
      shadPS4 ha sido creado por georgemoralis.
    • Por Dekuwa
      ColorControl es una aplicación para Windows que nos permite cambiar fácilmente la configuración de pantalla de NVIDIA y AMD y/o controlar los televisores LG y Samsung para tener acceso desde el ordenador a diferentes configuraciones, menús ocultos y demás.

      Controlador NVIDIA/AMD
      Si posee una tarjeta gráfica NVIDIA o AMD, esta aplicación le permite no solo ajustar la configuración básica de la pantalla, sino también algunas configuraciones ocultas. Para las tarjetas gráficas NVIDIA y AMD, puede configurar sus propios ajustes preestablecidos para cambiar la profundidad de color (6 a 16 bpc), el formato de color (RGB/YUV), la frecuencia de actualización, el tramado y la configuración HDR. Puede asignar un método abreviado de teclado global a cada ajuste preestablecido para cambiar la configuración de pantalla (¡y HDR!) con solo presionar un par de teclas. El controlador NVIDIA incluso tiene algunas opciones más:
      Rango dinámico: VESA (RGB completo) o CEA (RGB/YUV limitado) Espacio de color: para cambiar el espacio de color, pero es posible que su televisor no admita la mayoría Tramado: puede definir el modo de tramado (Temporal o Espacial) y la profundidad de bits del tramado. Notas:
      Para que se aplique una configuración específica, debe incluirla dentro del ajuste preestablecido. Simplemente haga clic en el elemento del menú "Incluir" y una vez marcado, estará listo.
      Controlador LG
      Si posee un televisor LG reciente (2018 o posterior, es posible que funcione uno anterior), puede controlar su televisor a través de la aplicación (no se necesita tarjeta gráfica NVIDIA o AMD). Al iniciar la aplicación, detectará automáticamente los televisores (ver más abajo) si están en la misma red que su PC.
      Si un televisor está encendido, mostrará una ventana emergente mediante la cual podrá permitir que ColorControl envíe comandos a su televisor. Esto solo sucederá la primera vez o cada vez que haya un cambio en los permisos requeridos. Es posible que una nueva versión de ColorControl necesite esto.
      También es posible agregar un televisor manualmente usando el botón "Agregar". Se requiere un nombre y una dirección IP, la dirección MAC solo es necesaria para Wake-On-Lan. También puedes configurar cuándo encender o apagar automáticamente tu televisor:
      Encendido después del inicio de la PC Encendido después de reanudar Apagar al apagar Apagar en espera Apagar en el protector de pantalla y encender cuando el protector de pantalla se desactiva Preajustes
      Con los ajustes preestablecidos puedes realizar acciones en tu televisor que normalmente harías a través del control remoto. Propiedades de un preset:
      Nombre: complete su propio nombre/descripción Dispositivo: seleccione el televisor en el que realizar la acción. El valor predeterminado es "Dispositivo seleccionado globalmente", que es el dispositivo seleccionado en el menú desplegable de dispositivos superior. Aplicación: seleccione la aplicación para iniciar que esté instalada en su televisor (opcional) Atajo: ingrese el atajo global para ejecutar este ajuste preestablecido Pasos: pasos a ejecutar de forma secuencial. Estos pasos pueden ser: Botones del control remoto: como DERECHA, IZQUIERDA, ENTRAR, etc. Acciones: cambie directamente la configuración de la imagen como luz de fondo, contraste, modo de imagen, etc. En un cuadro de diálogo debe especificar el valor. Ajustes preestablecidos de NVIDIA/AMD: agregue aquí los ajustes preestablecidos de NVIDIA o AMD que también deben ejecutarse Además, puede agregar un activador a un ajuste preestablecido, lo que significa que se ejecutará automáticamente cuando se esté ejecutando un proceso en su PC.
      Detección automática de tu televisor
      Compruebe si el televisor aparece en el Administrador de dispositivos de Windows (Win+X -> Administrador de dispositivos) en Dispositivos de medios digitales. De lo contrario, agregue el televisor usando Configuración (Win+I) -> "Dispositivos" -> "Agregar Bluetooth u otro dispositivo" -> "Todo lo demás", luego seleccione su televisor por nombre. Ahora debería aparecer en el Administrador de dispositivos. (Si su televisor no se muestra al agregar dispositivos, entonces su PC no puede ver el televisor en la red, verifique la configuración de red tanto en la PC como en el televisor).
      NOTA: Es posible que deba agregar el televisor como dispositivo más de una vez antes. aparece en el Administrador de dispositivos, ya que Windows puede detectar el televisor como varios dispositivos.
      WinPcap ya no se usa de forma predeterminada, pero si recibe errores de WinPcap, descargue e instale Npcap en el modo de compatibilidad con WinPcap. WinPcap se deprecia en Windows 10.
      En la pestaña Opciones puede ajustar algunos parámetros y/o habilitar algunas configuraciones.
      ColorControl es una aplicación creada por Maassoft.
    • Por Dekuwa
      Flyby11 es un parche simple que elimina las molestas restricciones que te impiden instalar Windows 11 (24H2) en hardware no compatible. ¿Tienes una PC vieja? ¿No tienes TPM, Secure Boot o tu procesador no es compatible? Flyby11 te permite instalar Windows 11 24H2 de todos modos.
      No hay pasos complicados. Simplemente ejecuta la herramienta y estarás ejecutando Windows 11 en tu máquina obsoleta en poco tiempo. Piensa en ello como si te escabulleras por la puerta trasera sin que nadie se dé cuenta.

      Descripción técnica
      Flyby11 aprovecha una característica del proceso de instalación de Windows 11 que utiliza la variante de Windows Server de la instalación. Esta variante, a diferencia de la instalación normal de Windows 11, omite la mayoría de las comprobaciones de compatibilidad de hardware, lo que le permite ejecutarse en sistemas no compatibles. A continuación, se incluye un desglose más técnico del proceso:
      Configuración de Windows Server: la herramienta utiliza la variante de Windows Server de la instalación, que evita las comprobaciones habituales de elementos como TPM, arranque seguro y requisitos específicos del procesador. Instalación de Windows 11 normal: aunque la instalación se ejecuta en modo servidor, instala la versión normal de Windows 11 (no la versión servidor). Preparación manual de la ISO: Flyby11 automatiza la descarga y el montaje de la ISO, por lo que no es necesario modificar nada manualmente.
      Flyby11 ha sido creado por bel.
    • Por Dekuwa
      Calibre es una aplicación para Windows, macOS y Linux que nos permite gestionar todo lo relacionado con nuestros eBooks, como pasar archivos .epub del ordenador a un lector de libros electrónicos como el Kindle, hacer copias de seguridad o administrar nuestra biblioteca, entre otras cosas.

      Como meter libros en Kindle utilizando Calibre
      Añadir libros a un Kindle en formato .epub utilizando Calibre es un proceso rápido y sencillo. Una vez tengamos descargado el archivo .epub del libro en cuestión solo tenemos que conectar el Kindle al ordenador, sea por WiFi o USB, y seguir estos pasos:
      Utilizar la opción "Añadir libro", situada en la parte superior izquierda, seleccionar el .epub y aceptar. Una vez añadido el libro a Calibre, simplemente elegimos la opción "Enviar al dispositivo" -> "Enviar formato específico para" -> "Memoria Principal". Aceptamos, esperamos que termine y listo, ya lo tendremos en nuestra biblioteca de Kindle listo para ser leído.
    • Por Dekuwa
      Bloatynosy es una aplicación para para Windows 10 y  Windows 11 que nos permite personalizar fácilmente nuestro sistema.

      Características:
      Funciones nativas (sin aplicaciones web basura) Volvemos a lo básico: eficiente y fácil de usar Sin integración con IA/Copilot Enfocado en lo esencial Qué viene a continuación:
      WinModder regresa para ofrecer aún más personalizaciones Próximamente habrá localizaciones para un alcance global Bloatynosy Nue es una aplicación creada por Bel.
×
×
  • Crear nuevo...