# OverView

The XDK Wi-Fi API is a part of the XDK platform section and accesses the Texas Instruments Simplelink Library that is part of the library section. The Simplelink library provides a low level access to the CC3100 Wi-Fi chip of the XDK-Hardware.

![](https://1555789063-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lj1MxDmShTQrCAMd7Sr%2F-Lj1MyjBj93yCY6nPMFc%2F-Lj1NZKwwOFVbccfTTCW%2Fimport18.png?generation=1562334349285329\&alt=media)

This section will demonstrate some functions of the two main APIs for Wi-Fi. Those are

* `BCDS_WlanConnect.h`

   for the Wi-Fi connection interface
* `BCDS_NetworkConfig.h`

   for the Wi-Fi configuration interface

The `BCDS_WlanConnect.h` interface provides several functions to make the Wi-Fi Hardware available and to do things like searching for networks or initiating a connection to them. In general, this interface provides the connection functions of the API.

| Function                          | Description                                                                                                       |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `WlanConnect_init()`              | Initialize Wi-Fi driver and Wi-Fi stack. This function must be called before calling any other Wi-Fi API function |
| `WlanConnect_DeInit()`            | Deinitialize the Wi-Fi driver and the Wi-Fi stack                                                                 |
| `WlanConnect_ScanNetworks()`      | Scan for surrounded Wi-Fi networks                                                                                |
| `WlanConnect_Open()`              | Connect to a network without security permissions                                                                 |
| `WlanConnect_WPA()`               | Connect to a network with a WPA passphrase                                                                        |
| `WlanConnect_Disconnect()`        | Disconnect the current network connection                                                                         |
| `WlanConnect_CurrentNwStatus_T()` | Delivers the current status of the Wi-Fi network connection                                                       |

The `BCDS_NetworkConfig.h` interface provides basic functions to make general connection settings and to get informations about the current network connection.

| `NetworkConfig_Ipv4Value()`     | Convert a given IP in a hexadecimal state                                             |
| ------------------------------- | ------------------------------------------------------------------------------------- |
| `NetworkConfig_Ipv4Byte()`      | Extract a byte from an acquired IP address                                            |
| `NetworkConfig_SetIpStatic()`   | Set the configuration to a static IP                                                  |
| `NetworkConfig_SetIpDhcp()`     | Set the configuration to dynamic IP by using DHCP                                     |
| `NetworkConfig_GetIpSettings()` | Handle Wi-Fi IP settings. Return a structure that includes the connection information |