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.
- µC/TCP-IP stack must be installed properly (a running project). See Installing for further detail about how to install µC/TCP-IP.
- Source code for µC/SMTPc.
Additional Modules
µC/SMTPc depends on other modules to run. First, it needs the presence of µC/CPU, µC/LIB, and µC/TCP-IP modules.
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/TCP-IP stack is a compact, reliable, high-performance TCP/IP protocol stack which provide the socket to the application layer. The complete µC/TCP-IP documentation can be found here.
If the network security manager is to be used, a security layer module (i.e μC/SSL) is required. Please refer to the μC/SMTPc release notes document for required version information.
Optionally, it is possible to use DNS services to connect to a SMTP Server. In that scenario, the µC/DNSc module must be included and properly initialized. The µC/DNSc module is a distributed directory service for internet resources. It enables internet resources (such as servers) to be referenced by names (e.g. ‘www.weston-embedded.com’) instead of their IP addresses, that are meaningless, hard to remember, and sometimes changing over time.The complete µC/DNSc documentation can be found here.
Downloading the source code
µC/SMTPc can be downloaded from the Micrium customer portal as all the other required modules. The distribution package includes the full source code and documentation.
Depending if you bought a package or individual components, either you would find uC/SMTPc source code with the µC/TCP-IP package or you would have to download the µC/SMTPc component from the customer portal.
You can log into the Micrium customer portal at the address below to begin your download (you must have a valid license to gain access to the file):
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/SMTPc. In the example, all Micriµm products sub-folders shown in Figure - Directory Tree for µC/SMTPc will be located in C:\Micrium\Software\. The Micriµm µC/OS-III RTOS has been chosen for this example.
