Chapter 185. Configuration

This chapter shows how to include the WLAN support into an eCos configuration, and to configure it once installed.

185.1. Configuration Overview

The common eCos WLAN layer is contained in the package CYGPKG_NET_WLAN. However, it depends on the services of a collection of other packages for complete functionality. Currently the WLAN implementation is tightly bound with the lwIP TCP/IP networking stack provided by the CYGPKG_NET_LWIP package.

Incorporating the WLAN support into your application is straightforward. The essential starting point is to incorporate the WLAN eCos package (CYGPKG_NET_WLAN) into your configuration.

This may be achieved directly using ecosconfig add on the command line, or the Build->Packages… menu item within the eCos Configuration Tool.

185.2. Configuration Options

Once added to the eCos configuration, the WLAN package has a number of configuration options.

The CDL configuration provides default settings for the use by wireless network interfaces. The application documented in Section 187.2, “wlan_switch” provides an example implementation of using the run-time interface configuration, where appropriate, to associate with different access-points.

CYGDAT_NET_WLAN_COUNTRY
This option is used to define the regulatory domain for the radio.
CYGPKG_NET_WLAN_STAx

If infrastructure (station) interfaces are provided by the underlying wireless device driver package then a number of these STAx options become available.

CYGPKG_NET_WLAN_STAx_SSID
This option specifies the SSID (network name) that the interface should associate with.
CYGPKG_NET_WLAN_STAx_SEC
This option is used to select the security encoding required to associate with the named SSID access-point.
CYGPKG_NET_WLAN_STAx_PASS
For pre-shared key security encodings this option supplies the passphrase associated with the SSID access-point.
CYGPKG_NET_WLAN_APx

If master (access-point) or adhoc (p2p) capable interfaces are provided by the underlying wireless device driver package then a number of these APx options become available.

CYGPKG_NET_WLAN_APx_SSID
For access-point or P2P interfaces this option supplies the network name used for the connection.
CYGPKG_NET_WLAN_APx_SEC
This option specifies the security encoding exposed by the interface.
CYGPKG_NET_WLAN_APx_PASS
For pre-shared key security encoding this option defines the passphrase to be used.
CYGPKG_NET_WLAN_APx_TYPE
This option allows selection between the “Infrastructure”(master, access-point) and “Adhoc” (P2P) interface modes.
CYGPKG_NET_WLAN_APx_CHANNEL
The radio channel to be used for the interface.