Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Dependencies: mbed-os-example-wifi-DISCO_IOTBOARD_MQTT MQTT
Revision 32:bca3f5f442b3, committed 2017-09-08
- Comitter:
- mbed_official
- Date:
- Fri Sep 08 10:15:04 2017 +0100
- Parent:
- 31:7b64fdf0b13b
- Child:
- 33:12f0df4d51d7
- Commit message:
- Add compiler check for Morpho form factor
.
Commit copied from https://github.com/ARMmbed/mbed-os-example-wifi
Changed in this revision
--- a/README.md Thu Aug 31 15:45:04 2017 +0100
+++ b/README.md Fri Sep 08 10:15:04 2017 +0100
@@ -12,50 +12,62 @@
* [UBLOX Odin board](https://developer.mbed.org/platforms/ublox-EVK-ODIN-W2/) built-in WiFi module
* [REALTEK_RTL8195AM](https://developer.mbed.org/platforms/REALTEK-RTL8195AM/) built-in WiFi module
+* [NUCLEO_F401RE](https://developer.mbed.org/platforms/ST-Nucleo-F401RE/) with [X-NUCLEO-IDW01M1](https://developer.mbed.org/components/X-NUCLEO-IDW01M1/) WiFi expansion board using pins D8 D2
* [NUCLEO_F429ZI](https://developer.mbed.org/platforms/ST-Nucleo-F429ZI/) with ESP8266-01 module using pins D1 D0
* [NUCLEO_L476RG](https://developer.mbed.org/platforms/ST-Nucleo-L476RG/) with ESP8266-01 module using pins D8 D2
-* Other mbed target with ESP2866 module (Board it's connected to shouldn't have other network interface eg. Ethernet)
+* Other mbed targets with ESP8266 module or [X-NUCLEO-IDW01M1](https://developer.mbed.org/components/X-NUCLEO-IDW01M1/) expansion board
+ *(the mbed target board the WiFi shield gets connected to shouldn't have any other network interface e.g. Ethernet)*
-ESP2866 is a fallback option and will be used if the build is for unsupported platform.
+ESP8266 is a fallback option and will be used if the build is for unsupported platform.
-#### Connecting the ESP2866 ####
-
+#### Connecting the ESP8266 ####
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.
-**Note on NUCLEO boards:** On the NUCLEO 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.
+**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-IDW01M1 ####
+To connect the [X-NUCLEO-IDW01M1](https://developer.mbed.org/components/X-NUCLEO-IDW01M1/) expansion board to your NUCLEO development board, just plug the expansion board on top of the NUCLEO board using the Morpho connector.
## Getting started
1. Import the example
- ```
- mbed import mbed-os-example-wifi
- cd mbed-os-example-wifi
- ```
-2. Configure the WiFi credentials
+ ```
+ mbed import mbed-os-example-wifi
+ cd mbed-os-example-wifi
+ ```
+2. Configure the WiFi shield to use
- Edit ```mbed_app.json``` to include correct SSID and Password:
+ Edit ```mbed_app.json``` to include correct WiFi shield, SSID and Password:
- ```
- "config": {
- "wifi-ssid": {
- "help": "WiFi SSID",
- "value": "\"SSID\""
- },
- "wifi-password": {
- "help": "WiFi Password",
- "value": "\"Password\""
- }
- },
- ```
+ ```
+ "config": {
+ "wifi-shield": {
+ "help": "Options are WIFI_ESP8266, WIFI_IDW01M1",
+ "value": "WIFI_IDW01M1"
+ },
+ "wifi-ssid": {
+ "help": "WiFi SSID",
+ "value": "\"SSID\""
+ },
+ "wifi-password": {
+ "help": "WiFi Password",
+ "value": "\"Password\""
+ }
+ },
+ ```
-3. Compile and generate binary
-
- For example, for `GCC`:
+3. Copy the respective _ignore_ file to `.mbedignore`
+ * Copy `esp8266-mbedignore` when using ESP8266 module.
+ * Copy `idw01m1-mbedignore` when using [X-NUCLEO-IDW01M1](https://developer.mbed.org/components/X-NUCLEO-IDW01M1/) expansion board.
+
+4. Compile and generate binary
- ```
- mbed compile -t GCC_ARM -m UBLOX_EVK_ODIN_W2
- ```
+ For example, for `GCC`:
+
+ ```
+ mbed compile -t GCC_ARM -m UBLOX_EVK_ODIN_W2
+ ```
## Documentation ##
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/esp8266-mbedignore Fri Sep 08 10:15:04 2017 +0100 @@ -0,0 +1,1 @@ +wifi-x-nucleo-idw01m1/*
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/idw01m1-mbedignore Fri Sep 08 10:15:04 2017 +0100 @@ -0,0 +1,1 @@ +esp8266-driver/*
--- a/main.cpp Thu Aug 31 15:45:04 2017 +0100
+++ b/main.cpp Fri Sep 08 10:15:04 2017 +0100
@@ -17,6 +17,9 @@
#include "mbed.h"
#include "TCPSocket.h"
+#define WIFI_ESP8266 1
+#define WIFI_IDW01M1 2
+
#if TARGET_UBLOX_EVK_ODIN_W2
#include "OdinWiFiInterface.h"
OdinWiFiInterface wifi;
@@ -26,14 +29,25 @@
RTWInterface wifi;
#else
+#if MBED_CONF_APP_WIFI_SHIELD == WIFI_ESP8266
+#if !TARGET_FF_MORPHO
+#error [NOT_SUPPORTED] Only Morpho form factor devices are supported for this shield at this time
+#endif // !TARGET_FF_MORPHO
+#else
#if !TARGET_FF_ARDUINO
-#error [NOT_SUPPORTED] Only Arduino form factor devices are supported at this time
-#endif
+#error [NOT_SUPPORTED] Only Arduino form factor devices are supported for this shield at this time
+#endif // !TARGET_FF_ARDUINO
+#endif // MBED_CONF_APP_WIFI_SHIELD != WIFI_ESP8266
+#if MBED_CONF_APP_WIFI_SHIELD == WIFI_ESP8266
#include "ESP8266Interface.h"
ESP8266Interface wifi(MBED_CONF_APP_WIFI_TX, MBED_CONF_APP_WIFI_RX);
+#elif MBED_CONF_APP_WIFI_SHIELD == WIFI_IDW01M1
+#include "SpwfSAInterface.h"
+SpwfSAInterface wifi(MBED_CONF_APP_WIFI_TX, MBED_CONF_APP_WIFI_RX);
+#endif // MBED_CONF_APP_WIFI_SHIELD == WIFI_IDW01M1
-#endif
+#endif // TARGET_UBLOX_EVK_ODIN_W2
const char *sec2str(nsapi_security_t sec)
{
--- a/mbed_app.json Thu Aug 31 15:45:04 2017 +0100
+++ b/mbed_app.json Fri Sep 08 10:15:04 2017 +0100
@@ -1,5 +1,9 @@
{
"config": {
+ "wifi-shield": {
+ "help": "Options are WIFI_ESP8266, WIFI_IDW01M1",
+ "value": "WIFI_IDW01M1"
+ },
"wifi-ssid": {
"help": "WiFi SSID",
"value": "\"SSID\""
@@ -24,6 +28,10 @@
"NUCLEO_L476RG": {
"wifi-tx": "D8",
"wifi-rx": "D2"
+ },
+ "NUCLEO_F401RE": {
+ "wifi-tx": "D8",
+ "wifi-rx": "D2"
}
}
}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/wifi-x-nucleo-idw01m1.lib Fri Sep 08 10:15:04 2017 +0100 @@ -0,0 +1,1 @@ +https://github.com/ARMmbed/wifi-x-nucleo-idw01m1/#6ec4ac4a662fae9cca087dc3b57395da950a1ba5 \ No newline at end of file