Lukas Bielesch
Debugging tool for mbed enabled microcontrollers, especially for NUCLEO-F303RE and STM32F042F6P6.
Debug.h@1:dbb9fcc20d07, 2019-05-06 (annotated)
- Committer:
- bieleluk
- Date:
- Mon May 06 00:29:00 2019 +0000
- Revision:
- 1:dbb9fcc20d07
- Parent:
- 0:e36b454cc2e6
- Child:
- 2:478ba8b83e3f
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| bieleluk | 0:e36b454cc2e6 | 1 | #pragma once |
| bieleluk | 0:e36b454cc2e6 | 2 | |
| bieleluk | 0:e36b454cc2e6 | 3 | // include files |
| bieleluk | 0:e36b454cc2e6 | 4 | //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 5 | #include "mbed.h" |
| bieleluk | 0:e36b454cc2e6 | 6 | |
| bieleluk | 0:e36b454cc2e6 | 7 | // macros |
| bieleluk | 0:e36b454cc2e6 | 8 | //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 9 | #define name(var) #var |
| bieleluk | 0:e36b454cc2e6 | 10 | |
| bieleluk | 0:e36b454cc2e6 | 11 | |
| bieleluk | 0:e36b454cc2e6 | 12 | // assembly functions |
| bieleluk | 0:e36b454cc2e6 | 13 | //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 14 | extern "C" int check_1_bit(uint32_t gpiox, uint32_t offset, uint32_t pin); |
| bieleluk | 0:e36b454cc2e6 | 15 | extern "C" int check_2_bit(uint32_t gpiox, uint32_t offset, uint32_t pin); |
| bieleluk | 0:e36b454cc2e6 | 16 | extern "C" int check_alternative_mode(uint32_t gpiox, uint32_t offset, uint32_t pin); |
| bieleluk | 0:e36b454cc2e6 | 17 | extern "C" int read_word(uint32_t address, uint32_t offset); |
| bieleluk | 0:e36b454cc2e6 | 18 | |
| bieleluk | 0:e36b454cc2e6 | 19 | // structs |
| bieleluk | 0:e36b454cc2e6 | 20 | //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 21 | typedef struct Pin { |
| bieleluk | 0:e36b454cc2e6 | 22 | char port; |
| bieleluk | 0:e36b454cc2e6 | 23 | int number; |
| bieleluk | 0:e36b454cc2e6 | 24 | } pin_t; |
| bieleluk | 0:e36b454cc2e6 | 25 | |
| bieleluk | 0:e36b454cc2e6 | 26 | |
| bieleluk | 0:e36b454cc2e6 | 27 | /** Debug_serial class. |
| bieleluk | 0:e36b454cc2e6 | 28 | * Class for stepping programme and printing actual position of the running programme with optional print of one variable (int, float, char or char*). |
| bieleluk | 0:e36b454cc2e6 | 29 | * Functions printf, putc and getc are also defined in the class. |
| bieleluk | 0:e36b454cc2e6 | 30 | * |
| bieleluk | 0:e36b454cc2e6 | 31 | * Example program: |
| bieleluk | 0:e36b454cc2e6 | 32 | * @code |
| bieleluk | 0:e36b454cc2e6 | 33 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 34 | * // Author: Lukas Bielesch |
| bieleluk | 0:e36b454cc2e6 | 35 | * // Department of Measurement, Czech technical university in Prague, Czech Republic |
| bieleluk | 0:e36b454cc2e6 | 36 | * // Date of publication: 15. Apr 2019 |
| bieleluk | 0:e36b454cc2e6 | 37 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 38 | * #include "Debug.h" |
| bieleluk | 0:e36b454cc2e6 | 39 | * AnalogIn analog(PA_5); |
| bieleluk | 0:e36b454cc2e6 | 40 | * PwmOut pwm(PA_6); |
| bieleluk | 0:e36b454cc2e6 | 41 | * DigitalOut out(PA_4); |
| bieleluk | 0:e36b454cc2e6 | 42 | * Debug_serial pc(PA_2, PA_3, 115200); // |
| bieleluk | 0:e36b454cc2e6 | 43 | * |
| bieleluk | 0:e36b454cc2e6 | 44 | * int main(){ |
| bieleluk | 0:e36b454cc2e6 | 45 | * int var = 0; |
| bieleluk | 0:e36b454cc2e6 | 46 | * char character; |
| bieleluk | 0:e36b454cc2e6 | 47 | * out = 1; |
| bieleluk | 0:e36b454cc2e6 | 48 | * float pi = 3.14159265359; |
| bieleluk | 0:e36b454cc2e6 | 49 | * pc.breakpoint(__LINE__,name(pi),pi); |
| bieleluk | 0:e36b454cc2e6 | 50 | * char* arr = "this is string"; |
| bieleluk | 0:e36b454cc2e6 | 51 | * pc.breakpoint(__LINE__,name(arr),arr); |
| bieleluk | 0:e36b454cc2e6 | 52 | * pwm = 0.5; |
| bieleluk | 0:e36b454cc2e6 | 53 | * pwm.period(1); |
| bieleluk | 0:e36b454cc2e6 | 54 | * while(1){ |
| bieleluk | 0:e36b454cc2e6 | 55 | * pc.breakpoint(__LINE__,name(var),var); |
| bieleluk | 0:e36b454cc2e6 | 56 | * pc.printf("insert character\n\r"); |
| bieleluk | 0:e36b454cc2e6 | 57 | * character = pc.getc(); |
| bieleluk | 0:e36b454cc2e6 | 58 | * pc.printf("you have inserted %c\n\r",character); |
| bieleluk | 0:e36b454cc2e6 | 59 | * var++; |
| bieleluk | 1:dbb9fcc20d07 | 60 | * pc.breakpoint(__LINE__, 0x48000000); |
| bieleluk | 0:e36b454cc2e6 | 61 | * wait(1); |
| bieleluk | 0:e36b454cc2e6 | 62 | * } |
| bieleluk | 0:e36b454cc2e6 | 63 | * } |
| bieleluk | 0:e36b454cc2e6 | 64 | * @endcode |
| bieleluk | 0:e36b454cc2e6 | 65 | */ |
| bieleluk | 0:e36b454cc2e6 | 66 | //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 67 | class Debug_serial { |
| bieleluk | 0:e36b454cc2e6 | 68 | public: |
| bieleluk | 0:e36b454cc2e6 | 69 | |
| bieleluk | 0:e36b454cc2e6 | 70 | /** Create object of class Debug_serial |
| bieleluk | 0:e36b454cc2e6 | 71 | * @param tx_pin TX pin of serial port of the board |
| bieleluk | 0:e36b454cc2e6 | 72 | * @param rx_pin RX pin of serial port of the board |
| bieleluk | 0:e36b454cc2e6 | 73 | * @param baudrate desired baudrate value of debug serial port |
| bieleluk | 0:e36b454cc2e6 | 74 | */ |
| bieleluk | 0:e36b454cc2e6 | 75 | Debug_serial(PinName tx_pin, PinName rx_pin, int baudrate = 115200); |
| bieleluk | 0:e36b454cc2e6 | 76 | |
| bieleluk | 0:e36b454cc2e6 | 77 | /** Perform one breakpoint without printing variable |
| bieleluk | 0:e36b454cc2e6 | 78 | * @param line_number line number of the breakpoint |
| bieleluk | 0:e36b454cc2e6 | 79 | */ |
| bieleluk | 0:e36b454cc2e6 | 80 | void breakpoint(int line_number = -1); |
| bieleluk | 0:e36b454cc2e6 | 81 | |
| bieleluk | 0:e36b454cc2e6 | 82 | /** Perform one breakpoint and print variable of type int |
| bieleluk | 0:e36b454cc2e6 | 83 | * @param line_number Line number of the breakpoint |
| bieleluk | 0:e36b454cc2e6 | 84 | * @param name name of printed variable(max length is 19) |
| bieleluk | 0:e36b454cc2e6 | 85 | * @param variable |
| bieleluk | 0:e36b454cc2e6 | 86 | */ |
| bieleluk | 0:e36b454cc2e6 | 87 | void breakpoint(int line_number, char name[20], int variable); |
| bieleluk | 0:e36b454cc2e6 | 88 | |
| bieleluk | 0:e36b454cc2e6 | 89 | /** Perform one breakpoint and print variable of type char |
| bieleluk | 0:e36b454cc2e6 | 90 | * @param line_number Line number of the breakpoint |
| bieleluk | 0:e36b454cc2e6 | 91 | * @param name name of printed variable(max length is 19) |
| bieleluk | 0:e36b454cc2e6 | 92 | * @param variable |
| bieleluk | 0:e36b454cc2e6 | 93 | */ |
| bieleluk | 0:e36b454cc2e6 | 94 | void breakpoint(int line_number, char name[20], char variable); |
| bieleluk | 0:e36b454cc2e6 | 95 | |
| bieleluk | 0:e36b454cc2e6 | 96 | /** Perform one breakpoint and print variable of type string |
| bieleluk | 0:e36b454cc2e6 | 97 | * @param line_number Line number of the breakpoint |
| bieleluk | 0:e36b454cc2e6 | 98 | * @param name name of printed variable(max length is 19) |
| bieleluk | 0:e36b454cc2e6 | 99 | * @param variable |
| bieleluk | 0:e36b454cc2e6 | 100 | */ |
| bieleluk | 0:e36b454cc2e6 | 101 | void breakpoint(int line_number, char name[20], char * variable); |
| bieleluk | 0:e36b454cc2e6 | 102 | |
| bieleluk | 0:e36b454cc2e6 | 103 | /** Perform one breakpoint and print variable of type float |
| bieleluk | 0:e36b454cc2e6 | 104 | * @param line_number Line number of the breakpoint |
| bieleluk | 0:e36b454cc2e6 | 105 | * @param name name of printed variable(max length is 19) |
| bieleluk | 0:e36b454cc2e6 | 106 | * @param variable |
| bieleluk | 0:e36b454cc2e6 | 107 | */ |
| bieleluk | 0:e36b454cc2e6 | 108 | void breakpoint(int line_number, char name[20], float variable); |
| bieleluk | 0:e36b454cc2e6 | 109 | |
| bieleluk | 1:dbb9fcc20d07 | 110 | /** Perform one breakpoint and print one register value |
| bieleluk | 1:dbb9fcc20d07 | 111 | * @param line_number Line number of the breakpoint |
| bieleluk | 1:dbb9fcc20d07 | 112 | * @param address |
| bieleluk | 1:dbb9fcc20d07 | 113 | * @param offset |
| bieleluk | 1:dbb9fcc20d07 | 114 | */ |
| bieleluk | 1:dbb9fcc20d07 | 115 | void breakpoint(int line_number, uint32_t address, uint32_t offset = 0); |
| bieleluk | 1:dbb9fcc20d07 | 116 | |
| bieleluk | 0:e36b454cc2e6 | 117 | /** Print formatted string to debug serial port |
| bieleluk | 0:e36b454cc2e6 | 118 | * @param string |
| bieleluk | 0:e36b454cc2e6 | 119 | * @param format (optional) |
| bieleluk | 0:e36b454cc2e6 | 120 | * @returns total number of printed characters or negative value if an output error or an encoding error |
| bieleluk | 0:e36b454cc2e6 | 121 | */ |
| bieleluk | 0:e36b454cc2e6 | 122 | int printf(const char* format, ...); |
| bieleluk | 0:e36b454cc2e6 | 123 | |
| bieleluk | 0:e36b454cc2e6 | 124 | /** Print one character to debug serial port |
| bieleluk | 0:e36b454cc2e6 | 125 | * @param character |
| bieleluk | 0:e36b454cc2e6 | 126 | * @returns character written as an unsigned char cast to an int |
| bieleluk | 0:e36b454cc2e6 | 127 | */ |
| bieleluk | 0:e36b454cc2e6 | 128 | int putc(int character); |
| bieleluk | 0:e36b454cc2e6 | 129 | |
| bieleluk | 0:e36b454cc2e6 | 130 | /** Read one character from debug serial port |
| bieleluk | 0:e36b454cc2e6 | 131 | * @returns character written as an unsigned char cast to an int |
| bieleluk | 0:e36b454cc2e6 | 132 | */ |
| bieleluk | 0:e36b454cc2e6 | 133 | int getc(); |
| bieleluk | 0:e36b454cc2e6 | 134 | private: |
| bieleluk | 0:e36b454cc2e6 | 135 | int break_line[3]; //store number of lines of three previous breakpoints |
| bieleluk | 0:e36b454cc2e6 | 136 | char var[3][50]; //store variables of three previous breakpoints |
| bieleluk | 0:e36b454cc2e6 | 137 | |
| bieleluk | 0:e36b454cc2e6 | 138 | protected: |
| bieleluk | 0:e36b454cc2e6 | 139 | // objects: |
| bieleluk | 0:e36b454cc2e6 | 140 | Serial pc; //debug serial device |
| bieleluk | 0:e36b454cc2e6 | 141 | // variables: |
| bieleluk | 0:e36b454cc2e6 | 142 | int breakpoint_count; //stores number of the current breakpoint |
| bieleluk | 0:e36b454cc2e6 | 143 | // functions |
| bieleluk | 0:e36b454cc2e6 | 144 | // initialization function |
| bieleluk | 0:e36b454cc2e6 | 145 | void init(); |
| bieleluk | 0:e36b454cc2e6 | 146 | // print 3 last breakpoints |
| bieleluk | 0:e36b454cc2e6 | 147 | void print_3_breaks(int line_number); |
| bieleluk | 0:e36b454cc2e6 | 148 | // print one breakpoint |
| bieleluk | 0:e36b454cc2e6 | 149 | void print_one_break(int n); |
| bieleluk | 0:e36b454cc2e6 | 150 | // clear screen from m line up to n line |
| bieleluk | 0:e36b454cc2e6 | 151 | void clear_from_n_up_to_m(int m, int n); |
| bieleluk | 0:e36b454cc2e6 | 152 | }; |
| bieleluk | 0:e36b454cc2e6 | 153 | |
| bieleluk | 0:e36b454cc2e6 | 154 | |
| bieleluk | 0:e36b454cc2e6 | 155 | |
| bieleluk | 0:e36b454cc2e6 | 156 | |
| bieleluk | 0:e36b454cc2e6 | 157 | /** Debug_led class. |
| bieleluk | 0:e36b454cc2e6 | 158 | * Class for stepping the program with debug LED and button, that is connected to GND(default) or VCC. |
| bieleluk | 0:e36b454cc2e6 | 159 | * |
| bieleluk | 0:e36b454cc2e6 | 160 | * Example program: |
| bieleluk | 0:e36b454cc2e6 | 161 | * @code |
| bieleluk | 0:e36b454cc2e6 | 162 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 163 | * // Author: Lukas Bielesch |
| bieleluk | 0:e36b454cc2e6 | 164 | * // Department of Measurement, Czech technical university in Prague, Czech Republic |
| bieleluk | 0:e36b454cc2e6 | 165 | * // Date of publication: 15. Apr 2019 |
| bieleluk | 0:e36b454cc2e6 | 166 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 167 | * #include "Debug.h" |
| bieleluk | 0:e36b454cc2e6 | 168 | * AnalogIn analog(PA_3); |
| bieleluk | 0:e36b454cc2e6 | 169 | * PwmOut pwm(PA_4); |
| bieleluk | 0:e36b454cc2e6 | 170 | * DigitalOut out(PA_2); |
| bieleluk | 0:e36b454cc2e6 | 171 | * Debug_led deb(PA_5, PA_6, "BUTTON_VDD"); //debug led on PA5, debug button connected to VDD on PA6 |
| bieleluk | 0:e36b454cc2e6 | 172 | * int main(){ |
| bieleluk | 0:e36b454cc2e6 | 173 | * |
| bieleluk | 0:e36b454cc2e6 | 174 | * out = 1; |
| bieleluk | 0:e36b454cc2e6 | 175 | * deb.breakpoint(1); |
| bieleluk | 0:e36b454cc2e6 | 176 | * pwm = 0.5; |
| bieleluk | 0:e36b454cc2e6 | 177 | * pwm.period(1); |
| bieleluk | 0:e36b454cc2e6 | 178 | * deb.breakpoint(2); |
| bieleluk | 0:e36b454cc2e6 | 179 | * |
| bieleluk | 0:e36b454cc2e6 | 180 | * while(1){ |
| bieleluk | 0:e36b454cc2e6 | 181 | * deb.breakpoint(); |
| bieleluk | 0:e36b454cc2e6 | 182 | * pwm = pwm + 0.1; |
| bieleluk | 0:e36b454cc2e6 | 183 | * wait(2); |
| bieleluk | 0:e36b454cc2e6 | 184 | * } |
| bieleluk | 0:e36b454cc2e6 | 185 | * } |
| bieleluk | 0:e36b454cc2e6 | 186 | * @endcode |
| bieleluk | 0:e36b454cc2e6 | 187 | */ |
| bieleluk | 0:e36b454cc2e6 | 188 | // class Debug_led |
| bieleluk | 0:e36b454cc2e6 | 189 | //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 190 | class Debug_led { |
| bieleluk | 0:e36b454cc2e6 | 191 | public: |
| bieleluk | 0:e36b454cc2e6 | 192 | |
| bieleluk | 0:e36b454cc2e6 | 193 | /** Create object of class Debug_led |
| bieleluk | 0:e36b454cc2e6 | 194 | * @param led_pin pin of of debug led |
| bieleluk | 0:e36b454cc2e6 | 195 | * @param button_pin pin of of debug button |
| bieleluk | 0:e36b454cc2e6 | 196 | * @param mode mode of button connection("BUTTON_GND", "BUTTON_VCC", "BUTTON_VDD") |
| bieleluk | 0:e36b454cc2e6 | 197 | */ |
| bieleluk | 0:e36b454cc2e6 | 198 | Debug_led(PinName led_pin, PinName button_pin, char mode[11] = "BUTTON_GND"); |
| bieleluk | 0:e36b454cc2e6 | 199 | |
| bieleluk | 0:e36b454cc2e6 | 200 | /** Perform one breakpoint |
| bieleluk | 0:e36b454cc2e6 | 201 | * @param number number of flashes of LED during the breakpoint(optional) |
| bieleluk | 0:e36b454cc2e6 | 202 | */ |
| bieleluk | 0:e36b454cc2e6 | 203 | void breakpoint(int number = -1); |
| bieleluk | 0:e36b454cc2e6 | 204 | |
| bieleluk | 0:e36b454cc2e6 | 205 | private: |
| bieleluk | 0:e36b454cc2e6 | 206 | // objects |
| bieleluk | 0:e36b454cc2e6 | 207 | DigitalOut led; //debug led |
| bieleluk | 0:e36b454cc2e6 | 208 | InterruptIn button; //debug button |
| bieleluk | 0:e36b454cc2e6 | 209 | // variables |
| bieleluk | 0:e36b454cc2e6 | 210 | int button_mode; //mode of button 1->pullupt, 0->pulldown |
| bieleluk | 0:e36b454cc2e6 | 211 | volatile bool end_breakpoint; |
| bieleluk | 0:e36b454cc2e6 | 212 | int number_of_breakpoints; |
| bieleluk | 0:e36b454cc2e6 | 213 | |
| bieleluk | 0:e36b454cc2e6 | 214 | /** Initialization */ |
| bieleluk | 0:e36b454cc2e6 | 215 | void init(char mode[11]); |
| bieleluk | 0:e36b454cc2e6 | 216 | |
| bieleluk | 0:e36b454cc2e6 | 217 | /** Blinks the debug led n-times with blink period wait_time_ms */ |
| bieleluk | 0:e36b454cc2e6 | 218 | void flash_n_times(int wait_time_ms, int n); |
| bieleluk | 0:e36b454cc2e6 | 219 | |
| bieleluk | 0:e36b454cc2e6 | 220 | /** end the break after the button is pushed */ |
| bieleluk | 0:e36b454cc2e6 | 221 | void end_break(); |
| bieleluk | 0:e36b454cc2e6 | 222 | |
| bieleluk | 0:e36b454cc2e6 | 223 | |
| bieleluk | 0:e36b454cc2e6 | 224 | }; |
| bieleluk | 0:e36b454cc2e6 | 225 | |
| bieleluk | 0:e36b454cc2e6 | 226 | |
| bieleluk | 0:e36b454cc2e6 | 227 | /** Debug_register class. |
| bieleluk | 0:e36b454cc2e6 | 228 | * |
| bieleluk | 0:e36b454cc2e6 | 229 | * Example program: |
| bieleluk | 0:e36b454cc2e6 | 230 | * @code |
| bieleluk | 0:e36b454cc2e6 | 231 | * //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 232 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 233 | * // Author: Lukas Bielesch |
| bieleluk | 0:e36b454cc2e6 | 234 | * // Department of Measurement, Czech technical university in Prague, Czech Republic |
| bieleluk | 0:e36b454cc2e6 | 235 | * // Date of publication: 15. Apr 2019 |
| bieleluk | 0:e36b454cc2e6 | 236 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 237 | * #include "Debug.h" |
| bieleluk | 0:e36b454cc2e6 | 238 | * AnalogIn analog(PA_5); |
| bieleluk | 0:e36b454cc2e6 | 239 | * PwmOut pwm(PA_6); |
| bieleluk | 0:e36b454cc2e6 | 240 | * DigitalOut out(PA_4); |
| bieleluk | 0:e36b454cc2e6 | 241 | * Debug_register pc(PA_2, PA_3, 115200); |
| bieleluk | 0:e36b454cc2e6 | 242 | * |
| bieleluk | 0:e36b454cc2e6 | 243 | * int main(){ |
| bieleluk | 0:e36b454cc2e6 | 244 | * pc.breakpoint(__LINE__,0x48000000); |
| bieleluk | 0:e36b454cc2e6 | 245 | * DigitalOut out2 (PA_0); |
| bieleluk | 0:e36b454cc2e6 | 246 | * pc.breakpoint(__LINE__,0x48000000); |
| bieleluk | 0:e36b454cc2e6 | 247 | * AnalogIn analog2 (PA_1); |
| bieleluk | 0:e36b454cc2e6 | 248 | * pc.breakpoint(__LINE__,0x48000000); |
| bieleluk | 0:e36b454cc2e6 | 249 | * |
| bieleluk | 0:e36b454cc2e6 | 250 | * while(1){ |
| bieleluk | 0:e36b454cc2e6 | 251 | * if(pc.readable()){ |
| bieleluk | 0:e36b454cc2e6 | 252 | * pc.putc(pc.getc()); |
| bieleluk | 0:e36b454cc2e6 | 253 | * } |
| bieleluk | 0:e36b454cc2e6 | 254 | * wait(0.1); |
| bieleluk | 0:e36b454cc2e6 | 255 | * } |
| bieleluk | 0:e36b454cc2e6 | 256 | * } |
| bieleluk | 0:e36b454cc2e6 | 257 | * @endcode |
| bieleluk | 0:e36b454cc2e6 | 258 | */ |
| bieleluk | 0:e36b454cc2e6 | 259 | class Debug_register { |
| bieleluk | 0:e36b454cc2e6 | 260 | public: |
| bieleluk | 0:e36b454cc2e6 | 261 | |
| bieleluk | 0:e36b454cc2e6 | 262 | /** Create object of class Debug_serial |
| bieleluk | 0:e36b454cc2e6 | 263 | * @param tx_pin TX pin of serial port of the board |
| bieleluk | 0:e36b454cc2e6 | 264 | * @param rx_pin RX pin of serial port of the board |
| bieleluk | 0:e36b454cc2e6 | 265 | * @param baudrate desired baudrate value of debug serial port |
| bieleluk | 0:e36b454cc2e6 | 266 | */ |
| bieleluk | 0:e36b454cc2e6 | 267 | Debug_register(PinName tx_pin, PinName rx_pin, int baudrate = 115200); |
| bieleluk | 0:e36b454cc2e6 | 268 | |
| bieleluk | 0:e36b454cc2e6 | 269 | /** Perform one breakpoint and print one register |
| bieleluk | 0:e36b454cc2e6 | 270 | * @param line_number line number of the breakpoint |
| bieleluk | 0:e36b454cc2e6 | 271 | * @param address |
| bieleluk | 0:e36b454cc2e6 | 272 | * @param offset |
| bieleluk | 0:e36b454cc2e6 | 273 | */ |
| bieleluk | 0:e36b454cc2e6 | 274 | void breakpoint(int line_number = -1, uint32_t address = 0, uint32_t offset = 0); |
| bieleluk | 0:e36b454cc2e6 | 275 | |
| bieleluk | 0:e36b454cc2e6 | 276 | |
| bieleluk | 0:e36b454cc2e6 | 277 | |
| bieleluk | 0:e36b454cc2e6 | 278 | /** Print formatted string to debug serial port |
| bieleluk | 0:e36b454cc2e6 | 279 | * @param string |
| bieleluk | 0:e36b454cc2e6 | 280 | * @param format (optional) |
| bieleluk | 0:e36b454cc2e6 | 281 | * @returns total number of printed characters or negative value if an output error or an encoding error |
| bieleluk | 0:e36b454cc2e6 | 282 | */ |
| bieleluk | 0:e36b454cc2e6 | 283 | int printf(const char* format, ...); |
| bieleluk | 0:e36b454cc2e6 | 284 | |
| bieleluk | 0:e36b454cc2e6 | 285 | /** Print one character to debug serial port |
| bieleluk | 0:e36b454cc2e6 | 286 | * @param character |
| bieleluk | 0:e36b454cc2e6 | 287 | * @returns character written as an unsigned char cast to an int |
| bieleluk | 0:e36b454cc2e6 | 288 | */ |
| bieleluk | 0:e36b454cc2e6 | 289 | int putc(int character); |
| bieleluk | 0:e36b454cc2e6 | 290 | |
| bieleluk | 0:e36b454cc2e6 | 291 | /** Read one character from debug serial port |
| bieleluk | 0:e36b454cc2e6 | 292 | * @returns character written as an unsigned char cast to an int |
| bieleluk | 0:e36b454cc2e6 | 293 | */ |
| bieleluk | 0:e36b454cc2e6 | 294 | int getc(); |
| bieleluk | 0:e36b454cc2e6 | 295 | |
| bieleluk | 0:e36b454cc2e6 | 296 | bool readable(); |
| bieleluk | 0:e36b454cc2e6 | 297 | |
| bieleluk | 0:e36b454cc2e6 | 298 | protected: |
| bieleluk | 0:e36b454cc2e6 | 299 | // objects: |
| bieleluk | 0:e36b454cc2e6 | 300 | Serial pc; //debug serial device |
| bieleluk | 0:e36b454cc2e6 | 301 | // variables: |
| bieleluk | 0:e36b454cc2e6 | 302 | int breakpoint_count; //stores number of the current breakpoint |
| bieleluk | 0:e36b454cc2e6 | 303 | // functions |
| bieleluk | 0:e36b454cc2e6 | 304 | // initialization function |
| bieleluk | 0:e36b454cc2e6 | 305 | void init(); |
| bieleluk | 0:e36b454cc2e6 | 306 | // clear screen from m line up to n line |
| bieleluk | 0:e36b454cc2e6 | 307 | void clear_from_n_up_to_m(int m, int n); |
| bieleluk | 0:e36b454cc2e6 | 308 | }; |
| bieleluk | 0:e36b454cc2e6 | 309 | /** Debug_register_print class. |
| bieleluk | 0:e36b454cc2e6 | 310 | * |
| bieleluk | 0:e36b454cc2e6 | 311 | * Example program: |
| bieleluk | 0:e36b454cc2e6 | 312 | * @code |
| bieleluk | 0:e36b454cc2e6 | 313 | * //------------------------------------------------------------------------------------------------------------------ |
| bieleluk | 0:e36b454cc2e6 | 314 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 315 | * // Author: Lukas Bielesch |
| bieleluk | 0:e36b454cc2e6 | 316 | * // Department of Measurement, Czech technical university in Prague, Czech Republic |
| bieleluk | 0:e36b454cc2e6 | 317 | * // Date of publication: 15. Apr 2019 |
| bieleluk | 0:e36b454cc2e6 | 318 | * // ---------------------------------------------------------------------------- |
| bieleluk | 0:e36b454cc2e6 | 319 | * #include "Debug.h" |
| bieleluk | 0:e36b454cc2e6 | 320 | * AnalogIn analog(PA_5); |
| bieleluk | 0:e36b454cc2e6 | 321 | * PwmOut pwm(PA_6); |
| bieleluk | 0:e36b454cc2e6 | 322 | * DigitalOut out(PA_4); |
| bieleluk | 0:e36b454cc2e6 | 323 | * Debug_register_print pc(PA_2, PA_3, 115200); |
| bieleluk | 0:e36b454cc2e6 | 324 | * |
| bieleluk | 0:e36b454cc2e6 | 325 | * int main(){ |
| bieleluk | 0:e36b454cc2e6 | 326 | * pc.format(2,2,1,3);//breakpoint count,line number, address, value |
| bieleluk | 0:e36b454cc2e6 | 327 | * pc.breakpoint(__LINE__,0x48000000); |
| bieleluk | 0:e36b454cc2e6 | 328 | * DigitalOut out2 (PA_0); |
| bieleluk | 0:e36b454cc2e6 | 329 | * pc.breakpoint(__LINE__,0x48000000); |
| bieleluk | 0:e36b454cc2e6 | 330 | * AnalogIn analog2 (PA_1); |
| bieleluk | 0:e36b454cc2e6 | 331 | * pc.breakpoint(__LINE__,0x48000000); |
| bieleluk | 0:e36b454cc2e6 | 332 | * |
| bieleluk | 0:e36b454cc2e6 | 333 | * while(1){ |
| bieleluk | 0:e36b454cc2e6 | 334 | * wait(1); |
| bieleluk | 0:e36b454cc2e6 | 335 | * } |
| bieleluk | 0:e36b454cc2e6 | 336 | * } |
| bieleluk | 0:e36b454cc2e6 | 337 | * @endcode |
| bieleluk | 0:e36b454cc2e6 | 338 | */ |
| bieleluk | 0:e36b454cc2e6 | 339 | class Debug_register_print { |
| bieleluk | 0:e36b454cc2e6 | 340 | public: |
| bieleluk | 0:e36b454cc2e6 | 341 | |
| bieleluk | 0:e36b454cc2e6 | 342 | /** Create object of class Debug_serial |
| bieleluk | 0:e36b454cc2e6 | 343 | * @param tx_pin TX pin of serial port of the board |
| bieleluk | 0:e36b454cc2e6 | 344 | * @param rx_pin RX pin of serial port of the board |
| bieleluk | 0:e36b454cc2e6 | 345 | * @param baudrate desired baudrate value of debug serial port |
| bieleluk | 0:e36b454cc2e6 | 346 | */ |
| bieleluk | 0:e36b454cc2e6 | 347 | Debug_register_print(PinName tx_pin, PinName rx_pin, int baudrate = 115200); |
| bieleluk | 0:e36b454cc2e6 | 348 | |
| bieleluk | 0:e36b454cc2e6 | 349 | |
| bieleluk | 0:e36b454cc2e6 | 350 | void format(int break_number = 2, int line = 2, int address = 1, int value = 1); |
| bieleluk | 0:e36b454cc2e6 | 351 | |
| bieleluk | 0:e36b454cc2e6 | 352 | /** Perform one breakpoint and print one register |
| bieleluk | 0:e36b454cc2e6 | 353 | * @param line_number line number of the breakpoint |
| bieleluk | 0:e36b454cc2e6 | 354 | * @param address |
| bieleluk | 0:e36b454cc2e6 | 355 | * @param offset |
| bieleluk | 0:e36b454cc2e6 | 356 | */ |
| bieleluk | 0:e36b454cc2e6 | 357 | void breakpoint(int line_number = -1, uint32_t address = 0, uint32_t offset = 0); |
| bieleluk | 0:e36b454cc2e6 | 358 | |
| bieleluk | 0:e36b454cc2e6 | 359 | |
| bieleluk | 0:e36b454cc2e6 | 360 | protected: |
| bieleluk | 0:e36b454cc2e6 | 361 | // objects: |
| bieleluk | 0:e36b454cc2e6 | 362 | Serial pc; //debug serial device |
| bieleluk | 0:e36b454cc2e6 | 363 | // variables: |
| bieleluk | 0:e36b454cc2e6 | 364 | int breakpoint_count; //stores number of the current breakpoint |
| bieleluk | 0:e36b454cc2e6 | 365 | int count_format; |
| bieleluk | 0:e36b454cc2e6 | 366 | int line_format; |
| bieleluk | 0:e36b454cc2e6 | 367 | int address_format; |
| bieleluk | 0:e36b454cc2e6 | 368 | int register_format; |
| bieleluk | 0:e36b454cc2e6 | 369 | // functions |
| bieleluk | 0:e36b454cc2e6 | 370 | // initialization function |
| bieleluk | 0:e36b454cc2e6 | 371 | void init(); |
| bieleluk | 0:e36b454cc2e6 | 372 | |
| bieleluk | 0:e36b454cc2e6 | 373 | }; |