Mike Moore / Mbed 2 deprecated RTOS_HW_04

RTOS homework 4

Dependencies:   C12832_lcd mbed

main.cpp@11:e764ed79553a, 2013-08-18 (annotated)

Committer:
gatedClock
Date:
Sun Aug 18 17:40:11 2013 +0000
Revision:
11:e764ed79553a
Parent:
10:4f2fa66cc430
Child:
12:fab8e658ae76
BPM increase debounce looks ok.

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 10:4f2fa66cc430 46 #define DEBOUNCE 0.16 // debounce pause duration in S.
gatedClock 0:1013288b8e43 47 //--global_definitions--------------------------//------------------------------
gatedClock 0:1013288b8e43 48 //--global_variables----------------------------//------------------------------
gatedClock 0:1013288b8e43 49 float fMetroDelay; // time between ticks, in seconds.
gatedClock 0:1013288b8e43 50 float fMetroDuty; // duration of metro high, in seconds.
gatedClock 0:1013288b8e43 51 int dMetroBPM; // master parameter.
gatedClock 0:1013288b8e43 52 long lUpDownHowMany; // count how long up/down joystick pressed.
gatedClock 9:ea97a69b9b93 53 char cMutex; // debounce mutex.
gatedClock 0:1013288b8e43 54 //--global_instances----------------------------//------------------------------
gatedClock 0:1013288b8e43 55 C12832_LCD lcd; // LCD object.
gatedClock 0:1013288b8e43 56
gatedClock 7:562f136c7681 57 InterruptIn iJoyStickUp (p15); // joystick up rising edge.
gatedClock 7:562f136c7681 58 InterruptIn iJoyStickDown (p12); // joystick down rising edge.
gatedClock 7:562f136c7681 59 InterruptIn iJoyStickLeft (p13); // joystick left rising edge.
gatedClock 7:562f136c7681 60 InterruptIn iJoyStickRight (p16); // joystick right rising edge.
gatedClock 7:562f136c7681 61 InterruptIn iJoyStickCenter(p14); // 1 if joystick middle pressed.
gatedClock 3:8ff0c9c853be 62
gatedClock 8:95f4f470ae28 63 DigitalIn dJoyStickUp (p15); // joystick up sample.
gatedClock 8:95f4f470ae28 64 DigitalIn dJoyStickDown (p12); // joystick down sample.
gatedClock 8:95f4f470ae28 65 DigitalIn dJoyStickLeft (p13); // joystick left sample.
gatedClock 8:95f4f470ae28 66 DigitalIn dJoyStickRight (p16); // joystick right sample.
gatedClock 8:95f4f470ae28 67 DigitalIn dJoyStickCenter(p14); // joystick center sample.
gatedClock 0:1013288b8e43 68
gatedClock 0:1013288b8e43 69 DigitalOut led3(LED1); // leftmost LED.
gatedClock 0:1013288b8e43 70
gatedClock 0:1013288b8e43 71 Ticker tickerMetronome; // blinking LED.
gatedClock 0:1013288b8e43 72 Ticker tickerJoystickUD; // joystick up/down sample.
gatedClock 0:1013288b8e43 73 Ticker tickerLCD; // display ticker.
gatedClock 0:1013288b8e43 74 Timeout timeoutDutyCycle; // LED duty cycle delay.
gatedClock 0:1013288b8e43 75 //-------prototypes-----------------------------//------------------------------
gatedClock 0:1013288b8e43 76 void initialization(); // initialize settings.
gatedClock 0:1013288b8e43 77 void lcd_display(); // display on LCD.
gatedClock 0:1013288b8e43 78 void interrupt_service_M(); // metronome tick.
gatedClock 0:1013288b8e43 79 void interrupt_service_UD(); // joystick up/down sample.
gatedClock 0:1013288b8e43 80 void led3_off(); // attachable LED control.
gatedClock 0:1013288b8e43 81 void led3_on(); // attachable LED control.
gatedClock 1:5f41e2df0e85 82 void ISR_up();
gatedClock 1:5f41e2df0e85 83 void ISR_down();
gatedClock 10:4f2fa66cc430 84 void ISR_right_rising();
gatedClock 10:4f2fa66cc430 85 void ISR_right_falling();
gatedClock 11:e764ed79553a 86 void ISR_left_rising();
gatedClock 11:e764ed79553a 87 void ISR_left_falling();
gatedClock 1:5f41e2df0e85 88 void ISR_center();
gatedClock 0:1013288b8e43 89 //==============================================//==============================
gatedClock 0:1013288b8e43 90 int main(void)
gatedClock 0:1013288b8e43 91 {
gatedClock 3:8ff0c9c853be 92 iJoyStickUp.rise(&ISR_up);
gatedClock 5:faa6d8a04501 93 iJoyStickDown.rise(&ISR_down);
gatedClock 11:e764ed79553a 94
gatedClock 11:e764ed79553a 95 iJoyStickLeft.rise(&ISR_left_rising);
gatedClock 11:e764ed79553a 96 iJoyStickLeft.fall(&ISR_left_falling);
gatedClock 10:4f2fa66cc430 97
gatedClock 10:4f2fa66cc430 98 iJoyStickRight.rise(&ISR_right_rising);
gatedClock 10:4f2fa66cc430 99 iJoyStickRight.fall(&ISR_right_falling);
gatedClock 10:4f2fa66cc430 100
gatedClock 5:faa6d8a04501 101 iJoyStickCenter.rise(&ISR_center);
gatedClock 6:bb5f989e3425 102
gatedClock 6:bb5f989e3425 103 initialization();
gatedClock 6:bb5f989e3425 104
gatedClock 6:bb5f989e3425 105 // metronome ticker.
gatedClock 6:bb5f989e3425 106 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 6:bb5f989e3425 107
gatedClock 6:bb5f989e3425 108 // LCD ticker.
gatedClock 6:bb5f989e3425 109 tickerLCD.attach(&lcd_display,LCDSAMPLERATE);
gatedClock 6:bb5f989e3425 110
gatedClock 6:bb5f989e3425 111 while(1)
gatedClock 6:bb5f989e3425 112 {
gatedClock 6:bb5f989e3425 113
gatedClock 6:bb5f989e3425 114 wait(10.0);
gatedClock 6:bb5f989e3425 115 }
gatedClock 2:1a3acbc4d799 116
gatedClock 0:1013288b8e43 117 }
gatedClock 0:1013288b8e43 118 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 119 void initialization(void) // program initializations.
gatedClock 0:1013288b8e43 120 {
gatedClock 0:1013288b8e43 121 dMetroBPM = 60; // initialize to 60BPM.
gatedClock 0:1013288b8e43 122 fMetroDelay = 60.0 / (float) (dMetroBPM);
gatedClock 0:1013288b8e43 123 fMetroDuty = PULSELENGTH; // initialize LED on-duration.
gatedClock 0:1013288b8e43 124 lUpDownHowMany = 0;
gatedClock 9:ea97a69b9b93 125 cMutex = 1;
gatedClock 0:1013288b8e43 126 }
gatedClock 0:1013288b8e43 127 /*----------------------------------------------//----------------------------*/
gatedClock 11:e764ed79553a 128 void ISR_left_rising(void) // increase BPM.
gatedClock 1:5f41e2df0e85 129 {
gatedClock 11:e764ed79553a 130 __disable_irq();
gatedClock 11:e764ed79553a 131
gatedClock 11:e764ed79553a 132 dMetroBPM++; // increase BPM.
gatedClock 11:e764ed79553a 133
gatedClock 11:e764ed79553a 134 wait(DEBOUNCE); // debounce time.
gatedClock 11:e764ed79553a 135
gatedClock 11:e764ed79553a 136 __enable_irq();
gatedClock 4:67d958cc00e8 137
gatedClock 9:ea97a69b9b93 138 // saturate metronome BPM.
gatedClock 11:e764ed79553a 139 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 11:e764ed79553a 140 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 1:5f41e2df0e85 141 }
gatedClock 1:5f41e2df0e85 142 /*----------------------------------------------//----------------------------*/
gatedClock 11:e764ed79553a 143 void ISR_left_falling(void) // ignore rising after falling edge.
gatedClock 11:e764ed79553a 144 {
gatedClock 11:e764ed79553a 145 __disable_irq();
gatedClock 11:e764ed79553a 146
gatedClock 11:e764ed79553a 147 wait(DEBOUNCE); // debounce time.
gatedClock 11:e764ed79553a 148
gatedClock 11:e764ed79553a 149 __enable_irq();
gatedClock 11:e764ed79553a 150 }
gatedClock 11:e764ed79553a 151 /*----------------------------------------------//----------------------------*/
gatedClock 11:e764ed79553a 152
gatedClock 10:4f2fa66cc430 153 void ISR_right_rising(void) // decrease BPM.
gatedClock 4:67d958cc00e8 154 {
gatedClock 10:4f2fa66cc430 155 __disable_irq();
gatedClock 10:4f2fa66cc430 156
gatedClock 10:4f2fa66cc430 157 dMetroBPM--; // decrease BPM.
gatedClock 4:67d958cc00e8 158
gatedClock 10:4f2fa66cc430 159 wait(DEBOUNCE); // debounce time.
gatedClock 9:ea97a69b9b93 160
gatedClock 10:4f2fa66cc430 161 __enable_irq();
gatedClock 11:e764ed79553a 162 // saturate metronome BPM.
gatedClock 11:e764ed79553a 163 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 11:e764ed79553a 164 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 10:4f2fa66cc430 165 }
gatedClock 10:4f2fa66cc430 166 /*----------------------------------------------//----------------------------*/
gatedClock 10:4f2fa66cc430 167 void ISR_right_falling(void) // ignore rising after falling edge.
gatedClock 10:4f2fa66cc430 168 {
gatedClock 10:4f2fa66cc430 169 __disable_irq();
gatedClock 10:4f2fa66cc430 170
gatedClock 10:4f2fa66cc430 171 wait(DEBOUNCE); // debounce time.
gatedClock 10:4f2fa66cc430 172
gatedClock 10:4f2fa66cc430 173 __enable_irq();
gatedClock 4:67d958cc00e8 174 }
gatedClock 4:67d958cc00e8 175 /*----------------------------------------------//----------------------------*/
gatedClock 4:67d958cc00e8 176 void ISR_up(void)
gatedClock 1:5f41e2df0e85 177 {
gatedClock 1:5f41e2df0e85 178 }
gatedClock 1:5f41e2df0e85 179 /*----------------------------------------------//----------------------------*/
gatedClock 4:67d958cc00e8 180 void ISR_down(void)
gatedClock 1:5f41e2df0e85 181 {
gatedClock 1:5f41e2df0e85 182 }
gatedClock 1:5f41e2df0e85 183 /*----------------------------------------------//----------------------------*/
gatedClock 3:8ff0c9c853be 184 void ISR_center(void) // set BPM = 60.
gatedClock 1:5f41e2df0e85 185 {
gatedClock 8:95f4f470ae28 186 dMetroBPM = 60;
gatedClock 4:67d958cc00e8 187
gatedClock 1:5f41e2df0e85 188 }
gatedClock 1:5f41e2df0e85 189 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 190 void lcd_display(void) // display metronome info.
gatedClock 0:1013288b8e43 191 {
gatedClock 0:1013288b8e43 192 lcd.cls(); // clear display.
gatedClock 0:1013288b8e43 193
gatedClock 0:1013288b8e43 194 LCD1; // line 1.
gatedClock 0:1013288b8e43 195 lcd.printf(" METRONOME");
gatedClock 0:1013288b8e43 196
gatedClock 0:1013288b8e43 197 LCD2; // line 2.
gatedClock 0:1013288b8e43 198
gatedClock 0:1013288b8e43 199 if (dMetroBPM == METROMIN) // BPM, with saturation notification.
gatedClock 0:1013288b8e43 200 lcd.printf(" %5.2d BPM minimum",dMetroBPM);
gatedClock 0:1013288b8e43 201 else
gatedClock 0:1013288b8e43 202 if (dMetroBPM == METROMAX)
gatedClock 0:1013288b8e43 203 lcd.printf(" %5.2d BPM maximum",dMetroBPM);
gatedClock 0:1013288b8e43 204 else
gatedClock 0:1013288b8e43 205 lcd.printf(" %5.2d BPM",dMetroBPM);
gatedClock 0:1013288b8e43 206
gatedClock 0:1013288b8e43 207 LCD3; // line 3.
gatedClock 0:1013288b8e43 208
gatedClock 8:95f4f470ae28 209 lcd.printf(" RTOS HW 4");
gatedClock 0:1013288b8e43 210 }
gatedClock 0:1013288b8e43 211 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 212 // this metronome tick ISR will self-adjust to the current user-selected
gatedClock 0:1013288b8e43 213 // metronome rate. that has to be done here, and at the start of the function,
gatedClock 0:1013288b8e43 214 // in order to maintain a constant phase and to prevent a beat-skip.
gatedClock 0:1013288b8e43 215
gatedClock 0:1013288b8e43 216 void interrupt_service_M() // metronome tick.
gatedClock 0:1013288b8e43 217 {
gatedClock 0:1013288b8e43 218 tickerMetronome.detach(); // only one attachment.
gatedClock 0:1013288b8e43 219 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 0:1013288b8e43 220 led3 = 1;
gatedClock 0:1013288b8e43 221 timeoutDutyCycle.attach(&led3_off,fMetroDuty);
gatedClock 0:1013288b8e43 222 }
gatedClock 0:1013288b8e43 223 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 224 // this routine measures the number of seconds for which the joystick is
gatedClock 0:1013288b8e43 225 // in the up or down position. for three ranges of time, three different
gatedClock 0:1013288b8e43 226 // BPM rates-of-change are used. This means that as the user controls the
gatedClock 0:1013288b8e43 227 // metronome rate using the joystick, at first it will change slowly, then
gatedClock 0:1013288b8e43 228 // it will change at a moderate speed, then it will change quickly.
gatedClock 0:1013288b8e43 229 // additionally, pressing the center joystick button will bring the metronome
gatedClock 0:1013288b8e43 230 // back to 60BPM immediately, breaking BPM phase continuity.
gatedClock 0:1013288b8e43 231 void interrupt_service_UD(void) // joystick up/down sample
gatedClock 0:1013288b8e43 232 {
gatedClock 0:1013288b8e43 233 int dPressedSeconds; // how many seconds joystick pressed.
gatedClock 0:1013288b8e43 234 int dMultiCount; // slow count rate.
gatedClock 0:1013288b8e43 235 char cDiscontinuity; // 1 = break phase & change BPM now.
gatedClock 0:1013288b8e43 236
gatedClock 0:1013288b8e43 237 cDiscontinuity = 0; // don't break phase.
gatedClock 0:1013288b8e43 238
gatedClock 0:1013288b8e43 239 // calculate slow rate period.
gatedClock 0:1013288b8e43 240 dMultiCount = (int) ((float) (1.0 / ((float) UDSAMPLERATE)));
gatedClock 0:1013288b8e43 241
gatedClock 3:8ff0c9c853be 242 if (dJoyStickUp) // joystick up.
gatedClock 0:1013288b8e43 243 {
gatedClock 0:1013288b8e43 244 // rate-range calculations.
gatedClock 0:1013288b8e43 245 dPressedSeconds = (int) (((float) lUpDownHowMany) * UDSAMPLERATE);
gatedClock 0:1013288b8e43 246 if (dPressedSeconds < 5) {if (!(lUpDownHowMany % dMultiCount)) dMetroBPM ++;}
gatedClock 0:1013288b8e43 247 else
gatedClock 0:1013288b8e43 248 if (dPressedSeconds < 10) dMetroBPM++;
gatedClock 0:1013288b8e43 249 else dMetroBPM += 5;
gatedClock 0:1013288b8e43 250 lUpDownHowMany++; // joystick holddown time.
gatedClock 0:1013288b8e43 251 }
gatedClock 0:1013288b8e43 252 else
gatedClock 3:8ff0c9c853be 253 if (dJoyStickDown) // joystick down.
gatedClock 0:1013288b8e43 254 {
gatedClock 0:1013288b8e43 255 // rate-range calculations.
gatedClock 0:1013288b8e43 256 dPressedSeconds = (int) (((float) lUpDownHowMany) * UDSAMPLERATE);
gatedClock 0:1013288b8e43 257 if (dPressedSeconds < 5) {if (!(lUpDownHowMany % dMultiCount)) dMetroBPM --;}
gatedClock 0:1013288b8e43 258 else
gatedClock 0:1013288b8e43 259 if (dPressedSeconds < 10) dMetroBPM--;
gatedClock 0:1013288b8e43 260 else dMetroBPM -= 5;
gatedClock 0:1013288b8e43 261 lUpDownHowMany++; // joystick holddown time.
gatedClock 0:1013288b8e43 262 }
gatedClock 0:1013288b8e43 263 else lUpDownHowMany = 0; // clear when not up or down.
gatedClock 0:1013288b8e43 264
gatedClock 3:8ff0c9c853be 265 if (dJoyStickCenter)
gatedClock 0:1013288b8e43 266 {
gatedClock 0:1013288b8e43 267 dMetroBPM = 60; // center-button -> 60BPM.
gatedClock 0:1013288b8e43 268 cDiscontinuity = 1; // pending phase-break.
gatedClock 0:1013288b8e43 269 }
gatedClock 0:1013288b8e43 270 // saturate metronome BPM.
gatedClock 0:1013288b8e43 271 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 0:1013288b8e43 272 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 0:1013288b8e43 273
gatedClock 0:1013288b8e43 274 fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time.
gatedClock 0:1013288b8e43 275
gatedClock 0:1013288b8e43 276 if (cDiscontinuity) // implement 60BPS now.
gatedClock 0:1013288b8e43 277 {
gatedClock 0:1013288b8e43 278 tickerMetronome.detach(); // only one attachment.
gatedClock 0:1013288b8e43 279 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 0:1013288b8e43 280 }
gatedClock 0:1013288b8e43 281
gatedClock 0:1013288b8e43 282 }
gatedClock 0:1013288b8e43 283 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 284 void led3_off(void) {led3 = 0;} // turn off the LED.
gatedClock 0:1013288b8e43 285 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 286 void led3_on( void) {led3 = 1;} // turn on the led.
gatedClock 0:1013288b8e43 287 /*----------------------------------------------//----------------------------*/