JGtoJR
Dependencies: MODSERIAL Watchdog
README.md@0:1c1c9f47b8ad, 2017-06-15 (annotated)
- Committer:
- JavierGC
- Date:
- Thu Jun 15 12:01:36 2017 +0000
- Revision:
- 0:1c1c9f47b8ad
JG_to_JR
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
JavierGC | 0:1c1c9f47b8ad | 1 | # Getting started with Blinky on mbed OS |
JavierGC | 0:1c1c9f47b8ad | 2 | |
JavierGC | 0:1c1c9f47b8ad | 3 | This guide reviews the steps required to get Blinky working on an mbed OS platform. |
JavierGC | 0:1c1c9f47b8ad | 4 | |
JavierGC | 0:1c1c9f47b8ad | 5 | Please install [mbed CLI](https://github.com/ARMmbed/mbed-cli#installing-mbed-cli). |
JavierGC | 0:1c1c9f47b8ad | 6 | |
JavierGC | 0:1c1c9f47b8ad | 7 | ## Import the example application |
JavierGC | 0:1c1c9f47b8ad | 8 | |
JavierGC | 0:1c1c9f47b8ad | 9 | From the command-line, import the example: |
JavierGC | 0:1c1c9f47b8ad | 10 | |
JavierGC | 0:1c1c9f47b8ad | 11 | ``` |
JavierGC | 0:1c1c9f47b8ad | 12 | mbed import mbed-os-example-blinky |
JavierGC | 0:1c1c9f47b8ad | 13 | cd mbed-os-example-blinky |
JavierGC | 0:1c1c9f47b8ad | 14 | ``` |
JavierGC | 0:1c1c9f47b8ad | 15 | |
JavierGC | 0:1c1c9f47b8ad | 16 | ### Now compile |
JavierGC | 0:1c1c9f47b8ad | 17 | |
JavierGC | 0:1c1c9f47b8ad | 18 | 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: |
JavierGC | 0:1c1c9f47b8ad | 19 | |
JavierGC | 0:1c1c9f47b8ad | 20 | ``` |
JavierGC | 0:1c1c9f47b8ad | 21 | mbed compile -m K64F -t ARM |
JavierGC | 0:1c1c9f47b8ad | 22 | ``` |
JavierGC | 0:1c1c9f47b8ad | 23 | |
JavierGC | 0:1c1c9f47b8ad | 24 | Your PC may take a few minutes to compile your code. At the end, you see the following result: |
JavierGC | 0:1c1c9f47b8ad | 25 | |
JavierGC | 0:1c1c9f47b8ad | 26 | ``` |
JavierGC | 0:1c1c9f47b8ad | 27 | [snip] |
JavierGC | 0:1c1c9f47b8ad | 28 | +----------------------------+-------+-------+------+ |
JavierGC | 0:1c1c9f47b8ad | 29 | | Module | .text | .data | .bss | |
JavierGC | 0:1c1c9f47b8ad | 30 | +----------------------------+-------+-------+------+ |
JavierGC | 0:1c1c9f47b8ad | 31 | | Misc | 13939 | 24 | 1372 | |
JavierGC | 0:1c1c9f47b8ad | 32 | | core/hal | 16993 | 96 | 296 | |
JavierGC | 0:1c1c9f47b8ad | 33 | | core/rtos | 7384 | 92 | 4204 | |
JavierGC | 0:1c1c9f47b8ad | 34 | | features/FEATURE_IPV4 | 80 | 0 | 176 | |
JavierGC | 0:1c1c9f47b8ad | 35 | | frameworks/greentea-client | 1830 | 60 | 44 | |
JavierGC | 0:1c1c9f47b8ad | 36 | | frameworks/utest | 2392 | 512 | 292 | |
JavierGC | 0:1c1c9f47b8ad | 37 | | Subtotals | 42618 | 784 | 6384 | |
JavierGC | 0:1c1c9f47b8ad | 38 | +----------------------------+-------+-------+------+ |
JavierGC | 0:1c1c9f47b8ad | 39 | Allocated Heap: unknown |
JavierGC | 0:1c1c9f47b8ad | 40 | Allocated Stack: unknown |
JavierGC | 0:1c1c9f47b8ad | 41 | Total Static RAM memory (data + bss): 7168 bytes |
JavierGC | 0:1c1c9f47b8ad | 42 | Total RAM memory (data + bss + heap + stack): 7168 bytes |
JavierGC | 0:1c1c9f47b8ad | 43 | Total Flash memory (text + data + misc): 43402 bytes |
JavierGC | 0:1c1c9f47b8ad | 44 | Image: .\.build\K64F\ARM\mbed-os-example-blinky.bin |
JavierGC | 0:1c1c9f47b8ad | 45 | ``` |
JavierGC | 0:1c1c9f47b8ad | 46 | |
JavierGC | 0:1c1c9f47b8ad | 47 | ### Program your board |
JavierGC | 0:1c1c9f47b8ad | 48 | |
JavierGC | 0:1c1c9f47b8ad | 49 | 1. Connect your mbed device to the computer over USB. |
JavierGC | 0:1c1c9f47b8ad | 50 | 1. Copy the binary file to the mbed device. |
JavierGC | 0:1c1c9f47b8ad | 51 | 1. Press the reset button to start the program. |
JavierGC | 0:1c1c9f47b8ad | 52 | |
JavierGC | 0:1c1c9f47b8ad | 53 | The LED on your platform turns on and off. |
JavierGC | 0:1c1c9f47b8ad | 54 | |
JavierGC | 0:1c1c9f47b8ad | 55 | ## Export the project to Keil MDK, and debug your application |
JavierGC | 0:1c1c9f47b8ad | 56 | |
JavierGC | 0:1c1c9f47b8ad | 57 | From the command-line, run the following command: |
JavierGC | 0:1c1c9f47b8ad | 58 | |
JavierGC | 0:1c1c9f47b8ad | 59 | ``` |
JavierGC | 0:1c1c9f47b8ad | 60 | mbed export -m K64F -i uvision |
JavierGC | 0:1c1c9f47b8ad | 61 | ``` |
JavierGC | 0:1c1c9f47b8ad | 62 | |
JavierGC | 0:1c1c9f47b8ad | 63 | To debug the application: |
JavierGC | 0:1c1c9f47b8ad | 64 | |
JavierGC | 0:1c1c9f47b8ad | 65 | 1. Start uVision. |
JavierGC | 0:1c1c9f47b8ad | 66 | 1. Import the uVision project generated earlier. |
JavierGC | 0:1c1c9f47b8ad | 67 | 1. Compile your application, and generate an `.axf` file. |
JavierGC | 0:1c1c9f47b8ad | 68 | 1. Make sure uVision is configured to debug over CMSIS-DAP (From the Project menu > Options for Target '...' > Debug tab > Use CMSIS-DAP Debugger). |
JavierGC | 0:1c1c9f47b8ad | 69 | 1. Set breakpoints, and start a debug session. |
JavierGC | 0:1c1c9f47b8ad | 70 | |
JavierGC | 0:1c1c9f47b8ad | 71 | ![Image of uVision](img/uvision.png) |
JavierGC | 0:1c1c9f47b8ad | 72 | |
JavierGC | 0:1c1c9f47b8ad | 73 | ## Troubleshooting |
JavierGC | 0:1c1c9f47b8ad | 74 | |
JavierGC | 0:1c1c9f47b8ad | 75 | 1. Make sure `mbed-cli` is working correctly and its version is `>1.0.0` |
JavierGC | 0:1c1c9f47b8ad | 76 | |
JavierGC | 0:1c1c9f47b8ad | 77 | ``` |
JavierGC | 0:1c1c9f47b8ad | 78 | mbed --version |
JavierGC | 0:1c1c9f47b8ad | 79 | ``` |
JavierGC | 0:1c1c9f47b8ad | 80 | |
JavierGC | 0:1c1c9f47b8ad | 81 | If not, you can update it: |
JavierGC | 0:1c1c9f47b8ad | 82 | |
JavierGC | 0:1c1c9f47b8ad | 83 | ``` |
JavierGC | 0:1c1c9f47b8ad | 84 | pip install mbed-cli --upgrade |
JavierGC | 0:1c1c9f47b8ad | 85 | ``` |
JavierGC | 0:1c1c9f47b8ad | 86 | |
JavierGC | 0:1c1c9f47b8ad | 87 | 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. |