Installing
Prerequisites
Before running your first application, you must ensure that you have the minimal set of required tools and components:
- Toolchain for your specific microcontroller.
- Development board.
- Source code for the µC/TCPI-IP stack.
- Source code for all the other Micriµm modules required by the µC/TCPI-IP stack (see section Installing#Additional Modules)
- Interface device driver compatible with your hardware for the µC/TCP-IP stack (Ethernet + PHY driver or WiFi driver).*
- Board support package (BSP) for your development board.*
- A running project for your selected RTOS.
Additional Modules
µC/TCP-IP depends on other modules to run. First, it needs the presence of a RTOS. Furthermore, µC/CPU, µC/LIB and µC/Common modules are required.
If you are using one of the two Micriµm OS, complete documentation can be found here for µC/OS-II and here for µ/COS-III. Refer to those guides for more information on the requirements, installation, configuration and running of those RTOS.
The µC/CPU module regroups the processor's hardware-dependent code. µC/CPU includes many ports for all the different CPU architectures Micriµm supports. You must therefore used the port corresponding to your specific CPU. The complete µC/CPU documentation can be found here.
The µC/LIB module is the Micriµm run-time library, implementing the most common standard library functions, macros, and constants. The complete µC/LIB documentation can be found here.
The µC/Common repository comprises multiple modules required by the µC/TCP-IP stack. Among others, the KAL module is included. KAL stands for Kernel-Abstraction Layer. It is used by µC/TCP-IP stack and other Micriµm products to interacts with the RTOS by specifying a set of generic API functions. KAL comes with the µC/OS-II and µC/OS-III ports. The complete KAL documentation can be found here.
Downloading the source code
The source code is available as open-source on Github: https://github.com/weston-embedded
If your device is not supported by Micriµm, you will need to develop your own device driver. Refer to section TCPIP Driver Manual for all the details.
Installing the Files
Once all the distribution packages have been downloaded to your host machine, extract all the files at the root of your C:\ drive for instance. The package may be extracted to any location. After extracting all the files, the directory structure should look as illustrated in Figure - Directory Tree for µC/TCP-IP . In the example, all Micriµm products sub-folders shown in Figure - Directory Tree for µC/TCP-IP will be located in C:\Micrium\Software\
. The Micriµm µC/OS-III RTOS has been chosen for this example.