Library for ELEC2645 Gamepad PCB. University of Leeds Version 2 January 2020
Dependents: ELEC2645_Ticker_WAV ELEC2645_Project_username ELEC2645_Project_el18vgt ELEC2645_Project_el17oc11 ... more
Gamepad.h@11:ff86b2ffce01, 2017-03-02 (annotated)
- Committer:
- valavanisalex
- Date:
- Thu Mar 02 18:34:42 2017 +0000
- Revision:
- 11:ff86b2ffce01
- Parent:
- 10:a13d2f9d8a14
- Child:
- 12:1b0b6355da4f
Const safety and private member formatting
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
eencae | 0:a6288c29b936 | 1 | #ifndef GAMEPAD_H |
eencae | 0:a6288c29b936 | 2 | #define GAMEPAD_H |
eencae | 0:a6288c29b936 | 3 | |
eencae | 0:a6288c29b936 | 4 | #include "mbed.h" |
eencae | 3:964a6d95acdd | 5 | |
eencae | 3:964a6d95acdd | 6 | #define TOL 0.1f |
eencae | 3:964a6d95acdd | 7 | #define RAD2DEG 57.2957795131f |
eencae | 3:964a6d95acdd | 8 | |
eencae | 9:893189072e89 | 9 | /** Enum for direction */ |
eencae | 3:964a6d95acdd | 10 | enum Direction { |
eencae | 9:893189072e89 | 11 | CENTRE, /**< joystick centred */ |
eencae | 9:893189072e89 | 12 | N, /**< pushed North (0)*/ |
eencae | 9:893189072e89 | 13 | NE, /**< pushed North-East (45) */ |
eencae | 9:893189072e89 | 14 | E, /**< pushed East (90) */ |
eencae | 9:893189072e89 | 15 | SE, /**< pushed South-East (135) */ |
eencae | 9:893189072e89 | 16 | S, /**< pushed South (180) */ |
eencae | 9:893189072e89 | 17 | SW, /**< pushed South-West (225) */ |
eencae | 9:893189072e89 | 18 | W, /**< pushed West (270) */ |
eencae | 9:893189072e89 | 19 | NW /**< pushed North-West (315) */ |
eencae | 3:964a6d95acdd | 20 | }; |
eencae | 3:964a6d95acdd | 21 | |
eencae | 9:893189072e89 | 22 | /** Vector 2D struct */ |
eencae | 3:964a6d95acdd | 23 | struct Vector2D { |
eencae | 9:893189072e89 | 24 | float x; /**< float for x value */ |
eencae | 9:893189072e89 | 25 | float y; /**< float for y value */ |
eencae | 3:964a6d95acdd | 26 | }; |
eencae | 3:964a6d95acdd | 27 | |
eencae | 9:893189072e89 | 28 | /** Polar coordinate struct */ |
eencae | 3:964a6d95acdd | 29 | struct Polar { |
eencae | 9:893189072e89 | 30 | float mag; /**< float for magnitude */ |
eencae | 9:893189072e89 | 31 | float angle; /**< float for angle (in degrees) */ |
eencae | 3:964a6d95acdd | 32 | }; |
eencae | 0:a6288c29b936 | 33 | |
eencae | 9:893189072e89 | 34 | /** Gamepad Class |
eencae | 9:893189072e89 | 35 | @brief Library for interfacing with ELEC2645 Gamepad PCB, University of Leeds |
eencae | 9:893189072e89 | 36 | @author Dr Craig A. Evans |
eencae | 9:893189072e89 | 37 | @date Febraury 2017 |
eencae | 9:893189072e89 | 38 | */ |
eencae | 0:a6288c29b936 | 39 | class Gamepad |
eencae | 0:a6288c29b936 | 40 | { |
valavanisalex | 11:ff86b2ffce01 | 41 | private: |
valavanisalex | 11:ff86b2ffce01 | 42 | PwmOut *_led1; |
valavanisalex | 11:ff86b2ffce01 | 43 | PwmOut *_led2; |
valavanisalex | 11:ff86b2ffce01 | 44 | PwmOut *_led3; |
valavanisalex | 11:ff86b2ffce01 | 45 | PwmOut *_led4; |
valavanisalex | 11:ff86b2ffce01 | 46 | PwmOut *_led5; |
valavanisalex | 11:ff86b2ffce01 | 47 | PwmOut *_led6; |
valavanisalex | 11:ff86b2ffce01 | 48 | |
valavanisalex | 11:ff86b2ffce01 | 49 | InterruptIn *_button_A; |
valavanisalex | 11:ff86b2ffce01 | 50 | InterruptIn *_button_B; |
valavanisalex | 11:ff86b2ffce01 | 51 | InterruptIn *_button_X; |
valavanisalex | 11:ff86b2ffce01 | 52 | InterruptIn *_button_Y; |
valavanisalex | 11:ff86b2ffce01 | 53 | InterruptIn *_button_back; |
valavanisalex | 11:ff86b2ffce01 | 54 | InterruptIn *_button_start; |
valavanisalex | 11:ff86b2ffce01 | 55 | InterruptIn *_button_L; |
valavanisalex | 11:ff86b2ffce01 | 56 | InterruptIn *_button_R; |
valavanisalex | 11:ff86b2ffce01 | 57 | InterruptIn *_button_joystick; |
valavanisalex | 11:ff86b2ffce01 | 58 | |
valavanisalex | 11:ff86b2ffce01 | 59 | AnalogIn *_vert; |
valavanisalex | 11:ff86b2ffce01 | 60 | AnalogIn *_horiz; |
valavanisalex | 11:ff86b2ffce01 | 61 | |
valavanisalex | 11:ff86b2ffce01 | 62 | PwmOut *_buzzer; |
valavanisalex | 11:ff86b2ffce01 | 63 | AnalogIn *_pot; |
valavanisalex | 11:ff86b2ffce01 | 64 | |
valavanisalex | 11:ff86b2ffce01 | 65 | Timeout *_timeout; |
valavanisalex | 11:ff86b2ffce01 | 66 | |
valavanisalex | 11:ff86b2ffce01 | 67 | bool _a_flag; |
valavanisalex | 11:ff86b2ffce01 | 68 | bool _b_flag; |
valavanisalex | 11:ff86b2ffce01 | 69 | bool _x_flag; |
valavanisalex | 11:ff86b2ffce01 | 70 | bool _y_flag; |
valavanisalex | 11:ff86b2ffce01 | 71 | bool _l_flag; |
valavanisalex | 11:ff86b2ffce01 | 72 | bool _r_flag; |
valavanisalex | 11:ff86b2ffce01 | 73 | bool _back_flag; |
valavanisalex | 11:ff86b2ffce01 | 74 | bool _start_flag; |
valavanisalex | 11:ff86b2ffce01 | 75 | bool _joy_flag; |
valavanisalex | 11:ff86b2ffce01 | 76 | |
valavanisalex | 11:ff86b2ffce01 | 77 | // centred x,y values |
valavanisalex | 11:ff86b2ffce01 | 78 | float _x0; |
valavanisalex | 11:ff86b2ffce01 | 79 | float _y0; |
eencae | 0:a6288c29b936 | 80 | |
eencae | 0:a6288c29b936 | 81 | public: |
eencae | 0:a6288c29b936 | 82 | |
eencae | 9:893189072e89 | 83 | /** Constructor */ |
eencae | 0:a6288c29b936 | 84 | Gamepad(); |
eencae | 8:7eaf26f4b5f2 | 85 | |
eencae | 9:893189072e89 | 86 | /** Destructor */ |
eencae | 1:6d25cd49059b | 87 | ~Gamepad(); |
eencae | 0:a6288c29b936 | 88 | |
eencae | 9:893189072e89 | 89 | /** Initialise all peripherals and configure interrupts */ |
eencae | 0:a6288c29b936 | 90 | void init(); |
eencae | 8:7eaf26f4b5f2 | 91 | |
eencae | 9:893189072e89 | 92 | /** Turn all LEDs on */ |
eencae | 0:a6288c29b936 | 93 | void leds_on(); |
eencae | 8:7eaf26f4b5f2 | 94 | |
eencae | 9:893189072e89 | 95 | /** Turn all LEDs off */ |
eencae | 0:a6288c29b936 | 96 | void leds_off(); |
eencae | 8:7eaf26f4b5f2 | 97 | |
eencae | 9:893189072e89 | 98 | /** Set all LEDs to duty-cycle |
eencae | 9:893189072e89 | 99 | *@param value in range 0.0 to 1.0 |
eencae | 9:893189072e89 | 100 | */ |
valavanisalex | 11:ff86b2ffce01 | 101 | void leds(float val) const; |
eencae | 9:893189072e89 | 102 | |
eencae | 9:893189072e89 | 103 | /** Set LED to duty-cycle |
eencae | 9:893189072e89 | 104 | *@param value in range 0.0 to 1.0 |
eencae | 8:7eaf26f4b5f2 | 105 | */ |
eencae | 10:a13d2f9d8a14 | 106 | void led1(float val); |
eencae | 9:893189072e89 | 107 | |
eencae | 9:893189072e89 | 108 | /** Set LED to duty-cycle |
eencae | 9:893189072e89 | 109 | *@param value in range 0.0 to 1.0 |
eencae | 9:893189072e89 | 110 | */ |
eencae | 10:a13d2f9d8a14 | 111 | void led2(float val); |
eencae | 9:893189072e89 | 112 | |
eencae | 9:893189072e89 | 113 | /** Set LED to duty-cycle |
eencae | 9:893189072e89 | 114 | *@param value in range 0.0 to 1.0 |
eencae | 9:893189072e89 | 115 | */ |
eencae | 10:a13d2f9d8a14 | 116 | void led3(float val); |
eencae | 9:893189072e89 | 117 | |
eencae | 9:893189072e89 | 118 | /** Set LED to duty-cycle |
eencae | 9:893189072e89 | 119 | *@param value in range 0.0 to 1.0 |
eencae | 9:893189072e89 | 120 | */ |
eencae | 10:a13d2f9d8a14 | 121 | void led4(float val); |
eencae | 9:893189072e89 | 122 | |
eencae | 9:893189072e89 | 123 | /** Set LED to duty-cycle |
eencae | 9:893189072e89 | 124 | *@param value in range 0.0 to 1.0 |
eencae | 9:893189072e89 | 125 | */ |
eencae | 10:a13d2f9d8a14 | 126 | void led5(float val); |
eencae | 9:893189072e89 | 127 | |
eencae | 9:893189072e89 | 128 | /** Set LED to duty-cycle |
eencae | 9:893189072e89 | 129 | *@param value in range 0.0 to 1.0 |
eencae | 9:893189072e89 | 130 | */ |
eencae | 10:a13d2f9d8a14 | 131 | void led6(float val); |
eencae | 1:6d25cd49059b | 132 | |
eencae | 8:7eaf26f4b5f2 | 133 | /** Read potentiometer |
eencae | 9:893189072e89 | 134 | *@returns potentiometer value in range 0.0 to 1.0 |
eencae | 8:7eaf26f4b5f2 | 135 | */ |
valavanisalex | 11:ff86b2ffce01 | 136 | float read_pot() const; |
eencae | 8:7eaf26f4b5f2 | 137 | |
eencae | 8:7eaf26f4b5f2 | 138 | /** Play tone on piezo |
eencae | 9:893189072e89 | 139 | * @param frequency in Hz |
eencae | 9:893189072e89 | 140 | * @param duration of tone in seconds |
eencae | 8:7eaf26f4b5f2 | 141 | */ |
eencae | 1:6d25cd49059b | 142 | void tone(float frequency, float duration); |
eencae | 1:6d25cd49059b | 143 | |
eencae | 8:7eaf26f4b5f2 | 144 | /** Check if A button pressed |
eencae | 9:893189072e89 | 145 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 146 | */ |
eencae | 1:6d25cd49059b | 147 | bool a_pressed(); |
eencae | 8:7eaf26f4b5f2 | 148 | |
eencae | 8:7eaf26f4b5f2 | 149 | /** Check if B button pressed |
eencae | 9:893189072e89 | 150 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 151 | */ |
eencae | 1:6d25cd49059b | 152 | bool b_pressed(); |
eencae | 8:7eaf26f4b5f2 | 153 | |
eencae | 8:7eaf26f4b5f2 | 154 | /** Check if X button pressed |
eencae | 9:893189072e89 | 155 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 156 | */ |
eencae | 1:6d25cd49059b | 157 | bool x_pressed(); |
eencae | 8:7eaf26f4b5f2 | 158 | |
eencae | 8:7eaf26f4b5f2 | 159 | /** Check if Y button pressed |
eencae | 9:893189072e89 | 160 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 161 | */ |
eencae | 1:6d25cd49059b | 162 | bool y_pressed(); |
eencae | 8:7eaf26f4b5f2 | 163 | |
eencae | 8:7eaf26f4b5f2 | 164 | /** Check if L button pressed |
eencae | 9:893189072e89 | 165 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 166 | */ |
eencae | 1:6d25cd49059b | 167 | bool l_pressed(); |
eencae | 8:7eaf26f4b5f2 | 168 | |
eencae | 8:7eaf26f4b5f2 | 169 | /** Check if R button pressed |
eencae | 9:893189072e89 | 170 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 171 | */ |
eencae | 1:6d25cd49059b | 172 | bool r_pressed(); |
eencae | 8:7eaf26f4b5f2 | 173 | |
eencae | 8:7eaf26f4b5f2 | 174 | /** Check if Back button pressed |
eencae | 9:893189072e89 | 175 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 176 | */ |
eencae | 1:6d25cd49059b | 177 | bool back_pressed(); |
eencae | 8:7eaf26f4b5f2 | 178 | |
eencae | 8:7eaf26f4b5f2 | 179 | /** Check if Start button pressed |
eencae | 9:893189072e89 | 180 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 181 | */ |
eencae | 1:6d25cd49059b | 182 | bool start_pressed(); |
eencae | 8:7eaf26f4b5f2 | 183 | |
eencae | 8:7eaf26f4b5f2 | 184 | /** Check if Joystick button pressed |
eencae | 9:893189072e89 | 185 | * @returns true if yes, false if no |
eencae | 8:7eaf26f4b5f2 | 186 | */ |
eencae | 3:964a6d95acdd | 187 | bool joystick_pressed(); |
eencae | 8:7eaf26f4b5f2 | 188 | |
eencae | 8:7eaf26f4b5f2 | 189 | /** Get magnitude of joystick movement |
eencae | 9:893189072e89 | 190 | * @returns value in range 0.0 to 1.0 |
eencae | 8:7eaf26f4b5f2 | 191 | */ |
eencae | 8:7eaf26f4b5f2 | 192 | |
eencae | 8:7eaf26f4b5f2 | 193 | float get_mag(); |
eencae | 9:893189072e89 | 194 | |
eencae | 8:7eaf26f4b5f2 | 195 | /** Get angle of joystick movement |
eencae | 9:893189072e89 | 196 | * @returns value in range 0.0 to 359.9. 0.0 corresponds to N, 180.0 to S. -1.0 is central |
eencae | 8:7eaf26f4b5f2 | 197 | */ |
eencae | 3:964a6d95acdd | 198 | float get_angle(); |
eencae | 9:893189072e89 | 199 | |
eencae | 8:7eaf26f4b5f2 | 200 | /** Gets joystick direction |
eencae | 9:893189072e89 | 201 | * @returns an enum: CENTRE, N, NE, E, SE, S, SW, W, NW, |
eencae | 8:7eaf26f4b5f2 | 202 | */ |
eencae | 3:964a6d95acdd | 203 | Direction get_direction(); // N,NE,E,SE etc. |
eencae | 9:893189072e89 | 204 | |
eencae | 8:7eaf26f4b5f2 | 205 | /** Gets raw cartesian co-ordinates of joystick |
eencae | 9:893189072e89 | 206 | * @returns a struct with x,y members, each in the range 0.0 to 1.0 |
eencae | 8:7eaf26f4b5f2 | 207 | */ |
eencae | 5:ce5eae9ee934 | 208 | Vector2D get_coord(); // cartesian co-ordinates x,y |
eencae | 9:893189072e89 | 209 | |
eencae | 8:7eaf26f4b5f2 | 210 | /** Gets cartesian coordinates mapped to circular grid |
eencae | 9:893189072e89 | 211 | * @returns a struct with x,y members, each in the range 0.0 to 1.0 |
eencae | 8:7eaf26f4b5f2 | 212 | */ |
eencae | 5:ce5eae9ee934 | 213 | Vector2D get_mapped_coord(); // x,y mapped to circle |
eencae | 9:893189072e89 | 214 | |
eencae | 8:7eaf26f4b5f2 | 215 | /** Gets polar coordinates of the joystick |
eencae | 9:893189072e89 | 216 | * @returns a struct contains mag and angle |
eencae | 8:7eaf26f4b5f2 | 217 | */ |
eencae | 5:ce5eae9ee934 | 218 | Polar get_polar(); // mag and angle in struct form |
eencae | 3:964a6d95acdd | 219 | |
eencae | 0:a6288c29b936 | 220 | private: |
eencae | 1:6d25cd49059b | 221 | void init_buttons(); |
eencae | 1:6d25cd49059b | 222 | void tone_off(); |
eencae | 3:964a6d95acdd | 223 | |
eencae | 1:6d25cd49059b | 224 | void a_isr(); |
eencae | 1:6d25cd49059b | 225 | void b_isr(); |
eencae | 1:6d25cd49059b | 226 | void x_isr(); |
eencae | 1:6d25cd49059b | 227 | void y_isr(); |
eencae | 1:6d25cd49059b | 228 | void l_isr(); |
eencae | 1:6d25cd49059b | 229 | void r_isr(); |
eencae | 1:6d25cd49059b | 230 | void back_isr(); |
eencae | 1:6d25cd49059b | 231 | void start_isr(); |
eencae | 3:964a6d95acdd | 232 | void joy_isr(); |
eencae | 0:a6288c29b936 | 233 | }; |
eencae | 0:a6288c29b936 | 234 | |
eencae | 0:a6288c29b936 | 235 | #endif |