ST / X_NUCLEO_IDW01M1v2

X-NUCLEO-IDW01M1 Wi-Fi expansion board mbed OS 2 ("Classic") library. mbed OS 5 library also available (see below).

Dependencies:   SPWF01SA

Dependents:   SpwfInterface_NSAPI_Testsv2 Nucleo_read_a0_thingspace Nucleo_read_a0_thingspace_mems Cayenne-X-NUCLEO-IDW01M1 ... more

Fork of X_NUCLEO_IDW01M1v2 by ST Expansion SW Team

Introduction

X_NUCLEO_IDW01M1 is a mbed library for the Wi-Fi expansion board X-NUCLEO-IDW01M1 compatible with STM32 Nucleo.

The software can be used for building Wi-Fi applications with the SPWF01SA module. It is an implementation of the NetworkSocketAPI library from mbed OS 2 ("Classic").
mbed OS 5 library can instead be found at this link.

Firmware Library

The X_NUCLEO_IDW01M1 library comes with a sample application (HelloWorld_IDW01M1v2) and a NSAPI test suite application (SpwfInterface_NSAPI_Testsv2).

This library is only supported on NUCLEO platforms and any platforms with Arduino connector. However connection to arduino needs to be done manually using 4 wires for Vdd, Gnd, Rx and Tx. Example applications have more specific details on exact connections to be used.

The features of the library are :

  • Supports mbed OS 2 ("Classic") NetworkSocketAPI
  • Supports both client sockets
  • Configuration of USART pins to be used

Class SpwfSAInterface is intended to represent the X-NUCLEO-IDW01M1 expansion board with the SPWF module.

The expansion board is basically featuring the component:

  1. a SPWF01SA Serial-to-Wi-Fi module

Example Applications

NSAPI Test Suite

Diff: SpwfInterface.cpp

Revision:
1:fd7b3df18dd7
Parent:
0:907910bfb0b5
Child:
2:610672ed2e9f
diff -r 907910bfb0b5 -r fd7b3df18dd7 SpwfInterface.cpp
--- a/SpwfInterface.cpp	Tue Jul 05 09:36:47 2016 +0000
+++ b/SpwfInterface.cpp	Tue Jul 05 11:03:15 2016 +0000
@@ -88,7 +88,11 @@
 int SpwfSAInterface::init(void) 
 {
     _spwf.setTimeout(SPWF_MISC_TIMEOUT);
-    return (_spwf.startup(0));
+    if(_spwf.startup(0)) {
+        isInitialized=true;
+        return true;
+    }
+    else return NSAPI_ERROR_DEVICE_ERROR;
 }
 
 /**
@@ -108,9 +112,8 @@
     //initialize the device before connecting
     if(!isInitialized)
     {
-        if(init()==0)
-            isInitialized=true;
-        else return NSAPI_ERROR_DEVICE_ERROR;
+        if(!init())
+            return NSAPI_ERROR_DEVICE_ERROR;
     }
     
     _spwf.setTimeout(SPWF_CONNECT_TIMEOUT);   
@@ -204,7 +207,9 @@
     
     const char *proto = (socket->proto == NSAPI_UDP) ? "u" : "t";//"s" for secure socket?
 
-    _spwf.open(proto, &sock_id, addr.get_ip_address(), addr.get_port());//sock ID is allocated NOW
+    if (!_spwf.open(proto, &sock_id, addr.get_ip_address(), addr.get_port())) {;//sock ID is allocated NOW
+        return NSAPI_ERROR_DEVICE_ERROR;
+    }
     
     //TODO: Maintain a socket table to map socket ID to host & port
     //TODO: lookup on client table to see if already socket is allocated to same host/port
@@ -270,20 +275,13 @@
     
     if(socket->id!=-1)
     {
-        if(socket->id==SERVER_SOCKET_NO)
-        {
-            //if (_spwf.socket_server_close()==-1) {
-                //err = NSAPI_ERROR_DEVICE_ERROR;
-            //}
-            isListening = false;
+        if (_spwf.close(socket->id)) {
+            if(socket->id==SERVER_SOCKET_NO)      
+                isListening = false;
+            else
+                _ids[socket->id] = false;            
         }
-        else
-        {
-            //if (_spwf.socket_client_close(socket->id)==-1) {
-                //err = NSAPI_ERROR_DEVICE_ERROR;
-            //}
-            _ids[socket->id] = false;
-        }
+        else err = NSAPI_ERROR_DEVICE_ERROR;
     }
 
     delete socket;
@@ -302,17 +300,17 @@
     struct spwf_socket *socket = (struct spwf_socket *)handle;
     int err;
     
-    if(socket->id==SERVER_SOCKET_NO)
+    /*if(socket->id==SERVER_SOCKET_NO)
         {
             if(socket->server_port==-1 || !isListening) 
                 return NSAPI_ERROR_NO_SOCKET; //server socket not bound or not listening        
 
-            //err = _spwf.socket_server_write((uint16_t)size, (char*)data);
+            err = _spwf.socket_server_write((uint16_t)size, (char*)data);
         }
     else
-        {
-            //err = _spwf.socket_client_write((uint8_t)socket->id, (uint16_t)size, (char*)data);
-        }
+        {*/
+            err = _spwf.send(socket->id, (char*)data, (uint32_t)size);
+        //}
     
     return err;
 }
@@ -332,10 +330,10 @@
     _spwf.setTimeout(SPWF_RECV_TIMEOUT);
     
     //CHECK:Receive for both Client and Server Sockets same?
-    //recv = _spwf.socket_client_recv((uint8_t)socket->id, (uint16_t)size, (char*)data);    
-    //if (recv < 0) {
-        //return NSAPI_ERROR_WOULD_BLOCK;
-    //}
+    recv = _spwf.recv(socket->id, (char*)data, (uint32_t)size);    
+    if (recv < 0) {
+        return NSAPI_ERROR_WOULD_BLOCK;
+    }
     return recv;
     
 }