µC/HTTPs
The following are the steps to follow to include µC/HTTPs into your project:
- 1 The μC/HTTPs configuration files most be copied into your application directory. Those templates files can be retrieve inside the
/Micrium/Software/uC-HTTPs/Cfg/Template
folder (see Chapter 2, “Directories and Files” on page 8). The configuration files include:
...
- The
http-s_cfg.h
file - or the
http-s_instance_secure.c/.h
filesThe first file includes preprocessor’s macros related to the configuration of the HTTP server suite. Please refer to section 4-3 “μC/HTTPs Module Configuration” on page 16 for a detailed explanation of each configuration variables.
The
http-s_instance_cfg.c/.h
pair of files, defines the configuration structure for an HTTP server’s instance (see section 4-4 “μC/HTTPs Instance Configuration” on page 20 for more details). If your application requires a secured HTTP server instance, thehttp-s_instance_secure_cfg.c/.h
pair of files should be used as template instead.The configuration files includes with µC/HTTPs are templates and must be modified according to your application specific needs and constrains.
...
End of page
Table of Contents | ||
---|---|---|
|
Prerequisites
Anchor | ||||
---|---|---|---|---|
|
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/HTTP-server.
Additional Modules
µC/HTTP-server depends on other modules to run. First, it needs the presence of a RTOS. Furthermore, µC/CPU, µC/LIB, µC/Common and µC/TCP-IP modules are required.
If you are using one of the two Micriµm RTOS, complete documentation can be found for µC/OS-II and µC/OS-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/TCP-IP stack is a compact, reliable, high-performance TCP/IP protocol stack which provide the socket to the HTTP application layer. The complete µC/TCP-IP documentation can be found here.
µC/Common regroups modules use commonly by all the Micriµm products. It must therefore also be include in your project.
Downloading the Source Code
Anchor | ||||
---|---|---|---|---|
|
The source code is available as open-source on Github: https://github.com/weston-embedded
Installing the Files
Anchor | ||||
---|---|---|---|---|
|
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/HTTP-server. In the example, all Micriµm products sub-folders shown in Figure - Directory Tree for µC/HTTP-server will be located in C:\Micrium\Software\
. The Micriµm µC/OS-III RTOS has been chosen for this example.