File content as of revision 2:ea05f8a719a9:

# Getting started with NuMaker-mbed-modbus-sample on mbed OS
 
The code works on an mbed OS platform. It needs run with some NuMaker-PFM-NUC472 boards, it includes the application of Modbus protocol and RS485 port.
Please refer to the documents on the website https://github.com/OpenNuvoton/NuMaker_NuWicam_Samples/ for more details
 
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://developer.mbed.org/teams/Nuvoton/code/NuMaker-mbed-modbus-sample/
cd NuMaker-mbed-modbus-sample

```

Make shortcut for mbed-os, modbus and nvt_rs485 libraries within the folder NuMaker-mbed-modbus-sample
 
### 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                   | 18452 |   238 | 1052256 |
| drivers                |  2357 |     4 |      28 |
| features/FEATURE_LWIP  |   162 |    16 |      16 |
| hal                    |   842 |     8 |       0 |
| platform               |  1919 |    16 |      92 |
| rtos                   |   144 |     8 |       0 |
| rtos/rtx               |  6946 |   100 |    8396 |
| targets/TARGET_NUVOTON |  9538 |   272 |     312 |
| Subtotals              | 40360 |   662 | 1061100 |
+------------------------+-------+-------+---------+
Allocated Heap: unknown
Allocated Stack: unknown
Total Static RAM memory (data + bss): 1061762 bytes
Total RAM memory (data + bss + heap + stack): 1061762 bytes
Total Flash memory (text + data + misc): 41022 bytes
```
 
### 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.