Bjorn Van Bockel / Wifly_RNXV

Wifly interface for RN-XV (wifly RN171XVW) senCommand: ssid & pharse no AOK needed

Fork of WiflyInterface by mbed official

Wifly/Wifly.h@10:07a3be55bb0a, 2014-02-05 (annotated)

Committer:
BjornVB
Date:
Wed Feb 05 21:11:23 2014 +0000
Revision:
10:07a3be55bb0a
Parent:
1:fb4494783863 
Wifly library for RN171XVW (RN-XV) Wifly; sendCommand: ssid and phrase --> no AOK //solved

Who changed what in which revision?

UserRevisionLine numberNew contents of line
samux 1:fb4494783863 1 /* Copyright (C) 2012 mbed.org, MIT License
samux 1:fb4494783863 2 *
samux 1:fb4494783863 3 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
samux 1:fb4494783863 4 * and associated documentation files (the "Software"), to deal in the Software without restriction,
samux 1:fb4494783863 5 * including without limitation the rights to use, copy, modify, merge, publish, distribute,
samux 1:fb4494783863 6 * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
samux 1:fb4494783863 7 * furnished to do so, subject to the following conditions:
samux 1:fb4494783863 8 *
samux 1:fb4494783863 9 * The above copyright notice and this permission notice shall be included in all copies or
samux 1:fb4494783863 10 * substantial portions of the Software.
samux 1:fb4494783863 11 *
samux 1:fb4494783863 12 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
samux 1:fb4494783863 13 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
samux 1:fb4494783863 14 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
samux 1:fb4494783863 15 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
samux 1:fb4494783863 16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
samux 1:fb4494783863 17 *
samux 1:fb4494783863 18 * @section DESCRIPTION
samux 1:fb4494783863 19 *
samux 1:fb4494783863 20 * Wifly RN131-C, wifi module
samux 1:fb4494783863 21 *
samux 1:fb4494783863 22 * Datasheet:
samux 1:fb4494783863 23 *
samux 1:fb4494783863 24 * http://dlnmh9ip6v2uc.cloudfront.net/datasheets/Wireless/WiFi/WiFly-RN-UM.pdf
samux 1:fb4494783863 25 */
samux 1:fb4494783863 26
samux 1:fb4494783863 27 #ifndef WIFLY_H
samux 1:fb4494783863 28 #define WIFLY_H
samux 1:fb4494783863 29
BjornVB 10:07a3be55bb0a 30
samux 1:fb4494783863 31 #include "mbed.h"
samux 1:fb4494783863 32 #include "CBuffer.h"
samux 1:fb4494783863 33
samux 1:fb4494783863 34 #define DEFAULT_WAIT_RESP_TIMEOUT 500
samux 1:fb4494783863 35
samux 1:fb4494783863 36 enum Security {
samux 1:fb4494783863 37 NONE = 0,
samux 1:fb4494783863 38 WEP_128 = 1,
BjornVB 10:07a3be55bb0a 39 WPA1 = 2,
samux 1:fb4494783863 40 WPA = 3
samux 1:fb4494783863 41 };
samux 1:fb4494783863 42
samux 1:fb4494783863 43 enum Protocol {
samux 1:fb4494783863 44 UDP = (1 << 0),
samux 1:fb4494783863 45 TCP = (1 << 1)
samux 1:fb4494783863 46 };
samux 1:fb4494783863 47
samux 1:fb4494783863 48 class Wifly
samux 1:fb4494783863 49 {
samux 1:fb4494783863 50
samux 1:fb4494783863 51 public:
samux 1:fb4494783863 52 /*
samux 1:fb4494783863 53 * Constructor
samux 1:fb4494783863 54 *
samux 1:fb4494783863 55 * @param tx mbed pin to use for tx line of Serial interface
samux 1:fb4494783863 56 * @param rx mbed pin to use for rx line of Serial interface
samux 1:fb4494783863 57 * @param reset reset pin of the wifi module ()
samux 1:fb4494783863 58 * @param tcp_status connection status pin of the wifi module (GPIO 6)
samux 1:fb4494783863 59 * @param ssid ssid of the network
samux 1:fb4494783863 60 * @param phrase WEP or WPA key
samux 1:fb4494783863 61 * @param sec Security type (NONE, WEP_128 or WPA)
samux 1:fb4494783863 62 */
samux 1:fb4494783863 63 Wifly( PinName tx, PinName rx, PinName reset, PinName tcp_status, const char * ssid, const char * phrase, Security sec);
samux 1:fb4494783863 64
samux 1:fb4494783863 65 /*
samux 1:fb4494783863 66 * Connect the wifi module to the ssid contained in the constructor.
samux 1:fb4494783863 67 *
samux 1:fb4494783863 68 * @return true if connected, false otherwise
samux 1:fb4494783863 69 */
samux 1:fb4494783863 70 bool join();
samux 1:fb4494783863 71
samux 1:fb4494783863 72 /*
samux 1:fb4494783863 73 * Disconnect the wifly module from the access point
samux 1:fb4494783863 74 *
samux 1:fb4494783863 75 * @ returns true if successful
samux 1:fb4494783863 76 */
samux 1:fb4494783863 77 bool disconnect();
samux 1:fb4494783863 78
samux 1:fb4494783863 79 /*
samux 1:fb4494783863 80 * Open a tcp connection with the specified host on the specified port
samux 1:fb4494783863 81 *
samux 1:fb4494783863 82 * @param host host (can be either an ip address or a name. If a name is provided, a dns request will be established)
samux 1:fb4494783863 83 * @param port port
samux 1:fb4494783863 84 * @ returns true if successful
samux 1:fb4494783863 85 */
samux 1:fb4494783863 86 bool connect(const char * host, int port);
samux 1:fb4494783863 87
samux 1:fb4494783863 88
samux 1:fb4494783863 89 /*
samux 1:fb4494783863 90 * Set the protocol (UDP or TCP)
samux 1:fb4494783863 91 *
samux 1:fb4494783863 92 * @param p protocol
samux 1:fb4494783863 93 * @ returns true if successful
samux 1:fb4494783863 94 */
samux 1:fb4494783863 95 bool setProtocol(Protocol p);
samux 1:fb4494783863 96
samux 1:fb4494783863 97 /*
samux 1:fb4494783863 98 * Reset the wifi module
samux 1:fb4494783863 99 */
samux 1:fb4494783863 100 void reset();
samux 1:fb4494783863 101
samux 1:fb4494783863 102 /*
samux 1:fb4494783863 103 * Check if characters are available
samux 1:fb4494783863 104 *
samux 1:fb4494783863 105 * @return number of available characters
samux 1:fb4494783863 106 */
samux 1:fb4494783863 107 int readable();
samux 1:fb4494783863 108
samux 1:fb4494783863 109 /*
samux 1:fb4494783863 110 * Check if characters are available
samux 1:fb4494783863 111 *
samux 1:fb4494783863 112 * @return number of available characters
samux 1:fb4494783863 113 */
samux 1:fb4494783863 114 int writeable();
samux 1:fb4494783863 115
samux 1:fb4494783863 116 /*
samux 1:fb4494783863 117 * Check if a tcp link is active
samux 1:fb4494783863 118 *
samux 1:fb4494783863 119 * @returns true if successful
samux 1:fb4494783863 120 */
samux 1:fb4494783863 121 bool is_connected();
samux 1:fb4494783863 122
samux 1:fb4494783863 123 /*
samux 1:fb4494783863 124 * Read a character
samux 1:fb4494783863 125 *
samux 1:fb4494783863 126 * @return the character read
samux 1:fb4494783863 127 */
samux 1:fb4494783863 128 char getc();
samux 1:fb4494783863 129
samux 1:fb4494783863 130 /*
samux 1:fb4494783863 131 * Flush the buffer
samux 1:fb4494783863 132 */
samux 1:fb4494783863 133 void flush();
samux 1:fb4494783863 134
samux 1:fb4494783863 135 /*
samux 1:fb4494783863 136 * Write a character
samux 1:fb4494783863 137 *
samux 1:fb4494783863 138 * @param the character which will be written
samux 1:fb4494783863 139 */
samux 1:fb4494783863 140 int putc(char c);
BjornVB 10:07a3be55bb0a 141
samux 1:fb4494783863 142 /*
samux 1:fb4494783863 143 * To enter in command mode (we can configure the module)
samux 1:fb4494783863 144 *
samux 1:fb4494783863 145 * @return true if successful, false otherwise
samux 1:fb4494783863 146 */
samux 1:fb4494783863 147 bool cmdMode();
samux 1:fb4494783863 148
samux 1:fb4494783863 149 /*
samux 1:fb4494783863 150 * To exit the command mode
samux 1:fb4494783863 151 *
samux 1:fb4494783863 152 * @return true if successful, false otherwise
samux 1:fb4494783863 153 */
samux 1:fb4494783863 154 bool exit();
samux 1:fb4494783863 155
samux 1:fb4494783863 156 /*
samux 1:fb4494783863 157 * Close a tcp connection
samux 1:fb4494783863 158 *
samux 1:fb4494783863 159 * @ returns true if successful
samux 1:fb4494783863 160 */
samux 1:fb4494783863 161 bool close();
samux 1:fb4494783863 162
samux 1:fb4494783863 163 /*
samux 1:fb4494783863 164 * 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.
samux 1:fb4494783863 165 * Useful to send a command to the module and wait a response.
samux 1:fb4494783863 166 *
samux 1:fb4494783863 167 *
samux 1:fb4494783863 168 * @param str string to be sent
samux 1:fb4494783863 169 * @param len string length
samux 1:fb4494783863 170 * @param ACK string which must be acknowledge by the wifi module. If ACK == NULL, no string has to be acknoledged. (default: "NO")
samux 1:fb4494783863 171 * @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)
samux 1:fb4494783863 172 *
samux 1:fb4494783863 173 * @return true if ACK has been found in the response from the wifi module. False otherwise or if there is no response in 5s.
samux 1:fb4494783863 174 */
samux 1:fb4494783863 175 int send(const char * str, int len, const char * ACK = NULL, char * res = NULL, int timeout = DEFAULT_WAIT_RESP_TIMEOUT);
samux 1:fb4494783863 176
samux 1:fb4494783863 177 /*
samux 1:fb4494783863 178 * Send a command to the wify module. Check if the module is in command mode. If not enter in command mode
samux 1:fb4494783863 179 *
samux 1:fb4494783863 180 * @param str string to be sent
samux 1:fb4494783863 181 * @param ACK string which must be acknowledge by the wifi module. If ACK == NULL, no string has to be acknoledged. (default: "NO")
samux 1:fb4494783863 182 * @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)
samux 1:fb4494783863 183 *
samux 1:fb4494783863 184 * @returns true if successful
samux 1:fb4494783863 185 */
samux 1:fb4494783863 186 bool sendCommand(const char * cmd, const char * ack = NULL, char * res = NULL, int timeout = DEFAULT_WAIT_RESP_TIMEOUT);
samux 1:fb4494783863 187
samux 1:fb4494783863 188 bool gethostbyname(const char * host, char * ip);
samux 1:fb4494783863 189
samux 1:fb4494783863 190 static Wifly * getInstance() {
samux 1:fb4494783863 191 return inst;
samux 1:fb4494783863 192 };
samux 1:fb4494783863 193
samux 1:fb4494783863 194 protected:
samux 1:fb4494783863 195 Serial wifi;
samux 1:fb4494783863 196 DigitalOut reset_pin;
samux 1:fb4494783863 197 DigitalIn tcp_status;
samux 1:fb4494783863 198 char phrase[30];
samux 1:fb4494783863 199 char ssid[30];
samux 1:fb4494783863 200 const char * ip;
samux 1:fb4494783863 201 const char * netmask;
samux 1:fb4494783863 202 const char * gateway;
samux 1:fb4494783863 203 int channel;
samux 1:fb4494783863 204 CircBuffer<char> buf_wifly;
samux 1:fb4494783863 205
samux 1:fb4494783863 206 static Wifly * inst;
samux 1:fb4494783863 207
samux 1:fb4494783863 208 void attach_rx(bool null);
samux 1:fb4494783863 209 void handler_rx(void);
samux 1:fb4494783863 210
samux 1:fb4494783863 211
samux 1:fb4494783863 212 typedef struct STATE {
samux 1:fb4494783863 213 bool associated;
samux 1:fb4494783863 214 bool tcp;
samux 1:fb4494783863 215 bool dhcp;
samux 1:fb4494783863 216 Security sec;
samux 1:fb4494783863 217 Protocol proto;
samux 1:fb4494783863 218 bool cmd_mode;
samux 1:fb4494783863 219 } State;
samux 1:fb4494783863 220
samux 1:fb4494783863 221 State state;
samux 1:fb4494783863 222 char * getStringSecurity();
samux 1:fb4494783863 223 };
samux 1:fb4494783863 224
samux 1:fb4494783863 225 #endif