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 use DNS services to connect to a SMTP Server. In that scenario, the µC/DNSc module must be included. 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.micrium.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.