blob: b6a9a0f3966ee0d1853aba4b42c1fca2f94d70a1 [file] [log] [blame]
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001// SPDX-License-Identifier: GPL-2.0+
2/*
3 * HID driver for Nintendo Switch Joy-Cons and Pro Controllers
4 *
Daniel J. Ogorchocke93363f2021-09-11 13:36:38 -04005 * Copyright (c) 2019-2021 Daniel J. Ogorchock <djogorchock@gmail.com>
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04006 *
7 * The following resources/projects were referenced for this driver:
8 * https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering
9 * https://gitlab.com/pjranki/joycon-linux-kernel (Peter Rankin)
10 * https://github.com/FrotBot/SwitchProConLinuxUSB
11 * https://github.com/MTCKC/ProconXInput
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -040012 * https://github.com/Davidobot/BetterJoyForCemu
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040013 * hid-wiimote kernel hid driver
14 * hid-logitech-hidpp driver
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -040015 * hid-sony driver
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040016 *
17 * This driver supports the Nintendo Switch Joy-Cons and Pro Controllers. The
18 * Pro Controllers can either be used over USB or Bluetooth.
19 *
20 * The driver will retrieve the factory calibration info from the controllers,
21 * so little to no user calibration should be required.
22 *
23 */
24
25#include "hid-ids.h"
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -040026#include <asm/unaligned.h>
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040027#include <linux/delay.h>
28#include <linux/device.h>
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -040029#include <linux/kernel.h>
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040030#include <linux/hid.h>
31#include <linux/input.h>
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -040032#include <linux/jiffies.h>
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -040033#include <linux/leds.h>
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040034#include <linux/module.h>
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -040035#include <linux/power_supply.h>
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040036#include <linux/spinlock.h>
37
38/*
39 * Reference the url below for the following HID report defines:
40 * https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering
41 */
42
43/* Output Reports */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +010044#define JC_OUTPUT_RUMBLE_AND_SUBCMD 0x01
45#define JC_OUTPUT_FW_UPDATE_PKT 0x03
46#define JC_OUTPUT_RUMBLE_ONLY 0x10
47#define JC_OUTPUT_MCU_DATA 0x11
48#define JC_OUTPUT_USB_CMD 0x80
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040049
50/* Subcommand IDs */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +010051#define JC_SUBCMD_STATE 0x00
52#define JC_SUBCMD_MANUAL_BT_PAIRING 0x01
53#define JC_SUBCMD_REQ_DEV_INFO 0x02
54#define JC_SUBCMD_SET_REPORT_MODE 0x03
55#define JC_SUBCMD_TRIGGERS_ELAPSED 0x04
56#define JC_SUBCMD_GET_PAGE_LIST_STATE 0x05
57#define JC_SUBCMD_SET_HCI_STATE 0x06
58#define JC_SUBCMD_RESET_PAIRING_INFO 0x07
59#define JC_SUBCMD_LOW_POWER_MODE 0x08
60#define JC_SUBCMD_SPI_FLASH_READ 0x10
61#define JC_SUBCMD_SPI_FLASH_WRITE 0x11
62#define JC_SUBCMD_RESET_MCU 0x20
63#define JC_SUBCMD_SET_MCU_CONFIG 0x21
64#define JC_SUBCMD_SET_MCU_STATE 0x22
65#define JC_SUBCMD_SET_PLAYER_LIGHTS 0x30
66#define JC_SUBCMD_GET_PLAYER_LIGHTS 0x31
67#define JC_SUBCMD_SET_HOME_LIGHT 0x38
68#define JC_SUBCMD_ENABLE_IMU 0x40
69#define JC_SUBCMD_SET_IMU_SENSITIVITY 0x41
70#define JC_SUBCMD_WRITE_IMU_REG 0x42
71#define JC_SUBCMD_READ_IMU_REG 0x43
72#define JC_SUBCMD_ENABLE_VIBRATION 0x48
73#define JC_SUBCMD_GET_REGULATED_VOLTAGE 0x50
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040074
75/* Input Reports */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +010076#define JC_INPUT_BUTTON_EVENT 0x3F
77#define JC_INPUT_SUBCMD_REPLY 0x21
78#define JC_INPUT_IMU_DATA 0x30
79#define JC_INPUT_MCU_DATA 0x31
80#define JC_INPUT_USB_RESPONSE 0x81
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040081
82/* Feature Reports */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +010083#define JC_FEATURE_LAST_SUBCMD 0x02
84#define JC_FEATURE_OTA_FW_UPGRADE 0x70
85#define JC_FEATURE_SETUP_MEM_READ 0x71
86#define JC_FEATURE_MEM_READ 0x72
87#define JC_FEATURE_ERASE_MEM_SECTOR 0x73
88#define JC_FEATURE_MEM_WRITE 0x74
89#define JC_FEATURE_LAUNCH 0x75
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -040090
91/* USB Commands */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +010092#define JC_USB_CMD_CONN_STATUS 0x01
93#define JC_USB_CMD_HANDSHAKE 0x02
94#define JC_USB_CMD_BAUDRATE_3M 0x03
95#define JC_USB_CMD_NO_TIMEOUT 0x04
96#define JC_USB_CMD_EN_TIMEOUT 0x05
97#define JC_USB_RESET 0x06
98#define JC_USB_PRE_HANDSHAKE 0x91
99#define JC_USB_SEND_UART 0x92
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400100
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400101/* Magic value denoting presence of user calibration */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100102#define JC_CAL_USR_MAGIC_0 0xB2
103#define JC_CAL_USR_MAGIC_1 0xA1
104#define JC_CAL_USR_MAGIC_SIZE 2
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400105
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400106/* SPI storage addresses of user calibration data */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100107#define JC_CAL_USR_LEFT_MAGIC_ADDR 0x8010
108#define JC_CAL_USR_LEFT_DATA_ADDR 0x8012
109#define JC_CAL_USR_LEFT_DATA_END 0x801A
110#define JC_CAL_USR_RIGHT_MAGIC_ADDR 0x801B
111#define JC_CAL_USR_RIGHT_DATA_ADDR 0x801D
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400112#define JC_CAL_STICK_DATA_SIZE \
113 (JC_CAL_USR_LEFT_DATA_END - JC_CAL_USR_LEFT_DATA_ADDR + 1)
114
115/* SPI storage addresses of factory calibration data */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100116#define JC_CAL_FCT_DATA_LEFT_ADDR 0x603d
117#define JC_CAL_FCT_DATA_RIGHT_ADDR 0x6046
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400118
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400119/* SPI storage addresses of IMU factory calibration data */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100120#define JC_IMU_CAL_FCT_DATA_ADDR 0x6020
121#define JC_IMU_CAL_FCT_DATA_END 0x6037
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400122#define JC_IMU_CAL_DATA_SIZE \
123 (JC_IMU_CAL_FCT_DATA_END - JC_IMU_CAL_FCT_DATA_ADDR + 1)
124/* SPI storage addresses of IMU user calibration data */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100125#define JC_IMU_CAL_USR_MAGIC_ADDR 0x8026
126#define JC_IMU_CAL_USR_DATA_ADDR 0x8028
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400127
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400128/* The raw analog joystick values will be mapped in terms of this magnitude */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100129#define JC_MAX_STICK_MAG 32767
130#define JC_STICK_FUZZ 250
131#define JC_STICK_FLAT 500
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400132
133/* Hat values for pro controller's d-pad */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100134#define JC_MAX_DPAD_MAG 1
135#define JC_DPAD_FUZZ 0
136#define JC_DPAD_FLAT 0
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400137
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400138/* Under most circumstances IMU reports are pushed every 15ms; use as default */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100139#define JC_IMU_DFLT_AVG_DELTA_MS 15
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400140/* How many samples to sum before calculating average IMU report delta */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100141#define JC_IMU_SAMPLES_PER_DELTA_AVG 300
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400142/* Controls how many dropped IMU packets at once trigger a warning message */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100143#define JC_IMU_DROPPED_PKT_WARNING 3
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400144
145/*
146 * The controller's accelerometer has a sensor resolution of 16bits and is
147 * configured with a range of +-8000 milliGs. Therefore, the resolution can be
148 * calculated thus: (2^16-1)/(8000 * 2) = 4.096 digits per milliG
149 * Resolution per G (rather than per millliG): 4.096 * 1000 = 4096 digits per G
150 * Alternatively: 1/4096 = .0002441 Gs per digit
151 */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100152#define JC_IMU_MAX_ACCEL_MAG 32767
153#define JC_IMU_ACCEL_RES_PER_G 4096
154#define JC_IMU_ACCEL_FUZZ 10
155#define JC_IMU_ACCEL_FLAT 0
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400156
157/*
158 * The controller's gyroscope has a sensor resolution of 16bits and is
159 * configured with a range of +-2000 degrees/second.
160 * Digits per dps: (2^16 -1)/(2000*2) = 16.38375
161 * dps per digit: 16.38375E-1 = .0610
162 *
163 * STMicro recommends in the datasheet to add 15% to the dps/digit. This allows
164 * the full sensitivity range to be saturated without clipping. This yields more
165 * accurate results, so it's the technique this driver uses.
166 * dps per digit (corrected): .0610 * 1.15 = .0702
167 * digits per dps (corrected): .0702E-1 = 14.247
168 *
169 * Now, 14.247 truncating to 14 loses a lot of precision, so we rescale the
170 * min/max range by 1000.
171 */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100172#define JC_IMU_PREC_RANGE_SCALE 1000
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400173/* Note: change mag and res_per_dps if prec_range_scale is ever altered */
Jiri Kosinadaf11ca2021-11-01 15:31:19 +0100174#define JC_IMU_MAX_GYRO_MAG 32767000 /* (2^16-1)*1000 */
175#define JC_IMU_GYRO_RES_PER_DPS 14247 /* (14.247*1000) */
176#define JC_IMU_GYRO_FUZZ 10
177#define JC_IMU_GYRO_FLAT 0
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400178
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400179/* frequency/amplitude tables for rumble */
180struct joycon_rumble_freq_data {
181 u16 high;
182 u8 low;
183 u16 freq; /* Hz*/
184};
185
186struct joycon_rumble_amp_data {
187 u8 high;
188 u16 low;
189 u16 amp;
190};
191
Jiri Kosinaf61e0632021-11-19 15:58:30 +0100192#if IS_ENABLED(CONFIG_NINTENDO_FF)
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400193/*
194 * These tables are from
195 * https://github.com/dekuNukem/Nintendo_Switch_Reverse_Engineering/blob/master/rumble_data_table.md
196 */
197static const struct joycon_rumble_freq_data joycon_rumble_frequencies[] = {
198 /* high, low, freq */
199 { 0x0000, 0x01, 41 }, { 0x0000, 0x02, 42 }, { 0x0000, 0x03, 43 },
200 { 0x0000, 0x04, 44 }, { 0x0000, 0x05, 45 }, { 0x0000, 0x06, 46 },
201 { 0x0000, 0x07, 47 }, { 0x0000, 0x08, 48 }, { 0x0000, 0x09, 49 },
202 { 0x0000, 0x0A, 50 }, { 0x0000, 0x0B, 51 }, { 0x0000, 0x0C, 52 },
203 { 0x0000, 0x0D, 53 }, { 0x0000, 0x0E, 54 }, { 0x0000, 0x0F, 55 },
204 { 0x0000, 0x10, 57 }, { 0x0000, 0x11, 58 }, { 0x0000, 0x12, 59 },
205 { 0x0000, 0x13, 60 }, { 0x0000, 0x14, 62 }, { 0x0000, 0x15, 63 },
206 { 0x0000, 0x16, 64 }, { 0x0000, 0x17, 66 }, { 0x0000, 0x18, 67 },
207 { 0x0000, 0x19, 69 }, { 0x0000, 0x1A, 70 }, { 0x0000, 0x1B, 72 },
208 { 0x0000, 0x1C, 73 }, { 0x0000, 0x1D, 75 }, { 0x0000, 0x1e, 77 },
209 { 0x0000, 0x1f, 78 }, { 0x0000, 0x20, 80 }, { 0x0400, 0x21, 82 },
210 { 0x0800, 0x22, 84 }, { 0x0c00, 0x23, 85 }, { 0x1000, 0x24, 87 },
211 { 0x1400, 0x25, 89 }, { 0x1800, 0x26, 91 }, { 0x1c00, 0x27, 93 },
212 { 0x2000, 0x28, 95 }, { 0x2400, 0x29, 97 }, { 0x2800, 0x2a, 99 },
213 { 0x2c00, 0x2b, 102 }, { 0x3000, 0x2c, 104 }, { 0x3400, 0x2d, 106 },
214 { 0x3800, 0x2e, 108 }, { 0x3c00, 0x2f, 111 }, { 0x4000, 0x30, 113 },
215 { 0x4400, 0x31, 116 }, { 0x4800, 0x32, 118 }, { 0x4c00, 0x33, 121 },
216 { 0x5000, 0x34, 123 }, { 0x5400, 0x35, 126 }, { 0x5800, 0x36, 129 },
217 { 0x5c00, 0x37, 132 }, { 0x6000, 0x38, 135 }, { 0x6400, 0x39, 137 },
218 { 0x6800, 0x3a, 141 }, { 0x6c00, 0x3b, 144 }, { 0x7000, 0x3c, 147 },
219 { 0x7400, 0x3d, 150 }, { 0x7800, 0x3e, 153 }, { 0x7c00, 0x3f, 157 },
220 { 0x8000, 0x40, 160 }, { 0x8400, 0x41, 164 }, { 0x8800, 0x42, 167 },
221 { 0x8c00, 0x43, 171 }, { 0x9000, 0x44, 174 }, { 0x9400, 0x45, 178 },
222 { 0x9800, 0x46, 182 }, { 0x9c00, 0x47, 186 }, { 0xa000, 0x48, 190 },
223 { 0xa400, 0x49, 194 }, { 0xa800, 0x4a, 199 }, { 0xac00, 0x4b, 203 },
224 { 0xb000, 0x4c, 207 }, { 0xb400, 0x4d, 212 }, { 0xb800, 0x4e, 217 },
225 { 0xbc00, 0x4f, 221 }, { 0xc000, 0x50, 226 }, { 0xc400, 0x51, 231 },
226 { 0xc800, 0x52, 236 }, { 0xcc00, 0x53, 241 }, { 0xd000, 0x54, 247 },
227 { 0xd400, 0x55, 252 }, { 0xd800, 0x56, 258 }, { 0xdc00, 0x57, 263 },
228 { 0xe000, 0x58, 269 }, { 0xe400, 0x59, 275 }, { 0xe800, 0x5a, 281 },
229 { 0xec00, 0x5b, 287 }, { 0xf000, 0x5c, 293 }, { 0xf400, 0x5d, 300 },
230 { 0xf800, 0x5e, 306 }, { 0xfc00, 0x5f, 313 }, { 0x0001, 0x60, 320 },
231 { 0x0401, 0x61, 327 }, { 0x0801, 0x62, 334 }, { 0x0c01, 0x63, 341 },
232 { 0x1001, 0x64, 349 }, { 0x1401, 0x65, 357 }, { 0x1801, 0x66, 364 },
233 { 0x1c01, 0x67, 372 }, { 0x2001, 0x68, 381 }, { 0x2401, 0x69, 389 },
234 { 0x2801, 0x6a, 397 }, { 0x2c01, 0x6b, 406 }, { 0x3001, 0x6c, 415 },
235 { 0x3401, 0x6d, 424 }, { 0x3801, 0x6e, 433 }, { 0x3c01, 0x6f, 443 },
236 { 0x4001, 0x70, 453 }, { 0x4401, 0x71, 462 }, { 0x4801, 0x72, 473 },
237 { 0x4c01, 0x73, 483 }, { 0x5001, 0x74, 494 }, { 0x5401, 0x75, 504 },
238 { 0x5801, 0x76, 515 }, { 0x5c01, 0x77, 527 }, { 0x6001, 0x78, 538 },
239 { 0x6401, 0x79, 550 }, { 0x6801, 0x7a, 562 }, { 0x6c01, 0x7b, 574 },
240 { 0x7001, 0x7c, 587 }, { 0x7401, 0x7d, 600 }, { 0x7801, 0x7e, 613 },
241 { 0x7c01, 0x7f, 626 }, { 0x8001, 0x00, 640 }, { 0x8401, 0x00, 654 },
242 { 0x8801, 0x00, 668 }, { 0x8c01, 0x00, 683 }, { 0x9001, 0x00, 698 },
243 { 0x9401, 0x00, 713 }, { 0x9801, 0x00, 729 }, { 0x9c01, 0x00, 745 },
244 { 0xa001, 0x00, 761 }, { 0xa401, 0x00, 778 }, { 0xa801, 0x00, 795 },
245 { 0xac01, 0x00, 812 }, { 0xb001, 0x00, 830 }, { 0xb401, 0x00, 848 },
246 { 0xb801, 0x00, 867 }, { 0xbc01, 0x00, 886 }, { 0xc001, 0x00, 905 },
247 { 0xc401, 0x00, 925 }, { 0xc801, 0x00, 945 }, { 0xcc01, 0x00, 966 },
248 { 0xd001, 0x00, 987 }, { 0xd401, 0x00, 1009 }, { 0xd801, 0x00, 1031 },
249 { 0xdc01, 0x00, 1053 }, { 0xe001, 0x00, 1076 }, { 0xe401, 0x00, 1100 },
250 { 0xe801, 0x00, 1124 }, { 0xec01, 0x00, 1149 }, { 0xf001, 0x00, 1174 },
251 { 0xf401, 0x00, 1199 }, { 0xf801, 0x00, 1226 }, { 0xfc01, 0x00, 1253 }
252};
253
254#define joycon_max_rumble_amp (1003)
255static const struct joycon_rumble_amp_data joycon_rumble_amplitudes[] = {
256 /* high, low, amp */
257 { 0x00, 0x0040, 0 },
258 { 0x02, 0x8040, 10 }, { 0x04, 0x0041, 12 }, { 0x06, 0x8041, 14 },
259 { 0x08, 0x0042, 17 }, { 0x0a, 0x8042, 20 }, { 0x0c, 0x0043, 24 },
260 { 0x0e, 0x8043, 28 }, { 0x10, 0x0044, 33 }, { 0x12, 0x8044, 40 },
261 { 0x14, 0x0045, 47 }, { 0x16, 0x8045, 56 }, { 0x18, 0x0046, 67 },
262 { 0x1a, 0x8046, 80 }, { 0x1c, 0x0047, 95 }, { 0x1e, 0x8047, 112 },
263 { 0x20, 0x0048, 117 }, { 0x22, 0x8048, 123 }, { 0x24, 0x0049, 128 },
264 { 0x26, 0x8049, 134 }, { 0x28, 0x004a, 140 }, { 0x2a, 0x804a, 146 },
265 { 0x2c, 0x004b, 152 }, { 0x2e, 0x804b, 159 }, { 0x30, 0x004c, 166 },
266 { 0x32, 0x804c, 173 }, { 0x34, 0x004d, 181 }, { 0x36, 0x804d, 189 },
267 { 0x38, 0x004e, 198 }, { 0x3a, 0x804e, 206 }, { 0x3c, 0x004f, 215 },
268 { 0x3e, 0x804f, 225 }, { 0x40, 0x0050, 230 }, { 0x42, 0x8050, 235 },
269 { 0x44, 0x0051, 240 }, { 0x46, 0x8051, 245 }, { 0x48, 0x0052, 251 },
270 { 0x4a, 0x8052, 256 }, { 0x4c, 0x0053, 262 }, { 0x4e, 0x8053, 268 },
271 { 0x50, 0x0054, 273 }, { 0x52, 0x8054, 279 }, { 0x54, 0x0055, 286 },
272 { 0x56, 0x8055, 292 }, { 0x58, 0x0056, 298 }, { 0x5a, 0x8056, 305 },
273 { 0x5c, 0x0057, 311 }, { 0x5e, 0x8057, 318 }, { 0x60, 0x0058, 325 },
274 { 0x62, 0x8058, 332 }, { 0x64, 0x0059, 340 }, { 0x66, 0x8059, 347 },
275 { 0x68, 0x005a, 355 }, { 0x6a, 0x805a, 362 }, { 0x6c, 0x005b, 370 },
276 { 0x6e, 0x805b, 378 }, { 0x70, 0x005c, 387 }, { 0x72, 0x805c, 395 },
277 { 0x74, 0x005d, 404 }, { 0x76, 0x805d, 413 }, { 0x78, 0x005e, 422 },
278 { 0x7a, 0x805e, 431 }, { 0x7c, 0x005f, 440 }, { 0x7e, 0x805f, 450 },
279 { 0x80, 0x0060, 460 }, { 0x82, 0x8060, 470 }, { 0x84, 0x0061, 480 },
280 { 0x86, 0x8061, 491 }, { 0x88, 0x0062, 501 }, { 0x8a, 0x8062, 512 },
281 { 0x8c, 0x0063, 524 }, { 0x8e, 0x8063, 535 }, { 0x90, 0x0064, 547 },
282 { 0x92, 0x8064, 559 }, { 0x94, 0x0065, 571 }, { 0x96, 0x8065, 584 },
283 { 0x98, 0x0066, 596 }, { 0x9a, 0x8066, 609 }, { 0x9c, 0x0067, 623 },
284 { 0x9e, 0x8067, 636 }, { 0xa0, 0x0068, 650 }, { 0xa2, 0x8068, 665 },
285 { 0xa4, 0x0069, 679 }, { 0xa6, 0x8069, 694 }, { 0xa8, 0x006a, 709 },
286 { 0xaa, 0x806a, 725 }, { 0xac, 0x006b, 741 }, { 0xae, 0x806b, 757 },
287 { 0xb0, 0x006c, 773 }, { 0xb2, 0x806c, 790 }, { 0xb4, 0x006d, 808 },
288 { 0xb6, 0x806d, 825 }, { 0xb8, 0x006e, 843 }, { 0xba, 0x806e, 862 },
289 { 0xbc, 0x006f, 881 }, { 0xbe, 0x806f, 900 }, { 0xc0, 0x0070, 920 },
290 { 0xc2, 0x8070, 940 }, { 0xc4, 0x0071, 960 }, { 0xc6, 0x8071, 981 },
291 { 0xc8, 0x0072, joycon_max_rumble_amp }
292};
Jiri Kosinaf61e0632021-11-19 15:58:30 +0100293static const u16 JC_RUMBLE_DFLT_LOW_FREQ = 160;
294static const u16 JC_RUMBLE_DFLT_HIGH_FREQ = 320;
295#endif /* IS_ENABLED(CONFIG_NINTENDO_FF) */
296static const u16 JC_RUMBLE_PERIOD_MS = 50;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400297
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400298/* States for controller state machine */
299enum joycon_ctlr_state {
300 JOYCON_CTLR_STATE_INIT,
301 JOYCON_CTLR_STATE_READ,
Daniel J. Ogorchock012bd522021-09-11 13:36:31 -0400302 JOYCON_CTLR_STATE_REMOVED,
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400303};
304
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -0400305/* Controller type received as part of device info */
306enum joycon_ctlr_type {
307 JOYCON_CTLR_TYPE_JCL = 0x01,
308 JOYCON_CTLR_TYPE_JCR = 0x02,
309 JOYCON_CTLR_TYPE_PRO = 0x03,
310};
311
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400312struct joycon_stick_cal {
313 s32 max;
314 s32 min;
315 s32 center;
316};
317
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400318struct joycon_imu_cal {
319 s16 offset[3];
320 s16 scale[3];
321};
322
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400323/*
324 * All the controller's button values are stored in a u32.
325 * They can be accessed with bitwise ANDs.
326 */
327static const u32 JC_BTN_Y = BIT(0);
328static const u32 JC_BTN_X = BIT(1);
329static const u32 JC_BTN_B = BIT(2);
330static const u32 JC_BTN_A = BIT(3);
331static const u32 JC_BTN_SR_R = BIT(4);
332static const u32 JC_BTN_SL_R = BIT(5);
333static const u32 JC_BTN_R = BIT(6);
334static const u32 JC_BTN_ZR = BIT(7);
335static const u32 JC_BTN_MINUS = BIT(8);
336static const u32 JC_BTN_PLUS = BIT(9);
337static const u32 JC_BTN_RSTICK = BIT(10);
338static const u32 JC_BTN_LSTICK = BIT(11);
339static const u32 JC_BTN_HOME = BIT(12);
340static const u32 JC_BTN_CAP = BIT(13); /* capture button */
341static const u32 JC_BTN_DOWN = BIT(16);
342static const u32 JC_BTN_UP = BIT(17);
343static const u32 JC_BTN_RIGHT = BIT(18);
344static const u32 JC_BTN_LEFT = BIT(19);
345static const u32 JC_BTN_SR_L = BIT(20);
346static const u32 JC_BTN_SL_L = BIT(21);
347static const u32 JC_BTN_L = BIT(22);
348static const u32 JC_BTN_ZL = BIT(23);
349
350enum joycon_msg_type {
351 JOYCON_MSG_TYPE_NONE,
352 JOYCON_MSG_TYPE_USB,
353 JOYCON_MSG_TYPE_SUBCMD,
354};
355
Daniel J. Ogorchock4c048f62021-09-11 13:36:37 -0400356struct joycon_rumble_output {
357 u8 output_id;
358 u8 packet_num;
359 u8 rumble_data[8];
360} __packed;
361
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400362struct joycon_subcmd_request {
363 u8 output_id; /* must be 0x01 for subcommand, 0x10 for rumble only */
364 u8 packet_num; /* incremented every send */
365 u8 rumble_data[8];
366 u8 subcmd_id;
367 u8 data[]; /* length depends on the subcommand */
368} __packed;
369
370struct joycon_subcmd_reply {
371 u8 ack; /* MSB 1 for ACK, 0 for NACK */
372 u8 id; /* id of requested subcmd */
373 u8 data[]; /* will be at most 35 bytes */
374} __packed;
375
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400376struct joycon_imu_data {
377 s16 accel_x;
378 s16 accel_y;
379 s16 accel_z;
380 s16 gyro_x;
381 s16 gyro_y;
382 s16 gyro_z;
383} __packed;
384
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400385struct joycon_input_report {
386 u8 id;
387 u8 timer;
388 u8 bat_con; /* battery and connection info */
389 u8 button_status[3];
390 u8 left_stick[3];
391 u8 right_stick[3];
392 u8 vibrator_report;
393
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400394 union {
395 struct joycon_subcmd_reply subcmd_reply;
396 /* IMU input reports contain 3 samples */
397 u8 imu_raw_bytes[sizeof(struct joycon_imu_data) * 3];
398 };
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400399} __packed;
400
401#define JC_MAX_RESP_SIZE (sizeof(struct joycon_input_report) + 35)
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400402#define JC_RUMBLE_DATA_SIZE 8
403#define JC_RUMBLE_QUEUE_SIZE 8
404
Daniel J. Ogorchockdad74e12021-09-11 13:36:39 -0400405static const unsigned short JC_RUMBLE_ZERO_AMP_PKT_CNT = 5;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400406
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -0400407static const char * const joycon_player_led_names[] = {
408 LED_FUNCTION_PLAYER1,
409 LED_FUNCTION_PLAYER2,
410 LED_FUNCTION_PLAYER3,
411 LED_FUNCTION_PLAYER4,
412};
413#define JC_NUM_LEDS ARRAY_SIZE(joycon_player_led_names)
414
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400415/* Each physical controller is associated with a joycon_ctlr struct */
416struct joycon_ctlr {
417 struct hid_device *hdev;
418 struct input_dev *input;
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -0400419 struct led_classdev leds[JC_NUM_LEDS]; /* player leds */
420 struct led_classdev home_led;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400421 enum joycon_ctlr_state ctlr_state;
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -0400422 spinlock_t lock;
Daniel J. Ogorchock14252472021-09-11 13:36:33 -0400423 u8 mac_addr[6];
424 char *mac_addr_str;
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -0400425 enum joycon_ctlr_type ctlr_type;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400426
427 /* The following members are used for synchronous sends/receives */
428 enum joycon_msg_type msg_type;
429 u8 subcmd_num;
430 struct mutex output_mutex;
431 u8 input_buf[JC_MAX_RESP_SIZE];
432 wait_queue_head_t wait;
433 bool received_resp;
434 u8 usb_ack_match;
435 u8 subcmd_ack_match;
Daniel J. Ogorchock479da172021-09-11 13:36:30 -0400436 bool received_input_report;
Daniel J. Ogorchocke93363f2021-09-11 13:36:38 -0400437 unsigned int last_subcmd_sent_msecs;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400438
439 /* factory calibration data */
440 struct joycon_stick_cal left_stick_cal_x;
441 struct joycon_stick_cal left_stick_cal_y;
442 struct joycon_stick_cal right_stick_cal_x;
443 struct joycon_stick_cal right_stick_cal_y;
444
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400445 struct joycon_imu_cal accel_cal;
446 struct joycon_imu_cal gyro_cal;
447
448 /* prevents needlessly recalculating these divisors every sample */
449 s32 imu_cal_accel_divisor[3];
450 s32 imu_cal_gyro_divisor[3];
451
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -0400452 /* power supply data */
453 struct power_supply *battery;
454 struct power_supply_desc battery_desc;
455 u8 battery_capacity;
456 bool battery_charging;
457 bool host_powered;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400458
459 /* rumble */
460 u8 rumble_data[JC_RUMBLE_QUEUE_SIZE][JC_RUMBLE_DATA_SIZE];
461 int rumble_queue_head;
462 int rumble_queue_tail;
463 struct workqueue_struct *rumble_queue;
464 struct work_struct rumble_worker;
465 unsigned int rumble_msecs;
466 u16 rumble_ll_freq;
467 u16 rumble_lh_freq;
468 u16 rumble_rl_freq;
469 u16 rumble_rh_freq;
Daniel J. Ogorchockdad74e12021-09-11 13:36:39 -0400470 unsigned short rumble_zero_countdown;
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400471
472 /* imu */
473 struct input_dev *imu_input;
474 bool imu_first_packet_received; /* helps in initiating timestamp */
475 unsigned int imu_timestamp_us; /* timestamp we report to userspace */
476 unsigned int imu_last_pkt_ms; /* used to calc imu report delta */
477 /* the following are used to track the average imu report time delta */
478 unsigned int imu_delta_samples_count;
479 unsigned int imu_delta_samples_sum;
480 unsigned int imu_avg_delta_ms;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400481};
482
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -0400483/* Helper macros for checking controller type */
484#define jc_type_is_joycon(ctlr) \
485 (ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_JOYCONL || \
486 ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_JOYCONR || \
487 ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_CHRGGRIP)
488#define jc_type_is_procon(ctlr) \
489 (ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_PROCON)
490#define jc_type_is_chrggrip(ctlr) \
491 (ctlr->hdev->product == USB_DEVICE_ID_NINTENDO_CHRGGRIP)
492
493/* Does this controller have inputs associated with left joycon? */
494#define jc_type_has_left(ctlr) \
495 (ctlr->ctlr_type == JOYCON_CTLR_TYPE_JCL || \
496 ctlr->ctlr_type == JOYCON_CTLR_TYPE_PRO)
497
498/* Does this controller have inputs associated with right joycon? */
499#define jc_type_has_right(ctlr) \
500 (ctlr->ctlr_type == JOYCON_CTLR_TYPE_JCR || \
501 ctlr->ctlr_type == JOYCON_CTLR_TYPE_PRO)
502
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400503static int __joycon_hid_send(struct hid_device *hdev, u8 *data, size_t len)
504{
505 u8 *buf;
506 int ret;
507
508 buf = kmemdup(data, len, GFP_KERNEL);
509 if (!buf)
510 return -ENOMEM;
511 ret = hid_hw_output_report(hdev, buf, len);
512 kfree(buf);
513 if (ret < 0)
514 hid_dbg(hdev, "Failed to send output report ret=%d\n", ret);
515 return ret;
516}
517
Daniel J. Ogorchocke93363f2021-09-11 13:36:38 -0400518static void joycon_wait_for_input_report(struct joycon_ctlr *ctlr)
519{
520 int ret;
521
522 /*
523 * If we are in the proper reporting mode, wait for an input
524 * report prior to sending the subcommand. This improves
525 * reliability considerably.
526 */
527 if (ctlr->ctlr_state == JOYCON_CTLR_STATE_READ) {
528 unsigned long flags;
529
530 spin_lock_irqsave(&ctlr->lock, flags);
531 ctlr->received_input_report = false;
532 spin_unlock_irqrestore(&ctlr->lock, flags);
533 ret = wait_event_timeout(ctlr->wait,
534 ctlr->received_input_report,
535 HZ / 4);
536 /* We will still proceed, even with a timeout here */
537 if (!ret)
538 hid_warn(ctlr->hdev,
539 "timeout waiting for input report\n");
540 }
541}
542
543/*
544 * Sending subcommands and/or rumble data at too high a rate can cause bluetooth
545 * controller disconnections.
546 */
547static void joycon_enforce_subcmd_rate(struct joycon_ctlr *ctlr)
548{
549 static const unsigned int max_subcmd_rate_ms = 25;
550 unsigned int current_ms = jiffies_to_msecs(jiffies);
551 unsigned int delta_ms = current_ms - ctlr->last_subcmd_sent_msecs;
552
553 while (delta_ms < max_subcmd_rate_ms &&
554 ctlr->ctlr_state == JOYCON_CTLR_STATE_READ) {
555 joycon_wait_for_input_report(ctlr);
556 current_ms = jiffies_to_msecs(jiffies);
557 delta_ms = current_ms - ctlr->last_subcmd_sent_msecs;
558 }
559 ctlr->last_subcmd_sent_msecs = current_ms;
560}
561
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400562static int joycon_hid_send_sync(struct joycon_ctlr *ctlr, u8 *data, size_t len,
563 u32 timeout)
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400564{
565 int ret;
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400566 int tries = 2;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400567
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400568 /*
569 * The controller occasionally seems to drop subcommands. In testing,
570 * doing one retry after a timeout appears to always work.
571 */
572 while (tries--) {
Daniel J. Ogorchocke93363f2021-09-11 13:36:38 -0400573 joycon_enforce_subcmd_rate(ctlr);
Daniel J. Ogorchock479da172021-09-11 13:36:30 -0400574
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400575 ret = __joycon_hid_send(ctlr->hdev, data, len);
576 if (ret < 0) {
577 memset(ctlr->input_buf, 0, JC_MAX_RESP_SIZE);
578 return ret;
579 }
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400580
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400581 ret = wait_event_timeout(ctlr->wait, ctlr->received_resp,
582 timeout);
583 if (!ret) {
584 hid_dbg(ctlr->hdev,
585 "synchronous send/receive timed out\n");
586 if (tries) {
587 hid_dbg(ctlr->hdev,
588 "retrying sync send after timeout\n");
589 }
590 memset(ctlr->input_buf, 0, JC_MAX_RESP_SIZE);
591 ret = -ETIMEDOUT;
592 } else {
593 ret = 0;
594 break;
595 }
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400596 }
597
598 ctlr->received_resp = false;
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400599 return ret;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400600}
601
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400602static int joycon_send_usb(struct joycon_ctlr *ctlr, u8 cmd, u32 timeout)
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400603{
604 int ret;
605 u8 buf[2] = {JC_OUTPUT_USB_CMD};
606
607 buf[1] = cmd;
608 ctlr->usb_ack_match = cmd;
609 ctlr->msg_type = JOYCON_MSG_TYPE_USB;
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400610 ret = joycon_hid_send_sync(ctlr, buf, sizeof(buf), timeout);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400611 if (ret)
612 hid_dbg(ctlr->hdev, "send usb command failed; ret=%d\n", ret);
613 return ret;
614}
615
616static int joycon_send_subcmd(struct joycon_ctlr *ctlr,
617 struct joycon_subcmd_request *subcmd,
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400618 size_t data_len, u32 timeout)
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400619{
620 int ret;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400621 unsigned long flags;
622
623 spin_lock_irqsave(&ctlr->lock, flags);
Daniel J. Ogorchock012bd522021-09-11 13:36:31 -0400624 /*
625 * If the controller has been removed, just return ENODEV so the LED
626 * subsystem doesn't print invalid errors on removal.
627 */
628 if (ctlr->ctlr_state == JOYCON_CTLR_STATE_REMOVED) {
629 spin_unlock_irqrestore(&ctlr->lock, flags);
630 return -ENODEV;
631 }
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400632 memcpy(subcmd->rumble_data, ctlr->rumble_data[ctlr->rumble_queue_tail],
633 JC_RUMBLE_DATA_SIZE);
634 spin_unlock_irqrestore(&ctlr->lock, flags);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400635
636 subcmd->output_id = JC_OUTPUT_RUMBLE_AND_SUBCMD;
637 subcmd->packet_num = ctlr->subcmd_num;
638 if (++ctlr->subcmd_num > 0xF)
639 ctlr->subcmd_num = 0;
640 ctlr->subcmd_ack_match = subcmd->subcmd_id;
641 ctlr->msg_type = JOYCON_MSG_TYPE_SUBCMD;
642
643 ret = joycon_hid_send_sync(ctlr, (u8 *)subcmd,
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400644 sizeof(*subcmd) + data_len, timeout);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400645 if (ret < 0)
646 hid_dbg(ctlr->hdev, "send subcommand failed; ret=%d\n", ret);
647 else
648 ret = 0;
649 return ret;
650}
651
652/* Supply nibbles for flash and on. Ones correspond to active */
653static int joycon_set_player_leds(struct joycon_ctlr *ctlr, u8 flash, u8 on)
654{
655 struct joycon_subcmd_request *req;
656 u8 buffer[sizeof(*req) + 1] = { 0 };
657
658 req = (struct joycon_subcmd_request *)buffer;
659 req->subcmd_id = JC_SUBCMD_SET_PLAYER_LIGHTS;
660 req->data[0] = (flash << 4) | on;
661
662 hid_dbg(ctlr->hdev, "setting player leds\n");
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400663 return joycon_send_subcmd(ctlr, req, 1, HZ/4);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400664}
665
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400666static int joycon_request_spi_flash_read(struct joycon_ctlr *ctlr,
667 u32 start_addr, u8 size, u8 **reply)
668{
669 struct joycon_subcmd_request *req;
670 struct joycon_input_report *report;
671 u8 buffer[sizeof(*req) + 5] = { 0 };
672 u8 *data;
673 int ret;
674
675 if (!reply)
676 return -EINVAL;
677
678 req = (struct joycon_subcmd_request *)buffer;
679 req->subcmd_id = JC_SUBCMD_SPI_FLASH_READ;
680 data = req->data;
681 put_unaligned_le32(start_addr, data);
682 data[4] = size;
683
684 hid_dbg(ctlr->hdev, "requesting SPI flash data\n");
685 ret = joycon_send_subcmd(ctlr, req, 5, HZ);
686 if (ret) {
687 hid_err(ctlr->hdev, "failed reading SPI flash; ret=%d\n", ret);
688 } else {
689 report = (struct joycon_input_report *)ctlr->input_buf;
690 /* The read data starts at the 6th byte */
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400691 *reply = &report->subcmd_reply.data[5];
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400692 }
693 return ret;
694}
695
696/*
697 * User calibration's presence is denoted with a magic byte preceding it.
698 * returns 0 if magic val is present, 1 if not present, < 0 on error
699 */
700static int joycon_check_for_cal_magic(struct joycon_ctlr *ctlr, u32 flash_addr)
701{
702 int ret;
703 u8 *reply;
704
705 ret = joycon_request_spi_flash_read(ctlr, flash_addr,
706 JC_CAL_USR_MAGIC_SIZE, &reply);
707 if (ret)
708 return ret;
709
710 return reply[0] != JC_CAL_USR_MAGIC_0 || reply[1] != JC_CAL_USR_MAGIC_1;
711}
712
713static int joycon_read_stick_calibration(struct joycon_ctlr *ctlr, u16 cal_addr,
714 struct joycon_stick_cal *cal_x,
715 struct joycon_stick_cal *cal_y,
716 bool left_stick)
717{
718 s32 x_max_above;
719 s32 x_min_below;
720 s32 y_max_above;
721 s32 y_min_below;
722 u8 *raw_cal;
723 int ret;
724
725 ret = joycon_request_spi_flash_read(ctlr, cal_addr,
726 JC_CAL_STICK_DATA_SIZE, &raw_cal);
727 if (ret)
728 return ret;
729
730 /* stick calibration parsing: note the order differs based on stick */
731 if (left_stick) {
732 x_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 0), 0,
733 12);
734 y_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 1), 4,
735 12);
736 cal_x->center = hid_field_extract(ctlr->hdev, (raw_cal + 3), 0,
737 12);
738 cal_y->center = hid_field_extract(ctlr->hdev, (raw_cal + 4), 4,
739 12);
740 x_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 6), 0,
741 12);
742 y_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 7), 4,
743 12);
744 } else {
745 cal_x->center = hid_field_extract(ctlr->hdev, (raw_cal + 0), 0,
746 12);
747 cal_y->center = hid_field_extract(ctlr->hdev, (raw_cal + 1), 4,
748 12);
749 x_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 3), 0,
750 12);
751 y_min_below = hid_field_extract(ctlr->hdev, (raw_cal + 4), 4,
752 12);
753 x_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 6), 0,
754 12);
755 y_max_above = hid_field_extract(ctlr->hdev, (raw_cal + 7), 4,
756 12);
757 }
758
759 cal_x->max = cal_x->center + x_max_above;
760 cal_x->min = cal_x->center - x_min_below;
761 cal_y->max = cal_y->center + y_max_above;
762 cal_y->min = cal_y->center - y_min_below;
763
764 return 0;
765}
766
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400767static const u16 DFLT_STICK_CAL_CEN = 2000;
768static const u16 DFLT_STICK_CAL_MAX = 3500;
769static const u16 DFLT_STICK_CAL_MIN = 500;
770static int joycon_request_calibration(struct joycon_ctlr *ctlr)
771{
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400772 u16 left_stick_addr = JC_CAL_FCT_DATA_LEFT_ADDR;
773 u16 right_stick_addr = JC_CAL_FCT_DATA_RIGHT_ADDR;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400774 int ret;
775
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400776 hid_dbg(ctlr->hdev, "requesting cal data\n");
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400777
778 /* check if user stick calibrations are present */
779 if (!joycon_check_for_cal_magic(ctlr, JC_CAL_USR_LEFT_MAGIC_ADDR)) {
780 left_stick_addr = JC_CAL_USR_LEFT_DATA_ADDR;
781 hid_info(ctlr->hdev, "using user cal for left stick\n");
782 } else {
783 hid_info(ctlr->hdev, "using factory cal for left stick\n");
784 }
785 if (!joycon_check_for_cal_magic(ctlr, JC_CAL_USR_RIGHT_MAGIC_ADDR)) {
786 right_stick_addr = JC_CAL_USR_RIGHT_DATA_ADDR;
787 hid_info(ctlr->hdev, "using user cal for right stick\n");
788 } else {
789 hid_info(ctlr->hdev, "using factory cal for right stick\n");
790 }
791
792 /* read the left stick calibration data */
793 ret = joycon_read_stick_calibration(ctlr, left_stick_addr,
794 &ctlr->left_stick_cal_x,
795 &ctlr->left_stick_cal_y,
796 true);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400797 if (ret) {
798 hid_warn(ctlr->hdev,
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400799 "Failed to read left stick cal, using dflts; e=%d\n",
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400800 ret);
801
802 ctlr->left_stick_cal_x.center = DFLT_STICK_CAL_CEN;
803 ctlr->left_stick_cal_x.max = DFLT_STICK_CAL_MAX;
804 ctlr->left_stick_cal_x.min = DFLT_STICK_CAL_MIN;
805
806 ctlr->left_stick_cal_y.center = DFLT_STICK_CAL_CEN;
807 ctlr->left_stick_cal_y.max = DFLT_STICK_CAL_MAX;
808 ctlr->left_stick_cal_y.min = DFLT_STICK_CAL_MIN;
Daniel J. Ogorchock83d640c2021-09-11 13:36:35 -0400809 }
810
811 /* read the right stick calibration data */
812 ret = joycon_read_stick_calibration(ctlr, right_stick_addr,
813 &ctlr->right_stick_cal_x,
814 &ctlr->right_stick_cal_y,
815 false);
816 if (ret) {
817 hid_warn(ctlr->hdev,
818 "Failed to read right stick cal, using dflts; e=%d\n",
819 ret);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400820
821 ctlr->right_stick_cal_x.center = DFLT_STICK_CAL_CEN;
822 ctlr->right_stick_cal_x.max = DFLT_STICK_CAL_MAX;
823 ctlr->right_stick_cal_x.min = DFLT_STICK_CAL_MIN;
824
825 ctlr->right_stick_cal_y.center = DFLT_STICK_CAL_CEN;
826 ctlr->right_stick_cal_y.max = DFLT_STICK_CAL_MAX;
827 ctlr->right_stick_cal_y.min = DFLT_STICK_CAL_MIN;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400828 }
829
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400830 hid_dbg(ctlr->hdev, "calibration:\n"
831 "l_x_c=%d l_x_max=%d l_x_min=%d\n"
832 "l_y_c=%d l_y_max=%d l_y_min=%d\n"
833 "r_x_c=%d r_x_max=%d r_x_min=%d\n"
834 "r_y_c=%d r_y_max=%d r_y_min=%d\n",
835 ctlr->left_stick_cal_x.center,
836 ctlr->left_stick_cal_x.max,
837 ctlr->left_stick_cal_x.min,
838 ctlr->left_stick_cal_y.center,
839 ctlr->left_stick_cal_y.max,
840 ctlr->left_stick_cal_y.min,
841 ctlr->right_stick_cal_x.center,
842 ctlr->right_stick_cal_x.max,
843 ctlr->right_stick_cal_x.min,
844 ctlr->right_stick_cal_y.center,
845 ctlr->right_stick_cal_y.max,
846 ctlr->right_stick_cal_y.min);
847
848 return 0;
849}
850
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400851/*
852 * These divisors are calculated once rather than for each sample. They are only
853 * dependent on the IMU calibration values. They are used when processing the
854 * IMU input reports.
855 */
856static void joycon_calc_imu_cal_divisors(struct joycon_ctlr *ctlr)
857{
858 int i;
859
860 for (i = 0; i < 3; i++) {
861 ctlr->imu_cal_accel_divisor[i] = ctlr->accel_cal.scale[i] -
862 ctlr->accel_cal.offset[i];
863 ctlr->imu_cal_gyro_divisor[i] = ctlr->gyro_cal.scale[i] -
864 ctlr->gyro_cal.offset[i];
865 }
866}
867
868static const s16 DFLT_ACCEL_OFFSET /*= 0*/;
869static const s16 DFLT_ACCEL_SCALE = 16384;
870static const s16 DFLT_GYRO_OFFSET /*= 0*/;
871static const s16 DFLT_GYRO_SCALE = 13371;
872static int joycon_request_imu_calibration(struct joycon_ctlr *ctlr)
873{
874 u16 imu_cal_addr = JC_IMU_CAL_FCT_DATA_ADDR;
875 u8 *raw_cal;
876 int ret;
877 int i;
878
879 /* check if user calibration exists */
880 if (!joycon_check_for_cal_magic(ctlr, JC_IMU_CAL_USR_MAGIC_ADDR)) {
881 imu_cal_addr = JC_IMU_CAL_USR_DATA_ADDR;
882 hid_info(ctlr->hdev, "using user cal for IMU\n");
883 } else {
884 hid_info(ctlr->hdev, "using factory cal for IMU\n");
885 }
886
887 /* request IMU calibration data */
888 hid_dbg(ctlr->hdev, "requesting IMU cal data\n");
889 ret = joycon_request_spi_flash_read(ctlr, imu_cal_addr,
890 JC_IMU_CAL_DATA_SIZE, &raw_cal);
891 if (ret) {
892 hid_warn(ctlr->hdev,
893 "Failed to read IMU cal, using defaults; ret=%d\n",
894 ret);
895
896 for (i = 0; i < 3; i++) {
897 ctlr->accel_cal.offset[i] = DFLT_ACCEL_OFFSET;
898 ctlr->accel_cal.scale[i] = DFLT_ACCEL_SCALE;
899 ctlr->gyro_cal.offset[i] = DFLT_GYRO_OFFSET;
900 ctlr->gyro_cal.scale[i] = DFLT_GYRO_SCALE;
901 }
902 joycon_calc_imu_cal_divisors(ctlr);
903 return ret;
904 }
905
906 /* IMU calibration parsing */
907 for (i = 0; i < 3; i++) {
908 int j = i * 2;
909
910 ctlr->accel_cal.offset[i] = get_unaligned_le16(raw_cal + j);
911 ctlr->accel_cal.scale[i] = get_unaligned_le16(raw_cal + j + 6);
912 ctlr->gyro_cal.offset[i] = get_unaligned_le16(raw_cal + j + 12);
913 ctlr->gyro_cal.scale[i] = get_unaligned_le16(raw_cal + j + 18);
914 }
915
916 joycon_calc_imu_cal_divisors(ctlr);
917
918 hid_dbg(ctlr->hdev, "IMU calibration:\n"
919 "a_o[0]=%d a_o[1]=%d a_o[2]=%d\n"
920 "a_s[0]=%d a_s[1]=%d a_s[2]=%d\n"
921 "g_o[0]=%d g_o[1]=%d g_o[2]=%d\n"
922 "g_s[0]=%d g_s[1]=%d g_s[2]=%d\n",
923 ctlr->accel_cal.offset[0],
924 ctlr->accel_cal.offset[1],
925 ctlr->accel_cal.offset[2],
926 ctlr->accel_cal.scale[0],
927 ctlr->accel_cal.scale[1],
928 ctlr->accel_cal.scale[2],
929 ctlr->gyro_cal.offset[0],
930 ctlr->gyro_cal.offset[1],
931 ctlr->gyro_cal.offset[2],
932 ctlr->gyro_cal.scale[0],
933 ctlr->gyro_cal.scale[1],
934 ctlr->gyro_cal.scale[2]);
935
936 return 0;
937}
938
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400939static int joycon_set_report_mode(struct joycon_ctlr *ctlr)
940{
941 struct joycon_subcmd_request *req;
942 u8 buffer[sizeof(*req) + 1] = { 0 };
943
944 req = (struct joycon_subcmd_request *)buffer;
945 req->subcmd_id = JC_SUBCMD_SET_REPORT_MODE;
946 req->data[0] = 0x30; /* standard, full report mode */
947
948 hid_dbg(ctlr->hdev, "setting controller report mode\n");
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400949 return joycon_send_subcmd(ctlr, req, 1, HZ);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400950}
951
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400952static int joycon_enable_rumble(struct joycon_ctlr *ctlr)
953{
954 struct joycon_subcmd_request *req;
955 u8 buffer[sizeof(*req) + 1] = { 0 };
956
957 req = (struct joycon_subcmd_request *)buffer;
958 req->subcmd_id = JC_SUBCMD_ENABLE_VIBRATION;
959 req->data[0] = 0x01; /* note: 0x00 would disable */
960
961 hid_dbg(ctlr->hdev, "enabling rumble\n");
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -0400962 return joycon_send_subcmd(ctlr, req, 1, HZ/4);
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -0400963}
964
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400965static int joycon_enable_imu(struct joycon_ctlr *ctlr)
966{
967 struct joycon_subcmd_request *req;
968 u8 buffer[sizeof(*req) + 1] = { 0 };
969
970 req = (struct joycon_subcmd_request *)buffer;
971 req->subcmd_id = JC_SUBCMD_ENABLE_IMU;
972 req->data[0] = 0x01; /* note: 0x00 would disable */
973
974 hid_dbg(ctlr->hdev, "enabling IMU\n");
975 return joycon_send_subcmd(ctlr, req, 1, HZ);
976}
977
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -0400978static s32 joycon_map_stick_val(struct joycon_stick_cal *cal, s32 val)
979{
980 s32 center = cal->center;
981 s32 min = cal->min;
982 s32 max = cal->max;
983 s32 new_val;
984
985 if (val > center) {
986 new_val = (val - center) * JC_MAX_STICK_MAG;
987 new_val /= (max - center);
988 } else {
989 new_val = (center - val) * -JC_MAX_STICK_MAG;
990 new_val /= (center - min);
991 }
992 new_val = clamp(new_val, (s32)-JC_MAX_STICK_MAG, (s32)JC_MAX_STICK_MAG);
993 return new_val;
994}
995
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -0400996static void joycon_input_report_parse_imu_data(struct joycon_ctlr *ctlr,
997 struct joycon_input_report *rep,
998 struct joycon_imu_data *imu_data)
999{
1000 u8 *raw = rep->imu_raw_bytes;
1001 int i;
1002
1003 for (i = 0; i < 3; i++) {
1004 struct joycon_imu_data *data = &imu_data[i];
1005
1006 data->accel_x = get_unaligned_le16(raw + 0);
1007 data->accel_y = get_unaligned_le16(raw + 2);
1008 data->accel_z = get_unaligned_le16(raw + 4);
1009 data->gyro_x = get_unaligned_le16(raw + 6);
1010 data->gyro_y = get_unaligned_le16(raw + 8);
1011 data->gyro_z = get_unaligned_le16(raw + 10);
1012 /* point to next imu sample */
1013 raw += sizeof(struct joycon_imu_data);
1014 }
1015}
1016
1017static void joycon_parse_imu_report(struct joycon_ctlr *ctlr,
1018 struct joycon_input_report *rep)
1019{
1020 struct joycon_imu_data imu_data[3] = {0}; /* 3 reports per packet */
1021 struct input_dev *idev = ctlr->imu_input;
1022 unsigned int msecs = jiffies_to_msecs(jiffies);
1023 unsigned int last_msecs = ctlr->imu_last_pkt_ms;
1024 int i;
1025 int value[6];
1026
1027 joycon_input_report_parse_imu_data(ctlr, rep, imu_data);
1028
1029 /*
1030 * There are complexities surrounding how we determine the timestamps we
1031 * associate with the samples we pass to userspace. The IMU input
1032 * reports do not provide us with a good timestamp. There's a quickly
1033 * incrementing 8-bit counter per input report, but it is not very
1034 * useful for this purpose (it is not entirely clear what rate it
1035 * increments at or if it varies based on packet push rate - more on
1036 * the push rate below...).
1037 *
1038 * The reverse engineering work done on the joy-cons and pro controllers
1039 * by the community seems to indicate the following:
1040 * - The controller samples the IMU every 1.35ms. It then does some of
1041 * its own processing, probably averaging the samples out.
1042 * - Each imu input report contains 3 IMU samples, (usually 5ms apart).
1043 * - In the standard reporting mode (which this driver uses exclusively)
1044 * input reports are pushed from the controller as follows:
1045 * * joy-con (bluetooth): every 15 ms
1046 * * joy-cons (in charging grip via USB): every 15 ms
1047 * * pro controller (USB): every 15 ms
1048 * * pro controller (bluetooth): every 8 ms (this is the wildcard)
1049 *
1050 * Further complicating matters is that some bluetooth stacks are known
1051 * to alter the controller's packet rate by hardcoding the bluetooth
1052 * SSR for the switch controllers (android's stack currently sets the
1053 * SSR to 11ms for both the joy-cons and pro controllers).
1054 *
1055 * In my own testing, I've discovered that my pro controller either
1056 * reports IMU sample batches every 11ms or every 15ms. This rate is
1057 * stable after connecting. It isn't 100% clear what determines this
1058 * rate. Importantly, even when sending every 11ms, none of the samples
1059 * are duplicates. This seems to indicate that the time deltas between
1060 * reported samples can vary based on the input report rate.
1061 *
1062 * The solution employed in this driver is to keep track of the average
1063 * time delta between IMU input reports. In testing, this value has
1064 * proven to be stable, staying at 15ms or 11ms, though other hardware
1065 * configurations and bluetooth stacks could potentially see other rates
1066 * (hopefully this will become more clear as more people use the
1067 * driver).
1068 *
1069 * Keeping track of the average report delta allows us to submit our
1070 * timestamps to userspace based on that. Each report contains 3
1071 * samples, so the IMU sampling rate should be avg_time_delta/3. We can
1072 * also use this average to detect events where we have dropped a
1073 * packet. The userspace timestamp for the samples will be adjusted
1074 * accordingly to prevent unwanted behvaior.
1075 */
1076 if (!ctlr->imu_first_packet_received) {
1077 ctlr->imu_timestamp_us = 0;
1078 ctlr->imu_delta_samples_count = 0;
1079 ctlr->imu_delta_samples_sum = 0;
1080 ctlr->imu_avg_delta_ms = JC_IMU_DFLT_AVG_DELTA_MS;
1081 ctlr->imu_first_packet_received = true;
1082 } else {
1083 unsigned int delta = msecs - last_msecs;
1084 unsigned int dropped_pkts;
1085 unsigned int dropped_threshold;
1086
1087 /* avg imu report delta housekeeping */
1088 ctlr->imu_delta_samples_sum += delta;
1089 ctlr->imu_delta_samples_count++;
1090 if (ctlr->imu_delta_samples_count >=
1091 JC_IMU_SAMPLES_PER_DELTA_AVG) {
1092 ctlr->imu_avg_delta_ms = ctlr->imu_delta_samples_sum /
1093 ctlr->imu_delta_samples_count;
1094 /* don't ever want divide by zero shenanigans */
1095 if (ctlr->imu_avg_delta_ms == 0) {
1096 ctlr->imu_avg_delta_ms = 1;
1097 hid_warn(ctlr->hdev,
1098 "calculated avg imu delta of 0\n");
1099 }
1100 ctlr->imu_delta_samples_count = 0;
1101 ctlr->imu_delta_samples_sum = 0;
1102 }
1103
1104 /* useful for debugging IMU sample rate */
1105 hid_dbg(ctlr->hdev,
1106 "imu_report: ms=%u last_ms=%u delta=%u avg_delta=%u\n",
1107 msecs, last_msecs, delta, ctlr->imu_avg_delta_ms);
1108
1109 /* check if any packets have been dropped */
1110 dropped_threshold = ctlr->imu_avg_delta_ms * 3 / 2;
1111 dropped_pkts = (delta - min(delta, dropped_threshold)) /
1112 ctlr->imu_avg_delta_ms;
1113 ctlr->imu_timestamp_us += 1000 * ctlr->imu_avg_delta_ms;
1114 if (dropped_pkts > JC_IMU_DROPPED_PKT_WARNING) {
1115 hid_warn(ctlr->hdev,
1116 "compensating for %u dropped IMU reports\n",
1117 dropped_pkts);
1118 hid_warn(ctlr->hdev,
1119 "delta=%u avg_delta=%u\n",
1120 delta, ctlr->imu_avg_delta_ms);
1121 }
1122 }
1123 ctlr->imu_last_pkt_ms = msecs;
1124
1125 /* Each IMU input report contains three samples */
1126 for (i = 0; i < 3; i++) {
1127 input_event(idev, EV_MSC, MSC_TIMESTAMP,
1128 ctlr->imu_timestamp_us);
1129
1130 /*
1131 * These calculations (which use the controller's calibration
1132 * settings to improve the final values) are based on those
1133 * found in the community's reverse-engineering repo (linked at
1134 * top of driver). For hid-nintendo, we make sure that the final
1135 * value given to userspace is always in terms of the axis
1136 * resolution we provided.
1137 *
1138 * Currently only the gyro calculations subtract the calibration
1139 * offsets from the raw value itself. In testing, doing the same
1140 * for the accelerometer raw values decreased accuracy.
1141 *
1142 * Note that the gyro values are multiplied by the
1143 * precision-saving scaling factor to prevent large inaccuracies
1144 * due to truncation of the resolution value which would
1145 * otherwise occur. To prevent overflow (without resorting to 64
1146 * bit integer math), the mult_frac macro is used.
1147 */
1148 value[0] = mult_frac((JC_IMU_PREC_RANGE_SCALE *
1149 (imu_data[i].gyro_x -
1150 ctlr->gyro_cal.offset[0])),
1151 ctlr->gyro_cal.scale[0],
1152 ctlr->imu_cal_gyro_divisor[0]);
1153 value[1] = mult_frac((JC_IMU_PREC_RANGE_SCALE *
1154 (imu_data[i].gyro_y -
1155 ctlr->gyro_cal.offset[1])),
1156 ctlr->gyro_cal.scale[1],
1157 ctlr->imu_cal_gyro_divisor[1]);
1158 value[2] = mult_frac((JC_IMU_PREC_RANGE_SCALE *
1159 (imu_data[i].gyro_z -
1160 ctlr->gyro_cal.offset[2])),
1161 ctlr->gyro_cal.scale[2],
1162 ctlr->imu_cal_gyro_divisor[2]);
1163
1164 value[3] = ((s32)imu_data[i].accel_x *
1165 ctlr->accel_cal.scale[0]) /
1166 ctlr->imu_cal_accel_divisor[0];
1167 value[4] = ((s32)imu_data[i].accel_y *
1168 ctlr->accel_cal.scale[1]) /
1169 ctlr->imu_cal_accel_divisor[1];
1170 value[5] = ((s32)imu_data[i].accel_z *
1171 ctlr->accel_cal.scale[2]) /
1172 ctlr->imu_cal_accel_divisor[2];
1173
1174 hid_dbg(ctlr->hdev, "raw_gyro: g_x=%d g_y=%d g_z=%d\n",
1175 imu_data[i].gyro_x, imu_data[i].gyro_y,
1176 imu_data[i].gyro_z);
1177 hid_dbg(ctlr->hdev, "raw_accel: a_x=%d a_y=%d a_z=%d\n",
1178 imu_data[i].accel_x, imu_data[i].accel_y,
1179 imu_data[i].accel_z);
1180
1181 /*
1182 * The right joy-con has 2 axes negated, Y and Z. This is due to
1183 * the orientation of the IMU in the controller. We negate those
1184 * axes' values in order to be consistent with the left joy-con
1185 * and the pro controller:
1186 * X: positive is pointing toward the triggers
1187 * Y: positive is pointing to the left
1188 * Z: positive is pointing up (out of the buttons/sticks)
1189 * The axes follow the right-hand rule.
1190 */
1191 if (jc_type_is_joycon(ctlr) && jc_type_has_right(ctlr)) {
1192 int j;
1193
1194 /* negate all but x axis */
1195 for (j = 1; j < 6; ++j) {
1196 if (j == 3)
1197 continue;
1198 value[j] *= -1;
1199 }
1200 }
1201
1202 input_report_abs(idev, ABS_RX, value[0]);
1203 input_report_abs(idev, ABS_RY, value[1]);
1204 input_report_abs(idev, ABS_RZ, value[2]);
1205 input_report_abs(idev, ABS_X, value[3]);
1206 input_report_abs(idev, ABS_Y, value[4]);
1207 input_report_abs(idev, ABS_Z, value[5]);
1208 input_sync(idev);
1209 /* convert to micros and divide by 3 (3 samples per report). */
1210 ctlr->imu_timestamp_us += ctlr->imu_avg_delta_ms * 1000 / 3;
1211 }
1212}
1213
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001214static void joycon_parse_report(struct joycon_ctlr *ctlr,
1215 struct joycon_input_report *rep)
1216{
1217 struct input_dev *dev = ctlr->input;
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -04001218 unsigned long flags;
1219 u8 tmp;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001220 u32 btns;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001221 unsigned long msecs = jiffies_to_msecs(jiffies);
1222
1223 spin_lock_irqsave(&ctlr->lock, flags);
1224 if (IS_ENABLED(CONFIG_NINTENDO_FF) && rep->vibrator_report &&
Daniel J. Ogorchockdad74e12021-09-11 13:36:39 -04001225 (msecs - ctlr->rumble_msecs) >= JC_RUMBLE_PERIOD_MS &&
1226 (ctlr->rumble_queue_head != ctlr->rumble_queue_tail ||
1227 ctlr->rumble_zero_countdown > 0)) {
1228 /*
1229 * When this value reaches 0, we know we've sent multiple
1230 * packets to the controller instructing it to disable rumble.
1231 * We can safely stop sending periodic rumble packets until the
1232 * next ff effect.
1233 */
1234 if (ctlr->rumble_zero_countdown > 0)
1235 ctlr->rumble_zero_countdown--;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001236 queue_work(ctlr->rumble_queue, &ctlr->rumble_worker);
Daniel J. Ogorchockdad74e12021-09-11 13:36:39 -04001237 }
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001238
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -04001239 /* Parse the battery status */
1240 tmp = rep->bat_con;
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -04001241 ctlr->host_powered = tmp & BIT(0);
1242 ctlr->battery_charging = tmp & BIT(4);
1243 tmp = tmp >> 5;
1244 switch (tmp) {
1245 case 0: /* empty */
1246 ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_CRITICAL;
1247 break;
1248 case 1: /* low */
1249 ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_LOW;
1250 break;
1251 case 2: /* medium */
1252 ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_NORMAL;
1253 break;
1254 case 3: /* high */
1255 ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_HIGH;
1256 break;
1257 case 4: /* full */
1258 ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_FULL;
1259 break;
1260 default:
1261 ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_UNKNOWN;
1262 hid_warn(ctlr->hdev, "Invalid battery status\n");
1263 break;
1264 }
1265 spin_unlock_irqrestore(&ctlr->lock, flags);
1266
1267 /* Parse the buttons and sticks */
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001268 btns = hid_field_extract(ctlr->hdev, rep->button_status, 0, 24);
1269
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001270 if (jc_type_has_left(ctlr)) {
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001271 u16 raw_x;
1272 u16 raw_y;
1273 s32 x;
1274 s32 y;
1275
1276 /* get raw stick values */
1277 raw_x = hid_field_extract(ctlr->hdev, rep->left_stick, 0, 12);
1278 raw_y = hid_field_extract(ctlr->hdev,
1279 rep->left_stick + 1, 4, 12);
1280 /* map the stick values */
1281 x = joycon_map_stick_val(&ctlr->left_stick_cal_x, raw_x);
1282 y = -joycon_map_stick_val(&ctlr->left_stick_cal_y, raw_y);
1283 /* report sticks */
1284 input_report_abs(dev, ABS_X, x);
1285 input_report_abs(dev, ABS_Y, y);
1286
1287 /* report buttons */
1288 input_report_key(dev, BTN_TL, btns & JC_BTN_L);
1289 input_report_key(dev, BTN_TL2, btns & JC_BTN_ZL);
1290 input_report_key(dev, BTN_SELECT, btns & JC_BTN_MINUS);
1291 input_report_key(dev, BTN_THUMBL, btns & JC_BTN_LSTICK);
1292 input_report_key(dev, BTN_Z, btns & JC_BTN_CAP);
1293
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001294 if (jc_type_is_joycon(ctlr)) {
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001295 /* Report the S buttons as the non-existent triggers */
1296 input_report_key(dev, BTN_TR, btns & JC_BTN_SL_L);
1297 input_report_key(dev, BTN_TR2, btns & JC_BTN_SR_L);
1298
1299 /* Report d-pad as digital buttons for the joy-cons */
1300 input_report_key(dev, BTN_DPAD_DOWN,
1301 btns & JC_BTN_DOWN);
1302 input_report_key(dev, BTN_DPAD_UP, btns & JC_BTN_UP);
1303 input_report_key(dev, BTN_DPAD_RIGHT,
1304 btns & JC_BTN_RIGHT);
1305 input_report_key(dev, BTN_DPAD_LEFT,
1306 btns & JC_BTN_LEFT);
1307 } else {
1308 int hatx = 0;
1309 int haty = 0;
1310
1311 /* d-pad x */
1312 if (btns & JC_BTN_LEFT)
1313 hatx = -1;
1314 else if (btns & JC_BTN_RIGHT)
1315 hatx = 1;
1316 input_report_abs(dev, ABS_HAT0X, hatx);
1317
1318 /* d-pad y */
1319 if (btns & JC_BTN_UP)
1320 haty = -1;
1321 else if (btns & JC_BTN_DOWN)
1322 haty = 1;
1323 input_report_abs(dev, ABS_HAT0Y, haty);
1324 }
1325 }
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001326 if (jc_type_has_right(ctlr)) {
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001327 u16 raw_x;
1328 u16 raw_y;
1329 s32 x;
1330 s32 y;
1331
1332 /* get raw stick values */
1333 raw_x = hid_field_extract(ctlr->hdev, rep->right_stick, 0, 12);
1334 raw_y = hid_field_extract(ctlr->hdev,
1335 rep->right_stick + 1, 4, 12);
1336 /* map stick values */
1337 x = joycon_map_stick_val(&ctlr->right_stick_cal_x, raw_x);
1338 y = -joycon_map_stick_val(&ctlr->right_stick_cal_y, raw_y);
1339 /* report sticks */
1340 input_report_abs(dev, ABS_RX, x);
1341 input_report_abs(dev, ABS_RY, y);
1342
1343 /* report buttons */
1344 input_report_key(dev, BTN_TR, btns & JC_BTN_R);
1345 input_report_key(dev, BTN_TR2, btns & JC_BTN_ZR);
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001346 if (jc_type_is_joycon(ctlr)) {
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001347 /* Report the S buttons as the non-existent triggers */
1348 input_report_key(dev, BTN_TL, btns & JC_BTN_SL_R);
1349 input_report_key(dev, BTN_TL2, btns & JC_BTN_SR_R);
1350 }
1351 input_report_key(dev, BTN_START, btns & JC_BTN_PLUS);
1352 input_report_key(dev, BTN_THUMBR, btns & JC_BTN_RSTICK);
1353 input_report_key(dev, BTN_MODE, btns & JC_BTN_HOME);
1354 input_report_key(dev, BTN_WEST, btns & JC_BTN_Y);
1355 input_report_key(dev, BTN_NORTH, btns & JC_BTN_X);
1356 input_report_key(dev, BTN_EAST, btns & JC_BTN_A);
1357 input_report_key(dev, BTN_SOUTH, btns & JC_BTN_B);
1358 }
1359
1360 input_sync(dev);
Daniel J. Ogorchock479da172021-09-11 13:36:30 -04001361
1362 /*
1363 * Immediately after receiving a report is the most reliable time to
1364 * send a subcommand to the controller. Wake any subcommand senders
1365 * waiting for a report.
1366 */
1367 if (unlikely(mutex_is_locked(&ctlr->output_mutex))) {
1368 spin_lock_irqsave(&ctlr->lock, flags);
1369 ctlr->received_input_report = true;
1370 spin_unlock_irqrestore(&ctlr->lock, flags);
1371 wake_up(&ctlr->wait);
1372 }
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001373
1374 /* parse IMU data if present */
1375 if (rep->id == JC_INPUT_IMU_DATA)
1376 joycon_parse_imu_report(ctlr, rep);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001377}
1378
Daniel J. Ogorchock4c048f62021-09-11 13:36:37 -04001379static int joycon_send_rumble_data(struct joycon_ctlr *ctlr)
1380{
1381 int ret;
1382 unsigned long flags;
1383 struct joycon_rumble_output rumble_output = { 0 };
1384
1385 spin_lock_irqsave(&ctlr->lock, flags);
1386 /*
1387 * If the controller has been removed, just return ENODEV so the LED
1388 * subsystem doesn't print invalid errors on removal.
1389 */
1390 if (ctlr->ctlr_state == JOYCON_CTLR_STATE_REMOVED) {
1391 spin_unlock_irqrestore(&ctlr->lock, flags);
1392 return -ENODEV;
1393 }
1394 memcpy(rumble_output.rumble_data,
1395 ctlr->rumble_data[ctlr->rumble_queue_tail],
1396 JC_RUMBLE_DATA_SIZE);
1397 spin_unlock_irqrestore(&ctlr->lock, flags);
1398
1399 rumble_output.output_id = JC_OUTPUT_RUMBLE_ONLY;
1400 rumble_output.packet_num = ctlr->subcmd_num;
1401 if (++ctlr->subcmd_num > 0xF)
1402 ctlr->subcmd_num = 0;
1403
Daniel J. Ogorchocke93363f2021-09-11 13:36:38 -04001404 joycon_enforce_subcmd_rate(ctlr);
1405
Daniel J. Ogorchock4c048f62021-09-11 13:36:37 -04001406 ret = __joycon_hid_send(ctlr->hdev, (u8 *)&rumble_output,
1407 sizeof(rumble_output));
1408 return ret;
1409}
1410
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001411static void joycon_rumble_worker(struct work_struct *work)
1412{
1413 struct joycon_ctlr *ctlr = container_of(work, struct joycon_ctlr,
1414 rumble_worker);
1415 unsigned long flags;
1416 bool again = true;
1417 int ret;
1418
1419 while (again) {
1420 mutex_lock(&ctlr->output_mutex);
Daniel J. Ogorchock4c048f62021-09-11 13:36:37 -04001421 ret = joycon_send_rumble_data(ctlr);
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001422 mutex_unlock(&ctlr->output_mutex);
Daniel J. Ogorchock012bd522021-09-11 13:36:31 -04001423
1424 /* -ENODEV means the controller was just unplugged */
1425 spin_lock_irqsave(&ctlr->lock, flags);
1426 if (ret < 0 && ret != -ENODEV &&
1427 ctlr->ctlr_state != JOYCON_CTLR_STATE_REMOVED)
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001428 hid_warn(ctlr->hdev, "Failed to set rumble; e=%d", ret);
1429
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001430 ctlr->rumble_msecs = jiffies_to_msecs(jiffies);
1431 if (ctlr->rumble_queue_tail != ctlr->rumble_queue_head) {
1432 if (++ctlr->rumble_queue_tail >= JC_RUMBLE_QUEUE_SIZE)
1433 ctlr->rumble_queue_tail = 0;
1434 } else {
1435 again = false;
1436 }
1437 spin_unlock_irqrestore(&ctlr->lock, flags);
1438 }
1439}
1440
1441#if IS_ENABLED(CONFIG_NINTENDO_FF)
1442static struct joycon_rumble_freq_data joycon_find_rumble_freq(u16 freq)
1443{
1444 const size_t length = ARRAY_SIZE(joycon_rumble_frequencies);
1445 const struct joycon_rumble_freq_data *data = joycon_rumble_frequencies;
1446 int i = 0;
1447
1448 if (freq > data[0].freq) {
1449 for (i = 1; i < length - 1; i++) {
1450 if (freq > data[i - 1].freq && freq <= data[i].freq)
1451 break;
1452 }
1453 }
1454
1455 return data[i];
1456}
1457
1458static struct joycon_rumble_amp_data joycon_find_rumble_amp(u16 amp)
1459{
1460 const size_t length = ARRAY_SIZE(joycon_rumble_amplitudes);
1461 const struct joycon_rumble_amp_data *data = joycon_rumble_amplitudes;
1462 int i = 0;
1463
1464 if (amp > data[0].amp) {
1465 for (i = 1; i < length - 1; i++) {
1466 if (amp > data[i - 1].amp && amp <= data[i].amp)
1467 break;
1468 }
1469 }
1470
1471 return data[i];
1472}
1473
1474static void joycon_encode_rumble(u8 *data, u16 freq_low, u16 freq_high, u16 amp)
1475{
1476 struct joycon_rumble_freq_data freq_data_low;
1477 struct joycon_rumble_freq_data freq_data_high;
1478 struct joycon_rumble_amp_data amp_data;
1479
1480 freq_data_low = joycon_find_rumble_freq(freq_low);
1481 freq_data_high = joycon_find_rumble_freq(freq_high);
1482 amp_data = joycon_find_rumble_amp(amp);
1483
1484 data[0] = (freq_data_high.high >> 8) & 0xFF;
1485 data[1] = (freq_data_high.high & 0xFF) + amp_data.high;
1486 data[2] = freq_data_low.low + ((amp_data.low >> 8) & 0xFF);
1487 data[3] = amp_data.low & 0xFF;
1488}
1489
1490static const u16 JOYCON_MAX_RUMBLE_HIGH_FREQ = 1253;
1491static const u16 JOYCON_MIN_RUMBLE_HIGH_FREQ = 82;
1492static const u16 JOYCON_MAX_RUMBLE_LOW_FREQ = 626;
1493static const u16 JOYCON_MIN_RUMBLE_LOW_FREQ = 41;
1494
1495static void joycon_clamp_rumble_freqs(struct joycon_ctlr *ctlr)
1496{
1497 unsigned long flags;
1498
1499 spin_lock_irqsave(&ctlr->lock, flags);
1500 ctlr->rumble_ll_freq = clamp(ctlr->rumble_ll_freq,
1501 JOYCON_MIN_RUMBLE_LOW_FREQ,
1502 JOYCON_MAX_RUMBLE_LOW_FREQ);
1503 ctlr->rumble_lh_freq = clamp(ctlr->rumble_lh_freq,
1504 JOYCON_MIN_RUMBLE_HIGH_FREQ,
1505 JOYCON_MAX_RUMBLE_HIGH_FREQ);
1506 ctlr->rumble_rl_freq = clamp(ctlr->rumble_rl_freq,
1507 JOYCON_MIN_RUMBLE_LOW_FREQ,
1508 JOYCON_MAX_RUMBLE_LOW_FREQ);
1509 ctlr->rumble_rh_freq = clamp(ctlr->rumble_rh_freq,
1510 JOYCON_MIN_RUMBLE_HIGH_FREQ,
1511 JOYCON_MAX_RUMBLE_HIGH_FREQ);
1512 spin_unlock_irqrestore(&ctlr->lock, flags);
1513}
1514
1515static int joycon_set_rumble(struct joycon_ctlr *ctlr, u16 amp_r, u16 amp_l,
1516 bool schedule_now)
1517{
1518 u8 data[JC_RUMBLE_DATA_SIZE];
1519 u16 amp;
1520 u16 freq_r_low;
1521 u16 freq_r_high;
1522 u16 freq_l_low;
1523 u16 freq_l_high;
1524 unsigned long flags;
1525
1526 spin_lock_irqsave(&ctlr->lock, flags);
1527 freq_r_low = ctlr->rumble_rl_freq;
1528 freq_r_high = ctlr->rumble_rh_freq;
1529 freq_l_low = ctlr->rumble_ll_freq;
1530 freq_l_high = ctlr->rumble_lh_freq;
Daniel J. Ogorchockdad74e12021-09-11 13:36:39 -04001531 /* limit number of silent rumble packets to reduce traffic */
1532 if (amp_l != 0 || amp_r != 0)
1533 ctlr->rumble_zero_countdown = JC_RUMBLE_ZERO_AMP_PKT_CNT;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001534 spin_unlock_irqrestore(&ctlr->lock, flags);
1535
1536 /* right joy-con */
1537 amp = amp_r * (u32)joycon_max_rumble_amp / 65535;
1538 joycon_encode_rumble(data + 4, freq_r_low, freq_r_high, amp);
1539
1540 /* left joy-con */
1541 amp = amp_l * (u32)joycon_max_rumble_amp / 65535;
1542 joycon_encode_rumble(data, freq_l_low, freq_l_high, amp);
1543
1544 spin_lock_irqsave(&ctlr->lock, flags);
1545 if (++ctlr->rumble_queue_head >= JC_RUMBLE_QUEUE_SIZE)
1546 ctlr->rumble_queue_head = 0;
1547 memcpy(ctlr->rumble_data[ctlr->rumble_queue_head], data,
1548 JC_RUMBLE_DATA_SIZE);
1549 spin_unlock_irqrestore(&ctlr->lock, flags);
1550
1551 /* don't wait for the periodic send (reduces latency) */
1552 if (schedule_now)
1553 queue_work(ctlr->rumble_queue, &ctlr->rumble_worker);
1554
1555 return 0;
1556}
1557
1558static int joycon_play_effect(struct input_dev *dev, void *data,
1559 struct ff_effect *effect)
1560{
1561 struct joycon_ctlr *ctlr = input_get_drvdata(dev);
1562
1563 if (effect->type != FF_RUMBLE)
1564 return 0;
1565
1566 return joycon_set_rumble(ctlr,
1567 effect->u.rumble.weak_magnitude,
1568 effect->u.rumble.strong_magnitude,
1569 true);
1570}
1571#endif /* IS_ENABLED(CONFIG_NINTENDO_FF) */
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001572
1573static const unsigned int joycon_button_inputs_l[] = {
1574 BTN_SELECT, BTN_Z, BTN_THUMBL,
1575 BTN_TL, BTN_TL2,
1576 0 /* 0 signals end of array */
1577};
1578
1579static const unsigned int joycon_button_inputs_r[] = {
1580 BTN_START, BTN_MODE, BTN_THUMBR,
1581 BTN_SOUTH, BTN_EAST, BTN_NORTH, BTN_WEST,
1582 BTN_TR, BTN_TR2,
1583 0 /* 0 signals end of array */
1584};
1585
1586/* We report joy-con d-pad inputs as buttons and pro controller as a hat. */
1587static const unsigned int joycon_dpad_inputs_jc[] = {
1588 BTN_DPAD_UP, BTN_DPAD_DOWN, BTN_DPAD_LEFT, BTN_DPAD_RIGHT,
1589};
1590
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001591static int joycon_input_create(struct joycon_ctlr *ctlr)
1592{
1593 struct hid_device *hdev;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001594 const char *name;
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001595 const char *imu_name;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001596 int ret;
1597 int i;
1598
1599 hdev = ctlr->hdev;
1600
1601 switch (hdev->product) {
1602 case USB_DEVICE_ID_NINTENDO_PROCON:
1603 name = "Nintendo Switch Pro Controller";
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001604 imu_name = "Nintendo Switch Pro Controller IMU";
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001605 break;
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001606 case USB_DEVICE_ID_NINTENDO_CHRGGRIP:
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001607 if (jc_type_has_left(ctlr)) {
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001608 name = "Nintendo Switch Left Joy-Con (Grip)";
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001609 imu_name = "Nintendo Switch Left Joy-Con IMU (Grip)";
1610 } else {
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001611 name = "Nintendo Switch Right Joy-Con (Grip)";
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001612 imu_name = "Nintendo Switch Right Joy-Con IMU (Grip)";
1613 }
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001614 break;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001615 case USB_DEVICE_ID_NINTENDO_JOYCONL:
1616 name = "Nintendo Switch Left Joy-Con";
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001617 imu_name = "Nintendo Switch Left Joy-Con IMU";
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001618 break;
1619 case USB_DEVICE_ID_NINTENDO_JOYCONR:
1620 name = "Nintendo Switch Right Joy-Con";
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001621 imu_name = "Nintendo Switch Right Joy-Con IMU";
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001622 break;
1623 default: /* Should be impossible */
1624 hid_err(hdev, "Invalid hid product\n");
1625 return -EINVAL;
1626 }
1627
1628 ctlr->input = devm_input_allocate_device(&hdev->dev);
1629 if (!ctlr->input)
1630 return -ENOMEM;
1631 ctlr->input->id.bustype = hdev->bus;
1632 ctlr->input->id.vendor = hdev->vendor;
1633 ctlr->input->id.product = hdev->product;
1634 ctlr->input->id.version = hdev->version;
Daniel J. Ogorchock14252472021-09-11 13:36:33 -04001635 ctlr->input->uniq = ctlr->mac_addr_str;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001636 ctlr->input->name = name;
1637 input_set_drvdata(ctlr->input, ctlr);
1638
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001639 /* set up sticks and buttons */
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001640 if (jc_type_has_left(ctlr)) {
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001641 input_set_abs_params(ctlr->input, ABS_X,
1642 -JC_MAX_STICK_MAG, JC_MAX_STICK_MAG,
1643 JC_STICK_FUZZ, JC_STICK_FLAT);
1644 input_set_abs_params(ctlr->input, ABS_Y,
1645 -JC_MAX_STICK_MAG, JC_MAX_STICK_MAG,
1646 JC_STICK_FUZZ, JC_STICK_FLAT);
1647
1648 for (i = 0; joycon_button_inputs_l[i] > 0; i++)
1649 input_set_capability(ctlr->input, EV_KEY,
1650 joycon_button_inputs_l[i]);
1651
1652 /* configure d-pad differently for joy-con vs pro controller */
1653 if (hdev->product != USB_DEVICE_ID_NINTENDO_PROCON) {
1654 for (i = 0; joycon_dpad_inputs_jc[i] > 0; i++)
1655 input_set_capability(ctlr->input, EV_KEY,
1656 joycon_dpad_inputs_jc[i]);
1657 } else {
1658 input_set_abs_params(ctlr->input, ABS_HAT0X,
1659 -JC_MAX_DPAD_MAG, JC_MAX_DPAD_MAG,
1660 JC_DPAD_FUZZ, JC_DPAD_FLAT);
1661 input_set_abs_params(ctlr->input, ABS_HAT0Y,
1662 -JC_MAX_DPAD_MAG, JC_MAX_DPAD_MAG,
1663 JC_DPAD_FUZZ, JC_DPAD_FLAT);
1664 }
1665 }
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001666 if (jc_type_has_right(ctlr)) {
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001667 input_set_abs_params(ctlr->input, ABS_RX,
1668 -JC_MAX_STICK_MAG, JC_MAX_STICK_MAG,
1669 JC_STICK_FUZZ, JC_STICK_FLAT);
1670 input_set_abs_params(ctlr->input, ABS_RY,
1671 -JC_MAX_STICK_MAG, JC_MAX_STICK_MAG,
1672 JC_STICK_FUZZ, JC_STICK_FLAT);
1673
1674 for (i = 0; joycon_button_inputs_r[i] > 0; i++)
1675 input_set_capability(ctlr->input, EV_KEY,
1676 joycon_button_inputs_r[i]);
1677 }
1678
1679 /* Let's report joy-con S triggers separately */
1680 if (hdev->product == USB_DEVICE_ID_NINTENDO_JOYCONL) {
1681 input_set_capability(ctlr->input, EV_KEY, BTN_TR);
1682 input_set_capability(ctlr->input, EV_KEY, BTN_TR2);
1683 } else if (hdev->product == USB_DEVICE_ID_NINTENDO_JOYCONR) {
1684 input_set_capability(ctlr->input, EV_KEY, BTN_TL);
1685 input_set_capability(ctlr->input, EV_KEY, BTN_TL2);
1686 }
1687
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04001688#if IS_ENABLED(CONFIG_NINTENDO_FF)
1689 /* set up rumble */
1690 input_set_capability(ctlr->input, EV_FF, FF_RUMBLE);
1691 input_ff_create_memless(ctlr->input, NULL, joycon_play_effect);
1692 ctlr->rumble_ll_freq = JC_RUMBLE_DFLT_LOW_FREQ;
1693 ctlr->rumble_lh_freq = JC_RUMBLE_DFLT_HIGH_FREQ;
1694 ctlr->rumble_rl_freq = JC_RUMBLE_DFLT_LOW_FREQ;
1695 ctlr->rumble_rh_freq = JC_RUMBLE_DFLT_HIGH_FREQ;
1696 joycon_clamp_rumble_freqs(ctlr);
1697 joycon_set_rumble(ctlr, 0, 0, false);
1698 ctlr->rumble_msecs = jiffies_to_msecs(jiffies);
1699#endif
1700
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001701 ret = input_register_device(ctlr->input);
1702 if (ret)
1703 return ret;
1704
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04001705 /* configure the imu input device */
1706 ctlr->imu_input = devm_input_allocate_device(&hdev->dev);
1707 if (!ctlr->imu_input)
1708 return -ENOMEM;
1709
1710 ctlr->imu_input->id.bustype = hdev->bus;
1711 ctlr->imu_input->id.vendor = hdev->vendor;
1712 ctlr->imu_input->id.product = hdev->product;
1713 ctlr->imu_input->id.version = hdev->version;
1714 ctlr->imu_input->uniq = ctlr->mac_addr_str;
1715 ctlr->imu_input->name = imu_name;
1716 input_set_drvdata(ctlr->imu_input, ctlr);
1717
1718 /* configure imu axes */
1719 input_set_abs_params(ctlr->imu_input, ABS_X,
1720 -JC_IMU_MAX_ACCEL_MAG, JC_IMU_MAX_ACCEL_MAG,
1721 JC_IMU_ACCEL_FUZZ, JC_IMU_ACCEL_FLAT);
1722 input_set_abs_params(ctlr->imu_input, ABS_Y,
1723 -JC_IMU_MAX_ACCEL_MAG, JC_IMU_MAX_ACCEL_MAG,
1724 JC_IMU_ACCEL_FUZZ, JC_IMU_ACCEL_FLAT);
1725 input_set_abs_params(ctlr->imu_input, ABS_Z,
1726 -JC_IMU_MAX_ACCEL_MAG, JC_IMU_MAX_ACCEL_MAG,
1727 JC_IMU_ACCEL_FUZZ, JC_IMU_ACCEL_FLAT);
1728 input_abs_set_res(ctlr->imu_input, ABS_X, JC_IMU_ACCEL_RES_PER_G);
1729 input_abs_set_res(ctlr->imu_input, ABS_Y, JC_IMU_ACCEL_RES_PER_G);
1730 input_abs_set_res(ctlr->imu_input, ABS_Z, JC_IMU_ACCEL_RES_PER_G);
1731
1732 input_set_abs_params(ctlr->imu_input, ABS_RX,
1733 -JC_IMU_MAX_GYRO_MAG, JC_IMU_MAX_GYRO_MAG,
1734 JC_IMU_GYRO_FUZZ, JC_IMU_GYRO_FLAT);
1735 input_set_abs_params(ctlr->imu_input, ABS_RY,
1736 -JC_IMU_MAX_GYRO_MAG, JC_IMU_MAX_GYRO_MAG,
1737 JC_IMU_GYRO_FUZZ, JC_IMU_GYRO_FLAT);
1738 input_set_abs_params(ctlr->imu_input, ABS_RZ,
1739 -JC_IMU_MAX_GYRO_MAG, JC_IMU_MAX_GYRO_MAG,
1740 JC_IMU_GYRO_FUZZ, JC_IMU_GYRO_FLAT);
1741
1742 input_abs_set_res(ctlr->imu_input, ABS_RX, JC_IMU_GYRO_RES_PER_DPS);
1743 input_abs_set_res(ctlr->imu_input, ABS_RY, JC_IMU_GYRO_RES_PER_DPS);
1744 input_abs_set_res(ctlr->imu_input, ABS_RZ, JC_IMU_GYRO_RES_PER_DPS);
1745
1746 __set_bit(EV_MSC, ctlr->imu_input->evbit);
1747 __set_bit(MSC_TIMESTAMP, ctlr->imu_input->mscbit);
1748 __set_bit(INPUT_PROP_ACCELEROMETER, ctlr->imu_input->propbit);
1749
1750 ret = input_register_device(ctlr->imu_input);
1751 if (ret)
1752 return ret;
1753
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04001754 return 0;
1755}
1756
1757static int joycon_player_led_brightness_set(struct led_classdev *led,
1758 enum led_brightness brightness)
1759{
1760 struct device *dev = led->dev->parent;
1761 struct hid_device *hdev = to_hid_device(dev);
1762 struct joycon_ctlr *ctlr;
1763 int val = 0;
1764 int i;
1765 int ret;
1766 int num;
1767
1768 ctlr = hid_get_drvdata(hdev);
1769 if (!ctlr) {
1770 hid_err(hdev, "No controller data\n");
1771 return -ENODEV;
1772 }
1773
1774 /* determine which player led this is */
1775 for (num = 0; num < JC_NUM_LEDS; num++) {
1776 if (&ctlr->leds[num] == led)
1777 break;
1778 }
1779 if (num >= JC_NUM_LEDS)
1780 return -EINVAL;
1781
1782 mutex_lock(&ctlr->output_mutex);
1783 for (i = 0; i < JC_NUM_LEDS; i++) {
1784 if (i == num)
1785 val |= brightness << i;
1786 else
1787 val |= ctlr->leds[i].brightness << i;
1788 }
1789 ret = joycon_set_player_leds(ctlr, 0, val);
1790 mutex_unlock(&ctlr->output_mutex);
1791
1792 return ret;
1793}
1794
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -04001795static int joycon_home_led_brightness_set(struct led_classdev *led,
1796 enum led_brightness brightness)
1797{
1798 struct device *dev = led->dev->parent;
1799 struct hid_device *hdev = to_hid_device(dev);
1800 struct joycon_ctlr *ctlr;
1801 struct joycon_subcmd_request *req;
1802 u8 buffer[sizeof(*req) + 5] = { 0 };
1803 u8 *data;
1804 int ret;
1805
1806 ctlr = hid_get_drvdata(hdev);
1807 if (!ctlr) {
1808 hid_err(hdev, "No controller data\n");
1809 return -ENODEV;
1810 }
1811
1812 req = (struct joycon_subcmd_request *)buffer;
1813 req->subcmd_id = JC_SUBCMD_SET_HOME_LIGHT;
1814 data = req->data;
1815 data[0] = 0x01;
1816 data[1] = brightness << 4;
1817 data[2] = brightness | (brightness << 4);
1818 data[3] = 0x11;
1819 data[4] = 0x11;
1820
1821 hid_dbg(hdev, "setting home led brightness\n");
1822 mutex_lock(&ctlr->output_mutex);
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -04001823 ret = joycon_send_subcmd(ctlr, req, 5, HZ/4);
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -04001824 mutex_unlock(&ctlr->output_mutex);
1825
1826 return ret;
1827}
1828
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04001829static DEFINE_MUTEX(joycon_input_num_mutex);
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -04001830static int joycon_leds_create(struct joycon_ctlr *ctlr)
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04001831{
1832 struct hid_device *hdev = ctlr->hdev;
1833 struct device *dev = &hdev->dev;
1834 const char *d_name = dev_name(dev);
1835 struct led_classdev *led;
1836 char *name;
1837 int ret = 0;
1838 int i;
1839 static int input_num = 1;
1840
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001841 /* Set the default controller player leds based on controller number */
1842 mutex_lock(&joycon_input_num_mutex);
1843 mutex_lock(&ctlr->output_mutex);
1844 ret = joycon_set_player_leds(ctlr, 0, 0xF >> (4 - input_num));
1845 if (ret)
1846 hid_warn(ctlr->hdev, "Failed to set leds; ret=%d\n", ret);
1847 mutex_unlock(&ctlr->output_mutex);
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04001848
1849 /* configure the player LEDs */
1850 for (i = 0; i < JC_NUM_LEDS; i++) {
1851 name = devm_kasprintf(dev, GFP_KERNEL, "%s:%s:%s",
1852 d_name,
1853 "green",
1854 joycon_player_led_names[i]);
Dan Carpenter304dd362021-11-10 11:12:08 +03001855 if (!name) {
1856 mutex_unlock(&joycon_input_num_mutex);
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04001857 return -ENOMEM;
Dan Carpenter304dd362021-11-10 11:12:08 +03001858 }
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04001859
1860 led = &ctlr->leds[i];
1861 led->name = name;
1862 led->brightness = ((i + 1) <= input_num) ? 1 : 0;
1863 led->max_brightness = 1;
1864 led->brightness_set_blocking =
1865 joycon_player_led_brightness_set;
1866 led->flags = LED_CORE_SUSPENDRESUME | LED_HW_PLUGGABLE;
1867
1868 ret = devm_led_classdev_register(&hdev->dev, led);
1869 if (ret) {
1870 hid_err(hdev, "Failed registering %s LED\n", led->name);
Dan Carpenter304dd362021-11-10 11:12:08 +03001871 mutex_unlock(&joycon_input_num_mutex);
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -04001872 return ret;
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04001873 }
1874 }
1875
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001876 if (++input_num > 4)
1877 input_num = 1;
1878 mutex_unlock(&joycon_input_num_mutex);
1879
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -04001880 /* configure the home LED */
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001881 if (jc_type_has_right(ctlr)) {
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -04001882 name = devm_kasprintf(dev, GFP_KERNEL, "%s:%s:%s",
1883 d_name,
1884 "blue",
1885 LED_FUNCTION_PLAYER5);
1886 if (!name)
1887 return -ENOMEM;
1888
1889 led = &ctlr->home_led;
1890 led->name = name;
1891 led->brightness = 0;
1892 led->max_brightness = 0xF;
1893 led->brightness_set_blocking = joycon_home_led_brightness_set;
1894 led->flags = LED_CORE_SUSPENDRESUME | LED_HW_PLUGGABLE;
1895 ret = devm_led_classdev_register(&hdev->dev, led);
1896 if (ret) {
1897 hid_err(hdev, "Failed registering home led\n");
1898 return ret;
1899 }
1900 /* Set the home LED to 0 as default state */
1901 ret = joycon_home_led_brightness_set(led, 0);
1902 if (ret) {
1903 hid_err(hdev, "Failed to set home LED dflt; ret=%d\n",
1904 ret);
1905 return ret;
1906 }
1907 }
1908
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04001909 return 0;
1910}
1911
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -04001912static int joycon_battery_get_property(struct power_supply *supply,
1913 enum power_supply_property prop,
1914 union power_supply_propval *val)
1915{
1916 struct joycon_ctlr *ctlr = power_supply_get_drvdata(supply);
1917 unsigned long flags;
1918 int ret = 0;
1919 u8 capacity;
1920 bool charging;
1921 bool powered;
1922
1923 spin_lock_irqsave(&ctlr->lock, flags);
1924 capacity = ctlr->battery_capacity;
1925 charging = ctlr->battery_charging;
1926 powered = ctlr->host_powered;
1927 spin_unlock_irqrestore(&ctlr->lock, flags);
1928
1929 switch (prop) {
1930 case POWER_SUPPLY_PROP_PRESENT:
1931 val->intval = 1;
1932 break;
1933 case POWER_SUPPLY_PROP_SCOPE:
1934 val->intval = POWER_SUPPLY_SCOPE_DEVICE;
1935 break;
1936 case POWER_SUPPLY_PROP_CAPACITY_LEVEL:
1937 val->intval = capacity;
1938 break;
1939 case POWER_SUPPLY_PROP_STATUS:
1940 if (charging)
1941 val->intval = POWER_SUPPLY_STATUS_CHARGING;
1942 else if (capacity == POWER_SUPPLY_CAPACITY_LEVEL_FULL &&
1943 powered)
1944 val->intval = POWER_SUPPLY_STATUS_FULL;
1945 else
1946 val->intval = POWER_SUPPLY_STATUS_DISCHARGING;
1947 break;
1948 default:
1949 ret = -EINVAL;
1950 break;
1951 }
1952 return ret;
1953}
1954
1955static enum power_supply_property joycon_battery_props[] = {
1956 POWER_SUPPLY_PROP_PRESENT,
1957 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
1958 POWER_SUPPLY_PROP_SCOPE,
1959 POWER_SUPPLY_PROP_STATUS,
1960};
1961
1962static int joycon_power_supply_create(struct joycon_ctlr *ctlr)
1963{
1964 struct hid_device *hdev = ctlr->hdev;
1965 struct power_supply_config supply_config = { .drv_data = ctlr, };
1966 const char * const name_fmt = "nintendo_switch_controller_battery_%s";
1967 int ret = 0;
1968
1969 /* Set initially to unknown before receiving first input report */
1970 ctlr->battery_capacity = POWER_SUPPLY_CAPACITY_LEVEL_UNKNOWN;
1971
1972 /* Configure the battery's description */
1973 ctlr->battery_desc.properties = joycon_battery_props;
1974 ctlr->battery_desc.num_properties =
1975 ARRAY_SIZE(joycon_battery_props);
1976 ctlr->battery_desc.get_property = joycon_battery_get_property;
1977 ctlr->battery_desc.type = POWER_SUPPLY_TYPE_BATTERY;
1978 ctlr->battery_desc.use_for_apm = 0;
1979 ctlr->battery_desc.name = devm_kasprintf(&hdev->dev, GFP_KERNEL,
1980 name_fmt,
1981 dev_name(&hdev->dev));
1982 if (!ctlr->battery_desc.name)
1983 return -ENOMEM;
1984
1985 ctlr->battery = devm_power_supply_register(&hdev->dev,
1986 &ctlr->battery_desc,
1987 &supply_config);
1988 if (IS_ERR(ctlr->battery)) {
1989 ret = PTR_ERR(ctlr->battery);
1990 hid_err(hdev, "Failed to register battery; ret=%d\n", ret);
1991 return ret;
1992 }
1993
1994 return power_supply_powers(ctlr->battery, &hdev->dev);
1995}
1996
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04001997static int joycon_read_info(struct joycon_ctlr *ctlr)
Daniel J. Ogorchock14252472021-09-11 13:36:33 -04001998{
1999 int ret;
2000 int i;
2001 int j;
2002 struct joycon_subcmd_request req = { 0 };
2003 struct joycon_input_report *report;
2004
2005 req.subcmd_id = JC_SUBCMD_REQ_DEV_INFO;
2006 ret = joycon_send_subcmd(ctlr, &req, 0, HZ);
2007 if (ret) {
2008 hid_err(ctlr->hdev, "Failed to get joycon info; ret=%d\n", ret);
2009 return ret;
2010 }
2011
2012 report = (struct joycon_input_report *)ctlr->input_buf;
2013
2014 for (i = 4, j = 0; j < 6; i++, j++)
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04002015 ctlr->mac_addr[j] = report->subcmd_reply.data[i];
Daniel J. Ogorchock14252472021-09-11 13:36:33 -04002016
2017 ctlr->mac_addr_str = devm_kasprintf(&ctlr->hdev->dev, GFP_KERNEL,
2018 "%02X:%02X:%02X:%02X:%02X:%02X",
2019 ctlr->mac_addr[0],
2020 ctlr->mac_addr[1],
2021 ctlr->mac_addr[2],
2022 ctlr->mac_addr[3],
2023 ctlr->mac_addr[4],
2024 ctlr->mac_addr[5]);
2025 if (!ctlr->mac_addr_str)
2026 return -ENOMEM;
2027 hid_info(ctlr->hdev, "controller MAC = %s\n", ctlr->mac_addr_str);
2028
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04002029 /* Retrieve the type so we can distinguish for charging grip */
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04002030 ctlr->ctlr_type = report->subcmd_reply.data[2];
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04002031
Daniel J. Ogorchock14252472021-09-11 13:36:33 -04002032 return 0;
2033}
2034
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002035/* Common handler for parsing inputs */
2036static int joycon_ctlr_read_handler(struct joycon_ctlr *ctlr, u8 *data,
2037 int size)
2038{
2039 if (data[0] == JC_INPUT_SUBCMD_REPLY || data[0] == JC_INPUT_IMU_DATA ||
2040 data[0] == JC_INPUT_MCU_DATA) {
2041 if (size >= 12) /* make sure it contains the input report */
2042 joycon_parse_report(ctlr,
2043 (struct joycon_input_report *)data);
2044 }
2045
2046 return 0;
2047}
2048
2049static int joycon_ctlr_handle_event(struct joycon_ctlr *ctlr, u8 *data,
2050 int size)
2051{
2052 int ret = 0;
2053 bool match = false;
2054 struct joycon_input_report *report;
2055
2056 if (unlikely(mutex_is_locked(&ctlr->output_mutex)) &&
2057 ctlr->msg_type != JOYCON_MSG_TYPE_NONE) {
2058 switch (ctlr->msg_type) {
2059 case JOYCON_MSG_TYPE_USB:
2060 if (size < 2)
2061 break;
2062 if (data[0] == JC_INPUT_USB_RESPONSE &&
2063 data[1] == ctlr->usb_ack_match)
2064 match = true;
2065 break;
2066 case JOYCON_MSG_TYPE_SUBCMD:
2067 if (size < sizeof(struct joycon_input_report) ||
2068 data[0] != JC_INPUT_SUBCMD_REPLY)
2069 break;
2070 report = (struct joycon_input_report *)data;
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04002071 if (report->subcmd_reply.id == ctlr->subcmd_ack_match)
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002072 match = true;
2073 break;
2074 default:
2075 break;
2076 }
2077
2078 if (match) {
2079 memcpy(ctlr->input_buf, data,
2080 min(size, (int)JC_MAX_RESP_SIZE));
2081 ctlr->msg_type = JOYCON_MSG_TYPE_NONE;
2082 ctlr->received_resp = true;
2083 wake_up(&ctlr->wait);
2084
2085 /* This message has been handled */
2086 return 1;
2087 }
2088 }
2089
2090 if (ctlr->ctlr_state == JOYCON_CTLR_STATE_READ)
2091 ret = joycon_ctlr_read_handler(ctlr, data, size);
2092
2093 return ret;
2094}
2095
2096static int nintendo_hid_event(struct hid_device *hdev,
2097 struct hid_report *report, u8 *raw_data, int size)
2098{
2099 struct joycon_ctlr *ctlr = hid_get_drvdata(hdev);
2100
2101 if (size < 1)
2102 return -EINVAL;
2103
2104 return joycon_ctlr_handle_event(ctlr, raw_data, size);
2105}
2106
2107static int nintendo_hid_probe(struct hid_device *hdev,
2108 const struct hid_device_id *id)
2109{
2110 int ret;
2111 struct joycon_ctlr *ctlr;
2112
2113 hid_dbg(hdev, "probe - start\n");
2114
2115 ctlr = devm_kzalloc(&hdev->dev, sizeof(*ctlr), GFP_KERNEL);
2116 if (!ctlr) {
2117 ret = -ENOMEM;
2118 goto err;
2119 }
2120
2121 ctlr->hdev = hdev;
2122 ctlr->ctlr_state = JOYCON_CTLR_STATE_INIT;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002123 ctlr->rumble_queue_head = JC_RUMBLE_QUEUE_SIZE - 1;
2124 ctlr->rumble_queue_tail = 0;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002125 hid_set_drvdata(hdev, ctlr);
2126 mutex_init(&ctlr->output_mutex);
2127 init_waitqueue_head(&ctlr->wait);
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -04002128 spin_lock_init(&ctlr->lock);
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002129 ctlr->rumble_queue = alloc_workqueue("hid-nintendo-rumble_wq",
2130 WQ_FREEZABLE | WQ_MEM_RECLAIM, 0);
2131 INIT_WORK(&ctlr->rumble_worker, joycon_rumble_worker);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002132
2133 ret = hid_parse(hdev);
2134 if (ret) {
2135 hid_err(hdev, "HID parse failed\n");
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002136 goto err_wq;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002137 }
2138
Daniel J. Ogorchockc7d0d632021-09-11 13:36:32 -04002139 /*
2140 * Patch the hw version of pro controller/joycons, so applications can
2141 * distinguish between the default HID mappings and the mappings defined
2142 * by the Linux game controller spec. This is important for the SDL2
2143 * library, which has a game controller database, which uses device ids
2144 * in combination with version as a key.
2145 */
2146 hdev->version |= 0x8000;
2147
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002148 ret = hid_hw_start(hdev, HID_CONNECT_HIDRAW);
2149 if (ret) {
2150 hid_err(hdev, "HW start failed\n");
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002151 goto err_wq;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002152 }
2153
2154 ret = hid_hw_open(hdev);
2155 if (ret) {
2156 hid_err(hdev, "cannot start hardware I/O\n");
2157 goto err_stop;
2158 }
2159
2160 hid_device_io_start(hdev);
2161
2162 /* Initialize the controller */
2163 mutex_lock(&ctlr->output_mutex);
2164 /* if handshake command fails, assume ble pro controller */
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04002165 if ((jc_type_is_procon(ctlr) || jc_type_is_chrggrip(ctlr)) &&
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -04002166 !joycon_send_usb(ctlr, JC_USB_CMD_HANDSHAKE, HZ)) {
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002167 hid_dbg(hdev, "detected USB controller\n");
2168 /* set baudrate for improved latency */
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -04002169 ret = joycon_send_usb(ctlr, JC_USB_CMD_BAUDRATE_3M, HZ);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002170 if (ret) {
2171 hid_err(hdev, "Failed to set baudrate; ret=%d\n", ret);
2172 goto err_mutex;
2173 }
2174 /* handshake */
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -04002175 ret = joycon_send_usb(ctlr, JC_USB_CMD_HANDSHAKE, HZ);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002176 if (ret) {
2177 hid_err(hdev, "Failed handshake; ret=%d\n", ret);
2178 goto err_mutex;
2179 }
2180 /*
2181 * Set no timeout (to keep controller in USB mode).
2182 * This doesn't send a response, so ignore the timeout.
2183 */
Daniel J. Ogorchock6b5dca22021-09-11 13:36:29 -04002184 joycon_send_usb(ctlr, JC_USB_CMD_NO_TIMEOUT, HZ/10);
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04002185 } else if (jc_type_is_chrggrip(ctlr)) {
2186 hid_err(hdev, "Failed charging grip handshake\n");
2187 ret = -ETIMEDOUT;
2188 goto err_mutex;
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002189 }
2190
2191 /* get controller calibration data, and parse it */
2192 ret = joycon_request_calibration(ctlr);
2193 if (ret) {
2194 /*
2195 * We can function with default calibration, but it may be
2196 * inaccurate. Provide a warning, and continue on.
2197 */
2198 hid_warn(hdev, "Analog stick positions may be inaccurate\n");
2199 }
2200
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04002201 /* get IMU calibration data, and parse it */
2202 ret = joycon_request_imu_calibration(ctlr);
2203 if (ret) {
2204 /*
2205 * We can function with default calibration, but it may be
2206 * inaccurate. Provide a warning, and continue on.
2207 */
2208 hid_warn(hdev, "Unable to read IMU calibration data\n");
2209 }
2210
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002211 /* Set the reporting mode to 0x30, which is the full report mode */
2212 ret = joycon_set_report_mode(ctlr);
2213 if (ret) {
2214 hid_err(hdev, "Failed to set report mode; ret=%d\n", ret);
2215 goto err_mutex;
2216 }
2217
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002218 /* Enable rumble */
2219 ret = joycon_enable_rumble(ctlr);
2220 if (ret) {
2221 hid_err(hdev, "Failed to enable rumble; ret=%d\n", ret);
2222 goto err_mutex;
2223 }
2224
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04002225 /* Enable the IMU */
2226 ret = joycon_enable_imu(ctlr);
2227 if (ret) {
2228 hid_err(hdev, "Failed to enable the IMU; ret=%d\n", ret);
2229 goto err_mutex;
2230 }
2231
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04002232 ret = joycon_read_info(ctlr);
Daniel J. Ogorchock14252472021-09-11 13:36:33 -04002233 if (ret) {
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04002234 hid_err(hdev, "Failed to retrieve controller info; ret=%d\n",
Daniel J. Ogorchock14252472021-09-11 13:36:33 -04002235 ret);
2236 goto err_mutex;
2237 }
2238
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002239 mutex_unlock(&ctlr->output_mutex);
2240
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04002241 /* Initialize the leds */
Daniel J. Ogorchock697e5c72021-09-11 13:36:27 -04002242 ret = joycon_leds_create(ctlr);
Daniel J. Ogorchockc5e62672021-09-11 13:36:25 -04002243 if (ret) {
2244 hid_err(hdev, "Failed to create leds; ret=%d\n", ret);
2245 goto err_close;
2246 }
2247
Daniel J. Ogorchock08ebba52021-09-11 13:36:26 -04002248 /* Initialize the battery power supply */
2249 ret = joycon_power_supply_create(ctlr);
2250 if (ret) {
2251 hid_err(hdev, "Failed to create power_supply; ret=%d\n", ret);
2252 goto err_close;
2253 }
2254
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002255 ret = joycon_input_create(ctlr);
2256 if (ret) {
2257 hid_err(hdev, "Failed to create input device; ret=%d\n", ret);
2258 goto err_close;
2259 }
2260
2261 ctlr->ctlr_state = JOYCON_CTLR_STATE_READ;
2262
2263 hid_dbg(hdev, "probe - success\n");
2264 return 0;
2265
2266err_mutex:
2267 mutex_unlock(&ctlr->output_mutex);
2268err_close:
2269 hid_hw_close(hdev);
2270err_stop:
2271 hid_hw_stop(hdev);
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002272err_wq:
2273 destroy_workqueue(ctlr->rumble_queue);
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002274err:
2275 hid_err(hdev, "probe - fail = %d\n", ret);
2276 return ret;
2277}
2278
2279static void nintendo_hid_remove(struct hid_device *hdev)
2280{
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002281 struct joycon_ctlr *ctlr = hid_get_drvdata(hdev);
Daniel J. Ogorchock012bd522021-09-11 13:36:31 -04002282 unsigned long flags;
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002283
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002284 hid_dbg(hdev, "remove\n");
Daniel J. Ogorchock012bd522021-09-11 13:36:31 -04002285
2286 /* Prevent further attempts at sending subcommands. */
2287 spin_lock_irqsave(&ctlr->lock, flags);
2288 ctlr->ctlr_state = JOYCON_CTLR_STATE_REMOVED;
2289 spin_unlock_irqrestore(&ctlr->lock, flags);
2290
Daniel J. Ogorchockc4eae842021-09-11 13:36:28 -04002291 destroy_workqueue(ctlr->rumble_queue);
Daniel J. Ogorchock012bd522021-09-11 13:36:31 -04002292
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002293 hid_hw_close(hdev);
2294 hid_hw_stop(hdev);
2295}
2296
2297static const struct hid_device_id nintendo_hid_devices[] = {
2298 { HID_USB_DEVICE(USB_VENDOR_ID_NINTENDO,
2299 USB_DEVICE_ID_NINTENDO_PROCON) },
2300 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
2301 USB_DEVICE_ID_NINTENDO_PROCON) },
Daniel J. Ogorchock294a82872021-09-11 13:36:34 -04002302 { HID_USB_DEVICE(USB_VENDOR_ID_NINTENDO,
2303 USB_DEVICE_ID_NINTENDO_CHRGGRIP) },
Daniel J. Ogorchock2af16c12021-09-11 13:36:24 -04002304 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
2305 USB_DEVICE_ID_NINTENDO_JOYCONL) },
2306 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO,
2307 USB_DEVICE_ID_NINTENDO_JOYCONR) },
2308 { }
2309};
2310MODULE_DEVICE_TABLE(hid, nintendo_hid_devices);
2311
2312static struct hid_driver nintendo_hid_driver = {
2313 .name = "nintendo",
2314 .id_table = nintendo_hid_devices,
2315 .probe = nintendo_hid_probe,
2316 .remove = nintendo_hid_remove,
2317 .raw_event = nintendo_hid_event,
2318};
2319module_hid_driver(nintendo_hid_driver);
2320
2321MODULE_LICENSE("GPL");
2322MODULE_AUTHOR("Daniel J. Ogorchock <djogorchock@gmail.com>");
2323MODULE_DESCRIPTION("Driver for Nintendo Switch Controllers");
Daniel J. Ogorchock4ff5b102021-09-11 13:36:36 -04002324