NuMaker Modbus-RS485
Dependencies: Modbus nvt_rs485
Fork of modbus-over-rs485-sample by
Diff: README.md
- Revision:
- 2:ea05f8a719a9
- Child:
- 3:6087ac36c45f
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Tue Dec 13 11:13:47 2016 +0800 @@ -0,0 +1,99 @@ + +# 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. + + \ No newline at end of file