Felipe Neves
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
--- /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*
--- /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. + + + +## 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.
Binary file img/uvision.png has changed
--- /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
--- /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