vusb.c 33 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013
  1. /*
  2. Copyright 2011 Jun Wako <wakojun@gmail.com>
  3. This program is free software: you can redistribute it and/or modify
  4. it under the terms of the GNU General Public License as published by
  5. the Free Software Foundation, either version 2 of the License, or
  6. (at your option) any later version.
  7. This program is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. GNU General Public License for more details.
  11. You should have received a copy of the GNU General Public License
  12. along with this program. If not, see <http://www.gnu.org/licenses/>.
  13. */
  14. #include <stdint.h>
  15. #include <avr/wdt.h>
  16. #include <usbdrv/usbdrv.h>
  17. #include "usbconfig.h"
  18. #include "host.h"
  19. #include "report.h"
  20. #include "host_driver.h"
  21. #include "vusb.h"
  22. #include "print.h"
  23. #include "debug.h"
  24. #include "wait.h"
  25. #include "usb_descriptor_common.h"
  26. #ifdef RAW_ENABLE
  27. # include "raw_hid.h"
  28. #endif
  29. #if defined(CONSOLE_ENABLE)
  30. # define RBUF_SIZE 128
  31. # include "ring_buffer.h"
  32. #endif
  33. #define NEXT_INTERFACE __COUNTER__
  34. /*
  35. * Interface indexes
  36. */
  37. enum usb_interfaces {
  38. #ifndef KEYBOARD_SHARED_EP
  39. KEYBOARD_INTERFACE = NEXT_INTERFACE,
  40. #else
  41. SHARED_INTERFACE = NEXT_INTERFACE,
  42. # define KEYBOARD_INTERFACE SHARED_INTERFACE
  43. #endif
  44. // It is important that the Raw HID interface is at a constant
  45. // interface number, to support Linux/OSX platforms and chrome.hid
  46. // If Raw HID is enabled, let it be always 1.
  47. #ifdef RAW_ENABLE
  48. RAW_INTERFACE = NEXT_INTERFACE,
  49. #endif
  50. #if defined(SHARED_EP_ENABLE) && !defined(KEYBOARD_SHARED_EP)
  51. SHARED_INTERFACE = NEXT_INTERFACE,
  52. #endif
  53. #ifdef CONSOLE_ENABLE
  54. CONSOLE_INTERFACE = NEXT_INTERFACE,
  55. #endif
  56. TOTAL_INTERFACES = NEXT_INTERFACE
  57. };
  58. #define MAX_INTERFACES 3
  59. #if (NEXT_INTERFACE - 1) > MAX_INTERFACES
  60. # error There are not enough available interfaces to support all functions. Please disable one or more of the following: Mouse Keys, Extra Keys, Raw HID, Console
  61. #endif
  62. #if (defined(MOUSE_ENABLE) || defined(EXTRAKEY_ENABLE)) && CONSOLE_ENABLE
  63. # error Mouse/Extra Keys share an endpoint with Console. Please disable one of the two.
  64. #endif
  65. static uint8_t keyboard_led_state = 0;
  66. static uint8_t vusb_idle_rate = 0;
  67. /* Keyboard report send buffer */
  68. #define KBUF_SIZE 16
  69. static report_keyboard_t kbuf[KBUF_SIZE];
  70. static uint8_t kbuf_head = 0;
  71. static uint8_t kbuf_tail = 0;
  72. static report_keyboard_t keyboard_report_sent;
  73. #define VUSB_TRANSFER_KEYBOARD_MAX_TRIES 10
  74. /* transfer keyboard report from buffer */
  75. void vusb_transfer_keyboard(void) {
  76. for (int i = 0; i < VUSB_TRANSFER_KEYBOARD_MAX_TRIES; i++) {
  77. if (usbInterruptIsReady()) {
  78. if (kbuf_head != kbuf_tail) {
  79. #ifndef KEYBOARD_SHARED_EP
  80. usbSetInterrupt((void *)&kbuf[kbuf_tail], sizeof(report_keyboard_t));
  81. #else
  82. // Ugly hack! :(
  83. usbSetInterrupt((void *)&kbuf[kbuf_tail], sizeof(report_keyboard_t) - 1);
  84. while (!usbInterruptIsReady()) {
  85. usbPoll();
  86. }
  87. usbSetInterrupt((void *)(&(kbuf[kbuf_tail].keys[5])), 1);
  88. #endif
  89. kbuf_tail = (kbuf_tail + 1) % KBUF_SIZE;
  90. if (debug_keyboard) {
  91. dprintf("V-USB: kbuf[%d->%d](%02X)\n", kbuf_tail, kbuf_head, (kbuf_head < kbuf_tail) ? (KBUF_SIZE - kbuf_tail + kbuf_head) : (kbuf_head - kbuf_tail));
  92. }
  93. }
  94. break;
  95. }
  96. usbPoll();
  97. wait_ms(1);
  98. }
  99. }
  100. /*------------------------------------------------------------------*
  101. * RAW HID
  102. *------------------------------------------------------------------*/
  103. #ifdef RAW_ENABLE
  104. # define RAW_BUFFER_SIZE 32
  105. # define RAW_EPSIZE 8
  106. static uint8_t raw_output_buffer[RAW_BUFFER_SIZE];
  107. static uint8_t raw_output_received_bytes = 0;
  108. void raw_hid_send(uint8_t *data, uint8_t length) {
  109. if (length != RAW_BUFFER_SIZE) {
  110. return;
  111. }
  112. uint8_t *temp = data;
  113. for (uint8_t i = 0; i < 4; i++) {
  114. while (!usbInterruptIsReady4()) {
  115. usbPoll();
  116. }
  117. usbSetInterrupt4(temp, 8);
  118. temp += 8;
  119. }
  120. while (!usbInterruptIsReady4()) {
  121. usbPoll();
  122. }
  123. usbSetInterrupt4(0, 0);
  124. }
  125. __attribute__((weak)) void raw_hid_receive(uint8_t *data, uint8_t length) {
  126. // Users should #include "raw_hid.h" in their own code
  127. // and implement this function there. Leave this as weak linkage
  128. // so users can opt to not handle data coming in.
  129. }
  130. void raw_hid_task(void) {
  131. if (raw_output_received_bytes == RAW_BUFFER_SIZE) {
  132. raw_hid_receive(raw_output_buffer, RAW_BUFFER_SIZE);
  133. raw_output_received_bytes = 0;
  134. }
  135. }
  136. #endif
  137. /*------------------------------------------------------------------*
  138. * Console
  139. *------------------------------------------------------------------*/
  140. #ifdef CONSOLE_ENABLE
  141. # define CONSOLE_BUFFER_SIZE 32
  142. # define CONSOLE_EPSIZE 8
  143. int8_t sendchar(uint8_t c) {
  144. rbuf_enqueue(c);
  145. return 0;
  146. }
  147. static inline bool usbSendData3(char *data, uint8_t len) {
  148. uint8_t retries = 5;
  149. while (!usbInterruptIsReady3()) {
  150. if (!(retries--)) {
  151. return false;
  152. }
  153. usbPoll();
  154. }
  155. usbSetInterrupt3((unsigned char *)data, len);
  156. return true;
  157. }
  158. void console_task(void) {
  159. if (!usbConfiguration) {
  160. return;
  161. }
  162. if (!rbuf_has_data()) {
  163. return;
  164. }
  165. // Send in chunks of 8 padded to 32
  166. char send_buf[CONSOLE_BUFFER_SIZE] = {0};
  167. uint8_t send_buf_count = 0;
  168. while (rbuf_has_data() && send_buf_count < CONSOLE_EPSIZE) {
  169. send_buf[send_buf_count++] = rbuf_dequeue();
  170. }
  171. char *temp = send_buf;
  172. for (uint8_t i = 0; i < 4; i++) {
  173. if (!usbSendData3(temp, 8)) {
  174. break;
  175. }
  176. temp += 8;
  177. }
  178. usbSendData3(0, 0);
  179. usbPoll();
  180. }
  181. #endif
  182. /*------------------------------------------------------------------*
  183. * Host driver
  184. *------------------------------------------------------------------*/
  185. static uint8_t keyboard_leds(void);
  186. static void send_keyboard(report_keyboard_t *report);
  187. static void send_mouse(report_mouse_t *report);
  188. static void send_extra(report_extra_t *report);
  189. static host_driver_t driver = {keyboard_leds, send_keyboard, send_mouse, send_extra};
  190. host_driver_t *vusb_driver(void) {
  191. return &driver;
  192. }
  193. static uint8_t keyboard_leds(void) {
  194. return keyboard_led_state;
  195. }
  196. static void send_keyboard(report_keyboard_t *report) {
  197. uint8_t next = (kbuf_head + 1) % KBUF_SIZE;
  198. if (next != kbuf_tail) {
  199. kbuf[kbuf_head] = *report;
  200. kbuf_head = next;
  201. } else {
  202. dprint("kbuf: full\n");
  203. }
  204. // NOTE: send key strokes of Macro
  205. usbPoll();
  206. vusb_transfer_keyboard();
  207. keyboard_report_sent = *report;
  208. }
  209. #ifndef KEYBOARD_SHARED_EP
  210. # define usbInterruptIsReadyShared usbInterruptIsReady3
  211. # define usbSetInterruptShared usbSetInterrupt3
  212. #else
  213. # define usbInterruptIsReadyShared usbInterruptIsReady
  214. # define usbSetInterruptShared usbSetInterrupt
  215. #endif
  216. static void send_mouse(report_mouse_t *report) {
  217. #ifdef MOUSE_ENABLE
  218. if (usbInterruptIsReadyShared()) {
  219. usbSetInterruptShared((void *)report, sizeof(report_mouse_t));
  220. }
  221. #endif
  222. }
  223. static void send_extra(report_extra_t *report) {
  224. #ifdef EXTRAKEY_ENABLE
  225. if (usbInterruptIsReadyShared()) {
  226. usbSetInterruptShared((void *)report, sizeof(report_extra_t));
  227. }
  228. #endif
  229. }
  230. void send_digitizer(report_digitizer_t *report) {
  231. #ifdef DIGITIZER_ENABLE
  232. if (usbInterruptIsReadyShared()) {
  233. usbSetInterruptShared((void *)report, sizeof(report_digitizer_t));
  234. }
  235. #endif
  236. }
  237. void send_programmable_button(report_programmable_button_t *report) {
  238. #ifdef PROGRAMMABLE_BUTTON_ENABLE
  239. if (usbInterruptIsReadyShared()) {
  240. usbSetInterruptShared((void *)report, sizeof(report_programmable_button_t));
  241. }
  242. #endif
  243. }
  244. /*------------------------------------------------------------------*
  245. * Request from host *
  246. *------------------------------------------------------------------*/
  247. static struct {
  248. uint16_t len;
  249. enum { NONE, SET_LED } kind;
  250. } last_req;
  251. usbMsgLen_t usbFunctionSetup(uchar data[8]) {
  252. usbRequest_t *rq = (void *)data;
  253. if ((rq->bmRequestType & USBRQ_TYPE_MASK) == USBRQ_TYPE_CLASS) { /* class request type */
  254. if (rq->bRequest == USBRQ_HID_GET_REPORT) {
  255. dprint("GET_REPORT:");
  256. if (rq->wIndex.word == KEYBOARD_INTERFACE) {
  257. usbMsgPtr = (usbMsgPtr_t)&keyboard_report_sent;
  258. return sizeof(keyboard_report_sent);
  259. }
  260. } else if (rq->bRequest == USBRQ_HID_GET_IDLE) {
  261. dprint("GET_IDLE:");
  262. usbMsgPtr = (usbMsgPtr_t)&vusb_idle_rate;
  263. return 1;
  264. } else if (rq->bRequest == USBRQ_HID_SET_IDLE) {
  265. vusb_idle_rate = rq->wValue.bytes[1];
  266. dprintf("SET_IDLE: %02X", vusb_idle_rate);
  267. } else if (rq->bRequest == USBRQ_HID_SET_REPORT) {
  268. dprint("SET_REPORT:");
  269. // Report Type: 0x02(Out)/ReportID: 0x00(none) && Interface: 0(keyboard)
  270. if (rq->wValue.word == 0x0200 && rq->wIndex.word == KEYBOARD_INTERFACE) {
  271. dprint("SET_LED:");
  272. last_req.kind = SET_LED;
  273. last_req.len = rq->wLength.word;
  274. }
  275. return USB_NO_MSG; // to get data in usbFunctionWrite
  276. } else {
  277. dprint("UNKNOWN:");
  278. }
  279. } else {
  280. dprint("VENDOR:");
  281. /* no vendor specific requests implemented */
  282. }
  283. dprint("\n");
  284. return 0; /* default for not implemented requests: return no data back to host */
  285. }
  286. uchar usbFunctionWrite(uchar *data, uchar len) {
  287. if (last_req.len == 0) {
  288. return -1;
  289. }
  290. switch (last_req.kind) {
  291. case SET_LED:
  292. dprintf("SET_LED: %02X\n", data[0]);
  293. keyboard_led_state = data[0];
  294. last_req.len = 0;
  295. return 1;
  296. break;
  297. case NONE:
  298. default:
  299. return -1;
  300. break;
  301. }
  302. return 1;
  303. }
  304. void usbFunctionWriteOut(uchar *data, uchar len) {
  305. #ifdef RAW_ENABLE
  306. // Data from host must be divided every 8bytes
  307. if (len != 8) {
  308. dprint("RAW: invalid length\n");
  309. raw_output_received_bytes = 0;
  310. return;
  311. }
  312. if (raw_output_received_bytes + len > RAW_BUFFER_SIZE) {
  313. dprint("RAW: buffer full\n");
  314. raw_output_received_bytes = 0;
  315. } else {
  316. for (uint8_t i = 0; i < 8; i++) {
  317. raw_output_buffer[raw_output_received_bytes + i] = data[i];
  318. }
  319. raw_output_received_bytes += len;
  320. }
  321. #endif
  322. }
  323. /*------------------------------------------------------------------*
  324. * Descriptors *
  325. *------------------------------------------------------------------*/
  326. #ifdef KEYBOARD_SHARED_EP
  327. const PROGMEM uchar shared_hid_report[] = {
  328. # define SHARED_REPORT_STARTED
  329. #else
  330. const PROGMEM uchar keyboard_hid_report[] = {
  331. #endif
  332. 0x05, 0x01, // Usage Page (Generic Desktop)
  333. 0x09, 0x06, // Usage (Keyboard)
  334. 0xA1, 0x01, // Collection (Application)
  335. #ifdef KEYBOARD_SHARED_EP
  336. 0x85, REPORT_ID_KEYBOARD, // Report ID
  337. #endif
  338. // Modifiers (8 bits)
  339. 0x05, 0x07, // Usage Page (Keyboard/Keypad)
  340. 0x19, 0xE0, // Usage Minimum (Keyboard Left Control)
  341. 0x29, 0xE7, // Usage Maximum (Keyboard Right GUI)
  342. 0x15, 0x00, // Logical Minimum (0)
  343. 0x25, 0x01, // Logical Maximum (1)
  344. 0x95, 0x08, // Report Count (8)
  345. 0x75, 0x01, // Report Size (1)
  346. 0x81, 0x02, // Input (Data, Variable, Absolute)
  347. // Reserved (1 byte)
  348. 0x95, 0x01, // Report Count (1)
  349. 0x75, 0x08, // Report Size (8)
  350. 0x81, 0x03, // Input (Constant)
  351. // Keycodes (6 bytes)
  352. 0x05, 0x07, // Usage Page (Keyboard/Keypad)
  353. 0x19, 0x00, // Usage Minimum (0)
  354. 0x29, 0xFF, // Usage Maximum (255)
  355. 0x15, 0x00, // Logical Minimum (0)
  356. 0x26, 0xFF, 0x00, // Logical Maximum (255)
  357. 0x95, 0x06, // Report Count (6)
  358. 0x75, 0x08, // Report Size (8)
  359. 0x81, 0x00, // Input (Data, Array, Absolute)
  360. // Status LEDs (5 bits)
  361. 0x05, 0x08, // Usage Page (LED)
  362. 0x19, 0x01, // Usage Minimum (Num Lock)
  363. 0x29, 0x05, // Usage Maximum (Kana)
  364. 0x95, 0x05, // Report Count (5)
  365. 0x75, 0x01, // Report Size (1)
  366. 0x91, 0x02, // Output (Data, Variable, Absolute)
  367. // LED padding (3 bits)
  368. 0x95, 0x01, // Report Count (1)
  369. 0x75, 0x03, // Report Size (3)
  370. 0x91, 0x03, // Output (Constant)
  371. 0xC0, // End Collection
  372. #ifndef KEYBOARD_SHARED_EP
  373. };
  374. #endif
  375. #if defined(SHARED_EP_ENABLE) && !defined(SHARED_REPORT_STARTED)
  376. const PROGMEM uchar shared_hid_report[] = {
  377. # define SHARED_REPORT_STARTED
  378. #endif
  379. #ifdef MOUSE_ENABLE
  380. // Mouse report descriptor
  381. 0x05, 0x01, // Usage Page (Generic Desktop)
  382. 0x09, 0x02, // Usage (Mouse)
  383. 0xA1, 0x01, // Collection (Application)
  384. 0x85, REPORT_ID_MOUSE, // Report ID
  385. 0x09, 0x01, // Usage (Pointer)
  386. 0xA1, 0x00, // Collection (Physical)
  387. // Buttons (8 bits)
  388. 0x05, 0x09, // Usage Page (Button)
  389. 0x19, 0x01, // Usage Minimum (Button 1)
  390. 0x29, 0x08, // Usage Maximum (Button 8)
  391. 0x15, 0x00, // Logical Minimum (0)
  392. 0x25, 0x01, // Logical Maximum (1)
  393. 0x95, 0x08, // Report Count (8)
  394. 0x75, 0x01, // Report Size (1)
  395. 0x81, 0x02, // Input (Data, Variable, Absolute)
  396. # ifdef MOUSE_EXTENDED_REPORT
  397. // Boot protocol XY ignored in Report protocol
  398. 0x95, 0x02, // Report Count (2)
  399. 0x75, 0x08, // Report Size (8)
  400. 0x81, 0x03, // Input (Constant)
  401. # endif
  402. // X/Y position (2 or 4 bytes)
  403. 0x05, 0x01, // Usage Page (Generic Desktop)
  404. 0x09, 0x30, // Usage (X)
  405. 0x09, 0x31, // Usage (Y)
  406. # ifndef MOUSE_EXTENDED_REPORT
  407. 0x15, 0x81, // Logical Minimum (-127)
  408. 0x25, 0x7F, // Logical Maximum (127)
  409. 0x95, 0x02, // Report Count (2)
  410. 0x75, 0x08, // Report Size (8)
  411. # else
  412. 0x16, 0x01, 0x80, // Logical Minimum (-32767)
  413. 0x26, 0xFF, 0x7F, // Logical Maximum (32767)
  414. 0x95, 0x02, // Report Count (2)
  415. 0x75, 0x10, // Report Size (16)
  416. # endif
  417. 0x81, 0x06, // Input (Data, Variable, Relative)
  418. // Vertical wheel (1 byte)
  419. 0x09, 0x38, // Usage (Wheel)
  420. 0x15, 0x81, // Logical Minimum (-127)
  421. 0x25, 0x7F, // Logical Maximum (127)
  422. 0x95, 0x01, // Report Count (1)
  423. 0x75, 0x08, // Report Size (8)
  424. 0x81, 0x06, // Input (Data, Variable, Relative)
  425. // Horizontal wheel (1 byte)
  426. 0x05, 0x0C, // Usage Page (Consumer)
  427. 0x0A, 0x38, 0x02, // Usage (AC Pan)
  428. 0x15, 0x81, // Logical Minimum (-127)
  429. 0x25, 0x7F, // Logical Maximum (127)
  430. 0x95, 0x01, // Report Count (1)
  431. 0x75, 0x08, // Report Size (8)
  432. 0x81, 0x06, // Input (Data, Variable, Relative)
  433. 0xC0, // End Collection
  434. 0xC0, // End Collection
  435. #endif
  436. #ifdef EXTRAKEY_ENABLE
  437. // Extrakeys report descriptor
  438. 0x05, 0x01, // Usage Page (Generic Desktop)
  439. 0x09, 0x80, // Usage (System Control)
  440. 0xA1, 0x01, // Collection (Application)
  441. 0x85, REPORT_ID_SYSTEM, // Report ID
  442. 0x19, 0x01, // Usage Minimum (Pointer)
  443. 0x2A, 0xB7, 0x00, // Usage Maximum (System Display LCD Autoscale)
  444. 0x15, 0x01, // Logical Minimum
  445. 0x26, 0xB7, 0x00, // Logical Maximum
  446. 0x95, 0x01, // Report Count (1)
  447. 0x75, 0x10, // Report Size (16)
  448. 0x81, 0x00, // Input (Data, Array, Absolute)
  449. 0xC0, // End Collection
  450. 0x05, 0x0C, // Usage Page (Consumer)
  451. 0x09, 0x01, // Usage (Consumer Control)
  452. 0xA1, 0x01, // Collection (Application)
  453. 0x85, REPORT_ID_CONSUMER, // Report ID
  454. 0x19, 0x01, // Usage Minimum (Consumer Control)
  455. 0x2A, 0xA0, 0x02, // Usage Maximum (AC Desktop Show All Applications)
  456. 0x15, 0x01, // Logical Minimum
  457. 0x26, 0xA0, 0x02, // Logical Maximum
  458. 0x95, 0x01, // Report Count (1)
  459. 0x75, 0x10, // Report Size (16)
  460. 0x81, 0x00, // Input (Data, Array, Absolute)
  461. 0xC0, // End Collection
  462. #endif
  463. #ifdef DIGITIZER_ENABLE
  464. // Digitizer report descriptor
  465. 0x05, 0x0D, // Usage Page (Digitizers)
  466. 0x09, 0x01, // Usage (Digitizer)
  467. 0xA1, 0x01, // Collection (Application)
  468. 0x85, REPORT_ID_DIGITIZER, // Report ID
  469. 0x09, 0x22, // Usage (Finger)
  470. 0xA1, 0x00, // Collection (Physical)
  471. // Tip Switch (1 bit)
  472. 0x09, 0x42, // Usage (Tip Switch)
  473. 0x15, 0x00, // Logical Minimum
  474. 0x25, 0x01, // Logical Maximum
  475. 0x95, 0x01, // Report Count (1)
  476. 0x75, 0x01, // Report Size (16)
  477. 0x81, 0x02, // Input (Data, Variable, Absolute)
  478. // In Range (1 bit)
  479. 0x09, 0x32, // Usage (In Range)
  480. 0x81, 0x02, // Input (Data, Variable, Absolute)
  481. // Padding (6 bits)
  482. 0x95, 0x06, // Report Count (6)
  483. 0x81, 0x03, // Input (Constant)
  484. // X/Y Position (4 bytes)
  485. 0x05, 0x01, // Usage Page (Generic Desktop)
  486. 0x26, 0xFF, 0x7F, // Logical Maximum (32767)
  487. 0x95, 0x01, // Report Count (1)
  488. 0x75, 0x10, // Report Size (16)
  489. 0x65, 0x33, // Unit (Inch, English Linear)
  490. 0x55, 0x0E, // Unit Exponent (-2)
  491. 0x09, 0x30, // Usage (X)
  492. 0x81, 0x02, // Input (Data, Variable, Absolute)
  493. 0x09, 0x31, // Usage (Y)
  494. 0x81, 0x02, // Input (Data, Variable, Absolute)
  495. 0xC0, // End Collection
  496. 0xC0, // End Collection
  497. #endif
  498. #ifdef PROGRAMMABLE_BUTTON_ENABLE
  499. // Programmable buttons report descriptor
  500. 0x05, 0x0C, // Usage Page (Consumer)
  501. 0x09, 0x01, // Usage (Consumer Control)
  502. 0xA1, 0x01, // Collection (Application)
  503. 0x85, REPORT_ID_PROGRAMMABLE_BUTTON, // Report ID
  504. 0x09, 0x03, // Usage (Programmable Buttons)
  505. 0xA1, 0x04, // Collection (Named Array)
  506. 0x05, 0x09, // Usage Page (Button)
  507. 0x19, 0x01, // Usage Minimum (Button 1)
  508. 0x29, 0x20, // Usage Maximum (Button 32)
  509. 0x15, 0x00, // Logical Minimum (0)
  510. 0x25, 0x01, // Logical Maximum (1)
  511. 0x95, 0x20, // Report Count (32)
  512. 0x75, 0x01, // Report Size (1)
  513. 0x81, 0x02, // Input (Data, Variable, Absolute)
  514. 0xC0, // End Collection
  515. 0xC0, // End Collection
  516. #endif
  517. #ifdef SHARED_EP_ENABLE
  518. };
  519. #endif
  520. #ifdef RAW_ENABLE
  521. const PROGMEM uchar raw_hid_report[] = {
  522. 0x06, RAW_USAGE_PAGE_LO, RAW_USAGE_PAGE_HI, // Usage Page (Vendor Defined)
  523. 0x09, RAW_USAGE_ID, // Usage (Vendor Defined)
  524. 0xA1, 0x01, // Collection (Application)
  525. // Data to host
  526. 0x09, 0x62, // Usage (Vendor Defined)
  527. 0x15, 0x00, // Logical Minimum (0)
  528. 0x26, 0xFF, 0x00, // Logical Maximum (255)
  529. 0x95, RAW_BUFFER_SIZE, // Report Count
  530. 0x75, 0x08, // Report Size (8)
  531. 0x81, 0x02, // Input (Data, Variable, Absolute)
  532. // Data from host
  533. 0x09, 0x63, // Usage (Vendor Defined)
  534. 0x15, 0x00, // Logical Minimum (0)
  535. 0x26, 0xFF, 0x00, // Logical Maximum (255)
  536. 0x95, RAW_BUFFER_SIZE, // Report Count
  537. 0x75, 0x08, // Report Size (8)
  538. 0x91, 0x02, // Output (Data, Variable, Absolute)
  539. 0xC0 // End Collection
  540. };
  541. #endif
  542. #if defined(CONSOLE_ENABLE)
  543. const PROGMEM uchar console_hid_report[] = {
  544. 0x06, 0x31, 0xFF, // Usage Page (Vendor Defined - PJRC Teensy compatible)
  545. 0x09, 0x74, // Usage (Vendor Defined - PJRC Teensy compatible)
  546. 0xA1, 0x01, // Collection (Application)
  547. // Data to host
  548. 0x09, 0x75, // Usage (Vendor Defined)
  549. 0x15, 0x00, // Logical Minimum (0x00)
  550. 0x26, 0xFF, 0x00, // Logical Maximum (0x00FF)
  551. 0x95, CONSOLE_BUFFER_SIZE, // Report Count
  552. 0x75, 0x08, // Report Size (8)
  553. 0x81, 0x02, // Input (Data, Variable, Absolute)
  554. // Data from host
  555. 0x09, 0x76, // Usage (Vendor Defined)
  556. 0x15, 0x00, // Logical Minimum (0x00)
  557. 0x26, 0xFF, 0x00, // Logical Maximum (0x00FF)
  558. 0x95, CONSOLE_BUFFER_SIZE, // Report Count
  559. 0x75, 0x08, // Report Size (8)
  560. 0x91, 0x02, // Output (Data)
  561. 0xC0 // End Collection
  562. };
  563. #endif
  564. #ifndef USB_MAX_POWER_CONSUMPTION
  565. # define USB_MAX_POWER_CONSUMPTION 500
  566. #endif
  567. #ifndef USB_POLLING_INTERVAL_MS
  568. # define USB_POLLING_INTERVAL_MS 1
  569. #endif
  570. // clang-format off
  571. const PROGMEM usbStringDescriptor_t usbStringDescriptorZero = {
  572. .header = {
  573. .bLength = 4,
  574. .bDescriptorType = USBDESCR_STRING
  575. },
  576. .bString = {0x0409} // US English
  577. };
  578. const PROGMEM usbStringDescriptor_t usbStringDescriptorManufacturer = {
  579. .header = {
  580. .bLength = sizeof(USBSTR(MANUFACTURER)),
  581. .bDescriptorType = USBDESCR_STRING
  582. },
  583. .bString = USBSTR(MANUFACTURER)
  584. };
  585. const PROGMEM usbStringDescriptor_t usbStringDescriptorProduct = {
  586. .header = {
  587. .bLength = sizeof(USBSTR(PRODUCT)),
  588. .bDescriptorType = USBDESCR_STRING
  589. },
  590. .bString = USBSTR(PRODUCT)
  591. };
  592. #if defined(SERIAL_NUMBER)
  593. const PROGMEM usbStringDescriptor_t usbStringDescriptorSerial = {
  594. .header = {
  595. .bLength = sizeof(USBSTR(SERIAL_NUMBER)),
  596. .bDescriptorType = USBDESCR_STRING
  597. },
  598. .bString = USBSTR(SERIAL_NUMBER)
  599. };
  600. #endif
  601. /*
  602. * Device descriptor
  603. */
  604. const PROGMEM usbDeviceDescriptor_t usbDeviceDescriptor = {
  605. .header = {
  606. .bLength = sizeof(usbDeviceDescriptor_t),
  607. .bDescriptorType = USBDESCR_DEVICE
  608. },
  609. .bcdUSB = 0x0110,
  610. .bDeviceClass = 0x00,
  611. .bDeviceSubClass = 0x00,
  612. .bDeviceProtocol = 0x00,
  613. .bMaxPacketSize0 = 8,
  614. .idVendor = VENDOR_ID,
  615. .idProduct = PRODUCT_ID,
  616. .bcdDevice = DEVICE_VER,
  617. .iManufacturer = 0x01,
  618. .iProduct = 0x02,
  619. #if defined(SERIAL_NUMBER)
  620. .iSerialNumber = 0x03,
  621. #else
  622. .iSerialNumber = 0x00,
  623. #endif
  624. .bNumConfigurations = 1
  625. };
  626. /*
  627. * Configuration descriptors
  628. */
  629. const PROGMEM usbConfigurationDescriptor_t usbConfigurationDescriptor = {
  630. .header = {
  631. .header = {
  632. .bLength = sizeof(usbConfigurationDescriptorHeader_t),
  633. .bDescriptorType = USBDESCR_CONFIG
  634. },
  635. .wTotalLength = sizeof(usbConfigurationDescriptor_t),
  636. .bNumInterfaces = TOTAL_INTERFACES,
  637. .bConfigurationValue = 0x01,
  638. .iConfiguration = 0x00,
  639. .bmAttributes = (1 << 7) | USBATTR_REMOTEWAKE,
  640. .bMaxPower = USB_MAX_POWER_CONSUMPTION / 2
  641. },
  642. # ifndef KEYBOARD_SHARED_EP
  643. /*
  644. * Keyboard
  645. */
  646. .keyboardInterface = {
  647. .header = {
  648. .bLength = sizeof(usbInterfaceDescriptor_t),
  649. .bDescriptorType = USBDESCR_INTERFACE
  650. },
  651. .bInterfaceNumber = KEYBOARD_INTERFACE,
  652. .bAlternateSetting = 0x00,
  653. .bNumEndpoints = 1,
  654. .bInterfaceClass = 0x03,
  655. .bInterfaceSubClass = 0x01,
  656. .bInterfaceProtocol = 0x01,
  657. .iInterface = 0x00
  658. },
  659. .keyboardHID = {
  660. .header = {
  661. .bLength = sizeof(usbHIDDescriptor_t),
  662. .bDescriptorType = USBDESCR_HID
  663. },
  664. .bcdHID = 0x0101,
  665. .bCountryCode = 0x00,
  666. .bNumDescriptors = 1,
  667. .bDescriptorType = USBDESCR_HID_REPORT,
  668. .wDescriptorLength = sizeof(keyboard_hid_report)
  669. },
  670. .keyboardINEndpoint = {
  671. .header = {
  672. .bLength = sizeof(usbEndpointDescriptor_t),
  673. .bDescriptorType = USBDESCR_ENDPOINT
  674. },
  675. .bEndpointAddress = (USBRQ_DIR_DEVICE_TO_HOST | 1),
  676. .bmAttributes = 0x03,
  677. .wMaxPacketSize = 8,
  678. .bInterval = USB_POLLING_INTERVAL_MS
  679. },
  680. # endif
  681. # if defined(RAW_ENABLE)
  682. /*
  683. * RAW HID
  684. */
  685. .rawInterface = {
  686. .header = {
  687. .bLength = sizeof(usbInterfaceDescriptor_t),
  688. .bDescriptorType = USBDESCR_INTERFACE
  689. },
  690. .bInterfaceNumber = RAW_INTERFACE,
  691. .bAlternateSetting = 0x00,
  692. .bNumEndpoints = 2,
  693. .bInterfaceClass = 0x03,
  694. .bInterfaceSubClass = 0x00,
  695. .bInterfaceProtocol = 0x00,
  696. .iInterface = 0x00
  697. },
  698. .rawHID = {
  699. .header = {
  700. .bLength = sizeof(usbHIDDescriptor_t),
  701. .bDescriptorType = USBDESCR_HID
  702. },
  703. .bcdHID = 0x0101,
  704. .bCountryCode = 0x00,
  705. .bNumDescriptors = 1,
  706. .bDescriptorType = USBDESCR_HID_REPORT,
  707. .wDescriptorLength = sizeof(raw_hid_report)
  708. },
  709. .rawINEndpoint = {
  710. .header = {
  711. .bLength = sizeof(usbEndpointDescriptor_t),
  712. .bDescriptorType = USBDESCR_ENDPOINT
  713. },
  714. .bEndpointAddress = (USBRQ_DIR_DEVICE_TO_HOST | USB_CFG_EP4_NUMBER),
  715. .bmAttributes = 0x03,
  716. .wMaxPacketSize = RAW_EPSIZE,
  717. .bInterval = USB_POLLING_INTERVAL_MS
  718. },
  719. .rawOUTEndpoint = {
  720. .header = {
  721. .bLength = sizeof(usbEndpointDescriptor_t),
  722. .bDescriptorType = USBDESCR_ENDPOINT
  723. },
  724. .bEndpointAddress = (USBRQ_DIR_HOST_TO_DEVICE | USB_CFG_EP4_NUMBER),
  725. .bmAttributes = 0x03,
  726. .wMaxPacketSize = RAW_EPSIZE,
  727. .bInterval = USB_POLLING_INTERVAL_MS
  728. },
  729. # endif
  730. # ifdef SHARED_EP_ENABLE
  731. /*
  732. * Shared
  733. */
  734. .sharedInterface = {
  735. .header = {
  736. .bLength = sizeof(usbInterfaceDescriptor_t),
  737. .bDescriptorType = USBDESCR_INTERFACE
  738. },
  739. .bInterfaceNumber = SHARED_INTERFACE,
  740. .bAlternateSetting = 0x00,
  741. .bNumEndpoints = 1,
  742. .bInterfaceClass = 0x03,
  743. # ifdef KEYBOARD_SHARED_EP
  744. .bInterfaceSubClass = 0x01,
  745. .bInterfaceProtocol = 0x01,
  746. # else
  747. .bInterfaceSubClass = 0x00,
  748. .bInterfaceProtocol = 0x00,
  749. # endif
  750. .iInterface = 0x00
  751. },
  752. .sharedHID = {
  753. .header = {
  754. .bLength = sizeof(usbHIDDescriptor_t),
  755. .bDescriptorType = USBDESCR_HID
  756. },
  757. .bcdHID = 0x0101,
  758. .bCountryCode = 0x00,
  759. .bNumDescriptors = 1,
  760. .bDescriptorType = USBDESCR_HID_REPORT,
  761. .wDescriptorLength = sizeof(shared_hid_report)
  762. },
  763. .sharedINEndpoint = {
  764. .header = {
  765. .bLength = sizeof(usbEndpointDescriptor_t),
  766. .bDescriptorType = USBDESCR_ENDPOINT
  767. },
  768. # ifdef KEYBOARD_SHARED_EP
  769. .bEndpointAddress = (USBRQ_DIR_DEVICE_TO_HOST | 1),
  770. # else
  771. .bEndpointAddress = (USBRQ_DIR_DEVICE_TO_HOST | USB_CFG_EP3_NUMBER),
  772. # endif
  773. .bmAttributes = 0x03,
  774. .wMaxPacketSize = 8,
  775. .bInterval = USB_POLLING_INTERVAL_MS
  776. },
  777. # endif
  778. # if defined(CONSOLE_ENABLE)
  779. /*
  780. * Console
  781. */
  782. .consoleInterface = {
  783. .header = {
  784. .bLength = sizeof(usbInterfaceDescriptor_t),
  785. .bDescriptorType = USBDESCR_INTERFACE
  786. },
  787. .bInterfaceNumber = CONSOLE_INTERFACE,
  788. .bAlternateSetting = 0x00,
  789. .bNumEndpoints = 2,
  790. .bInterfaceClass = 0x03,
  791. .bInterfaceSubClass = 0x00,
  792. .bInterfaceProtocol = 0x00,
  793. .iInterface = 0x00
  794. },
  795. .consoleHID = {
  796. .header = {
  797. .bLength = sizeof(usbHIDDescriptor_t),
  798. .bDescriptorType = USBDESCR_HID
  799. },
  800. .bcdHID = 0x0111,
  801. .bCountryCode = 0x00,
  802. .bNumDescriptors = 1,
  803. .bDescriptorType = USBDESCR_HID_REPORT,
  804. .wDescriptorLength = sizeof(console_hid_report)
  805. },
  806. .consoleINEndpoint = {
  807. .header = {
  808. .bLength = sizeof(usbEndpointDescriptor_t),
  809. .bDescriptorType = USBDESCR_ENDPOINT
  810. },
  811. .bEndpointAddress = (USBRQ_DIR_DEVICE_TO_HOST | USB_CFG_EP3_NUMBER),
  812. .bmAttributes = 0x03,
  813. .wMaxPacketSize = CONSOLE_EPSIZE,
  814. .bInterval = 0x01
  815. },
  816. .consoleOUTEndpoint = {
  817. .header = {
  818. .bLength = sizeof(usbEndpointDescriptor_t),
  819. .bDescriptorType = USBDESCR_ENDPOINT
  820. },
  821. .bEndpointAddress = (USBRQ_DIR_HOST_TO_DEVICE | USB_CFG_EP3_NUMBER),
  822. .bmAttributes = 0x03,
  823. .wMaxPacketSize = CONSOLE_EPSIZE,
  824. .bInterval = 0x01
  825. }
  826. # endif
  827. };
  828. // clang-format on
  829. USB_PUBLIC usbMsgLen_t usbFunctionDescriptor(struct usbRequest *rq) {
  830. usbMsgLen_t len = 0;
  831. switch (rq->wValue.bytes[1]) {
  832. case USBDESCR_DEVICE:
  833. usbMsgPtr = (usbMsgPtr_t)&usbDeviceDescriptor;
  834. len = sizeof(usbDeviceDescriptor_t);
  835. break;
  836. case USBDESCR_CONFIG:
  837. usbMsgPtr = (usbMsgPtr_t)&usbConfigurationDescriptor;
  838. len = sizeof(usbConfigurationDescriptor_t);
  839. break;
  840. case USBDESCR_STRING:
  841. switch (rq->wValue.bytes[0]) {
  842. case 0:
  843. usbMsgPtr = (usbMsgPtr_t)&usbStringDescriptorZero;
  844. len = usbStringDescriptorZero.header.bLength;
  845. break;
  846. case 1: // iManufacturer
  847. usbMsgPtr = (usbMsgPtr_t)&usbStringDescriptorManufacturer;
  848. len = usbStringDescriptorManufacturer.header.bLength;
  849. break;
  850. case 2: // iProduct
  851. usbMsgPtr = (usbMsgPtr_t)&usbStringDescriptorProduct;
  852. len = usbStringDescriptorProduct.header.bLength;
  853. break;
  854. #if defined(SERIAL_NUMBER)
  855. case 3: // iSerialNumber
  856. usbMsgPtr = (usbMsgPtr_t)&usbStringDescriptorSerial;
  857. len = usbStringDescriptorSerial.header.bLength;
  858. break;
  859. #endif
  860. }
  861. break;
  862. case USBDESCR_HID:
  863. switch (rq->wValue.bytes[0]) {
  864. #ifndef KEYBOARD_SHARED_EP
  865. case KEYBOARD_INTERFACE:
  866. usbMsgPtr = (usbMsgPtr_t)&usbConfigurationDescriptor.keyboardHID;
  867. len = sizeof(usbHIDDescriptor_t);
  868. break;
  869. #endif
  870. #if defined(RAW_ENABLE)
  871. case RAW_INTERFACE:
  872. usbMsgPtr = (usbMsgPtr_t)&usbConfigurationDescriptor.rawHID;
  873. len = sizeof(usbHIDDescriptor_t);
  874. break;
  875. #endif
  876. #ifdef SHARED_EP_ENABLE
  877. case SHARED_INTERFACE:
  878. usbMsgPtr = (usbMsgPtr_t)&usbConfigurationDescriptor.sharedHID;
  879. len = sizeof(usbHIDDescriptor_t);
  880. break;
  881. #endif
  882. #if defined(CONSOLE_ENABLE)
  883. case CONSOLE_INTERFACE:
  884. usbMsgPtr = (usbMsgPtr_t)&usbConfigurationDescriptor.consoleHID;
  885. len = sizeof(usbHIDDescriptor_t);
  886. break;
  887. #endif
  888. }
  889. break;
  890. case USBDESCR_HID_REPORT:
  891. /* interface index */
  892. switch (rq->wIndex.word) {
  893. #ifndef KEYBOARD_SHARED_EP
  894. case KEYBOARD_INTERFACE:
  895. usbMsgPtr = (usbMsgPtr_t)keyboard_hid_report;
  896. len = sizeof(keyboard_hid_report);
  897. break;
  898. #endif
  899. #if defined(RAW_ENABLE)
  900. case RAW_INTERFACE:
  901. usbMsgPtr = (usbMsgPtr_t)raw_hid_report;
  902. len = sizeof(raw_hid_report);
  903. break;
  904. #endif
  905. #ifdef SHARED_EP_ENABLE
  906. case SHARED_INTERFACE:
  907. usbMsgPtr = (usbMsgPtr_t)shared_hid_report;
  908. len = sizeof(shared_hid_report);
  909. break;
  910. #endif
  911. #if defined(CONSOLE_ENABLE)
  912. case CONSOLE_INTERFACE:
  913. usbMsgPtr = (usbMsgPtr_t)console_hid_report;
  914. len = sizeof(console_hid_report);
  915. break;
  916. #endif
  917. }
  918. break;
  919. }
  920. return len;
  921. }