ESP8266 / ESP8266Interface

ESP8266 Socket Library. AT Thinker firmware.

Dependents:   ESP8266_MQTT_HelloWorld ESP8266_IFTTT_Test ECE_4180_Lab_4 websocketmbed ... more

Fork of ESP8266Interface by ESP8266

This repository has been superceded

This project has moved to https://developer.mbed.org/teams/ESP8266/code/esp8266-driver/

This library works with the AT Thinker firmware.

Note

This library is currently in Beta. It is not feature complete and has some bugs, proceed with caution! Fixes and patches are welcome and appreciated!

Currently the ESP8266Interface Library has the following Abilities:

Working

  • TCP Client
  • UDP Client
  • Transparent mode (single connection of 1 type at a time)
  • Station Mode (connects to AP)

To be implemented

  • TCP Server
  • UDP Server
  • Multi Connection Mode (able to have up to 5 sockets at a time)
  • AP Mode (Make ESP Chip act like access point)
  • DNS Support (currently websites must be looked up by IP)
  • Error Recovery

Nice but not necessary

  • colorized text for ESP AT Commands in Command line (easier to differentiate from other text)

Socket/TCPSocketServer.h@48:03fd9333670d, 2015-06-10 (annotated)

Committer:
sarahmarshy
Date:
Wed Jun 10 15:47:33 2015 +0000
Revision:
48:03fd9333670d
Parent:
44:3a7b6083210b 
ESP8266 was changing ssid spaces to "$". Unecessary. Removed this feature.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
sarahmarshy 44:3a7b6083210b 1 /* Copyright (C) 2012 mbed.org, MIT License
sarahmarshy 44:3a7b6083210b 2 *
sarahmarshy 44:3a7b6083210b 3 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
sarahmarshy 44:3a7b6083210b 4 * and associated documentation files (the "Software"), to deal in the Software without restriction,
sarahmarshy 44:3a7b6083210b 5 * including without limitation the rights to use, copy, modify, merge, publish, distribute,
sarahmarshy 44:3a7b6083210b 6 * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
sarahmarshy 44:3a7b6083210b 7 * furnished to do so, subject to the following conditions:
sarahmarshy 44:3a7b6083210b 8 *
sarahmarshy 44:3a7b6083210b 9 * The above copyright notice and this permission notice shall be included in all copies or
sarahmarshy 44:3a7b6083210b 10 * substantial portions of the Software.
sarahmarshy 44:3a7b6083210b 11 *
sarahmarshy 44:3a7b6083210b 12 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
sarahmarshy 44:3a7b6083210b 13 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
sarahmarshy 44:3a7b6083210b 14 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
sarahmarshy 44:3a7b6083210b 15 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
sarahmarshy 44:3a7b6083210b 16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
sarahmarshy 44:3a7b6083210b 17 */
sarahmarshy 44:3a7b6083210b 18 #ifndef TCPSOCKETSERVER_H
sarahmarshy 44:3a7b6083210b 19 #define TCPSOCKETSERVER_H
sarahmarshy 44:3a7b6083210b 20
sarahmarshy 44:3a7b6083210b 21 #include "Socket/Socket.h"
sarahmarshy 44:3a7b6083210b 22 #include "TCPSocketConnection.h"
sarahmarshy 44:3a7b6083210b 23
sarahmarshy 44:3a7b6083210b 24 /** TCP Server.
sarahmarshy 44:3a7b6083210b 25 */
sarahmarshy 44:3a7b6083210b 26 class TCPSocketServer : public Socket {
sarahmarshy 44:3a7b6083210b 27 friend class TCPSocketConnection;
sarahmarshy 44:3a7b6083210b 28 public:
sarahmarshy 44:3a7b6083210b 29 /** Instantiate a TCP Server.
sarahmarshy 44:3a7b6083210b 30 */
sarahmarshy 44:3a7b6083210b 31 TCPSocketServer();
sarahmarshy 44:3a7b6083210b 32
sarahmarshy 44:3a7b6083210b 33 /** Bind a socket to a specific port.
sarahmarshy 44:3a7b6083210b 34 \param port The port to listen for incoming connections on.
sarahmarshy 44:3a7b6083210b 35 \return 0 on success, -1 on failure.
sarahmarshy 44:3a7b6083210b 36 */
sarahmarshy 44:3a7b6083210b 37 int bind(int port);
sarahmarshy 44:3a7b6083210b 38
sarahmarshy 44:3a7b6083210b 39 /** Start listening for incoming connections.
sarahmarshy 44:3a7b6083210b 40 \param backlog number of pending connections that can be queued up at any
sarahmarshy 44:3a7b6083210b 41 one time [Default: 1].
sarahmarshy 44:3a7b6083210b 42 \return 0 on success, -1 on failure.
sarahmarshy 44:3a7b6083210b 43 */
sarahmarshy 44:3a7b6083210b 44 int listen(int backlog=1);
sarahmarshy 44:3a7b6083210b 45
sarahmarshy 44:3a7b6083210b 46 /** Accept a new connection.
sarahmarshy 44:3a7b6083210b 47 \param connection A TCPSocketConnection instance that will handle the incoming connection.
sarahmarshy 44:3a7b6083210b 48 \return 0 on success, -1 on failure.
sarahmarshy 44:3a7b6083210b 49 */
sarahmarshy 44:3a7b6083210b 50 int accept(TCPSocketConnection& connection);
sarahmarshy 44:3a7b6083210b 51 private:
sarahmarshy 44:3a7b6083210b 52 int _port;
sarahmarshy 44:3a7b6083210b 53 };
sarahmarshy 44:3a7b6083210b 54
sarahmarshy 44:3a7b6083210b 55 #endif