Markus Kalkbrenner / Mbed 2 deprecated Pinscape_Controller

work in progress

Dependencies:   FastAnalogIn FastIO USBDevice mbed FastPWM SimpleDMA

Fork of Pinscape_Controller by Mike R

USBJoystick/USBJoystick.cpp@35:d832bcab089e, 2015-10-21 (annotated)

Committer:
mjr
Date:
Wed Oct 21 21:53:07 2015 +0000
Revision:
35:d832bcab089e
Parent:
31:582472d0bc57 
With expansion board 5940 "power enable" output; saving this feature, which is to be removed.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mjr 3:3514575d4f86 1 /* Copyright (c) 2010-2011 mbed.org, MIT License
mjr 3:3514575d4f86 2 * Modified Mouse code for Joystick - WH 2012
mjr 3:3514575d4f86 3 *
mjr 3:3514575d4f86 4 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
mjr 3:3514575d4f86 5 * and associated documentation files (the "Software"), to deal in the Software without
mjr 3:3514575d4f86 6 * restriction, including without limitation the rights to use, copy, modify, merge, publish,
mjr 3:3514575d4f86 7 * distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
mjr 3:3514575d4f86 8 * Software is furnished to do so, subject to the following conditions:
mjr 3:3514575d4f86 9 *
mjr 3:3514575d4f86 10 * The above copyright notice and this permission notice shall be included in all copies or
mjr 3:3514575d4f86 11 * substantial portions of the Software.
mjr 3:3514575d4f86 12 *
mjr 3:3514575d4f86 13 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
mjr 3:3514575d4f86 14 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
mjr 3:3514575d4f86 15 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
mjr 3:3514575d4f86 16 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
mjr 3:3514575d4f86 17 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
mjr 3:3514575d4f86 18 */
mjr 3:3514575d4f86 19
mjr 3:3514575d4f86 20 #include "stdint.h"
mjr 3:3514575d4f86 21 #include "USBJoystick.h"
mjr 21:5048e16cc9ef 22
mjr 21:5048e16cc9ef 23 #include "config.h" // Pinscape configuration
mjr 21:5048e16cc9ef 24
mjr 21:5048e16cc9ef 25 // Length of our joystick reports. Important: This must be kept in sync
mjr 21:5048e16cc9ef 26 // with the actual joystick report format sent in update().
mjr 21:5048e16cc9ef 27 const int reportLen = 14;
mjr 21:5048e16cc9ef 28
mjr 21:5048e16cc9ef 29 #ifdef ENABLE_JOYSTICK
mjr 11:bd9da7088e6e 30 bool USBJoystick::update(int16_t x, int16_t y, int16_t z, uint32_t buttons, uint16_t status)
mjr 3:3514575d4f86 31 {
mjr 3:3514575d4f86 32 _x = x;
mjr 3:3514575d4f86 33 _y = y;
mjr 3:3514575d4f86 34 _z = z;
mjr 11:bd9da7088e6e 35 _buttonsLo = (uint16_t)(buttons & 0xffff);
mjr 11:bd9da7088e6e 36 _buttonsHi = (uint16_t)((buttons >> 16) & 0xffff);
mjr 10:976666ffa4ef 37 _status = status;
mjr 3:3514575d4f86 38
mjr 3:3514575d4f86 39 // send the report
mjr 3:3514575d4f86 40 return update();
mjr 3:3514575d4f86 41 }
mjr 3:3514575d4f86 42
mjr 11:bd9da7088e6e 43 bool USBJoystick::update()
mjr 11:bd9da7088e6e 44 {
mjr 3:3514575d4f86 45 HID_REPORT report;
mjr 11:bd9da7088e6e 46
mjr 3:3514575d4f86 47 // Fill the report according to the Joystick Descriptor
mjr 6:cc35eb643e8f 48 #define put(idx, val) (report.data[idx] = (val) & 0xff, report.data[(idx)+1] = ((val) >> 8) & 0xff)
mjr 10:976666ffa4ef 49 put(0, _status);
mjr 10:976666ffa4ef 50 put(2, 0); // second byte of status isn't used in normal reports
mjr 11:bd9da7088e6e 51 put(4, _buttonsLo);
mjr 11:bd9da7088e6e 52 put(6, _buttonsHi);
mjr 11:bd9da7088e6e 53 put(8, _x);
mjr 11:bd9da7088e6e 54 put(10, _y);
mjr 11:bd9da7088e6e 55 put(12, _z);
mjr 21:5048e16cc9ef 56
mjr 21:5048e16cc9ef 57 // important: keep reportLen in sync with the actual byte length of
mjr 21:5048e16cc9ef 58 // the reports we build here
mjr 11:bd9da7088e6e 59 report.length = reportLen;
mjr 3:3514575d4f86 60
mjr 5:a70c0bce770d 61 // send the report
mjr 10:976666ffa4ef 62 return sendTO(&report, 100);
mjr 10:976666ffa4ef 63 }
mjr 10:976666ffa4ef 64
mjr 10:976666ffa4ef 65 bool USBJoystick::updateExposure(int &idx, int npix, const uint16_t *pix)
mjr 10:976666ffa4ef 66 {
mjr 10:976666ffa4ef 67 HID_REPORT report;
mjr 10:976666ffa4ef 68
mjr 10:976666ffa4ef 69 // Set the special status bits to indicate it's an exposure report.
mjr 10:976666ffa4ef 70 // The high 5 bits of the status word are set to 10000, and the
mjr 10:976666ffa4ef 71 // low 11 bits are the current pixel index.
mjr 10:976666ffa4ef 72 uint16_t s = idx | 0x8000;
mjr 10:976666ffa4ef 73 put(0, s);
mjr 25:e22b88bd783a 74
mjr 25:e22b88bd783a 75 // start at the second byte
mjr 25:e22b88bd783a 76 int ofs = 2;
mjr 25:e22b88bd783a 77
mjr 25:e22b88bd783a 78 // in the first report, add the total pixel count as the next two bytes
mjr 25:e22b88bd783a 79 if (idx == 0)
mjr 25:e22b88bd783a 80 {
mjr 25:e22b88bd783a 81 put(ofs, npix);
mjr 25:e22b88bd783a 82 ofs += 2;
mjr 25:e22b88bd783a 83 }
mjr 10:976666ffa4ef 84
mjr 10:976666ffa4ef 85 // now fill out the remaining words with exposure values
mjr 11:bd9da7088e6e 86 report.length = reportLen;
mjr 25:e22b88bd783a 87 for ( ; ofs + 1 < report.length ; ofs += 2)
mjr 10:976666ffa4ef 88 {
mjr 10:976666ffa4ef 89 uint16_t p = (idx < npix ? pix[idx++] : 0);
mjr 10:976666ffa4ef 90 put(ofs, p);
mjr 10:976666ffa4ef 91 }
mjr 10:976666ffa4ef 92
mjr 10:976666ffa4ef 93 // send the report
mjr 10:976666ffa4ef 94 return send(&report);
mjr 3:3514575d4f86 95 }
mjr 9:fd65b0a94720 96
mjr 35:d832bcab089e 97 bool USBJoystick::reportConfig(int numOutputs, int unitNo)
mjr 35:d832bcab089e 98 {
mjr 35:d832bcab089e 99 HID_REPORT report;
mjr 35:d832bcab089e 100
mjr 35:d832bcab089e 101 // initially fill the report with zeros
mjr 35:d832bcab089e 102 memset(report.data, 0, sizeof(report.data));
mjr 35:d832bcab089e 103
mjr 35:d832bcab089e 104 // Set the special status bits to indicate that it's a config report.
mjr 35:d832bcab089e 105 uint16_t s = 0x8800;
mjr 35:d832bcab089e 106 put(0, s);
mjr 35:d832bcab089e 107
mjr 35:d832bcab089e 108 // write the number of configured outputs
mjr 35:d832bcab089e 109 put(2, numOutputs);
mjr 35:d832bcab089e 110
mjr 35:d832bcab089e 111 // write the unit number
mjr 35:d832bcab089e 112 put(4, unitNo);
mjr 35:d832bcab089e 113
mjr 35:d832bcab089e 114 // send the report
mjr 35:d832bcab089e 115 report.length = reportLen;
mjr 35:d832bcab089e 116 return send(&report);
mjr 35:d832bcab089e 117 }
mjr 35:d832bcab089e 118
mjr 35:d832bcab089e 119 bool USBJoystick::move(int16_t x, int16_t y)
mjr 35:d832bcab089e 120 {
mjr 3:3514575d4f86 121 _x = x;
mjr 3:3514575d4f86 122 _y = y;
mjr 3:3514575d4f86 123 return update();
mjr 3:3514575d4f86 124 }
mjr 3:3514575d4f86 125
mjr 35:d832bcab089e 126 bool USBJoystick::setZ(int16_t z)
mjr 35:d832bcab089e 127 {
mjr 3:3514575d4f86 128 _z = z;
mjr 3:3514575d4f86 129 return update();
mjr 3:3514575d4f86 130 }
mjr 3:3514575d4f86 131
mjr 35:d832bcab089e 132 bool USBJoystick::buttons(uint32_t buttons)
mjr 35:d832bcab089e 133 {
mjr 11:bd9da7088e6e 134 _buttonsLo = (uint16_t)(buttons & 0xffff);
mjr 11:bd9da7088e6e 135 _buttonsHi = (uint16_t)((buttons >> 16) & 0xffff);
mjr 3:3514575d4f86 136 return update();
mjr 3:3514575d4f86 137 }
mjr 21:5048e16cc9ef 138
mjr 21:5048e16cc9ef 139 #else /* ENABLE_JOYSTICK */
mjr 21:5048e16cc9ef 140
mjr 21:5048e16cc9ef 141 bool USBJoystick::updateStatus(uint32_t status)
mjr 21:5048e16cc9ef 142 {
mjr 21:5048e16cc9ef 143 HID_REPORT report;
mjr 21:5048e16cc9ef 144
mjr 21:5048e16cc9ef 145 // Fill the report according to the Joystick Descriptor
mjr 21:5048e16cc9ef 146 #define put(idx, val) (report.data[idx] = (val) & 0xff, report.data[(idx)+1] = ((val) >> 8) & 0xff)
mjr 21:5048e16cc9ef 147 memset(report.data, 0, reportLen);
mjr 21:5048e16cc9ef 148 put(0, status);
mjr 21:5048e16cc9ef 149 report.length = reportLen;
mjr 21:5048e16cc9ef 150
mjr 21:5048e16cc9ef 151 // send the report
mjr 21:5048e16cc9ef 152 return sendTO(&report, 100);
mjr 21:5048e16cc9ef 153 }
mjr 21:5048e16cc9ef 154
mjr 21:5048e16cc9ef 155 #endif /* ENABLE_JOYSTICK */
mjr 3:3514575d4f86 156
mjr 3:3514575d4f86 157
mjr 3:3514575d4f86 158 void USBJoystick::_init() {
mjr 3:3514575d4f86 159
mjr 3:3514575d4f86 160 _x = 0;
mjr 3:3514575d4f86 161 _y = 0;
mjr 3:3514575d4f86 162 _z = 0;
mjr 11:bd9da7088e6e 163 _buttonsLo = 0x0000;
mjr 11:bd9da7088e6e 164 _buttonsHi = 0x0000;
mjr 9:fd65b0a94720 165 _status = 0;
mjr 3:3514575d4f86 166 }
mjr 3:3514575d4f86 167
mjr 3:3514575d4f86 168
mjr 3:3514575d4f86 169 uint8_t * USBJoystick::reportDesc()
mjr 3:3514575d4f86 170 {
mjr 21:5048e16cc9ef 171 #ifdef ENABLE_JOYSTICK
mjr 21:5048e16cc9ef 172 // Joystick reports are enabled. Use the full joystick report
mjr 21:5048e16cc9ef 173 // format.
mjr 3:3514575d4f86 174 static uint8_t reportDescriptor[] =
mjr 3:3514575d4f86 175 {
mjr 3:3514575d4f86 176 USAGE_PAGE(1), 0x01, // Generic desktop
mjr 3:3514575d4f86 177 USAGE(1), 0x04, // Joystick
mjr 3:3514575d4f86 178 COLLECTION(1), 0x01, // Application
mjr 9:fd65b0a94720 179
mjr 9:fd65b0a94720 180 // input report (device to host)
mjr 10:976666ffa4ef 181
mjr 10:976666ffa4ef 182 USAGE_PAGE(1), 0x06, // generic device controls - for config status
mjr 10:976666ffa4ef 183 USAGE(1), 0x00, // undefined device control
mjr 10:976666ffa4ef 184 LOGICAL_MINIMUM(1), 0x00, // 8-bit values
mjr 10:976666ffa4ef 185 LOGICAL_MAXIMUM(1), 0xFF,
mjr 10:976666ffa4ef 186 REPORT_SIZE(1), 0x08, // 8 bits per report
mjr 10:976666ffa4ef 187 REPORT_COUNT(1), 0x04, // 4 reports (4 bytes)
mjr 10:976666ffa4ef 188 INPUT(1), 0x02, // Data, Variable, Absolute
mjr 10:976666ffa4ef 189
mjr 3:3514575d4f86 190 USAGE_PAGE(1), 0x09, // Buttons
mjr 3:3514575d4f86 191 USAGE_MINIMUM(1), 0x01, // { buttons }
mjr 11:bd9da7088e6e 192 USAGE_MAXIMUM(1), 0x20, // { 1-32 }
mjr 3:3514575d4f86 193 LOGICAL_MINIMUM(1), 0x00, // 1-bit buttons - 0...
mjr 3:3514575d4f86 194 LOGICAL_MAXIMUM(1), 0x01, // ...to 1
mjr 3:3514575d4f86 195 REPORT_SIZE(1), 0x01, // 1 bit per report
mjr 11:bd9da7088e6e 196 REPORT_COUNT(1), 0x20, // 32 reports
mjr 3:3514575d4f86 197 UNIT_EXPONENT(1), 0x00, // Unit_Exponent (0)
mjr 3:3514575d4f86 198 UNIT(1), 0x00, // Unit (None)
mjr 3:3514575d4f86 199 INPUT(1), 0x02, // Data, Variable, Absolute
mjr 3:3514575d4f86 200
mjr 3:3514575d4f86 201 USAGE_PAGE(1), 0x01, // Generic desktop
mjr 9:fd65b0a94720 202 USAGE(1), 0x30, // X axis
mjr 9:fd65b0a94720 203 USAGE(1), 0x31, // Y axis
mjr 9:fd65b0a94720 204 USAGE(1), 0x32, // Z axis
mjr 6:cc35eb643e8f 205 LOGICAL_MINIMUM(2), 0x00,0xF0, // each value ranges -4096
mjr 6:cc35eb643e8f 206 LOGICAL_MAXIMUM(2), 0x00,0x10, // ...to +4096
mjr 6:cc35eb643e8f 207 REPORT_SIZE(1), 0x10, // 16 bits per report
mjr 9:fd65b0a94720 208 REPORT_COUNT(1), 0x03, // 3 reports (X, Y, Z)
mjr 9:fd65b0a94720 209 INPUT(1), 0x02, // Data, Variable, Absolute
mjr 9:fd65b0a94720 210
mjr 9:fd65b0a94720 211 // output report (host to device)
mjr 9:fd65b0a94720 212 REPORT_SIZE(1), 0x08, // 8 bits per report
mjr 31:582472d0bc57 213 REPORT_COUNT(1), 0x08, // output report count - 8-byte LedWiz format
mjr 3:3514575d4f86 214 0x09, 0x01, // usage
mjr 3:3514575d4f86 215 0x91, 0x01, // Output (array)
mjr 3:3514575d4f86 216
mjr 3:3514575d4f86 217 END_COLLECTION(0)
mjr 31:582472d0bc57 218
mjr 3:3514575d4f86 219 };
mjr 21:5048e16cc9ef 220 #else /* defined(ENABLE_JOYSTICK) */
mjr 21:5048e16cc9ef 221
mjr 21:5048e16cc9ef 222 // Joystick reports are disabled. We still want to appear
mjr 21:5048e16cc9ef 223 // as a USB device for the LedWiz output emulation, but we
mjr 21:5048e16cc9ef 224 // don't want to appear as a joystick.
mjr 21:5048e16cc9ef 225
mjr 21:5048e16cc9ef 226 static uint8_t reportDescriptor[] =
mjr 21:5048e16cc9ef 227 {
mjr 21:5048e16cc9ef 228 USAGE_PAGE(1), 0x01, // Generic desktop
mjr 21:5048e16cc9ef 229 USAGE(1), 0x00, // Undefined
mjr 21:5048e16cc9ef 230
mjr 21:5048e16cc9ef 231 COLLECTION(1), 0x01, // Application
mjr 21:5048e16cc9ef 232
mjr 21:5048e16cc9ef 233 // input report (device to host)
mjr 21:5048e16cc9ef 234 USAGE_PAGE(1), 0x06, // generic device controls - for config status
mjr 21:5048e16cc9ef 235 USAGE(1), 0x00, // undefined device control
mjr 21:5048e16cc9ef 236 LOGICAL_MINIMUM(1), 0x00, // 8-bit values
mjr 21:5048e16cc9ef 237 LOGICAL_MAXIMUM(1), 0xFF,
mjr 21:5048e16cc9ef 238 REPORT_SIZE(1), 0x08, // 8 bits per report
mjr 21:5048e16cc9ef 239 REPORT_COUNT(1), reportLen, // standard report length (same as if we were in joystick mode)
mjr 21:5048e16cc9ef 240 INPUT(1), 0x02, // Data, Variable, Absolute
mjr 21:5048e16cc9ef 241
mjr 21:5048e16cc9ef 242 // output report (host to device)
mjr 21:5048e16cc9ef 243 REPORT_SIZE(1), 0x08, // 8 bits per report
mjr 21:5048e16cc9ef 244 REPORT_COUNT(1), 0x08, // output report count (LEDWiz messages)
mjr 21:5048e16cc9ef 245 0x09, 0x01, // usage
mjr 21:5048e16cc9ef 246 0x91, 0x01, // Output (array)
mjr 21:5048e16cc9ef 247
mjr 21:5048e16cc9ef 248 END_COLLECTION(0)
mjr 21:5048e16cc9ef 249 };
mjr 3:3514575d4f86 250
mjr 21:5048e16cc9ef 251 #endif /* defined(ENABLE_JOYSTICK) */
mjr 21:5048e16cc9ef 252
mjr 3:3514575d4f86 253 reportLength = sizeof(reportDescriptor);
mjr 3:3514575d4f86 254 return reportDescriptor;
mjr 3:3514575d4f86 255 }
mjr 3:3514575d4f86 256
mjr 3:3514575d4f86 257 uint8_t * USBJoystick::stringImanufacturerDesc() {
mjr 3:3514575d4f86 258 static uint8_t stringImanufacturerDescriptor[] = {
mjr 3:3514575d4f86 259 0x10, /*bLength*/
mjr 3:3514575d4f86 260 STRING_DESCRIPTOR, /*bDescriptorType 0x03*/
mjr 3:3514575d4f86 261 'm',0,'j',0,'r',0,'c',0,'o',0,'r',0,'p',0 /*bString iManufacturer - mjrcorp*/
mjr 3:3514575d4f86 262 };
mjr 3:3514575d4f86 263 return stringImanufacturerDescriptor;
mjr 3:3514575d4f86 264 }
mjr 3:3514575d4f86 265
mjr 3:3514575d4f86 266 uint8_t * USBJoystick::stringIserialDesc() {
mjr 3:3514575d4f86 267 static uint8_t stringIserialDescriptor[] = {
mjr 3:3514575d4f86 268 0x16, /*bLength*/
mjr 3:3514575d4f86 269 STRING_DESCRIPTOR, /*bDescriptorType 0x03*/
mjr 3:3514575d4f86 270 '0',0,'1',0,'2',0,'3',0,'4',0,'5',0,'6',0,'7',0,'8',0,'9',0, /*bString iSerial - 0123456789*/
mjr 3:3514575d4f86 271 };
mjr 3:3514575d4f86 272 return stringIserialDescriptor;
mjr 3:3514575d4f86 273 }
mjr 3:3514575d4f86 274
mjr 3:3514575d4f86 275 uint8_t * USBJoystick::stringIproductDesc() {
mjr 3:3514575d4f86 276 static uint8_t stringIproductDescriptor[] = {
mjr 9:fd65b0a94720 277 0x28, /*bLength*/
mjr 3:3514575d4f86 278 STRING_DESCRIPTOR, /*bDescriptorType 0x03*/
mjr 3:3514575d4f86 279 'P',0,'i',0,'n',0,'s',0,'c',0,'a',0,'p',0,'e',0,
mjr 3:3514575d4f86 280 ' ',0,'C',0,'o',0,'n',0,'t',0,'r',0,'o',0,'l',0,
mjr 3:3514575d4f86 281 'l',0,'e',0,'r',0 /*String iProduct */
mjr 3:3514575d4f86 282 };
mjr 3:3514575d4f86 283 return stringIproductDescriptor;
mjr 3:3514575d4f86 284 }