Before running your first application, you must ensure that you have the minimal set of required tools and components:
| * If Micrium does not support your network device driver, you will have to write your own device driver. The same goes for your BSP. However, you can contact Micriµm (support@micrium.com) to see if a BSP example exists for your development board to help you get started. Refer to section TCPIP Driver Manual for more information on writing your own Ethernet or WiFi device driver and section Network Board Support Package for writing your own BSP. |
µ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.
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.
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.
|
