FreeRTOS+ WolfSSL Demo
An executable example
DownloadThe example presented on this page is available in the following directory of the offical FreeRTOS zip file download:
IntroductionThe project presented on this page demonstrates WolfSSL being used to secure communication between a TCP/IP client and a TCP/IP server.
Hardware setupThe demo uses the FreeRTOS Windows simulator. The simulator provides an extremely convenient self contained evaluation environment because it can be built using Microsoft’s free Visual C++ Express tools, and it removes the need to use any external hardware. However, unlike when using a real FreeRTOS port, the FreeRTOS Windows simulator port does not exhibit real time behaviour.
As the FreeRTOS simulator runs in a Windows environment, the demo application also has access to, and therefore uses, the Windows TCP/IP stack and Windows loopback virtual network interface. Using the loopback interface allows the project to be used without a live network connection.
Although this demo application does not require any custom TCP/IP functionality to be included in the build, it is generally very easy to run WolfSSL on top of a popular (eg. lwIP) or custom TCP/IP stack, or other transport medium (eg. Bluetooth). WolfSSL offers an easy-to-use I/O abstraction layer allowing the user to write their own custom Input/Output functions.
Provided the application is executed on a standard Windows computer, no external hardware is necessary, and no hardware setup is necessary.
The TCP/IP server taskThe FreeRTOS TCP/IP server task is implemented in the SecureTCPServerTask.c source file. It creates a TCP/IP socket that is configured to listen for connections from the FreeRTOS TCP/IP client task. After accepting a connection, the TCP/IP server task simply writes all the data it receives through the socket to the console until the connection is closed.
A WolfSSL object is created each time a connection is accepted, and deleted each time a connection is closed.
The server behaviour is depicted in the flowchart below.
The behaviour of the RTOS server task
The TCP/IP client taskThe FreeRTOS TCP/IP client task is implemented in the SecureTCPClientTask.c source file. It creates a TCP/IP socket, then repeatedly connects the socket to the FreeRTOS TCP/IP server task, sends ten strings through the socket, before closing the socket again. A short delay is used between each iteration to prevent the server task writing to the console too quickly.
A WolfSSL object is created each time the socket is connected, and deleted each time the socket is closed.
The client behaviour is depicted in the flow chart below.
The behaviour of the RTOS client task
Building and executing the demo
Ensure Microsoft Visual C++ is installed.
The free Express version
can be used.
The Visual C++ solution file is called FreeRTOS_Plus_WolfSSL.sln, and is
located in the FreeRTOS-Plus/Demo/FreeRTOS_Plus_WolfSSL_Windows_Simulator
directory of the download. Double click the file to open Visual C++, or alternatively
open the file from within the Visual C++ IDE.
The RTOS project viewed in the Visual C++ IDE
- The source files that implement the demo application are listed in the Demo App Source folder.
- The source files that implement the encryption functionality are listed in the FreeRTOS+/WolfSSL folder.
- The source files that implement the RTOS functionality are listed in the FreeRTOS folder.
Build and execute the application.
The output generated when the demo application executes