Felipe Neves
/
TEN_mbedos_mutex
TEN MBED OS Course mutex lab
Revision 0:8b346455add1, committed 2017-01-29
- Comitter:
- uLipe
- Date:
- Sun Jan 29 20:41:53 2017 +0000
- Commit message:
- first;
Changed in this revision
diff -r 000000000000 -r 8b346455add1 .gitignore --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/.gitignore Sun Jan 29 20:41:53 2017 +0000 @@ -0,0 +1,4 @@ +.build +.mbed +projectfiles +*.py*
diff -r 000000000000 -r 8b346455add1 README.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Sun Jan 29 20:41:53 2017 +0000 @@ -0,0 +1,89 @@ +# Getting started with Blinky on mbed OS + +This is a very simple guide, reviewing the steps required to get Blinky working on an mbed OS platform. + +Please install [mbed CLI](https://github.com/ARMmbed/mbed-cli#installing-mbed-cli). + +## Get the example application! + +From the command line, import the example: + +``` +mbed import mbed-os-example-blinky +cd mbed-os-example-blinky +``` + +### Now compile + +Invoke `mbed compile` specifying the name of your platform and your favorite toolchain (`GCC_ARM`, `ARM`, `IAR`). For example, for the ARM Compiler 5: + +``` +mbed compile -m K64F -t ARM +``` + +Your PC may take a few minutes to compile your code. At the end you should get the following result: + +``` +[snip] ++----------------------------+-------+-------+------+ +| Module | .text | .data | .bss | ++----------------------------+-------+-------+------+ +| Misc | 13939 | 24 | 1372 | +| core/hal | 16993 | 96 | 296 | +| core/rtos | 7384 | 92 | 4204 | +| features/FEATURE_IPV4 | 80 | 0 | 176 | +| frameworks/greentea-client | 1830 | 60 | 44 | +| frameworks/utest | 2392 | 512 | 292 | +| Subtotals | 42618 | 784 | 6384 | ++----------------------------+-------+-------+------+ +Allocated Heap: unknown +Allocated Stack: unknown +Total Static RAM memory (data + bss): 7168 bytes +Total RAM memory (data + bss + heap + stack): 7168 bytes +Total Flash memory (text + data + misc): 43402 bytes +Image: .\.build\K64F\ARM\mbed-os-example-blinky.bin +``` + +### Program your board + +1. Connect your mbed device to the computer over USB. +1. Copy the binary file to the mbed device . +1. Press the reset button to start the program. + +You should see the LED of your platform turning on and off. + +Congratulations if you managed to complete this test! + +## Export the project to Keil MDK and debug your application + +From the command line, run the following command: + +``` +mbed export -m K64F -i uvision +``` + +To debug the application: + +1. Start uVision. +1. Import the uVision project generated earlier. +1. Compile your application and generate an `.axf` file. +1. Make sure uVision is configured to debug over CMSIS-DAP (From the Project menu > Options for Target '...' > Debug tab > Use CMSIS-DAP Debugger). +1. Set breakpoints and start a debug session. + +![Image of uVision](img/uvision.png) + +## Troubleshooting + +1. Make sure `mbed-cli` is working correctly and its version is greater than `0.8.9` + + ``` + mbed --version + ``` + + If not, you can update it easily: + + ``` + pip install mbed-cli --upgrade + ``` + +2. If using Keil MDK, make sure you have a license installed. [MDK-Lite](http://www.keil.com/arm/mdk.asp) has a 32KB restriction on code size.
diff -r 000000000000 -r 8b346455add1 img/uvision.png Binary file img/uvision.png has changed
diff -r 000000000000 -r 8b346455add1 main.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/main.cpp Sun Jan 29 20:41:53 2017 +0000 @@ -0,0 +1,98 @@ +/** + * @brief first thread control program with MBED OS + */ +#include "mbed.h" +#include "rtos.h" + +/* declares threads for this demo: */ +const size_t a_stk_size = 1024; +uint8_t a_stk[a_stk_size]; +Thread a_thread(osPriorityNormal, a_stk_size, &a_stk[0]); + +const size_t b_stk_size = 1024; +uint8_t b_stk[b_stk_size]; +Thread b_thread(osPriorityNormal, b_stk_size, &b_stk[0]); + +const size_t printer_stk_size = 2048; +uint8_t printer_stk[printer_stk_size]; +Thread printer_thread(osPriorityHigh, printer_stk_size, &printer_stk[0]); + +/* semaphore to simulate a io driver*/ +Semaphore sema; + +/* Mutex declared to share resource */ +Mutex mtx; + +/* reserve the debbuger uart to shell interface */ +Serial pc_serial(USBTX,USBRX); + +/* ram buffer to be acessed for both a and b threads */ +char ram_console[1024]; + +/** + * @brief thread a function + */ +static void thread_a(void) +{ + const char message[] = {"thread_a writes: Hocus Pocus! Simsalabim!"}; + + for(;;) { + a_thread.wait(10); + /* protect the resource */ + mtx.lock(); + memcpy(&ram_console, &message, sizeof(message)); + sema.release(); + /* release the protected resource */ + mtx.unlock(); + } +} + + +/** + * @brief thread a function + */ +static void thread_b(void) +{ + const char message[] = {"thread_b writes: Abracadabra!"}; + + for(;;) { + b_thread.wait(10); + /* protect the resource */ + mtx.lock(); + memcpy(&ram_console, &message, sizeof(message)); + sema.release(); + /* release the protected resource */ + mtx.unlock(); + } +} + +/** + * @brief thread printer function + */ +static void thread_printer(void) +{ + + for(;;) { + sema.wait(osWaitForever); + /* prints the contents of buffer */ + pc_serial.printf("##[PRINTER_OUT]: %s ## \n\r", ram_console); + + for(int i = 0; i < 0xFFFFFF; i++); + + /* flushes the I/O console */ + memset(&ram_console, 0, sizeof(ram_console)); + } +} + + +/** + * @brief main application loop + */ +int main(void) +{ + pc_serial.baud(115200); + a_thread.start(thread_a); + b_thread.start(thread_b); + printer_thread.start(thread_printer); + return 0; +} \ No newline at end of file
diff -r 000000000000 -r 8b346455add1 mbed-os.lib --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mbed-os.lib Sun Jan 29 20:41:53 2017 +0000 @@ -0,0 +1,1 @@ +https://github.com/ARMmbed/mbed-os/#34c1facf42a174f47fdf9002cd8c6bf10ac41744