Mike Moore / Mbed 2 deprecated RTOS_HW_04

RTOS homework 4

Dependencies:   C12832_lcd mbed

main.cpp@21:eb692e90ae8d, 2013-09-13 (annotated)

Committer:
gatedClock
Date:
Fri Sep 13 03:59:57 2013 +0000
Revision:
21:eb692e90ae8d
Parent:
20:64f1671c57ec
Child:
22:5d9bcc7f4440
first powercontrol compile

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