// SPDX-License-Identifier: GPL-2.0+
/*
* HID driver for Nintendo Switch Joy - Cons and Pro Controllers
*
* Copyright ( c ) 2019 - 2021 Daniel J . Ogorchock < djogorchock @ gmail . com >
* Portions Copyright ( c ) 2020 Nadia Holmquist Pedersen < nadia @ nhp . sh >
* Copyright ( c ) 2022 Emily Strickland < linux @ emily . st >
* Copyright ( c ) 2023 Ryan McClelland < rymcclel @ gmail . com >
*
* The following resources / projects were referenced for this driver :
* https : //github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering
* https : //gitlab.com/pjranki/joycon-linux-kernel (Peter Rankin)
* https : //github.com/FrotBot/SwitchProConLinuxUSB
* https : //github.com/MTCKC/ProconXInput
* https : //github.com/Davidobot/BetterJoyForCemu
* hid - wiimote kernel hid driver
* hid - logitech - hidpp driver
* hid - sony driver
*
* This driver supports the Nintendo Switch Joy - Cons and Pro Controllers . The
* Pro Controllers can either be used over USB or Bluetooth .
*
* This driver also incorporates support for Nintendo Switch Online controllers
* for the NES , SNES , Sega Genesis , and N64 .
*
* The driver will retrieve the factory calibration info from the controllers ,
* so little to no user calibration should be required .
*
*/
#include "hid-ids.h"
#include <linux/unaligned.h>
#include <linux/delay.h>
#include <linux/device.h>
#include <linux/kernel.h>
#include <linux/hid.h>
#include <linux/idr.h>
#include <linux/input.h>
#include <linux/jiffies.h>
#include <linux/leds.h>
#include <linux/module.h>
#include <linux/power_supply.h>
#include <linux/spinlock.h>
/*
* Reference the url below for the following HID report defines :
* https : //github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering
*/
/* Output Reports */
#define JC_OUTPUT_RUMBLE_AND_SUBCMD
0 x01
#define JC_OUTPUT_FW_UPDATE_PKT
0 x03
#define JC_OUTPUT_RUMBLE_ONLY
0 x10
#define JC_OUTPUT_MCU_DATA
0 x11
#define JC_OUTPUT_USB_CMD
0 x80
/* Subcommand IDs */
#define JC_SUBCMD_STATE
0 x00
#define JC_SUBCMD_MANUAL_BT_PAIRING
0 x01
#define JC_SUBCMD_REQ_DEV_INFO
0 x02
#define JC_SUBCMD_SET_REPORT_MODE
0 x03
#define JC_SUBCMD_TRIGGERS_ELAPSED
0 x04
#define JC_SUBCMD_GET_PAGE_LIST_STATE
0 x05
#define JC_SUBCMD_SET_HCI_STATE
0 x06
#define JC_SUBCMD_RESET_PAIRING_INFO
0 x07
#define JC_SUBCMD_LOW_POWER_MODE
0 x08
#define JC_SUBCMD_SPI_FLASH_READ
0 x10
#define JC_SUBCMD_SPI_FLASH_WRITE
0 x11
#define JC_SUBCMD_RESET_MCU
0 x20
#define JC_SUBCMD_SET_MCU_CONFIG
0 x21
#define JC_SUBCMD_SET_MCU_STATE
0 x22
#define JC_SUBCMD_SET_PLAYER_LIGHTS
0 x30
#define JC_SUBCMD_GET_PLAYER_LIGHTS
0 x31
#define JC_SUBCMD_SET_HOME_LIGHT
0 x38
#define JC_SUBCMD_ENABLE_IMU
0 x40
#define JC_SUBCMD_SET_IMU_SENSITIVITY
0 x41
#define JC_SUBCMD_WRITE_IMU_REG
0 x42
#define JC_SUBCMD_READ_IMU_REG
0 x43
#define JC_SUBCMD_ENABLE_VIBRATION
0 x48
#define JC_SUBCMD_GET_REGULATED_VOLTAGE
0 x50
/* Input Reports */
#define JC_INPUT_BUTTON_EVENT
0 x3F
#define JC_INPUT_SUBCMD_REPLY
0 x21
#define JC_INPUT_IMU_DATA
0 x30
#define JC_INPUT_MCU_DATA
0 x31
#define JC_INPUT_USB_RESPONSE
0 x81
/* Feature Reports */
#define JC_FEATURE_LAST_SUBCMD
0 x02
#define JC_FEATURE_OTA_FW_UPGRADE
0 x70
#define JC_FEATURE_SETUP_MEM_READ
0 x71
#define JC_FEATURE_MEM_READ
0 x72
#define JC_FEATURE_ERASE_MEM_SECTOR
0 x73
#define JC_FEATURE_MEM_WRITE
0 x74
#define JC_FEATURE_LAUNCH
0 x75
/* USB Commands */
#define JC_USB_CMD_CONN_STATUS
0 x01
#define JC_USB_CMD_HANDSHAKE
0 x02
#define JC_USB_CMD_BAUDRATE_3M
0 x03
#define JC_USB_CMD_NO_TIMEOUT
0 x04
#define JC_USB_CMD_EN_TIMEOUT
0 x05
#define JC_USB_RESET
0 x06
#define JC_USB_PRE_HANDSHAKE
0 x91
#define JC_USB_SEND_UART
0 x92
/* Magic value denoting presence of user calibration */
#define JC_CAL_USR_MAGIC_0
0 xB2
#define JC_CAL_USR_MAGIC_1
0 xA1
#define JC_CAL_USR_MAGIC_SIZE
2
/* SPI storage addresses of user calibration data */
#define JC_CAL_USR_LEFT_MAGIC_ADDR
0 x8010
#define JC_CAL_USR_LEFT_DATA_ADDR
0 x8012
#define JC_CAL_USR_LEFT_DATA_END
0 x801A
#define JC_CAL_USR_RIGHT_MAGIC_ADDR
0 x801B
#define JC_CAL_USR_RIGHT_DATA_ADDR
0 x801D
#define JC_CAL_STICK_DATA_SIZE \
(JC_CAL_USR_LEFT_DATA_END - JC_CAL_USR_LEFT_DATA_ADDR +
1 )
/* SPI storage addresses of factory calibration data */
#define JC_CAL_FCT_DATA_LEFT_ADDR
0 x603d
#define JC_CAL_FCT_DATA_RIGHT_ADDR
0 x6046
/* SPI storage addresses of IMU factory calibration data */
#define JC_IMU_CAL_FCT_DATA_ADDR
0 x6020
#define JC_IMU_CAL_FCT_DATA_END
0 x6037
#define JC_IMU_CAL_DATA_SIZE \
(JC_IMU_CAL_FCT_DATA_END - JC_IMU_CAL_FCT_DATA_ADDR +
1 )
/* SPI storage addresses of IMU user calibration data */
#define JC_IMU_CAL_USR_MAGIC_ADDR
0 x8026
#define JC_IMU_CAL_USR_DATA_ADDR
0 x8028
/* The raw analog joystick values will be mapped in terms of this magnitude */
#define JC_MAX_STICK_MAG
32767
#define JC_STICK_FUZZ
250
#define JC_STICK_FLAT
500
/* Hat values for pro controller's d-pad */
#define JC_MAX_DPAD_MAG
1
#define JC_DPAD_FUZZ
0
#define JC_DPAD_FLAT
0
/* Under most circumstances IMU reports are pushed every 15ms; use as default */
#define JC_IMU_DFLT_AVG_DELTA_MS
15
/* How many samples to sum before calculating average IMU report delta */
#define JC_IMU_SAMPLES_PER_DELTA_AVG
300
/* Controls how many dropped IMU packets at once trigger a warning message */
#define JC_IMU_DROPPED_PKT_WARNING
3
/*
* The controller ' s accelerometer has a sensor resolution of 16 bits and is
* configured with a range of + - 8000 milliGs . Therefore , the resolution can be
* calculated thus : ( 2 ^ 16 - 1 ) / ( 8000 * 2 ) = 4 . 096 digits per milliG
* Resolution per G ( rather than per millliG ) : 4 . 096 * 1000 = 4096 digits per G
* Alternatively : 1 / 4096 = . 0002441 Gs per digit
*/
#define JC_IMU_MAX_ACCEL_MAG
32767
#define JC_IMU_ACCEL_RES_PER_G
4096
#define JC_IMU_ACCEL_FUZZ
10
#define JC_IMU_ACCEL_FLAT
0
/*
* The controller ' s gyroscope has a sensor resolution of 16 bits and is
* configured with a range of + - 2000 degrees / second .
* Digits per dps : ( 2 ^ 16 - 1 ) / ( 2000 * 2 ) = 16 . 38375
* dps per digit : 16 . 38375 E - 1 = . 0610
*
* STMicro recommends in the datasheet to add 15 % to the dps / digit . This allows
* the full sensitivity range to be saturated without clipping . This yields more
* accurate results , so it ' s the technique this driver uses .
* dps per digit ( corrected ) : . 0610 * 1 . 15 = . 0702
* digits per dps ( corrected ) : . 0702 E - 1 = 14 . 247
*
* Now , 14 . 247 truncating to 14 loses a lot of precision , so we rescale the
* min / max range by 1000 .
*/
#define JC_IMU_PREC_RANGE_SCALE
1000
/* Note: change mag and res_per_dps if prec_range_scale is ever altered */
#define JC_IMU_MAX_GYRO_MAG
32767000 /* (2^16-1)*1000 */
#define JC_IMU_GYRO_RES_PER_DPS
14247 /* (14.247*1000) */
#define JC_IMU_GYRO_FUZZ
10
#define JC_IMU_GYRO_FLAT
0
/* frequency/amplitude tables for rumble */
struct joycon_rumble_freq_data {
u16 high;
u8 low;
u16 freq;
/* Hz*/
};
struct joycon_rumble_amp_data {
u8 high;
u16 low;
u16 amp;
};
#if IS_ENABLED(CONFIG_NINTENDO_FF)
/*
* These tables are from
* https : //github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/rumble_data_table.md
*/
static const struct joycon_rumble_freq_data joycon_rumble_frequencies[] = {
/* high, low, freq */
{
0 x0000,
0 x01,
41 }, {
0 x0000,
0 x02,
42 }, {
0 x0000,
0 x03,
43 },
{
0 x0000,
0 x04,
44 }, {
0 x0000,
0 x05,
45 }, {
0 x0000,
0 x06,
46 },
{
0 x0000,
0 x07,
47 }, {
0 x0000,
0 x08,
48 }, {
0 x0000,
0 x09,
49 },
{
0 x0000,
0 x0A,
50 }, {
0 x0000,
0 x0B,
51 }, {
0 x0000,
0 x0C,
52 },
{
0 x0000,
0 x0D,
53 }, {
0 x0000,
0 x0E,
54 }, {
0 x0000,
0 x0F,
55 },
{
0 x0000,
0 x10,
57 }, {
0 x0000,
0 x11,
58 }, {
0 x0000,
0 x12,
59 },
{
0 x0000,
0 x13,
60 }, {
0 x0000,
0 x14,
62 }, {
0 x0000,
0 x15,
63 },
{
0 x0000,
0 x16,
64 }, {
0 x0000,
0 x17,
66 }, {
0 x0000,
0 x18,
67 },
{
0 x0000,
0 x19,
69 }, {
0 x0000,
0 x1A,
70 }, {
0 x0000,
0 x1B,
72 },
{
0 x0000,
0 x1C,
73 }, {
0 x0000,
0 x1D,
75 }, {
0 x0000,
0 x1e,
77 },
{
0 x0000,
0 x1f,
78 }, {
0 x0000,
0 x20,
80 }, {
0 x0400,
0 x21,
82 },
{
0 x0800,
0 x22,
84 }, {
0 x0c00,
0 x23,
85 }, {
0 x1000,
0 x24,
87 },
{
0 x1400,
0 x25,
89 }, {
0 x1800,
0 x26,
91 }, {
0 x1c00,
0 x27,
93 },
{
0 x2000,
0 x28,
95 }, {
0 x2400,
0 x29,
97 }, {
0 x2800,
0 x2a,
99 },
{
0 x2c00,
0 x2b,
102 }, {
0 x3000,
0 x2c,
104 }, {
0 x3400,
0 x2d,
106 },
{
0 x3800,
0 x2e,
108 }, {
0 x3c00,
0 x2f,
111 }, {
0 x4000,
0 x30,
113 },
{
0 x4400,
0 x31,
116 }, {
0 x4800,
0 x32,
118 }, {
0 x4c00,
0 x33,
121 },
{
0 x5000,
0 x34,
123 }, {
0 x5400,
0 x35,
126 }, {
0 x5800,
0 x36,
129 },
{
0 x5c00,
0 x37,
132 }, {
0 x6000,
0 x38,
135 }, {
0 x6400,
0 x39,
137 },
{
0 x6800,
0 x3a,
141 }, {
0 x6c00,
0 x3b,
144 }, {
0 x7000,
0 x3c,
147 },
{
0 x7400,
0 x3d,
150 }, {
0 x7800,
0 x3e,
153 }, {
0 x7c00,
0 x3f,
157 },
{
0 x8000,
0 x40,
160 }, {
0 x8400,
0 x41,
164 }, {
0 x8800,
0 x42,
167 },
{
0 x8c00,
0 x43,
171 }, {
0 x9000,
0 x44,
174 }, {
0 x9400,
0 x45,
178 },
{
0 x9800,
0 x46,
182 }, {
0 x9c00,
0 x47,
186 }, {
0 xa000,
0 x48,
190 },
{
0 xa400,
0 x49,
194 }, {
0 xa800,
0 x4a,
199 }, {
0 xac00,
0 x4b,
203 },
{
0 xb000,
0 x4c,
207 }, {
0 xb400,
0 x4d,
212 }, {
0 xb800,
0 x4e,
217 },
{
0 xbc00,
0 x4f,
221 }, {
0 xc000,
0 x50,
226 }, {
0 xc400,
0 x51,
231 },
{
0 xc800,
0 x52,
236 }, {
0 xcc00,
0 x53,
241 }, {
0 xd000,
0 x54,
247 },
{
0 xd400,
0 x55,
252 }, {
0 xd800,
0 x56,
258 }, {
0 xdc00,
0 x57,
263 },
{
0 xe000,
0 x58,
269 }, {
0 xe400,
0 x59,
275 }, {
0 xe800,
0 x5a,
281 },
{
0 xec00,
0 x5b,
287 }, {
0 xf000,
0 x5c,
293 }, {
0 xf400,
0 x5d,
300 },
{
0 xf800,
0 x5e,
306 }, {
0 xfc00,
0 x5f,
313 }, {
0 x0001,
0 x60,
320 },
{
0 x0401,
0 x61,
327 }, {
0 x0801,
0 x62,
334 }, {
0 x0c01,
0 x63,
341 },
{
0 x1001,
0 x64,
349 }, {
0 x1401,
0 x65,
357 }, {
0 x1801,
0 x66,
364 },
{
0 x1c01,
0 x67,
372 }, {
0 x2001,
0 x68,
381 }, {
0 x2401,
0 x69,
389 },
{
0 x2801,
0 x6a,
397 }, {
0 x2c01,
0 x6b,
406 }, {
0 x3001,
0 x6c,
415 },
{
0 x3401,
0 x6d,
424 }, {
0 x3801,
0 x6e,
433 }, {
0 x3c01,
0 x6f,
443 },
{
0 x4001,
0 x70,
453 }, {
0 x4401,
0 x71,
462 }, {
0 x4801,
0 x72,
473 },
{
0 x4c01,
0 x73,
483 }, {
0 x5001,
0 x74,
494 }, {
0 x5401,
0 x75,
504 },
{
0 x5801,
0 x76,
515 }, {
0 x5c01,
0 x77,
527 }, {
0 x6001,
0 x78,
538 },
{
0 x6401,
0 x79,
550 }, {
0 x6801,
0 x7a,
562 }, {
0 x6c01,
0 x7b,
574 },
{
0 x7001,
0 x7c,
587 }, {
0 x7401,
0 x7d,
600 }, {
0 x7801,
0 x7e,
613 },
{
0 x7c01,
0 x7f,
626 }, {
0 x8001,
0 x00,
640 }, {
0 x8401,
0 x00,
654 },
{
0 x8801,
0 x00,
668 }, {
0 x8c01,
0 x00,
683 }, {
0 x9001,
0 x00,
698 },
{
0 x9401,
0 x00,
713 }, {
0 x9801,
0 x00,
729 }, {
0 x9c01,
0 x00,
745 },
{
0 xa001,
0 x00,
761 }, {
0 xa401,
0 x00,
778 }, {
0 xa801,
0 x00,
795 },
{
0 xac01,
0 x00,
812 }, {
0 xb001,
0 x00,
830 }, {
0 xb401,
0 x00,
848 },
{
0 xb801,
0 x00,
867 }, {
0 xbc01,
0 x00,
886 }, {
0 xc001,
0 x00,
905 },
{
0 xc401,
0 x00,
925 }, {
0 xc801,
0 x00,
945 }, {
0 xcc01,
0 x00,
966 },
{
0 xd001,
0 x00,
987 }, {
0 xd401,
0 x00,
1009 }, {
0 xd801,
0 x00,
1031 },
{
0 xdc01,
0 x00,
1053 }, {
0 xe001,
0 x00,
1076 }, {
0 xe401,
0 x00,
1100 },
{
0 xe801,
0 x00,
1124 }, {
0 xec01,
0 x00,
1149 }, {
0 xf001,
0 x00,
1174 },
{
0 xf401,
0 x00,
1199 }, {
0 xf801,
0 x00,
1226 }, {
0 xfc01,
0 x00,
1253 }
};
#define joycon_max_rumble_amp (
1003 )
static const struct joycon_rumble_amp_data joycon_rumble_amplitudes[] = {
/* high, low, amp */
{
0 x00,
0 x0040,
0 },
{
0 x02,
0 x8040,
10 }, {
0 x04,
0 x0041,
12 }, {
0 x06,
0 x8041,
14 },
{
0 x08,
0 x0042,
17 }, {
0 x0a,
0 x8042,
20 }, {
0 x0c,
0 x0043,
24 },
{
0 x0e,
0 x8043,
28 }, {
0 x10,
0 x0044,
33 }, {
0 x12,
0 x8044,
40 },
{
0 x14,
0 x0045,
47 }, {
0 x16,
0 x8045,
56 }, {
0 x18,
0 x0046,
67 },
{
0 x1a,
0 x8046,
80 }, {
0 x1c,
0 x0047,
95 }, {
0 x1e,
0 x8047,
112 },
{
0 x20,
0 x0048,
117 }, {
0 x22,
0 x8048,
123 }, {
0 x24,
0 x0049,
128 },
{
0 x26,
0 x8049,
134 }, {
0 x28,
0 x004a,
140 }, {
0 x2a,
0 x804a,
146 },
{
0 x2c,
0 x004b,
152 }, {
0 x2e,
0 x804b,
159 }, {
0 x30,
0 x004c,
166 },
{
0 x32,
0 x804c,
173 }, {
0 x34,
0 x004d,
181 }, {
0 x36,
0 x804d,
189 },
{
0 x38,
0 x004e,
198 }, {
0 x3a,
0 x804e,
206 }, {
0 x3c,
0 x004f,
215 },
{
0 x3e,
0 x804f,
225 }, {
0 x40,
0 x0050,
230 }, {
0 x42,
0 x8050,
235 },
{
0 x44,
0 x0051,
240 }, {
0 x46,
0 x8051,
245 }, {
0 x48,
0 x0052,
251 },
{
0 x4a,
0 x8052,
256 }, {
0 x4c,
0 x0053,
262 }, {
0 x4e,
0 x8053,
268 },
{
0 x50,
0 x0054,
273 }, {
0 x52,
0 x8054,
279 }, {
0 x54,
0 x0055,
286 },
{
0 x56,
0 x8055,
292 }, {
0 x58,
0 x0056,
298 }, {
0 x5a,
0 x8056,
305 },
{
0 x5c,
0 x0057,
311 }, {
0 x5e,
0 x8057,
318 }, {
0 x60,
0 x0058,
325 },
{
0 x62,
0 x8058,
332 }, {
0 x64,
0 x0059,
340 }, {
0 x66,
0 x8059,
347 },
{
0 x68,
0 x005a,
355 }, {
0 x6a,
0 x805a,
362 }, {
0 x6c,
0 x005b,
370 },
{
0 x6e,
0 x805b,
378 }, {
0 x70,
0 x005c,
387 }, {
0 x72,
0 x805c,
395 },
{
0 x74,
0 x005d,
404 }, {
0 x76,
0 x805d,
413 }, {
0 x78,
0 x005e,
422 },
{
0 x7a,
0 x805e,
431 }, {
0 x7c,
0 x005f,
440 }, {
0 x7e,
0 x805f,
450 },
{
0 x80,
0 x0060,
460 }, {
0 x82,
0 x8060,
470 }, {
0 x84,
0 x0061,
480 },
{
0 x86,
0 x8061,
491 }, {
0 x88,
0 x0062,
501 }, {
0 x8a,
0 x8062,
512 },
{
0 x8c,
0 x0063,
524 }, {
0 x8e,
0 x8063,
535 }, {
0 x90,
0 x0064,
547 },
{
0 x92,
0 x8064,
559 }, {
0 x94,
0 x0065,
571 }, {
0 x96,
0 x8065,
584 },
{
0 x98,
0 x0066,
596 }, {
0 x9a,
0 x8066,
609 }, {
0 x9c,
0 x0067,
623 },
{
0 x9e,
0 x8067,
636 }, {
0 xa0,
0 x0068,
650 }, {
0 xa2,
0 x8068,
665 },
{
0 xa4,
0 x0069,
679 }, {
0 xa6,
0 x8069,
694 }, {
0 xa8,
0 x006a,
709 },
{
0 xaa,
0 x806a,
725 }, {
0 xac,
0 x006b,
741 }, {
0 xae,
0 x806b,
757 },
{
0 xb0,
0 x006c,
773 }, {
0 xb2,
0 x806c,
790 }, {
0 xb4,
0 x006d,
808 },
{
0 xb6,
0 x806d,
825 }, {
0 xb8,
0 x006e,
843 }, {
0 xba,
0 x806e,
862 },
{
0 xbc,
0 x006f,
881 }, {
0 xbe,
0 x806f,
900 }, {
0 xc0,
0 x0070,
920 },
{
0 xc2,
0 x8070,
940 }, {
0 xc4,
0 x0071,
960 }, {
0 xc6,
0 x8071,
981 },
{
0 xc8,
0 x0072, joycon_max_rumble_amp }
};
static const u16 JC_RUMBLE_DFLT_LOW_FREQ =
160 ;
static const u16 JC_RUMBLE_DFLT_HIGH_FREQ =
320 ;
static const unsigned short JC_RUMBLE_ZERO_AMP_PKT_CNT =
5 ;
#endif /* IS_ENABLED(CONFIG_NINTENDO_FF) */
static const u16 JC_RUMBLE_PERIOD_MS =
50 ;
/* States for controller state machine */
enum joycon_ctlr_state {
JOYCON_CTLR_STATE_INIT,
JOYCON_CTLR_STATE_READ,
JOYCON_CTLR_STATE_REMOVED,
JOYCON_CTLR_STATE_SUSPENDED,
};
/* Controller type received as part of device info */
enum joycon_ctlr_type {
JOYCON_CTLR_TYPE_JCL =
0 x01,
JOYCON_CTLR_TYPE_JCR =
0 x02,
JOYCON_CTLR_TYPE_PRO =
0 x03,
JOYCON_CTLR_TYPE_NESL =
0 x09,
JOYCON_CTLR_TYPE_NESR =
0 x0A,
JOYCON_CTLR_TYPE_SNES =
0 x0B,
JOYCON_CTLR_TYPE_GEN =
0 x0D,
JOYCON_CTLR_TYPE_N64 =
0 x0C,
};
struct joycon_stick_cal {
s32 max;
s32 min;
s32 center;
};
struct joycon_imu_cal {
s16 offset[
3 ];
s16 scale[
3 ];
};
/*
* All the controller ' s button values are stored in a u32 .
* They can be accessed with bitwise ANDs .
*/
#define JC_BTN_Y BIT(
0 )
#define JC_BTN_X BIT(
1 )
#define JC_BTN_B BIT(
2 )
#define JC_BTN_A BIT(
3 )
#define JC_BTN_SR_R BIT(
4 )
#define JC_BTN_SL_R BIT(
5 )
#define JC_BTN_R BIT(
6 )
#define JC_BTN_ZR BIT(
7 )
#define JC_BTN_MINUS BIT(
8 )
#define JC_BTN_PLUS BIT(
9 )
#define JC_BTN_RSTICK BIT(
10 )
#define JC_BTN_LSTICK BIT(
11 )
#define JC_BTN_HOME BIT(
12 )
#define JC_BTN_CAP BIT(
13 )
/* capture button */
#define JC_BTN_DOWN BIT(
16 )
#define JC_BTN_UP BIT(
17 )
#define JC_BTN_RIGHT BIT(
18 )
#define JC_BTN_LEFT BIT(
19 )
#define JC_BTN_SR_L BIT(
20 )
#define JC_BTN_SL_L BIT(
21 )
#define JC_BTN_L BIT(
22 )
#define JC_BTN_ZL BIT(
23 )
struct joycon_ctlr_button_mapping {
u32 code;
u32 bit;
};
/*
* D - pad is configured as buttons for the left Joy - Con only !
*/
static const struct joycon_ctlr_button_mapping left_joycon_button_mappings[] = {
{ BTN_TL, JC_BTN_L, },
{ BTN_TL2, JC_BTN_ZL, },
{ BTN_SELECT, JC_BTN_MINUS, },
{ BTN_THUMBL, JC_BTN_LSTICK, },
{ BTN_DPAD_UP, JC_BTN_UP, },
{ BTN_DPAD_DOWN, JC_BTN_DOWN, },
{ BTN_DPAD_LEFT, JC_BTN_LEFT, },
{ BTN_DPAD_RIGHT, JC_BTN_RIGHT, },
{ BTN_Z, JC_BTN_CAP, },
{
/* sentinel */ },
};
/*
* The unused * right * - side triggers become the SL / SR triggers for the * left *
* Joy - Con , if and only if we ' re not using a charging grip .
*/
static const struct joycon_ctlr_button_mapping left_joycon_s_button_mappings[] = {
{ BTN_TR, JC_BTN_SL_L, },
{ BTN_TR2, JC_BTN_SR_L, },
{
/* sentinel */ },
};
static const struct joycon_ctlr_button_mapping right_joycon_button_mappings[] = {
{ BTN_EAST, JC_BTN_A, },
{ BTN_SOUTH, JC_BTN_B, },
{ BTN_NORTH, JC_BTN_X, },
{ BTN_WEST, JC_BTN_Y, },
{ BTN_TR, JC_BTN_R, },
{ BTN_TR2, JC_BTN_ZR, },
{ BTN_START, JC_BTN_PLUS, },
{ BTN_THUMBR, JC_BTN_RSTICK, },
{ BTN_MODE, JC_BTN_HOME, },
{
/* sentinel */ },
};
/*
* The unused * left * - side triggers become the SL / SR triggers for the * right *
* Joy - Con , if and only if we ' re not using a charging grip .
*/
static const struct joycon_ctlr_button_mapping right_joycon_s_button_mappings[] = {
{ BTN_TL, JC_BTN_SL_R, },
{ BTN_TL2, JC_BTN_SR_R, },
{
/* sentinel */ },
};
static const struct joycon_ctlr_button_mapping procon_button_mappings[] = {
{ BTN_EAST, JC_BTN_A, },
{ BTN_SOUTH, JC_BTN_B, },
{ BTN_NORTH, JC_BTN_X, },
{ BTN_WEST, JC_BTN_Y, },
{ BTN_TL, JC_BTN_L, },
{ BTN_TR, JC_BTN_R, },
{ BTN_TL2, JC_BTN_ZL, },
{ BTN_TR2, JC_BTN_ZR, },
{ BTN_SELECT, JC_BTN_MINUS, },
{ BTN_START, JC_BTN_PLUS, },
{ BTN_THUMBL, JC_BTN_LSTICK, },
{ BTN_THUMBR, JC_BTN_RSTICK, },
{ BTN_MODE, JC_BTN_HOME, },
{ BTN_Z, JC_BTN_CAP, },
{
/* sentinel */ },
};
static const struct joycon_ctlr_button_mapping nescon_button_mappings[] = {
{ BTN_SOUTH, JC_BTN_A, },
{ BTN_EAST, JC_BTN_B, },
{ BTN_TL, JC_BTN_L, },
{ BTN_TR, JC_BTN_R, },
{ BTN_SELECT, JC_BTN_MINUS, },
{ BTN_START, JC_BTN_PLUS, },
{
/* sentinel */ },
};
static const struct joycon_ctlr_button_mapping snescon_button_mappings[] = {
{ BTN_EAST, JC_BTN_A, },
{ BTN_SOUTH, JC_BTN_B, },
{ BTN_NORTH, JC_BTN_X, },
{ BTN_WEST, JC_BTN_Y, },
{ BTN_TL, JC_BTN_L, },
{ BTN_TR, JC_BTN_R, },
{ BTN_TL2, JC_BTN_ZL, },
{ BTN_TR2, JC_BTN_ZR, },
{ BTN_SELECT, JC_BTN_MINUS, },
{ BTN_START, JC_BTN_PLUS, },
{
/* sentinel */ },
};
static const struct joycon_ctlr_button_mapping gencon_button_mappings[] = {
{ BTN_WEST, JC_BTN_A, },
/* A */
{ BTN_SOUTH, JC_BTN_B, },
/* B */
{ BTN_EAST, JC_BTN_R, },
/* C */
{ BTN_TL, JC_BTN_X, },
/* X MD/GEN 6B Only */
{ BTN_NORTH, JC_BTN_Y, },
/* Y MD/GEN 6B Only */
{ BTN_TR, JC_BTN_L, },
/* Z MD/GEN 6B Only */
{ BTN_SELECT, JC_BTN_ZR, },
/* Mode */
{ BTN_START, JC_BTN_PLUS, },
{ BTN_MODE, JC_BTN_HOME, },
{ BTN_Z, JC_BTN_CAP, },
{
/* sentinel */ },
};
static const struct joycon_ctlr_button_mapping n64con_button_mappings[] = {
{ BTN_A, JC_BTN_A, },
{ BTN_B, JC_BTN_B, },
{ BTN_TL2, JC_BTN_ZL, },
/* Z */
{ BTN_TL, JC_BTN_L, },
{ BTN_TR, JC_BTN_R, },
{ BTN_TR2, JC_BTN_LSTICK, },
/* ZR */
{ BTN_START, JC_BTN_PLUS, },
{ BTN_SELECT, JC_BTN_Y, },
/* C UP */
{ BTN_X, JC_BTN_ZR, },
/* C DOWN */
{ BTN_Y, JC_BTN_X, },
/* C LEFT */
{ BTN_C, JC_BTN_MINUS, },
/* C RIGHT */
{ BTN_MODE, JC_BTN_HOME, },
{ BTN_Z, JC_BTN_CAP, },
{
/* sentinel */ },
};
enum joycon_msg_type {
JOYCON_MSG_TYPE_NONE,
JOYCON_MSG_TYPE_USB,
JOYCON_MSG_TYPE_SUBCMD,
};
struct joycon_rumble_output {
u8 output_id;
u8 packet_num;
u8 rumble_data[
8 ];
} __packed;
struct joycon_subcmd_request {
u8 output_id;
/* must be 0x01 for subcommand, 0x10 for rumble only */
u8 packet_num;
/* incremented every send */
u8 rumble_data[
8 ];
u8 subcmd_id;
u8 data[];
/* length depends on the subcommand */
} __packed;
struct joycon_subcmd_reply {
u8 ack;
/* MSB 1 for ACK, 0 for NACK */
u8 id;
/* id of requested subcmd */
u8 data[];
/* will be at most 35 bytes */
} __packed;
struct joycon_imu_data {
s16 accel_x;
s16 accel_y;
s16 accel_z;
s16 gyro_x;
s16 gyro_y;
s16 gyro_z;
} __packed;
struct joycon_input_report {
u8 id;
u8 timer;
u8 bat_con;
/* battery and connection info */
u8 button_status[
3 ];
u8 left_stick[
3 ];
u8 right_stick[
3 ];
u8 vibrator_report;
union {
struct joycon_subcmd_reply subcmd_reply;
/* IMU input reports contain 3 samples */
u8 imu_raw_bytes[
sizeof (
struct joycon_imu_data) *
3 ];
};
} __packed;
#define JC_MAX_RESP_SIZE (
sizeof (
struct joycon_input_report) +
35 )
#define JC_RUMBLE_DATA_SIZE
8
#define JC_RUMBLE_QUEUE_SIZE
8
static const char *
const joycon_player_led_names[] = {
LED_FUNCTION_PLAYER1,
LED_FUNCTION_PLAYER2,
LED_FUNCTION_PLAYER3,
LED_FUNCTION_PLAYER4,
};
#define JC_NUM_LEDS ARRAY_SIZE(joycon_player_led_names)
#define JC_NUM_LED_PATTERNS
8
/* Taken from https://www.nintendo.com/my/support/qa/detail/33822 */
static const enum led_brightness joycon_player_led_patterns[JC_NUM_LED_PATTERNS][JC_
NUM_LEDS] = {
{ 1 , 0 , 0 , 0 },
{ 1 , 1 , 0 , 0 },
{ 1 , 1 , 1 , 0 },
{ 1 , 1 , 1 , 1 },
{ 1 , 0 , 0 , 1 },
{ 1 , 0 , 1 , 0 },
{ 1 , 0 , 1 , 1 },
{ 0 , 1 , 1 , 0 },
};
/* Each physical controller is associated with a joycon_ctlr struct */
struct joycon_ctlr {
struct hid_device *hdev;
struct input_dev *input;
u32 player_id;
struct led_classdev leds[JC_NUM_LEDS]; /* player leds */
struct led_classdev home_led;
enum joycon_ctlr_state ctlr_state;
spinlock_t lock;
u8 mac_addr[6 ];
char *mac_addr_str;
enum joycon_ctlr_type ctlr_type;
/* The following members are used for synchronous sends/receives */
enum joycon_msg_type msg_type;
u8 subcmd_num;
struct mutex output_mutex;
u8 input_buf[JC_MAX_RESP_SIZE];
wait_queue_head_t wait;
bool received_resp;
u8 usb_ack_match;
u8 subcmd_ack_match;
bool received_input_report;
unsigned int last_input_report_msecs;
unsigned int last_subcmd_sent_msecs;
unsigned int consecutive_valid_report_deltas;
/* factory calibration data */
struct joycon_stick_cal left_stick_cal_x;
struct joycon_stick_cal left_stick_cal_y;
struct joycon_stick_cal right_stick_cal_x;
struct joycon_stick_cal right_stick_cal_y;
struct joycon_imu_cal accel_cal;
struct joycon_imu_cal gyro_cal;
/* prevents needlessly recalculating these divisors every sample */
s32 imu_cal_accel_divisor[3 ];
s32 imu_cal_gyro_divisor[3 ];
/* power supply data */
struct power_supply *battery;
struct power_supply_desc battery_desc;
u8 battery_capacity;
bool battery_charging;
bool host_powered;
/* rumble */
u8 rumble_data[JC_RUMBLE_QUEUE_SIZE][JC_RUMBLE_DATA_SIZE];
int rumble_queue_head;
int rumble_queue_tail;
struct workqueue_struct *rumble_queue;
struct work_struct rumble_worker;
unsigned int rumble_msecs;
u16 rumble_ll_freq;
u16 rumble_lh_freq;
u16 rumble_rl_freq;
u16 rumble_rh_freq;
unsigned short rumble_zero_countdown;
/* imu */
struct input_dev *imu_input;
bool imu_first_packet_received; /* helps in initiating timestamp */
unsigned int imu_timestamp_us; /* timestamp we report to userspace */
unsigned int imu_last_pkt_ms; /* used to calc imu report delta */
/* the following are used to track the average imu report time delta */
unsigned int imu_delta_samples_count;
unsigned int imu_delta_samples_sum;
unsigned int imu_avg_delta_ms;
};
/* Helper macros for checking controller type */
#define jc_type_is_joycon(ctlr) \
(ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_JOYCONL || \
ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_JOYCONR || \
ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_CHRGGRIP)
#define jc_type_is_procon(ctlr) \
(ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_PROCON)
#define jc_type_is_chrggrip(ctlr) \
(ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_CHRGGRIP)
/* Does this controller have inputs associated with left joycon? */
#define jc_type_has_left(ctlr) \
(ctlr->ctlr_type == JOYCON_CTLR_TYPE_JCL || \
ctlr->ctlr_type == JOYCON_CTLR_TYPE_PRO || \
ctlr->ctlr_type == JOYCON_CTLR_TYPE_N64)
/* Does this controller have inputs associated with right joycon? */
#define jc_type_has_right(ctlr) \
(ctlr->ctlr_type == JOYCON_CTLR_TYPE_JCR || \
ctlr->ctlr_type == JOYCON_CTLR_TYPE_PRO)
/*
* Controller device helpers
*
* These look at the device ID known to the HID subsystem to identify a device ,
* but take caution : some NSO devices lie about themselves ( NES Joy - Cons and
* Sega Genesis controller ) . See type helpers below .
*
* These helpers are most useful early during the HID probe or in conjunction
* with the capability helpers below .
*/
static inline bool joycon_device_is_chrggrip(struct joycon_ctlr *ctlr)
{
return ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_CHRGGRIP;
}
/*
* Controller type helpers
*
* These are slightly different than the device - ID - based helpers above . They are
* generally more reliable , since they can distinguish between , e . g . , Genesis
* versus SNES , or NES Joy - Cons versus regular Switch Joy - Cons . They ' re most
* useful for reporting available inputs . For other kinds of distinctions , see
* the capability helpers below .
*
* They have two major drawbacks : ( 1 ) they ' re not available until after we set
* the reporting method and then request the device info ; ( 2 ) they can ' t
* distinguish all controllers ( like the Charging Grip from the Pro controller . )
*/
static inline bool joycon_type_is_left_joycon(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_JCL;
}
static inline bool joycon_type_is_right_joycon(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_JCR;
}
static inline bool joycon_type_is_procon(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_PRO;
}
static inline bool joycon_type_is_snescon(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_SNES;
}
static inline bool joycon_type_is_gencon(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_GEN;
}
static inline bool joycon_type_is_n64con(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_N64;
}
static inline bool joycon_type_is_left_nescon(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_NESL;
}
static inline bool joycon_type_is_right_nescon(struct joycon_ctlr *ctlr)
{
return ctlr->ctlr_type == JOYCON_CTLR_TYPE_NESR;
}
static inline bool joycon_type_is_any_joycon(struct joycon_ctlr *ctlr)
{
return joycon_type_is_left_joycon(ctlr) ||
joycon_type_is_right_joycon(ctlr) ||
joycon_device_is_chrggrip(ctlr);
}
static inline bool joycon_type_is_any_nescon(struct joycon_ctlr *ctlr)
{
return joycon_type_is_left_nescon(ctlr) ||
joycon_type_is_right_nescon(ctlr);
}
/*
* Controller capability helpers
*
* These helpers combine the use of the helpers above to detect certain
* capabilities during initialization . They are always accurate but ( since they
* use type helpers ) cannot be used early in the HID probe .
*/
static inline bool joycon_has_imu(struct joycon_ctlr *ctlr)
{
return joycon_device_is_chrggrip(ctlr) ||
joycon_type_is_any_joycon(ctlr) ||
joycon_type_is_procon(ctlr);
}
static inline bool joycon_has_joysticks(struct joycon_ctlr *ctlr)
{
return joycon_device_is_chrggrip(ctlr) ||
joycon_type_is_any_joycon(ctlr) ||
joycon_type_is_procon(ctlr) ||
joycon_type_is_n64con(ctlr);
}
static inline bool joycon_has_rumble(struct joycon_ctlr *ctlr)
{
return joycon_device_is_chrggrip(ctlr) ||
joycon_type_is_any_joycon(ctlr) ||
joycon_type_is_procon(ctlr) ||
joycon_type_is_n64con(ctlr);
}
static inline bool joycon_using_usb(struct joycon_ctlr *ctlr)
{
return ctlr->hdev->bus == BUS_USB;
}
static int __joycon_hid_send(struct hid_device *hdev, u8 *data, size_t len)
{
u8 *buf;
int ret;
buf = kmemdup(data, len, GFP_KERNEL);
if (!buf)
return -ENOMEM;
ret = hid_hw_output_report(hdev, buf, len);
kfree(buf);
if (ret < 0 )
hid_dbg(hdev, "Failed to send output report ret=%d\n" , ret);
return ret;
}
static void joycon_wait_for_input_report(struct joycon_ctlr *ctlr)
{
int ret;
/*
* If we are in the proper reporting mode , wait for an input
* report prior to sending the subcommand . This improves
* reliability considerably .
*/
if (ctlr->ctlr_state == JOYCON_CTLR_STATE_READ) {
unsigned long flags;
spin_lock_irqsave(&ctlr->lock, flags);
ctlr->received_input_report = false ;
spin_unlock_irqrestore(&ctlr->lock, flags);
ret = wait_event_timeout(ctlr->wait,
ctlr->received_input_report,
HZ / 4 );
/* We will still proceed, even with a timeout here */
if (!ret)
hid_warn(ctlr->hdev,
"timeout waiting for input report\n" );
}
}
/*
* Sending subcommands and / or rumble data at too high a rate can cause bluetooth
* controller disconnections .
*/
#define JC_INPUT_REPORT_MIN_DELTA 8
#define JC_INPUT_REPORT_MAX_DELTA 17
#define JC_SUBCMD_TX_OFFSET_MS 4
#define JC_SUBCMD_VALID_DELTA_REQ 3
#define JC_SUBCMD_RATE_MAX_ATTEMPTS 500
#define JC_SUBCMD_RATE_LIMITER_USB_MS 20
#define JC_SUBCMD_RATE_LIMITER_BT_MS 60
#define JC_SUBCMD_RATE_LIMITER_MS(ctlr) ((ctlr)->hdev->bus == BUS_USB ? JC_SUBCMD_RATE_LIMITER_USB_MS : JC_SUBCMD_RATE_LIMITER_BT_MS)
static void joycon_enforce_subcmd_rate(struct joycon_ctlr *ctlr)
{
unsigned int current_ms;
unsigned long subcmd_delta;
int consecutive_valid_deltas = 0 ;
int attempts = 0 ;
unsigned long flags;
if (unlikely(ctlr->ctlr_state != JOYCON_CTLR_STATE_READ))
return ;
do {
joycon_wait_for_input_report(ctlr);
current_ms = jiffies_to_msecs(jiffies);
subcmd_delta = current_ms - ctlr->last_subcmd_sent_msecs;
spin_lock_irqsave(&ctlr->lock, flags);
consecutive_valid_deltas = ctlr->consecutive_valid_report_deltas;
spin_unlock_irqrestore(&ctlr->lock, flags);
attempts++;
} while ((consecutive_valid_deltas < JC_SUBCMD_VALID_DELTA_REQ ||
subcmd_delta < JC_SUBCMD_RATE_LIMITER_MS(ctlr)) &&
ctlr->ctlr_state == JOYCON_CTLR_STATE_READ &&
attempts < JC_SUBCMD_RATE_MAX_ATTEMPTS);
if (attempts >= JC_SUBCMD_RATE_MAX_ATTEMPTS) {
hid_warn(ctlr->hdev, "%s: exceeded max attempts" , __func__);
return ;
}
ctlr->last_subcmd_sent_msecs = current_ms;
/*
* Wait a short time after receiving an input report before
* transmitting . This should reduce odds of a TX coinciding with an RX .
* Minimizing concurrent BT traffic with the controller seems to lower
* the rate of disconnections .
*/
msleep(JC_SUBCMD_TX_OFFSET_MS);
}
static int joycon_hid_send_sync(struct joycon_ctlr *ctlr, u8 *data, size_t len,
u32 timeout)
{
int ret;
int tries = 2 ;
/*
* The controller occasionally seems to drop subcommands . In testing ,
* doing one retry after a timeout appears to always work .
*/
while (tries--) {
joycon_enforce_subcmd_rate(ctlr);
ret = __joycon_hid_send(ctlr->hdev, data, len);
if (ret < 0 ) {
memset(ctlr->input_buf, 0 , JC_MAX_RESP_SIZE);
return ret;
}
ret = wait_event_timeout(ctlr->wait, ctlr->received_resp,
timeout);
if (!ret) {
hid_dbg(ctlr->hdev,
"synchronous send/receive timed out\n" );
if (tries) {
hid_dbg(ctlr->hdev,
"retrying sync send after timeout\n" );
}
memset(ctlr->input_buf, 0 , JC_MAX_RESP_SIZE);
ret = -ETIMEDOUT;
} else {
ret = 0 ;
break ;
}
}
ctlr->received_resp = false ;
return ret;
}
static int joycon_send_usb(struct joycon_ctlr *ctlr, u8 cmd, u32 timeout)
{
int ret;
u8 buf[2 ] = {JC_OUTPUT_USB_CMD};
buf[1 ] = cmd;
ctlr->usb_ack_match = cmd;
ctlr->msg_type = JOYCON_MSG_TYPE_USB;
ret = joycon_hid_send_sync(ctlr, buf, sizeof (buf), timeout);
if (ret)
hid_dbg(ctlr->hdev, "send usb command failed; ret=%d\n" , ret);
return ret;
}
static int joycon_send_subcmd(struct joycon_ctlr *ctlr,
struct joycon_subcmd_request *subcmd,
size_t data_len, u32 timeout)
{
int ret;
unsigned long flags;
spin_lock_irqsave(&ctlr->lock, flags);
/*
* If the controller has been removed , just return ENODEV so the LED
* subsystem doesn ' t print invalid errors on removal .
*/
if (ctlr->ctlr_state == JOYCON_CTLR_STATE_REMOVED) {
spin_unlock_irqrestore(&ctlr->lock, flags);
return -ENODEV;
}
memcpy(subcmd->rumble_data, ctlr->rumble_data[ctlr->rumble_queue_tail],
JC_RUMBLE_DATA_SIZE);
spin_unlock_irqrestore(&ctlr->lock, flags);
subcmd->output_id = JC_OUTPUT_RUMBLE_AND_SUBCMD;
subcmd->packet_num = ctlr->subcmd_num;
if (++ctlr->subcmd_num > 0 xF)
ctlr->subcmd_num = 0 ;
ctlr->subcmd_ack_match = subcmd->subcmd_id;
ctlr->msg_type = JOYCON_MSG_TYPE_SUBCMD;
ret = joycon_hid_send_sync(ctlr, (u8 *)subcmd,
sizeof (*subcmd) + data_len, timeout);
if (ret < 0 )
hid_dbg(ctlr->hdev, "send subcommand failed; ret=%d\n" , ret);
else
ret = 0 ;
return ret;
}
/* Supply nibbles for flash and on. Ones correspond to active */
static int joycon_set_player_leds(struct joycon_ctlr *ctlr, u8 flash, u8 on)
{
struct joycon_subcmd_request *req;
u8 buffer[sizeof (*req) + 1 ] = { 0 };
req = (struct joycon_subcmd_request *)buffer;
req->subcmd_id = JC_SUBCMD_SET_PLAYER_LIGHTS;
req->data[0 ] = (flash << 4 ) | on;
hid_dbg(ctlr->hdev, "setting player leds\n" );
return joycon_send_subcmd(ctlr, req, 1 , HZ/4 );
}
static int joycon_set_home_led(struct joycon_ctlr *ctlr, enum led_brightness brightness)
{
struct joycon_subcmd_request *req;
u8 buffer[sizeof (*req) + 5 ] = { 0 };
u8 *data;
req = (struct joycon_subcmd_request *)buffer;
req->subcmd_id = JC_SUBCMD_SET_HOME_LIGHT;
data = req->data;
data[0 ] = 0 x01;
data[1 ] = brightness << 4 ;
data[2 ] = brightness | (brightness << 4 );
data[3 ] = 0 x11;
data[4 ] = 0 x11;
hid_dbg(ctlr->hdev, "setting home led brightness\n" );
return joycon_send_subcmd(ctlr, req, 5 , HZ/4 );
}
static int joycon_request_spi_flash_read(struct joycon_ctlr *ctlr,
u32 start_addr, u8 size, u8 **reply)
{
struct joycon_subcmd_request *req;
struct joycon_input_report *report;
u8 buffer[sizeof (*req) + 5 ] = { 0 };
u8 *data;
int ret;
if (!reply)
return -EINVAL;
req = (struct joycon_subcmd_request *)buffer;
req->subcmd_id = JC_SUBCMD_SPI_FLASH_READ;
data = req->data;
put_unaligned_le32(start_addr, data);
data[4 ] = size;
hid_dbg(ctlr->hdev, "requesting SPI flash data\n" );
ret = joycon_send_subcmd(ctlr, req, 5 , HZ);
if (ret) {
hid_err(ctlr->hdev, "failed reading SPI flash; ret=%d\n" , ret);
} else {
report = (struct joycon_input_report *)ctlr->input_buf;
/* The read data starts at the 6th byte */
*reply = &report->subcmd_reply.data[5 ];
}
return ret;
}
/*
* User calibration ' s presence is denoted with a magic byte preceding it .
* returns 0 if magic val is present , 1 if not present , < 0 on error
*/
static int joycon_check_for_cal_magic(struct joycon_ctlr *ctlr, u32 flash_addr)
{
int ret;
u8 *reply;
ret = joycon_request_spi_flash_read(ctlr, flash_addr,
JC_CAL_USR_MAGIC_SIZE, &reply);
if (ret)
return ret;
return reply[0 ] != JC_CAL_USR_MAGIC_0 || reply[1 ] != JC_CAL_USR_MAGIC_1;
}
static int joycon_read_stick_calibration(struct joycon_ctlr *ctlr, u16 cal_addr,
struct joycon_stick_cal *cal_x,
struct joycon_stick_cal *cal_y,
bool left_stick)
{
s32 x_max_above;
s32 x_min_below;
s32 y_max_above;
s32 y_min_below;
u8 *raw_cal;
int ret;
ret = joycon_request_spi_flash_read(ctlr, cal_addr,
JC_CAL_STICK_DATA_SIZE, &raw_cal);
if (ret)
return ret;
/* stick calibration parsing: note the order differs based on stick */
if (left_stick) {
x_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 0 ), 0 ,
12 );
y_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 1 ), 4 ,
12 );
cal_x->center = hid_field_extract(ctlr->hdev, (raw_cal + 3 ), 0 ,
12 );
cal_y->center = hid_field_extract(ctlr->hdev, (raw_cal + 4 ), 4 ,
12 );
x_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 6 ), 0 ,
12 );
y_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 7 ), 4 ,
12 );
} else {
cal_x->center = hid_field_extract(ctlr->hdev, (raw_cal + 0 ), 0 ,
12 );
cal_y->center = hid_field_extract(ctlr->hdev, (raw_cal + 1 ), 4 ,
12 );
x_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 3 ), 0 ,
12 );
y_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 4 ), 4 ,
12 );
x_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 6 ), 0 ,
12 );
y_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 7 ), 4 ,
12 );
}
cal_x->max = cal_x->center + x_max_above;
cal_x->min = cal_x->center - x_min_below;
cal_y->max = cal_y->center + y_max_above;
cal_y->min = cal_y->center - y_min_below;
/* check if calibration values are plausible */
if (cal_x->min >= cal_x->center || cal_x->center >= cal_x->max ||
cal_y->min >= cal_y->center || cal_y->center >= cal_y->max)
ret = -EINVAL;
return ret;
}
static const u16 DFLT_STICK_CAL_CEN = 2000 ;
static const u16 DFLT_STICK_CAL_MAX = 3500 ;
static const u16 DFLT_STICK_CAL_MIN = 500 ;
static void joycon_use_default_calibration(struct hid_device *hdev,
struct joycon_stick_cal *cal_x,
struct joycon_stick_cal *cal_y,
const char *stick, int ret)
{
hid_warn(hdev,
"Failed to read %s stick cal, using defaults; e=%d\n" ,
stick, ret);
cal_x->center = cal_y->center = DFLT_STICK_CAL_CEN;
cal_x->max = cal_y->max = DFLT_STICK_CAL_MAX;
cal_x->min = cal_y->min = DFLT_STICK_CAL_MIN;
}
static int joycon_request_calibration(struct joycon_ctlr *ctlr)
{
u16 left_stick_addr = JC_CAL_FCT_DATA_LEFT_ADDR;
u16 right_stick_addr = JC_CAL_FCT_DATA_RIGHT_ADDR;
int ret;
hid_dbg(ctlr->hdev, "requesting cal data\n" );
/* check if user stick calibrations are present */
if (!joycon_check_for_cal_magic(ctlr, JC_CAL_USR_LEFT_MAGIC_ADDR)) {
left_stick_addr = JC_CAL_USR_LEFT_DATA_ADDR;
hid_info(ctlr->hdev, "using user cal for left stick\n" );
} else {
hid_info(ctlr->hdev, "using factory cal for left stick\n" );
}
if (!joycon_check_for_cal_magic(ctlr, JC_CAL_USR_RIGHT_MAGIC_ADDR)) {
right_stick_addr = JC_CAL_USR_RIGHT_DATA_ADDR;
hid_info(ctlr->hdev, "using user cal for right stick\n" );
} else {
hid_info(ctlr->hdev, "using factory cal for right stick\n" );
}
/* read the left stick calibration data */
ret = joycon_read_stick_calibration(ctlr, left_stick_addr,
&ctlr->left_stick_cal_x,
&ctlr->left_stick_cal_y,
true );
if (ret)
joycon_use_default_calibration(ctlr->hdev,
&ctlr->left_stick_cal_x,
&ctlr->left_stick_cal_y,
"left" , ret);
/* read the right stick calibration data */
ret = joycon_read_stick_calibration(ctlr, right_stick_addr,
&ctlr->right_stick_cal_x,
&ctlr->right_stick_cal_y,
false );
if (ret)
joycon_use_default_calibration(ctlr->hdev,
&ctlr->right_stick_cal_x,
&ctlr->right_stick_cal_y,
"right" , ret);
hid_dbg(ctlr->hdev, "calibration:\n"
"l_x_c=%d l_x_max=%d l_x_min=%d\n"
"l_y_c=%d l_y_max=%d l_y_min=%d\n"
"r_x_c=%d r_x_max=%d r_x_min=%d\n"
"r_y_c=%d r_y_max=%d r_y_min=%d\n" ,
ctlr->left_stick_cal_x.center,
ctlr->left_stick_cal_x.max,
ctlr->left_stick_cal_x.min,
ctlr->left_stick_cal_y.center,
ctlr->left_stick_cal_y.max,
ctlr->left_stick_cal_y.min,
ctlr->right_stick_cal_x.center,
ctlr->right_stick_cal_x.max,
ctlr->right_stick_cal_x.min,
ctlr->right_stick_cal_y.center,
ctlr->right_stick_cal_y.max,
ctlr->right_stick_cal_y.min);
return 0 ;
}
/*
* These divisors are calculated once rather than for each sample . They are only
* dependent on the IMU calibration values . They are used when processing the
* IMU input reports .
*/
static void joycon_calc_imu_cal_divisors(struct joycon_ctlr *ctlr)
{
int i, divz = 0 ;
for (i = 0 ; i < 3 ; i++) {
ctlr->imu_cal_accel_divisor[i] = ctlr->accel_cal.scale[i] -
ctlr->accel_cal.offset[i];
ctlr->imu_cal_gyro_divisor[i] = ctlr->gyro_cal.scale[i] -
ctlr->gyro_cal.offset[i];
if (ctlr->imu_cal_accel_divisor[i] == 0 ) {
ctlr->imu_cal_accel_divisor[i] = 1 ;
divz++;
}
if (ctlr->imu_cal_gyro_divisor[i] == 0 ) {
ctlr->imu_cal_gyro_divisor[i] = 1 ;
divz++;
}
}
if (divz)
hid_warn(ctlr->hdev, "inaccurate IMU divisors (%d)\n" , divz);
}
static const s16 DFLT_ACCEL_OFFSET /*= 0*/;
static const s16 DFLT_ACCEL_SCALE = 16384 ;
static const s16 DFLT_GYRO_OFFSET /*= 0*/;
static const s16 DFLT_GYRO_SCALE = 13371 ;
static int joycon_request_imu_calibration(struct joycon_ctlr *ctlr)
{
u16 imu_cal_addr = JC_IMU_CAL_FCT_DATA_ADDR;
u8 *raw_cal;
int ret;
int i;
/* check if user calibration exists */
if (!joycon_check_for_cal_magic(ctlr, JC_IMU_CAL_USR_MAGIC_ADDR)) {
imu_cal_addr = JC_IMU_CAL_USR_DATA_ADDR;
hid_info(ctlr->hdev, "using user cal for IMU\n" );
} else {
hid_info(ctlr->hdev, "using factory cal for IMU\n" );
}
/* request IMU calibration data */
hid_dbg(ctlr->hdev, "requesting IMU cal data\n" );
ret = joycon_request_spi_flash_read(ctlr, imu_cal_addr,
JC_IMU_CAL_DATA_SIZE, &raw_cal);
if (ret) {
hid_warn(ctlr->hdev,
"Failed to read IMU cal, using defaults; ret=%d\n" ,
ret);
for (i = 0 ; i < 3 ; i++) {
ctlr->accel_cal.offset[i] = DFLT_ACCEL_OFFSET;
ctlr->accel_cal.scale[i] = DFLT_ACCEL_SCALE;
ctlr->gyro_cal.offset[i] = DFLT_GYRO_OFFSET;
ctlr->gyro_cal.scale[i] = DFLT_GYRO_SCALE;
}
joycon_calc_imu_cal_divisors(ctlr);
return ret;
}
/* IMU calibration parsing */
for (i = 0 ; i < 3 ; i++) {
int j = i * 2 ;
ctlr->accel_cal.offset[i] = get_unaligned_le16(raw_cal + j);
ctlr->accel_cal.scale[i] = get_unaligned_le16(raw_cal + j + 6 );
ctlr->gyro_cal.offset[i] = get_unaligned_le16(raw_cal + j + 12 );
ctlr->gyro_cal.scale[i] = get_unaligned_le16(raw_cal + j + 18 );
}
joycon_calc_imu_cal_divisors(ctlr);
hid_dbg(ctlr->hdev, "IMU calibration:\n"
"a_o[0]=%d a_o[1]=%d a_o[2]=%d\n"
"a_s[0]=%d a_s[1]=%d a_s[2]=%d\n"
"g_o[0]=%d g_o[1]=%d g_o[2]=%d\n"
"g_s[0]=%d g_s[1]=%d g_s[2]=%d\n" ,
ctlr->accel_cal.offset[0 ],
ctlr->accel_cal.offset[1 ],
ctlr->accel_cal.offset[2 ],
ctlr->accel_cal.scale[0 ],
ctlr->accel_cal.scale[1 ],
ctlr->accel_cal.scale[2 ],
ctlr->gyro_cal.offset[0 ],
ctlr->gyro_cal.offset[1 ],
ctlr->gyro_cal.offset[2 ],
ctlr->gyro_cal.scale[0 ],
ctlr->gyro_cal.scale[1 ],
ctlr->gyro_cal.scale[2 ]);
return 0 ;
}
static int joycon_set_report_mode(struct joycon_ctlr *ctlr)
{
struct joycon_subcmd_request *req;
u8 buffer[sizeof (*req) + 1 ] = { 0 };
req = (struct joycon_subcmd_request *)buffer;
req->subcmd_id = JC_SUBCMD_SET_REPORT_MODE;
req->data[0 ] = 0 x30; /* standard, full report mode */
hid_dbg(ctlr->hdev, "setting controller report mode\n" );
return joycon_send_subcmd(ctlr, req, 1 , HZ);
}
static int joycon_enable_rumble(struct joycon_ctlr *ctlr)
{
struct joycon_subcmd_request *req;
u8 buffer[sizeof (*req) + 1 ] = { 0 };
req = (struct joycon_subcmd_request *)buffer;
req->subcmd_id = JC_SUBCMD_ENABLE_VIBRATION;
req->data[0 ] = 0 x01; /* note: 0x00 would disable */
hid_dbg(ctlr->hdev, "enabling rumble\n" );
return joycon_send_subcmd(ctlr, req, 1 , HZ/4 );
}
static int joycon_enable_imu(struct joycon_ctlr *ctlr)
{
struct joycon_subcmd_request *req;
u8 buffer[sizeof (*req) + 1 ] = { 0 };
req = (struct joycon_subcmd_request *)buffer;
req->subcmd_id = JC_SUBCMD_ENABLE_IMU;
req->data[0 ] = 0 x01; /* note: 0x00 would disable */
hid_dbg(ctlr->hdev, "enabling IMU\n" );
return joycon_send_subcmd(ctlr, req, 1 , HZ);
}
static s32 joycon_map_stick_val(struct joycon_stick_cal *cal, s32 val)
{
s32 center = cal->center;
s32 min = cal->min;
s32 max = cal->max;
s32 new_val;
if (val > center) {
new_val = (val - center) * JC_MAX_STICK_MAG;
new_val /= (max - center);
} else {
new_val = (center - val) * -JC_MAX_STICK_MAG;
new_val /= (center - min);
}
new_val = clamp(new_val, (s32)-JC_MAX_STICK_MAG, (s32)JC_MAX_STICK_MAG);
return new_val;
}
static void joycon_input_report_parse_imu_data(struct joycon_ctlr *ctlr,
struct joycon_input_report *rep,
struct joycon_imu_data *imu_data)
{
u8 *raw = rep->imu_raw_bytes;
int i;
for (i = 0 ; i < 3 ; i++) {
struct joycon_imu_data *data = &imu_data[i];
data->accel_x = get_unaligned_le16(raw + 0 );
data->accel_y = get_unaligned_le16(raw + 2 );
data->accel_z = get_unaligned_le16(raw + 4 );
data->gyro_x = get_unaligned_le16(raw + 6 );
data->gyro_y = get_unaligned_le16(raw + 8 );
data->gyro_z = get_unaligned_le16(raw + 10 );
/* point to next imu sample */
raw += sizeof (struct joycon_imu_data);
}
}
static void joycon_parse_imu_report(struct joycon_ctlr *ctlr,
struct joycon_input_report *rep)
{
struct joycon_imu_data imu_data[3 ] = {0 }; /* 3 reports per packet */
struct input_dev *idev = ctlr->imu_input;
unsigned int msecs = jiffies_to_msecs(jiffies);
unsigned int last_msecs = ctlr->imu_last_pkt_ms;
int i;
int value[6 ];
joycon_input_report_parse_imu_data(ctlr, rep, imu_data);
/*
* There are complexities surrounding how we determine the timestamps we
* associate with the samples we pass to userspace . The IMU input
* reports do not provide us with a good timestamp . There ' s a quickly
* incrementing 8 - bit counter per input report , but it is not very
* useful for this purpose ( it is not entirely clear what rate it
* increments at or if it varies based on packet push rate - more on
* the push rate below . . . ) .
*
* The reverse engineering work done on the joy - cons and pro controllers
* by the community seems to indicate the following :
* - The controller samples the IMU every 1 . 35 ms . It then does some of
* its own processing , probably averaging the samples out .
* - Each imu input report contains 3 IMU samples , ( usually 5 ms apart ) .
* - In the standard reporting mode ( which this driver uses exclusively )
* input reports are pushed from the controller as follows :
* * joy - con ( bluetooth ) : every 15 ms
* * joy - cons ( in charging grip via USB ) : every 15 ms
* * pro controller ( USB ) : every 15 ms
* * pro controller ( bluetooth ) : every 8 ms ( this is the wildcard )
*
* Further complicating matters is that some bluetooth stacks are known
* to alter the controller ' s packet rate by hardcoding the bluetooth
* SSR for the switch controllers ( android ' s stack currently sets the
* SSR to 11 ms for both the joy - cons and pro controllers ) .
*
* In my own testing , I ' ve discovered that my pro controller either
* reports IMU sample batches every 11 ms or every 15 ms . This rate is
* stable after connecting . It isn ' t 100 % clear what determines this
* rate . Importantly , even when sending every 11 ms , none of the samples
* are duplicates . This seems to indicate that the time deltas between
* reported samples can vary based on the input report rate .
*
* The solution employed in this driver is to keep track of the average
* time delta between IMU input reports . In testing , this value has
* proven to be stable , staying at 15 ms or 11 ms , though other hardware
* configurations and bluetooth stacks could potentially see other rates
* ( hopefully this will become more clear as more people use the
* driver ) .
*
* Keeping track of the average report delta allows us to submit our
* timestamps to userspace based on that . Each report contains 3
* samples , so the IMU sampling rate should be avg_time_delta / 3 . We can
* also use this average to detect events where we have dropped a
* packet . The userspace timestamp for the samples will be adjusted
* accordingly to prevent unwanted behvaior .
*/
if (!ctlr->imu_first_packet_received) {
ctlr->imu_timestamp_us = 0 ;
ctlr->imu_delta_samples_count = 0 ;
ctlr->imu_delta_samples_sum = 0 ;
ctlr->imu_avg_delta_ms = JC_IMU_DFLT_AVG_DELTA_MS;
ctlr->imu_first_packet_received = true ;
} else {
unsigned int delta = msecs - last_msecs;
unsigned int dropped_pkts;
unsigned int dropped_threshold;
/* avg imu report delta housekeeping */
ctlr->imu_delta_samples_sum += delta;
ctlr->imu_delta_samples_count++;
if (ctlr->imu_delta_samples_count >=
JC_IMU_SAMPLES_PER_DELTA_AVG) {
ctlr->imu_avg_delta_ms = ctlr->imu_delta_samples_sum /
ctlr->imu_delta_samples_count;
ctlr->imu_delta_samples_count = 0 ;
ctlr->imu_delta_samples_sum = 0 ;
}
/* don't ever want divide by zero shenanigans */
if (ctlr->imu_avg_delta_ms == 0 ) {
ctlr->imu_avg_delta_ms = 1 ;
hid_warn(ctlr->hdev, "calculated avg imu delta of 0\n" );
}
/* useful for debugging IMU sample rate */
hid_dbg(ctlr->hdev,
"imu_report: ms=%u last_ms=%u delta=%u avg_delta=%u\n" ,
msecs, last_msecs, delta, ctlr->imu_avg_delta_ms);
/* check if any packets have been dropped */
dropped_threshold = ctlr->imu_avg_delta_ms * 3 / 2 ;
dropped_pkts = (delta - min(delta, dropped_threshold)) /
ctlr->imu_avg_delta_ms;
ctlr->imu_timestamp_us += 1000 * ctlr->imu_avg_delta_ms;
if (dropped_pkts > JC_IMU_DROPPED_PKT_WARNING) {
hid_warn(ctlr->hdev,
"compensating for %u dropped IMU reports\n" ,
dropped_pkts);
hid_warn(ctlr->hdev,
"delta=%u avg_delta=%u\n" ,
delta, ctlr->imu_avg_delta_ms);
}
}
ctlr->imu_last_pkt_ms = msecs;
/* Each IMU input report contains three samples */
for (i = 0 ; i < 3 ; i++) {
input_event(idev, EV_MSC, MSC_TIMESTAMP,
ctlr->imu_timestamp_us);
/*
* These calculations ( which use the controller ' s calibration
* settings to improve the final values ) are based on those
* found in the community ' s reverse - engineering repo ( linked at
* top of driver ) . For hid - nintendo , we make sure that the final
* value given to userspace is always in terms of the axis
* resolution we provided .
*
* Currently only the gyro calculations subtract the calibration
* offsets from the raw value itself . In testing , doing the same
* for the accelerometer raw values decreased accuracy .
*
* Note that the gyro values are multiplied by the
* precision - saving scaling factor to prevent large inaccuracies
* due to truncation of the resolution value which would
* otherwise occur . To prevent overflow ( without resorting to 64
* bit integer math ) , the mult_frac macro is used .
*/
value[0 ] = mult_frac((JC_IMU_PREC_RANGE_SCALE *
(imu_data[i].gyro_x -
ctlr->gyro_cal.offset[0 ])),
ctlr->gyro_cal.scale[0 ],
ctlr->imu_cal_gyro_divisor[0 ]);
value[1 ] = mult_frac((JC_IMU_PREC_RANGE_SCALE *
(imu_data[i].gyro_y -
ctlr->gyro_cal.offset[1 ])),
ctlr->gyro_cal.scale[1 ],
ctlr->imu_cal_gyro_divisor[1 ]);
value[2 ] = mult_frac((JC_IMU_PREC_RANGE_SCALE *
(imu_data[i].gyro_z -
ctlr->gyro_cal.offset[2 ])),
ctlr->gyro_cal.scale[2 ],
ctlr->imu_cal_gyro_divisor[2 ]);
value[3 ] = ((s32)imu_data[i].accel_x *
ctlr->accel_cal.scale[0 ]) /
ctlr->imu_cal_accel_divisor[0 ];
value[4 ] = ((s32)imu_data[i].accel_y *
ctlr->accel_cal.scale[1 ]) /
ctlr->imu_cal_accel_divisor[1 ];
value[5 ] = ((s32)imu_data[i].accel_z *
ctlr->accel_cal.scale[2 ]) /
ctlr->imu_cal_accel_divisor[2 ];
hid_dbg(ctlr->hdev, "raw_gyro: g_x=%d g_y=%d g_z=%d\n" ,
imu_data[i].gyro_x, imu_data[i].gyro_y,
imu_data[i].gyro_z);
hid_dbg(ctlr->hdev, "raw_accel: a_x=%d a_y=%d a_z=%d\n" ,
imu_data[i].accel_x, imu_data[i].accel_y,
imu_data[i].accel_z);
/*
* The right joy - con has 2 axes negated , Y and Z . This is due to
* the orientation of the IMU in the controller . We negate those
* axes ' values in order to be consistent with the left joy - con
* and the pro controller :
* X : positive is pointing toward the triggers
* Y : positive is pointing to the left
* Z : positive is pointing up ( out of the buttons / sticks )
* The axes follow the right - hand rule .
*/
if (jc_type_is_joycon(ctlr) && jc_type_has_right(ctlr)) {
int j;
/* negate all but x axis */
for (j = 1 ; j < 6 ; ++j) {
if (j == 3 )
continue ;
value[j] *= -1 ;
}
}
input_report_abs(idev, ABS_RX, value[0 ]);
input_report_abs(idev, ABS_RY, value[1 ]);
input_report_abs(idev, ABS_RZ, value[2 ]);
input_report_abs(idev, ABS_X, value[3 ]);
input_report_abs(idev, ABS_Y, value[4 ]);
input_report_abs(idev, ABS_Z, value[5 ]);
input_sync(idev);
/* convert to micros and divide by 3 (3 samples per report). */
ctlr->imu_timestamp_us += ctlr->imu_avg_delta_ms * 1000 / 3 ;
}
}
static void joycon_handle_rumble_report(struct joycon_ctlr *ctlr, struct joycon_input_report *rep)
{
unsigned long flags;
unsigned long msecs = jiffies_to_msecs(jiffies);
spin_lock_irqsave(&ctlr->lock, flags);
if (IS_ENABLED(CONFIG_NINTENDO_FF) && rep->vibrator_report &&
ctlr->ctlr_state != JOYCON_CTLR_STATE_REMOVED &&
(msecs - ctlr->rumble_msecs) >= JC_RUMBLE_PERIOD_MS &&
(ctlr->rumble_queue_head != ctlr->rumble_queue_tail ||
ctlr->rumble_zero_countdown > 0 )) {
/*
* When this value reaches 0 , we know we ' ve sent multiple
* packets to the controller instructing it to disable rumble .
* We can safely stop sending periodic rumble packets until the
* next ff effect .
*/
if (ctlr->rumble_zero_countdown > 0 )
ctlr->rumble_zero_countdown--;
queue_work(ctlr->rumble_queue, &ctlr->rumble_worker);
}
spin_unlock_irqrestore(&ctlr->lock, flags);
}
static void joycon_parse_battery_status(struct joycon_ctlr *ctlr, struct joycon_input_report *rep)
{
u8 tmp;
unsigned long flags;
spin_lock_irqsave(&ctlr->lock, flags);
tmp = rep->bat_con;
ctlr->host_powered = tmp & BIT(0 );
ctlr->battery_charging = tmp & BIT(4 );
tmp = tmp >> 5 ;
switch (tmp) {
case 0 : /* empty */
ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_CRITICAL;
break ;
case 1 : /* low */
ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_LOW;
break ;
case 2 : /* medium */
ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_NORMAL;
break ;
case 3 : /* high */
ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_HIGH;
break ;
case 4 : /* full */
ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_FULL;
break ;
default :
ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_UNKNOWN;
hid_warn(ctlr->hdev, "Invalid battery status\n" );
break ;
}
spin_unlock_irqrestore(&ctlr->lock, flags);
}
static void joycon_report_left_stick(struct joycon_ctlr *ctlr,
struct joycon_input_report *rep)
{
u16 raw_x;
u16 raw_y;
s32 x;
s32 y;
raw_x = hid_field_extract(ctlr->hdev, rep->left_stick, 0 , 12 );
raw_y = hid_field_extract(ctlr->hdev, rep->left_stick + 1 , 4 , 12 );
x = joycon_map_stick_val(&ctlr->left_stick_cal_x, raw_x);
y = -joycon_map_stick_val(&ctlr->left_stick_cal_y, raw_y);
input_report_abs(ctlr->input, ABS_X, x);
input_report_abs(ctlr->input, ABS_Y, y);
}
static void joycon_report_right_stick(struct joycon_ctlr *ctlr,
struct joycon_input_report *rep)
{
u16 raw_x;
u16 raw_y;
s32 x;
s32 y;
raw_x = hid_field_extract(ctlr->hdev, rep->right_stick, 0 , 12 );
raw_y = hid_field_extract(ctlr->hdev, rep->right_stick + 1 , 4 , 12 );
x = joycon_map_stick_val(&ctlr->right_stick_cal_x, raw_x);
y = -joycon_map_stick_val(&ctlr->right_stick_cal_y, raw_y);
input_report_abs(ctlr->input, ABS_RX, x);
input_report_abs(ctlr->input, ABS_RY, y);
}
static void joycon_report_dpad(struct joycon_ctlr *ctlr,
struct joycon_input_report *rep)
{
int hatx = 0 ;
int haty = 0 ;
u32 btns = hid_field_extract(ctlr->hdev, rep->button_status, 0 , 24 );
if (btns & JC_BTN_LEFT)
hatx = -1 ;
else if (btns & JC_BTN_RIGHT)
hatx = 1 ;
if (btns & JC_BTN_UP)
haty = -1 ;
else if (btns & JC_BTN_DOWN)
haty = 1 ;
input_report_abs(ctlr->input, ABS_HAT0X, hatx);
input_report_abs(ctlr->input, ABS_HAT0Y, haty);
}
static void joycon_report_buttons(struct joycon_ctlr *ctlr,
struct joycon_input_report *rep,
const struct joycon_ctlr_button_mapping button_mappings[])
{
const struct joycon_ctlr_button_mapping *button;
u32 status = hid_field_extract(ctlr->hdev, rep->button_status, 0 , 24 );
for (button = button_mappings; button->code; button++)
input_report_key(ctlr->input, button->code, status & button->bit);
}
static void joycon_parse_report(struct joycon_ctlr *ctlr,
struct joycon_input_report *rep)
{
unsigned long flags;
unsigned long msecs = jiffies_to_msecs(jiffies);
unsigned long report_delta_ms = msecs - ctlr->last_input_report_msecs;
if (joycon_has_rumble(ctlr))
joycon_handle_rumble_report(ctlr, rep);
joycon_parse_battery_status(ctlr, rep);
if (joycon_type_is_left_joycon(ctlr)) {
joycon_report_left_stick(ctlr, rep);
joycon_report_buttons(ctlr, rep, left_joycon_button_mappings);
if (!joycon_device_is_chrggrip(ctlr))
joycon_report_buttons(ctlr, rep, left_joycon_s_button_mappings);
} else if (joycon_type_is_right_joycon(ctlr)) {
joycon_report_right_stick(ctlr, rep);
joycon_report_buttons(ctlr, rep, right_joycon_button_mappings);
if (!joycon_device_is_chrggrip(ctlr))
joycon_report_buttons(ctlr, rep, right_joycon_s_button_mappings);
} else if (joycon_type_is_procon(ctlr)) {
joycon_report_left_stick(ctlr, rep);
joycon_report_right_stick(ctlr, rep);
joycon_report_dpad(ctlr, rep);
joycon_report_buttons(ctlr, rep, procon_button_mappings);
} else if (joycon_type_is_any_nescon(ctlr)) {
joycon_report_dpad(ctlr, rep);
joycon_report_buttons(ctlr, rep, nescon_button_mappings);
} else if (joycon_type_is_snescon(ctlr)) {
joycon_report_dpad(ctlr, rep);
joycon_report_buttons(ctlr, rep, snescon_button_mappings);
} else if (joycon_type_is_gencon(ctlr)) {
joycon_report_dpad(ctlr, rep);
joycon_report_buttons(ctlr, rep, gencon_button_mappings);
} else if (joycon_type_is_n64con(ctlr)) {
joycon_report_left_stick(ctlr, rep);
joycon_report_dpad(ctlr, rep);
joycon_report_buttons(ctlr, rep, n64con_button_mappings);
}
input_sync(ctlr->input);
spin_lock_irqsave(&ctlr->lock, flags);
ctlr->last_input_report_msecs = msecs;
/*
* Was this input report a reasonable time delta compared to the prior
* report ? We use this information to decide when a safe time is to send
* rumble packets or subcommand packets .
*/
if (report_delta_ms >= JC_INPUT_REPORT_MIN_DELTA &&
report_delta_ms <= JC_INPUT_REPORT_MAX_DELTA) {
if (ctlr->consecutive_valid_report_deltas < JC_SUBCMD_VALID_DELTA_REQ)
ctlr->consecutive_valid_report_deltas++;
} else {
ctlr->consecutive_valid_report_deltas = 0 ;
}
/*
* Our consecutive valid report tracking is only relevant for
* bluetooth - connected controllers . For USB devices , we ' re beholden to
* USB ' s underlying polling rate anyway . Always set to the consecutive
* delta requirement .
*/
if (ctlr->hdev->bus == BUS_USB)
ctlr->consecutive_valid_report_deltas = JC_SUBCMD_VALID_DELTA_REQ;
spin_unlock_irqrestore(&ctlr->lock, flags);
/*
* Immediately after receiving a report is the most reliable time to
* send a subcommand to the controller . Wake any subcommand senders
* waiting for a report .
*/
if (unlikely(mutex_is_locked(&ctlr->output_mutex))) {
spin_lock_irqsave(&ctlr->lock, flags);
ctlr->received_input_report = true ;
spin_unlock_irqrestore(&ctlr->lock, flags);
wake_up(&ctlr->wait);
}
/* parse IMU data if present */
if ((rep->id == JC_INPUT_IMU_DATA) && joycon_has_imu(ctlr))
joycon_parse_imu_report(ctlr, rep);
}
static int joycon_send_rumble_data(struct joycon_ctlr *ctlr)
{
int ret;
unsigned long flags;
struct joycon_rumble_output rumble_output = { 0 };
spin_lock_irqsave(&ctlr->lock, flags);
/*
* If the controller has been removed , just return ENODEV so the LED
* subsystem doesn ' t print invalid errors on removal .
*/
if (ctlr->ctlr_state == JOYCON_CTLR_STATE_REMOVED) {
spin_unlock_irqrestore(&ctlr->lock, flags);
return -ENODEV;
}
memcpy(rumble_output.rumble_data,
ctlr->rumble_data[ctlr->rumble_queue_tail],
JC_RUMBLE_DATA_SIZE);
spin_unlock_irqrestore(&ctlr->lock, flags);
rumble_output.output_id = JC_OUTPUT_RUMBLE_ONLY;
rumble_output.packet_num = ctlr->subcmd_num;
if (++ctlr->subcmd_num > 0 xF)
ctlr->subcmd_num = 0 ;
joycon_enforce_subcmd_rate(ctlr);
ret = __joycon_hid_send(ctlr->hdev, (u8 *)&rumble_output,
sizeof (rumble_output));
return ret;
}
static void joycon_rumble_worker(struct work_struct *work)
{
struct joycon_ctlr *ctlr = container_of(work, struct joycon_ctlr,
rumble_worker);
unsigned long flags;
bool again = true ;
int ret;
while (again) {
mutex_lock(&ctlr->output_mutex);
ret = joycon_send_rumble_data(ctlr);
mutex_unlock(&ctlr->output_mutex);
/* -ENODEV means the controller was just unplugged */
spin_lock_irqsave(&ctlr->lock, flags);
if (ret < 0 && ret != -ENODEV &&
ctlr->ctlr_state != JOYCON_CTLR_STATE_REMOVED)
hid_warn(ctlr->hdev, "Failed to set rumble; e=%d" , ret);
ctlr->rumble_msecs = jiffies_to_msecs(jiffies);
if (ctlr->rumble_queue_tail != ctlr->rumble_queue_head) {
if (++ctlr->rumble_queue_tail >= JC_RUMBLE_QUEUE_SIZE)
ctlr->rumble_queue_tail = 0 ;
} else {
again = false ;
}
spin_unlock_irqrestore(&ctlr->lock, flags);
}
}
#if IS_ENABLED(CONFIG_NINTENDO_FF)
static struct joycon_rumble_freq_data joycon_find_rumble_freq(u16 freq)
{
const size_t length = ARRAY_SIZE(joycon_rumble_frequencies);
const struct joycon_rumble_freq_data *data = joycon_rumble_frequencies;
int i = 0 ;
if (freq > data[0 ].freq) {
for (i = 1 ; i < length - 1 ; i++) {
if (freq > data[i - 1 ].freq && freq <= data[i].freq)
break ;
}
}
return data[i];
}
static struct joycon_rumble_amp_data joycon_find_rumble_amp(u16 amp)
{
const size_t length = ARRAY_SIZE(joycon_rumble_amplitudes);
const struct joycon_rumble_amp_data *data = joycon_rumble_amplitudes;
int i = 0 ;
if (amp > data[0 ].amp) {
for (i = 1 ; i < length - 1 ; i++) {
if (amp > data[i - 1 ].amp && amp <= data[i].amp)
break ;
}
}
return data[i];
}
static void joycon_encode_rumble(u8 *data, u16 freq_low, u16 freq_high, u16 amp)
{
struct joycon_rumble_freq_data freq_data_low;
struct joycon_rumble_freq_data freq_data_high;
struct joycon_rumble_amp_data amp_data;
freq_data_low = joycon_find_rumble_freq(freq_low);
freq_data_high = joycon_find_rumble_freq(freq_high);
amp_data = joycon_find_rumble_amp(amp);
data[0 ] = (freq_data_high.high >> 8 ) & 0 xFF;
data[1 ] = (freq_data_high.high & 0 xFF) + amp_data.high;
data[2 ] = freq_data_low.low + ((amp_data.low >> 8 ) & 0 xFF);
data[3 ] = amp_data.low & 0 xFF;
}
static const u16 JOYCON_MAX_RUMBLE_HIGH_FREQ = 1253 ;
static const u16 JOYCON_MIN_RUMBLE_HIGH_FREQ = 82 ;
static const u16 JOYCON_MAX_RUMBLE_LOW_FREQ = 626 ;
static const u16 JOYCON_MIN_RUMBLE_LOW_FREQ = 41 ;
static void joycon_clamp_rumble_freqs(struct joycon_ctlr *ctlr)
{
unsigned long flags;
spin_lock_irqsave(&ctlr->lock, flags);
ctlr->rumble_ll_freq = clamp(ctlr->rumble_ll_freq,
JOYCON_MIN_RUMBLE_LOW_FREQ,
JOYCON_MAX_RUMBLE_LOW_FREQ);
ctlr->rumble_lh_freq = clamp(ctlr->rumble_lh_freq,
JOYCON_MIN_RUMBLE_HIGH_FREQ,
JOYCON_MAX_RUMBLE_HIGH_FREQ);
ctlr->rumble_rl_freq = clamp(ctlr->rumble_rl_freq,
JOYCON_MIN_RUMBLE_LOW_FREQ,
JOYCON_MAX_RUMBLE_LOW_FREQ);
ctlr->rumble_rh_freq = clamp(ctlr->rumble_rh_freq,
JOYCON_MIN_RUMBLE_HIGH_FREQ,
JOYCON_MAX_RUMBLE_HIGH_FREQ);
spin_unlock_irqrestore(&ctlr->lock, flags);
}
static int joycon_set_rumble(struct joycon_ctlr *ctlr, u16 amp_r, u16 amp_l,
bool schedule_now)
{
u8 data[JC_RUMBLE_DATA_SIZE];
u16 amp;
u16 freq_r_low;
u16 freq_r_high;
u16 freq_l_low;
u16 freq_l_high;
unsigned long flags;
int next_rq_head;
spin_lock_irqsave(&ctlr->lock, flags);
freq_r_low = ctlr->rumble_rl_freq;
freq_r_high = ctlr->rumble_rh_freq;
freq_l_low = ctlr->rumble_ll_freq;
freq_l_high = ctlr->rumble_lh_freq;
/* limit number of silent rumble packets to reduce traffic */
if (amp_l != 0 || amp_r != 0 )
ctlr->rumble_zero_countdown = JC_RUMBLE_ZERO_AMP_PKT_CNT;
spin_unlock_irqrestore(&ctlr->lock, flags);
/* right joy-con */
amp = amp_r * (u32)joycon_max_rumble_amp / 65535 ;
joycon_encode_rumble(data + 4 , freq_r_low, freq_r_high, amp);
/* left joy-con */
amp = amp_l * (u32)joycon_max_rumble_amp / 65535 ;
joycon_encode_rumble(data, freq_l_low, freq_l_high, amp);
spin_lock_irqsave(&ctlr->lock, flags);
next_rq_head = ctlr->rumble_queue_head + 1 ;
if (next_rq_head >= JC_RUMBLE_QUEUE_SIZE)
next_rq_head = 0 ;
/* Did we overrun the circular buffer?
* If so , be sure we keep the latest intended rumble state .
*/
if (next_rq_head == ctlr->rumble_queue_tail) {
hid_dbg(ctlr->hdev, "rumble queue is full" );
/* overwrite the prior value at the end of the circular buf */
next_rq_head = ctlr->rumble_queue_head;
}
ctlr->rumble_queue_head = next_rq_head;
memcpy(ctlr->rumble_data[ctlr->rumble_queue_head], data,
JC_RUMBLE_DATA_SIZE);
/* don't wait for the periodic send (reduces latency) */
if (schedule_now && ctlr->ctlr_state != JOYCON_CTLR_STATE_REMOVED)
queue_work(ctlr->rumble_queue, &ctlr->rumble_worker);
spin_unlock_irqrestore(&ctlr->lock, flags);
return 0 ;
}
static int joycon_play_effect(struct input_dev *dev, void *data,
struct ff_effect *effect)
{
struct joycon_ctlr *ctlr = input_get_drvdata(dev);
if (effect->type != FF_RUMBLE)
return 0 ;
return joycon_set_rumble(ctlr,
effect->u.rumble.weak_magnitude,
effect->u.rumble.strong_magnitude,
true );
}
#endif /* IS_ENABLED(CONFIG_NINTENDO_FF) */
static void joycon_config_left_stick(struct input_dev *idev)
{
input_set_abs_params(idev,
ABS_X,
-JC_MAX_STICK_MAG,
JC_MAX_STICK_MAG,
JC_STICK_FUZZ,
JC_STICK_FLAT);
input_set_abs_params(idev,
ABS_Y,
-JC_MAX_STICK_MAG,
JC_MAX_STICK_MAG,
JC_STICK_FUZZ,
JC_STICK_FLAT);
}
static void joycon_config_right_stick(struct input_dev *idev)
{
input_set_abs_params(idev,
ABS_RX,
-JC_MAX_STICK_MAG,
JC_MAX_STICK_MAG,
JC_STICK_FUZZ,
JC_STICK_FLAT);
input_set_abs_params(idev,
ABS_RY,
-JC_MAX_STICK_MAG,
JC_MAX_STICK_MAG,
JC_STICK_FUZZ,
JC_STICK_FLAT);
}
static void joycon_config_dpad(struct input_dev *idev)
{
input_set_abs_params(idev,
ABS_HAT0X,
-JC_MAX_DPAD_MAG,
JC_MAX_DPAD_MAG,
JC_DPAD_FUZZ,
JC_DPAD_FLAT);
input_set_abs_params(idev,
ABS_HAT0Y,
-JC_MAX_DPAD_MAG,
JC_MAX_DPAD_MAG,
JC_DPAD_FUZZ,
JC_DPAD_FLAT);
}
static void joycon_config_buttons(struct input_dev *idev,
const struct joycon_ctlr_button_mapping button_mappings[])
{
const struct joycon_ctlr_button_mapping *button;
for (button = button_mappings; button->code; button++)
input_set_capability(idev, EV_KEY, button->code);
}
static void joycon_config_rumble(struct joycon_ctlr *ctlr)
{
#if IS_ENABLED(CONFIG_NINTENDO_FF)
/* set up rumble */
input_set_capability(ctlr->input, EV_FF, FF_RUMBLE);
input_ff_create_memless(ctlr->input, NULL, joycon_play_effect);
ctlr->rumble_ll_freq = JC_RUMBLE_DFLT_LOW_FREQ;
ctlr->rumble_lh_freq = JC_RUMBLE_DFLT_HIGH_FREQ;
ctlr->rumble_rl_freq = JC_RUMBLE_DFLT_LOW_FREQ;
ctlr->rumble_rh_freq = JC_RUMBLE_DFLT_HIGH_FREQ;
joycon_clamp_rumble_freqs(ctlr);
joycon_set_rumble(ctlr, 0 , 0 , false );
ctlr->rumble_msecs = jiffies_to_msecs(jiffies);
#endif
}
static int joycon_imu_input_create(struct joycon_ctlr *ctlr)
{
struct hid_device *hdev;
const char *imu_name;
int ret;
hdev = ctlr->hdev;
/* configure the imu input device */
ctlr->imu_input = devm_input_allocate_device(&hdev->dev);
if (!ctlr->imu_input)
return -ENOMEM;
ctlr->imu_input->id.bustype = hdev->bus;
ctlr->imu_input->id.vendor = hdev->vendor;
ctlr->imu_input->id.product = hdev->product;
ctlr->imu_input->id.version = hdev->version;
ctlr->imu_input->uniq = ctlr->mac_addr_str;
ctlr->imu_input->phys = hdev->phys;
imu_name = devm_kasprintf(&hdev->dev, GFP_KERNEL, "%s (IMU)" , ctlr->input->name);
if (!imu_name)
return -ENOMEM;
ctlr->imu_input->name = imu_name;
input_set_drvdata(ctlr->imu_input, ctlr);
/* configure imu axes */
input_set_abs_params(ctlr->imu_input, ABS_X,
-JC_IMU_MAX_ACCEL_MAG, JC_IMU_MAX_ACCEL_MAG,
JC_IMU_ACCEL_FUZZ, JC_IMU_ACCEL_FLAT);
input_set_abs_params(ctlr->imu_input, ABS_Y,
-JC_IMU_MAX_ACCEL_MAG, JC_IMU_MAX_ACCEL_MAG,
JC_IMU_ACCEL_FUZZ, JC_IMU_ACCEL_FLAT);
input_set_abs_params(ctlr->imu_input, ABS_Z,
-JC_IMU_MAX_ACCEL_MAG, JC_IMU_MAX_ACCEL_MAG,
JC_IMU_ACCEL_FUZZ, JC_IMU_ACCEL_FLAT);
input_abs_set_res(ctlr->imu_input, ABS_X, JC_IMU_ACCEL_RES_PER_G);
input_abs_set_res(ctlr->imu_input, ABS_Y, JC_IMU_ACCEL_RES_PER_G);
input_abs_set_res(ctlr->imu_input, ABS_Z, JC_IMU_ACCEL_RES_PER_G);
input_set_abs_params(ctlr->imu_input, ABS_RX,
-JC_IMU_MAX_GYRO_MAG, JC_IMU_MAX_GYRO_MAG,
JC_IMU_GYRO_FUZZ, JC_IMU_GYRO_FLAT);
input_set_abs_params(ctlr->imu_input, ABS_RY,
-JC_IMU_MAX_GYRO_MAG, JC_IMU_MAX_GYRO_MAG,
JC_IMU_GYRO_FUZZ, JC_IMU_GYRO_FLAT);
input_set_abs_params(ctlr->imu_input, ABS_RZ,
-JC_IMU_MAX_GYRO_MAG, JC_IMU_MAX_GYRO_MAG,
JC_IMU_GYRO_FUZZ, JC_IMU_GYRO_FLAT);
input_abs_set_res(ctlr->imu_input, ABS_RX, JC_IMU_GYRO_RES_PER_DPS);
input_abs_set_res(ctlr->imu_input, ABS_RY, JC_IMU_GYRO_RES_PER_DPS);
input_abs_set_res(ctlr->imu_input, ABS_RZ, JC_IMU_GYRO_RES_PER_DPS);
__set_bit(EV_MSC, ctlr->imu_input->evbit);
__set_bit(MSC_TIMESTAMP, ctlr->imu_input->mscbit);
__set_bit(INPUT_PROP_ACCELEROMETER, ctlr->imu_input->propbit);
ret = input_register_device(ctlr->imu_input);
if (ret)
return ret;
return 0 ;
}
static int joycon_input_create(struct joycon_ctlr *ctlr)
{
struct hid_device *hdev;
int ret;
hdev = ctlr->hdev;
ctlr->input = devm_input_allocate_device(&hdev->dev);
if (!ctlr->input)
return -ENOMEM;
ctlr->input->id.bustype = hdev->bus;
ctlr->input->id.vendor = hdev->vendor;
ctlr->input->id.product = hdev->product;
ctlr->input->id.version = hdev->version;
ctlr->input->uniq = ctlr->mac_addr_str;
ctlr->input->name = hdev->name;
ctlr->input->phys = hdev->phys;
input_set_drvdata(ctlr->input, ctlr);
ret = input_register_device(ctlr->input);
if (ret)
return ret;
if (joycon_type_is_right_joycon(ctlr)) {
joycon_config_right_stick(ctlr->input);
joycon_config_buttons(ctlr->input, right_joycon_button_mappings);
if (!joycon_device_is_chrggrip(ctlr))
joycon_config_buttons(ctlr->input, right_joycon_s_button_mappings);
} else if (joycon_type_is_left_joycon(ctlr)) {
joycon_config_left_stick(ctlr->input);
joycon_config_buttons(ctlr->input, left_joycon_button_mappings);
if (!joycon_device_is_chrggrip(ctlr))
joycon_config_buttons(ctlr->input, left_joycon_s_button_mappings);
} else if (joycon_type_is_procon(ctlr)) {
joycon_config_left_stick(ctlr->input);
joycon_config_right_stick(ctlr->input);
joycon_config_dpad(ctlr->input);
joycon_config_buttons(ctlr->input, procon_button_mappings);
} else if (joycon_type_is_any_nescon(ctlr)) {
joycon_config_dpad(ctlr->input);
joycon_config_buttons(ctlr->input, nescon_button_mappings);
} else if (joycon_type_is_snescon(ctlr)) {
joycon_config_dpad(ctlr->input);
joycon_config_buttons(ctlr->input, snescon_button_mappings);
} else if (joycon_type_is_gencon(ctlr)) {
joycon_config_dpad(ctlr->input);
joycon_config_buttons(ctlr->input, gencon_button_mappings);
} else if (joycon_type_is_n64con(ctlr)) {
joycon_config_dpad(ctlr->input);
joycon_config_left_stick(ctlr->input);
joycon_config_buttons(ctlr->input, n64con_button_mappings);
}
if (joycon_has_imu(ctlr)) {
ret = joycon_imu_input_create(ctlr);
if (ret)
return ret;
}
if (joycon_has_rumble(ctlr))
joycon_config_rumble(ctlr);
return 0 ;
}
/* Because the subcommand sets all the leds at once, the brightness argument is ignored */
static int joycon_player_led_brightness_set(struct led_classdev *led,
enum led_brightness brightness)
{
struct device *dev = led->dev->parent;
struct hid_device *hdev = to_hid_device(dev);
struct joycon_ctlr *ctlr;
int val = 0 ;
int i;
int ret;
ctlr = hid_get_drvdata(hdev);
if (!ctlr) {
hid_err(hdev, "No controller data\n" );
return -ENODEV;
}
for (i = 0 ; i < JC_NUM_LEDS; i++)
val |= ctlr->leds[i].brightness << i;
mutex_lock(&ctlr->output_mutex);
ret = joycon_set_player_leds(ctlr, 0 , val);
mutex_unlock(&ctlr->output_mutex);
return ret;
}
static int joycon_home_led_brightness_set(struct led_classdev *led,
enum led_brightness brightness)
{
struct device *dev = led->dev->parent;
struct hid_device *hdev = to_hid_device(dev);
struct joycon_ctlr *ctlr;
int ret;
ctlr = hid_get_drvdata(hdev);
if (!ctlr) {
hid_err(hdev, "No controller data\n" );
return -ENODEV;
}
mutex_lock(&ctlr->output_mutex);
ret = joycon_set_home_led(ctlr, brightness);
mutex_unlock(&ctlr->output_mutex);
return ret;
}
static DEFINE_IDA(nintendo_player_id_allocator);
static int joycon_leds_create(struct joycon_ctlr *ctlr)
{
struct hid_device *hdev = ctlr->hdev;
struct device *dev = &hdev->dev;
const char *d_name = dev_name(dev);
struct led_classdev *led;
int led_val = 0 ;
char *name;
int ret;
int i;
int player_led_pattern;
/* configure the player LEDs */
ctlr->player_id = U32_MAX;
ret = ida_alloc(&nintendo_player_id_allocator, GFP_KERNEL);
if (ret < 0 ) {
hid_warn(hdev, "Failed to allocate player ID, skipping; ret=%d\n" , ret);
goto home_led;
}
ctlr->player_id = ret;
player_led_pattern = ret % JC_NUM_LED_PATTERNS;
hid_info(ctlr->hdev, "assigned player %d led pattern" , player_led_pattern + 1 );
for (i = 0 ; i < JC_NUM_LEDS; i++) {
name = devm_kasprintf(dev, GFP_KERNEL, "%s:%s:%s" ,
d_name,
"green" ,
joycon_player_led_names[i]);
if (!name)
return -ENOMEM;
led = &ctlr->leds[i];
led->name = name;
led->brightness = joycon_player_led_patterns[player_led_pattern][i];
led->max_brightness = 1 ;
led->brightness_set_blocking =
joycon_player_led_brightness_set;
led->flags = LED_CORE_SUSPENDRESUME | LED_HW_PLUGGABLE;
led_val |= joycon_player_led_patterns[player_led_pattern][i] << i;
}
mutex_lock(&ctlr->output_mutex);
ret = joycon_set_player_leds(ctlr, 0 , led_val);
mutex_unlock(&ctlr->output_mutex);
if (ret) {
hid_warn(hdev, "Failed to set players LEDs, skipping registration; ret=%d\n" , ret);
goto home_led;
}
for (i = 0 ; i < JC_NUM_LEDS; i++) {
led = &ctlr->leds[i];
ret = devm_led_classdev_register(&hdev->dev, led);
if (ret) {
hid_err(hdev, "Failed to register player %d LED; ret=%d\n" , i + 1 , ret);
return ret;
}
}
home_led:
/* configure the home LED */
if (jc_type_has_right(ctlr)) {
name = devm_kasprintf(dev, GFP_KERNEL, "%s:%s:%s" ,
d_name,
"blue" ,
LED_FUNCTION_PLAYER5);
if (!name)
return -ENOMEM;
led = &ctlr->home_led;
led->name = name;
led->brightness = 0 ;
led->max_brightness = 0 xF;
led->brightness_set_blocking = joycon_home_led_brightness_set;
led->flags = LED_CORE_SUSPENDRESUME | LED_HW_PLUGGABLE;
/* Set the home LED to 0 as default state */
mutex_lock(&ctlr->output_mutex);
ret = joycon_set_home_led(ctlr, 0 );
mutex_unlock(&ctlr->output_mutex);
if (ret) {
hid_warn(hdev, "Failed to set home LED, skipping registration; ret=%d\n" , ret);
return 0 ;
}
ret = devm_led_classdev_register(&hdev->dev, led);
if (ret) {
hid_err(hdev, "Failed to register home LED; ret=%d\n" , ret);
return ret;
}
}
return 0 ;
}
static int joycon_battery_get_property(struct power_supply *supply,
enum power_supply_property prop,
union power_supply_propval *val)
{
struct joycon_ctlr *ctlr = power_supply_get_drvdata(supply);
unsigned long flags;
int ret = 0 ;
u8 capacity;
bool charging;
bool powered;
spin_lock_irqsave(&ctlr->lock, flags);
capacity = ctlr->battery_capacity;
charging = ctlr->battery_charging;
powered = ctlr->host_powered;
spin_unlock_irqrestore(&ctlr->lock, flags);
switch (prop) {
case POWER_SUPPLY_PROP_PRESENT:
val->intval = 1 ;
break ;
case POWER_SUPPLY_PROP_SCOPE:
val->intval = POWER_SUPPLY_SCOPE_DEVICE;
break ;
case POWER_SUPPLY_PROP_CAPACITY_LEVEL:
val->intval = capacity;
break ;
case POWER_SUPPLY_PROP_STATUS:
if (charging)
val->intval = POWER_SUPPLY_STATUS_CHARGING;
else if (capacity == POWER_SUPPLY_CAPACITY_LEVEL_FULL &&
powered)
val->intval = POWER_SUPPLY_STATUS_FULL;
else
val->intval = POWER_SUPPLY_STATUS_DISCHARGING;
break ;
default :
ret = -EINVAL;
break ;
}
return ret;
}
static enum power_supply_property joycon_battery_props[] = {
POWER_SUPPLY_PROP_PRESENT,
POWER_SUPPLY_PROP_CAPACITY_LEVEL,
POWER_SUPPLY_PROP_SCOPE,
POWER_SUPPLY_PROP_STATUS,
};
static int joycon_power_supply_create(struct joycon_ctlr *ctlr)
{
struct hid_device *hdev = ctlr->hdev;
struct power_supply_config supply_config = { .drv_data = ctlr, };
const char * const name_fmt = "nintendo_switch_controller_battery_%s" ;
int ret = 0 ;
/* Set initially to unknown before receiving first input report */
ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_UNKNOWN;
/* Configure the battery's description */
ctlr->battery_desc.properties = joycon_battery_props;
ctlr->battery_desc.num_properties =
ARRAY_SIZE(joycon_battery_props);
ctlr->battery_desc.get_property = joycon_battery_get_property;
ctlr->battery_desc.type = POWER_SUPPLY_TYPE_BATTERY;
ctlr->battery_desc.use_for_apm = 0 ;
ctlr->battery_desc.name = devm_kasprintf(&hdev->dev, GFP_KERNEL,
name_fmt,
dev_name(&hdev->dev));
if (!ctlr->battery_desc.name)
return -ENOMEM;
ctlr->battery = devm_power_supply_register(&hdev->dev,
&ctlr->battery_desc,
&supply_config);
if (IS_ERR(ctlr->battery)) {
ret = PTR_ERR(ctlr->battery);
hid_err(hdev, "Failed to register battery; ret=%d\n" , ret);
return ret;
}
return power_supply_powers(ctlr->battery, &hdev->dev);
}
static int joycon_read_info(struct joycon_ctlr *ctlr)
{
int ret;
int i;
int j;
struct joycon_subcmd_request req = { 0 };
struct joycon_input_report *report;
req.subcmd_id = JC_SUBCMD_REQ_DEV_INFO;
ret = joycon_send_subcmd(ctlr, &req, 0 , 2 * HZ);
if (ret) {
hid_err(ctlr->hdev, "Failed to get joycon info; ret=%d\n" , ret);
return ret;
}
report = (struct joycon_input_report *)ctlr->input_buf;
for (i = 4 , j = 0 ; j < 6 ; i++, j++)
ctlr->mac_addr[j] = report->subcmd_reply.data[i];
ctlr->mac_addr_str = devm_kasprintf(&ctlr->hdev->dev, GFP_KERNEL,
"%02X:%02X:%02X:%02X:%02X:%02X" ,
ctlr->mac_addr[0 ],
ctlr->mac_addr[1 ],
ctlr->mac_addr[2 ],
ctlr->mac_addr[3 ],
ctlr->mac_addr[4 ],
ctlr->mac_addr[5 ]);
if (!ctlr->mac_addr_str)
return -ENOMEM;
hid_info(ctlr->hdev, "controller MAC = %s\n" , ctlr->mac_addr_str);
/*
* Retrieve the type so we can distinguish the controller type
* Unfortantly the hdev - > product can ' t always be used due to a ? bug ?
* with the NSO Genesis controller . Over USB , it will report the
* PID as 0 x201E , but over bluetooth it will report the PID as 0 x2017
* which is the same as the NSO SNES controller . This is different from
* the rest of the controllers which will report the same PID over USB
* and bluetooth .
*/
ctlr->ctlr_type = report->subcmd_reply.data[2 ];
hid_dbg(ctlr->hdev, "controller type = 0x%02X\n" , ctlr->ctlr_type);
return 0 ;
}
static int joycon_init(struct hid_device *hdev)
{
struct joycon_ctlr *ctlr = hid_get_drvdata(hdev);
int ret = 0 ;
mutex_lock(&ctlr->output_mutex);
/* if handshake command fails, assume ble pro controller */
if (joycon_using_usb(ctlr) && !joycon_send_usb(ctlr, JC_USB_CMD_HANDSHAKE, HZ)) {
hid_dbg(hdev, "detected USB controller\n" );
/* set baudrate for improved latency */
ret = joycon_send_usb(ctlr, JC_USB_CMD_BAUDRATE_3M, HZ);
if (ret) {
/*
* We can function with the default baudrate .
* Provide a warning , and continue on .
*/
hid_warn(hdev, "Failed to set baudrate (ret=%d), continuing anyway\n" , ret);
}
/* handshake */
ret = joycon_send_usb(ctlr, JC_USB_CMD_HANDSHAKE, HZ);
if (ret) {
hid_err(hdev, "Failed handshake; ret=%d\n" , ret);
goto out_unlock;
}
/*
* Set no timeout ( to keep controller in USB mode ) .
* This doesn ' t send a response , so ignore the timeout .
*/
joycon_send_usb(ctlr, JC_USB_CMD_NO_TIMEOUT, HZ/10 );
} else if (jc_type_is_chrggrip(ctlr)) {
hid_err(hdev, "Failed charging grip handshake\n" );
ret = -ETIMEDOUT;
goto out_unlock;
}
/* needed to retrieve the controller type */
ret = joycon_read_info(ctlr);
if (ret) {
hid_err(hdev, "Failed to retrieve controller info; ret=%d\n" ,
ret);
goto out_unlock;
}
if (joycon_has_joysticks(ctlr)) {
/* get controller calibration data, and parse it */
ret = joycon_request_calibration(ctlr);
if (ret) {
/*
* We can function with default calibration , but it may be
* inaccurate . Provide a warning , and continue on .
*/
hid_warn(hdev, "Analog stick positions may be inaccurate\n" );
}
}
if (joycon_has_imu(ctlr)) {
/* get IMU calibration data, and parse it */
ret = joycon_request_imu_calibration(ctlr);
if (ret) {
/*
* We can function with default calibration , but it may be
* inaccurate . Provide a warning , and continue on .
*/
hid_warn(hdev, "Unable to read IMU calibration data\n" );
}
/* Enable the IMU */
ret = joycon_enable_imu(ctlr);
if (ret) {
hid_err(hdev, "Failed to enable the IMU; ret=%d\n" , ret);
goto out_unlock;
}
}
/* Set the reporting mode to 0x30, which is the full report mode */
ret = joycon_set_report_mode(ctlr);
if (ret) {
hid_err(hdev, "Failed to set report mode; ret=%d\n" , ret);
goto out_unlock;
}
if (joycon_has_rumble(ctlr)) {
/* Enable rumble */
ret = joycon_enable_rumble(ctlr);
if (ret) {
hid_err(hdev, "Failed to enable rumble; ret=%d\n" , ret);
goto out_unlock;
}
}
out_unlock:
mutex_unlock(&ctlr->output_mutex);
return ret;
}
/* Common handler for parsing inputs */
static int joycon_ctlr_read_handler(struct joycon_ctlr *ctlr, u8 *data,
int size)
{
if (data[0 ] == JC_INPUT_SUBCMD_REPLY || data[0 ] == JC_INPUT_IMU_DATA ||
data[0 ] == JC_INPUT_MCU_DATA) {
if (size >= 12 ) /* make sure it contains the input report */
joycon_parse_report(ctlr,
(struct joycon_input_report *)data);
}
return 0 ;
}
static int joycon_ctlr_handle_event(struct joycon_ctlr *ctlr, u8 *data,
int size)
{
int ret = 0 ;
bool match = false ;
struct joycon_input_report *report;
if (unlikely(mutex_is_locked(&ctlr->output_mutex)) &&
ctlr->msg_type != JOYCON_MSG_TYPE_NONE) {
switch (ctlr->msg_type) {
case JOYCON_MSG_TYPE_USB:
if (size < 2 )
break ;
if (data[0 ] == JC_INPUT_USB_RESPONSE &&
data[1 ] == ctlr->usb_ack_match)
match = true ;
break ;
case JOYCON_MSG_TYPE_SUBCMD:
if (size < sizeof (struct joycon_input_report) ||
data[0 ] != JC_INPUT_SUBCMD_REPLY)
break ;
report = (struct joycon_input_report *)data;
if (report->subcmd_reply.id == ctlr->subcmd_ack_match)
match = true ;
break ;
default :
break ;
}
if (match) {
memcpy(ctlr->input_buf, data,
min(size, (int )JC_MAX_RESP_SIZE));
ctlr->msg_type = JOYCON_MSG_TYPE_NONE;
ctlr->received_resp = true ;
wake_up(&ctlr->wait);
/* This message has been handled */
return 1 ;
}
}
if (ctlr->ctlr_state == JOYCON_CTLR_STATE_READ)
ret = joycon_ctlr_read_handler(ctlr, data, size);
return ret;
}
static int nintendo_hid_event(struct hid_device *hdev,
struct hid_report *report, u8 *raw_data, int size)
{
struct joycon_ctlr *ctlr = hid_get_drvdata(hdev);
if (size < 1 )
return -EINVAL;
return joycon_ctlr_handle_event(ctlr, raw_data, size);
}
static int nintendo_hid_probe(struct hid_device *hdev,
const struct hid_device_id *id)
{
int ret;
struct joycon_ctlr *ctlr;
hid_dbg(hdev, "probe - start\n" );
ctlr = devm_kzalloc(&hdev->dev, sizeof (*ctlr), GFP_KERNEL);
if (!ctlr) {
ret = -ENOMEM;
goto err;
}
ctlr->hdev = hdev;
ctlr->ctlr_state = JOYCON_CTLR_STATE_INIT;
ctlr->rumble_queue_head = 0 ;
ctlr->rumble_queue_tail = 0 ;
hid_set_drvdata(hdev, ctlr);
mutex_init(&ctlr->output_mutex);
init_waitqueue_head(&ctlr->wait);
spin_lock_init(&ctlr->lock);
ctlr->rumble_queue = alloc_workqueue("hid-nintendo-rumble_wq" ,
WQ_FREEZABLE | WQ_MEM_RECLAIM, 0 );
if (!ctlr->rumble_queue) {
ret = -ENOMEM;
goto err;
}
INIT_WORK(&ctlr->rumble_worker, joycon_rumble_worker);
ret = hid_parse(hdev);
if (ret) {
hid_err(hdev, "HID parse failed\n" );
goto err_wq;
}
/*
* Patch the hw version of pro controller / joycons , so applications can
* distinguish between the default HID mappings and the mappings defined
* by the Linux game controller spec . This is important for the SDL2
* library , which has a game controller database , which uses device ids
* in combination with version as a key .
*/
hdev->version |= 0 x8000;
ret = hid_hw_start(hdev, HID_CONNECT_HIDRAW);
if (ret) {
hid_err(hdev, "HW start failed\n" );
goto err_wq;
}
ret = hid_hw_open(hdev);
if (ret) {
hid_err(hdev, "cannot start hardware I/O\n" );
goto err_stop;
}
hid_device_io_start(hdev);
ret = joycon_init(hdev);
if (ret) {
hid_err(hdev, "Failed to initialize controller; ret=%d\n" , ret);
goto err_close;
}
/* Initialize the leds */
ret = joycon_leds_create(ctlr);
if (ret) {
hid_err(hdev, "Failed to create leds; ret=%d\n" , ret);
goto err_close;
}
/* Initialize the battery power supply */
ret = joycon_power_supply_create(ctlr);
if (ret) {
hid_err(hdev, "Failed to create power_supply; ret=%d\n" , ret);
goto err_ida;
}
ret = joycon_input_create(ctlr);
if (ret) {
hid_err(hdev, "Failed to create input device; ret=%d\n" , ret);
goto err_ida;
}
ctlr->ctlr_state = JOYCON_CTLR_STATE_READ;
hid_dbg(hdev, "probe - success\n" );
return 0 ;
err_ida:
ida_free(&nintendo_player_id_allocator, ctlr->player_id);
err_close:
hid_hw_close(hdev);
err_stop:
hid_hw_stop(hdev);
err_wq:
destroy_workqueue(ctlr->rumble_queue);
err:
hid_err(hdev, "probe - fail = %d\n" , ret);
return ret;
}
static void nintendo_hid_remove(struct hid_device *hdev)
{
struct joycon_ctlr *ctlr = hid_get_drvdata(hdev);
unsigned long flags;
hid_dbg(hdev, "remove\n" );
/* Prevent further attempts at sending subcommands. */
spin_lock_irqsave(&ctlr->lock, flags);
ctlr->ctlr_state = JOYCON_CTLR_STATE_REMOVED;
spin_unlock_irqrestore(&ctlr->lock, flags);
destroy_workqueue(ctlr->rumble_queue);
ida_free(&nintendo_player_id_allocator, ctlr->player_id);
hid_hw_close(hdev);
hid_hw_stop(hdev);
}
#ifdef CONFIG_PM
static int nintendo_hid_resume(struct hid_device *hdev)
{
struct joycon_ctlr *ctlr = hid_get_drvdata(hdev);
int ret;
hid_dbg(hdev, "resume\n" );
if (!joycon_using_usb(ctlr)) {
hid_dbg(hdev, "no-op resume for bt ctlr\n" );
ctlr->ctlr_state = JOYCON_CTLR_STATE_READ;
return 0 ;
}
ret = joycon_init(hdev);
if (ret)
hid_err(hdev,
"Failed to restore controller after resume: %d\n" ,
ret);
else
ctlr->ctlr_state = JOYCON_CTLR_STATE_READ;
return ret;
}
static int nintendo_hid_suspend(struct hid_device *hdev, pm_message_t message)
{
struct joycon_ctlr *ctlr = hid_get_drvdata(hdev);
hid_dbg(hdev, "suspend: %d\n" , message.event);
/*
* Avoid any blocking loops in suspend / resume transitions .
*
* joycon_enforce_subcmd_rate ( ) can result in repeated retries if for
* whatever reason the controller stops providing input reports .
*
* This has been observed with bluetooth controllers which lose
* connectivity prior to suspend ( but not long enough to result in
* complete disconnection ) .
*/
ctlr->ctlr_state = JOYCON_CTLR_STATE_SUSPENDED;
return 0 ;
}
#endif
static const struct hid_device_id nintendo_hid_devices[] = {
{ HID_USB_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_PROCON) },
{ HID_USB_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_SNESCON) },
{ HID_USB_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_GENCON) },
{ HID_USB_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_N64CON) },
{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_PROCON) },
{ HID_USB_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_CHRGGRIP) },
{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_JOYCONL) },
{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_JOYCONR) },
{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_SNESCON) },
{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_GENCON) },
{ HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
USB_DEVICE_ID_NINTENDO_N64CON) },
{ }
};
MODULE_DEVICE_TABLE(hid, nintendo_hid_devices);
static struct hid_driver nintendo_hid_driver = {
.name = "nintendo" ,
.id_table = nintendo_hid_devices,
.probe = nintendo_hid_probe,
.remove = nintendo_hid_remove,
.raw_event = nintendo_hid_event,
#ifdef CONFIG_PM
.resume = nintendo_hid_resume,
.suspend = nintendo_hid_suspend,
#endif
};
static int __init nintendo_init(void )
{
return hid_register_driver(&nintendo_hid_driver);
}
static void __exit nintendo_exit(void )
{
hid_unregister_driver(&nintendo_hid_driver);
ida_destroy(&nintendo_player_id_allocator);
}
module_init(nintendo_init);
module_exit(nintendo_exit);
MODULE_LICENSE("GPL" );
MODULE_AUTHOR("Ryan McClelland <rymcclel@gmail.com>" );
MODULE_AUTHOR("Emily Strickland <linux@emily.st>" );
MODULE_AUTHOR("Daniel J. Ogorchock <djogorchock@gmail.com>" );
MODULE_DESCRIPTION("Driver for Nintendo Switch Controllers" );
Messung V0.5 in Prozent C=94 H=93 G=93
¤ Dauer der Verarbeitung: 0.75 Sekunden
(vorverarbeitet am 2026-09-28)
¤
*© Formatika GbR, Deutschland