Mike Moore
/
RTOS_HW_04
RTOS homework 4
main.cpp@23:99a13f79cdad, 2013-09-13 (annotated)
- Committer:
- gatedClock
- Date:
- Fri Sep 13 04:03:41 2013 +0000
- Revision:
- 23:99a13f79cdad
- Parent:
- 22:5d9bcc7f4440
- Child:
- 24:fe4e288bbca3
added Sleep();
Who changed what in which revision?
User | Revision | Line number | New 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 | 22:5d9bcc7f4440 | 119 | #ifdef NOETHER |
gatedClock | 22:5d9bcc7f4440 | 120 | // Normal mbed power level for this setup is around 690mW |
gatedClock | 22:5d9bcc7f4440 | 121 | // assuming 5V used on Vin pin |
gatedClock | 22:5d9bcc7f4440 | 122 | // If you don't need networking... |
gatedClock | 22:5d9bcc7f4440 | 123 | // Power down Ethernet interface - saves around 175mW |
gatedClock | 22:5d9bcc7f4440 | 124 | // Also need to unplug network cable - just a cable sucks power |
gatedClock | 22:5d9bcc7f4440 | 125 | PHY_PowerDown(); |
gatedClock | 22:5d9bcc7f4440 | 126 | #endif |
gatedClock | 22:5d9bcc7f4440 | 127 | |
gatedClock | 18:f19721f1069e | 128 | while(1) // all timer/interrupt driven. |
gatedClock | 6:bb5f989e3425 | 129 | { |
gatedClock | 23:99a13f79cdad | 130 | Sleep(); |
gatedClock | 6:bb5f989e3425 | 131 | } |
gatedClock | 0:1013288b8e43 | 132 | } |
gatedClock | 0:1013288b8e43 | 133 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 134 | void initialization(void) // program initializations. |
gatedClock | 0:1013288b8e43 | 135 | { |
gatedClock | 0:1013288b8e43 | 136 | dMetroBPM = 60; // initialize to 60BPM. |
gatedClock | 0:1013288b8e43 | 137 | fMetroDelay = 60.0 / (float) (dMetroBPM); |
gatedClock | 0:1013288b8e43 | 138 | fMetroDuty = PULSELENGTH; // initialize LED on-duration. |
gatedClock | 17:cd6c76be8046 | 139 | cMetronomeOn = 0; |
gatedClock | 0:1013288b8e43 | 140 | } |
gatedClock | 0:1013288b8e43 | 141 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 11:e764ed79553a | 142 | void ISR_left_rising(void) // increase BPM. |
gatedClock | 1:5f41e2df0e85 | 143 | { |
gatedClock | 18:f19721f1069e | 144 | __disable_irq(); // anti-bounce. |
gatedClock | 11:e764ed79553a | 145 | |
gatedClock | 11:e764ed79553a | 146 | dMetroBPM++; // increase BPM. |
gatedClock | 11:e764ed79553a | 147 | |
gatedClock | 12:fab8e658ae76 | 148 | // saturate metronome BPM. |
gatedClock | 12:fab8e658ae76 | 149 | if (dMetroBPM > METROMAX) dMetroBPM = METROMAX; |
gatedClock | 12:fab8e658ae76 | 150 | if (dMetroBPM < METROMIN) dMetroBPM = METROMIN; |
gatedClock | 20:64f1671c57ec | 151 | fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time. |
gatedClock | 12:fab8e658ae76 | 152 | |
gatedClock | 11:e764ed79553a | 153 | wait(DEBOUNCE); // debounce time. |
gatedClock | 11:e764ed79553a | 154 | |
gatedClock | 18:f19721f1069e | 155 | __enable_irq(); // safe by now. |
gatedClock | 1:5f41e2df0e85 | 156 | } |
gatedClock | 1:5f41e2df0e85 | 157 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 11:e764ed79553a | 158 | void ISR_left_falling(void) // ignore rising after falling edge. |
gatedClock | 11:e764ed79553a | 159 | { |
gatedClock | 18:f19721f1069e | 160 | __disable_irq(); // anti-bounce. |
gatedClock | 11:e764ed79553a | 161 | |
gatedClock | 11:e764ed79553a | 162 | wait(DEBOUNCE); // debounce time. |
gatedClock | 11:e764ed79553a | 163 | |
gatedClock | 18:f19721f1069e | 164 | __enable_irq(); // safe by now. |
gatedClock | 11:e764ed79553a | 165 | } |
gatedClock | 11:e764ed79553a | 166 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 10:4f2fa66cc430 | 167 | void ISR_right_rising(void) // decrease BPM. |
gatedClock | 4:67d958cc00e8 | 168 | { |
gatedClock | 18:f19721f1069e | 169 | __disable_irq(); // anti-bounce. |
gatedClock | 10:4f2fa66cc430 | 170 | |
gatedClock | 10:4f2fa66cc430 | 171 | dMetroBPM--; // decrease BPM. |
gatedClock | 4:67d958cc00e8 | 172 | |
gatedClock | 12:fab8e658ae76 | 173 | // saturate metronome BPM. |
gatedClock | 12:fab8e658ae76 | 174 | if (dMetroBPM > METROMAX) dMetroBPM = METROMAX; |
gatedClock | 12:fab8e658ae76 | 175 | if (dMetroBPM < METROMIN) dMetroBPM = METROMIN; |
gatedClock | 20:64f1671c57ec | 176 | fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time. |
gatedClock | 12:fab8e658ae76 | 177 | |
gatedClock | 10:4f2fa66cc430 | 178 | wait(DEBOUNCE); // debounce time. |
gatedClock | 9:ea97a69b9b93 | 179 | |
gatedClock | 18:f19721f1069e | 180 | __enable_irq(); // safe by now. |
gatedClock | 10:4f2fa66cc430 | 181 | } |
gatedClock | 10:4f2fa66cc430 | 182 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 10:4f2fa66cc430 | 183 | void ISR_right_falling(void) // ignore rising after falling edge. |
gatedClock | 10:4f2fa66cc430 | 184 | { |
gatedClock | 18:f19721f1069e | 185 | __disable_irq(); // anti-bounce. |
gatedClock | 10:4f2fa66cc430 | 186 | |
gatedClock | 10:4f2fa66cc430 | 187 | wait(DEBOUNCE); // debounce time. |
gatedClock | 10:4f2fa66cc430 | 188 | |
gatedClock | 18:f19721f1069e | 189 | __enable_irq(); // safe by now. |
gatedClock | 4:67d958cc00e8 | 190 | } |
gatedClock | 4:67d958cc00e8 | 191 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 18:f19721f1069e | 192 | void ISR_up(void) // turn off metronome. |
gatedClock | 1:5f41e2df0e85 | 193 | { |
gatedClock | 17:cd6c76be8046 | 194 | cMetronomeOn = 0; |
gatedClock | 1:5f41e2df0e85 | 195 | } |
gatedClock | 1:5f41e2df0e85 | 196 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 18:f19721f1069e | 197 | void ISR_down(void) // metronome on with timeout. |
gatedClock | 1:5f41e2df0e85 | 198 | { |
gatedClock | 12:fab8e658ae76 | 199 | cMetronomeOn = 1; |
gatedClock | 12:fab8e658ae76 | 200 | timeoutMetronome.detach(); |
gatedClock | 17:cd6c76be8046 | 201 | timeoutMetronome.attach(&turn_off_metronome,METROTIME); |
gatedClock | 1:5f41e2df0e85 | 202 | } |
gatedClock | 1:5f41e2df0e85 | 203 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 3:8ff0c9c853be | 204 | void ISR_center(void) // set BPM = 60. |
gatedClock | 1:5f41e2df0e85 | 205 | { |
gatedClock | 8:95f4f470ae28 | 206 | dMetroBPM = 60; |
gatedClock | 20:64f1671c57ec | 207 | fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time. |
gatedClock | 19:0db1451d19ef | 208 | tickerMetronome.detach(); // change BPM immediately. |
gatedClock | 19:0db1451d19ef | 209 | tickerMetronome.attach(&interrupt_service_M,fMetroDelay); |
gatedClock | 1:5f41e2df0e85 | 210 | } |
gatedClock | 1:5f41e2df0e85 | 211 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 212 | void lcd_display(void) // display metronome info. |
gatedClock | 0:1013288b8e43 | 213 | { |
gatedClock | 0:1013288b8e43 | 214 | lcd.cls(); // clear display. |
gatedClock | 0:1013288b8e43 | 215 | |
gatedClock | 0:1013288b8e43 | 216 | LCD1; // line 1. |
gatedClock | 17:cd6c76be8046 | 217 | |
gatedClock | 16:d7bbd641929c | 218 | if (cMetronomeOn) |
gatedClock | 16:d7bbd641929c | 219 | lcd.printf(" metronome ON"); |
gatedClock | 16:d7bbd641929c | 220 | else |
gatedClock | 16:d7bbd641929c | 221 | lcd.printf(" metronome OFF"); |
gatedClock | 0:1013288b8e43 | 222 | |
gatedClock | 0:1013288b8e43 | 223 | LCD2; // line 2. |
gatedClock | 0:1013288b8e43 | 224 | |
gatedClock | 0:1013288b8e43 | 225 | if (dMetroBPM == METROMIN) // BPM, with saturation notification. |
gatedClock | 0:1013288b8e43 | 226 | lcd.printf(" %5.2d BPM minimum",dMetroBPM); |
gatedClock | 0:1013288b8e43 | 227 | else |
gatedClock | 0:1013288b8e43 | 228 | if (dMetroBPM == METROMAX) |
gatedClock | 0:1013288b8e43 | 229 | lcd.printf(" %5.2d BPM maximum",dMetroBPM); |
gatedClock | 0:1013288b8e43 | 230 | else |
gatedClock | 0:1013288b8e43 | 231 | lcd.printf(" %5.2d BPM",dMetroBPM); |
gatedClock | 0:1013288b8e43 | 232 | |
gatedClock | 0:1013288b8e43 | 233 | LCD3; // line 3. |
gatedClock | 0:1013288b8e43 | 234 | |
gatedClock | 8:95f4f470ae28 | 235 | lcd.printf(" RTOS HW 4"); |
gatedClock | 0:1013288b8e43 | 236 | } |
gatedClock | 0:1013288b8e43 | 237 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 17:cd6c76be8046 | 238 | // this metronome tick ISR will self-adjust to the current user-selected |
gatedClock | 17:cd6c76be8046 | 239 | // metronome rate. that has to be done here, and at the start of the function, |
gatedClock | 17:cd6c76be8046 | 240 | // in order to maintain a constant phase and to prevent a beat-skip. |
gatedClock | 17:cd6c76be8046 | 241 | |
gatedClock | 17:cd6c76be8046 | 242 | void interrupt_service_M() // metronome tick. |
gatedClock | 17:cd6c76be8046 | 243 | { |
gatedClock | 17:cd6c76be8046 | 244 | if (cMetronomeOn) |
gatedClock | 17:cd6c76be8046 | 245 | { |
gatedClock | 18:f19721f1069e | 246 | tickerMetronome.detach(); // only one attachment. |
gatedClock | 17:cd6c76be8046 | 247 | tickerMetronome.attach(&interrupt_service_M,fMetroDelay); |
gatedClock | 17:cd6c76be8046 | 248 | led3_on(); |
gatedClock | 17:cd6c76be8046 | 249 | timeoutDutyCycle.attach(&led3_off,fMetroDuty); |
gatedClock | 17:cd6c76be8046 | 250 | } else led3_off(); |
gatedClock | 17:cd6c76be8046 | 251 | } |
gatedClock | 17:cd6c76be8046 | 252 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 18:f19721f1069e | 253 | void turn_off_metronome(void) // turn off metronome. |
gatedClock | 17:cd6c76be8046 | 254 | { |
gatedClock | 17:cd6c76be8046 | 255 | cMetronomeOn = 0; |
gatedClock | 17:cd6c76be8046 | 256 | } |
gatedClock | 17:cd6c76be8046 | 257 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 258 | void led3_off(void) {led3 = 0;} // turn off the LED. |
gatedClock | 0:1013288b8e43 | 259 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 260 | void led3_on( void) {led3 = 1;} // turn on the led. |
gatedClock | 15:7c0a94d2a439 | 261 | /*----------------------------------------------//----------------------------*/ |