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
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: Wifly/Wifly.h
- Revision:
- 13:41098c907200
- Parent:
- 12:c5f0eac67a8a
- Child:
- 14:4d1128f72e00
--- a/Wifly/Wifly.h Wed Oct 08 19:57:58 2014 +0000
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,242 +0,0 @@
-/* Copyright (C) 2012 mbed.org, MIT License
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
- * and associated documentation files (the "Software"), to deal in the Software without restriction,
- * including without limitation the rights to use, copy, modify, merge, publish, distribute,
- * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all copies or
- * substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
- * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
- * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
- * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- *
- * @section DESCRIPTION
- *
- * Wifly RN131-C, wifi module
- *
- * Datasheet:
- *
- * http://dlnmh9ip6v2uc.cloudfront.net/datasheets/Wireless/WiFi/WiFly-RN-UM.pdf
- */
-
-#ifndef WIFLY_H
-#define WIFLY_H
-
-#include "mbed.h"
-#include "CBuffer.h"
-
-#define DEFAULT_WAIT_RESP_TIMEOUT 500
-
-enum Security {
- NONE = 0,
- WEP_128 = 1,
- WPA = 3,
- WPA2 = 4,
-};
-
-enum Protocol {
- UDP = (1 << 0),
- TCP = (1 << 1)
-};
-
-/**
- * The Wifly class
- */
-class Wifly
-{
-
-public:
- /**
- * Constructor
- *
- * @param tx mbed pin to use for tx line of Serial interface
- * @param rx mbed pin to use for rx line of Serial interface
- * @param reset reset pin of the wifi module ()
- * @param tcp_status connection status pin of the wifi module (GPIO 6)
- * @param ssid ssid of the network
- * @param phrase WEP, WPA or WPA2 key
- * @param sec Security type (NONE, WEP_128 or WPA, WPA2)
- */
- Wifly( PinName tx, PinName rx, PinName reset, PinName tcp_status, const char * ssid, const char * phrase, Security sec);
-
- /**
- * Connect the wifi module to the ssid contained in the constructor.
- *
- * @return true if connected, false otherwise
- */
- bool join();
-
- /**
- * Disconnect the wifly module from the access point
- *
- * @return true if successful
- */
- bool disconnect();
-
- /**
- * Open a tcp connection with the specified host on the specified port
- *
- * @param host host (can be either an ip address or a name. If a name is provided, a dns request will be established)
- * @param port port
- * @return true if successful
- */
- bool connect(const char * host, int port);
-
-
- /**
- * Set the protocol (UDP or TCP)
- *
- * @param p protocol
- * @return true if successful
- */
- bool setProtocol(Protocol p);
-
- /**
- * Reset the wifi module
- */
- void reset();
-
- /**
- * Reboot the wifi module
- */
- bool reboot();
-
- /**
- * Check if characters are available
- *
- * @return number of available characters
- */
- int readable();
-
- /**
- * Check if characters are available
- *
- * @return number of available characters
- */
- int writeable();
-
- /**
- * Check if a tcp link is active
- *
- * @return true if successful
- */
- bool is_connected();
-
- /**
- * Read a character
- *
- * @return the character read
- */
- char getc();
-
- /**
- * Flush the buffer
- */
- void flush();
-
- /**
- * Write a character
- *
- * @param the character which will be written
- */
- int putc(char c);
-
-
- /**
- * To enter in command mode (we can configure the module)
- *
- * @return true if successful, false otherwise
- */
- bool cmdMode();
-
- /**
- * To exit the command mode
- *
- * @return true if successful, false otherwise
- */
- bool exit();
-
- /**
- * Close a tcp connection
- *
- * @return true if successful
- */
- bool close();
-
- /**
- * 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.
- * Useful to send a command to the module and wait a response.
- *
- *
- * @param str string to be sent
- * @param len string length
- * @param ACK string which must be acknowledge by the wifi module. If ACK == NULL, no string has to be acknoledged. (default: "NO")
- * @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)
- *
- * @return true if ACK has been found in the response from the wifi module. False otherwise or if there is no response in 5s.
- */
- int send(const char * str, int len, const char * ACK = NULL, char * res = NULL, int timeout = DEFAULT_WAIT_RESP_TIMEOUT);
-
- /**
- * Send a command to the wify module. Check if the module is in command mode. If not enter in command mode
- *
- * @param str string to be sent
- * @param ACK string which must be acknowledge by the wifi module. If ACK == NULL, no string has to be acknoledged. (default: "NO")
- * @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)
- *
- * @return true if successful
- */
- bool sendCommand(const char * cmd, const char * ack = NULL, char * res = NULL, int timeout = DEFAULT_WAIT_RESP_TIMEOUT);
-
- /**
- * Return true if the module is using dhcp
- *
- * @return true if the module is using dhcp
- */
- bool isDHCP() {
- return state.dhcp;
- }
-
- bool gethostbyname(const char * host, char * ip);
-
- static Wifly * getInstance() {
- return inst;
- };
-
-protected:
- Serial wifi;
- DigitalOut reset_pin;
- DigitalIn tcp_status;
- char phrase[30];
- char ssid[30];
- const char * ip;
- const char * netmask;
- const char * gateway;
- int channel;
- CircBuffer<char> buf_wifly;
-
- static Wifly * inst;
-
- void attach_rx(bool null);
- void handler_rx(void);
-
-
- typedef struct STATE {
- bool associated;
- bool tcp;
- bool dhcp;
- Security sec;
- Protocol proto;
- bool cmd_mode;
- } State;
-
- State state;
- char * getStringSecurity();
-};
-
-#endif
\ No newline at end of file
ESP8266

Adafruit Huzzah