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
Diff: SpwfInterface.h
- Revision:
- 0:907910bfb0b5
- Child:
- 13:0368732b5b9d
--- /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