![](/media/cache/img/default_profile.jpg.50x50_q85.jpg)
e
README.md@90:1def9d67d6e4, 2019-01-09 (annotated)
- Committer:
- mbed_official
- Date:
- Wed Jan 09 09:30:03 2019 +0000
- Revision:
- 90:1def9d67d6e4
- Parent:
- 88:20f23913c4a7
- Child:
- 91:dab9882e2b49
Update README.md
.
Commit copied from https://github.com/ARMmbed/mbed-os-example-wifi
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
mbed_official | 0:857719181846 | 1 | # mbed-os-example-wifi # |
mbed_official | 0:857719181846 | 2 | |
mbed_official | 49:d44cac40bf15 | 3 | Wi-Fi example for Mbed OS |
mbed_official | 0:857719181846 | 4 | |
mbed_official | 49:d44cac40bf15 | 5 | ## Getting started with the Wi-Fi API ## |
mbed_official | 0:857719181846 | 6 | |
mbed_official | 49:d44cac40bf15 | 7 | This is an example of a Wi-Fi application using the Wi-Fi and network socket APIs that [Mbed OS](https://github.com/ARMmbed/mbed-os) provides. |
mbed_official | 0:857719181846 | 8 | |
mbed_official | 49:d44cac40bf15 | 9 | 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. |
mbed_official | 49:d44cac40bf15 | 10 | |
mbed_official | 49:d44cac40bf15 | 11 | For more information about Wi-Fi APIs, please visit the [Mbed OS Wi-Fi](https://os.mbed.com/docs/latest/reference/wi-fi.html) documentation. |
mbed_official | 0:857719181846 | 12 | |
mbed_official | 0:857719181846 | 13 | ### Supported hardware ### |
mbed_official | 0:857719181846 | 14 | |
mbed_official | 71:a0fbcc153b55 | 15 | * All Mbed OS boards with build-in Wi-Fi module: |
mbed_official | 71:a0fbcc153b55 | 16 | * [u-blox ODIN-W2](https://os.mbed.com/platforms/ublox-EVK-ODIN-W2/) |
mbed_official | 71:a0fbcc153b55 | 17 | * [Realtek RTL8195AM](https://os.mbed.com/platforms/REALTEK-RTL8195AM/) |
mbed_official | 71:a0fbcc153b55 | 18 | * [ST DISCO IOT board](https://os.mbed.com/platforms/ST-Discovery-L475E-IOT01A/) with integrated [ISM43362 WiFi Inventek module](https://github.com/ARMmbed/wifi-ism43362). |
mbed_official | 71:a0fbcc153b55 | 19 | * [ST DISCO_F413ZH board](https://os.mbed.com/platforms/ST-Discovery-F413H/) with integrated [ISM43362 WiFi Inventek module](https://github.com/ARMmbed/wifi-ism43362). |
mbed_official | 71:a0fbcc153b55 | 20 | * [Advantech WISE-150](https://os.mbed.com/modules/advantech-wise-1530/) |
mbed_official | 71:a0fbcc153b55 | 21 | * USI WM-BN-BM-22 |
mbed_official | 71:a0fbcc153b55 | 22 | * MxChip EMW3166 |
mbed_official | 71:a0fbcc153b55 | 23 | * Boards with external WiFi shields. |
mbed_official | 71:a0fbcc153b55 | 24 | * [NUCLEO-F401RE](https://os.mbed.com/platforms/ST-Nucleo-F401RE/) with [X-NUCLEO-IDW04A1](http://www.st.com/content/st_com/en/products/ecosystems/stm32-open-development-environment/stm32-nucleo-expansion-boards/stm32-ode-connect-hw/x-nucleo-idw04a1.html) Wi-Fi expansion board using pins D8 and D2 _(of the Arduino connector)_. |
mbed_official | 71:a0fbcc153b55 | 25 | * [NUCLEO-F401RE](https://os.mbed.com/platforms/ST-Nucleo-F401RE/) with [X-NUCLEO-IDW01M1](https://os.mbed.com/components/X-NUCLEO-IDW01M1/) Wi-Fi expansion board using pins PA_9 and PA_10 _(of the Morpho connector)_. |
mbed_official | 71:a0fbcc153b55 | 26 | * [NUCLEO-F429ZI](https://os.mbed.com/platforms/ST-Nucleo-F429ZI/) with ESP8266-01 module using pins D1 and D0. |
mbed_official | 71:a0fbcc153b55 | 27 | * Other Mbed targets with an ESP8266 module, [X-NUCLEO-IDW04A1](http://www.st.com/content/st_com/en/products/ecosystems/stm32-open-development-environment/stm32-nucleo-expansion-boards/stm32-ode-connect-hw/x-nucleo-idw04a1.html) or [X-NUCLEO-IDW01M1](https://os.mbed.com/components/X-NUCLEO-IDW01M1/) expansion board. |
mbed_official | 0:857719181846 | 28 | |
mbed_official | 77:b74ac6641a3e | 29 | #### Adding connectivity driver |
mbed_official | 77:b74ac6641a3e | 30 | |
mbed_official | 77:b74ac6641a3e | 31 | 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_official | 77:b74ac6641a3e | 32 | |
mbed_official | 77:b74ac6641a3e | 33 | ``` |
mbed_official | 77:b74ac6641a3e | 34 | mbed add <driver> |
mbed_official | 77:b74ac6641a3e | 35 | ``` |
mbed_official | 77:b74ac6641a3e | 36 | |
mbed_official | 90:1def9d67d6e4 | 37 | For example adding ISM43362 driver `mbed add wifi-ism43362` or X-Nucleo-IDW01M1 driver `mbed add wifi-x-nucleo-idw01m1` |
mbed_official | 90:1def9d67d6e4 | 38 | The ESP8266 driver is already suplied by Mbed OS. |
mbed_official | 77:b74ac6641a3e | 39 | |
mbed_official | 77:b74ac6641a3e | 40 | Then pin names need to be configured as instructed in the drivers README file. |
mbed_official | 77:b74ac6641a3e | 41 | |
mbed_official | 32:bca3f5f442b3 | 42 | #### Connecting the ESP8266 #### |
mbed_official | 49:d44cac40bf15 | 43 | |
mbed_official | 27:b3c6dba3b6e9 | 44 | To connect the ESP8266 module to your development board, look at the [ESP8266 Cookbook page](https://developer.mbed.org/users/4180_1/notebook/using-the-esp8266-with-the-mbed-lpc1768/). In general, this means hooking up the ESP8266 TX pin to `D0` and the ESP8266 RX pin to `D1` on your development board. |
mbed_official | 6:9944c5308062 | 45 | |
mbed_official | 44:63be19b7a3db | 46 | #### Connecting the X-NUCLEO-IDW0XX1 #### |
mbed_official | 49:d44cac40bf15 | 47 | |
mbed_official | 49:d44cac40bf15 | 48 | To connect the [X-NUCLEO-IDW04A1](http://www.st.com/content/st_com/en/products/ecosystems/stm32-open-development-environment/stm32-nucleo-expansion-boards/stm32-ode-connect-hw/x-nucleo-idw04a1.html) or [X-NUCLEO-IDW01M1](https://developer.mbed.org/components/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. |
mbed_official | 6:9944c5308062 | 49 | |
mbed_official | 44:63be19b7a3db | 50 | ## Getting started ## |
mbed_official | 0:857719181846 | 51 | |
mbed_official | 49:d44cac40bf15 | 52 | 1. Import the example. |
mbed_official | 0:857719181846 | 53 | |
mbed_official | 32:bca3f5f442b3 | 54 | ``` |
mbed_official | 32:bca3f5f442b3 | 55 | mbed import mbed-os-example-wifi |
mbed_official | 32:bca3f5f442b3 | 56 | cd mbed-os-example-wifi |
mbed_official | 32:bca3f5f442b3 | 57 | ``` |
mbed_official | 71:a0fbcc153b55 | 58 | |
mbed_official | 82:122bb3ae6de5 | 59 | 1. Configure the Wi-Fi shield and settings. |
mbed_official | 49:d44cac40bf15 | 60 | Edit ```mbed_app.json``` to include the correct Wi-Fi shield, SSID and password: |
mbed_official | 0:857719181846 | 61 | |
mbed_official | 86:92e4be20dc8b | 62 | ```json |
mbed_official | 82:122bb3ae6de5 | 63 | { |
mbed_official | 82:122bb3ae6de5 | 64 | "config": { |
mbed_official | 82:122bb3ae6de5 | 65 | "wifi-ssid": { |
mbed_official | 82:122bb3ae6de5 | 66 | "help": "WiFi SSID", |
mbed_official | 82:122bb3ae6de5 | 67 | "value": "\"SSID\"" |
mbed_official | 82:122bb3ae6de5 | 68 | }, |
mbed_official | 82:122bb3ae6de5 | 69 | "wifi-password": { |
mbed_official | 82:122bb3ae6de5 | 70 | "help": "WiFi Password", |
mbed_official | 82:122bb3ae6de5 | 71 | "value": "\"PASSWORD\"" |
mbed_official | 82:122bb3ae6de5 | 72 | } |
mbed_official | 82:122bb3ae6de5 | 73 | }, |
mbed_official | 82:122bb3ae6de5 | 74 | "target_overrides": { |
mbed_official | 82:122bb3ae6de5 | 75 | "*": { |
mbed_official | 82:122bb3ae6de5 | 76 | "platform.stdio-convert-newlines": true, |
mbed_official | 82:122bb3ae6de5 | 77 | "esp8266.provide-default" : false |
mbed_official | 82:122bb3ae6de5 | 78 | } |
mbed_official | 82:122bb3ae6de5 | 79 | } |
mbed_official | 82:122bb3ae6de5 | 80 | } |
mbed_official | 86:92e4be20dc8b | 81 | ``` |
mbed_official | 0:857719181846 | 82 | |
mbed_official | 82:122bb3ae6de5 | 83 | For build-in WiFi, you do not need to set any `provide-default` values. Those are required |
mbed_official | 82:122bb3ae6de5 | 84 | if you use external WiFi shield. |
mbed_official | 82:122bb3ae6de5 | 85 | |
mbed_official | 49:d44cac40bf15 | 86 | 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```). |
mbed_official | 71:a0fbcc153b55 | 87 | |
mbed_official | 33:12f0df4d51d7 | 88 | |
mbed_official | 71:a0fbcc153b55 | 89 | 1. Compile and generate binary. |
mbed_official | 71:a0fbcc153b55 | 90 | For example, for `GCC`: |
mbed_official | 71:a0fbcc153b55 | 91 | ``` |
mbed_official | 71:a0fbcc153b55 | 92 | mbed compile -t GCC_ARM -m UBLOX_EVK_ODIN_W2 |
mbed_official | 71:a0fbcc153b55 | 93 | ``` |
mbed_official | 32:bca3f5f442b3 | 94 | |
mbed_official | 71:a0fbcc153b55 | 95 | 1. Open a serial console session with the target platform using the following parameters: |
mbed_official | 36:aa0b6789bbd2 | 96 | * **Baud rate:** 9600 |
mbed_official | 36:aa0b6789bbd2 | 97 | * **Data bits:** 8 |
mbed_official | 36:aa0b6789bbd2 | 98 | * **Stop bits:** 1 |
mbed_official | 36:aa0b6789bbd2 | 99 | * **Parity:** None |
mbed_official | 71:a0fbcc153b55 | 100 | |
mbed_official | 71:a0fbcc153b55 | 101 | 1. 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. |
mbed_official | 36:aa0b6789bbd2 | 102 | |
mbed_official | 71:a0fbcc153b55 | 103 | 1. The serial console should display a similar output to below, indicating a successful Wi-Fi connection: |
mbed_official | 71:a0fbcc153b55 | 104 | ``` |
mbed_official | 71:a0fbcc153b55 | 105 | WiFi example |
mbed_official | 71:a0fbcc153b55 | 106 | |
mbed_official | 71:a0fbcc153b55 | 107 | Scan: |
mbed_official | 71:a0fbcc153b55 | 108 | Network: Dave Hot Spot secured: Unknown BSSID: 00:01:02:03:04:05 RSSI: -58 Ch: 1 |
mbed_official | 71:a0fbcc153b55 | 109 | 1 network available. |
mbed_official | 36:aa0b6789bbd2 | 110 | |
mbed_official | 71:a0fbcc153b55 | 111 | Connecting... |
mbed_official | 71:a0fbcc153b55 | 112 | Success |
mbed_official | 36:aa0b6789bbd2 | 113 | |
mbed_official | 71:a0fbcc153b55 | 114 | MAC: 00:01:02:03:04:05 |
mbed_official | 71:a0fbcc153b55 | 115 | IP: 192.168.0.5 |
mbed_official | 71:a0fbcc153b55 | 116 | Netmask: 255.255.255.0 |
mbed_official | 71:a0fbcc153b55 | 117 | Gateway: 192.168.0.1 |
mbed_official | 71:a0fbcc153b55 | 118 | RSSI: -27 |
mbed_official | 36:aa0b6789bbd2 | 119 | |
mbed_official | 71:a0fbcc153b55 | 120 | Sending HTTP request to www.arm.com... |
mbed_official | 71:a0fbcc153b55 | 121 | sent 38 [GET / HTTP/1.1] |
mbed_official | 71:a0fbcc153b55 | 122 | recv 64 [HTTP/1.1 301 Moved Permanently] |
mbed_official | 36:aa0b6789bbd2 | 123 | |
mbed_official | 71:a0fbcc153b55 | 124 | Done |
mbed_official | 71:a0fbcc153b55 | 125 | ``` |
mbed_official | 0:857719181846 | 126 | |
mbed_official | 49:d44cac40bf15 | 127 | ## Troubleshooting |
mbed_official | 0:857719181846 | 128 | |
mbed_official | 49:d44cac40bf15 | 129 | If you have problems, you can review the [documentation](https://os.mbed.com/docs/latest/tutorials/debugging.html) for suggestions on what could be wrong and how to fix it. |
mbed_official | 88:20f23913c4a7 | 130 | |
mbed_official | 88:20f23913c4a7 | 131 | ### License and contributions |
mbed_official | 88:20f23913c4a7 | 132 | |
mbed_official | 88:20f23913c4a7 | 133 | 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. |
mbed_official | 88:20f23913c4a7 | 134 | |
mbed_official | 88:20f23913c4a7 | 135 | This project contains code from other projects. The original license text is included in those source files. They must comply with our license guide. |