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: Socket/UDPSocket.cpp

Revision:
37:6887e61cf674
Parent:
31:fd0eaf273b11
Child:
38:86e75901efc1
--- a/Socket/UDPSocket.cpp	Sat May 02 03:30:52 2015 +0000
+++ b/Socket/UDPSocket.cpp	Sat May 02 03:58:22 2015 +0000
@@ -48,7 +48,14 @@
     int idx = 0;
 
     confEndpoint(remote);
-
+    // initialize transparent mode if not already done
+    if(!endpoint_configured) {
+        // initialize UDP (default id of -1 means transparent mode)
+        if(!wifi->start(ESP_UDP_TYPE, remote._ipAddress, remote._port, remote._id)) {
+            return(-1);
+        }
+        endpoint_configured = true;
+    }
     tmr.start();
 
     while ((tmr.read_ms() < _timeout) || _blocking) {
@@ -68,13 +75,13 @@
     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);
-        // }
+    // if ( wifi.readable <= 0 ) {
+    // return (wifi.readable);
+    // }
     // }
     //---
     tmr.start();
@@ -90,28 +97,28 @@
     // blocking case
     else {
         tmr.reset();
-        
-        while (time < _timeout){
+
+        while (time < _timeout) {
             nb_available = wifi->readable();
             if (nb_available < 0) return nb_available;
             if (nb_available > 0) break ;
             time = tmr.read_ms();
         }
-        
-        if (nb_available == 0) return nb_available;  
-    } 
-    
+
+        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;
-        // }
+    // if ( wifi.readable() && (idx < length) ) {
+    // buffer[idx++] = wifi->getc();
+    // tmr.reset();
+    // }
+    // if ( idx == length ) {
+    // break;
+    // }
     // }
     //---
     while (time < _timeout) {