David Leaming / Joystick

Analog joystick library Used & amended by D.Leaming, University of Lincoln, December 2021

Joystick.h@1:a68688213b63, 2021-12-06 (annotated)

Committer:
legstar85
Date:
Mon Dec 06 14:48:13 2021 +0000
Revision:
1:a68688213b63
Parent:
0:649b59b2fb26 
D.Leaming - Lincoln Uni - IoT - Final Project V02

Who changed what in which revision?

UserRevisionLine numberNew contents of line
eencae 0:649b59b2fb26 1 #ifndef JOYSTICK_H
eencae 0:649b59b2fb26 2 #define JOYSTICK_H
eencae 0:649b59b2fb26 3
eencae 0:649b59b2fb26 4 #include "mbed.h"
eencae 0:649b59b2fb26 5
eencae 0:649b59b2fb26 6 // this value can be tuned to alter tolerance of joystick movement
eencae 0:649b59b2fb26 7 #define TOL 0.1f
eencae 0:649b59b2fb26 8 #define RAD2DEG 57.2957795131f
eencae 0:649b59b2fb26 9
eencae 0:649b59b2fb26 10 enum Direction {
eencae 0:649b59b2fb26 11 CENTRE, // 0
eencae 0:649b59b2fb26 12 N, // 1
eencae 0:649b59b2fb26 13 NE, // 2
eencae 0:649b59b2fb26 14 E, // 3
eencae 0:649b59b2fb26 15 SE, // 4
eencae 0:649b59b2fb26 16 S, // 5
eencae 0:649b59b2fb26 17 SW, // 6
eencae 0:649b59b2fb26 18 W, // 7
eencae 0:649b59b2fb26 19 NW // 8
eencae 0:649b59b2fb26 20 };
eencae 0:649b59b2fb26 21
eencae 0:649b59b2fb26 22 struct Vector2D {
eencae 0:649b59b2fb26 23 float x;
eencae 0:649b59b2fb26 24 float y;
eencae 0:649b59b2fb26 25 };
eencae 0:649b59b2fb26 26
eencae 0:649b59b2fb26 27 struct Polar {
eencae 0:649b59b2fb26 28 float mag;
eencae 0:649b59b2fb26 29 float angle;
eencae 0:649b59b2fb26 30 };
eencae 0:649b59b2fb26 31
eencae 0:649b59b2fb26 32 /** Joystick Class
legstar85 1:a68688213b63 33 @brief Acknowledgements to Dr Craig A. Evans, University of Leeds
eencae 0:649b59b2fb26 34 @brief Library for interfacing with analogue joystick
legstar85 1:a68688213b63 35 @upgraded Dr Edmond Nurellari, University of Lincoln
eencae 0:649b59b2fb26 36
eencae 0:649b59b2fb26 37 Example:
eencae 0:649b59b2fb26 38
eencae 0:649b59b2fb26 39 @code
eencae 0:649b59b2fb26 40
eencae 0:649b59b2fb26 41 #include "mbed.h"
eencae 0:649b59b2fb26 42 #include "Joystick.h"
eencae 0:649b59b2fb26 43
eencae 0:649b59b2fb26 44 // y x button
eencae 0:649b59b2fb26 45 Joystick joystick(PTB10,PTB11,PTC16);
eencae 0:649b59b2fb26 46
eencae 0:649b59b2fb26 47 int main() {
eencae 0:649b59b2fb26 48
eencae 0:649b59b2fb26 49 joystick.init();
eencae 0:649b59b2fb26 50
eencae 0:649b59b2fb26 51 while(1) {
eencae 0:649b59b2fb26 52
eencae 0:649b59b2fb26 53 Vector2D coord = joystick.get_coord();
eencae 0:649b59b2fb26 54 printf("Coord = %f,%f\n",coord.x,coord.y);
eencae 0:649b59b2fb26 55
eencae 0:649b59b2fb26 56 Vector2D mapped_coord = joystick.get_mapped_coord();
eencae 0:649b59b2fb26 57 printf("Mapped coord = %f,%f\n",mapped_coord.x,mapped_coord.y);
eencae 0:649b59b2fb26 58
eencae 0:649b59b2fb26 59 float mag = joystick.get_mag();
eencae 0:649b59b2fb26 60 float angle = joystick.get_angle();
eencae 0:649b59b2fb26 61 printf("Mag = %f Angle = %f\n",mag,angle);
eencae 0:649b59b2fb26 62
eencae 0:649b59b2fb26 63 Direction d = joystick.get_direction();
eencae 0:649b59b2fb26 64 printf("Direction = %i\n",d);
eencae 0:649b59b2fb26 65
eencae 0:649b59b2fb26 66 if (joystick.button_pressed() ) {
eencae 0:649b59b2fb26 67 printf("Button Pressed\n");
eencae 0:649b59b2fb26 68 }
eencae 0:649b59b2fb26 69
eencae 0:649b59b2fb26 70 wait(0.5);
eencae 0:649b59b2fb26 71 }
eencae 0:649b59b2fb26 72
eencae 0:649b59b2fb26 73
eencae 0:649b59b2fb26 74 }
eencae 0:649b59b2fb26 75
eencae 0:649b59b2fb26 76 * @endcode
eencae 0:649b59b2fb26 77 */
eencae 0:649b59b2fb26 78 class Joystick
eencae 0:649b59b2fb26 79 {
eencae 0:649b59b2fb26 80 public:
eencae 0:649b59b2fb26 81
eencae 0:649b59b2fb26 82 // y-pot x-pot button
eencae 0:649b59b2fb26 83 Joystick(PinName vertPin,PinName horizPin,PinName clickPin);
eencae 0:649b59b2fb26 84
eencae 0:649b59b2fb26 85 void init(); // needs to be called at start with joystick centred
eencae 0:649b59b2fb26 86 float get_mag(); // polar
eencae 0:649b59b2fb26 87 float get_angle(); // polar
eencae 0:649b59b2fb26 88 Vector2D get_coord(); // cartesian co-ordinates x,y
eencae 0:649b59b2fb26 89 Vector2D get_mapped_coord(); // x,y mapped to circle
eencae 0:649b59b2fb26 90 Direction get_direction(); // N,NE,E,SE etc.
eencae 0:649b59b2fb26 91 Polar get_polar(); // mag and angle in struct form
eencae 0:649b59b2fb26 92 bool button_pressed(); // read button flag set in ISR when button pressed
eencae 0:649b59b2fb26 93
eencae 0:649b59b2fb26 94 private:
eencae 0:649b59b2fb26 95
eencae 0:649b59b2fb26 96 AnalogIn *vert;
eencae 0:649b59b2fb26 97 AnalogIn *horiz;
eencae 0:649b59b2fb26 98 InterruptIn *click;
eencae 0:649b59b2fb26 99
eencae 0:649b59b2fb26 100 int _click_flag; // flag set in ISR
eencae 0:649b59b2fb26 101 void click_isr(); // ISR on button press
eencae 0:649b59b2fb26 102
eencae 0:649b59b2fb26 103 // centred x,y values
eencae 0:649b59b2fb26 104 float _x0;
eencae 0:649b59b2fb26 105 float _y0;
eencae 0:649b59b2fb26 106
eencae 0:649b59b2fb26 107 };
eencae 0:649b59b2fb26 108
eencae 0:649b59b2fb26 109 #endif