University of Plymouth - Stages 1, 2 and 3
2019
Revision 0:65e4972b64a9, committed 2019-09-20
- Comitter:
- noutram
- Date:
- Fri Sep 20 14:12:39 2019 +0000
- Child:
- 1:9124e866b4e6
- Commit message:
- 2019
Changed in this revision
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/.gitignore Fri Sep 20 14:12:39 2019 +0000 @@ -0,0 +1,4 @@ +.build +.mbed +projectfiles +*.py*
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Fri Sep 20 14:12:39 2019 +0000 @@ -0,0 +1,87 @@ +# Getting started with Blinky on mbed OS + +This guide reviews 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). + +## Import 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`, and specify 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 see 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. + +The LED on your platform turns on and off. + +## 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 `>1.0.0` + + ``` + mbed --version + ``` + + If not, you can update it: + + ``` + 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 32 KB restriction on code size. \ No newline at end of file
Binary file img/uvision.png has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/main.cpp Fri Sep 20 14:12:39 2019 +0000
@@ -0,0 +1,92 @@
+#include "mbed.h"
+void countUp();
+void countDown();
+
+#define N 1000000
+#define RELEASED 0
+#define PRESSED 1
+
+//Hardware
+DigitalOut red_led(PE_15); //CountUp is in its critical section
+DigitalOut yellow_led(PB_10); //CountDown is in its critical section
+DigitalOut green_led(PB_11); //counter != 0
+DigitalIn button(USER_BUTTON);
+
+//Additional Threads
+Thread t1;
+Thread t2;
+
+//MUTEX Lock to avoid data corruption
+Mutex mutex;
+
+//Shared mutable state
+volatile long long counter = 0; //Volatile means it must be stored in memory
+
+//Increment the shared variable
+void countUp()
+{
+ //RED MEANS THE COUNT UP FUNCTION IS IN ITS CRITICAL SECTION
+ red_led = 1;
+ for (unsigned int n=0; n<N; n++) {
+ mutex.lock();
+ counter++;
+ counter++;
+ counter++;
+ counter++;
+ counter++;
+ counter++;
+ counter++;
+ counter++;
+ counter++;
+ counter++;
+ mutex.unlock();
+ }
+ red_led = 0;
+
+}
+
+//Decrement the shared variable
+void countDown()
+{
+ //YELLOW MEANS THE COUNT DOWN FUNCTION IS IN ITS CRITICAL SECTION
+ yellow_led = 1;
+ for (unsigned int n=0; n<N; n++) {
+ mutex.lock();
+ counter--;
+ counter--;
+ counter--;
+ counter--;
+ counter--;
+ counter--;
+ counter--;
+ counter--;
+ counter--;
+ counter--;
+ mutex.unlock();
+ }
+ yellow_led = 0;
+
+}
+int main() {
+
+ green_led = 1;
+
+ //Start competing threads
+ t1.start(countUp);
+ t2.start(countDown);
+
+ //These threads DO exit, so let's wait for BOTH to finish
+ t1.join(); //Wait for thread t1 to finish
+ t2.join(); //Wait for thread t2 to finish
+
+ //Did the counter end up at zero?
+ if (counter == 0) {
+ green_led = 0;
+ }
+
+ //Now spin-lock for ever
+ while(1) {
+ asm("nop");
+ };
+}
+
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mbed-os.lib Fri Sep 20 14:12:39 2019 +0000 @@ -0,0 +1,1 @@ +https://github.com/ARMmbed/mbed-os/#1bf6b20df9d3cd5f29f001ffc6f0d0fcbbb96118