Diff: README.md

Revision:

6:5be66d8a01d1

Child:

8:478b47fb0af6

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.md	Mon Dec 12 16:01:52 2016 +0800
@@ -0,0 +1,102 @@
+
+# Getting started with NuMaker_NuWicam_Lite on mbed OS
+ 
+It needs run with NuMaker NuWicam board, the libraries modbus.lib and nvt_rs485.lib are provided by Nuvoton. The code works on an mbed OS platform.
+ 
+Please install [mbed CLI](https://github.com/ARMmbed/mbed-cli#installing-mbed-cli).
+ 
+## Get the example application!
+
+Ontain the mbed-OS library from Windows command prompt
+
+git clone https://github.com/ARMmbed/mbed-os
+
+
+From the command line of Git Bash, for example:
+ 
+```
+hg clone https://username@developer.mbed.org/teams/Nuvoton/code/NuMaker_NuWicam_Lite/
+cd NuMaker_NuWicam_Lite
+hg clone https://developer.mbed.org/users/wclin/code/Modbus
+hg clone http://mbed.org/users/wclin/code/nvt_rs485
+```
+
+Make shortcut for mbed-os library under the folder NuMaker_NuWicam_Lite
+ 
+### 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 NUMAKER_PFM_NUC472 -t ARM
+```
+ 
+Your PC may take a few minutes to compile your code. At the end you should get the following result:
+ 
+```
++------------------------+-------+-------+---------+
+| Module                 | .text | .data |    .bss |
++------------------------+-------+-------+---------+
+| Misc                   | 20112 |   246 | 1052260 |
+| drivers                |  2303 |     4 |      56 |
+| features/FEATURE_LWIP  |   162 |    16 |      16 |
+| hal                    |   802 |     8 |       0 |
+| platform               |  1981 |    16 |      92 |
+| rtos                   |   754 |     8 |       0 |
+| rtos/rtx               |  7088 |   100 |    8396 |
+| targets/TARGET_NUVOTON | 10632 |   276 |     312 |
+| Subtotals              | 43834 |   674 | 1061132 |
++------------------------+-------+-------+---------+
+Allocated Heap: unknown
+Allocated Stack: unknown
+Total Static RAM memory (data + bss): 1061806 bytes
+Total RAM memory (data + bss + heap + stack): 1061806 bytes
+Total Flash memory (text + data + misc): 44508 bytes
+
+Object file test_env.o is not unique! It could be made from: C:\CCLi8\IoT\mbed\mbed-os\NuMaker_NuWicam_Lite\mbed-os\features/unsupported\tests\mbed\env\test_env.cpp .\mbed-os\features\frameworks\greentea-client\source\test_env.cpp
+Image: .\BUILD\NUMAKER_PFM_NUC472\ARM\NuMaker_NuWicam_Lite.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.
+ 
+Please refer to the documents at the path https://github.com/OpenNuvoton/NuMaker_NuWicam_Samples/
+ 
+## Export the project to Keil MDK and debug your application
+ 
+From the command line, run the following command:
+ 
+```
+mbed export -m NUMAKER_PFM_NUC472 -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.
+ 
+ 
\ No newline at end of file