Dave Van Wagner / USBHOST

ST/USBHOST forked to add another HID handler for raw keyboard data to get more detail not available with current handlers (all pressed keys, all releases, and periodic updates)

Dependents:   C64-stm429_discovery

USBHostHID/USBHostMouse.h@7:9dc1cb9d5e12, 2020-04-13 (annotated)

Committer:
davervw
Date:
Mon Apr 13 05:25:10 2020 +0000
Revision:
7:9dc1cb9d5e12
Parent:
5:fc157e6bd5a5 
Added handler to USBHostHID/USBHostKeyboard.cpp:;    void (*onKeyData)(uint8_t len, uint8_t* data);; so can get raw keyboard data for all keys simultaneously pressed, and all releases and periodic data

Who changed what in which revision?

UserRevisionLine numberNew contents of line
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 1 /* mbed USBHost Library
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 2 * Copyright (c) 2006-2013 ARM Limited
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 3 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 4 * Licensed under the Apache License, Version 2.0 (the "License");
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 5 * you may not use this file except in compliance with the License.
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 6 * You may obtain a copy of the License at
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 7 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 8 * http://www.apache.org/licenses/LICENSE-2.0
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 9 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 10 * Unless required by applicable law or agreed to in writing, software
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 11 * distributed under the License is distributed on an "AS IS" BASIS,
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 13 * See the License for the specific language governing permissions and
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 14 * limitations under the License.
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 15 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 16
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 17 #ifndef USBHOSTMOUSE_H
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 18 #define USBHOSTMOUSE_H
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 19
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 20 #include "USBHostConf.h"
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 21
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 22 #if USBHOST_MOUSE
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 23
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 24 #include "USBHost.h"
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 25
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 26 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 27 * A class to communicate a USB mouse
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 28 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 29 class USBHostMouse : public IUSBEnumerator {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 30 public:
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 31
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 32 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 33 * Constructor
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 34 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 35 USBHostMouse();
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 36
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 37 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 38 * Try to connect a mouse device
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 39 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 40 * @return true if connection was successful
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 41 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 42 bool connect();
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 43
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 44 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 45 * Check if a mouse is connected
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 46 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 47 * @returns true if a mouse is connected
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 48 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 49 bool connected();
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 50
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 51 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 52 * Attach a callback called when a mouse event is received
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 53 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 54 * @param ptr function pointer
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 55 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 56 inline void attachEvent(void (*ptr)(uint8_t buttons, int8_t x, int8_t y, int8_t z)) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 57 if (ptr != NULL) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 58 onUpdate = ptr;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 59 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 60 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 61
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 62 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 63 * Attach a callback called when the button state changes
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 64 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 65 * @param ptr function pointer
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 66 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 67 inline void attachButtonEvent(void (*ptr)(uint8_t buttons)) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 68 if (ptr != NULL) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 69 onButtonUpdate = ptr;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 70 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 71 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 72
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 73 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 74 * Attach a callback called when the X axis value changes
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 75 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 76 * @param ptr function pointer
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 77 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 78 inline void attachXEvent(void (*ptr)(int8_t x)) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 79 if (ptr != NULL) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 80 onXUpdate = ptr;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 81 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 82 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 83
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 84 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 85 * Attach a callback called when the Y axis value changes
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 86 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 87 * @param ptr function pointer
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 88 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 89 inline void attachYEvent(void (*ptr)(int8_t y)) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 90 if (ptr != NULL) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 91 onYUpdate = ptr;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 92 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 93 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 94
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 95 /**
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 96 * Attach a callback called when the Z axis value changes (scrolling)
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 97 *
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 98 * @param ptr function pointer
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 99 */
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 100 inline void attachZEvent(void (*ptr)(int8_t z)) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 101 if (ptr != NULL) {
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 102 onZUpdate = ptr;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 103 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 104 }
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 105
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 106 protected:
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 107 //From IUSBEnumerator
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 108 virtual void setVidPid(uint16_t vid, uint16_t pid);
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 109 virtual bool parseInterface(uint8_t intf_nb, uint8_t intf_class, uint8_t intf_subclass, uint8_t intf_protocol); //Must return true if the interface should be parsed
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 110 virtual bool useEndpoint(uint8_t intf_nb, ENDPOINT_TYPE type, ENDPOINT_DIRECTION dir); //Must return true if the endpoint will be used
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 111
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 112 private:
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 113 USBHost * host;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 114 USBDeviceConnected * dev;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 115 USBEndpoint * int_in;
frq08711@LMECWL0871.LME.ST.COM 5:fc157e6bd5a5 116 uint8_t report[64];
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 117 bool dev_connected;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 118 bool mouse_device_found;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 119 int mouse_intf;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 120
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 121 uint8_t buttons;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 122 int8_t x;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 123 int8_t y;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 124 int8_t z;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 125
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 126 void rxHandler();
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 127 void (*onUpdate)(uint8_t buttons, int8_t x, int8_t y, int8_t z);
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 128 void (*onButtonUpdate)(uint8_t buttons);
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 129 void (*onXUpdate)(int8_t x);
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 130 void (*onYUpdate)(int8_t y);
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 131 void (*onZUpdate)(int8_t z);
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 132 int report_id;
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 133 void init();
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 134 };
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 135
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 136 #endif
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 137
frq08711@LMECWL0871.LME.ST.COM 1:ab240722d7ef 138 #endif