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)

Diff: ESP8266/ESP8266.cpp

Revision:
15:37a7a56a424f
Parent:
14:4d1128f72e00
Child:
16:3f0efaa57a12
--- a/ESP8266/ESP8266.cpp	Sun Nov 30 21:37:16 2014 +0000
+++ b/ESP8266/ESP8266.cpp	Sun Nov 30 21:56:03 2014 +0000
@@ -83,6 +83,32 @@
     return join();
 }
 
+bool ESP8266::is_connected()
+{
+    return true;
+}
+
+bool ESP8266::close()
+{
+    return true;
+}
+
+bool ESP8266::disconnect()
+{
+    // if already disconnected, return
+    if (!state.associated)
+        return true;
+    // send command to quit AP
+    //    
+    state.associated = false;
+    return true;
+}
+
+char* ESP8266::getIPAddress()
+{
+    return ipString;
+}
+
 bool ESP8266::gethostbyname(const char * host, char * ip)
 {
     string h = host;
@@ -105,43 +131,6 @@
     }
 }
 
-void ESP8266::flush()
-{
-    buf_ESP8266.flush();
-}
-
-bool ESP8266::sendCommand(const char * cmd, const char * ack, char * res, int timeout)
-{
-    return true;
-}
-
-bool ESP8266::close()
-{
-    return true;
-}
-
-bool ESP8266::disconnect()
-{
-    // if already disconnected, return
-    if (!state.associated)
-        return true;
-    // send command to quit AP
-    //    
-    state.associated = false;
-    return true;
-
-}
-
-bool ESP8266::is_connected()
-{
-    return true;
-}
-
-char* ESP8266::getIPAddress()
-{
-    return ipString;
-}
-
 void ESP8266::reset()
 {
     reset_pin = 0;
@@ -155,10 +144,19 @@
     return true;
 }
 
-int ESP8266::putc(char c)
+void ESP8266::handler_rx(void)
 {
-    while (!wifi.writeable());
-    return wifi.putc(c);
+    //read characters
+    while (wifi.readable())
+        buf_ESP8266.queue(wifi.getc());
+}
+
+void ESP8266::attach_rx(bool callback)
+{
+    if (!callback)
+        wifi.attach(NULL);
+    else
+        wifi.attach(this, &ESP8266::handler_rx);
 }
 
 int ESP8266::readable()
@@ -179,21 +177,21 @@
     return c;
 }
 
-void ESP8266::handler_rx(void)
+int ESP8266::putc(char c)
 {
-    //read characters
-    while (wifi.readable())
-        buf_ESP8266.queue(wifi.getc());
+    while (!wifi.writeable());
+    return wifi.putc(c);
 }
 
-void ESP8266::attach_rx(bool callback)
+void ESP8266::flush()
 {
-    if (!callback)
-        wifi.attach(NULL);
-    else
-        wifi.attach(this, &ESP8266::handler_rx);
+    buf_ESP8266.flush();
 }
 
+bool ESP8266::sendCommand(const char * cmd, const char * ack, char * res, int timeout)
+{
+    return true;
+}
 
 int ESP8266::send(const char * str, int len, const char * ACK, char * res, int timeout)
 {
@@ -300,4 +298,4 @@
     attach_rx(true);
     DBG("result: %d\r\n", result)
     return result;
-}
\ No newline at end of file
+}