USB Joystick library, modified to work as a 6 DOF joystick.

Dependents:   USBJoystick_Test

Fork of USBJoystick by Wim Huiskamp

USBJoystick.h

Committer:
smartsystemdesign
Date:
2017-01-13
Revision:
2:1549541d3b4b
Parent:
1:8b5f213b169f
Child:
3:f8be03f31e6c

File content as of revision 2:1549541d3b4b:

/* mbed USBJoystick Library
 * Copyright (c) 2012, v01:  Initial version, WH,
 *                           Modified USBMouse code ARM Limited.
 *                           (c) 2010-2011 mbed.org, MIT License
 *               2016, v02:  Updated USBDevice Lib, Added waitForConnect, Updated 32 bits button 
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, inclumosig without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUmosiG BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

#ifndef USBJOYSTICK_H
#define USBJOYSTICK_H

#include "USBHID.h"

#define REPORT_ID_JOYSTICK  4

//Configure Joystick
#define HAT4      0
#define HAT8      1

#define BUTTONS4  0
#define BUTTONS8  0
#define BUTTONS32 1


/* Common usage */
enum JOY_BUTTON {
     JOY_B0 = 1,
     JOY_B1 = 2,
     JOY_B2 = 4,
     JOY_B3 = 8,
};

#if (HAT4 == 1)
enum JOY_HAT {
     JOY_HAT_UP      = 0,
     JOY_HAT_RIGHT   = 1,
     JOY_HAT_DOWN    = 2,
     JOY_HAT_LEFT    = 3,     
     JOY_HAT_NEUTRAL = 4,
};
#endif
#if (HAT8 == 1)
enum JOY_HAT {
     JOY_HAT_UP         = 0,     
     JOY_HAT_UP_RIGHT   = 1,
     JOY_HAT_RIGHT      = 2,
     JOY_HAT_RIGHT_DOWN = 3,
     JOY_HAT_DOWN       = 4,
     JOY_HAT_DOWN_LEFT  = 5,
     JOY_HAT_LEFT       = 6,
     JOY_HAT_LEFT_UP    = 7,
     JOY_HAT_NEUTRAL    = 8,
};
#endif

/* X, Y and T limits */
/* These values do not directly map to screen pixels */
/* Zero may be interpreted as meaning 'no movement' */
#define JX_MIN_ABS    (-32768)     /*!< The maximum value that we can move to the left on the x-axis */
#define JY_MIN_ABS    (-32768)     /*!< The maximum value that we can move up on the y-axis */
#define JT_MIN_ABS    (-32768)     /*!< The minimum value for the throttle */
#define JX_MAX_ABS    (32767)      /*!< The maximum value that we can move to the right on the x-axis */
#define JY_MAX_ABS    (32767)      /*!< The maximum value that we can move down on the y-axis */
#define JT_MAX_ABS    (32767)      /*!< The maximum value for the throttle */

class USBJoystick: public USBHID {
   public:

   /**
     *   Constructor
     *
     * @param vendor_id Your vendor_id (default: 0x1234)
     * @param product_id Your product_id (default: 0x0002)
     * @param product_release Your product_release (default: 0x0001)
     */
//     USBJoystick(uint16_t vendor_id = 0x1234, uint16_t product_id = 0x0100, uint16_t product_release = 0x0001, int waitForConnect = true):    // 4 buttons, no padding on buttons
//     USBJoystick(uint16_t vendor_id = 0x1234, uint16_t product_id = 0x0500, uint16_t product_release = 0x0001, int waitForConnect = true):    // 8 buttons, no padding on buttons
     USBJoystick(uint16_t vendor_id = 0x1234, uint16_t product_id = 0x0600, uint16_t product_release = 0x0001, int waitForConnect = true):    // 32 buttons, no padding on buttons
       USBHID(0, 0, vendor_id, product_id, product_release, false) {
         _init();
         connect(waitForConnect);
     };
         
     /**
       * Write state of the joystick
       *
       * @param t throttle position
       * @param r rudder position         
       * @param x x-axis position
       * @param y y-axis position
       * @param buttons buttons state
       * @param hat hat state 0 (up), 1 (right, 2 (down), 3 (left) or 4 (neutral)
       * @returns true if there is no error, false otherwise
       */
     bool update(int16_t x, int16_t y, int16_t z, int16_t rx, int16_t ry, int16_t rz, uint32_t buttons, uint8_t hat);

     /**
       * Write state of the joystick
       *
       * @returns true if there is no error, false otherwise
       */
     bool update();       

     /**
       * Move the cursor to (x, y)
       *
       * @param x-axis position
       * @param y-axis position
       * @returns true if there is no error, false otherwise
       */
     bool move(int16_t x, int16_t y, int16_t z, int16_t rx, int16_t ry, int16_t rz);
         
     /**
       * Press one or several buttons
       *
       * @param buttons buttons state
       * @returns true if there is no error, false otherwise
       */
     bool buttons(uint32_t buttons);
         
     /**
       * Press hat
       *
       * @param hat hat state
       * @returns true if there is no error, false otherwise
       */
     bool hat(uint8_t hat);
         
     /**
       * To define the report descriptor. Warning: this method has to store the length of the report descriptor in reportLength.
       *
       * @returns pointer to the report descriptor
       */
       virtual uint8_t * reportDesc();

   private:
     int16_t _x;
     int16_t _y;
     int16_t _z;
     int16_t _rx;
     int16_t _ry;              
     int16_t _rz;
     uint32_t _buttons;
     uint8_t _hat; 
     
     void _init();                 
};

#endif