WiFi Interface Setup

Including TCP-IP Stack Source Code

Include the following files in your project tree from the µC/TCP-IP source code distribution, as indicated in Figure - µC/TCP-IP Source Code. In this figure, the IP folder only shows the subfolder IPv4 as an example. If you are running with IPv6, please add the IPv6 folder instead or add both IPv4 and IPv6 folders if you want your project to support both IP versions. 

As indicated in the Figure - µC/TCP-IP Source Code, all the files in the Source folder must be added to your project tree. Furthermore, if a TCP/IP port exists for your CPU architecture inside the Ports folder, you can also include it to your project files.

Second, add the following include paths to your project’s C compiler settings:

\Micrium\Software\uC-TCPIP

\Micrium\Software\uC-TCPIP\Dev\WiFi\<device_name>

\Micrium\Software\uC-TCPIP\Dev\WiFi\Manager\Generic

Modify the Interface Device Configuration

Inside the net_dev_cfg.c file, there are different device configuration templates.

Since the example project we want to run in this section features a WiFi device, the configuration that interests us is beneath the section "EXAMPLE WIFI DEVICE CONFIGURATION".

Next, you need to modify the WiFi device configuration template as needed by your application. Refer to section Memory Configuration and  Wireless Interface Configuration for all the details on the parameters to configure.

Modify Static Configurations

As previously mentioned, the µC/TCP-IP static configurations are located in the net_cfg.h file. For this getting started guide, the template file without modification should be enough to get you started. Depending on your Interface device configuration, it is possible that you would need to adjust the µC/TCP-IP queues' configurations as listed in µC/TCP-IP Static Configuration Modifications. Refer to section Static Stack Configuration for more details on the TCP-IP queues' configurations.

Tasks Priority

The net_cfg.c file includes the three network task configurations. You will need to defined the priority of each of those tasks. The priorities will depend on the other tasks already present in your application. Refer to section Network Tasks Configuration for all the details on configuring the network tasks and their priority. 

Example Project Setup

The purpose of this example project is to setup a network host on the target board to allow it to communicate with other hosts on the network. Figure - Example Application Setup shows the project test setup for a target board with a WiFi interface. The target board has WiFi interface that allows the board to connect to a WiFi access point. In this example, a router  acts as the access point and allows the PC to be on the same network as the board. The PC’s IP address is set to 10.10.10.111 and the target’s addresses will be configured to 10.10.10.64 as it will be shown in the next section Running the Example Application.

This example project contains enough code to be able to ping the board. Therefore, after successfully running the project, You will be able to issue the following command form a command-prompt:

ping 10.10.10.64

Ping (on the PC) should reply back with the ping time to the target. µC/TCP-IP target projects connected to the test PC on the same Ethernet switch or Ethernet cross-over cable achieve ping times of less than 2 milliseconds.

After you have successfully completed and run the example project, you can use it as a starting point to run other µC/TCP-IP demos you may have purchased.

Adding Additional includes

Since the µC/TCP-IP module was added to the example project, the following include must be added to the app.c file :

#include <KAL/kal.h>
#include <Source/net.h>
#include <net_dev_????.h>
#include <net_wifi_mgr.h>
#include <net_dev_cfg.h>
#include <net_bsp.h>

Adding µC/TCP-IP application function

Before running the example application, you will need to add the new funtion, AppInit_TCPIP(), in your app.c file to initialize and setup the µC/TCP-IP stack. Section Tasks and Objects Initialization gives an example of the main application task inside which the AppInit_TCPIP() function will be called. Section WiFi Example Application gives an AppInit_TCPIP() example for a WiFi interface. 

Those code examples will need to be modified in accordance with your project setup. For example, when adding an interface, your network device configuration object name (inside net_dev_cfg.c) will need to be specify and the IP address used in the example could need to be change to match your network.

Once the source code is built and loaded into the target, the target will respond to ICMP Echo (ping) requests.