This option is used to configure the pending interface wireless mode. It is not used for the active configuration until a WLAN_DRV_SET_COMMIT operation is performed.

	Note
	Not all available WLAN mode definitions will necessarily be supported by the underlying wireless hardware driver. For example the CYGPKG_NET_WIFI_BROADCOM_WWD package only supports the modes WLAN_MODE_INFRA, WLAN_MODE_MASTER and WLAN_MODE_ADHOC.

The supplied (wlan_drv_mode_t) parameter value can be one of:

This option is used to configure the pending network name (SSID). It is not used for the active configuration until a WLAN_DRV_SET_COMMIT operation is performed.

The passed (wlan_drv_essid_t) structure provides the SSID vector (upto WLAN_ESSID_MAX_SIZE bytes in length).

This option is used to configure the pending network security encoding. It is not used for the active configuration until a WLAN_DRV_SET_COMMIT operation is performed.

The (wlan_drv_sectype_t) parameter is a bitfield encoding of the desired security features. The WLAN_SECTYPE_TYPE_MASK can be used to mask out the main security type encoding:

Along with the basic security type encoding the passed parameter can contain a set of authentication and cipher flags.

The authentication type flags:

The support cipher flags:

This option is used to configure the pending network security pre-shared key value. It is not used for the active configuration until a WLAN_DRV_SET_COMMIT operation is performed.

The passed (wlan_drv_passphrase_t) structure provides the key vector (upto WLAN_SECURITY_PASSPHRASE_LEN bytes in length).

	Note
	For security reasons there is no equivalent GET operation to read the active passphrase value.

This option is used to configure the pending network security WEP key set. It is not used for the active configuration until a WLAN_DRV_SET_COMMIT operation is performed.

The passed (wlan_drv_wepkeys_t) structure contains the keys to be used for WEP authentication. The passed keys[] vector contains the binary keys when the supplied length field is either WLAN_SECURITY_WEP104_LEN or WLAN_SECURITY_WEP40_LEN. If hexadecimal ASCII representations are being supplied in the keys[] vector then the length is twice the binary key length.

The passed (wlan_drv_channel_t) value is used to configure the radio channel to be used for the interface. This is used for WLAN_MODE_ADHOC and WLAN_MODE_MASTER configurations.

	Note
	For WLAN_MODE_INFRA configurations the WiFi device will scan for the required Access Point on all the allowed channels, and so the channel set via this operation may not actually be used.

This key is used to initiate a wireless network scan. The underlying wireless device driver defines for how long a scan is actually active.

The passed (wlan_drv_scan_t) structure is used to define the callback context for the application supplied handler executed for each network found during the scanning process. A handler function pointer, with the prototype as defined in wlan.h:

typedef void (*wlan_drv_scan_callback_fn)(void *private,wlan_drv_scan_info_t *info);

is required, along with a private context pointer.

For each network found the handler is called with a suitable (wlan_drv_scan_info_t) info pointer. If the scan is terminated then a NULL info parameter is passed to the handler, and the wireless device driver scan support will no longer reference the registered callback.

The eCos scan support is designed to allow the WLAN driver to have a minimal memory footprint, and so the application is responsible for storing/caching any network information seen.

	Note
	To support this common eCos WLAN layer (allowing eCos applications to use WLAN functionality without having to have special handling for different chipset/driver combinations) when scanning there is a slight overhead in converting the driver specific scan results into the common eCos structure.

The application documented in Section 200.1, “wlan_scan” provides an example implementation using the eCos wireless network scan interface.

A non-error return for this operation indicates a WLAN capable driver.

	Note
	The CYGPKG_NET_WLAN package requires that all eCos WLAN capable drivers provide support for a successful result from the WLAN_DRV_GET_INIT config key since it is used as an indicator that a specific Ethernet driver instance is a wireless interface. If WLAN_DRV_GET_INIT returns an error then the interface does NOT support the eCos wireless features.