ESP8266 / ESP8266NodeMCUInterface

ESP8266 driver using the NodeMCU interface

Dependencies:   BufferedSerial

Dependents:   esp8266_nodeMCU1 esp8266_2_thingspeak1 Solarator_0-0-2 IoTBurglar_and_Fire_AlarmSystem ... more

Fork of ESP8266Interface by ESP8266

This is an alternative implementation of the ESP8266 driver that uses the NodeMCU firmware. The NodeMCU firmware provides a slightly larger feature set than the default firmware through a Lua interpreter.

Note

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

Interface changes

  • SSID and passphrase moved out of ESP8266Interface constructor and to ESP8266Interface::connect
  • ESP8266Interface constructor provides optional timeout parameter to specify how long to wait for network operations

Note

NodeMCU defaults to a baud rate of 9600 instead of 115200 used by the default firmware.

Firmware

To install the NodeMCU firmware, follow the instructions on the Firmware Update wiki page using the nodemcu_integer_0.9.6-dev_20150406.bin binary at address 0x00000 instead of boot_v1.1.bin and user1.bin.

Since the NodeMCU firmware defaults to a baud rate of 9600, the Serial Passthrough program can be used to get direct access to the Lua interpreter running on the ESP8266.

Status

Working features:

  • TCP Client
  • UDP Client Transmit (Currently only UDP Server can recieve messages)
  • Single Connection at a time
  • Station Mode (Connects to AP)
  • DNS Lookups

To be implemented:

  • TCP Server
  • UDP Server
  • UDP Client recieve
  • Multiple Connections tracked through Lua variables
  • AP Mode (Act as access point)
  • IPV6 support (Existing issue with NodeMCU)

ESP8266/ESP8266.h@36:e1545c6c2cb3, 2015-05-02 (annotated)

Committer:
mbedAustin
Date:
Sat May 02 03:30:52 2015 +0000
Revision:
36:e1545c6c2cb3
Parent:
32:cf071dc33972 
updated debug command prints

Who changed what in which revision?

