Junichi Katsu / Milkcocoa

データの保存、更新、取得ができるWebサービス「milkcocoa」に接続し、データのプッシュ、送信、取得ができるライブラリです。 https://mlkcca.com/

Dependencies:   MQTT

Dependents:   MilkcocoaSample MilkcocoaSampleESP8266_LED MilkcocoaSampleESP8266 MilkcocoaSample_3G ... more

ESP8266InterfaceTiny/ESP8266/ESP8266.h@0:23e533c4b1ec, 2015-12-15 (annotated)

Committer:
jksoft
Date:
Tue Dec 15 09:56:32 2015 +0000
Revision:
0:23e533c4b1ec
??; Subscribe?1?????; ?Milkcocoa::on???????????????????????

Who changed what in which revision?

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