Mike Moore / Mbed 2 deprecated RTOS_HW_04

RTOS homework 4

Dependencies:   C12832_lcd mbed

main.cpp@19:0db1451d19ef, 2013-08-18 (annotated)

Committer:
gatedClock
Date:
Sun Aug 18 20:05:21 2013 +0000
Revision:
19:0db1451d19ef
Parent:
18:f19721f1069e
Child:
20:64f1671c57ec
pretty close, but the bpm adjustment is not actually changing the blink rate.

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 19:0db1451d19ef 10 1. joystick-controlled.
gatedClock 19:0db1451d19ef 11 2. turns off after one minute.
gatedClock 19:0db1451d19ef 12 3. ISR's for all joystick inputs.
gatedClock 19:0db1451d19ef 13 4. joystick debounce.
gatedClock 19:0db1451d19ef 14 5. LED and LCD displays.
gatedClock 19:0db1451d19ef 15 6. BPM rate adjustable even when metronome is off.
gatedClock 19:0db1451d19ef 16 7. BPM saturates at defined lower/upper bounds.
gatedClock 18:f19721f1069e 17
gatedClock 0:1013288b8e43 18 controls:
gatedClock 19:0db1451d19ef 19 1. joystick-left - increase metronome rate.
gatedClock 19:0db1451d19ef 20 2. joystick-right - decrease metronome rate.
gatedClock 19:0db1451d19ef 21 3. joystick-down - start metronome.
gatedClock 19:0db1451d19ef 22 4. joystick-up - stop metronome.
gatedClock 19:0db1451d19ef 23 5. joystick-center - set metronome to 60BPM.
gatedClock 0:1013288b8e43 24
gatedClock 0:1013288b8e43 25 notes:
gatedClock 19:0db1451d19ef 26 1. adding the mbed-rtos library to this project prevents the
gatedClock 19:0db1451d19ef 27 LED from blinking and the LCD from displaying, even if
gatedClock 19:0db1451d19ef 28 there is no #include "rtos.h" statement.
gatedClock 19:0db1451d19ef 29 2. i was considering having the BPM up/down ISRs set up self-
gatedClock 19:0db1451d19ef 30 ending threads for continuous button press for rapid rate
gatedClock 19:0db1451d19ef 31 change, but again, rtos.h was causing trouble.
gatedClock 19:0db1451d19ef 32 3. I'm making use of disable-interrupts for bounce suppression.
gatedClock 19:0db1451d19ef 33 this could microscopically delay the metronome while its
gatedClock 19:0db1451d19ef 34 BPM is being adjusted, since I can't turn off only the
gatedClock 19:0db1451d19ef 35 interrupt involved with joystick input.
gatedClock 0:1013288b8e43 36
gatedClock 0:1013288b8e43 37 testing:
gatedClock 19:0db1451d19ef 38 1. start metronome - verify it blinks, and stops after a minute.
gatedClock 19:0db1451d19ef 39 2. stop metronome - verity it stops metronome.
gatedClock 19:0db1451d19ef 40 3. verify display indicates ON and OFF state.
gatedClock 19:0db1451d19ef 41 4. verify display indicates BPM rate.
gatedClock 19:0db1451d19ef 42 5. operate left/right joystick, inspect for BPM jumps (bounce).
gatedClock 19:0db1451d19ef 43 6. verify lower/upper BPM bounds. (only lower-bound tested).
gatedClock 0:1013288b8e43 44 -----includes-----------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 45 #include "mbed.h" // mbed class.
gatedClock 15:7c0a94d2a439 46 // #include "rtos.h"
gatedClock 14:fb4c76ac43a1 47 #include "C12832_lcd.h" // LCD class.
gatedClock 0:1013288b8e43 48 //---defines------------------------------------//------------------------------
gatedClock 0:1013288b8e43 49 #define LCD1 lcd.locate(0, 0); // LCD line 1.
gatedClock 0:1013288b8e43 50 #define LCD2 lcd.locate(0,11); // LCD line 2.
gatedClock 0:1013288b8e43 51 #define LCD3 lcd.locate(0,22); // LCD line 3.
gatedClock 7:562f136c7681 52
gatedClock 0:1013288b8e43 53 #define METROMAX 800 // max. beats per minute.
gatedClock 0:1013288b8e43 54 #define METROMIN 8 // min. beats per minute.
gatedClock 19:0db1451d19ef 55 #define METROTIME 60.0 // metronome on-time in seconds.
gatedClock 0:1013288b8e43 56 #define UDSAMPLERATE 0.1 // how often to sample U/D joystick.
gatedClock 0:1013288b8e43 57 #define LCDSAMPLERATE 0.1 // how often to redraw the LCD.
gatedClock 0:1013288b8e43 58 #define PULSELENGTH 0.0625 // how long the LED-on-time is.
gatedClock 10:4f2fa66cc430 59 #define DEBOUNCE 0.16 // debounce pause duration in S.
gatedClock 0:1013288b8e43 60 //--global_definitions--------------------------//------------------------------
gatedClock 0:1013288b8e43 61 //--global_variables----------------------------//------------------------------
gatedClock 0:1013288b8e43 62 float fMetroDelay; // time between ticks, in seconds.
gatedClock 0:1013288b8e43 63 float fMetroDuty; // duration of metro high, in seconds.
gatedClock 0:1013288b8e43 64 int dMetroBPM; // master parameter.
gatedClock 12:fab8e658ae76 65 char cMetronomeOn; // 1 = allow blink.
gatedClock 0:1013288b8e43 66 //--global_instances----------------------------//------------------------------
gatedClock 18:f19721f1069e 67 C12832_LCD lcd; // LCD object.
gatedClock 0:1013288b8e43 68
gatedClock 18:f19721f1069e 69 InterruptIn iJoyStickUp (p15); // joystick up rising edge.
gatedClock 18:f19721f1069e 70 InterruptIn iJoyStickDown (p12); // joystick down rising edge.
gatedClock 18:f19721f1069e 71 InterruptIn iJoyStickLeft (p13); // joystick left rising edge.
gatedClock 18:f19721f1069e 72 InterruptIn iJoyStickRight (p16); // joystick right rising edge.
gatedClock 18:f19721f1069e 73 InterruptIn iJoyStickCenter(p14); // 1 if joystick middle pressed.
gatedClock 0:1013288b8e43 74
gatedClock 0:1013288b8e43 75 DigitalOut led3(LED1); // leftmost LED.
gatedClock 0:1013288b8e43 76
gatedClock 0:1013288b8e43 77 Ticker tickerMetronome; // blinking LED.
gatedClock 0:1013288b8e43 78 Ticker tickerLCD; // display ticker.
gatedClock 0:1013288b8e43 79 Timeout timeoutDutyCycle; // LED duty cycle delay.
gatedClock 12:fab8e658ae76 80 Timeout timeoutMetronome;
gatedClock 0:1013288b8e43 81 //-------prototypes-----------------------------//------------------------------
gatedClock 0:1013288b8e43 82 void initialization(); // initialize settings.
gatedClock 0:1013288b8e43 83 void lcd_display(); // display on LCD.
gatedClock 18:f19721f1069e 84 void interrupt_service_M(); // metronome tick.
gatedClock 0:1013288b8e43 85 void led3_off(); // attachable LED control.
gatedClock 0:1013288b8e43 86 void led3_on(); // attachable LED control.
gatedClock 18:f19721f1069e 87 void ISR_up(); // stop metronome.
gatedClock 18:f19721f1069e 88 void ISR_down(); // start metronome.
gatedClock 18:f19721f1069e 89 void ISR_right_rising(); // decrease BPM.
gatedClock 18:f19721f1069e 90 void ISR_right_falling(); // bounce protection.
gatedClock 18:f19721f1069e 91 void ISR_left_rising(); // increase BPM.
gatedClock 18:f19721f1069e 92 void ISR_left_falling(); // bounce protection.
gatedClock 18:f19721f1069e 93 void ISR_center(); // set to 60BPM.
gatedClock 18:f19721f1069e 94 void turn_off_metronome(); // turn off blinker.
gatedClock 0:1013288b8e43 95 //==============================================//==============================
gatedClock 0:1013288b8e43 96 int main(void)
gatedClock 0:1013288b8e43 97 {
gatedClock 18:f19721f1069e 98 iJoyStickUp.rise (&ISR_up); // metronome stop.
gatedClock 18:f19721f1069e 99 iJoyStickDown.rise (&ISR_down); // metronome start.
gatedClock 11:e764ed79553a 100
gatedClock 18:f19721f1069e 101 iJoyStickLeft.rise (&ISR_left_rising); // increase BPM.
gatedClock 18:f19721f1069e 102 iJoyStickLeft.fall (&ISR_left_falling); // anti-bounce.
gatedClock 10:4f2fa66cc430 103
gatedClock 18:f19721f1069e 104 iJoyStickRight.rise(&ISR_right_rising); // decrease BPM.
gatedClock 18:f19721f1069e 105 iJoyStickRight.fall(&ISR_right_falling); // anti-bounce.
gatedClock 10:4f2fa66cc430 106
gatedClock 18:f19721f1069e 107 iJoyStickCenter.rise(&ISR_center); // 60BPM.
gatedClock 6:bb5f989e3425 108
gatedClock 18:f19721f1069e 109 initialization(); // initialize variables.
gatedClock 6:bb5f989e3425 110
gatedClock 18:f19721f1069e 111 // metronome ticker.
gatedClock 15:7c0a94d2a439 112 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 6:bb5f989e3425 113
gatedClock 15:7c0a94d2a439 114 // LCD ticker.
gatedClock 15:7c0a94d2a439 115 tickerLCD.attach(&lcd_display,LCDSAMPLERATE);
gatedClock 6:bb5f989e3425 116
gatedClock 18:f19721f1069e 117 while(1) // all timer/interrupt driven.
gatedClock 6:bb5f989e3425 118 {
gatedClock 6:bb5f989e3425 119 wait(10.0);
gatedClock 6:bb5f989e3425 120 }
gatedClock 0:1013288b8e43 121 }
gatedClock 0:1013288b8e43 122 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 123 void initialization(void) // program initializations.
gatedClock 0:1013288b8e43 124 {
gatedClock 0:1013288b8e43 125 dMetroBPM = 60; // initialize to 60BPM.
gatedClock 0:1013288b8e43 126 fMetroDelay = 60.0 / (float) (dMetroBPM);
gatedClock 0:1013288b8e43 127 fMetroDuty = PULSELENGTH; // initialize LED on-duration.
gatedClock 17:cd6c76be8046 128 cMetronomeOn = 0;
gatedClock 0:1013288b8e43 129 }
gatedClock 0:1013288b8e43 130 /*----------------------------------------------//----------------------------*/
gatedClock 11:e764ed79553a 131 void ISR_left_rising(void) // increase BPM.
gatedClock 1:5f41e2df0e85 132 {
gatedClock 18:f19721f1069e 133 __disable_irq(); // anti-bounce.
gatedClock 11:e764ed79553a 134
gatedClock 11:e764ed79553a 135 dMetroBPM++; // increase BPM.
gatedClock 11:e764ed79553a 136
gatedClock 12:fab8e658ae76 137 // saturate metronome BPM.
gatedClock 12:fab8e658ae76 138 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 12:fab8e658ae76 139 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 12:fab8e658ae76 140
gatedClock 11:e764ed79553a 141 wait(DEBOUNCE); // debounce time.
gatedClock 11:e764ed79553a 142
gatedClock 18:f19721f1069e 143 __enable_irq(); // safe by now.
gatedClock 1:5f41e2df0e85 144 }
gatedClock 1:5f41e2df0e85 145 /*----------------------------------------------//----------------------------*/
gatedClock 11:e764ed79553a 146 void ISR_left_falling(void) // ignore rising after falling edge.
gatedClock 11:e764ed79553a 147 {
gatedClock 18:f19721f1069e 148 __disable_irq(); // anti-bounce.
gatedClock 11:e764ed79553a 149
gatedClock 11:e764ed79553a 150 wait(DEBOUNCE); // debounce time.
gatedClock 11:e764ed79553a 151
gatedClock 18:f19721f1069e 152 __enable_irq(); // safe by now.
gatedClock 11:e764ed79553a 153 }
gatedClock 11:e764ed79553a 154 /*----------------------------------------------//----------------------------*/
gatedClock 10:4f2fa66cc430 155 void ISR_right_rising(void) // decrease BPM.
gatedClock 4:67d958cc00e8 156 {
gatedClock 18:f19721f1069e 157 __disable_irq(); // anti-bounce.
gatedClock 10:4f2fa66cc430 158
gatedClock 10:4f2fa66cc430 159 dMetroBPM--; // decrease BPM.
gatedClock 4:67d958cc00e8 160
gatedClock 12:fab8e658ae76 161 // saturate metronome BPM.
gatedClock 12:fab8e658ae76 162 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 12:fab8e658ae76 163 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 12:fab8e658ae76 164
gatedClock 10:4f2fa66cc430 165 wait(DEBOUNCE); // debounce time.
gatedClock 9:ea97a69b9b93 166
gatedClock 18:f19721f1069e 167 __enable_irq(); // safe by now.
gatedClock 10:4f2fa66cc430 168 }
gatedClock 10:4f2fa66cc430 169 /*----------------------------------------------//----------------------------*/
gatedClock 10:4f2fa66cc430 170 void ISR_right_falling(void) // ignore rising after falling edge.
gatedClock 10:4f2fa66cc430 171 {
gatedClock 18:f19721f1069e 172 __disable_irq(); // anti-bounce.
gatedClock 10:4f2fa66cc430 173
gatedClock 10:4f2fa66cc430 174 wait(DEBOUNCE); // debounce time.
gatedClock 10:4f2fa66cc430 175
gatedClock 18:f19721f1069e 176 __enable_irq(); // safe by now.
gatedClock 4:67d958cc00e8 177 }
gatedClock 4:67d958cc00e8 178 /*----------------------------------------------//----------------------------*/
gatedClock 18:f19721f1069e 179 void ISR_up(void) // turn off metronome.
gatedClock 1:5f41e2df0e85 180 {
gatedClock 17:cd6c76be8046 181 cMetronomeOn = 0;
gatedClock 1:5f41e2df0e85 182 }
gatedClock 1:5f41e2df0e85 183 /*----------------------------------------------//----------------------------*/
gatedClock 18:f19721f1069e 184 void ISR_down(void) // metronome on with timeout.
gatedClock 1:5f41e2df0e85 185 {
gatedClock 12:fab8e658ae76 186 cMetronomeOn = 1;
gatedClock 12:fab8e658ae76 187 timeoutMetronome.detach();
gatedClock 17:cd6c76be8046 188 timeoutMetronome.attach(&turn_off_metronome,METROTIME);
gatedClock 1:5f41e2df0e85 189 }
gatedClock 1:5f41e2df0e85 190 /*----------------------------------------------//----------------------------*/
gatedClock 3:8ff0c9c853be 191 void ISR_center(void) // set BPM = 60.
gatedClock 1:5f41e2df0e85 192 {
gatedClock 8:95f4f470ae28 193 dMetroBPM = 60;
gatedClock 19:0db1451d19ef 194
gatedClock 19:0db1451d19ef 195 tickerMetronome.detach(); // change BPM immediately.
gatedClock 19:0db1451d19ef 196 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 1:5f41e2df0e85 197 }
gatedClock 1:5f41e2df0e85 198 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 199 void lcd_display(void) // display metronome info.
gatedClock 0:1013288b8e43 200 {
gatedClock 0:1013288b8e43 201 lcd.cls(); // clear display.
gatedClock 0:1013288b8e43 202
gatedClock 0:1013288b8e43 203 LCD1; // line 1.
gatedClock 17:cd6c76be8046 204
gatedClock 16:d7bbd641929c 205 if (cMetronomeOn)
gatedClock 16:d7bbd641929c 206 lcd.printf(" metronome ON");
gatedClock 16:d7bbd641929c 207 else
gatedClock 16:d7bbd641929c 208 lcd.printf(" metronome OFF");
gatedClock 0:1013288b8e43 209
gatedClock 0:1013288b8e43 210 LCD2; // line 2.
gatedClock 0:1013288b8e43 211
gatedClock 0:1013288b8e43 212 if (dMetroBPM == METROMIN) // BPM, with saturation notification.
gatedClock 0:1013288b8e43 213 lcd.printf(" %5.2d BPM minimum",dMetroBPM);
gatedClock 0:1013288b8e43 214 else
gatedClock 0:1013288b8e43 215 if (dMetroBPM == METROMAX)
gatedClock 0:1013288b8e43 216 lcd.printf(" %5.2d BPM maximum",dMetroBPM);
gatedClock 0:1013288b8e43 217 else
gatedClock 0:1013288b8e43 218 lcd.printf(" %5.2d BPM",dMetroBPM);
gatedClock 0:1013288b8e43 219
gatedClock 0:1013288b8e43 220 LCD3; // line 3.
gatedClock 0:1013288b8e43 221
gatedClock 8:95f4f470ae28 222 lcd.printf(" RTOS HW 4");
gatedClock 0:1013288b8e43 223 }
gatedClock 0:1013288b8e43 224 /*----------------------------------------------//----------------------------*/
gatedClock 17:cd6c76be8046 225 // this metronome tick ISR will self-adjust to the current user-selected
gatedClock 17:cd6c76be8046 226 // metronome rate. that has to be done here, and at the start of the function,
gatedClock 17:cd6c76be8046 227 // in order to maintain a constant phase and to prevent a beat-skip.
gatedClock 17:cd6c76be8046 228
gatedClock 17:cd6c76be8046 229 void interrupt_service_M() // metronome tick.
gatedClock 17:cd6c76be8046 230 {
gatedClock 17:cd6c76be8046 231 if (cMetronomeOn)
gatedClock 17:cd6c76be8046 232 {
gatedClock 18:f19721f1069e 233 tickerMetronome.detach(); // only one attachment.
gatedClock 17:cd6c76be8046 234 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 17:cd6c76be8046 235 led3_on();
gatedClock 17:cd6c76be8046 236 timeoutDutyCycle.attach(&led3_off,fMetroDuty);
gatedClock 17:cd6c76be8046 237 } else led3_off();
gatedClock 17:cd6c76be8046 238 }
gatedClock 17:cd6c76be8046 239 /*----------------------------------------------//----------------------------*/
gatedClock 18:f19721f1069e 240 void turn_off_metronome(void) // turn off metronome.
gatedClock 17:cd6c76be8046 241 {
gatedClock 17:cd6c76be8046 242 cMetronomeOn = 0;
gatedClock 17:cd6c76be8046 243 }
gatedClock 17:cd6c76be8046 244 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 245 void led3_off(void) {led3 = 0;} // turn off the LED.
gatedClock 0:1013288b8e43 246 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 247 void led3_on( void) {led3 = 1;} // turn on the led.
gatedClock 15:7c0a94d2a439 248 /*----------------------------------------------//----------------------------*/