Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 Installing µC/HTTPs. In the example, all Micriµm products sub-folders shown in Installing µC/HTTPs will be located in C:\Micrium\Software\. The Micriµm µC/OS-III RTOS has been chosen for this example.

 

OLD

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 µC/HTTPs Directories and Files). The configuration files include:
    • The http-s_cfg.h file
    • or the http-s_instance_secure.c/.h files

    The first file includes preprocessor’s macros related to the configuration of the HTTP server suite. Please refer to µC/HTTPs Module Configuration 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 µC/HTTPs Instance Configuration for more details). If your application requires a secured HTTP server instance, the http-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.

  2. Next, include the µC/HTTPs source files to your project tree. Those files can be retrieved inside the /Micrium/Software/uC-HTTPs/Source folder.

    The OS port’s files must also be added to your project. The ports for uC/OS-II and uC/OS-III are located inside the /Micrium/Software/uC-HTTPs/OS folder.

  3. For the file system, µC/HTTPs uses the network file system layer included with µC/TCP-IP located inside the uC-TCPIP/FS folder. Therefore, the file net_fs.h inside this folder must be include to your project, no matter what file system your HTTP server is using.

    If a conventional file system is used, the port should be located also inside the uC-TCPIP/FS folder. A port for the µC/FS-V4 file system is already included in this folder. If a file system other than µC/FS is used, a port template is available inside the uC-TCPIP/FS/Template folder to be customize according to your file system.

    If the Static file system is used, the port for this file system is located inside uC/HTTPs. Therefore, the source files http-s_fs_static.c/.h must be include to your project. They are located inside the Micrium/Software/uC-HTTPs/FS/Static folder. Furthermore, The configuration file template http-s_fs_static_cfg.h must be copied in your application directory. This configuration file can be retrieve inside the Micrium/Software/uC-HTTPs/FS/Static/Cfg/Template folder.

  4. Finally, Add in your compiler include paths a path leading to µC/HTTPs and µC/TCP-IP root directories:

    /Micrium/Software/uC-HTTPs/

    /Micrium/Software/uC-TCPIP-V2/

    Since uC/HTTPs requires the use of others modules (µC/LIB, µC/CPU, RTOS, file system), the path leading to the source code of those modules must also be included in your compiler include paths. Please refer to the user manual of each module for details on the path to add.