(DA) Internet of Things and Smart Electronics- ELE3006M2122 / Mbed 2 deprecated IOTProject_LC1

legionella detector

Dependencies:   mbed

Joystick/Joystick.cpp@0:089b4c4f2b6f, 23 months ago (annotated)

Committer:
lewiscameron
Date:
Tue Aug 23 08:47:11 2022 +0000
Revision:
0:089b4c4f2b6f
h

Who changed what in which revision?

UserRevisionLine numberNew contents of line
lewiscameron 0:089b4c4f2b6f 1 #include "Joystick.h"
lewiscameron 0:089b4c4f2b6f 2
lewiscameron 0:089b4c4f2b6f 3 Joystick::Joystick(PinName vertPin,PinName horizPin,PinName clickPin)
lewiscameron 0:089b4c4f2b6f 4 {
lewiscameron 0:089b4c4f2b6f 5 vert = new AnalogIn(vertPin);
lewiscameron 0:089b4c4f2b6f 6 horiz = new AnalogIn(horizPin);
lewiscameron 0:089b4c4f2b6f 7 click = new InterruptIn(clickPin);
lewiscameron 0:089b4c4f2b6f 8 }
lewiscameron 0:089b4c4f2b6f 9
lewiscameron 0:089b4c4f2b6f 10 void Joystick::init()
lewiscameron 0:089b4c4f2b6f 11 {
lewiscameron 0:089b4c4f2b6f 12 // read centred values of joystick
lewiscameron 0:089b4c4f2b6f 13 _x0 = horiz->read();
lewiscameron 0:089b4c4f2b6f 14 _y0 = vert->read();
lewiscameron 0:089b4c4f2b6f 15
lewiscameron 0:089b4c4f2b6f 16 // this assumes that the joystick is centred when the init function is called
lewiscameron 0:089b4c4f2b6f 17 // if perfectly centred, the pots should read 0.5, but this may
lewiscameron 0:089b4c4f2b6f 18 // not be the case and x0 and y0 will be used to calibrate readings
lewiscameron 0:089b4c4f2b6f 19
lewiscameron 0:089b4c4f2b6f 20 // turn on pull-down for button -> this assumes the other side of the button
lewiscameron 0:089b4c4f2b6f 21 // is connected to +3V3 so we read 1 when pressed and 0 when not pressed
lewiscameron 0:089b4c4f2b6f 22 click->mode(PullDown);
lewiscameron 0:089b4c4f2b6f 23 // we therefore need to fire the interrupt on a rising edge
lewiscameron 0:089b4c4f2b6f 24 click->rise(this,&Joystick::click_isr);
lewiscameron 0:089b4c4f2b6f 25 // need to use a callback since mbed-os5 - basically tells it to look in this class for the ISR
lewiscameron 0:089b4c4f2b6f 26 _click_flag = 0;
lewiscameron 0:089b4c4f2b6f 27
lewiscameron 0:089b4c4f2b6f 28 }
lewiscameron 0:089b4c4f2b6f 29
lewiscameron 0:089b4c4f2b6f 30 Direction Joystick::get_direction()
lewiscameron 0:089b4c4f2b6f 31 {
lewiscameron 0:089b4c4f2b6f 32 float angle = get_angle(); // 0 to 360, -1 for centred
lewiscameron 0:089b4c4f2b6f 33
lewiscameron 0:089b4c4f2b6f 34 Direction d;
lewiscameron 0:089b4c4f2b6f 35 // partition 360 into segments and check which segment the angle is in
lewiscameron 0:089b4c4f2b6f 36 if (angle < 0.0f) {
lewiscameron 0:089b4c4f2b6f 37 d = CENTRE; // check for -1.0 angle
lewiscameron 0:089b4c4f2b6f 38 } else if (angle < 22.5f) { // then keep going in 45 degree increments
lewiscameron 0:089b4c4f2b6f 39 d = N;
lewiscameron 0:089b4c4f2b6f 40 } else if (angle < 67.5f) {
lewiscameron 0:089b4c4f2b6f 41 d = NE;
lewiscameron 0:089b4c4f2b6f 42 } else if (angle < 112.5f) {
lewiscameron 0:089b4c4f2b6f 43 d = E;
lewiscameron 0:089b4c4f2b6f 44 } else if (angle < 157.5f) {
lewiscameron 0:089b4c4f2b6f 45 d = SE;
lewiscameron 0:089b4c4f2b6f 46 } else if (angle < 202.5f) {
lewiscameron 0:089b4c4f2b6f 47 d = S;
lewiscameron 0:089b4c4f2b6f 48 } else if (angle < 247.5f) {
lewiscameron 0:089b4c4f2b6f 49 d = SW;
lewiscameron 0:089b4c4f2b6f 50 } else if (angle < 292.5f) {
lewiscameron 0:089b4c4f2b6f 51 d = W;
lewiscameron 0:089b4c4f2b6f 52 } else if (angle < 337.5f) {
lewiscameron 0:089b4c4f2b6f 53 d = NW;
lewiscameron 0:089b4c4f2b6f 54 } else {
lewiscameron 0:089b4c4f2b6f 55 d = N;
lewiscameron 0:089b4c4f2b6f 56 }
lewiscameron 0:089b4c4f2b6f 57
lewiscameron 0:089b4c4f2b6f 58 return d;
lewiscameron 0:089b4c4f2b6f 59 }
lewiscameron 0:089b4c4f2b6f 60
lewiscameron 0:089b4c4f2b6f 61 // this method gets the magnitude of the joystick movement
lewiscameron 0:089b4c4f2b6f 62 float Joystick::get_mag()
lewiscameron 0:089b4c4f2b6f 63 {
lewiscameron 0:089b4c4f2b6f 64 Polar p = get_polar();
lewiscameron 0:089b4c4f2b6f 65 return p.mag;
lewiscameron 0:089b4c4f2b6f 66 }
lewiscameron 0:089b4c4f2b6f 67
lewiscameron 0:089b4c4f2b6f 68 // this method gets the angle of joystick movement (0 to 360, 0 North)
lewiscameron 0:089b4c4f2b6f 69 float Joystick::get_angle()
lewiscameron 0:089b4c4f2b6f 70 {
lewiscameron 0:089b4c4f2b6f 71 Polar p = get_polar();
lewiscameron 0:089b4c4f2b6f 72 return p.angle;
lewiscameron 0:089b4c4f2b6f 73 }
lewiscameron 0:089b4c4f2b6f 74
lewiscameron 0:089b4c4f2b6f 75 // get raw joystick coordinate in range -1 to 1
lewiscameron 0:089b4c4f2b6f 76 // Direction (x,y)
lewiscameron 0:089b4c4f2b6f 77 // North (0,1)
lewiscameron 0:089b4c4f2b6f 78 // East (1,0)
lewiscameron 0:089b4c4f2b6f 79 // South (0,-1)
lewiscameron 0:089b4c4f2b6f 80 // West (-1,0)
lewiscameron 0:089b4c4f2b6f 81 Vector2D Joystick::get_coord()
lewiscameron 0:089b4c4f2b6f 82 {
lewiscameron 0:089b4c4f2b6f 83 // read() returns value in range 0.0 to 1.0 so is scaled and centre value
lewiscameron 0:089b4c4f2b6f 84 // substracted to get values in the range -1.0 to 1.0
lewiscameron 0:089b4c4f2b6f 85 float x = 2.0f*( horiz->read() - _x0 );
lewiscameron 0:089b4c4f2b6f 86 float y = 2.0f*( vert->read() - _y0 );
lewiscameron 0:089b4c4f2b6f 87
lewiscameron 0:089b4c4f2b6f 88 // Note: the x value here is inverted to ensure the positive x is to the
lewiscameron 0:089b4c4f2b6f 89 // right. This is simply due to how the potentiometer on the joystick
lewiscameron 0:089b4c4f2b6f 90 // I was using was connected up. It could have been corrected in hardware
lewiscameron 0:089b4c4f2b6f 91 // by swapping the power supply pins. Instead it is done in software so may
lewiscameron 0:089b4c4f2b6f 92 // need to be changed depending on your wiring setup
lewiscameron 0:089b4c4f2b6f 93
lewiscameron 0:089b4c4f2b6f 94 Vector2D coord = {-x,y};
lewiscameron 0:089b4c4f2b6f 95 return coord;
lewiscameron 0:089b4c4f2b6f 96 }
lewiscameron 0:089b4c4f2b6f 97
lewiscameron 0:089b4c4f2b6f 98 // This maps the raw x,y coord onto a circular grid.
lewiscameron 0:089b4c4f2b6f 99 // See: http://mathproofs.blogspot.co.uk/2005/07/mapping-square-to-circle.html
lewiscameron 0:089b4c4f2b6f 100 Vector2D Joystick::get_mapped_coord()
lewiscameron 0:089b4c4f2b6f 101 {
lewiscameron 0:089b4c4f2b6f 102 Vector2D coord = get_coord();
lewiscameron 0:089b4c4f2b6f 103
lewiscameron 0:089b4c4f2b6f 104 // do the transformation
lewiscameron 0:089b4c4f2b6f 105 float x = coord.x*sqrt(1.0f-pow(coord.y,2.0f)/2.0f);
lewiscameron 0:089b4c4f2b6f 106 float y = coord.y*sqrt(1.0f-pow(coord.x,2.0f)/2.0f);
lewiscameron 0:089b4c4f2b6f 107
lewiscameron 0:089b4c4f2b6f 108 Vector2D mapped_coord = {x,y};
lewiscameron 0:089b4c4f2b6f 109 return mapped_coord;
lewiscameron 0:089b4c4f2b6f 110 }
lewiscameron 0:089b4c4f2b6f 111
lewiscameron 0:089b4c4f2b6f 112 // this function converts the mapped coordinates into polar form
lewiscameron 0:089b4c4f2b6f 113 Polar Joystick::get_polar()
lewiscameron 0:089b4c4f2b6f 114 {
lewiscameron 0:089b4c4f2b6f 115 // get the mapped coordinate
lewiscameron 0:089b4c4f2b6f 116 Vector2D coord = get_mapped_coord();
lewiscameron 0:089b4c4f2b6f 117
lewiscameron 0:089b4c4f2b6f 118 // at this point, 0 degrees (i.e. x-axis) will be defined to the East.
lewiscameron 0:089b4c4f2b6f 119 // We want 0 degrees to correspond to North and increase clockwise to 359
lewiscameron 0:089b4c4f2b6f 120 // like a compass heading, so we need to swap the axis and invert y
lewiscameron 0:089b4c4f2b6f 121 float x = coord.y;
lewiscameron 0:089b4c4f2b6f 122 float y = coord.x;
lewiscameron 0:089b4c4f2b6f 123
lewiscameron 0:089b4c4f2b6f 124 float mag = sqrt(x*x+y*y); // pythagoras
lewiscameron 0:089b4c4f2b6f 125 float angle = RAD2DEG*atan2(y,x);
lewiscameron 0:089b4c4f2b6f 126 // angle will be in range -180 to 180, so add 360 to negative angles to
lewiscameron 0:089b4c4f2b6f 127 // move to 0 to 360 range
lewiscameron 0:089b4c4f2b6f 128 if (angle < 0.0f) {
lewiscameron 0:089b4c4f2b6f 129 angle+=360.0f;
lewiscameron 0:089b4c4f2b6f 130 }
lewiscameron 0:089b4c4f2b6f 131
lewiscameron 0:089b4c4f2b6f 132 // the noise on the ADC causes the values of x and y to fluctuate slightly
lewiscameron 0:089b4c4f2b6f 133 // around the centred values. This causes the random angle values to get
lewiscameron 0:089b4c4f2b6f 134 // calculated when the joystick is centred and untouched. This is also when
lewiscameron 0:089b4c4f2b6f 135 // the magnitude is very small, so we can check for a small magnitude and then
lewiscameron 0:089b4c4f2b6f 136 // set the angle to -1. This will inform us when the angle is invalid and the
lewiscameron 0:089b4c4f2b6f 137 // joystick is centred
lewiscameron 0:089b4c4f2b6f 138
lewiscameron 0:089b4c4f2b6f 139 if (mag < TOL) {
lewiscameron 0:089b4c4f2b6f 140 mag = 0.0f;
lewiscameron 0:089b4c4f2b6f 141 angle = -1.0f;
lewiscameron 0:089b4c4f2b6f 142 }
lewiscameron 0:089b4c4f2b6f 143
lewiscameron 0:089b4c4f2b6f 144 Polar p = {mag,angle};
lewiscameron 0:089b4c4f2b6f 145 return p;
lewiscameron 0:089b4c4f2b6f 146 }
lewiscameron 0:089b4c4f2b6f 147
lewiscameron 0:089b4c4f2b6f 148 bool Joystick::button_pressed()
lewiscameron 0:089b4c4f2b6f 149 {
lewiscameron 0:089b4c4f2b6f 150 // ISR must have been triggered
lewiscameron 0:089b4c4f2b6f 151 if (_click_flag) {
lewiscameron 0:089b4c4f2b6f 152 _click_flag = 0; // clear flag
lewiscameron 0:089b4c4f2b6f 153 return true;
lewiscameron 0:089b4c4f2b6f 154 } else {
lewiscameron 0:089b4c4f2b6f 155 return false;
lewiscameron 0:089b4c4f2b6f 156 }
lewiscameron 0:089b4c4f2b6f 157 }
lewiscameron 0:089b4c4f2b6f 158
lewiscameron 0:089b4c4f2b6f 159 void Joystick::click_isr()
lewiscameron 0:089b4c4f2b6f 160 {
lewiscameron 0:089b4c4f2b6f 161 _click_flag = 1;
lewiscameron 0:089b4c4f2b6f 162 }