Files
RetroArch/input/include/hid_driver.h
T
LibretroAdmin 661fdde857 Input: motion from Switch Pro Controllers on the hid joypad driver
The Pro Controller, and the pads that pass for one (8BitDo's in Switch
mode among them), now give a core their accelerometer and gyroscope,
read as SDL reads them:

- The sensors' calibration is read from the pad's flash with the stick
  calibration: the factory's at 0x6020, then the user's origins at
  0x8026 where the user calibrated.
- Subcommand 0x40 turns the sensors on while a core asks for them and
  off when it is done, sent from the poll like the player lights.
- Each report 0x30 carries three samples; the newest one is kept. The
  values go out in g and radians a second, on the axes SDL gives them,
  which are the DualShock 4's, and so on the same axes as winraw's
  DualShock 4 and DualSense.

How it gets there:
- Pad handlers can now have set_sensor and sensor ops.
- hidraw and winusb route the driver's sensor calls to the slot's
  handler.
- The hid joypad driver passes the frontend's set_sensor_state and
  get_sensor_input on to its hid driver.
- The beside layer sends a hid pad's sensor calls to the hid driver
  rather than to the joypad driver it stands beside.

connect_parity_test checks the calibration reads, the 0x40 commands and
the values from a sample.
2026-10-22 02:33:45 +02:00

82 lines
3.5 KiB
C

/* RetroArch - A frontend for libretro.
* Copyright (C) 2010-2014 - Hans-Kristian Arntzen
* Copyright (C) 2011-2017 - Daniel De Matteis
* Copyright (C) 2016-2017 - Andrés Suárez
*
* RetroArch is free software: you can redistribute it and/or modify it under the terms
* of the GNU General Public License as published by the Free Software Found-
* ation, either version 3 of the License, or (at your option) any later version.
*
* RetroArch is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
* PURPOSE. See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along with RetroArch.
* If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef HID_DRIVER_H__
#define HID_DRIVER_H__
#include "../connect/joypad_connection.h"
#include "../input_driver.h"
/* what is 1? */
#define HID_REPORT_INPUT 1
#define HID_REPORT_OUTPUT 2
#define HID_REPORT_FEATURE 3
#define HID_REPORT_COUNT 4
/* are there more? */
/*
* This is the interface for the HID subsystem.
*
* The handle parameter is the pointer returned by init() and stores the implementation
* state data for the HID driver.
*/
struct input_pad_view;
struct hid_driver
{
void *(*init)(void);
bool (*query_pad)(void *handle, unsigned pad);
void (*free)(const void *handle);
int16_t (*button)(void *handle, unsigned pad, uint16_t button);
int16_t (*state)(void *data, rarch_joypad_info_t *joypad_info,
const uint16_t *joykeys, const uint32_t *joyaxes, unsigned port);
void (*get_buttons)(void *handle, unsigned pad, input_bits_t *state);
int16_t (*axis)(void *handle, unsigned pad, uint32_t axis);
void (*poll)(void *handle);
bool (*set_rumble)(void *handle, unsigned pad, enum retro_rumble_effect effect, uint16_t);
const char *(*name)(void *handle, unsigned pad);
const char *ident;
void (*send_control)(void *handle, uint8_t *s, size_t len);
int32_t (*set_report)(void *handle, uint8_t report_type, uint8_t report_id, uint8_t *data, size_t len);
int32_t (*get_report)(void *handle, uint8_t report_type, uint8_t report_id, uint8_t *data, size_t len);
int32_t (*set_idle)(void *handle, uint8_t amount);
int32_t (*set_protocol)(void *handle, uint8_t protocol);
int32_t (*read)(void *handle, void *s, size_t len);
/* as input_device_driver_t's */
bool (*get_bt_host)(void *handle, unsigned pad, uint8_t *addr);
bool (*set_bt_host)(void *handle, unsigned pad, const uint8_t *addr);
/* Whether the device - send_control's handle - is on Bluetooth, for
* a handler whose reports differ by the way the pad came and which
* cannot tell it by their length: Windows gives every report at the
* longest one's length. NULL where the lengths tell. */
bool (*is_bluetooth)(void *handle);
/* as input_device_driver_t's: the player @pad's lights are to show */
void (*set_player)(void *handle, unsigned pad, unsigned player);
/* as input_device_driver_t's: pad @pad's state, unchanged until the
* next poll; NULL where it cannot be lent */
const struct input_pad_view *(*view)(void *handle, unsigned pad);
/* as input_device_driver_t's: pad @pad's motion sensors; NULL where
* the driver reads none */
bool (*set_sensor_state)(void *handle, unsigned pad,
enum retro_sensor_action action, unsigned rate);
bool (*get_sensor_input)(void *handle, unsigned pad, unsigned id,
float *value);
};
#endif /* HID_DRIVER_H__ */