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)

Files at this revision

API Documentation at this revision

Revision 27:9c6cefc12f0c, committed 2015-04-20

Comitter:
michaeljkoster
Date:
Mon Apr 20 20:27:11 2015 +0000
Parent:
26:0d5bcb3903e2
Child:
28:91e65e22e63a
Commit message:
Blocking

Changed in this revision

Socket/UDPSocket.cpp Show annotated file Show diff for this revision Revisions of this file 
--- a/Socket/UDPSocket.cpp	Tue Dec 30 03:21:33 2014 +0000
+++ b/Socket/UDPSocket.cpp	Mon Apr 20 20:27:11 2015 +0000
@@ -68,8 +68,16 @@
     int idx = 0;
     int nb_available = 0;
     int time = -1;
+    
+    //make this the non-blocking case and return if <= 0
+    // remember to change the config to blocking
+    // if ( ! _blocking) {
+        // if ( wifi.readable <= 0 ) {
+            // return (wifi.readable);
+        // }
+    // }
+    //---
     tmr.start();
-    
     if (_blocking) {
         while (1) {
             nb_available = wifi->readable();
@@ -78,6 +86,8 @@
             }
         }
     }
+    //---
+    // blocking case
     else {
         tmr.reset();
         
@@ -91,7 +101,19 @@
         if (nb_available == 0) return nb_available;  
     } 
     
+    // change this to < 20 mS timeout per byte to detect end of packet gap
+    // this may not work due to buffering at the UART interface
     tmr.reset();
+    // while ( tmr.read_ms() < 20 ) {
+        // if ( wifi.readable() && (idx < length) ) {
+            // buffer[idx++] = wifi->getc();
+            // tmr.reset();
+        // }
+        // if ( idx == length ) {
+            // break;
+        // }
+    // }
+    //---
     while (time < _timeout) {
 
         nb_available = wifi->readable();
@@ -105,6 +127,7 @@
         }
         time = tmr.read_ms();
     }
+    //---
     readEndpoint(remote);
     return (idx == 0) ? -1 : idx;
 }