UserRevisionLine numberNew contents of line
samux 1:fb4494783863 1 /* Copyright (C) 2012 mbed.org, MIT License
samux 1:fb4494783863 2 *
samux 1:fb4494783863 3 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
samux 1:fb4494783863 4 * and associated documentation files (the "Software"), to deal in the Software without restriction,
samux 1:fb4494783863 5 * including without limitation the rights to use, copy, modify, merge, publish, distribute,
samux 1:fb4494783863 6 * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
samux 1:fb4494783863 7 * furnished to do so, subject to the following conditions:
samux 1:fb4494783863 8 *
samux 1:fb4494783863 9 * The above copyright notice and this permission notice shall be included in all copies or
samux 1:fb4494783863 10 * substantial portions of the Software.
samux 1:fb4494783863 11 *
samux 1:fb4494783863 12 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
samux 1:fb4494783863 13 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
samux 1:fb4494783863 14 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
samux 1:fb4494783863 15 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
samux 1:fb4494783863 16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
samux 1:fb4494783863 17 *
samux 1:fb4494783863 18 * @section DESCRIPTION
samux 1:fb4494783863 19 *
michaeljkoster 16:3f0efaa57a12 20 * ESP8266 serial wifi module
samux 1:fb4494783863 21 *
samux 1:fb4494783863 22 * Datasheet:
samux 1:fb4494783863 23 *
michaeljkoster 16:3f0efaa57a12 24 * http://www.electrodragon.com/w/Wi07c
samux 1:fb4494783863 25 */
samux 1:fb4494783863 26
michaeljkoster 13:41098c907200 27 #ifndef ESP8266_H
michaeljkoster 13:41098c907200 28 #define ESP8266_H
samux 1:fb4494783863 29
samux 1:fb4494783863 30 #include "mbed.h"
samux 1:fb4494783863 31 #include "CBuffer.h"
samux 1:fb4494783863 32
samux 1:fb4494783863 33 #define DEFAULT_WAIT_RESP_TIMEOUT 500
mbedAustin 30:c035696b9397 34 #define ESP_TCP_TYPE 1
mbedAustin 30:c035696b9397 35 #define ESP_UDP_TYPE 0
mbedAustin 36:e1545c6c2cb3 36 #define ESP_MBUFFE_MAX 256
samux 1:fb4494783863 37
screamer 5:81e264dbbf03 38 /**
michaeljkoster 13:41098c907200 39 * The ESP8266 class
screamer 5:81e264dbbf03 40 */
michaeljkoster 13:41098c907200 41 class ESP8266
samux 1:fb4494783863 42 {
samux 1:fb4494783863 43
samux 1:fb4494783863 44 public:
screamer 5:81e264dbbf03 45 /**
samux 1:fb4494783863 46 * Constructor
samux 1:fb4494783863 47 *
samux 1:fb4494783863 48 * @param tx mbed pin to use for tx line of Serial interface
samux 1:fb4494783863 49 * @param rx mbed pin to use for rx line of Serial interface
samux 1:fb4494783863 50 * @param reset reset pin of the wifi module ()
samux 1:fb4494783863 51 * @param ssid ssid of the network
screamer 9:f2439377c172 52 * @param phrase WEP, WPA or WPA2 key
mbedAustin 28:91e65e22e63a 53 * @param baud the baudrate of the serial connection
samux 1:fb4494783863 54 */
mbedAustin 28:91e65e22e63a 55 ESP8266( PinName tx, PinName rx, PinName reset, const char * ssid, const char * phrase, uint32_t baud );
samux 1:fb4494783863 56
screamer 5:81e264dbbf03 57 /**
samux 1:fb4494783863 58 * Connect the wifi module to the ssid contained in the constructor.
samux 1:fb4494783863 59 *
samux 1:fb4494783863 60 * @return true if connected, false otherwise
samux 1:fb4494783863 61 */
samux 1:fb4494783863 62 bool join();
samux 1:fb4494783863 63
screamer 5:81e264dbbf03 64 /**
michaeljkoster 15:37a7a56a424f 65 * Same as Join: connect to the ssid and get DHCP settings
screamer 6:5176e0864078 66 * @return true if successful
samux 1:fb4494783863 67 */
michaeljkoster 13:41098c907200 68 bool connect();
michaeljkoster 13:41098c907200 69
screamer 5:81e264dbbf03 70 /**
michaeljkoster 13:41098c907200 71 * Check connection to the access point
screamer 6:5176e0864078 72 * @return true if successful
samux 1:fb4494783863 73 */
michaeljkoster 13:41098c907200 74 bool is_connected();
samux 1:fb4494783863 75
screamer 5:81e264dbbf03 76 /**
michaeljkoster 15:37a7a56a424f 77 * Disconnect the ESP8266 module from the access point
michaeljkoster 15:37a7a56a424f 78 *
michaeljkoster 15:37a7a56a424f 79 * @return true if successful
michaeljkoster 15:37a7a56a424f 80 */
michaeljkoster 15:37a7a56a424f 81 bool disconnect();
michaeljkoster 16:3f0efaa57a12 82
michaeljkoster 16:3f0efaa57a12 83 /*
mbedAustin 30:c035696b9397 84 * Start up a UDP or TCP Connection
mbedAustin 30:c035696b9397 85 * @param type 0 for UDP, 1 for TCP
mbedAustin 30:c035696b9397 86 * @param ip A string that contains the IP, no quotes
mbedAustin 30:c035696b9397 87 * @param port Numerical port number to connect to
mbedAustin 30:c035696b9397 88 * @param id number between 0-4, if defined it denotes ID to use in multimode (Default to Single connection mode with -1)
mbedAustin 30:c035696b9397 89 * @return true if sucessful, 0 if fail
michaeljkoster 16:3f0efaa57a12 90 */
mbedAustin 30:c035696b9397 91 bool start(bool type, char* ip, int port, int id = -1);
mbedAustin 30:c035696b9397 92
mbedAustin 30:c035696b9397 93 /*
mbedAustin 30:c035696b9397 94 * Legacy Start for UDP only connection in transparent mode
mbedAustin 30:c035696b9397 95 * @param ip A string that contains the IP, no quotes
mbedAustin 30:c035696b9397 96 * @param port Numerical port number to connect to
mbedAustin 30:c035696b9397 97 */
mbedAustin 31:fd0eaf273b11 98 bool startUDP(char* ip, int port);
michaeljkoster 15:37a7a56a424f 99
michaeljkoster 15:37a7a56a424f 100 /**
michaeljkoster 16:3f0efaa57a12 101 * Close a connection
michaeljkoster 15:37a7a56a424f 102 *
michaeljkoster 15:37a7a56a424f 103 * @return true if successful
michaeljkoster 15:37a7a56a424f 104 */
michaeljkoster 15:37a7a56a424f 105 bool close();
michaeljkoster 15:37a7a56a424f 106
michaeljkoster 15:37a7a56a424f 107 /**
michaeljkoster 14:4d1128f72e00 108 * Return the IP address
michaeljkoster 14:4d1128f72e00 109 * @return IP address as a string
michaeljkoster 14:4d1128f72e00 110 */
michaeljkoster 14:4d1128f72e00 111 char* getIPAddress();
michaeljkoster 15:37a7a56a424f 112
michaeljkoster 15:37a7a56a424f 113 /**
michaeljkoster 15:37a7a56a424f 114 * Return the IP address from host name
mbedAustin 31:fd0eaf273b11 115 * @return true on success, false on failure
mbedAustin 32:cf071dc33972 116 */
mbedAustin 32:cf071dc33972 117 bool gethostbyname(const char * host, char * ip);
michaeljkoster 15:37a7a56a424f 118
michaeljkoster 14:4d1128f72e00 119 /**
samux 1:fb4494783863 120 * Reset the wifi module
samux 1:fb4494783863 121 */
samux 1:fb4494783863 122 void reset();
samux 3:9aa05e19c62e 123
screamer 5:81e264dbbf03 124 /**
samux 3:9aa05e19c62e 125 * Reboot the wifi module
samux 3:9aa05e19c62e 126 */
samux 3:9aa05e19c62e 127 bool reboot();
samux 1:fb4494783863 128
screamer 5:81e264dbbf03 129 /**
samux 1:fb4494783863 130 * Check if characters are available
samux 1:fb4494783863 131 *
samux 1:fb4494783863 132 * @return number of available characters
samux 1:fb4494783863 133 */
samux 1:fb4494783863 134 int readable();
samux 1:fb4494783863 135
screamer 5:81e264dbbf03 136 /**
samux 1:fb4494783863 137 * Check if characters are available
samux 1:fb4494783863 138 *
samux 1:fb4494783863 139 * @return number of available characters
samux 1:fb4494783863 140 */
samux 1:fb4494783863 141 int writeable();
samux 1:fb4494783863 142
screamer 5:81e264dbbf03 143 /**
samux 1:fb4494783863 144 * Read a character
samux 1:fb4494783863 145 *
samux 1:fb4494783863 146 * @return the character read
samux 1:fb4494783863 147 */
samux 1:fb4494783863 148 char getc();
samux 1:fb4494783863 149
screamer 5:81e264dbbf03 150 /**
samux 1:fb4494783863 151 * Write a character
samux 1:fb4494783863 152 *
samux 1:fb4494783863 153 * @param the character which will be written
samux 1:fb4494783863 154 */
samux 1:fb4494783863 155 int putc(char c);
samux 1:fb4494783863 156
screamer 5:81e264dbbf03 157 /**
michaeljkoster 15:37a7a56a424f 158 * Flush the buffer
michaeljkoster 15:37a7a56a424f 159 */
michaeljkoster 15:37a7a56a424f 160 void flush();
michaeljkoster 15:37a7a56a424f 161
michaeljkoster 15:37a7a56a424f 162 /**
mbedAustin 28:91e65e22e63a 163 * Send a command to the wifi module. Check if the module is in command mode. If not enter in command mode
michaeljkoster 15:37a7a56a424f 164 *
michaeljkoster 15:37a7a56a424f 165 * @param str string to be sent
michaeljkoster 15:37a7a56a424f 166 * @param ACK string which must be acknowledge by the wifi module. If ACK == NULL, no string has to be acknoledged. (default: "NO")
michaeljkoster 15:37a7a56a424f 167 * @param res this field will contain the response from the wifi module, result of a command sent. This field is available only if ACK = "NO" AND res != NULL (default: NULL)
samux 1:fb4494783863 168 *
screamer 6:5176e0864078 169 * @return true if successful
samux 1:fb4494783863 170 */
michaeljkoster 15:37a7a56a424f 171 bool sendCommand(const char * cmd, const char * ack = NULL, char * res = NULL, int timeout = DEFAULT_WAIT_RESP_TIMEOUT);
michaeljkoster 15:37a7a56a424f 172
screamer 5:81e264dbbf03 173 /**
samux 1:fb4494783863 174 * Send a string to the wifi module by serial port. This function desactivates the user interrupt handler when a character is received to analyze the response from the wifi module.
samux 1:fb4494783863 175 * Useful to send a command to the module and wait a response.
samux 1:fb4494783863 176 *
samux 1:fb4494783863 177 *
samux 1:fb4494783863 178 * @param str string to be sent
samux 1:fb4494783863 179 * @param len string length
samux 1:fb4494783863 180 * @param ACK string which must be acknowledge by the wifi module. If ACK == NULL, no string has to be acknoledged. (default: "NO")
samux 1:fb4494783863 181 * @param res this field will contain the response from the wifi module, result of a command sent. This field is available only if ACK = "NO" AND res != NULL (default: NULL)
samux 1:fb4494783863 182 *
samux 1:fb4494783863 183 * @return true if ACK has been found in the response from the wifi module. False otherwise or if there is no response in 5s.
samux 1:fb4494783863 184 */
michaeljkoster 16:3f0efaa57a12 185 int send(const char * buf, int len);
samux 1:fb4494783863 186
michaeljkoster 13:41098c907200 187 static ESP8266 * getInstance() {
samux 1:fb4494783863 188 return inst;
samux 1:fb4494783863 189 };
samux 1:fb4494783863 190
samux 1:fb4494783863 191 protected:
mbedAustin 28:91e65e22e63a 192 RawSerial wifi;
samux 1:fb4494783863 193 DigitalOut reset_pin;
samux 1:fb4494783863 194 char phrase[30];
samux 1:fb4494783863 195 char ssid[30];
michaeljkoster 14:4d1128f72e00 196 char ipString[20];
michaeljkoster 13:41098c907200 197 CircBuffer<char> buf_ESP8266;
samux 1:fb4494783863 198
michaeljkoster 13:41098c907200 199 static ESP8266 * inst;
samux 1:fb4494783863 200
samux 1:fb4494783863 201 void attach_rx(bool null);
samux 1:fb4494783863 202 void handler_rx(void);
samux 1:fb4494783863 203
samux 1:fb4494783863 204
samux 1:fb4494783863 205 typedef struct STATE {
samux 1:fb4494783863 206 bool associated;
michaeljkoster 22:c4360e61486a 207 bool cmdMode;
samux 1:fb4494783863 208 } State;
samux 1:fb4494783863 209
samux 1:fb4494783863 210 State state;
samux 1:fb4494783863 211 };
samux 1:fb4494783863 212
samux 1:fb4494783863 213 #endif