A library for the Roving Networks WiFly RN-XV.
The library provides functions for setting up and managing the WiFly module,
sending UDP packets, opening TCP connections and sending and receiving data
over the TCP connection.
Example code to setup and use the hardware serial interface:
Serial.begin(9600);
wifly.begin(&Serial, NULL);
Setup and use a software serial interface:
#include <SoftwareSerial.h>
SoftwareSerial wifiSerial(8,9);
wifiSerial.begin(9600);
wifly.begin(&wifiSerial);
Join a WiFi network:
wifly.setSSID("mySSID");
wifly.setPassphrase("myWPApassword");
wifly.enableDHCP();
wifly.join();
Create an Ad Hoc WiFi network on channel 10:
wifly.createAdhocNetwork("myssid", 10);
Send a UDP packet:
wifly.setIpProtocol(WIFLY_PROTOCOL_UDP);
wifly.sendto("Hello, world", "192.168.1.100", 2042);
Open a TCP connection and send some data, and close the connection:
wifly.setIpProtocol(WIFLY_PROTOCOL_TCP);
wifly.open("192.168.1.100",8042);
wifly.println("Hello, world!");
wifly.close();
Receive UDP or TCP data (assumes software serial interface):
if (wifly.available() > 0) {
Serial.write(wifly.read());
}
Easy handling of multiple receive options with multiMatch_P()::
if (wifly.available() > 0) {
int match = wifly.multiMatch_P(100, 3,
F("button"), F("slider="), F("switch="));
switch (match) {
case 0: /* button */
Serial.print(F("button: pressed"));
break;
case 1: /* slider */
int slider = wifly.parseInt();
Serial.print(F("slider: "));
Serial.println(slider);
break;
case 2: /* switch */
char ch = wifly.read();
Serial.print(F("switch: "));
Serial.println(ch);
break;
default: /* timeout */
break;
}
}
Limitations with WiFly RN-XV rev 2.32 firmware
1. Cannot determine the IP address of the TCP client that has connected.
2. Changing the local port does not take effect until after a save and reboot.
3. Closing a TCP connection may not work. Client may stay connected
and send additional data. Packet analysis shows that no FIN is sent
by the WiFly, but it still sends the *CLOS* message back to the
arduino.
4. Only supports one TCP connection at a time, which means its easy
for a web browser to lock out other users.
5. Changing the flush timeout (set comm time x) does not take affect until
after a save and reboot.
To do:
1. Add FTP support.
