mbed-os-example-wifi

Wi-Fi example for Mbed OS

(Note: To see this example in a rendered form you can import into the Arm Mbed Online Compiler, please see the documentation.)

Getting started with the Wi-Fi API

This is an example of a Wi-Fi application using the Wi-Fi APIs that Mbed OS provides.

The program brings up the Wi-Fi and the underlying network interface and uses it to scan available networks, connects to a network and prints interface and connection details.

For more information about Wi-Fi APIs, please visit the Mbed OS Wi-Fi documentation.

Supported hardware

All Mbed OS boards with build-in Wi-Fi module:
- u-blox ODIN-W2
- Realtek RTL8195AM
- ST DISCO IOT board with integrated ISM43362 WiFi Inventek module.
- ST DISCO_F413ZH board with integrated ISM43362 WiFi Inventek module.
- Advantech WISE-150
- USI WM-BN-BM-22
- MxChip EMW3166
Boards with external WiFi shields.
- NUCLEO-F401RE with X-NUCLEO-IDW04A1 Wi-Fi expansion board using pins D8 and D2 (of the Arduino connector).
- NUCLEO-F401RE with X-NUCLEO-IDW01M1 Wi-Fi expansion board using pins PA_9 and PA_10 (of the Morpho connector).
- NUCLEO-F429ZI with ESP8266-01 module using pins D1 and D0.
- Other Mbed targets with an ESP8266 module, X-NUCLEO-IDW04A1 or X-NUCLEO-IDW01M1 expansion board.

Adding connectivity driver

If the target does not have internal WiFi driver, or Mbed OS does not supply one, you need to add driver to your application and configure it to provide default WiFi interface.

mbed add <driver>

For example adding ISM43362 driver mbed add wifi-ism43362 or X-Nucleo-IDW01M1 driver mbed add wifi-x-nucleo-idw01m1 The ESP8266 driver is already suplied by Mbed OS.

Then pin names need to be configured as instructed in the drivers README file.

Getting started

Import the example.

mbed import mbed-os-example-wifi
cd mbed-os-example-wifi

Configure the Wi-Fi shield and settings. Edit mbed_app.json to include the correct Wi-Fi shield, SSID and password:

{
    "config": {
        "wifi-ssid": {
            "help": "WiFi SSID",
            "value": "\"SSID\""
        },
        "wifi-password": {
            "help": "WiFi Password",
            "value": "\"PASSWORD\""
        }
    },
    "target_overrides": {
        "*": {
            "platform.stdio-convert-newlines": true,
            "esp8266.provide-default" : false
        }
    }
}

For build-in WiFi, you do not need to set any provide-default values. Those are required if you use external WiFi shield.

Sample mbed_app.json files are provided for ESP8266 (mbed_app_esp8266.json), X-NUCLEO-IDW04A1 (mbed_app_idw04a1.json) and X-NUCLEO-IDW01M1 (mbed_app_idw01m1).

Compile and generate binary. For example, for GCC:
```
mbed compile -t GCC_ARM -m UBLOX_EVK_ODIN_W2
```
Open a serial console session with the target platform using the following parameters:
- Baud rate: 9600
- Data bits: 8
- Stop bits: 1
- Parity: None
Copy or drag the application mbed-os-example-wifi.bin in the folder mbed-os-example-wifi/BUILD/<TARGET NAME>/<PLATFORM NAME> onto the target board.

The serial console should display a similar output to below, indicating a successful Wi-Fi connection:

WiFi example

Scan:
Network: Dave Hot Spot secured: Unknown BSSID: 00:01:02:03:04:05 RSSI: -58 Ch: 1
1 network available.

Connecting...
Success

MAC: 00:01:02:03:04:05
IP: 192.168.0.5
Netmask: 255.255.255.0
Gateway: 192.168.0.1
RSSI: -27

Done

Troubleshooting

If you have problems, you can review the documentation for suggestions on what could be wrong and how to fix it.

License and contributions

The software is provided under Apache-2.0 license. Contributions to this project are accepted under the same license. Please see contributing.md for more info.

This project contains code from other projects. The original license text is included in those source files. They must comply with our license guide.