Mike Moore / Mbed 2 deprecated RTOS_HW_04

RTOS homework 4

Dependencies:   C12832_lcd mbed

main.cpp@9:ea97a69b9b93, 2013-08-18 (annotated)

Committer:
gatedClock
Date:
Sun Aug 18 17:05:30 2013 +0000
Revision:
9:ea97a69b9b93
Parent:
8:95f4f470ae28
Child:
10:4f2fa66cc430
mutex not completely effective for debounce.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
gatedClock 0:1013288b8e43 1 /*----------------------------------------------//------------------------------
gatedClock 0:1013288b8e43 2 student : m-moore
gatedClock 0:1013288b8e43 3 class : rtos
gatedClock 1:5f41e2df0e85 4 directory : RTOS_HW_04
gatedClock 0:1013288b8e43 5 file : main.cpp
gatedClock 0:1013288b8e43 6 ----description---------------------------------//------------------------------
gatedClock 0:1013288b8e43 7 Joystick-Controlled Metronome
gatedClock 0:1013288b8e43 8
gatedClock 0:1013288b8e43 9 features:
gatedClock 0:1013288b8e43 10 1. post-initialization functionality all timer-driven.
gatedClock 0:1013288b8e43 11 2. IRSs contain no blocking functions.
gatedClock 0:1013288b8e43 12 3. LED shows the metronome beat.
gatedClock 0:1013288b8e43 13 4. metronome speed controlled with up/down joystick.
gatedClock 0:1013288b8e43 14 5. rate-of-speed-change depends on how long the up/down has been active.
gatedClock 0:1013288b8e43 15 6. Beat-Per-Minute (BPM) shown on LCD display.
gatedClock 0:1013288b8e43 16
gatedClock 0:1013288b8e43 17 controls:
gatedClock 0:1013288b8e43 18 1. joystick-up - increase metronome rate.
gatedClock 0:1013288b8e43 19 2. joystick-down - decrease metronome rate.
gatedClock 0:1013288b8e43 20 3. joystick-center - set metronome to 60BPM.
gatedClock 0:1013288b8e43 21
gatedClock 0:1013288b8e43 22 notes:
gatedClock 0:1013288b8e43 23
gatedClock 0:1013288b8e43 24 testing:
gatedClock 0:1013288b8e43 25 1. confirm ease of being able to adjust one BPM rate with joystick up/down.
gatedClock 0:1013288b8e43 26 2. confirm three joystick up/down change rates, if keeping the stick pressed.
gatedClock 0:1013288b8e43 27 3. confirm max/min BPS saturation & display.
gatedClock 0:1013288b8e43 28 4. confirm joystick up/down control works to change display & LED BPM.
gatedClock 0:1013288b8e43 29 5. confirm joystick center-press sets rate to 60BPM immediately.
gatedClock 0:1013288b8e43 30 6. confirm long-test does not result in a crash.
gatedClock 0:1013288b8e43 31 -> all items confirmed.
gatedClock 0:1013288b8e43 32
gatedClock 0:1013288b8e43 33 -----includes-----------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 34 #include "mbed.h" // mbed class.
gatedClock 0:1013288b8e43 35 #include "C12832_lcd.h" // LCD class.
gatedClock 0:1013288b8e43 36 //---defines------------------------------------//------------------------------
gatedClock 0:1013288b8e43 37 #define LCD1 lcd.locate(0, 0); // LCD line 1.
gatedClock 0:1013288b8e43 38 #define LCD2 lcd.locate(0,11); // LCD line 2.
gatedClock 0:1013288b8e43 39 #define LCD3 lcd.locate(0,22); // LCD line 3.
gatedClock 7:562f136c7681 40
gatedClock 0:1013288b8e43 41 #define METROMAX 800 // max. beats per minute.
gatedClock 0:1013288b8e43 42 #define METROMIN 8 // min. beats per minute.
gatedClock 0:1013288b8e43 43 #define UDSAMPLERATE 0.1 // how often to sample U/D joystick.
gatedClock 0:1013288b8e43 44 #define LCDSAMPLERATE 0.1 // how often to redraw the LCD.
gatedClock 0:1013288b8e43 45 #define PULSELENGTH 0.0625 // how long the LED-on-time is.
gatedClock 0:1013288b8e43 46 //--global_definitions--------------------------//------------------------------
gatedClock 0:1013288b8e43 47 //--global_variables----------------------------//------------------------------
gatedClock 0:1013288b8e43 48 float fMetroDelay; // time between ticks, in seconds.
gatedClock 0:1013288b8e43 49 float fMetroDuty; // duration of metro high, in seconds.
gatedClock 0:1013288b8e43 50 int dMetroBPM; // master parameter.
gatedClock 0:1013288b8e43 51 long lUpDownHowMany; // count how long up/down joystick pressed.
gatedClock 9:ea97a69b9b93 52 char cMutex; // debounce mutex.
gatedClock 0:1013288b8e43 53 //--global_instances----------------------------//------------------------------
gatedClock 0:1013288b8e43 54 C12832_LCD lcd; // LCD object.
gatedClock 0:1013288b8e43 55
gatedClock 7:562f136c7681 56 InterruptIn iJoyStickUp (p15); // joystick up rising edge.
gatedClock 7:562f136c7681 57 InterruptIn iJoyStickDown (p12); // joystick down rising edge.
gatedClock 7:562f136c7681 58 InterruptIn iJoyStickLeft (p13); // joystick left rising edge.
gatedClock 7:562f136c7681 59 InterruptIn iJoyStickRight (p16); // joystick right rising edge.
gatedClock 7:562f136c7681 60 InterruptIn iJoyStickCenter(p14); // 1 if joystick middle pressed.
gatedClock 3:8ff0c9c853be 61
gatedClock 8:95f4f470ae28 62 DigitalIn dJoyStickUp (p15); // joystick up sample.
gatedClock 8:95f4f470ae28 63 DigitalIn dJoyStickDown (p12); // joystick down sample.
gatedClock 8:95f4f470ae28 64 DigitalIn dJoyStickLeft (p13); // joystick left sample.
gatedClock 8:95f4f470ae28 65 DigitalIn dJoyStickRight (p16); // joystick right sample.
gatedClock 8:95f4f470ae28 66 DigitalIn dJoyStickCenter(p14); // joystick center sample.
gatedClock 0:1013288b8e43 67
gatedClock 0:1013288b8e43 68 DigitalOut led3(LED1); // leftmost LED.
gatedClock 0:1013288b8e43 69
gatedClock 0:1013288b8e43 70 Ticker tickerMetronome; // blinking LED.
gatedClock 0:1013288b8e43 71 Ticker tickerJoystickUD; // joystick up/down sample.
gatedClock 0:1013288b8e43 72 Ticker tickerLCD; // display ticker.
gatedClock 0:1013288b8e43 73 Timeout timeoutDutyCycle; // LED duty cycle delay.
gatedClock 0:1013288b8e43 74 //-------prototypes-----------------------------//------------------------------
gatedClock 0:1013288b8e43 75 void initialization(); // initialize settings.
gatedClock 0:1013288b8e43 76 void lcd_display(); // display on LCD.
gatedClock 0:1013288b8e43 77 void interrupt_service_M(); // metronome tick.
gatedClock 0:1013288b8e43 78 void interrupt_service_UD(); // joystick up/down sample.
gatedClock 0:1013288b8e43 79 void led3_off(); // attachable LED control.
gatedClock 0:1013288b8e43 80 void led3_on(); // attachable LED control.
gatedClock 1:5f41e2df0e85 81 void ISR_up();
gatedClock 1:5f41e2df0e85 82 void ISR_down();
gatedClock 1:5f41e2df0e85 83 void ISR_right();
gatedClock 1:5f41e2df0e85 84 void ISR_left();
gatedClock 1:5f41e2df0e85 85 void ISR_center();
gatedClock 0:1013288b8e43 86 //==============================================//==============================
gatedClock 0:1013288b8e43 87 int main(void)
gatedClock 0:1013288b8e43 88 {
gatedClock 3:8ff0c9c853be 89 iJoyStickUp.rise(&ISR_up);
gatedClock 5:faa6d8a04501 90 iJoyStickDown.rise(&ISR_down);
gatedClock 5:faa6d8a04501 91 iJoyStickLeft.rise(&ISR_left);
gatedClock 5:faa6d8a04501 92 iJoyStickRight.rise(&ISR_right);
gatedClock 5:faa6d8a04501 93 iJoyStickCenter.rise(&ISR_center);
gatedClock 6:bb5f989e3425 94
gatedClock 6:bb5f989e3425 95 initialization();
gatedClock 6:bb5f989e3425 96
gatedClock 6:bb5f989e3425 97 // metronome ticker.
gatedClock 6:bb5f989e3425 98 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 6:bb5f989e3425 99
gatedClock 6:bb5f989e3425 100 // LCD ticker.
gatedClock 6:bb5f989e3425 101 tickerLCD.attach(&lcd_display,LCDSAMPLERATE);
gatedClock 6:bb5f989e3425 102
gatedClock 6:bb5f989e3425 103 while(1)
gatedClock 6:bb5f989e3425 104 {
gatedClock 6:bb5f989e3425 105
gatedClock 6:bb5f989e3425 106 wait(10.0);
gatedClock 6:bb5f989e3425 107 }
gatedClock 2:1a3acbc4d799 108
gatedClock 0:1013288b8e43 109 }
gatedClock 0:1013288b8e43 110 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 111 void initialization(void) // program initializations.
gatedClock 0:1013288b8e43 112 {
gatedClock 0:1013288b8e43 113 dMetroBPM = 60; // initialize to 60BPM.
gatedClock 0:1013288b8e43 114 fMetroDelay = 60.0 / (float) (dMetroBPM);
gatedClock 0:1013288b8e43 115 fMetroDuty = PULSELENGTH; // initialize LED on-duration.
gatedClock 0:1013288b8e43 116 lUpDownHowMany = 0;
gatedClock 9:ea97a69b9b93 117 cMutex = 1;
gatedClock 0:1013288b8e43 118 }
gatedClock 0:1013288b8e43 119 /*----------------------------------------------//----------------------------*/
gatedClock 8:95f4f470ae28 120 void ISR_left(void) // increase BPM.
gatedClock 1:5f41e2df0e85 121 {
gatedClock 9:ea97a69b9b93 122 if (cMutex) // grab the mutex.
gatedClock 9:ea97a69b9b93 123 {
gatedClock 9:ea97a69b9b93 124 cMutex = 0; // disqualify any bounce.
gatedClock 9:ea97a69b9b93 125
gatedClock 9:ea97a69b9b93 126 dMetroBPM++; // increase BPM.
gatedClock 4:67d958cc00e8 127
gatedClock 9:ea97a69b9b93 128 // saturate metronome BPM.
gatedClock 9:ea97a69b9b93 129 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 9:ea97a69b9b93 130 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 9:ea97a69b9b93 131
gatedClock 9:ea97a69b9b93 132 wait(0.01); // debounce time.
gatedClock 9:ea97a69b9b93 133
gatedClock 9:ea97a69b9b93 134 cMutex = 1; // allow critical section.
gatedClock 9:ea97a69b9b93 135 }
gatedClock 1:5f41e2df0e85 136 }
gatedClock 1:5f41e2df0e85 137 /*----------------------------------------------//----------------------------*/
gatedClock 9:ea97a69b9b93 138 // using a mutex to squelch this ISR from getting hammered
gatedClock 9:ea97a69b9b93 139 // by switch bounce. but: could a bounce interrupt sneak in between
gatedClock 9:ea97a69b9b93 140 // the 'if mutex' and 'mutex = 0' statements?
gatedClock 9:ea97a69b9b93 141 void ISR_right(void) // decrease BPM.
gatedClock 4:67d958cc00e8 142 {
gatedClock 9:ea97a69b9b93 143 if (cMutex) // grab the mutex.
gatedClock 9:ea97a69b9b93 144 {
gatedClock 9:ea97a69b9b93 145 cMutex = 0; // disqualify any bounce.
gatedClock 9:ea97a69b9b93 146
gatedClock 9:ea97a69b9b93 147 dMetroBPM--; // decrease BPM.
gatedClock 4:67d958cc00e8 148
gatedClock 9:ea97a69b9b93 149 // saturate metronome BPM.
gatedClock 9:ea97a69b9b93 150 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 9:ea97a69b9b93 151 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 9:ea97a69b9b93 152
gatedClock 9:ea97a69b9b93 153 wait(0.01); // debounce time.
gatedClock 9:ea97a69b9b93 154
gatedClock 9:ea97a69b9b93 155 cMutex = 1; // allow critical section.
gatedClock 9:ea97a69b9b93 156 }
gatedClock 4:67d958cc00e8 157 }
gatedClock 4:67d958cc00e8 158 /*----------------------------------------------//----------------------------*/
gatedClock 4:67d958cc00e8 159 void ISR_up(void)
gatedClock 1:5f41e2df0e85 160 {
gatedClock 1:5f41e2df0e85 161 }
gatedClock 1:5f41e2df0e85 162 /*----------------------------------------------//----------------------------*/
gatedClock 4:67d958cc00e8 163 void ISR_down(void)
gatedClock 1:5f41e2df0e85 164 {
gatedClock 1:5f41e2df0e85 165 }
gatedClock 1:5f41e2df0e85 166 /*----------------------------------------------//----------------------------*/
gatedClock 3:8ff0c9c853be 167 void ISR_center(void) // set BPM = 60.
gatedClock 1:5f41e2df0e85 168 {
gatedClock 8:95f4f470ae28 169 dMetroBPM = 60;
gatedClock 4:67d958cc00e8 170
gatedClock 1:5f41e2df0e85 171 }
gatedClock 1:5f41e2df0e85 172 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 173 void lcd_display(void) // display metronome info.
gatedClock 0:1013288b8e43 174 {
gatedClock 0:1013288b8e43 175 lcd.cls(); // clear display.
gatedClock 0:1013288b8e43 176
gatedClock 0:1013288b8e43 177 LCD1; // line 1.
gatedClock 0:1013288b8e43 178 lcd.printf(" METRONOME");
gatedClock 0:1013288b8e43 179
gatedClock 0:1013288b8e43 180 LCD2; // line 2.
gatedClock 0:1013288b8e43 181
gatedClock 0:1013288b8e43 182 if (dMetroBPM == METROMIN) // BPM, with saturation notification.
gatedClock 0:1013288b8e43 183 lcd.printf(" %5.2d BPM minimum",dMetroBPM);
gatedClock 0:1013288b8e43 184 else
gatedClock 0:1013288b8e43 185 if (dMetroBPM == METROMAX)
gatedClock 0:1013288b8e43 186 lcd.printf(" %5.2d BPM maximum",dMetroBPM);
gatedClock 0:1013288b8e43 187 else
gatedClock 0:1013288b8e43 188 lcd.printf(" %5.2d BPM",dMetroBPM);
gatedClock 0:1013288b8e43 189
gatedClock 0:1013288b8e43 190 LCD3; // line 3.
gatedClock 0:1013288b8e43 191
gatedClock 8:95f4f470ae28 192 lcd.printf(" RTOS HW 4");
gatedClock 0:1013288b8e43 193 }
gatedClock 0:1013288b8e43 194 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 195 // this metronome tick ISR will self-adjust to the current user-selected
gatedClock 0:1013288b8e43 196 // metronome rate. that has to be done here, and at the start of the function,
gatedClock 0:1013288b8e43 197 // in order to maintain a constant phase and to prevent a beat-skip.
gatedClock 0:1013288b8e43 198
gatedClock 0:1013288b8e43 199 void interrupt_service_M() // metronome tick.
gatedClock 0:1013288b8e43 200 {
gatedClock 0:1013288b8e43 201 tickerMetronome.detach(); // only one attachment.
gatedClock 0:1013288b8e43 202 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 0:1013288b8e43 203 led3 = 1;
gatedClock 0:1013288b8e43 204 timeoutDutyCycle.attach(&led3_off,fMetroDuty);
gatedClock 0:1013288b8e43 205 }
gatedClock 0:1013288b8e43 206 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 207 // this routine measures the number of seconds for which the joystick is
gatedClock 0:1013288b8e43 208 // in the up or down position. for three ranges of time, three different
gatedClock 0:1013288b8e43 209 // BPM rates-of-change are used. This means that as the user controls the
gatedClock 0:1013288b8e43 210 // metronome rate using the joystick, at first it will change slowly, then
gatedClock 0:1013288b8e43 211 // it will change at a moderate speed, then it will change quickly.
gatedClock 0:1013288b8e43 212 // additionally, pressing the center joystick button will bring the metronome
gatedClock 0:1013288b8e43 213 // back to 60BPM immediately, breaking BPM phase continuity.
gatedClock 0:1013288b8e43 214 void interrupt_service_UD(void) // joystick up/down sample
gatedClock 0:1013288b8e43 215 {
gatedClock 0:1013288b8e43 216 int dPressedSeconds; // how many seconds joystick pressed.
gatedClock 0:1013288b8e43 217 int dMultiCount; // slow count rate.
gatedClock 0:1013288b8e43 218 char cDiscontinuity; // 1 = break phase & change BPM now.
gatedClock 0:1013288b8e43 219
gatedClock 0:1013288b8e43 220 cDiscontinuity = 0; // don't break phase.
gatedClock 0:1013288b8e43 221
gatedClock 0:1013288b8e43 222 // calculate slow rate period.
gatedClock 0:1013288b8e43 223 dMultiCount = (int) ((float) (1.0 / ((float) UDSAMPLERATE)));
gatedClock 0:1013288b8e43 224
gatedClock 3:8ff0c9c853be 225 if (dJoyStickUp) // joystick up.
gatedClock 0:1013288b8e43 226 {
gatedClock 0:1013288b8e43 227 // rate-range calculations.
gatedClock 0:1013288b8e43 228 dPressedSeconds = (int) (((float) lUpDownHowMany) * UDSAMPLERATE);
gatedClock 0:1013288b8e43 229 if (dPressedSeconds < 5) {if (!(lUpDownHowMany % dMultiCount)) dMetroBPM ++;}
gatedClock 0:1013288b8e43 230 else
gatedClock 0:1013288b8e43 231 if (dPressedSeconds < 10) dMetroBPM++;
gatedClock 0:1013288b8e43 232 else dMetroBPM += 5;
gatedClock 0:1013288b8e43 233 lUpDownHowMany++; // joystick holddown time.
gatedClock 0:1013288b8e43 234 }
gatedClock 0:1013288b8e43 235 else
gatedClock 3:8ff0c9c853be 236 if (dJoyStickDown) // joystick down.
gatedClock 0:1013288b8e43 237 {
gatedClock 0:1013288b8e43 238 // rate-range calculations.
gatedClock 0:1013288b8e43 239 dPressedSeconds = (int) (((float) lUpDownHowMany) * UDSAMPLERATE);
gatedClock 0:1013288b8e43 240 if (dPressedSeconds < 5) {if (!(lUpDownHowMany % dMultiCount)) dMetroBPM --;}
gatedClock 0:1013288b8e43 241 else
gatedClock 0:1013288b8e43 242 if (dPressedSeconds < 10) dMetroBPM--;
gatedClock 0:1013288b8e43 243 else dMetroBPM -= 5;
gatedClock 0:1013288b8e43 244 lUpDownHowMany++; // joystick holddown time.
gatedClock 0:1013288b8e43 245 }
gatedClock 0:1013288b8e43 246 else lUpDownHowMany = 0; // clear when not up or down.
gatedClock 0:1013288b8e43 247
gatedClock 3:8ff0c9c853be 248 if (dJoyStickCenter)
gatedClock 0:1013288b8e43 249 {
gatedClock 0:1013288b8e43 250 dMetroBPM = 60; // center-button -> 60BPM.
gatedClock 0:1013288b8e43 251 cDiscontinuity = 1; // pending phase-break.
gatedClock 0:1013288b8e43 252 }
gatedClock 0:1013288b8e43 253 // saturate metronome BPM.
gatedClock 0:1013288b8e43 254 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 0:1013288b8e43 255 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 0:1013288b8e43 256
gatedClock 0:1013288b8e43 257 fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time.
gatedClock 0:1013288b8e43 258
gatedClock 0:1013288b8e43 259 if (cDiscontinuity) // implement 60BPS now.
gatedClock 0:1013288b8e43 260 {
gatedClock 0:1013288b8e43 261 tickerMetronome.detach(); // only one attachment.
gatedClock 0:1013288b8e43 262 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 0:1013288b8e43 263 }
gatedClock 0:1013288b8e43 264
gatedClock 0:1013288b8e43 265 }
gatedClock 0:1013288b8e43 266 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 267 void led3_off(void) {led3 = 0;} // turn off the LED.
gatedClock 0:1013288b8e43 268 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 269 void led3_on( void) {led3 = 1;} // turn on the led.
gatedClock 0:1013288b8e43 270 /*----------------------------------------------//----------------------------*/