Mike Moore / Mbed 2 deprecated RTOS_HW_04

RTOS homework 4

Dependencies:   C12832_lcd mbed

main.cpp@24:fe4e288bbca3, 2013-09-13 (annotated)

Committer:
gatedClock
Date:
Fri Sep 13 04:06:04 2013 +0000
Revision:
24:fe4e288bbca3
Parent:
23:99a13f79cdad
Child:
25:fe4425b11e3c
watchdog class and its instance compiles.

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 24:fe4e288bbca3 83
gatedClock 24:fe4e288bbca3 84
gatedClock 0:1013288b8e43 85 //-------prototypes-----------------------------//------------------------------
gatedClock 0:1013288b8e43 86 void initialization(); // initialize settings.
gatedClock 0:1013288b8e43 87 void lcd_display(); // display on LCD.
gatedClock 18:f19721f1069e 88 void interrupt_service_M(); // metronome tick.
gatedClock 0:1013288b8e43 89 void led3_off(); // attachable LED control.
gatedClock 0:1013288b8e43 90 void led3_on(); // attachable LED control.
gatedClock 18:f19721f1069e 91 void ISR_up(); // stop metronome.
gatedClock 18:f19721f1069e 92 void ISR_down(); // start metronome.
gatedClock 18:f19721f1069e 93 void ISR_right_rising(); // decrease BPM.
gatedClock 18:f19721f1069e 94 void ISR_right_falling(); // bounce protection.
gatedClock 18:f19721f1069e 95 void ISR_left_rising(); // increase BPM.
gatedClock 18:f19721f1069e 96 void ISR_left_falling(); // bounce protection.
gatedClock 18:f19721f1069e 97 void ISR_center(); // set to 60BPM.
gatedClock 18:f19721f1069e 98 void turn_off_metronome(); // turn off blinker.
gatedClock 24:fe4e288bbca3 99
gatedClock 24:fe4e288bbca3 100
gatedClock 24:fe4e288bbca3 101
gatedClock 24:fe4e288bbca3 102 class Watchdog {
gatedClock 24:fe4e288bbca3 103 public:
gatedClock 24:fe4e288bbca3 104 // Load timeout value in watchdog timer and enable
gatedClock 24:fe4e288bbca3 105 void kick(float s) {
gatedClock 24:fe4e288bbca3 106 LPC_WDT->WDCLKSEL = 0x1; // Set CLK src to PCLK
gatedClock 24:fe4e288bbca3 107 uint32_t clk = SystemCoreClock / 16; // WD has a fixed /4 prescaler, PCLK default is /4
gatedClock 24:fe4e288bbca3 108 LPC_WDT->WDTC = s * (float)clk;
gatedClock 24:fe4e288bbca3 109 LPC_WDT->WDMOD = 0x3; // Enabled and Reset
gatedClock 24:fe4e288bbca3 110 kick();
gatedClock 24:fe4e288bbca3 111 }
gatedClock 24:fe4e288bbca3 112 // "kick" or "feed" the dog - reset the watchdog timer
gatedClock 24:fe4e288bbca3 113 // by writing this required bit pattern
gatedClock 24:fe4e288bbca3 114 void kick() {
gatedClock 24:fe4e288bbca3 115 LPC_WDT->WDFEED = 0xAA;
gatedClock 24:fe4e288bbca3 116 LPC_WDT->WDFEED = 0x55;
gatedClock 24:fe4e288bbca3 117 }
gatedClock 24:fe4e288bbca3 118 };
gatedClock 24:fe4e288bbca3 119 Watchdog wdt; // add a wachdog timer.
gatedClock 0:1013288b8e43 120 //==============================================//==============================
gatedClock 0:1013288b8e43 121 int main(void)
gatedClock 0:1013288b8e43 122 {
gatedClock 18:f19721f1069e 123 iJoyStickUp.rise (&ISR_up); // metronome stop.
gatedClock 18:f19721f1069e 124 iJoyStickDown.rise (&ISR_down); // metronome start.
gatedClock 11:e764ed79553a 125
gatedClock 18:f19721f1069e 126 iJoyStickLeft.rise (&ISR_left_rising); // increase BPM.
gatedClock 18:f19721f1069e 127 iJoyStickLeft.fall (&ISR_left_falling); // anti-bounce.
gatedClock 10:4f2fa66cc430 128
gatedClock 18:f19721f1069e 129 iJoyStickRight.rise(&ISR_right_rising); // decrease BPM.
gatedClock 18:f19721f1069e 130 iJoyStickRight.fall(&ISR_right_falling); // anti-bounce.
gatedClock 10:4f2fa66cc430 131
gatedClock 18:f19721f1069e 132 iJoyStickCenter.rise(&ISR_center); // 60BPM.
gatedClock 6:bb5f989e3425 133
gatedClock 18:f19721f1069e 134 initialization(); // initialize variables.
gatedClock 6:bb5f989e3425 135
gatedClock 18:f19721f1069e 136 // metronome ticker.
gatedClock 15:7c0a94d2a439 137 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 6:bb5f989e3425 138
gatedClock 15:7c0a94d2a439 139 // LCD ticker.
gatedClock 15:7c0a94d2a439 140 tickerLCD.attach(&lcd_display,LCDSAMPLERATE);
gatedClock 6:bb5f989e3425 141
gatedClock 22:5d9bcc7f4440 142 #ifdef NOETHER
gatedClock 22:5d9bcc7f4440 143 // Normal mbed power level for this setup is around 690mW
gatedClock 22:5d9bcc7f4440 144 // assuming 5V used on Vin pin
gatedClock 22:5d9bcc7f4440 145 // If you don't need networking...
gatedClock 22:5d9bcc7f4440 146 // Power down Ethernet interface - saves around 175mW
gatedClock 22:5d9bcc7f4440 147 // Also need to unplug network cable - just a cable sucks power
gatedClock 22:5d9bcc7f4440 148 PHY_PowerDown();
gatedClock 22:5d9bcc7f4440 149 #endif
gatedClock 22:5d9bcc7f4440 150
gatedClock 18:f19721f1069e 151 while(1) // all timer/interrupt driven.
gatedClock 6:bb5f989e3425 152 {
gatedClock 23:99a13f79cdad 153 Sleep();
gatedClock 6:bb5f989e3425 154 }
gatedClock 0:1013288b8e43 155 }
gatedClock 0:1013288b8e43 156 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 157 void initialization(void) // program initializations.
gatedClock 0:1013288b8e43 158 {
gatedClock 0:1013288b8e43 159 dMetroBPM = 60; // initialize to 60BPM.
gatedClock 0:1013288b8e43 160 fMetroDelay = 60.0 / (float) (dMetroBPM);
gatedClock 0:1013288b8e43 161 fMetroDuty = PULSELENGTH; // initialize LED on-duration.
gatedClock 17:cd6c76be8046 162 cMetronomeOn = 0;
gatedClock 0:1013288b8e43 163 }
gatedClock 0:1013288b8e43 164 /*----------------------------------------------//----------------------------*/
gatedClock 11:e764ed79553a 165 void ISR_left_rising(void) // increase BPM.
gatedClock 1:5f41e2df0e85 166 {
gatedClock 18:f19721f1069e 167 __disable_irq(); // anti-bounce.
gatedClock 11:e764ed79553a 168
gatedClock 11:e764ed79553a 169 dMetroBPM++; // increase BPM.
gatedClock 11:e764ed79553a 170
gatedClock 12:fab8e658ae76 171 // saturate metronome BPM.
gatedClock 12:fab8e658ae76 172 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 12:fab8e658ae76 173 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 20:64f1671c57ec 174 fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time.
gatedClock 12:fab8e658ae76 175
gatedClock 11:e764ed79553a 176 wait(DEBOUNCE); // debounce time.
gatedClock 11:e764ed79553a 177
gatedClock 18:f19721f1069e 178 __enable_irq(); // safe by now.
gatedClock 1:5f41e2df0e85 179 }
gatedClock 1:5f41e2df0e85 180 /*----------------------------------------------//----------------------------*/
gatedClock 11:e764ed79553a 181 void ISR_left_falling(void) // ignore rising after falling edge.
gatedClock 11:e764ed79553a 182 {
gatedClock 18:f19721f1069e 183 __disable_irq(); // anti-bounce.
gatedClock 11:e764ed79553a 184
gatedClock 11:e764ed79553a 185 wait(DEBOUNCE); // debounce time.
gatedClock 11:e764ed79553a 186
gatedClock 18:f19721f1069e 187 __enable_irq(); // safe by now.
gatedClock 11:e764ed79553a 188 }
gatedClock 11:e764ed79553a 189 /*----------------------------------------------//----------------------------*/
gatedClock 10:4f2fa66cc430 190 void ISR_right_rising(void) // decrease BPM.
gatedClock 4:67d958cc00e8 191 {
gatedClock 18:f19721f1069e 192 __disable_irq(); // anti-bounce.
gatedClock 10:4f2fa66cc430 193
gatedClock 10:4f2fa66cc430 194 dMetroBPM--; // decrease BPM.
gatedClock 4:67d958cc00e8 195
gatedClock 12:fab8e658ae76 196 // saturate metronome BPM.
gatedClock 12:fab8e658ae76 197 if (dMetroBPM > METROMAX) dMetroBPM = METROMAX;
gatedClock 12:fab8e658ae76 198 if (dMetroBPM < METROMIN) dMetroBPM = METROMIN;
gatedClock 20:64f1671c57ec 199 fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time.
gatedClock 12:fab8e658ae76 200
gatedClock 10:4f2fa66cc430 201 wait(DEBOUNCE); // debounce time.
gatedClock 9:ea97a69b9b93 202
gatedClock 18:f19721f1069e 203 __enable_irq(); // safe by now.
gatedClock 10:4f2fa66cc430 204 }
gatedClock 10:4f2fa66cc430 205 /*----------------------------------------------//----------------------------*/
gatedClock 10:4f2fa66cc430 206 void ISR_right_falling(void) // ignore rising after falling edge.
gatedClock 10:4f2fa66cc430 207 {
gatedClock 18:f19721f1069e 208 __disable_irq(); // anti-bounce.
gatedClock 10:4f2fa66cc430 209
gatedClock 10:4f2fa66cc430 210 wait(DEBOUNCE); // debounce time.
gatedClock 10:4f2fa66cc430 211
gatedClock 18:f19721f1069e 212 __enable_irq(); // safe by now.
gatedClock 4:67d958cc00e8 213 }
gatedClock 4:67d958cc00e8 214 /*----------------------------------------------//----------------------------*/
gatedClock 18:f19721f1069e 215 void ISR_up(void) // turn off metronome.
gatedClock 1:5f41e2df0e85 216 {
gatedClock 17:cd6c76be8046 217 cMetronomeOn = 0;
gatedClock 1:5f41e2df0e85 218 }
gatedClock 1:5f41e2df0e85 219 /*----------------------------------------------//----------------------------*/
gatedClock 18:f19721f1069e 220 void ISR_down(void) // metronome on with timeout.
gatedClock 1:5f41e2df0e85 221 {
gatedClock 12:fab8e658ae76 222 cMetronomeOn = 1;
gatedClock 12:fab8e658ae76 223 timeoutMetronome.detach();
gatedClock 17:cd6c76be8046 224 timeoutMetronome.attach(&turn_off_metronome,METROTIME);
gatedClock 1:5f41e2df0e85 225 }
gatedClock 1:5f41e2df0e85 226 /*----------------------------------------------//----------------------------*/
gatedClock 3:8ff0c9c853be 227 void ISR_center(void) // set BPM = 60.
gatedClock 1:5f41e2df0e85 228 {
gatedClock 8:95f4f470ae28 229 dMetroBPM = 60;
gatedClock 20:64f1671c57ec 230 fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time.
gatedClock 19:0db1451d19ef 231 tickerMetronome.detach(); // change BPM immediately.
gatedClock 19:0db1451d19ef 232 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 1:5f41e2df0e85 233 }
gatedClock 1:5f41e2df0e85 234 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 235 void lcd_display(void) // display metronome info.
gatedClock 0:1013288b8e43 236 {
gatedClock 0:1013288b8e43 237 lcd.cls(); // clear display.
gatedClock 0:1013288b8e43 238
gatedClock 0:1013288b8e43 239 LCD1; // line 1.
gatedClock 17:cd6c76be8046 240
gatedClock 16:d7bbd641929c 241 if (cMetronomeOn)
gatedClock 16:d7bbd641929c 242 lcd.printf(" metronome ON");
gatedClock 16:d7bbd641929c 243 else
gatedClock 16:d7bbd641929c 244 lcd.printf(" metronome OFF");
gatedClock 0:1013288b8e43 245
gatedClock 0:1013288b8e43 246 LCD2; // line 2.
gatedClock 0:1013288b8e43 247
gatedClock 0:1013288b8e43 248 if (dMetroBPM == METROMIN) // BPM, with saturation notification.
gatedClock 0:1013288b8e43 249 lcd.printf(" %5.2d BPM minimum",dMetroBPM);
gatedClock 0:1013288b8e43 250 else
gatedClock 0:1013288b8e43 251 if (dMetroBPM == METROMAX)
gatedClock 0:1013288b8e43 252 lcd.printf(" %5.2d BPM maximum",dMetroBPM);
gatedClock 0:1013288b8e43 253 else
gatedClock 0:1013288b8e43 254 lcd.printf(" %5.2d BPM",dMetroBPM);
gatedClock 0:1013288b8e43 255
gatedClock 0:1013288b8e43 256 LCD3; // line 3.
gatedClock 0:1013288b8e43 257
gatedClock 8:95f4f470ae28 258 lcd.printf(" RTOS HW 4");
gatedClock 0:1013288b8e43 259 }
gatedClock 0:1013288b8e43 260 /*----------------------------------------------//----------------------------*/
gatedClock 17:cd6c76be8046 261 // this metronome tick ISR will self-adjust to the current user-selected
gatedClock 17:cd6c76be8046 262 // metronome rate. that has to be done here, and at the start of the function,
gatedClock 17:cd6c76be8046 263 // in order to maintain a constant phase and to prevent a beat-skip.
gatedClock 17:cd6c76be8046 264
gatedClock 17:cd6c76be8046 265 void interrupt_service_M() // metronome tick.
gatedClock 17:cd6c76be8046 266 {
gatedClock 17:cd6c76be8046 267 if (cMetronomeOn)
gatedClock 17:cd6c76be8046 268 {
gatedClock 18:f19721f1069e 269 tickerMetronome.detach(); // only one attachment.
gatedClock 17:cd6c76be8046 270 tickerMetronome.attach(&interrupt_service_M,fMetroDelay);
gatedClock 17:cd6c76be8046 271 led3_on();
gatedClock 17:cd6c76be8046 272 timeoutDutyCycle.attach(&led3_off,fMetroDuty);
gatedClock 17:cd6c76be8046 273 } else led3_off();
gatedClock 17:cd6c76be8046 274 }
gatedClock 17:cd6c76be8046 275 /*----------------------------------------------//----------------------------*/
gatedClock 18:f19721f1069e 276 void turn_off_metronome(void) // turn off metronome.
gatedClock 17:cd6c76be8046 277 {
gatedClock 17:cd6c76be8046 278 cMetronomeOn = 0;
gatedClock 17:cd6c76be8046 279 }
gatedClock 17:cd6c76be8046 280 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 281 void led3_off(void) {led3 = 0;} // turn off the LED.
gatedClock 0:1013288b8e43 282 /*----------------------------------------------//----------------------------*/
gatedClock 0:1013288b8e43 283 void led3_on( void) {led3 = 1;} // turn on the led.
gatedClock 15:7c0a94d2a439 284 /*----------------------------------------------//----------------------------*/