Junichi Katsu / Mbed OS mbed-os-example-milkcocoa

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-os-example-mbed5-blinky by mbed-os-examples

README.md@24:6ba1245bf049, 2017-01-24 (annotated)

Committer:
jksoft
Date:
Tue Jan 24 13:41:36 2017 +0000
Revision:
24:6ba1245bf049
Parent:
14:e4cde3e77fdc 
??????????

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Jonathan Austin 0:2757d7abb7d9 1 # Getting started with Blinky on mbed OS
Jonathan Austin 0:2757d7abb7d9 2
Jonathan Austin 0:2757d7abb7d9 3 This is a very simple guide, reviewing the steps required to get Blinky working on an mbed OS platform.
Jonathan Austin 0:2757d7abb7d9 4
Jonathan Austin 0:2757d7abb7d9 5 Please install [mbed CLI](https://github.com/ARMmbed/mbed-cli#installing-mbed-cli).
Jonathan Austin 0:2757d7abb7d9 6
Jonathan Austin 0:2757d7abb7d9 7 ## Get the example application!
Jonathan Austin 0:2757d7abb7d9 8
Jonathan Austin 0:2757d7abb7d9 9 From the command line, import the example:
Jonathan Austin 0:2757d7abb7d9 10
Jonathan Austin 0:2757d7abb7d9 11 ```
Jonathan Austin 0:2757d7abb7d9 12 mbed import mbed-os-example-blinky
Jonathan Austin 0:2757d7abb7d9 13 cd mbed-os-example-blinky
Jonathan Austin 0:2757d7abb7d9 14 ```
Jonathan Austin 0:2757d7abb7d9 15
Jonathan Austin 0:2757d7abb7d9 16 ### Now compile
Jonathan Austin 0:2757d7abb7d9 17
Jonathan Austin 0:2757d7abb7d9 18 Invoke `mbed compile` specifying the name of your platform and your favorite toolchain (`GCC_ARM`, `ARM`, `IAR`). For example, for the ARM Compiler 5:
Jonathan Austin 0:2757d7abb7d9 19
Jonathan Austin 0:2757d7abb7d9 20 ```
Jonathan Austin 0:2757d7abb7d9 21 mbed compile -m K64F -t ARM
Jonathan Austin 0:2757d7abb7d9 22 ```
Jonathan Austin 0:2757d7abb7d9 23
Jonathan Austin 0:2757d7abb7d9 24 Your PC may take a few minutes to compile your code. At the end you should get the following result:
Jonathan Austin 0:2757d7abb7d9 25
Jonathan Austin 0:2757d7abb7d9 26 ```
Jonathan Austin 0:2757d7abb7d9 27 [snip]
Jonathan Austin 0:2757d7abb7d9 28 +----------------------------+-------+-------+------+
Jonathan Austin 0:2757d7abb7d9 29 | Module | .text | .data | .bss |
Jonathan Austin 0:2757d7abb7d9 30 +----------------------------+-------+-------+------+
Jonathan Austin 0:2757d7abb7d9 31 | Misc | 13939 | 24 | 1372 |
Jonathan Austin 0:2757d7abb7d9 32 | core/hal | 16993 | 96 | 296 |
Jonathan Austin 0:2757d7abb7d9 33 | core/rtos | 7384 | 92 | 4204 |
Jonathan Austin 0:2757d7abb7d9 34 | features/FEATURE_IPV4 | 80 | 0 | 176 |
Jonathan Austin 0:2757d7abb7d9 35 | frameworks/greentea-client | 1830 | 60 | 44 |
Jonathan Austin 0:2757d7abb7d9 36 | frameworks/utest | 2392 | 512 | 292 |
Jonathan Austin 0:2757d7abb7d9 37 | Subtotals | 42618 | 784 | 6384 |
Jonathan Austin 0:2757d7abb7d9 38 +----------------------------+-------+-------+------+
Jonathan Austin 0:2757d7abb7d9 39 Allocated Heap: unknown
Jonathan Austin 0:2757d7abb7d9 40 Allocated Stack: unknown
Jonathan Austin 0:2757d7abb7d9 41 Total Static RAM memory (data + bss): 7168 bytes
Jonathan Austin 0:2757d7abb7d9 42 Total RAM memory (data + bss + heap + stack): 7168 bytes
Jonathan Austin 0:2757d7abb7d9 43 Total Flash memory (text + data + misc): 43402 bytes
Jonathan Austin 1:846c97078558 44 Image: .\.build\K64F\ARM\mbed-os-example-blinky.bin
Jonathan Austin 0:2757d7abb7d9 45 ```
Jonathan Austin 0:2757d7abb7d9 46
Jonathan Austin 0:2757d7abb7d9 47 ### Program your board
Jonathan Austin 0:2757d7abb7d9 48
Jonathan Austin 0:2757d7abb7d9 49 1. Connect your mbed device to the computer over USB.
Jonathan Austin 0:2757d7abb7d9 50 1. Copy the binary file to the mbed device .
Jonathan Austin 0:2757d7abb7d9 51 1. Press the reset button to start the program.
Jonathan Austin 0:2757d7abb7d9 52
Jonathan Austin 0:2757d7abb7d9 53 You should see the LED of your platform turning on and off.
Jonathan Austin 0:2757d7abb7d9 54
Jonathan Austin 0:2757d7abb7d9 55 Congratulations if you managed to complete this test!
Jonathan Austin 0:2757d7abb7d9 56
Jonathan Austin 0:2757d7abb7d9 57 ## Export the project to Keil MDK and debug your application
Jonathan Austin 0:2757d7abb7d9 58
Jonathan Austin 0:2757d7abb7d9 59 From the command line, run the following command:
Jonathan Austin 0:2757d7abb7d9 60
Jonathan Austin 0:2757d7abb7d9 61 ```
Jonathan Austin 1:846c97078558 62 mbed export -m K64F -i uvision
Jonathan Austin 0:2757d7abb7d9 63 ```
Jonathan Austin 0:2757d7abb7d9 64
Jonathan Austin 0:2757d7abb7d9 65 To debug the application:
Jonathan Austin 0:2757d7abb7d9 66
Jonathan Austin 0:2757d7abb7d9 67 1. Start uVision.
Jonathan Austin 0:2757d7abb7d9 68 1. Import the uVision project generated earlier.
Jonathan Austin 0:2757d7abb7d9 69 1. Compile your application and generate an `.axf` file.
Jonathan Austin 0:2757d7abb7d9 70 1. Make sure uVision is configured to debug over CMSIS-DAP (From the Project menu > Options for Target '...' > Debug tab > Use CMSIS-DAP Debugger).
Jonathan Austin 0:2757d7abb7d9 71 1. Set breakpoints and start a debug session.
Jonathan Austin 0:2757d7abb7d9 72
Jonathan Austin 0:2757d7abb7d9 73 ![Image of uVision](img/uvision.png)
Jonathan Austin 0:2757d7abb7d9 74
Jonathan Austin 0:2757d7abb7d9 75 ## Troubleshooting
Jonathan Austin 0:2757d7abb7d9 76
mbed_official 3:297fe5b2279f 77 1. Make sure `mbed-cli` is working correctly and its version is greater than `0.8.9`
Jonathan Austin 0:2757d7abb7d9 78
Jonathan Austin 0:2757d7abb7d9 79 ```
Jonathan Austin 0:2757d7abb7d9 80 mbed --version
Jonathan Austin 0:2757d7abb7d9 81 ```
Jonathan Austin 0:2757d7abb7d9 82
Jonathan Austin 0:2757d7abb7d9 83 If not, you can update it easily:
Jonathan Austin 0:2757d7abb7d9 84
Jonathan Austin 0:2757d7abb7d9 85 ```
Jonathan Austin 0:2757d7abb7d9 86 pip install mbed-cli --upgrade
Jonathan Austin 0:2757d7abb7d9 87 ```
Jonathan Austin 0:2757d7abb7d9 88
Jonathan Austin 0:2757d7abb7d9 89 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.