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
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:
- a SPWF01SA Serial-to-Wi-Fi module
Example Applications
NSAPI Test Suite
Revision 0:907910bfb0b5, committed 2016-07-05
- Comitter:
- mridup
- Date:
- Tue Jul 05 09:36:47 2016 +0000
- Child:
- 1:fd7b3df18dd7
- Commit message:
- SPWF NSAPI v2
Changed in this revision
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/SPWF01SA.lib Tue Jul 05 09:36:47 2016 +0000 @@ -0,0 +1,1 @@ +https://developer.mbed.org/users/mridup/code/SPWF01SA/#580379efe167
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/SpwfInterface.cpp Tue Jul 05 09:36:47 2016 +0000
@@ -0,0 +1,399 @@
+/* mbed Microcontroller Library
+* Copyright (c) 20015 ARM Limited
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+/**
+ ******************************************************************************
+ * @file SpwfInterface.cpp
+ * @author STMicroelectronics
+ * @brief Implementation of the NetworkStack for the SPWF Device
+ ******************************************************************************
+ * @copy
+ *
+ * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
+ * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
+ * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
+ * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
+ * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
+ * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
+ *
+ * <h2><center>© COPYRIGHT 2016 STMicroelectronics</center></h2>
+ ******************************************************************************
+ */
+
+#include "SpwfInterface.h"
+
+// Various timeouts for different SPWF operations
+#define SPWF_CONNECT_TIMEOUT 20000
+#define SPWF_SEND_TIMEOUT 500
+#define SPWF_RECV_TIMEOUT 1500
+#define SPWF_MISC_TIMEOUT 15000
+
+/** spwf_socket class
+ * Implementation of SPWF socket structure
+ */
+struct spwf_socket {
+ int id;
+ int server_port;
+ nsapi_protocol_t proto;
+ bool connected;
+};
+
+
+/**
+* @brief SpwfSAInterface constructor
+* @param tx: Pin USART TX
+* rx: Pin USART RX
+* rst: reset pin for Spwf module
+* wkup: reset pin for Spwf module
+* rts: Pin USART RTS
+* debug : not used
+* @retval none
+*/
+SpwfSAInterface::SpwfSAInterface(PinName tx, PinName rx, bool debug)
+ : _spwf(tx, rx, debug)
+{
+ memset(_ids, 0, sizeof(_ids));
+ isInitialized = false;
+ isListening = false;
+}
+
+/**
+* @brief SpwfSAInterface destructor
+* @param none
+* @retval none
+*/
+SpwfSAInterface::~SpwfSAInterface()
+{
+}
+
+/**
+* @brief init function
+ initializes SPWF FW and module
+* @param none
+* @retval error value
+*/
+int SpwfSAInterface::init(void)
+{
+ _spwf.setTimeout(SPWF_MISC_TIMEOUT);
+ return (_spwf.startup(0));
+}
+
+/**
+* @brief network connect
+ connects to Access Point
+* @param ap: Access Point (AP) Name String
+* pass_phrase: Password String for AP
+* security: type of NSAPI security supported
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::connect(const char *ap,
+ const char *pass_phrase,
+ nsapi_security_t security)
+{
+ int mode;
+
+ //initialize the device before connecting
+ if(!isInitialized)
+ {
+ if(init()==0)
+ isInitialized=true;
+ else return NSAPI_ERROR_DEVICE_ERROR;
+ }
+
+ _spwf.setTimeout(SPWF_CONNECT_TIMEOUT);
+
+ switch(security)
+ {
+ case NSAPI_SECURITY_NONE:
+ mode = 0;
+ pass_phrase = NULL;
+ break;
+ case NSAPI_SECURITY_WEP:
+ mode = 1;
+ break;
+ case NSAPI_SECURITY_WPA:
+ case NSAPI_SECURITY_WPA2:
+ mode = 2;
+ break;
+ default:
+ mode = 2;
+ break;
+ }
+ return (_spwf.connect((char*)ap, (char*)pass_phrase, mode));
+}
+
+/**
+* @brief network disconnect
+ disconnects from Access Point
+* @param none
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::disconnect()
+{
+ return (_spwf.disconnect());
+}
+
+/**
+* @brief Get the local IP address
+* @param none
+* @retval Null-terminated representation of the local IP address
+* or null if not yet connected
+*/
+const char *SpwfSAInterface::get_ip_address()
+{
+ return _spwf.getIPAddress();
+}
+
+/**
+* @brief Get the MAC address
+* @param none
+* @retval Null-terminated representation of the MAC address
+* or null if not yet connected
+*/
+const char *SpwfSAInterface::get_mac_address()
+{
+ return _spwf.getMACAddress();
+}
+
+/**
+* @brief open a socket handle
+* @param handle: Pointer to handle
+* proto: TCP/UDP protocol
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::socket_open(void **handle, nsapi_protocol_t proto)
+{
+ int id = -1;
+
+ struct spwf_socket *socket = new struct spwf_socket;
+ if (!socket) {
+ return NSAPI_ERROR_NO_SOCKET;
+ }
+
+ socket->id = id;
+ socket->server_port = id;
+ socket->proto = proto;
+ socket->connected = false;
+ *handle = socket;
+ return 0;
+}
+
+/**
+* @brief connect to a remote socket
+* @param handle: Pointer to socket handle
+* addr: Address to connect to
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::socket_connect(void *handle, const SocketAddress &addr)
+{
+ int sock_id = 99;
+ struct spwf_socket *socket = (struct spwf_socket *)handle;
+
+ 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
+
+ //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
+ //multimap <char *, vector <uint16_t> > ::iterator i = c_table.find((char*)ip);
+
+ if(sock_id <= SPWFSA_SOCKET_COUNT)
+ {
+ socket->id = sock_id;//the socket ID of this Socket instance
+ _ids[socket->id] = true;
+ socket->connected = true;
+ }
+ else
+ return NSAPI_ERROR_NO_SOCKET;
+
+ return 0;
+}
+
+/**
+* @brief bind to a port number and address
+* @param handle: Pointer to socket handle
+* proto: address to bind to
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::socket_bind(void *handle, const SocketAddress &address)
+{
+ struct spwf_socket *socket = (struct spwf_socket *)handle;
+ socket->server_port = address.get_port();
+ return 0;
+}
+
+/**
+* @brief start listening on a port and address
+* @param handle: Pointer to handle
+* backlog: not used (always value is 1)
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::socket_listen(void *handle, int backlog)
+{
+ return NSAPI_ERROR_UNSUPPORTED;
+}
+
+/**
+* @brief accept connections from remote sockets
+* @param handle: Pointer to handle of client socket (connecting)
+* proto: handle of server socket which will accept connections
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::socket_accept(void **handle, void *server)
+{
+ return NSAPI_ERROR_UNSUPPORTED;
+}
+
+/**
+* @brief close a socket
+* @param handle: Pointer to handle
+* @retval NSAPI Error Type
+*/
+int SpwfSAInterface::socket_close(void *handle)
+{
+ struct spwf_socket *socket = (struct spwf_socket *)handle;
+ int err = 0;
+ _spwf.setTimeout(SPWF_MISC_TIMEOUT);
+
+ if(socket->id!=-1)
+ {
+ if(socket->id==SERVER_SOCKET_NO)
+ {
+ //if (_spwf.socket_server_close()==-1) {
+ //err = NSAPI_ERROR_DEVICE_ERROR;
+ //}
+ isListening = false;
+ }
+ else
+ {
+ //if (_spwf.socket_client_close(socket->id)==-1) {
+ //err = NSAPI_ERROR_DEVICE_ERROR;
+ //}
+ _ids[socket->id] = false;
+ }
+ }
+
+ delete socket;
+ return err;
+}
+
+/**
+* @brief write to a socket
+* @param handle: Pointer to handle
+* data: pointer to data
+* size: size of data
+* @retval no of bytes sent
+*/
+int SpwfSAInterface::socket_send(void *handle, const void *data, unsigned size)
+{
+ struct spwf_socket *socket = (struct spwf_socket *)handle;
+ int err;
+
+ 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);
+ }
+ else
+ {
+ //err = _spwf.socket_client_write((uint8_t)socket->id, (uint16_t)size, (char*)data);
+ }
+
+ return err;
+}
+
+/**
+* @brief receive data on a socket
+* @param handle: Pointer to handle
+* data: pointer to data
+* size: size of data
+* @retval no of bytes read
+*/
+int SpwfSAInterface::socket_recv(void *handle, void *data, unsigned size)
+{
+ struct spwf_socket *socket = (struct spwf_socket *)handle;
+ int32_t recv;
+
+ _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;
+ //}
+ return recv;
+
+}
+
+/**
+* @brief send data to a udp socket
+* @param handle: Pointer to handle
+* addr: address of udp socket
+* data: pointer to data
+* size: size of data
+* @retval no of bytes sent
+*/
+int SpwfSAInterface::socket_sendto(void *handle, const SocketAddress &addr, const void *data, unsigned size)
+{
+ struct spwf_socket *socket = (struct spwf_socket *)handle;
+ if (!socket->connected) {
+ int err = socket_connect(socket, addr);
+ if (err < 0) {
+ return err;
+ }
+ }
+
+ return socket_send(socket, data, size);
+}
+
+/**
+* @brief receive data on a udp socket
+* @param handle: Pointer to handle
+* addr: address of udp socket
+* data: pointer to data
+* size: size of data
+* @retval no of bytes read
+*/
+int SpwfSAInterface::socket_recvfrom(void *handle, SocketAddress *addr, void *data, unsigned size)
+{
+ struct spwf_socket *socket = (struct spwf_socket *)handle;
+ return socket_recv(socket, data, size);
+}
+
+/**
+* @brief attach function/callback to the socket
+* Not used
+* @param handle: Pointer to handle
+* callback: callback function pointer
+* data: pointer to data
+* @retval none
+*/
+void SpwfSAInterface::socket_attach(void *handle, void (*callback)(void *), void *data)
+{
+ //No implementation yet
+}
+
+/**
+* @brief utility debug function for printing to serial terminal
+* @param string: Pointer to data
+* @retval none
+*/
+void SpwfSAInterface::debug(const char * string)
+{
+ //_spwf.debug_print(string);
+}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/SpwfInterface.h Tue Jul 05 09:36:47 2016 +0000
@@ -0,0 +1,91 @@
+/* mbed Microcontroller Library
+* Copyright (c) 20015 ARM Limited
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+/**
+ ******************************************************************************
+ * @file SpwfInterface.h
+ * @author STMicroelectronics
+ * @brief Header file of the NetworkStack for the SPWF Device
+ ******************************************************************************
+ * @copy
+ *
+ * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
+ * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
+ * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
+ * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
+ * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
+ * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
+ *
+ * <h2><center>© COPYRIGHT 2016 STMicroelectronics</center></h2>
+ ******************************************************************************
+ */
+
+#ifndef SPWFSA_INTERFACE_H
+#define SPWFSA_INTERFACE_H
+
+#include "WiFiInterface.h"
+#include "SPWFSA01.h"
+
+#define SPWFSA_SOCKET_COUNT 8
+#define SERVER_SOCKET_NO 9
+
+/** SpwfSAInterface class
+ * Implementation of the NetworkStack for the SPWF Device
+ */
+class SpwfSAInterface : public NetworkStack, public WiFiInterface
+{
+public:
+
+ SpwfSAInterface(PinName tx, PinName rx, bool debug = false);
+ virtual ~SpwfSAInterface();
+
+ // Implementation of WiFiInterface
+ virtual int connect(const char *ssid,
+ const char *pass,
+ nsapi_security_t security = NSAPI_SECURITY_NONE);
+
+ virtual int disconnect();
+ virtual const char *get_mac_address();
+ void debug(const char * string);
+
+ //Implementation of NetworkStack
+ virtual const char *get_ip_address();
+
+protected:
+ //Implementation of NetworkStack
+ virtual int socket_open(void **handle, nsapi_protocol_t proto);
+ virtual int socket_close(void *handle);
+ virtual int socket_bind(void *handle, const SocketAddress &address); //not supported
+ virtual int socket_listen(void *handle, int backlog);
+ virtual int socket_connect(void *handle, const SocketAddress &address);
+ virtual int socket_accept(void **handle, void *server);
+ virtual int socket_send(void *handle, const void *data, unsigned size);
+ virtual int socket_recv(void *handle, void *data, unsigned size);
+ virtual int socket_sendto(void *handle, const SocketAddress &address, const void *data, unsigned size);
+ virtual int socket_recvfrom(void *handle, SocketAddress *address, void *buffer, unsigned size);
+ virtual void socket_attach(void *handle, void (*callback)(void *), void *data);
+
+private:
+ int init(void);
+
+ SPWFSA01 _spwf;
+ bool _ids[SPWFSA_SOCKET_COUNT];
+ bool isListening;
+ bool isInitialized;
+};
+
+
+#endif

X-NUCLEO-IDW01M1 Wi-Fi expansion board