mbed-os-example-wifi

Wi-Fi example for Mbed OS

Getting started with the Wi-Fi API

This is an example of a Wi-Fi application using the Wi-Fi and network socket 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, prints interface and connection details and performs an HTTP operation.

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.
- NUCLEO-L476RG with ESP8266-01 module using pins D8 and D2.
- 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 ESP8266 mbed add esp8266-driver

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

Connecting the ESP8266

To connect the ESP8266 module to your development board, look at the ESP8266 Cookbook page. In general, this means hooking up the ESP8266 TX pin to D0 and the ESP8266 RX pin to D1 on your development board.

Note: On NUCLEO development boards, pins D0 and D1 are used for serial communication with the computer. Use pins D8 (to ESP8266 TX) and D2 (to ESP8266 RX) instead.

Connecting the X-NUCLEO-IDW0XX1

To connect the X-NUCLEO-IDW04A1 or X-NUCLEO-IDW01M1 expansion board to your NUCLEO development board, plug the expansion board on top of the NUCLEO board using the Arduino or Morpho connector.

Getting started

Import the example.

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

Configure the Wi-Fi shield to use.

Edit mbed_app.json to include the correct Wi-Fi shield, SSID and password:
```
    "config": {
   "wifi-shield": {
            "help": "Options are internal, WIFI_ESP8266, WIFI_ISM43362, WIFI_IDW0XX1",
            "value": "WIFI_ESP8266"
     	  },
        "wifi-ssid": {
            "help": "WiFi SSID",
            "value": "\"SSID\""
        },
        "wifi-password": {
            "help": "WiFi Password",
            "value": "\"Password\""
        }
    },
```
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).

For WIFI_ISM43362, ignore the value of wifi-shield as it is already overrides per supported targets.

For built-in Wi-Fi, ignore the value of wifi-shield.
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

Sending HTTP request to www.arm.com...
sent 38 [GET / HTTP/1.1]
recv 64 [HTTP/1.1 301 Moved Permanently]

Done

Troubleshooting

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

BlackstoneEngineering/mbed-os-example-wifi