Mike Moore
/
RTOS_HW_04
RTOS homework 4
main.cpp@3:8ff0c9c853be, 2013-08-18 (annotated)
- Committer:
- gatedClock
- Date:
- Sun Aug 18 15:38:00 2013 +0000
- Revision:
- 3:8ff0c9c853be
- Parent:
- 2:1a3acbc4d799
- Child:
- 4:67d958cc00e8
in progress.
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 | 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 | 0:1013288b8e43 | 40 | |
gatedClock | 2:1a3acbc4d799 | 41 | #define JOYUP p15 |
gatedClock | 2:1a3acbc4d799 | 42 | #define JOYDOWN p12 |
gatedClock | 2:1a3acbc4d799 | 43 | #define JOYLEFT p13 |
gatedClock | 2:1a3acbc4d799 | 44 | #define JOYRIGHT p16 |
gatedClock | 2:1a3acbc4d799 | 45 | #define JOYCENTER p14 |
gatedClock | 2:1a3acbc4d799 | 46 | |
gatedClock | 0:1013288b8e43 | 47 | #define METROMAX 800 // max. beats per minute. |
gatedClock | 0:1013288b8e43 | 48 | #define METROMIN 8 // min. beats per minute. |
gatedClock | 0:1013288b8e43 | 49 | #define UDSAMPLERATE 0.1 // how often to sample U/D joystick. |
gatedClock | 0:1013288b8e43 | 50 | #define LCDSAMPLERATE 0.1 // how often to redraw the LCD. |
gatedClock | 0:1013288b8e43 | 51 | #define PULSELENGTH 0.0625 // how long the LED-on-time is. |
gatedClock | 0:1013288b8e43 | 52 | //--global_definitions--------------------------//------------------------------ |
gatedClock | 0:1013288b8e43 | 53 | //--global_variables----------------------------//------------------------------ |
gatedClock | 0:1013288b8e43 | 54 | float fMetroDelay; // time between ticks, in seconds. |
gatedClock | 0:1013288b8e43 | 55 | float fMetroDuty; // duration of metro high, in seconds. |
gatedClock | 0:1013288b8e43 | 56 | int dMetroBPM; // master parameter. |
gatedClock | 0:1013288b8e43 | 57 | long lUpDownHowMany; // count how long up/down joystick pressed. |
gatedClock | 0:1013288b8e43 | 58 | //--global_instances----------------------------//------------------------------ |
gatedClock | 0:1013288b8e43 | 59 | C12832_LCD lcd; // LCD object. |
gatedClock | 0:1013288b8e43 | 60 | |
gatedClock | 3:8ff0c9c853be | 61 | InterruptIn iJoyStickUp (p15); // 1 if joystick up pressed. |
gatedClock | 3:8ff0c9c853be | 62 | InterruptIn iJoyStickDown (p12); // 1 if joystick down pressed. |
gatedClock | 3:8ff0c9c853be | 63 | InterruptIn iJoyStickLeft (p13); |
gatedClock | 3:8ff0c9c853be | 64 | InterruptIn iJoyStickRight (p16); |
gatedClock | 3:8ff0c9c853be | 65 | InterruptIn iJoyStickCenter(p14); // 1 if joystick middle pressed. |
gatedClock | 3:8ff0c9c853be | 66 | |
gatedClock | 3:8ff0c9c853be | 67 | DigitalOut dJoyStickUp (p15); |
gatedClock | 3:8ff0c9c853be | 68 | DigitalOut dJoyStickDown (p12); |
gatedClock | 3:8ff0c9c853be | 69 | DigitalOut dJoyStickLeft (p13); |
gatedClock | 3:8ff0c9c853be | 70 | DigitalOut dJoyStickRight (p16); |
gatedClock | 3:8ff0c9c853be | 71 | DigitalOut dJoyStickCenter(p14); |
gatedClock | 0:1013288b8e43 | 72 | |
gatedClock | 0:1013288b8e43 | 73 | DigitalOut led3(LED1); // leftmost LED. |
gatedClock | 0:1013288b8e43 | 74 | |
gatedClock | 0:1013288b8e43 | 75 | Ticker tickerMetronome; // blinking LED. |
gatedClock | 0:1013288b8e43 | 76 | Ticker tickerJoystickUD; // joystick up/down sample. |
gatedClock | 0:1013288b8e43 | 77 | Ticker tickerLCD; // display ticker. |
gatedClock | 0:1013288b8e43 | 78 | Timeout timeoutDutyCycle; // LED duty cycle delay. |
gatedClock | 0:1013288b8e43 | 79 | //-------prototypes-----------------------------//------------------------------ |
gatedClock | 0:1013288b8e43 | 80 | void initialization(); // initialize settings. |
gatedClock | 0:1013288b8e43 | 81 | void lcd_display(); // display on LCD. |
gatedClock | 0:1013288b8e43 | 82 | void interrupt_service_M(); // metronome tick. |
gatedClock | 0:1013288b8e43 | 83 | void interrupt_service_UD(); // joystick up/down sample. |
gatedClock | 0:1013288b8e43 | 84 | void led3_off(); // attachable LED control. |
gatedClock | 0:1013288b8e43 | 85 | void led3_on(); // attachable LED control. |
gatedClock | 1:5f41e2df0e85 | 86 | void ISR_up(); |
gatedClock | 1:5f41e2df0e85 | 87 | void ISR_down(); |
gatedClock | 1:5f41e2df0e85 | 88 | void ISR_right(); |
gatedClock | 1:5f41e2df0e85 | 89 | void ISR_left(); |
gatedClock | 1:5f41e2df0e85 | 90 | void ISR_center(); |
gatedClock | 0:1013288b8e43 | 91 | //==============================================//============================== |
gatedClock | 0:1013288b8e43 | 92 | int main(void) |
gatedClock | 0:1013288b8e43 | 93 | { |
gatedClock | 3:8ff0c9c853be | 94 | iJoyStickUp.rise(&ISR_up); |
gatedClock | 2:1a3acbc4d799 | 95 | |
gatedClock | 0:1013288b8e43 | 96 | } |
gatedClock | 0:1013288b8e43 | 97 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 98 | void initialization(void) // program initializations. |
gatedClock | 0:1013288b8e43 | 99 | { |
gatedClock | 0:1013288b8e43 | 100 | dMetroBPM = 60; // initialize to 60BPM. |
gatedClock | 0:1013288b8e43 | 101 | fMetroDelay = 60.0 / (float) (dMetroBPM); |
gatedClock | 0:1013288b8e43 | 102 | fMetroDuty = PULSELENGTH; // initialize LED on-duration. |
gatedClock | 0:1013288b8e43 | 103 | lUpDownHowMany = 0; |
gatedClock | 0:1013288b8e43 | 104 | } |
gatedClock | 0:1013288b8e43 | 105 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 3:8ff0c9c853be | 106 | void ISR_up(void) // metronome stop. |
gatedClock | 1:5f41e2df0e85 | 107 | { |
gatedClock | 3:8ff0c9c853be | 108 | int dPressedSeconds; // how many seconds joystick pressed. |
gatedClock | 3:8ff0c9c853be | 109 | int dMultiCount; // slow count rate. |
gatedClock | 3:8ff0c9c853be | 110 | char cDiscontinuity; // 1 = break phase & change BPM now. |
gatedClock | 3:8ff0c9c853be | 111 | |
gatedClock | 3:8ff0c9c853be | 112 | cDiscontinuity = 0; // don't break phase. |
gatedClock | 3:8ff0c9c853be | 113 | |
gatedClock | 3:8ff0c9c853be | 114 | // calculate slow rate period. |
gatedClock | 3:8ff0c9c853be | 115 | dMultiCount = (int) ((float) (1.0 / ((float) UDSAMPLERATE))); |
gatedClock | 3:8ff0c9c853be | 116 | |
gatedClock | 3:8ff0c9c853be | 117 | if (dJoyStickUp) // joystick up. |
gatedClock | 3:8ff0c9c853be | 118 | { |
gatedClock | 3:8ff0c9c853be | 119 | // rate-range calculations. |
gatedClock | 3:8ff0c9c853be | 120 | dPressedSeconds = (int) (((float) lUpDownHowMany) * UDSAMPLERATE); |
gatedClock | 3:8ff0c9c853be | 121 | if (dPressedSeconds < 5) {if (!(lUpDownHowMany % dMultiCount)) dMetroBPM ++;} |
gatedClock | 3:8ff0c9c853be | 122 | else |
gatedClock | 3:8ff0c9c853be | 123 | if (dPressedSeconds < 10) dMetroBPM++; |
gatedClock | 3:8ff0c9c853be | 124 | else dMetroBPM += 5; |
gatedClock | 3:8ff0c9c853be | 125 | lUpDownHowMany++; // joystick holddown time. |
gatedClock | 3:8ff0c9c853be | 126 | } |
gatedClock | 1:5f41e2df0e85 | 127 | } |
gatedClock | 1:5f41e2df0e85 | 128 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 3:8ff0c9c853be | 129 | void ISR_down(void) // metronome START. |
gatedClock | 1:5f41e2df0e85 | 130 | { |
gatedClock | 1:5f41e2df0e85 | 131 | } |
gatedClock | 1:5f41e2df0e85 | 132 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 3:8ff0c9c853be | 133 | void ISR_left(void) // increase BPM. |
gatedClock | 1:5f41e2df0e85 | 134 | { |
gatedClock | 1:5f41e2df0e85 | 135 | } |
gatedClock | 1:5f41e2df0e85 | 136 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 3:8ff0c9c853be | 137 | void ISR_right(void) // decrease BPM. |
gatedClock | 1:5f41e2df0e85 | 138 | { |
gatedClock | 1:5f41e2df0e85 | 139 | } |
gatedClock | 1:5f41e2df0e85 | 140 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 3:8ff0c9c853be | 141 | void ISR_center(void) // set BPM = 60. |
gatedClock | 1:5f41e2df0e85 | 142 | { |
gatedClock | 1:5f41e2df0e85 | 143 | } |
gatedClock | 1:5f41e2df0e85 | 144 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 145 | void lcd_display(void) // display metronome info. |
gatedClock | 0:1013288b8e43 | 146 | { |
gatedClock | 0:1013288b8e43 | 147 | lcd.cls(); // clear display. |
gatedClock | 0:1013288b8e43 | 148 | |
gatedClock | 0:1013288b8e43 | 149 | LCD1; // line 1. |
gatedClock | 0:1013288b8e43 | 150 | lcd.printf(" METRONOME"); |
gatedClock | 0:1013288b8e43 | 151 | |
gatedClock | 0:1013288b8e43 | 152 | LCD2; // line 2. |
gatedClock | 0:1013288b8e43 | 153 | |
gatedClock | 0:1013288b8e43 | 154 | if (dMetroBPM == METROMIN) // BPM, with saturation notification. |
gatedClock | 0:1013288b8e43 | 155 | lcd.printf(" %5.2d BPM minimum",dMetroBPM); |
gatedClock | 0:1013288b8e43 | 156 | else |
gatedClock | 0:1013288b8e43 | 157 | if (dMetroBPM == METROMAX) |
gatedClock | 0:1013288b8e43 | 158 | lcd.printf(" %5.2d BPM maximum",dMetroBPM); |
gatedClock | 0:1013288b8e43 | 159 | else |
gatedClock | 0:1013288b8e43 | 160 | lcd.printf(" %5.2d BPM",dMetroBPM); |
gatedClock | 0:1013288b8e43 | 161 | |
gatedClock | 0:1013288b8e43 | 162 | LCD3; // line 3. |
gatedClock | 0:1013288b8e43 | 163 | |
gatedClock | 0:1013288b8e43 | 164 | lcd.printf(" RTOS HW 3 PART 1"); |
gatedClock | 0:1013288b8e43 | 165 | } |
gatedClock | 0:1013288b8e43 | 166 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 167 | // this metronome tick ISR will self-adjust to the current user-selected |
gatedClock | 0:1013288b8e43 | 168 | // metronome rate. that has to be done here, and at the start of the function, |
gatedClock | 0:1013288b8e43 | 169 | // in order to maintain a constant phase and to prevent a beat-skip. |
gatedClock | 0:1013288b8e43 | 170 | |
gatedClock | 0:1013288b8e43 | 171 | void interrupt_service_M() // metronome tick. |
gatedClock | 0:1013288b8e43 | 172 | { |
gatedClock | 0:1013288b8e43 | 173 | tickerMetronome.detach(); // only one attachment. |
gatedClock | 0:1013288b8e43 | 174 | tickerMetronome.attach(&interrupt_service_M,fMetroDelay); |
gatedClock | 0:1013288b8e43 | 175 | led3 = 1; |
gatedClock | 0:1013288b8e43 | 176 | timeoutDutyCycle.attach(&led3_off,fMetroDuty); |
gatedClock | 0:1013288b8e43 | 177 | } |
gatedClock | 0:1013288b8e43 | 178 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 179 | // this routine measures the number of seconds for which the joystick is |
gatedClock | 0:1013288b8e43 | 180 | // in the up or down position. for three ranges of time, three different |
gatedClock | 0:1013288b8e43 | 181 | // BPM rates-of-change are used. This means that as the user controls the |
gatedClock | 0:1013288b8e43 | 182 | // metronome rate using the joystick, at first it will change slowly, then |
gatedClock | 0:1013288b8e43 | 183 | // it will change at a moderate speed, then it will change quickly. |
gatedClock | 0:1013288b8e43 | 184 | // additionally, pressing the center joystick button will bring the metronome |
gatedClock | 0:1013288b8e43 | 185 | // back to 60BPM immediately, breaking BPM phase continuity. |
gatedClock | 0:1013288b8e43 | 186 | void interrupt_service_UD(void) // joystick up/down sample |
gatedClock | 0:1013288b8e43 | 187 | { |
gatedClock | 0:1013288b8e43 | 188 | int dPressedSeconds; // how many seconds joystick pressed. |
gatedClock | 0:1013288b8e43 | 189 | int dMultiCount; // slow count rate. |
gatedClock | 0:1013288b8e43 | 190 | char cDiscontinuity; // 1 = break phase & change BPM now. |
gatedClock | 0:1013288b8e43 | 191 | |
gatedClock | 0:1013288b8e43 | 192 | cDiscontinuity = 0; // don't break phase. |
gatedClock | 0:1013288b8e43 | 193 | |
gatedClock | 0:1013288b8e43 | 194 | // calculate slow rate period. |
gatedClock | 0:1013288b8e43 | 195 | dMultiCount = (int) ((float) (1.0 / ((float) UDSAMPLERATE))); |
gatedClock | 0:1013288b8e43 | 196 | |
gatedClock | 3:8ff0c9c853be | 197 | if (dJoyStickUp) // joystick up. |
gatedClock | 0:1013288b8e43 | 198 | { |
gatedClock | 0:1013288b8e43 | 199 | // rate-range calculations. |
gatedClock | 0:1013288b8e43 | 200 | dPressedSeconds = (int) (((float) lUpDownHowMany) * UDSAMPLERATE); |
gatedClock | 0:1013288b8e43 | 201 | if (dPressedSeconds < 5) {if (!(lUpDownHowMany % dMultiCount)) dMetroBPM ++;} |
gatedClock | 0:1013288b8e43 | 202 | else |
gatedClock | 0:1013288b8e43 | 203 | if (dPressedSeconds < 10) dMetroBPM++; |
gatedClock | 0:1013288b8e43 | 204 | else dMetroBPM += 5; |
gatedClock | 0:1013288b8e43 | 205 | lUpDownHowMany++; // joystick holddown time. |
gatedClock | 0:1013288b8e43 | 206 | } |
gatedClock | 0:1013288b8e43 | 207 | else |
gatedClock | 3:8ff0c9c853be | 208 | if (dJoyStickDown) // joystick down. |
gatedClock | 0:1013288b8e43 | 209 | { |
gatedClock | 0:1013288b8e43 | 210 | // rate-range calculations. |
gatedClock | 0:1013288b8e43 | 211 | dPressedSeconds = (int) (((float) lUpDownHowMany) * UDSAMPLERATE); |
gatedClock | 0:1013288b8e43 | 212 | if (dPressedSeconds < 5) {if (!(lUpDownHowMany % dMultiCount)) dMetroBPM --;} |
gatedClock | 0:1013288b8e43 | 213 | else |
gatedClock | 0:1013288b8e43 | 214 | if (dPressedSeconds < 10) dMetroBPM--; |
gatedClock | 0:1013288b8e43 | 215 | else dMetroBPM -= 5; |
gatedClock | 0:1013288b8e43 | 216 | lUpDownHowMany++; // joystick holddown time. |
gatedClock | 0:1013288b8e43 | 217 | } |
gatedClock | 0:1013288b8e43 | 218 | else lUpDownHowMany = 0; // clear when not up or down. |
gatedClock | 0:1013288b8e43 | 219 | |
gatedClock | 3:8ff0c9c853be | 220 | if (dJoyStickCenter) |
gatedClock | 0:1013288b8e43 | 221 | { |
gatedClock | 0:1013288b8e43 | 222 | dMetroBPM = 60; // center-button -> 60BPM. |
gatedClock | 0:1013288b8e43 | 223 | cDiscontinuity = 1; // pending phase-break. |
gatedClock | 0:1013288b8e43 | 224 | } |
gatedClock | 0:1013288b8e43 | 225 | // saturate metronome BPM. |
gatedClock | 0:1013288b8e43 | 226 | if (dMetroBPM > METROMAX) dMetroBPM = METROMAX; |
gatedClock | 0:1013288b8e43 | 227 | if (dMetroBPM < METROMIN) dMetroBPM = METROMIN; |
gatedClock | 0:1013288b8e43 | 228 | |
gatedClock | 0:1013288b8e43 | 229 | fMetroDelay = 60.0 / (float) (dMetroBPM); // calculate Ticker delay time. |
gatedClock | 0:1013288b8e43 | 230 | |
gatedClock | 0:1013288b8e43 | 231 | if (cDiscontinuity) // implement 60BPS now. |
gatedClock | 0:1013288b8e43 | 232 | { |
gatedClock | 0:1013288b8e43 | 233 | tickerMetronome.detach(); // only one attachment. |
gatedClock | 0:1013288b8e43 | 234 | tickerMetronome.attach(&interrupt_service_M,fMetroDelay); |
gatedClock | 0:1013288b8e43 | 235 | } |
gatedClock | 0:1013288b8e43 | 236 | |
gatedClock | 0:1013288b8e43 | 237 | } |
gatedClock | 0:1013288b8e43 | 238 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 239 | void led3_off(void) {led3 = 0;} // turn off the LED. |
gatedClock | 0:1013288b8e43 | 240 | /*----------------------------------------------//----------------------------*/ |
gatedClock | 0:1013288b8e43 | 241 | void led3_on( void) {led3 = 1;} // turn on the led. |
gatedClock | 0:1013288b8e43 | 242 | /*----------------------------------------------//----------------------------*/ |