arduino - wifi - rn-wiflycr-ug-v1.2r - users guide.pdf

WiFly Command Reference, Advanced Features & Applications User’s GuideMODULES SUPPORTED:RN121RN123RN125RN131RN171RN174RN171XV

RN-WIFLYCR-UG

© 2013 Roving Networks. All rights reserved.

RN-WIFLYCR-UG Version 1.2r 4/30/13

Roving Networks, Inc.102 Cooper CourtLos Gatos, CA 95032+1 (408) 395-5300www.rovingnetworks.com

Copyright © 2013 Roving Networks. All rights reserved. Roving Networks is a registered trademark of Roving Networks. Apple Inc., iPhone, iPad, iTunes, Made for iPhone are registered trademarks of Apple Computer.

Roving Networks reserves the right to make corrections, modifications, and other changes to its products, documentation and services at any time. Customers should obtain the latest relevant information before plac-ing orders and should verify that such information is current and com-plete.

Roving Networks assumes no liability for applications assistance or cus-tomer’s product design. Customers are responsible for their products and applications that use Roving Networks components. To minimize cus-tomer product risks, customers should provide adequate design and oper-ating safeguards.

Roving Networks products are not authorized for use in safety-critical applications (such as life support) where a failure of the Roving Networks product would reasonably be expected to cause severe personal injury or death, unless officers of the parties have executed an agreement specifi-cally governing such use.

www.rovingnetworks.com Version 1.2r 4/30/13 page 2

RN-WIFLYCR-UG

Table of ContentsChapter 1. Introduction

1.1 Overview ........................................................................................................ 51.2 Configuration .................................................................................................. 6

Chapter 2. Command Reference2.1 Command Syntax ........................................................................................... 92.2 Command Organization ................................................................................. 92.3 Set Commands ............................................................................................. 102.4 Get Commands ............................................................................................ 352.5 Status Commands ........................................................................................ 372.6 Action Commands ........................................................................................ 402.7 File I/O Commands ...................................................................................... 43

Chapter 3. Advanced Features & Settings3.1 Access Point (AP) Mode .............................................................................. 453.2 Configuration Web Server ............................................................................ 493.3 Putting the Module to Sleep & Waking It ...................................................... 553.4 System & Auto-Connect Timers ................................................................... 573.5 Wake on Sensor Input .................................................................................. 583.6 Wake on UART Activity ................................................................................ 593.7 Setting Debug Print Levels ........................................................................... 643.8 Using the Real-Time Clock Function ............................................................ 673.9 Time Stamping Packets ............................................................................... 69

Chapter 4. Advanced Applications4.1 Sending Data using UDP ............................................................................. 714.2 Joining Networks & Making Connections ..................................................... 734.3 Making Connections ..................................................................................... 754.4 Using the HTML Client Feature .................................................................... 774.5 Upgrading Firmware Via FTP ....................................................................... 834.6 FTP Client .................................................................................................... 864.7 Wi-Fi Protected Setup (WPS) ....................................................................... 874.8 Ad hoc Networking Mode ............................................................................. 894.9 Analog Sensor Capability ............................................................................ 92

Appendix A. Default ConfigurationA.1 ADHOC PARAMETERS .............................................................................. 95A.2 BROADCAST PARAMETERS ..................................................................... 95A.3 COMM PARAMETERS ................................................................................ 95A.4 DNS PARAMETERS .................................................................................... 95A.5 FTP PARAMETERS .................................................................................... 95A.6 IP PARAMETERS ........................................................................................ 96


RN-WIFLYCR-UG

A.7 OPTIONAL PARAMETERS ......................................................................... 96A.8 SYSTEM PARAMETERS ............................................................................ 96A.9 TIME SERVER PARAMETERS ................................................................... 97A.10 UART PARAMETERS ............................................................................... 97A.11 WLAN PARAMETERS ............................................................................... 97A.12 String Variable Sizes .................................................................................. 97A.13 Restoring Default Configuration Settings .................................................. 98

Appendix B. Boot-Up Timing ValuesAppendix C. Supported Access PointsAppendix D. Command Quick Reference GuideAppendix E. Known ProblemsAppendix F. Current Firmware Features & Fixes

F.1 VERSION 4.00.1 4/19/2013 ....................................................................... 111F.2 VERSION 4.0 3/27/13 ................................................................................ 111F.3 Version 2.36/2.45 9/14/2012 ...................................................................... 112F.4 Version 2.30 10/26/2011 ............................................................................ 112F.5 Version 2.27 09/08/11 ................................................................................ 113F.6 Version 2.23 04/03/2011 ............................................................................ 113F.7 Version 2.21 07/11/2010 ............................................................................ 114F.8 Version 2.20 06/14/2010 ........................................................................... 114

Appendix G. Document Information

RN-WIFLYCR-UG

Chapter 1. Introduction1.1 OVERVIEW

The Roving Networks WiFly radio module is a complete, standalone embedded wire-less LAN access device. The device has an on-board TCP/IP stack and applications, and in the simplest hardware configuration requires only four pins (power, TX, RX, and ground). Once you have performed the initial configuration, the device automatically accesses a Wi-Fi network and sends/receives serial data.This user manual is applicable to standalone RN131 and RN171 modules, as well as Roving Networks products based on these modules. For example, the RN171XV device incorporates the RN171 module; therefore, all RN171 hardware features apply to the RN171XV. Although there are some differences, the RN131 and RN171 modules support the same ASCII command set. Table 1-1 compares the RN131 and RN171 module features.

Refer to the RN131 and the RN171 data sheets on the Roving Networks website at http://www.rovingnetworks.com for more details on their hardware differences and for detailed hardware specifications.

1.1.1 Features• Fully qualified and Wi-Fi certified 2.4-GHz IEEE 802.11 b/g transceiver• FCC, CE, IC certified, and RoHS compliant• Ultra-low power:

- Intelligent, built-in power management with programmable wakeup- Accepts 3.3-V power supply or 2- to 3-V battery when using boost regulators- RN131: 4 uA sleep, 35 mA Rx, 210 m Tx at 18 dBm (Tx power not configu-

rable)- RN171: 4 uA sleep, 35 mA Rx, 185 mA Tx at 12 dBm (Tx power configurable)

• Antenna options:- RN131: On-board ceramic chip antenna and U.FL connector for external

antenna- RN171: RF pad

• Hardware:- 8-Mbit flash memory and 128-Kbyte RAM, 2-Kbyte ROM, 2 Kbyte battery-

backed memory- General-purpose digital I/O pins (RN131: 10 GPIO pins, RN171: 14 GPIO

pins)

TABLE 1-1: COMPARING THE RN131 & RN171Feature RN131 RN171

Output power (PMAX) 18 dBm (fixed) 12 dBm (programmable)Lowest power 18 dBm 0 dBm (< 100 mA Tx current)On-board antenna Yes NoAccurate sleep timer Yes (32 kHz) No (+/- 10% error)GPIO pins available 10, GPIO4 – 13 (GPIO1 – 3 are not available for use) 14, GPIO1 – 14


http://http://www.rovingnetworks.com

RN-WIFLYCR-UG

- 8 analog inputs (14 bits, 1.2 V)- Real-time clock for wakeup and time stamping/data logging; auto-sleep and

auto-wakeup modes• Network support:

- Supports Soft Access Point (AP), ad hoc, and infrastructure networking modes

- Push-button WPS mode for easy network configuration- On-board TCP/IP stack- Over the air firmware upgrade (FTP)- Secure Wi-Fi authentication via WEP, WPA-PSK (TKIP), and WPA2-PSK

(AES)- Configuration over UART or wireless interfaces using simple ASCII com-

mands- Built in networking applications: DHCP client, DNS client, ARP, ICMP ping,

FTP client, TELNET, HTTP, UDP, and TCP

1.2 CONFIGURATION

The WiFly module has two modes of operation: data mode and command mode. In data mode, the module can accept incoming connections or initiate outgoing connec-tions. To configure parameters and/or view the current configuration, you must put the module into command mode (also called configuration mode).

1.2.1 Entering Command Mode By default, the module is in data mode after power up. Sending the escape sequence $$$ causes the module to enter command mode. You must send $$$ together quickly with no additional characters before or after. You must not send a carriage return (<cr>) or line feed after the $$$ to enter command mode. The module replies with CMD to indi-cate it is in command mode. Once in command mode, you can configure the WiFly device using simple ASCII commands; each command ends with a carriage return <cr>. Most valid commands return AOK; invalid ones return an ERR description. To exit command mode, send exit <cr>. The module responds with EXIT, indicating that it has exited command mode and entered data mode.

You can view various parameters, such as the SSID, channel, IP address, serial port, and other settings, and configure them in command mode. You send commands to the module through the UART or via remotely via telnet. When using the UART interface, the communications settings should match the WiFly module’s stored settings. The

Note: There is a 250-ms time buffer before and after the $$$ escape sequence. If characters are sent before or after the escape sequence within this 250-ms interval, the WiFly module treats them as data and passes them over the TCP or UDP socket, and the module will not enter command mode.


http://rovingnetworks.com/Support_Overview



RN-WIFLYCR-UG

default is 9,600 baud, 8 bits, no parity, 1 stop bit, and hardware flow control disabled. You can enter command mode locally over the UART interface at any time irrespective of an active TCP connection.

When the WiFly module powers up, it attempts to auto-associate with the access point stored in its configuration settings if the auto join feature is enabled. In firmware version 4.0 and higher, the auto join feature is disabled by default. Enable it using the ASCII command set wlan join 1. You can disable the auto-associate feature (default behavior) using the set wlan join 0 command. This command prevents the WiFly module from attempting to associate with a network that does not exist.

1.2.2 Remote Configuration Using Ad Hoc Mode

Using ad hoc mode to configure the device eliminates the need for the module to be associated with a network access point. In ad hoc mode, the module creates it’s own “on demand” network to which you can connect via your computer as you would with any other network.To enable ad hoc mode using hardware, set GPIO9 high (3.3 V) at power up. For the RN134 board, GPIO9 is on pin 1 on the jumper block (J2). For the RN174 board, GPIO9 is on the J6 connector. Upon power up with GPIO9 high, the WiFly module cre-ates an ad hoc network with the following settings:SSID: WiFly-GSX-XX, where XX is the final two bytes of the devices MAC

addressChannel: 1DHCP: OffIP address: 169.254.1.1Netmask: 255.255.0.0With the ad hoc jumper in place, these settings override any saved configuration set-tings. From your computer, connect to the WiFly-GSX-XX network. This open network does not require a pass phrase or pass key. Currently the WiFly module only supports OPEN mode for creating ad hoc networks.

Note: Roving Networks suggests using either the TeraTerm (Windows OS) or CoolTerm (Mac OS-X) terminal emulator program.

NOTICE

Firmware version 4.0 and higher does not support ad hoc mode (these versions sup-port soft AP mode). If ad hoc mode is required, use firmware version 2.38.3.


http://www.rovingnetworks.com/Support_Overview



RN-WIFLYCR-UG

It may take a few minutes for Windows to assign an IP address and connect to the net-work. You can check your computer’s IP address by running the ipconfig command in the Command Window. If connected, this command displays your computer’s IP address and netmask.

Once connected with an appropriate IP address, telnet into the WiFly module on port 2000 using the following command:telnet 169.254.1.1 2000The module issues the response *HELLO*. You can now enter command mode using the escape sequence $$$ and configure the module.In firmware versions 2.28 and higher, you can disable remote configuration, e.g., for security. To disable remote configuration, use bit 4 in the TCP mode register by issuing the command:

set ip tcp-mode 0x10

Note: The automatically assigned IP address must be on the 169.254.x.y subnet, otherwise the WiFly module will not be accessible. If your computer has both wireless and wired interface hardware, you may need to disable the wired LAN interface hardware before connecting to the ad hoc network. If the wired LAN is enabled, the computer may assign an IP address that is not on the same subnet as the WiFly module.


RN-WIFLYCR-UG

Chapter 2. Command ReferenceRoving Networks WiFly modules support a variety of commands for configuration. This section describes these commands in detail and provides examples.

2.1 COMMAND SYNTAX

To issue commands to the module, you send a keyword followed by optional parame-ters. Commands are case sensitive, and you cannot use spaces in parameters. Use a $ to indicate a space, e.g., MY NETWORK should be written as MY$NETWORK. Hex input data can be uppercase or lowercase. String text data, such as the SSID, is case sensitive. You can use shorthand for the parameters. For example, the following commands are equivalent:• set uart baudrate 115200• set uart b 115200• set u b 15200

You can type numbers in decimal (e.g., 115200) or hexadecimal. To enter a number in hex, use 0x<value>. For example, the hex value FF would be entered as 0xFF.

2.2 COMMAND ORGANIZATION

There are five general command categories, as shown in Table 2-1.

When the system boots, all configuration data is loaded into RAM variables from the configuration file. The set commands only modify the RAM copy of the system vari-ables. In general, the IP, WLAN, and UART settings require you to save and reboot before they take effect because they operate upon power up. For example, you only associate, set the channel, and obtain an IP address once at power up. Most of the other commands, e.g., COMM settings and timers, take effect immediately, allowing you to change parameters on the fly, minimizing power usage, and saving flash re-write cycles.

Note: You cannot use shorthand for command keywords. For example, s uart baudrate 115200 is illegal.

TABLE 2-1: COMMAND TYPESCommand Type Description

Set commands Set commands take effect immediately and are stored to memory when the save command is issued.

Get commands These commands retrieve the stored information and display it.Status commands These commands display the interface status, IP status, etc.Action commands Use these commands to perform actions such as scanning, connecting, disconnecting, etc.File I/O commands Use these commands to upgrade, load and save configuration, delete files, etc.

Note: You must save any changes you make using the save command or the module will load the previous settings upon reboot or power up.


RN-WIFLYCR-UG

Once configuration is complete, you must save the settings to store the configuration data, otherwise it will not take effect upon reboot or reset. You can store multiple con-figurations using the save <filename> command, and you can load them using the load <filename> command.

2.3 SET COMMANDS

These commands begin with the set keyword and include the categories shown in Table 2-2.

2.3.1 set adhoc beacon <value>This command sets the ad hoc beacon interval in milliseconds, where <value> is a dec-imal number from 0 to 65,436.

Default: 102Example: set adhoc beacon 120 // Beacons are sent every 120 ms

2.3.2 set adhoc probe <value>This command sets the ad hoc probe timeout in seconds, where <value> is the number of seconds. The probe timeout is the number of seconds the module waits for probe responses before declaring, “ADHOC is lost,” and disabling the network interface.

Default: 5Example: set adhoc probe 80 // Sets the ad hoc probe timeout to 80 s

TABLE 2-2: SET COMMANDSParameter Description

adhoc Controls the ad hoc parameters.broadcast Controls the broadcast hello/heartbeat UDP message.comm Sets the communication and data transfer, timers, and matching charac-

ters.dns Sets the DNS host and domain.ftp Sets the FTP host address and login information.ip Specifies the IP settings.option Supports optional and infrequently used parameters.sys Sets system settings such as sleep and wake timers.time Sets the timer server settings.uart Specifies the serial port settings such as baud rate and parity.wlan Sets the wireless interface settings, such as SSID, channel, and security

options.

Note: This command applies only to firmware versions supporting adhoc net-working mode. WiFly firmware versions 4.0 and higher do not support adhoc networking mode.

Note: This command applies only to firmware versions supporting adhoc net-working mode. WiFly firmware versions 4.0 and higher do not support adhoc networking mode.


RN-WIFLYCR-UG

2.3.3 set adhoc reboot <value>This command sets the reboot timer to reboot the module periodically every <value> seconds.

Default: 0Example: set adhoc reboot 600 // Sets the reboot timer to 600 seconds

2.3.4 set broadcast address <address>This command sets the primary address to which the UDP hello/heartbeat message is sent, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255.Default: 255.255.255.255Example: set broadcast address 192.168.1.50

// Sets the broadcast address to // 192.168.1.50

2.3.5 set broadcast backup <address>This command sets the secondary address to which the UDP hello/heartbeat message is sent, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255.The secondary broadcast is also a UDP packet sent after the primary broadcast and is of 120 bytes. The secondary broadcast contains the primary broadcast (110 bytes) plus the module’s MAC address (6 bytes) and IP address (4 bytes), for a total of 120 bytes.Default: 0.0.0.0Example: set broadcast backup 192.168.1.5

// Sets the broadcast address to // 192.168.1.5

2.3.6 set broadcast interval <mask>This command sets the interval at which the hello/heartbeat UDP message is sent and is specified in seconds. The value is a mask that is ANDed with a free running seconds counter; if the result is all 0s, a packet is sent. For example:• If the interval is 0x1, the module sends one packet every 2 seconds. • If the interval is 0x2. The module sends two packets every 4 seconds.• If the interval is 0x3, the module sends one packet every 4 seconds. • If the interval is 0x6, the module sends two packets every 8 seconds.• If the interval is 0x7, the module sends one packet every 8 seconds.

Note 1: <value> must be greater than 60 secs. To enable the automatic reboot feature, the reboot timer must be used in conjunction with the debug reg-ister (set system debug 0x80).

2: This command applies only to firmware versions supporting adhoc net-working mode. WiFly firmware versions 4.0 and higher do not support adhoc networking mode.


RN-WIFLYCR-UG

The minimum interval value is 1 (every 2 seconds) and the maximum value is 0xff (every 256 seconds). Setting the interval value to zero disables UDP broadcast mes-sages.Default: 7Example: set broadcast interval 6 // Sets the heartbeat UDP message

// interval to 6 seconds

2.3.7 set broadcast port <value>This commands sets the port to which the UDP hello/heartbeat message is sent, where <value> represents the port number.Default: 55555Example: set broadcast port 55555 // Sets the port to which the UDP heart

// beat is sent to 55555

2.3.8 set broadcast remote <value>This commands sets the port to which the backup UDP hello/heartbeat message is sent, where <value> represents the port number.Default: 0Example: set broadcast port 4444 // Sets the port to 44444

2.3.9 set comm $ <char>This command sets character used to enter command mode to <char>. You typically use this setting when $$$ (the default string used to enter command mode) is a possi-ble data string. You must carefully note the new character. After you save this setting, upon every subsequent reboot the module ignores $$$ and looks for <char><char><char> to enter command mode.Default: $Example: set comm $ w // Sets the string to enter command mode

// to www

2.3.10 set comm close <string>This command sets the ASCII string that is sent to the local UART when the TCP port is closed, where <string> is one or more characters up to a maximum of 32 (32 bytes). If you do not wish to use a string, use a zero (0) as the <string> parameter.Default: *CLOS*Example: set comm close *port closed* // Set the string to *port closed*

2.3.11 set comm open <string>This command sets the ASCII string that is sent to the local UART when the TCP port is opened, where <string> is one or more characters up to a maximum of 32 (32 bytes). If you do not wish to use a string, use a zero (0) as the <string> parameter.Default: *OPEN*Example: set comm open *port open* // Set the string to *port open*


RN-WIFLYCR-UG

2.3.12 set comm remote <string>This command sets the ASCII string that is sent to the remote TCP client when the TCP port is opened, where <string> is one or more characters up to a maximum of 32 (32 bytes). If you do not wish to use a string, use a zero (0) as the <string> parameter.Default: *HELLO*Example: set comm remote *welcome* // Set the string to *welcome*

2.3.13 set comm idle <value>This command sets the idle timer value, where <value> is a decimal number represent-ing the number of seconds. The idle timer value is the number of seconds during which no data is transmitted or received over TCP before the connection is closed automati-cally. Setting the timer to 0 (the default) means the module never disconnects when idle.Default: 0Example: set comm idle 25 // Set the idle timer value to 25 s

2.3.14 set comm match <value> | <hex>This command sets the match character, where <value> is a decimal number from 0 to 127 or a hex number from 0 to 7F. When this configuration option is set, the module sends an IP packet each time the match character appears in the data. You enter <value> either as the decimal (e.g., 13) or hex (e.g., 0xd) equivalent of the of the ASCII character. Setting the match character to 0 disables matching.A match character is one of three available methods you can use to control TCP/IP packet forwarding. The other methods are set comm size and set comm time. For more information refer to ““UART Receiver & RTS/CTS Hardware Flow Control” on page 60.Default: 0Example: set comm match 1 // Set the match character to a carriage

// return

2.3.15 set comm size <value> This commands sets the flush size in bytes, where <value> is a decimal number from 0 to 1,420 (at 9600 baud). When this configuration option is set, the module sends an IP packet each time <value> bytes are received. Roving Networks recommends that you set this value as large as possible to maximize TCP/IP performance.Flush size is one of three available methods you use to control TCP/IP packet forward-ing. The other methods are set comm match and set comm time. For more informa-tion refer to “UART Receiver & RTS/CTS Hardware Flow Control” on page 60.Default: 1420Example: set comm size 1420 // Set the flush size to 1,420 bytes

2.3.16 set comm time <value>This command sets the flush timer, where <value> is a decimal number representing milliseconds. When this configuration option is set, the module sends an IP packet if no additional bytes are received for <value> ms. Setting this value to 0 disables forwarding based on the flush timer.


RN-WIFLYCR-UG

The flush timer is one of three available methods you can use to control TCP/IP packet forwarding. The others are set comm match and set comm size. For more informa-tion refer to “UART Receiver & RTS/CTS Hardware Flow Control” on page 60.Default: 5Example: set comm time 20 // Set the flush timer to 20 ms

2.3.17 set dhcp lease <value>This command sets the soft AP mode DHCP lease time to <value>, where <value> is the number of seconds. The module uses this value when offering the DHCP lease to each client associating with the module in soft AP mode.Default: 86400Example: set dhcp lease 2000 // Sets the DHCP lease to 2,000 seconds

2.3.18 set dns address <address>This command sets the IP address of the DNS sever, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. This address is automatically set when using DHCP; you must set the DNS IP address for static IP or automatic IP modes.Default: 0.0.0.0Example: set dns address 169.64.1.1 // Set the DNS server address to

// 169.64.1.1

2.3.19 set dns name <string>This command sets the name of the host for TCP/IP connections to <string>, where <string> is up to 32 characters (32 bytes).Default: server1Example: set dns name roving1 // Set the DNS host name to roving1

2.3.20 set dns backup <string>This command sets the name of the backup host for TCP/IP connections to <string>, where <string> is up to 32 characters (32 bytes). The FTP client uses the backup string to download the firmware via the ftp update command.Default: rn.microchip.com Example: set dns backup roving2 // Set the DNS host name to roving2

2.3.21 set ftp addr <address>This command sets the FTP server’s IP address of the FTP server, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. Default: 0.0.0.0 Example: set ftp addr 66.35.227.3 // Set the FTP server to 66.35.227.3


RN-WIFLYCR-UG

2.3.22 set ftp dir <string>This command sets the starting directory on the FTP server, where <string> is up to 32 characters. To read/write to subfolders, use the \ character. To indicate the root direc-tory, use a period.Default: publicExample: set ftp dir demo // Set FTP server starting directory to

// demoset ftp dir demo\test // Set FTP server starting directory to

// demo\testset ftp dir . // Set FTP server starting directory to the

// root directory

2.3.23 set ftp filename <filename> This command sets the name of the file that is transferred when issuing the ftp u com-mand, where <filename> is the firmware image. If you specify any file other than the firmware image, the WiFly module downloads the file and issues the UPDATE FAIL=3 error.Default: Firmware version 4.0 and higher:

wifly3-<version>.img (RN131), wifly7-<version>.img (RN171)Firmware lower than version 4.0:wifly-GSX-<version>.img (RN131), wifly-EZX-<version>.img (RN171)

Example: set ftp filename my_data // Sets the firmware image to be retrieved // via FTP as my_data

2.3.24 set ftp mode <mask>This command sets the ftp mode, where <mask> indicates active or passive mode. Default: 0x0Example: set ftp mode 0x1 // Enables active FTP mode

2.3.25 set ftp remote <value> This command sets the FTP server’s remote port number, where <value> is the port number.Default: 21Example: set ftp remote 25 // Sets the FTP server’s remote port to 25

2.3.26 set ftp time <value>The command sets the FTP timeout value, where <value> is a decimal number that is five times the number of seconds required. The module uses this timer to close the FTP connection automatically after the specified time. Default: 200 Example: set ftp timer 40 // Sets a 5-second timer

set ftp timer 80 // Sets a 10-second timer


RN-WIFLYCR-UG

2.3.27 set ftp user <string> This command sets the user name for accessing the FTP server, where <string> is up to 16 characters (16 bytes). Default: rovingExample: set ftp user my_username // Sets the user name to my_username

2.3.28 set ftp pass <string> This command sets the password for accessing the FTP server, where <string> is up to 16 characters (16 bytes). Default: Pass123Example: set ftp user my_password // Sets the user name to my_password

2.3.29 set ip address <address>This command sets the WiFly module’s IP address, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. If DHCP is turned on, the IP address is assigned and overwritten when the module associates with an access point. IP addresses are “.” delimited. Default: 0.0.0.0Example: set ip a 10.20.20.1 // Sets the WiFly module’s IP address to

// 10.20.20.1

2.3.30 set ip backup <address>This command sets a secondary host IP address, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. If the primary host IP is unreachable, the module attempts to reach the sec-ondary IP address (if set).Default: 0.0.0.0Example: set ip a 10.20.20.2 // Sets the WiFly module’s secondary IP

// address to 10.20.20.2

2.3.31 set ip dhcp <value>This command enables/disables DHCP mode, where <value> is a decimal number shown in Table 2-3. If you set this parameter, the module requests and sets the IP address, gateway, netmask, and DNS server upon association with an access point. Any previously set IP information is overwritten.TABLE 2-3: DHCP MODESMode Protocol

0 Turns DHCP off. The module uses its stored static IP address.1 Turns DHCP on. The module attempts to obtain an IP address and gateway from the

access point.2 Enables automatic IP, which is generally used with ad hoc networks.3 Turns on DHCP cache mode. The module uses a previously set IP address if the

lease is not expired (or the lease survives reboot).4 Enables DHCP server in soft AP mode.


RN-WIFLYCR-UG

Using DHCP cache mode can reduce the time the module requires to wake from deep sleep, which saves power. The module checks the lease time; if it is not expired, the module uses the previous IP settings. If the lease has expired, the module attempts to associate and uses DHCP to obtain the IP settings. The DHCP cached IP address does not survive a power cycle or reset.Default: 1Example: set ip dhcp 0 // Turns DHCP off

2.3.32 set ip flags <mask>This commands sets the TCP/IP functions, where <mask> is a hex number referring to a bit-mapped register. See Figure 2-1.

FIGURE 2-1: SET IP FLAGS COMMAND BIT-MAPPED REGISTER

Note 1: If the module loses the link to an associated access point while a TCP con-nection is active, the TCP connection may hang or be in an inconsistent state. In some cases, the TCP connection will not recover. In firmware ver-sion 2.20 and higher, if the module regains the link to the access point within 60 seconds, the TCP connection will survive.

2: In firmware prior to version 2.20, bit 0 specified the TCP copy function.If bit 0 is set (the default), TCP connections are kept open when the connection to the access point is lost.If bit 0 is cleared (e.g., by sending set ip flags 0x6), if the module loses the access point connection while TCP is connected, the connection is closed.Default: 0x7Example: set ip flags 0x6 // Clear bit 0

2.3.33 set ip gateway <address>This command sets the gateway IP address, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. If DHCP is turned on, the gateway IP address is assigned and overwritten when the module associates with the access point.Default: 0.0.0.0Example: set ip gateway 169.254.1.1 // Sets the IP gateway to 169.254.1.1

1234567 0TCP connection status. See Notes (1), (2).

Bypass Nagle algorithm and use TCP_NODELAY.

TCP retry enabled (for a total of 96 packet retries).

UDP RETRY (attempts retry if no ACK from UDP).

DNS host address caching enabled.

ARP table caching enabled.

UDP auto pairing enabled.

Add 8-byte timestamp to UDP or TCP packets.


RN-WIFLYCR-UG

2.3.34 set ip host <address>This command sets the remote host’s IP address, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. You use this command to make connections from the WiFly module to a TCP/IP server with the IP address <address>. Default: 0.0.0.0Example: set ip host 137.57.1.1 // Sets the remote host’s IP address to

// 137.57.1.1

2.3.35 set ip localport <value>This command sets the local port number, where <value> is a decimal number repre-senting the port.Default: 2000Example: set ip localport 1025 // Sets the local port to 1025

2.3.36 set ip netmask <address>This command sets the network mask, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. If DHCP is turned on, the netmask is assigned and overwritten when the module associ-ates with the access point.Default: 255.255.255.0Example: set ip netmask 255.255.0.0 // Sets the netmask to 255.255.0.0

2.3.37 set ip protocol <flag>This command sets the IP protocol, where <flag> is a bit-mapped register as shown in Figure 2-2. To be able to connect to the WiFly module over TCP/IP (for example using telnet), you must set bit 2 of the IP protocol register. For the module to accept both TCP and UDP set bits 1 and 2 (value = 3).

FIGURE 2-2: SET IP PROTOCOL COMMAND BIT-MAPPED REGISTER

Default: 2Example: set ip protocol 18 // enables TCP and HTTP client mode

2.3.38 set ip remote <value>This command sets the remote host port number, where <value> is a decimal number representing the port.Default: 2000Example: set ip remote 1025 // Sets the remote host port to 1025

1234 0UDP.

TCP server and client (default).

Secure mode (only receive packets form an IP address that matches the stored host IP).

TCP client only.

HTTP client mode.


RN-WIFLYCR-UG

2.3.39 set ip tcp-mode <mask>This command controls the TCP connect timers, DNS preferences, and remote config-uration options. <mask> is a hex number referring to a bit-mapped register as shown in Figure 2-3.

FIGURE 2-3: SET IP TCP-MODE COMMAND BIT-MAPPED REGISTER

Default: 0x0Example: set ip tcp-mode 0x4 // Forces the module to use DNS

set ip tcp-mode 0x10 // Disables remote configuration

2.3.40 set opt jointmr <value>This command sets the join timer, which is the length of time (in ms) the join function waits for the access point to complete the association process. <value> is a decimal number representing the number of ms. This timer is also used as the timeout for the WPA handshaking process. Default: 1000Example set opt jointmr 1050 // Sets the join timer to 1,050 ms

2.3.41 set opt format <flag>The command sets the HTTP client/web server information, where <flag> is a bit-mapped register as shown in Figure 2-4. See “Using the HTML Client Feature” on page 77 for more details.

FIGURE 2-4: SET OPT FORMAT COMMAND BIT-MAPPED REGISTER

Default: 0x00Example: set opt format 0x7 // Module sends sensor values

Note: The TCPMODE register is available in firmware version 2.27 and higher.

1234 0Shorten the TCP connect timer (use with bit 1).

Shorten the TCP connect timer (use with bit 0).

Forces the module to use DNS first to resolve the IP address, even if the host IP is set.

Reserved.

Disables remote configuration for security purposes.

1234 0Automatically send an HTML header-based broadcast interval.

Send users binary data (converted to ASCII hex).

Sample the GPIO and ADC pins and format to ASCII hex.

Appends &id=<value>, where <value> is the device ID string that was set using set opt device <string>.

Appends the following key/value pairs to the HTTP message: &rtc=<time>, &mac=<address>, &bss=<access point address>, &bat=<battery voltage>, &io=<GPIO in hex>, &wake=<wake reason>, &seq=<sequence value>, where <time> is the realtime clock value in the message as a 32-bit hex value in format aabbccddeeff and <sequence value> is a rolling counter of how many web posts have been sent.


RN-WIFLYCR-UG

2.3.42 set opt replace <value>This command sets the replacement character used to indicate spaces in the SSID and pass phrases string, where <value> is the ASCII value of the character. Each occur-rence of the replacement character is changed into a space. Only the WiFly command parser uses this replacement character. For example, to change the replace character to %, use the set opt replace 0x25 com-mand (the ASCII value of % is 0x25).Default: 0x24Example: set opt replace 0x25 // Sets the replacement character to %

2.3.43 set opt deviceid <string>This command sets the configurable device ID, where <string> is up to 32 bytes long. You can use <string> for serial numbers, a product name, or to show other device infor-mation. The module sends the device ID as part of the UDP broadcast hello packet. You can view the device ID’s current value with the get option or show deviceid com-mands.Default: WiFly-GSXExample: set opt deviceid my_wifly // Sets the device ID to my_wifly

2.3.44 set opt password <string>This command sets the TCP connection password, where <string> is up to 32 bytes long. This setting provides minimal authentication by requiring any remote device that connects to the module to send and match the challenge <string>. When a connection is opened, the module sends the string PASS? to the remote host. The remote host must reply with the exact characters that match the stored password in one TCP packet; otherwise, the module closes the connection. To disable the password feature, use 0 (the default).Default: “” (no password required)Example: set opt password my_password

// Sets the TCP connection password to // my_password

2.3.45 set opt average <value>This command sets the number of RSSI samples used to calculate the running RSSI average for the set opt signal command.Default: 5Example: set opt average 10 // Sets the average to 10 RSSI readings

2.3.46 set opt signal <value>This command allows you to configure the threshold level for the RSSI value in infra-structure mode. If the signal strength (RSSI) falls below <value> dB, the module declares AP is lost and deauthenticates itself from the network. Thereafter, the module associates with the network based on the join policy.This command is useful for applications in which the Wi-Fi module is in a mobile envi-ronment and frequently enters and leaves the AP’s range.


RN-WIFLYCR-UG

The recommended range for <value> is between 50 and 80. As <value> is lowered, the module more frequently deauthenticates itself from the AP.

Default: 0Example: set opt signal 70 // Sets the RSSI threshold to -70 dBm. If

// the RSSI average falls below -70 dBm, // the module deauthenticates itself.

2.3.47 set q sensor <mask>This command specifies which sensor pins to sample when sending data using the UDP broadcast packet or the HTTP auto sample function, where <mask> is a bit-mapped register.

Default: 0Example: set q sensor 0xff // Enables all sensor inputs

2.3.48 set q power <value>This register automatically turns on the sensor power, where <value> is shown in Table 2-4. This parameter sets an 8-bit register with two 4-bit nibbles. If the top nibble is set, power is applied upon power up and removed upon power down or sleep. If the bottom nibble is set, power is applied when a sampling event occurs such as:• UDP broadcast• Automatic web posting of sensor data• Power is removed immediately after sampling is complete

Default: 0 Example: set q power 0x20 // Sets power to 1.2 V automatically

// upon power upset q power 0x02 // Sets power to 1.2 V when a

// sampling event occurs set q power 0x40 // Sets power to 3.3 V automatically

// upon power up

Note: This command applies in infrastructure mode only. It is not applicable in soft AP mode.

You must enable the link monitor for this feature to work.

Note: In versions of firmware prior to 2.23, this command is named set option sensor.

TABLE 2-4: SET Q POWER COMMAND SENSOR PIN VOLTAGE SETTINGSValue Sensor Pin Voltage

0 Turn off the sensor power.1 Ground the sensor pin.2 1.2-V internal regulated reference.3 VBATT input pin.4 3.3-V output of on board regulator.


RN-WIFLYCR-UG

set q power 0x04 // Sets power to 3.3 V when a // sampling event occurs

2.3.49 set sys autoconn <value>This command sets the auto-connect timer in TCP mode, where <value> is a decimal number from 0 to 255 as shown in Table 2-5. Setting this parameter causes the module to connect to the stored remote host periodically as specified by <value>.

Default: 0Example: set sys autoconn 5 // Module connects to host every 5 sec.

2.3.50 set sys iofunc <mask> This command sets the I/O port alternate functions, where <mask> is a hex number referring to a bit-mapped register. The I/O function <mask> is encoded as shown in Table 2-6.

For more details see “Setting the Alternate GPIO Functions with set sys iofunc” on page 62.Default: 0x0Example: set sys iofunc 0x7 // Disables the WiFly board LEDs

Note: To use the auto-connect timer, you must store the remote host’s IP address and port in the WiFly module using the set ip host <address> and set ip remote <value> commands.

TABLE 2-5: AUTO-CONNECT TIMER SETTINGSValue Description

0 Disable the auto-connect timer (default).1 Connect to the stored remote host IMMEDIATELY upon power up or when waking

from sleep.2 - 254 Connect to a stored remote host every <value> seconds.

255 Connect to a stored host IMMEDIATELY upon power up or when waking from sleep and go back to sleep IMMEDIATELY as soon as the TCP connection closes.

TABLE 2-6: GPIO PIN ALTERNATE FUNCTION BITMASKBit Signal Name Direction Function

0 GPIO4 Output Disable the LED function so the I/O can be used as a GPIO pin.1 GPIO5 Output Disable the LED function so the I/O can be used as a GPIO pin.2 GPIO6 Output Disable the LED function so the I/O can be used as a GPIO pin.3 Unused - -4 GPIO4 Output This pin goes high after the module has associated/authenticated and has an IP

address.5 GPIO5 Input Set this pin high to trigger a TCP connection and low to disconnect.6 GPIO6 Output This pin goes high when the module is connected over TCP and low when discon-

nected.

Note: Bits 0 - 3 are mutually exclusive with bits 4 – 6, i.e., 0x77 is an illegal value.


RN-WIFLYCR-UG

set sys launch_string <string>This command sets the name of the application (indicated by <string>) that is launched when GPIO9 toggles from high to low after power up (e.g., by pressing the FN button on evaluation kits). You use this mechanism to invoke valid applications as shown in Table 2-7.

Setting the <string> to an invalid string such as test results in the following error mes-sage when GPIO9 is toggled:*test not Found*

Default: web_appExample: set sys launch_string wps_app // Sets the launch application to WPS

2.3.51 set sys mask <mask> This command sets the I/O port direction, where <mask> is a hex number referring to a bit-mapped register. Figure 2-5 shows the bits corresponding to the GPIO pins and Table 2-8 shows the GPIO pin usage, their default state, and functionality.

FIGURE 2-5: GPIO PIN BITMASK

TABLE 2-7: VALID APPLICATION STRINGS<string> Description

web_app Launches the configuration web server.wps_app Launches the WPS application.

Note: Do not set <string> to the configuration filename or the boot firmware image. Otherwise, the module configuration may become corrupted and the module will reboot.

Note: Disable this error message by setting the print level to zero using the set sys print 0 command.

14 13 12 11 10 9 8 7 6 5 4 3 2 1 0GPIO0

GPIO1

GPIO2

GPIO3

GPIO4

GPIO5

GPIO6

GPIO7

GPIO14

GPIO13 UART RTS

GPIO12 UART CTS

GPIO11 UART RX

GPIO10 UART TX

GPIO9

GPIO8


RN-WIFLYCR-UG

For more details see “Setting GPIO Direction, Alternate Functions & Disabling LEDs” on page 60.

Default: 0x20F0 (for RN131) 0x21F0 (for RN171)

Example: set sys mask 0x0 // Sets all pins as inputs

TABLE 2-8: GPIO PIN USAGE, DEFAULT STATE & FUNCTIONALITY

Bit Signal Name

RN-131 Default State

RN-171 Default State Default Function

0 GPIO0 N/A N/A -1 GPIO1 N/A Input Unused.2 GPIO2 N/A Input Unused.3 GPIO3 N/A Input Unused.4 GPIO4 Output Output Green LED.5 GPIO5 Output Output Yellow LED.6 GPIO6 Output Output Red LED.7 GPIO7 Output Output Blue LED.8 GPIO8 Input Output Unused.9 GPIO9 Input Input Ad hoc mode and factory reset.10 GPIO10 Output Output UART TX.11 GPIO11 Input Input UART RX.12 GPIO12 Input Input Throttles the transmitter if hardware flow control is enabled.

Driving this pin low enables transmitter; driving this pin high dis-ables it.

13 GPIO13 Output Output This pin goes high on power up and goes low when the system is ready. If hardware flow control is enabled, this pin toggles to high to indicate the RX buffer is full.

14 GPIO14 N/A Input -

Note: On the Wi-Fi serial adapter (RN-370) and the RN-174 evaluation board, the blue LED is connected to GPIO7. The blue LED is NOT connected to GPIO7 on the RN-134 board. It is not possible to power off the blue LED on the RN-134 board because it is connected directly to power.

Note: To set the GPIO pins as inputs or outputs instantly, use the set sys mask 0xABCD 1 command, which does not require a reboot.


RN-WIFLYCR-UG

2.3.52 set sys printlvl <value>This command controls the debug print messages printed by the WiFly module on the UART, where <value> is one of the values shown in Table 2-9. Refer to “Setting Debug Print Levels” on page 64 for more information.

Default: 0x1Example: set sys printlvl 2 // Sets the debug print messages to only

// critical network connection status

2.3.53 set sys output <mask> <mask> This command sets the output GPIO pins high or low, where <mask> is a hex number referring to a bit-mapped register. The optional <mask> sets a subset of the pins.Default: NoneExample: To toggle GPIO8, use the following commands:

set sys mask 0x21f0 // Set GPIO8 as outputset sys output 0x0100 0x0100 // Drives GPIO8 highset sys output 0x0000 0x0100 // Drives GPIO8 low

2.3.54 set sys sleep <value>This command sets the sleep timer, where <value> is a decimal number. The sleep timer is the time (in seconds) after which the module goes to sleep. This timer is dis-abled during an open TCP connection. When the TCP connection is closed, the module counts down and puts the module to sleep after <value> seconds. Setting the value to 0 disables the sleep timer, and the module will not go to sleep based on this counter.

See “System & Auto-Connect Timers” on page 57 for more details on using system tim-ers. Default: 0Example: set sys sleep 5 // Module sleeps 5 s after TCP

// connection closes

TABLE 2-9: DEBUG PRINT MESSAGE SETTINGSValue Description

0 Quiet mode. Messages are not printed when the module wakes up or powers up. 1 Print all status messages.2 Print only critical network access point connection level status, e.g., Associated! or Disconnect from

<SSID>.4 Print the DHCP and IP address status information. After you have verified the module’s configuration,

you can turn off this option so that the messages do not interfere with the data.0x4000 Change the scan format output to an MCU friendly format.0x10 Enables the UART heartbeat message. See “UART Heartbeat Messages” on page 67 for more details.

Note: Be sure to set the wake timer before issuing the sleep timer if you are not using an external wake up signal; otherwise, the module will never wake up.


RN-WIFLYCR-UG

2.3.55 set sys trigger <flag> or <mask>With this parameter setting, the module wakes from sleep state using the sensor input 0, 1, 2, and 3, where <flag> is a decimal number referring to a bit-mapped register as shown in Table 2-10 and <mask> is a hex number. You use either <flag> or <mask> with this parameter setting. This command sets the sensor input(s) to wake on (0 to 3). Setting <flag> to 0 disables wake on sensor inputs.

Table 2-11 describes how you can wake the module using sensor input.

Setting the trigger value to 0x20 (i.e., using <mask>) puts the module to sleep when GPIO8 is pulled high. To enable this feature, use the set sys trigger 0x20 command. This command makes GPIO8 an interrupt pin and puts the module to sleep as soon as it is pulled high, regardless of the module’s state; the module goes to sleep even if it is associating with a network or has an open, active TCP connection.This command is useful for when the module is failing to associate with network because it is out of range (or for any other reason), or if the module must be put to sleep quickly.

Default: 0x41Example: set sys trigger 0x8 // Enable wake on sensor input 3

2.3.56 set sys value <mask>This command sets the default value of the GPIO pins’ outputs upon power-up, where <mask> is a hex number representing a bit-mapped register. The GPIO pins that are configured as outputs can be driven high or low on power-up or when the module wakes from sleep. The default power-up states can be set ONLY for the GPIO pins that are set as outputs. Setting the value to 1 makes the default power-up state high; setting the value to 0 makes the default power-up state low.

TABLE 2-10: SET SYS TRIGGER COMMAND BIT-MAPPED REGISTERBit Position Description

0 Trigger sensor input 0.1 Trigger sensor input 1.2 Trigger sensor input 2.3 Trigger sensor input 3.5 Enable sleep on GPIO8.

TABLE 2-11: SENSOR INPUT TRIGGER VALUESWake on Sensor Input Value Command

0 1 set sys trigger 11 2 set sys trigger 22 4 set sys trigger 43 8 set sys trigger 8

Note: GPIO8 must be low on power up and stay low until you want to put the mod-ule to sleep.


RN-WIFLYCR-UG

To configure GPIO pins as outputs, use the set sys mask <value> command.

Default: 0x0Example: To configure power-up states of GPIO8 (output by default):

set sys value 0x0100 // Sets GPIO8 high upon power-upset sys value 0x0000 // Sets GPIO8 low upon power-up

2.3.57 set sys wake <value>This command sets the automatic wake timer, where <value> is a decimal number rep-resenting the number of seconds after which the module wakes from sleep. Setting <value> to 0 disables. See “System & Auto-Connect Timers” on page 57 for more details. Default: 0Example: set sys wake 5 // The module wakes after 5 seconds

2.3.58 set time address <address>This command sets the time server address, where <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. This command applies to SNTP servers.Default: 64.90.182.55Example: set time address 208.109.78.52

// Sets the time server address as // 208.109.78.52

2.3.59 set time port <value>This command sets the time server port number, where <value> is a decimal number. 123, the default, is typically the SNTP server port.Default: 123Example: set time port 1052 // Sets the time server port to 1052

2.3.60 set time enable <value>This parameter tells the module how often to fetch the time from the specified SNTP time server, where <value> is a decimal number representing minutes. The default (0) disables time fetching. If <value> is 1, the module fetches the time only once on power up. If <value> is greater than 1, the modules fetches the time every <value> minutes.Default: 0Example: set time enable 5 // The module fetches the time every 5

// minutes

Note: GPIO pins 4, 5, and 6 are used by the firmware to blink the status LEDs. To set the default power up states for these GPIO pins, you must first disable their use by the firmware using the set sys iofunc 0x7 command.


RN-WIFLYCR-UG

2.3.61 set time raw <value>This parameter setting allows you to set the RTC raw value from the console, where <value> is a decimal number in seconds. The RTC ticks at 32,768 Hz.Default: None Example: set time raw 1 // Set to 1 second

2.3.62 set uart baud <value>This command sets the UART baud rate, where <value> is 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800.

Default: 9600Example: set uart baud 19200 // Sets the baud rate to 19,200 baud

2.3.63 set uart flow <value>This command sets the flow control mode and parity, where <value> is a hex number. The setting is in the upper nibble of the hardware flow control setting. The default is flow control disabled with parity set to none/no parity. Figure 2-6 shows the bit-mapped register.

FIGURE 2-6: SET UART FLOW BIT-MAPPED REGISTER

Default: 0Example: set uart flow 0x21 // Even parity with flow control

set uart flow 0x20 // Even parity without flowset uart flow 0x31 // Odd parity with flow controlset uart flow 0x30 // Odd parity without flow control

Note: The RN134 evaluation board’s RS-232 interface cannot exceed 230,400 baud.

Flow control:

0 = Disabled1 = EnabledParity:

00 = None01 = Illegal10 = Even11 = Odd

1234567 000 00 0

Note: Once flow control is enabled, it is important to drive the CTS pin properly (i.e., active-low enabled). If CTS is high, the module does NOT send data through the UART and further configuration in command mode is problem-atic because no response is received.


RN-WIFLYCR-UG

2.3.64 set uart instant <value> This command immediately changes the baud rate, where <value> is 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, or 921600. This command is useful when testing baud rate settings or when switching the baud rate “on the fly” while connected over TCP via telnet. Using this command does not affect configuration. The module returns the AOK response, and then the module exits command mode.

If used in local mode, the baud rate changes and the module sends AOK using the new baud rate. If the host switches to the new baud rate immediately, the host may see the AOK string at the new baud rate. Depending on the baud rate, it takes at least ten times the bit rate for the module to issue the first character.Default: Not applicableExample: set uart instant 19200 // Sets the baud rate to 19,200 baud

2.3.65 set uart mode <mask>This command sets the UART mode register, where <mask> is a hex number masking a bit-mapped value as shown in Figure 2-7.

FIGURE 2-7: SET UART MODE COMMAND BIT-MAPPED REGISTER

Default: 0Example: set uart mode 0x10 // Enable the UART data buffer

2.3.66 set uart raw <value> This command sets a raw UART value, where <value> is a decimal number represent-ing the baud rate. You use this command to set non-standard baud rates. The lowest possible baud rate is 2,400.

Note: In firmware version 2.22 and lower, the module does NOT return an AOK over telnet before exiting command mode.

Command echo:

0 = Enabled1 = Disabled

Data trigger:

0 = Disabled1 = Make TCP connection upon UART RX data

1234567 000 0

Sleep on RX break signal:

0 = Disabled1 = Enabled

UART RX data buffer:

0 = When TCP connection closes, buffer is flushed1 = When TCP connection closes, buffer holds data until: - If more data is received, buffer is flushed - If no data is received and a new connection is made, buffer is transmitted

Command prompt:

0 = Version string <x.xx>1 = Replacement character


RN-WIFLYCR-UG

Using non-standard raw baud rates with hardware flow control can be more useful at speeds as the microcontroller interfaced to the module may be able to better match the UART speed and get better results. Table 2-12 shows the supported raw baud rates:

Default: Not applicableExample: set uart raw 7200 // Sets the baud rate to 7,200 baud

2.3.67 set uart tx <value>This command disables or enables the UART’s TX pin (GPIO10), where <value> is 1 or 0. Disabling the pin (<value> = 0) sets GPIO10 as an input with a weak pull down.

Default: Not Applicable Example: set uart tx 1 // Enable the UART’s TX pin

2.3.68 set wlan auth <value> This command sets the authentication mode, where <value> is shown in Table 2-13. You only need to set this parameter if you are using automatic join mode 2, i.e., the set wlan join 2 command.

The firmware supports the following security modes:• WEP-64 and WEP-128 (open mode only, NOT shared mode)• WPA2-PSK (AES only) • WPA1-PSK (TKIP only) • WPA-PSK mixed mode (some access points, not all are supported)

TABLE 2-12: SUPPORTED RAW BAUD RATES Raw Baud Rate Comment

458,333 This is 460,800.500,000 Raw baud rate.550,000 Raw baud rate.611,111 Raw baud rate.687,599 Raw baud rate.785,714 Raw baud rate.916,667 This is 921,600.

1,100,000 Raw baud rate.

Note: Firmware version 2.36/2.45 and higher supports parity with the set uart flow command

Note: During association the module interrogates the access point and automat-ically selects the authentication mode.


RN-WIFLYCR-UG

Default: 0Example: set wlan auth 4 // Use WPA2-PSK authentication

2.3.69 set wlan channel <value> <flag>This command sets the WLAN channel, where <value> is a decimal number from 1 to 13 representing a fixed channel and <flag> is the optional character i (meaning imme-diate). If you set the channel to 0, the modules performs a scan using the SSID for all the channels set in the channel mask. The i flag allows you to create a temporary AP mode setup without having to reboot or save the settings. See Example 2.Default: 0Example 1:set wlan channel 2 // Set the WLAN channel to 2Example 2:set wlan channel 1 i

set wlan join 7set ip address 1.2.3.4set ip gateway 1.2.3.4set ip netmask 255.255.255.0set ip dhcp 4 // Use DHCP serverjoin <SSID> // Module goes into AP mode

2.3.70 set wlan ext_antenna <value>This commands determines which antenna is active, where <value> is 0 (use the chip antenna) or 1 (use the U.FL connector). Only one antenna is active at a time and the module must be power cycled after changing the antenna setting.

Default: 0Example: set wlan ext_antenna 1 // Use the U.FL antenna

TABLE 2-13: SET WLAN AUTH COMMAND AUTHENTICATION MODESValue Authentication Mode

0 Open (Default)1 WEP-1282 WPA13 Mixed WPA1 and WPA2-PSK4 WPA2-PSK5 Not used6 Ad hoc mode (join any ad hoc network)8 WPE-64

Note: This command applies only to the RN131 module; it is not applicable to the RN171. If you send this parameter to the RN171, it issues an error mes-sage ERR: Bad Args.


RN-WIFLYCR-UG

2.3.71 set wlan fmon <value>This parameter is used in soft AP mode to detect if the individual client devices are active and in range of the module.This command sets the soft AP mode link monitor timeout threshold for the associated client device, where <value> is a decimal number representing the number of seconds of client inactivity (i.e., no data received from the client device). When this timer expires, the module deauthenticates the inactive client.Setting this timer to a low value, e.g., 10 seconds, can result in client devices frequently deauthenticating if they do not send data before the timer expires.To disable the fmon timer, set <value> to zero (0).Default: 3600Example: set wlan fmon 1000 // Sets the fmon timer to 1,000 seconds

2.3.72 set wlan hide <value>This command hides the WEP key and WPA passphrase, where <value> is 0 or 1. If this parameter is set to 0, the pass phrase or passkey is displayed. If you set this parameter to 1, the module shows ****** for these fields when displaying the WLAN set-tings. To show the pass phrase or passkey, re-enter the key or pass phrase using the set wlan key or set wlan passphrase command. Default: 0Example: set wlan hide 1 // Hide the pass phrase or passkey

2.3.73 set wlan id <string>This command sets the EAP ID. This command is reserved for future development and is unused.

2.3.74 set wlan join <value>This command sets the policy for automatically associating with network access points, where <value> is one of the options shown in Table 2-14. The module uses this policy on powers up, including waking up from the sleep timer.

TABLE 2-14: SET WLAN JOIN COMMAND OPTIONSValue Policy

0 Manual. Do not try to associate with a network automatically.1 Try to associate with the access point that matches the stored SSID, passkey, and channel. If the channel is

set to 0, the module will scan for the access point. (Default)2 Associate with ANY access point that has security matching the stored authentication mode. The module

ignores the stored SSID and searches for the access point with the strongest signal. You can limit the chan-nels that are searched by setting the channel mask.

3 Reserved.4 Create an ad hoc network using stored SSID, IP address, and netmask. You MUST set the channel. Unless

another ad hoc device can act as DHCP server, set DHCP to 0 (static IP) or use automatic IP.

You can use this policy instead of the hardware jumper to create a custom ad hoc network.7 Create a soft AP network using stored the SSID, IP address, netmask, channel, etc. This mode applies only

to firmware versions supporting soft AP mode, not ad hoc mode.


RN-WIFLYCR-UG

Default: 0Example: set wlan join 4 // Create an ad hoc network

2.3.75 set wlan key <value> This command sets the WEP-64 or WEP-128 key, where <value> is EXACTLY 26 ASCII chars (13 bytes) in hex without the preceding 0x. Hex digits greater than 9 can be either upper or lower case. If you are using WPA or WPA2, enter a pass phrase with the set wlan passphrase command. The WEP key length depends on the WEP security used (WEP-64 or WEP-128):• WEP-64 uses a 10-character key • WEP-128 uses a 26-character keyDefault: 00 00 00 00 00Example: set wlan key 112233445566778899AABBCCDD

// Sets the WEP key

2.3.76 set wlan linkmon <value>This parameter is used in infrastructure mode to detect whether the module is associ-ated and in range of the access point.This command sets the infrastructure mode link monitor timeout threshold, where <value> is a decimal number representing the number of failed scans before the mod-ule declares Lost-AP and deauthenticates (e.g., when the module goes out of the access point’s range). If you set this parameter to 1 or more, the module scans once per second for the access point with which it is associated.If the module de-authenticates itself from the access point using the link monitor, it re-attempts the association based on the join policy setting. Roving Networks recommends setting the threshold to 30 attempts, because some access points do not always respond to probes. If you do not set this parameter, there is no way to detect that an access point is no longer present until it becomes available again (if ever).To disable the link monitor, set <value> to zero (0).Default: 30Example: set wlan linkmon 5 // Set the number of scan attempts to 5

2.3.77 set wlan mask <mask>This command sets the WLAN channel mask, which is used for scanning channels with auto-join policy 1 or 2, where <mask> is a hex number (bit 0 = channel 1). Reducing the number of channels scanned for association increases battery life. This setting is used when the channel is set to 0. Default: 0x1FFF (all channels)Example: set wlan mask 0x0421 // Scans for channels 1, 6, and 11


RN-WIFLYCR-UG

2.3.78 set wlan number <value> This command sets the WEP key number. The WEP key number must match the key number on the router or access point. You only need to set this parameter when using the WEP-64 or WEP-128 security modes. This setting is not required if you are using the WPA security mode.Default: 0Example: set wlan number 1 // Sets the WEP key number to 1

2.3.79 set wlan phrase <string>This command sets the passphrase for WPA and WPA2 security modes, where <string> is 1 to 64 characters (64 bytes). The passphrase is alphanumeric, and is used with the SSID to generate a unique 32-byte pre-shared key (PSK), which is then hashed into a 256-bit number. When you change either the SSID or the passphrase, the module re-calculates and stores the PSK.If you enter exactly 64 characters, the module assumes that the passphrase is an ASCII hex representation of the 32-byte PSK, and the value is simply stored.For passphrases that contain spaces, use the replacement character $ instead of spaces. For example my pass word becomes my$pass$word. You can change the replacement character using the set opt replace command.Default: rubygirlExample: set wlan phrase my_password // Sets the phrase to my_password

2.3.80 set wlan rate <value>This command sets the wireless data rate, where <value> is a value shown in Table 2-15. Lowering the data rate increases the effective range of the module.

Default: 12Example: set wlan rate 13 // Set the data rate to 36 Mbits/second

TABLE 2-15: SET WLAN RATE COMMAND OPTIONSValue Wireless Data Rate (Mbits/second)

0 11 22 5.53 11

4 - 7 Invalid8 69 9

10 1211 1812 24 (default)13 3614 4815 54


RN-WIFLYCR-UG

2.3.81 set wlan ssid <string>This command sets the SSID with which the module associates, where <string> is 1 to 32 characters (32 bytes).

Default: roving1Example: set wlan ssid my_network // Set the SSID to my_network

2.3.82 set wlan tx <value>This command sets the Wi-Fi transmit power, where <value> is a decimal number from 1 to 12 that corresponds to 1 to 12 dBm. The default, 0, corresponds to 12 dB, which is the maximum TX power. Setting the value to 0 or 12 sets the TX power to 12 dBm.

Default: 0Example: set wlan tx 11 // Set the TX power to 11 dBm

2.3.83 set wlan user <string>This command sets the EAP username. This command is reserved for future develop-ment and is unused.

2.4 GET COMMANDS

These commands begin with the keyword get and they display the module’s current values. Except where noted, the get commands do not have any parameters.

2.4.1 get adhocThis command displays the ad hoc settings.Example: get adhoc // Show ad hoc settings

2.4.2 get broadcast This command displays the broadcast UPD address, port, and interval.Example: get broadcast // Show broadcast UDP information

2.4.3 get comThis command displays the communication settings.Example: get com // Show communication settings

Note: <string> cannot contain spaces. If the SSID has spaces, use the $ charac-ter to indicate the space. For example, yellow brick road becomes yel-low$brick$road. When you use the get wlan command to view the SSID, the module properly displays it as SSID=yellow brick road.

Note: This command applies only to the RN171 module; it is not applicable to the RN131. The transmit power on the RN131 is fixed to 18 dBm. If you send this parameter to the RN131, it issues an error message ERR: Bad Args.


RN-WIFLYCR-UG

2.4.4 get dnsThis command displays the DNS settings.Example: get dns // Show the DNS information

2.4.5 get everythingThis command displays all of the configuration settings, which is useful for debugging.Example: get everything // Show all configuration settings

2.4.6 get ftpThis command displays the FTP settings.Example: get ftp // Show the FTP settings

2.4.7 get ip <char>This command displays the IP address and port number settings, where <char> is the optional parameter a. Using <char> returns the current IP address.Example: get ip a // Display the current IP address

2.4.8 get mac This command displays the device’s MAC address.Example: get mac // Show the MAC address

2.4.9 get option This command displays the optional settings such as the device ID.Example: get option // Show the optional settings

2.4.10 get sysThis command displays the system settings, sleep and wake timers, etc. Example: get sys // Show the system settings

2.4.11 get timeThis command displays the time server UDP address and port number.Example: get time // Show the time server information

2.4.12 get wlanThis command displays the SSID, channel, and other WLAN settings.Example: get wlan // Show the WLAN settings

2.4.13 get uartThis command displays the UART settings.Example: get uart // Show the UART settings


RN-WIFLYCR-UG

2.4.14 verThe command displays the firmware version.Example: ver // Show the firmware version

2.5 STATUS COMMANDS

These commands begin with the keyword show and they return the current values of the system variables. In some cases, e.g., IP addresses, the current values are received from the network and may not match the stored values. Except where noted, the show commands do not have any parameters.

2.5.1 show batteryThis command displays current battery voltage, and is only applicable to Roving Networks’ battery-powered products such as the RN370 and temperature sensors (ISENSOR-CB). Example: show battery // Show the current battery voltage

2.5.2 show connectionThis command displays the connection status in the hex format 8<XYZ>, where 8<XYZ> is a bit-mapped register providing the information shown in Figure 2-8.

FIGURE 2-8: SHOW CONNECTION COMMAND BIT-MAPPED REGISTER

2.5.3 show ioThis command displays the GPIO pins’ level status in the hex format 8<ABC>. For example, 8103 indicates GPIO 0, 1, and 8 are high.Example: show io // Show the GPIO level status

2.5.4 show net <char>The command displays the current network status, association, authentication, etc., where <char> is the optional parameter n. Using the n parameter displays only the MAC address of the access point with which the module is currently associated.Example: show net n // Show the access point’s MAC address

4567 3..0TCP status. 0 = idle; 1 = connected; 3 = No IP; 4 = connecting

Association. 1 = OK.

Authentication. 1 = OK.

DNS server. 1 = server is contacted.

DNS found. 1 = DNS is resolved.

12..9

Channel. Value = 1 - 13.

16..13

Fixed. Value = 8.


RN-WIFLYCR-UG

2.5.5 show q <value>This command displays the value of the analog interface pin, where <value> is 0 to 7. The A/D reading is 14 bits with a range of 0 to 400 mV (therefore, the resolution is 24 uV). The output is in uV (1,000 millivolts). The module returns a value in the format 8xxxxx, where xxxxx is the voltage in microvolts sampled on the channel you requested.

Example: show q 0 // Show the voltage on channel 0

2.5.6 show q 0x1<mask>This command displays multiple analog interface values simultaneously, where <mask> is a bit-mask representing the channels. For example, to read channels 0, 1, and 7, use the command:show q 0x183 The module returns 8<chan0>, 8<chan1>, 8<chan7>

Example: show q 0x183 // Show values for channel 0, 1, and 7

2.5.7 show rssiThis command displays the last received signal strength.Example: show rssi // Show signal strength

Note: If a web post or UDP broadcast samples the data, the data is shifted as described in “UDP Broadcast” on page 72.

Note: If a web post or UDP broadcast samples the data, the data is shifted as described in “UDP Broadcast” on page 72.


RN-WIFLYCR-UG

2.5.8 show statsThis command displays the current statistics, packet RX/TX counters, etc. The com-mand returns the statistics shown in Table 2-16.

Example: show stats // Show the statistics

2.5.9 show timeThis command displays the number of seconds since the module was last powered up or rebooted.Example: show time // Show seconds since last power up

TABLE 2-16: DISPLAY STATISTICSStatistic Description

Conns The number of TCP connections.WRX Number of bytes received by the module over TCP.WTX Number of bytes transmitted by the module over TCP.RTRY Total number of TCP retries.

RTRYfail Total number of TCP retries failed.URX Total number of bytes received over the UART.UTX Total number of bytes transmitted over the UART.

RXdrop Total number of bytes dropped by the UART.RXerror Total number of UART bytes received in error (parity, framing).FlwSet Total number of set software flow controls.FlwClr Total number of cleared software flow controls.

Netbuffs Total number of dropped TCP packets.Evt Total number of unknown events.

Adhoc_lost Total number of ad hoc disconnects.Boots Total number of module restarts.Wdog Total number of watchdogs.TXon Unused.


RN-WIFLYCR-UG

2.6 ACTION COMMANDS

The action commands allow you to enter and exit command mode, join networks, etc. Except where noted, these commands do not have any parameters.

2.6.1 $$$You use this command to enter command mode. You must type $$$ together quickly with no additional characters before or after. You must not type a carriage return (<cr>) after the $$$ to enter command mode. The module replies with CMD to indicate it is in command mode. There is a 250-ms buffer before and after the $$$ escape sequence. If characters are sent before or after the escape sequence within this 250-ms interval, the WiFly module treats them as data and passes them over the TCP or UDP socket, and the module will not enter command mode.If you want to use different characters to enter command mode (not $$$), you can set the character to use with the set comm $ <char> command.Example: $$$ // Enter command mode

2.6.2 apmode <bssid> <channel> This command creates a custom soft AP network where <bssid> is the broadcast SSID and the <channel> is the channel on which the soft AP network is created. The <bssid> and <channel> parameters are optional. If no parameters are specified, the module:• Uses the string stored with the set opt device_id <string> command and

appends -xy, where xy is the last byte of the module’s MAC address as the SSID.• Creates the soft AP network on channel 1.

Example: apmode MyNetwork 11 // Creates a soft AP network on channel // 11 with SSID MyNetwork

2.6.3 close This command disconnects a TCP connection.Example: close // Close the TCP connection

2.6.4 exit This command exits command mode. After leaving command mode, the module res-ponds with EXIT. Example: exit // Leave command mode

Note: This command does not survive power cycling. After a power cycle, the module behaves according to the wireless join policy determined by the set wlan join <value> command.


RN-WIFLYCR-UG

2.6.5 factory RESET This command loads the factory defaults into the module’s RAM and writes the settings to the standard configuration file. You must type the word RESET in capital letters. After you type this command, you must reboot the module for the settings to take effect.Example: factory RESET // Reset the configuration settings to the

// factory defaults

2.6.6 join <string>This commands instructs the WiFly module to join the network indicated by <string>. If the network has security enabled, you must first set the pass phrase with the set wlan pass command prior to issuing the join command.

Default: Not applicableExample: To join an unsecure network:

join roving1 // Join the network roving1To join a secure network:set wlan pass rubygirl // Set the password to rubygirljoin roving1 // Join the network roving1

2.6.7 join # <value>Use this command to join a network that is shown in the scan list, where <value> is the entry number listed for the network in the scan list. If network is security enabled, you must set the passphrase with the set wlan phrase command prior to issuing the join command.Example: join # 1 // Join the network indicated by a 1 in the

// scan list

2.6.8 leaveThis command disconnects the module from the access point to which it is currently associated.Example : leave // Disconnect from the access point

2.6.9 lookup <string> This command causes the module to perform a DNS query, where <string> is the host name for which to search.Example : lookup roving1 // Search for the host roving1

2.6.10 open <address> <value> This command opens a TCP connection to <address>, where <value> is the port num-ber and <address> is an IP address in the form <value>.<value>.<value>.<value> with <value> being a number between 0 and 255. If you do not use the <address> and

Note: The <string> must not contain spaces. If the network SSID contains spa-ces, use a $ instead of the space, e.g., MY$NETWORK to represent My Network.


RN-WIFLYCR-UG

<value> parameters, the module attempts to connect to the stored remote host IP address and remote port number. <address> can also be a DNS host name that the module attempts to resolve.Default: Stored remote IP address and portExample: open 10.20.20.62 2000 // Open a connection to 10.20.20.62

// port 2000

2.6.11 ping <string> <value> This command pings a remote host, where <string> is one of the parameters shown in Table 2-17 and <value> is the number of pings to send. By default, the module sends 1 packet. The optional <value> sends < value> pings, at 10 per second.

Default: 1 packetExample: ping 10.20.20.12 10 // Ping 10.20.20.12 10 times

2.6.12 rebootThis command forces the module to reboot (similar to a power cycle).Example: reboot // Reboot the module

2.6.13 run <string>This command is used to run an application using ASCII commands, where <string> is web_app or wps_app.Example: run web_app // Runs the configuration web server

run wps_app // Runs the WPS application

2.6.14 scan <value> <char>This command performs an active probe scan of access points on all 13 channels, where <value> is an optional parameter representing the time in ms per channel. <char> represents the optional parameter P, which causes the module to perform a passive scan, and list all access points it can see in passive mode.When you use this command, the module returns the MAC address, signal strength, SSID name, and security mode of the access points it finds. The default scan time is 200 ms/channel or about 3 seconds. See “Scan Output Format” on page 64 for more information on the format of the scan command output.You can also use this command in ad hoc mode.

TABLE 2-17: PING COMMAND PARAMETER OPTIONSOption Description

g This option pings the gateway. The gateway IP address is loaded if DHCP is turned on; otherwise, you must set it using the set ip gateway <address> command.

h This option pings the stored host IP address. You can set the host IP address using the set ip host <address> command.

i This option pings a known Internet server, www.neelum.com, by first resolving the URL. This option is useful to demonstrate that DNS is working and that the device has Internet connectivity.

0 This option terminates a previously issued ping command.<address> Ping a remote host where <address> is an IP address in the form <value>.<value>.<value>.<value>

with <value> being a number between 0 and 255.


RN-WIFLYCR-UG

Default: 200 ms/channelExample: scan 30 // Scan for 30 ms/channel

2.6.15 sleepThis command puts the module to sleep. You can wake the module by sending char-acters over the UART or by using the wake timer.Example: sleep // Put the module to sleep

2.6.16 time This command sets the real-time clock by synchronizing with the time server specified with the time server (set time) parameters. This command sends a UDP time server request packet.Example: time // Set the real-time clock

2.7 FILE I/O COMMANDS

You use the file I/O commands to save, load, delete, and update configuration and other files.

2.7.1 del <string> <value> This command deletes a file, where <string> is the filename and <value> is an optional number that overrides the name and uses the sector number displayed by the ls com-mand.Example: del my_old_config // Delete the file my_old_config

2.7.2 load <string> This command reads in a new configuration file, where <string> is the filename.Example: load my_config // Load the file my_config

2.7.3 ls This command displays the files in the system.Example: ls // Display the files in the system

2.7.4 save <string>This command saves the your configuration settings to a file, where <string> is an optional filename. If you do not specify a filename, the module saves the settings to a file named config (default).Default: configExample: save // Saves the configuration settings to the

// config filesave my_config // Saves the settings to the my_config file


RN-WIFLYCR-UG

2.7.5 boot image <value> This command makes a file represented by <value> the new boot image.Example: boot image 55 // Set the new boot image to a file

// represented by filename 55

2.7.6 ftp update <string> This command deletes the backup image file, retrieves a new image file, and updates the boot pointer to the new image, where <string> is the new image file to retrieve. Refer to “Upgrading Firmware Via FTP” on page 83 for more information.Example: ftp update wifly3-400.img // Retrieve the version 4.0 firmware

// (RN131)

Note: After changing the boot pointer to the new image, you must reboot the mod-ule to boot up with the new image. After the module boots up with new image, you must perform a factory reset on the module to initialize all the parameters to the factory default settings. Then you can reinitialize the parameters as required.


RN-WIFLYCR-UG

Chapter 3. Advanced Features & SettingsThis chapter describes the WiFly module’s advanced features, including techniques to put the module to sleep, wake up, and methods to open a TCP connection when awake. It also describes the UART flow control, alternative GPIO functions, and the real-time clock.

3.1 ACCESS POINT (AP) MODE

Roving Networks WiFly modules support several methods for accessing Wi-Fi net-works. In addition to infrastructure mode and ad hoc mode, with firmware version 2.45 the modules support access point (AP) mode. You implement AP mode using special firmware. In the future, AP mode will be released as part of the standard firmware and will replace ad hoc mode.AP mode provides several advantages over ad hoc mode. In AP mode:• The module creates a soft AP network to which Android devices (smartphones

and tablets) can join. (Android devices do not support ad hoc networking.)• The module runs a DHCP server and issues IP addresses to seven clients, which

is much faster than automatic IP in ad hoc mode.• The WiFly module will support security in future releases, unlike ad hoc, which is

an open mode.• The module supports routing between clients.

The following sections describe how to use AP mode with WiFly products, including configuring the module to act as an AP, enabling AP mode in hardware and software, and sending data to the module from a remote host.

3.1.1 Enabling AP modeThere are two methods for enabling AP mode, hardware and software, as described in the following sections.

3.1.1.1 ENABLE IN HARDWARE

To enable AP mode in hardware, hold GPIO9 high at 3.3 V and then reset (or power cycle) the module. The module will then boot up in AP mode with the DHCP server enabled.

Note: In firmware version 2.36 (ad hoc mode), the auto join feature is enabled to maintain backwards compatibility. In version 2.45 and higher (AP mode), auto join is disabled and you must explicitly enable auto join mode using the set wlan join 1 command for the module to associate with the pre-stored AP settings automatically.

Note: Refer to the documentation for your module on the Support page of the Roving Networks web site at http://rovingnetworks.com/Support_Overview for more details on programming/configuring the module.




RN-WIFLYCR-UG

Table 3-1 shows the default AP mode settings.

When the module boots up in soft AP mode, other Wi-Fi-enabled devices (PCs, iPhones, iPads, Android tablets, etc.) should be able to see the module when they scan for access points.

3.1.1.2 ENABLE IN SOFTWARE

You enable AP mode in software using the set wlan join 7 command. You can custom-ize network settings such as the SSID, channel, and IP address in software to create a custom AP mode. For example, the following commands create a custom AP mode in software:set wlan join 7 // Enable AP modeset wlan channel <value> // Specify the channel to create networkset wlan ssid <string> // Set up network broadcast SSID

// (BSSID)set ip dhcp 4 // Enable DHCP serverset ip address <address> // Specify the IP addressset ip net <address> // Specify the subnet maskset ip gateway <address> // Specify the gatewaysave // Store settings reboot // Reboot the module in AP modeAfter rebooting, the module is in AP mode with the custom settings shown above (SSID, channel, IP address, netmask, and gateway).A quick method of creating a soft AP network is to use the apmode <bssid> <channel> command, where <bssid> is the broadcast SSID and <channel> is the channel on which the soft AP network is created. The <bssid> and <channel> parameters are optional. If no parameters are specified, the module:• Uses the string stored with the set opt device_id <string> command and

appends -xy, where xy is the last byte of the module’s MAC address as the SSID.

TABLE 3-1: DEFAULT AP MODE SETTINGSSetting AP Mode Default

SSID WiFly-XXX-yy, where:• XXX is GSX for the RN131 and EZX for the RN171• yy is the LSB byte of the module’s MAC address

Channel 1DHCP server EnabledIP address 1.2.3.4Netmask 255.255.255.0Gateway 1.2.3.4

Note: Roving Networks recommends setting the WiFly module as the gateway when creating a point-to-point network between devices (Wi-Fi network only).


RN-WIFLYCR-UG

• Creates the soft AP network on channel 1.

apmode MyNetwork 11 // Creates a soft AP network on channel // 11 with SSID MyNetwork

3.1.2 Using AP ModeThe following sections describes how to use AP mode, including connecting to the module, checking for the last device connected over TCP, viewing associated devices, enabling the link monitor, and routing data between clients.

3.1.2.1 CONNECT TO THE MODULE

Once the module boots up in AP mode, any client device can associate with the net-work the module is broadcasting. Once associated, the module’s DHCP server assigns an IP address to the client device. The default lease time is 1 day i.e., 86,400 seconds. You can configure the lease time using the set dhcp lease <value> command, where <value> is the time in seconds. To view a list of devices associated with the module, use the show lease command. The command output is in the following format with commas delimiting the fields:

Figure 3-1 shows example output from the show lease command.

FIGURE 3-1: SHOW LEASE COMMAND EXAMPLE OUTPUT

Once a client is associated to the network, it can open a TCP connection to the Roving Networks’ module. After successfully opening a TCP connection, the client receives a *HELLO* message. The Roving Networks’ module prints *OPEN* on the UART, indi-cating an open TCP connection.

Note: This command does not survive power cycling. After a power cycle, the module behaves according to the wireless join policy determined by the set wlan join <value> command.

IP address assigned Client MACaddress

Remaining lease time(in seconds)

Host name

<2.42> show lease

1.2.3.10,f0:cb:a1:2b:63:59,153,*

1.2.3.11,00:00:00:00:00:00,0,

1.2.3.12,00:00:00:00:00:00,0,

1.2.3.13,00:00:00:00:00:00,0,

1.2.3.14,00:00:00:00:00:00,0,

1.2.3.15,00:00:00:00:00:00,0,

1.2.3.16,00:00:00:00:00:00,0,

<2.42>

Note: In AP mode, the module can assign a DHCP lease to 7 clients. However, not all clients report the host name. In this case, the module reports the name as an asterisk (*).


RN-WIFLYCR-UG

3.1.2.2 CHECK FOR THE LAST CONNECTED DEVICE OVER TCP

In some cases, it is beneficial to know the IP address of last device that connected to the module over TCP or the last device to which the module connected over TCP. To find this address, use the show z command. This command does not survive a power cycle or reboot.Upon power up, if no device is connected over TCP, the show z command returns 0.0.0.0.

3.1.2.3 View Associated Devices

To see a list of devices associated with the module, use the show associated com-mand. The command output is in the following format with commas delimiting the fields:

Figure 3-2 shows example output from the show associated command.

FIGURE 3-2: SHOW ASSOCIATE COMMAND EXAMPLE OUTPUT

You can use the Seconds since last packet received output to check for stale con-nections.

3.1.2.4 Enable the Link Monitor

AP mode supports a link monitor feature to detect if individual client devices are active and in range of the module. The link monitor is a timer (in seconds) that checks to see if any packets are received from an associated device. If the timer expires, the AP mod-ule de-authenticates the client(s). This feature is useful for aging out clients that do not send any traffic over Wi-Fi.You enable the link monitor using the set wlan fmon <value>, <value> is a decimal number representing the number of seconds of client inactivity (i.e., no data received from the client device). This command sets the soft AP mode link monitor timeout threshold for each associated client device. When this timer expires, the module deau-thenticates that particular client. Setting this timer to a lower value, e.g., 10 seconds, may result in frequent deauthen-tications for client devices if they do not send data before the timer expires.To disable the fmon timer, set <value> to zero (0). The default is 3600.Example: set wlan fmon 1000 // Set the fmon timer to 1,000 seconds

3.1.2.5 ROUTE DATA BETWEEN CLIENTS

AP mode supports routing between clients. Clients can ping each other via the AP mod-ule and can also send data to each other over TCP and UDP.

Connection number

Host MAC address

Received byte count

Transmitted byte count

Seconds since last packet received

<2.42> show associated

1,f0:cb:a1:2b:63:59,36868,0,7

2,00:24:8c:31:e5:27,76168,0,2

3,98:4b:4a:6b:e0:0f,1992,0,0

<2.42>


RN-WIFLYCR-UG

3.1.2.6 GPIO4, 5 & 6 ALTERNATIVE FUNCTIONS

GPIO4, 5, and 6 have alternative functions in soft AP mode as described in the advanced sections later in this document. You enable the alternative functions using the following commands:set sys iofunc 0x70 // Enables alternative functionsThe link monitor feature must be enabled to turn on the alternative functions in soft AP mode only. Table 3-2 shows the GPIO alternative functions.

3.2 CONFIGURATION WEB SERVER

This section describes how to use the module’s configuration web server (supported in firmware version 4.0 and higher).

3.2.1 IntroductionRoving Networks WiFly modules can operate in one of three modes:• Infrastructure mode—The module can join a network created by an access point

(AP).• Ad hoc mode—The module creates a network to which other devices can join.• Soft AP mode—The module behaves as an AP with limited functionality.A key challenge when using any embedded device in infrastructure mode is to provi-sion it so that it can associate with an AP. This process requires storing the AP’s set-tings, such as the SSID and passphrase, in the embedded device.You can configure or provision Roving Networks embedded Wi-Fi modules to join an infrastructure networks in several ways:• Sending ASCII commands to the module over a UART.• Sending ASCII commands remotely while the module is in ad hoc or soft AP

mode.• Using Wi-Fi protected setup (WPS).• Sending commands to the module remotely using a web interface.

TABLE 3-2: GPIO ALTERNATIVE FUNCTIONSGPIO Description

GPIO4 High when the first client associates, Low when all clients leave the networkGPIO5 WiFly module can drive it high to open a TCP connection to a stored host. When

the module drives GPIO5 low, it closes the TCP connectionGPIO6 WiFly module drives it high when a TCP connection is open, low when TCP con-

nection is closed


RN-WIFLYCR-UG

3.2.2 Using the Configuration Web ServerConfiguring the embedded WiFly module to associate with an AP in infrastructure mode involves the following process:1. Invoke the module’s configuration web server.2. Connect your client device (PC, smartphone, tablet, etc.) to the module’s soft AP

network.3. Access the module’s configuration web page from your client device’s web

browser.4. Save the settings (SSID and passphrase) in your web browser and exit.

3.2.2.1 INVOKE THE CONFIGURATION WEB SERVER

There are two methods for enabling the web server: hardware and software. When you invoke the configuration web server, it creates a soft AP network with the settings shown in Table 3-3.

3.2.2.1.1 Invoke Configuration Web Server in HardwareYou can invoke the web server in hardware using GPIO9. To use GPIO9, specify that the web application should launch using command set sys launch_string web_app (default configuration).With the launch string set, drive GPIO9 high any time after power up to invoke the web server. The module creates a soft AP mode network with the parameters described in Table 3-3.

TABLE 3-3: SOFT AP NETWORK SETTINGSSetting Soft AP Mode Default

SSID WiFly-GSX-XX for RN131G/CWiFly-EXZ-XX for RN171where XX is the last byte of the module’s MAC address

Channel 1DHCP server EnabledIP address 1.2.3.4Netmask 255.255.255.0Gateway 1.2.3.4

Note: The soft AP network’s SSID uses the module’s device ID parameter. If you change the device ID parameter using the set opt device_id <string> command, the module uses this new device ID as the soft AP network’s SSID. The device ID parameter is not set to a default if you perform a factory reset.

Note 1: Do not drive GPIO9 high upon power up. Doing so invokes soft AP mode and does not launch the web server.

2: If you are using an evaluation kit, GPIO9 is accessible using a jumper or pushbutton.


RN-WIFLYCR-UG

3.2.2.1.2 Invoke Configuration Web Server in SoftwareIf GPIO9 is not accessible using a pushbutton or jumper, an embedded microcontroller can invoke the configuration web server mode in software using the ASCII command run web_app. This command runs the configuration web server application and creates an AP network to which devices can join and configure the WiFly module from a web browser.

3.2.2.2 STATUS LEDS IN CONFIGURATION WEB SERVER MODE

The status LEDs provide a visual indication of the WiFly module’s state while you use the configuration web server feature. See Table 3-4.

3.2.3 Using the Web Server to Configure the ModuleThis section describes how to use the web server to configure the WiFly module with the AP’s SSID and passphrase. The example uses the Internet Explorer web browser running on a Windows 7 machine, however, the same concepts apply to any device with a Wi-Fi interface (e.g., iPhone, Android smartphones, tablets, or PCs,) running a web browser (e.g., Chrome, Firefox, or Safari).To configure the module using a web browser, perform the following steps:1. Associate your PC to the module’s AP network. Figure 3-3 shows a screen shot

displaying the network name.

TABLE 3-4: STATUS LEDSEvent LED Action

Launch AP mode Red, green Blink alternatelyYellow, blue Off

Client associated with the AP network Green Solid onYellow Blinks fast (twice per second)

Web browser launched on the client Blue Solid onGreen Solid onYellow Blinks fast (twice per second)


RN-WIFLYCR-UG

FIGURE 3-3: MODULE’S NETWORK NAME

2. Launch your web browser.3. Type http://config to go to the home page of web server running on the module.

The page has two tabs displayed by default:• Network Configuration—Used to set the AP?s SSID and passphrase.• Information—Displays information about the WiFly module. This tab displays

the following information:- WiFly module’s MAC address- Module type (RN131 or RN171)- List of files on the file system- Battery strength

4. Click the Network Configuration tab (see Figure 3-4). In this tab you configure the module’s network settings (SSID and passphrase). Configure these settings using the following steps:a) Enter your network’s SSID in the Access Point SSID box.

Alternatively, click the Refresh List button. The module scans for networks and displays a list of found networks. Select your network from the Available Access Points list or type it in the Access Point SSID box. Clicking an SSID displays a drop-down menu with more information about that network, such as channel, RSSI, security mode (WEP, WPA, WPA2), capabilities, WAP configurations, WPS configuration, and the AP’s MAC address (also called BSSID). If you do not see your desired access point in the list, click Refresh List to scan again.


RN-WIFLYCR-UG

FIGURE 3-4: NETWORK CONFIGURATION TAB

b) Type your AP’s security passphrase in the Passphrase box.c) (Optional) The module uses DHCP by default. If you want to assign the mod-

ule a static IP, turn off the Check to enable DHCP option and enter the static IP, subnet mask, and gateway.

d) Once you have configured the network settings, click Save Configuration to save the settings to the module.

5. Exit the web server by clicking Exit Web Configuration App. The module reboots in infrastructure mode and joins your wireless network

3.2.4 Using the Advanced TabsTurning on the Display Advanced Tabs option (bottom right corner of the application window) show the Terminal and Module Configuration tabs.

3.2.4.1 TERMINAL TAB

Click the Terminal tab (see Figure 3-5). In this tab you can issue ASCII commands to configure any of the WiFly module’s parameters. The web server includes a help utility to guide you through the module configuration. To use this feature, type help in the ter-minal.

Note: If your wireless network is hidden (i.e., not broadcasting an SSID), it does not display in the scan output. In this case, you must manually enter the SSID.


RN-WIFLYCR-UG

FIGURE 3-5: TERMINAL TAB

3.2.4.2 MODULE CONFIGURATION TAB

Click the Module Configuration tab (see Figure 3-6). In this tab you configure the WiFly module’s frequently used parameters such as device ID, UART baud rate, and flow control. You configure other parameters with ASCII commands in the Terminal tab.

FIGURE 3-6: MODULE CONFIGURATION TAB

3.2.5 Web Server TimersThe application includes two timers to ensure that the web server runs smoothly:• Idle timer• Browser disconnect timer


RN-WIFLYCR-UG

3.2.5.1 IDLE TIMER

The idle timer ensures that the client associated with the WiFly module’s AP network is not lost or unresponsive. If there is no interaction between the configuration web server and the client’s web browser for five minutes (default value), the WiFly module reboots to the boot image. To restart the configuration web server, you must invoke it in software or hardware as described previously.The timeout defaults to five minutes (300 seconds) and is configurable via the following command:set comm idle <seconds>

3.2.5.2 BROWSER DISCONNECT TIMER

This timer is used to recover from an unexpected situation in which the configuration web server on the WiFly module becomes unresponsive to the requests sent out by the web browser.The web browser periodically sends requests to the configuration web server. If the WiFly module does not receive a request within 60 seconds, it assumes that the con-figuration web server has become unresponsive and it reboots itself into configuration web server mode. Then, you must re-associate your device with the WiFly module’s AP network and refresh the web page.

3.3 PUTTING THE MODULE TO SLEEP & WAKING IT

Table 3-5 describes the methods for putting the module to sleep.

Table 3-6 describes the methods for waking the module.

TABLE 3-5: METHODS FOR PUTTING THE MODULE TO SLEEPMethod Interface Description

sleep command UART Go into command mode using $$$ and issue the sleep command.

Sleep timer Internal RTC The module sleeps based on the set sys sleep <value> command setting.

Drive GPIO8 high GPIO8 The module sleeps as soon as GPIO8 is held high (4 µs latency). To enable this feature, use the set sys trigger 0x20 command setting.

TABLE 3-6: METHODS FOR WAKING THE MODULE (SHEET 1 OF 2)Method Interface Description

Sensor input(1.2-V DC only)

Sensor pins You can wake the module using sensor pins 0 - 3 (1.2-V DC ONLY). Use the set sys trigger <value> command to enable the sensors.

Rx pin(3.3-V DC only)

RX pin via sensor 0

The RX pin on the RN-134 and the RN-174 evaluation boards is tied to sensor pin 0 via a resistor divider network. Use the set sys trigger 1 command to wake the module when it receives RX data.

NOTE: With this method, the module may drop the first UART data byte. A better method is to wake the module using the CTS pin.

CTS pin(3.3-V DC only)

CTS pin via sensor 1

The CTS pin on the RN-134 and the RN-174 evaluation boards is tied to sensor pin 1 via a resistor divider network. Use the set sys trigger 2 command to wake the module using the CTS pin.


RN-WIFLYCR-UG

When the module wakes up from sleep, it takes time (in milliseconds) to initialize the internal hardware. During this time, any data that is sent to the WiFly module over the UART is not processed. You can monitor signals that indicate the module is ready to accept data, as described in Table 3-7.

After the module wakes, you can open a TCP connection to a remote host in a number of ways, as described in Table 3-8. You set the remote host using the following com-mands:set ip host <address> OR set dns name <string> // Sets the host’s IP address OR URL set ip remote <value> // Sets the port number on which the host

// is listeningsave // Save the settings in the configuration

// filereboot // Reboot the module so that the settings

// take effect

Wake timer Internal RTC The wake timer wakes the module based on the set sys wake <value> com-mand setting.

FORCE AWAKE FORCE AWAKE pin

An input pulse of at least 31 s (3.3 V) wakes the module.

TABLE 3-6: METHODS FOR WAKING THE MODULE (SHEET 2 OF 2)Method Interface Description

TABLE 3-7: SIGNALS INDICATING THE MODULE CAN ACCEPT DATAMethod Interface Description

RTS transition RTS pin When the WiFly module wakes up, the RTS pin goes high. Once the module is ready, the RTS pin is driven low. You can monitor this pin with a microcontroller.

Monitor GPIO4 Alternative GPIO functions

Set the alternative functions for GPIO4, GPIO5, and GPIO6 (see “GPIO4, 5 & 6 Alternative Functions” on page 49). When the module wakes up and connects to an access point, GPIO4 goes high, indicating the module is ready to receive data over the UART. A microcontroller can monitor GPIO4.

Sensor power Sensor power pin

You can configure the module to output Vbat, or 3.3 V or 1.2 V on the sensor power pin when it wakes from sleep, indicating it is ready to accept data.

TABLE 3-8: METHODS OF CONNECTING TO A REMOTE HOSTMethod Type Description

Auto connect Internal RTC timer

Connect to the host at specific time intervals based upon the set sys autoconn <value> command setting.

Open UART In command mode, issue the open command.Connect on UART data

UART mode 2 This mode is designed for the HTML client feature. Use the set uart mode 2 command to connect the to host automatically when UART data is received.

GPIO5 Alternative GPIO func-tions

Set the alternative functions for GPIO4, GPIO5, and GPIO6 (see “GPIO4, 5 & 6 Alternative Functions” on page 49). Set GPIO5 high to trigger a TCP connection and low to disconnect.


RN-WIFLYCR-UG

3.4 SYSTEM & AUTO-CONNECT TIMERS

The WiFly module uses a real-time clock (RTC) to generate timers. The RTC is active even when the module is asleep, allowing you to put the module to sleep and wake it based on timer intervals. The module has the following timers:• Sleep timer—Used to put the module to sleep. It is a 32-bit number, which corre-

sponds to a maximum 1.19 million waking hours. The sleep timer is set with the set sys sleep <value> command, where <value> is a decimal number represent-ing seconds.

• Wake timer—Used to wake the module. It is a 22-bit number, which corresponds to a maximum sleep time of 1,165 hours. The wake timer is set with the set sys wake <value> command, where <value> is a decimal number representing sec-onds.

• Auto-connect timer—Used to open a TCP connection automatically.• Idle timer—Used to close a TCP connection automatically.The sleep and wake timers are responsible for putting the module to sleep and waking it up. If the sleep timer is enabled, the module automatically goes into deep-sleep, low-power mode once the timer counts down to 0. The sleep timer is disabled if the module has an IP connection or is in command mode. For example, if you want the module to wake up, join a network, and be available to accept TCP connections for 30 seconds every 2 minutes you would set the timers as shown in the following example:set wlan ssid my_net // Set the host nameset wlan passphrase my_pass // Set the passphraseset sys sleep 30 // Module sleeps after being awake for

// 30 sset sys wake 90 // Module wakes after sleeping for 90 ssave // Save the settingsreboot // RebootFigure 3-7 shows the transitions between the sleep and awake state based on the sleep and wake timer settings in the previous example.

FIGURE 3-7: SLEEP & AWAKE STATE TRANSITIONS

3.4.1 UDP Sleep & Connection TimersIn UDP only protocol mode (set with the set ip proto 1 command), the autoconn timer is used as an auto-sleep timer. When the module begins to transmit the first UDP data packet, this timer begins counting down. When it reaches 0, the module sleeps. You set the UDP auto-sleep timer using two commands, set sys autosleep and set comm timer. The timer interval is a product of the autosleep value and the comm flush timer (in ms). The timer is decremented every “product” milliseconds.

Awake State

Sleep State

Sleep Timer30 s

Wake Timer90 s

Sleep Timer30 s


RN-WIFLYCR-UG

For example, if you want a UDP sleep timer of 40 ms, use the following commands:set sys autosleep 4 // Set auto-sleep value to 4set comm timer 10 // Set comm timer to 10 ms (default value)The resulting UDP sleep timer is 4 x 10 ms or 40 ms. You could also set autosleep = 2 and comm timer = 20 ms to achieve the same effect.Roving Networks recommends using a minimum value of 2 (when the default flush time is 10 ms) to ensure that the UDP packet is transmitted. For larger packets, you should increase the value.

3.4.2 TCP Connection TimersThe TCP connection timers control when the module opens or closes a socket.

3.4.2.1 OPENING A TCP CONNECTION

In TCP client mode, the auto-conn timer controls the establishment of a socket connec-tion. When set, the device periodically attempts to establish a connection when the timer expires.The set sys autoconn <value> command causes the module to connect to the host periodically. The timer <value> determines how often to connect to the stored remote host. If set to 1, the module makes one attempt to auto connect upon power up. If set to 2 or higher, auto connect re-opens the connection after the connection is closed. The default, 0, disables the timer.

3.4.2.2 CLOSING THE TCP CONNECTION

The module supports a disconnect timer in both TCP client and server mode (default mode). You can use this timer to close a TCP connection automatically after a specified number of seconds of no transmit or receive data. To set the disconnect timer, use the set comm idle <value> command, where <value> is the number of seconds. The default comm idle timer value is 0, which means the module never disconnects when idle.For example, to close the TCP connection after 5 seconds of inactivity, use the set comm idle 5 command.

3.5 WAKE ON SENSOR INPUT

Four sensor inputs (0 to 3) wake the module from sleep. These pins have a small cur-rent source that is activated in sleep mode. This source is approximately 100 nA, and causes the input to float up to about 1.2-V DC. If, for example, SENSE1 is enabled, pull-ing the SENSE1 pin to ground wakes the device. To enable the sensors to wake the module, use the command set sys trigger <mask>, where <mask> is a bit-mapped setting of each sensor. For example, to wake the mod-ule using sensor pin 2, use set sys trig 4. Setting the trigger value to 0 disables all sen-sor pins.

Note: You must specify the remote host’s IP address and port number in the mod-ule’s configuration file for the auto-connect timer to work.


RN-WIFLYCR-UG

Table 3-9 describes the values to wake the module using individual sensor inputs.

The sensor inputs are rated 1.2-V DC, maximum. You must use a resistor divider when driving a sensor pin from the other 3-V pins such as RX. You should use a resistor divider network with a minimum of 24 K in series and 10 K to ground from the UART RX or CTS pin.An open-drain FET is an appropriate device to tie to the sensor pin as the threshold is about 500 mV. You can use additional pull-up to 1.2-V DC if the circuit has an imped-ance (due to leakage current) of less than 5 Mohms (500 mv/100 nA). Leave unused sensor pins disconnected.

3.6 WAKE ON UART ACTIVITY

When the module is in sleep mode, the UART is disabled. However, the module can wake on UART activity by connecting the sensor pins to the RX data or CTS pin (using the appropriate divider resistors as described in “Wake on Sensor Input” on page 58).

The RN-134 and the RN-174 evaluation boards have a built in resistor divider connect-ing SENSE0 and SENSE1 to RXD and CTS, respectively. This setup allows wake on RX and CTS using a 3.3-V signal.

To enable wake on RXD, use the set sys trig 1 command.

TABLE 3-9: SENSOR INPUT VALUESWake on Sensor Input Value Command

0 1 set sys trigger 11 2 set sys trigger 22 4 set sys trigger 43 8 set sys trigger 8

WARNING

The voltage on any sensor input CANNOT exceed 1.2-V DC or the module will be permanently damaged.

WARNING

Do not apply 3.3 V directly to SENSE0 and SENSE1; the voltage on any sensor input CANNOT exceed 1.2-V DC or the module will be permanently damaged.


RN-WIFLYCR-UG

The first (or possibly multiple) byte sent to the module will likely be lost; therefore, you should take care to send a preamble byte to wake the module before sending valid data bytes. Alternatively, use the CTS input to wake the module and wait until it is ready to accept data. To enable this setting, use the set sys trig 2 command.

3.6.1 UART Receiver & RTS/CTS Hardware Flow ControlThe UART receive buffer is approximately 1,500 bytes. At lower baud rates (less than 115 K), the system can send data over TCP/IP without flow control. Depending on the frequency and quantity of the data being sent, the comm parameters optimize Wi-Fi performance by specifying when the system sends IP packets. To min-imize latency and TCP/IP overhead, use the flush size or match character to send data in a single IP packet. In most cases, you should set the flush timer to a large number to avoid fragmentation. For high throughput, increase the UART baud rate, set the flush size to 1,460, and set the flush timer to a large value so that full IP packets are sent.You can control packet forwarding in the following ways:• set comm match <value> sets the value of the packet terminator. Each time the

module sees the match character it sends an IP packet. For example, set comm match 0xd forwards a packet when the module sees a 0xd hex character.

• set comm size <value> sets the flush size, where <value> is the number of bytes received before forwarding. The maximum is 1,460 bytes, which is the size of a single Ethernet frame.

• set comm time <value> sets the flush timer, which is used to flush any partial data sitting the RX buffer if no additional data is received for <value> ms. For example the set comm time 1000 command causes the module to wait for 1 sec-ond after no data was sent.

If the module will be sending more than a few hundred thousand bytes in a single trans-action, you should enable hardware flow control. Your hardware must actively monitor the CTS pin. Flow control is not enabled by default; you set it with the set uart flow 1 command.It is possible to operate higher baud rates (i.e., greater than 115 K) without flow control if the packets are uniform and you use an application protocol to ensure that the packet data is delivered on the remote side before the next packet is sent. However, given the uncertainty of packet delays in a TCP/IP network and the affects of interference and retries inherent in wireless networks, flow control is typically required whenever large, contiguous quantities of data are being written to the UART to guarantee no data is lost.

3.6.2 Setting GPIO Direction, Alternate Functions & Disabling LEDsYou control the GPIO pin direction and function using two commands:• set sys mask• set sys iofunc

Note: On the RN-134 evaluation board revision 2, the resistor pack connecting the RX and CTS signals is not correctly connected to the sensors. To wake on UART RX, place a jumper from pin 3 on the evaluation board header to pin 2 on the sensor header. To wake on UART CTS, place a jumper from pin 10 on the evaluation board header to pin 3 on the sensor header.


RN-WIFLYCR-UG

3.6.2.1 CONTROL GPIO DIRECTION WITH SET SYS MASK

You can control the GPIO pin direction with the GPIO mask using the set sys mask <value> command, where <value> is entered as a hex number. The hex number rep-resents a bitmask that controls each pin, where 1 = output and 0 = input. For example:set sys mask 0x0 // Sets all pins as inputsset sys mask 0xc0 // Set only GPIO6 and GPIO7 If you only need to set one bit in the mask, you need to read, mask, and set the value. Otherwise, you will overwrite any previous GPIO settings.The default mask for the RN-131 module is 0x20f0, which sets GPIO13, GPIO7, GPIO6, GPIO5, and GPIO4 as outputs.The default mask for the RN-171 module is 0x21f0, which corresponds to the following settings:• GPIO0 - 3 are used internally on the module.• GPIO4 - 6 are LEDs.• GPIO 9 is reserved as the ARM factory reset/ad hoc mode (read at power up) and

otherwise general-purpose input detect pin.• GPIO10 - 11 are the UART RX and TX pins; TX does not need to be masked as

an output.• GPIO12 is CTS (input), if used.• GPIO13 is RTS (output), if used.

The RN-134 evaluation board’s LEDs are connected to GPIO4 - 6. To disable the LEDs, enable the alternative functions of the LEDs (use the set sys iofunc 0x7 command).

The RN-174 evaluation board’s blue LED is connected to GPIO7, which is output by default. The board does not drive this because GPIO7’s default power-up state is low.The get sys command shows the setting of the GPIO mask as shown in Example 3-1.

EXAMPLE 3-1: GPIO MASK SETTING

Figure 3-8 shows the bits corresponding to the GPIO pins and Table 3-10 shows the GPIO pin usage, their default state, and functionality.

Note: To set the GPIO pins as inputs or outputs instantly, use the set sys mask 0xABCD 1 command, which does not require a reboot.

Note: You can turn off the yellow, red, or green LEDs. The RN-134 board’s blue LED is the power indicator and cannot be turned off.

<2.21> get sysSleepTmr=……IoFunc=0x0IoMask=0x21f0


RN-WIFLYCR-UG

FIGURE 3-8: GPIO PIN BITMASK

3.6.2.2 SETTING THE ALTERNATE GPIO FUNCTIONS WITH SET SYS IOFUNC

The GPIO4, 5, and 6 default function is to control the LEDs. You can override the default to allow user programmable I/O or alternate I/O functionality by using the set sys iofunc <mask> command, where <mask> is entered as a hex number. The hex value represents a bitmask that controls each bit in the <mask> and represents a par-

14 13 12 11 10 9 8 7 6 5 4 3 2 1 0GPIO0

GPIO1

GPIO2

GPIO3

GPIO4

GPIO5

GPIO6

GPIO7

GPIO14

GPIO13 UART RTS

GPIO12 UART CTS

GPIO11 UART RX

GPIO10 UART TX

GPIO9

GPIO8

TABLE 3-10: GPIO PIN USAGE, DEFAULT STATE & FUNCTIONALITY

Bit Signal Name

RN-131 Default State

RN-171 Default State Default Function

0 GPIO0 N/A N/A -1 GPIO1 N/A Input Unused.2 GPIO2 N/A Input Unused.3 GPIO3 N/A Input Unused.4 GPIO4 Output Output Green LED.5 GPIO5 Output Output Yellow LED.6 GPIO6 Output Output Red LED.7 GPIO7 Output Output Blue LED.8 GPIO8 Input Output Unused.9 GPIO9 Input Input Ad hoc mode and factory reset.10 GPIO10 Output Output UART TX.11 GPIO11 Input Input UART RX.12 GPIO12 Input Input Throttles the transmitter if hardware flow control is enabled.

Driving this pin low enables transmitter; driving this pin high dis-ables it.

13 GPIO13 Output Output This pin goes high on power up and goes low when the system is ready. If hardware flow control is enabled, this pin toggles to high to indicate the RX buffer is full.

14 GPIO14 N/A Input -

Note: On the Wi-Fi serial adapter (RN-370) and the RN-174 evaluation board, the blue LED is connected to GPIO7. The blue LED is NOT connected to GPIO7 on the RN-134 board. It is not possible to power off the blue LED on the RN-134 board because it is connected directly to power.


RN-WIFLYCR-UG

ticular GPIO pin. If a bit is 0, then the corresponding GPIO pin is driven/read by the firm-ware per the default function. The I/O function <mask> is encoded as shown in Table 3-11.

If you disable the LEDs using bits 0, 1, and 2, you can then use the show i command to read these GPIO pins. For example, the show i command might return Port=30.To use the alternate LEDs functions, use the following commands:set sys iofunc 0x70 // Enable alternate function for GPIO4 - 6save // Store configurationreboot // Reboot the module Example 3-2 shows how to control the LEDs on the evaluation boards:

EXAMPLE 3-2: TOGGLE RED AND GREEN LEDS

3.6.2.3 CONTROLLING CONNECTIONS WITH GPIO PINS

In embedded applications it is useful to monitor and control the status of the TCP/IP connection. To monitor and control the module’s connection status, enable the alter-nate function of GPIO4 - 6. Using the alternate function for these GPIO pins, the mod-ule connects to the stored remote host IP address and port when GPIO5 is driven high and disconnects when driven low. You can monitor the TCP/IP connection status by reading GPIO6; it is high when connected and low when not connected.

TABLE 3-11: GPIO PIN ALTERNATE FUNCTION BITMASKBit Signal Name Direction Function

0 GPIO4 Output Disable the LED function so the I/O can be used as a GPIO pin.1 GPIO5 Output Disable the LED function so the I/O can be used as a GPIO pin.2 GPIO6 Output Disable the LED function so the I/O can be used as a GPIO pin.3 Unused - -4 GPIO4 Output This pin goes high after the module has associated/authenticated and has an IP

address.5 GPIO5 Input Set this pin high to trigger a TCP connection and low to disconnect.6 GPIO6 Output This pin goes high when the module is connected over TCP and low when discon-

nected.

Note: Bits 0 - 3 are mutually exclusive with bits 4 – 6, i.e., 0x77 is an illegal value.

Green LED:set sys iofunc 0x01 // Mask GPIO4 from WiFly functionalityset sys output 0x10 // Toggle GPIO4's stateRed LED:set sys iofunc 0x04 // mask GPIO6 from WiFly functionalityset sys output 0x40 // toggle GPIO6's stateGReen and red LEDs:set sys iofunc 0x05 // mask GPIO4 and GPIO6 from WiFly

// functionalityset sys output 0x50 // toggle GPIO 4& 6's state


RN-WIFLYCR-UG

To configure the module to connect using GPIO5 and GPIO6, use the following com-mands:set ip host <address> // Set the IP address of the remote hostset ip remote <value> // Set the IP port of the remote hostset sys iofunc 0x70 // Set alternate function for GPIO4 - 6save // Store configurationreboot // Reboot the module After executing these commands, run your application or other software on the remote host that opens and listens on the specified port. Then, connect GPIO5 to your embed-ded processor or other control signal. When GPIO5 is driven high, the module attempts to connect. When GPI05 is driven low, the connection is closed.

If the connection to the remote host is successful, GPIO6 goes high. If you have set the COMM OPEN and REMOTE strings, the UART displays *OPEN* and the remote host displays *HELLO*. Figure 3-9 shows the process of controlling connection with the GPIO pins.

FIGURE 3-9: CONTROLLING CONNECTIONS WITH THE GPIO PINS

3.7 SETTING DEBUG PRINT LEVELS

You can enable print functions to assist with debugging the operation and status of the module. The set sys printlvl <value> command controls these additional print func-tions, where <value> is a bit-mapped register that controls which printout messages are sent to the UART. See “set sys printlvl <value>” on page 25 for more information.

3.7.1 Scan Output FormatYou enable the scan output using the set sys printlvl 0x4000 command. The scan out-put format differs, depending on the firmware you are running.

Note: Do not to drive the GPIO pin with more than 3.3-V DC or permanent dam-age to the module will occur.

EmbeddedMicroprocessor

WiFlyModule

GPIO4 = High by WiFly Module

GPIO5 = High by Microprocessor

GPIO6 = High by WiFly Module

Event: The WiFly module is associated withan access point and has a valid IP address.

The WiFly module is instructed to open a TCP/IPconnection to the stored remote host.

Event: The WiFly module successfully opens theTCP connection to the stored remote host.

This signal instructs the microprocessor thatit is OK to open a TCP connection.

Event: the microprocessor wants to open aTCP connection to the stored remote host.

This signal instructs the microprocessor that the TCP connection is open andit can beginsending/receiving data over the TCP link. Toclose the conenction, the microprocessordrives GPIO5 low.


RN-WIFLYCR-UG

3.7.1.1 FIRMWARE VERSION 2.36 & HIGHER

Firmware version 2.36 and 2.45 support a comma-delimited scan output format, which a microprocessor can use to parse the RSSI information. The scan command output format is:

Where:

Figure 3-10 shows an example of the output format:

FIGURE 3-10: SCAN OUTPUT FORMAT FIRMWARE VERSION 2.36 & 2.45

Table 3-12 shows the security modes.

Index Channel RSSI Security Mode

Capabilities WPA Configuration WPS Mode MAC Address SSID

Field Value

Index 2 character, decimalChannel 2 character, decimalRSSI 2 character, decimal (negative number)Security mode 2 bytes (see Table 3-12)Capabilities Bit-mapped 4 hex bytes (see Table 3-13)WPA Configuration Bit-mapped 2 hex bytes (see Table 3-14)WPS Mode Bit-mapped 2 hex bytes (see Table 3-12)MAC address AddressSSID Up to 32 chars

Note: The string END is added at the end of the scan data.

SCAN:Found 301,01,-59,04,1104,28,c0,20:4e:7f:08:df:85,dad-rules02,03,-64,02,1104,28,00,00:30:bd:9b:49:22,basement03,10,-71,04,3100,28,00,90:27:e4:5d:fc:a7,URSOMONEYEND:

TABLE 3-12: SECURITY MODESNumber Description

0 OPEN1 WEP (64 or 128)2 WPA13 MIXED4 WPA25 Enterprise WEP 6 Enterprise WPA1 7 Enterprise WPA mixed8 Enterprise WPA29 Enterprise NO security


RN-WIFLYCR-UG

Table 3-13 describes the capabilities bit mask values.

Table 3-14 describes the WPA bit mask values.

Table 3-15 describes the WPS bit mask values.

3.7.1.2 FIRMWARE VERSION 2.22 THROUGH 2.30

Firmware version 2.22 through 2.30 supports a comma-delimited scan output format, which a microprocessor can use to parse the RSSI information. The scan command output format is:

Figure 3-11 shows example output from the scan command.

FIGURE 3-11: SCAN OUTPUT FORMAT FIRMWARE VERSION 2.22 - 2.30

The security mode field for the this scan format is described below:

TABLE 3-13: CAPABILITIES BIT MASK VALUESBit Mask Value Description

0004 Short slot time0100 ESS (infrastructure mode)0200 IBSS (ad hoc mode)1000 Privacy (secure with WEP or WPA) 2000 Short preamble

TABLE 3-14: WPA BIT MASK VALUESBit Mask Value Description

04 WPA_UNICAST_TKIP08 WPA_UNICAST_AES_CCMP10 WPA_BROADCAST_TKIP20 WPA_BROADCAST_AES_CCMP

TABLE 3-15: WPS BIT MASK VALUESBit Mask Value Description

02 WPS_PushButton_ACTIVE40 WPS_SUPPORTED80 WPS_PushButton_SUPPORTED

Row Count Channel RSSI Value (dBm)

Security Mode Capabilities Access Point MAC Address

SSID

SCAN:Found 501,01,-53,00,0200,1a:fc:90:e5:a5:37,QTDFW02,01,-59,04,3104,00:15:f9:38:bd:b0,SensorNet03,11,-72,04,3104,00:16:b6:45:63:98,CoolBox04,11,-50,02,3100,00:18:02:70:7e:e8,airlink-1105,11,-69,04,3100,00:14:6c:1f:f7:5e,ap-ssid-change-me

Security Mode Open WEP WPA-PSK WPA2-PSK WPA-Enterprise WPA2-EnterpriseCode 0 1 2 4 6 8


RN-WIFLYCR-UG

3.7.2 UART Heartbeat MessagesIn firmware version 2.22 and higher, the module can output UART heartbeat mes-sages. The bit-mapped message is output periodically while the module is in data mode and not connected to a remote host. Messages are not output while in command mode. The heartbeat message encodes the module’s state for the embedded micro-processor. Based on the heartbeat message, the microprocessor can choose to change the configuration by going into command mode. To enable the UART heartbeat messages, use the set sys printlvl 0x10 command. The output of this mode is:*8b30*8b30*8b30….

Table 3-16 shows the output bit format.

3.8 USING THE REAL-TIME CLOCK FUNCTION

The module’s real-time clock keeps track of the number of seconds since the module was powered on and the actual time when the module synchronized with the sNTP time server. By default, the module keeps track of up time but does not synchronize with the time server because this synchronization requires the module to be associated with a network that can access the sNTP server. The real-time clock reads the time in sec-onds since 1970, which corresponds to the UNIX time.In firmware version 2.23 and higher, you can set the RTC value in seconds using the set time rtc <value> command. The default sNTP server is:ADDR=129.6.15.28:123ZONE=7 (GMT -7)

Note: For soft AP mode, the UART heartbeat message reflects the number of cli-ent devices associated with the module. In this case, the number 8 in the output is incremented according to the number of devices currently associ-ated to the soft AP network. For example:

*81xx indicates no associated client devices *91xx indicates one associated client device*a1xx indicates two associated client devices, etc.

TABLE 3-16: OUTPUT BIT FORMATBit 15..14 13..12 11..8 7..6 5 4 3..0

Function Fixed RESERVED Channel RESERVED Authentication Association TCP statusValue 2 = Access point

mode3 = Ad hoc mode

Unused 0 - 13 Unused 1 = OK 1 = OK 0 = Idle1 = Connected3 = No IP4 = Connecting5 = Challenge for password


RN-WIFLYCR-UG

Use the show time command to see the current time and uptime as shown below:<2.23> show tTime=08:43:10UpTime=10 s

To set the time, use the time command:<2. 23> show tTime NOT SETUpTime=8 s<2. 23> time<2. 23> show tTime=08:51:31UpTime=15 s

The module can also be configured to get the time whenever it powers up using the set time enable 1 command. If you set the time enable to a value greater than 1, the mod-ule pulls the time continuously every <value> minutes. For example, to configure the module to get time upon power up, see the following example:<2. 23> set time enable 1AOK<2. 23> get timeENA=1ADDR=129.6.15.28:123ZONE=7

To view a complete listing of the time variable, use the following command:<2. 23> show t tTime=09:02:10UpTime=653 sRTC=1293567548Restarts=1Wake=6RAW=2345ab

Note: The module must be associated with a network for the module to contact the sNTP server.

Note: The RAW value is the 64-bit hex RAW value of the RTC, which ticks at 32,768 Hz.


RN-WIFLYCR-UG

3.9 TIME STAMPING PACKETS

You can use the time stamping feature to append 8 bytes to a TCP or UDP packet auto-matically. The set ip flags 0x87 command enables the time stamp and keeps other default settings). The time stamp bits from MSB to LSB are:

The 8 bytes represents the 64-bit raw value of the real-time clock register. The data is appended before calculating the TCP checksum so that the data passes through the TCP stack correctly. This register counts at 32,768 Hz. If the timeserver function is enabled, the RTC should accurately reflect the real time. This register also counts when the module is in sleep mode.

User’s TCP or UDP packet data 63..56 55..48 47..40 39..32 31..24 23..16 15..8 7..0


RN-WIFLYCR-UG


RN-WIFLYCR-UG

Chapter 4. Advanced ApplicationsThis section describes a variety of advanced applications for the WiFly module, such as sending data using UDP, associating with access points, using the HTML client fea-ture, upgrading the firmware over FTP, etc.

4.1 SENDING DATA USING UDP

UDP is a connectionless protocol: there is no initial handshaking between the hosts to set up the UDP connection and the receiver does not send an acknowledgement when it receives UDP packets. Therefore, UDP is an unreliable protocol because there is no guarantee that the data will be delivered correctly. However, because it is connection-less, UDP is suited for applications that cannot tolerate too much latency but can toler-ate some errors in the data, e.g., video transmission.To use UDP with the module, you must enable the UDP protocol using the set ip proto 1 command. You must also specify the remote host’s IP address and the local and remote port number that you will use for UDP communications. The following example shows the commands you use to enable UDP data transfer.

EXAMPLE 4-1: ASSOCIATE WITH A NETWORK

EXAMPLE 4-2: SET UP THE PROTOCOL & PORT NUMBER

Because UDP is a connectionless protocol, data begins flowing as soon as you reboot the module. Unlike TCP, you do not need to send an open command to establish the connection. The module acts like a data pipe: the UART data is sent over the Wi-Fi link via the UDP protocol (in this case) and the data coming from the Wi-Fi link (via UDP protocol in this case) is sent to the UART.

set wlan ssid <string> // Set the network nameset wlan phrase <string> // Set the passphrase for WPA and WPA2 modes

set ip proto 1 // Enable UDP as the protocolset ip host <address> // Set the remote host’s IP address set ip remote <value> // Set remote port on which host listensset ip local <value> // Set port number on which module listenssave // Save settings in the configuration filereboot // Reboot the module

Note: If you attempt to send data by typing characters on the keyboard or if your microcontroller is not sending data fast enough, the module sends out packets with fewer data bytes. To avoid this issue, set the flush timer to a higher value. By default, it is set to 10 ms. You can disable forwarding based on the flush timer (set comm time 0) or set it to a higher value (e.g., set comm time 2000).


RN-WIFLYCR-UG

4.1.1 UDP Auto PairingWith the UDP auto-pairing feature, the module temporarily stores the host IP address of the first remote device that sends a UDP packet to the module. This host IP address is stored in the module’s RAM, which is cleared when the module sleeps or power cycles. This feature allows the module to echo to any client that sends a UDP packet.

EXAMPLE 4-3: TURN ON AUTO PAIRING

4.1.2 UDP RetryThis feature adds a level of reliability to the UDP protocol without adding the complete overhead of TCP protocol. When enabled, the module waits for a response on every UDP packet that is sent (any UDP packet coming back in). If the module does not receive the response packet by approximately 250 ms, the same UDP packet is sent out. This process continues until either:• A UDP response is seen• A new UDP packet is sent from the module and is acknowledgedRefer to “set ip flags <mask>” on page 17 for which bit to set to enable this feature.

4.1.3 UDP BroadcastYou can set up the module to generate UDP broadcast packets automatically, which is useful for the following reasons:• Some access points disconnect devices that are idle. UDP broadcast informs the

access point that the module is alive and wants to stay associated.• Applications can use this feature to automatically discover and configure the mod-

ule. If an application is listening for the UDP broadcast, a number of useful param-eters are present in the package that can be used for auto-discovery. For example, the module’s IP address and port number are part of the packet, thus an application can connect to the module and remotely configure it.

• The associated access point’s MAC address, channel, and RSSI value are also available in this packet, enabling a simple location and tracking function.

By default, the module sends out a UDP broadcast to 255.255.255.255 on port 55555 at a programmable interval. You set the broadcast address, port, and interval using the set broadcast commands.

set ip host 0.0.0.0 // Set the host to 0.0.0.0set ip flags 0x40

Note: You can send the module’s sensor data out via UDP broadcast. The ana-log-to-digital convertor is 14 bits on a 400 mV signal, which translates to about 24 microvolts (0x61A80 in hex). When you use the show q com-mand in command mode, the module displays the raw readings. However, for HTTP web posting and UDP broadcast packets, the module shifts the reading by 4 bits (which is a divide by 16) resulting in a 16-bit number. Therefore, if you want the actual voltage sampled, you must take the 16-bit number and shift it left by 4 bits to get the number of microvolts. If you the value in millivolts (and do not need high accuracy), right shift by another 6 bits, which is the same as dividing by about 1K.


RN-WIFLYCR-UG

The packet is 110 bytes of data as shown in Figure 4-1.

FIGURE 4-1: UDP BROADCAST PACKET BYTE FORMAT

4.2 JOINING NETWORKS & MAKING CONNECTIONS

Configuring the module to make connections involves associating with an access point and opening a connection. Before you can configure the module over the WiFi link you must associate the module with a network and program the network settings. There-fore, the best method is to configure the module using the UART or over the air using ad hoc mode. This section describes how to configure the module over the UART using the RS-232 connector or an evaluation board. For this mode, open a terminal emulator on the COM port associated with the module. The default baud rate is 9,600, 8 bits, and no parity.To configure using ad hoc mode, refer to “Ad hoc Networking Mode” on page 89. Once in ad hoc mode, open a telnet window using the IP address 169.254.1.1 port 2000.

4.2.1 Associate with an Access Point From within the terminal window, put the module into command mode by typing $$$. The module responds with CMD, indication that it is in command mode. Type show net to display the current network settings as shown in Figure 4-2.

Note: To add sensor data to the UDP broadcast message you must enable the sensors using the sensor mask. The set q sensor 0xff command enables all sensors.

0 - 5 6 7 8 - 9 10 - 13 14 - 15 16 - 17 18 - 31 32 - 59 60 - 91 92 - 93 94 - 110

Programmable Device ID Set with set option deviceid <string> (32 Bytes)

Version String with Date Code (26 Bytes)

ASCII Time (13 Bytes)

GPIO Pin Value (2 Bytes)

Access Point’s MAC Address (6 Bytes)

Channel (1 Byte)

RSSI (1 Byte)

Local TCP Port (2 Bytes)

Pin 20’s Battery Voltage in mV, e.g., 2755 (2 Bytes)

RTC Value, MSB to LSB (4 Bytes)

Position

Sensor 0 - 7 Voltage Readings Enabled with set opt format <mask> (16 Bytes)

Boot Time in ms (2 Bytes)


RN-WIFLYCR-UG

FIGURE 4-2: DISPLAY CURRENT NETWORK SETTINGS

Find all available networks with the scan command as shown in Figure 4-3.

FIGURE 4-3: FIND AVAILABLE NETWORKS

If you are connecting to an open network, use the join command to associate with the access point. The scan list in Figure 4-3 shows that roving1 is an open access point. Type join roving1 (or join # 1) to associate with the network as shown in Figure 4-4.

FIGURE 4-4: JOIN THE NETWORK

If the access point is secure, you must set the pass phrase prior to issuing the join com-mand. The module attempts to inquire and determine the access point’s security pro-tocol; you do not need to set the authentication mode. To set the WPA pass phrase use the set wlan phrase <string> command. For WEP, set the key using the set wlan key <value> command.Once the module has joined the network successfully, it stores the access point’s SSID. You can save the SSID and the pass phrase to the configuration file so that the module can associate with the access point each time it boots.


RN-WIFLYCR-UG

4.3 MAKING CONNECTIONS

To connect to the module, open an IP socket and connect to the module’s IP address. You can use telnet to test the connection; type open <address> <port> in a telnet win-dow. After the connection is open, you can type characters into the UART window and see them on the telnet window or vise versa.

EXAMPLE 4-4: OPEN A CONNECTION

To make a connection from the module you need your server application’s IP address and port number. A COM port redirector is a simple program you can use to test this functionality. This software opens an IP port and transfers all data it receives to a spec-ified COM port on your machine. A free COM port redirector program for Windows is available from Pira at http://www.pira.cz/eng/piracom.htm. In your COM port redirector program, note your computer’s IP address, e.g., by typing the ipconfig command in the Microsoft Command Window. Go to your terminal emu-lator and put the module into command mode. Type the open <address> <port> com-mand. The server reports that the connection is open and you can type characters into the UART window and see them on the server window or vice versa.

4.3.1 Setting Up Automatic ConnectionsSome applications require the module to connect to a remote server, send data, and then disconnect automatically upon power up (or wakeup). You can configure the mod-ule to perform this functionality automatically. Set the network SSID and security, and set autojoin to 1. When the module wakes up or is powered on, the auto-connect timer causes the module to attempt a connection to the stored remote IP address and port. The sleep timer does not decrement while this connection is open and the idle timer does not decrement while data is flowing. When data stops for 5 seconds the connection is closed; the sleep timer puts the module in deep sleep. The wake timer begins the cycle again one minute later.

open 10.20.20.62 2000 // Open host shown in Figure 4-4

Note: You can also use ad hoc mode (autojoin 4); however, there will be a delay connecting to the ad hoc network from the remote computer. Therefore, make the sleep timer large enough to allow the network to get set up and the auto-connect to establish a TCP connection.


http://www.pira.cz/eng/piracom.htm

RN-WIFLYCR-UG

EXAMPLE 4-5: AUTOMATIC CONNECTION

4.3.2 Controlling Connections using GPIO5 & GPIO6You can use GPIO5 to control the TCP connection. After you configure the pin with the set sys iofunc command, the module attempts to connect to the stored IP address and port when GPIO5 goes high and disconnects when GPIO5 goes low.Similarly, you can monitor the connection status by reading GPIO6. When it goes high, the connection is open; when it goes low, the connection is closed. Use the command set sys iofunc command to enable GPIO6.

EXAMPLE 4-6: USE GPIO6 & GPIO6 TO CONTROL CONNECTIONS

4.3.3 Using DNS Settings The module contains a built-in DNS client. If you do not specify the host’s IP address, (i.e., it is set to 0.0.0.0), the module uses DNS protocol. When you set the host name using the set dns name <string> command, the module automatically attempts to resolve the host address. When the address is resolved, the module connects automat-ically.To manually look up a host’s IP address, use the lookup <string>command, where <string> is the hostname.

EXAMPLE 4-7: USE DNS

4.3.4 Using the Backup IP Address/Connect Function The module contains a feature for auto-retry and redundancy. If the host’s first IP address connection fails, the module uses the backup IP (if set). If this fails (or is not set), the module uses the first DNS name. If this fails (or is not set), the module uses the backup DNS name (if set).

EXAMPLE 4-8: SET THE BACKUP IP ADDRESS

set ip host <address> // Set up remote machine’s IP address set ip remote_port <value>// Set up the remote machine’s IP port set sys autoconn 1 // Automatically connect when readyset com idle 5 // Disconnect after 5 seconds with no data activityset sys sleep 2 // Sleep 2 seconds after connection is closedset sys wake 60 // Wake up after 1 minute of sleepset uart mode 2 // Use UART data trigger mode, which

// causes the module to make a // TCP/HTTP connection upon incoming // UART data (supported in firmware // version 2.19 and higher)

set sys iofunc 0x20 // Enable GPIO5 set sys iofunc 0x40 // Enable GPIO6

set dns name my_server // Set the DNS host name to my_server

set ip backup <address> // Set the backup IP address


RN-WIFLYCR-UG

EXAMPLE 4-9: SET THE BACKUP DNS NAME

4.4 USING THE HTML CLIENT FEATURE

The module has a built-in HTML client. When enabled, the module can get or post data to a web server. For example, you can use the HTML client to post serial and/or sensor data to the host web server. This feature makes possible to provide Wi-Fi capabilities to applications such as GPS units, remote sensors, weather stations, etc.

4.4.1 Retrieve Web Server DataIn this example, you want to retrieve data from the web server with the format:http://www.webserver.com/ob.php?obvar=WEATHERTo perform this function, use the following settings:set ip proto 18 // Enable the HTML clientset dns name www.webserver.com // Set the web server nameset ip address 0 // Turn on DNSset ip remote 80 // Set the web server port, 80 is standardset com remote 0 // Turn off the REMOTE string so that it

// does not interfere with the post To make the connection, use the open command or you can use open www.web-server.com 80. The user’s microprocessor writes the following string to the UART:GET /ob.php?obvar=WEATHER \n\n

Where the \n is the linefeed character (decimal 10 or hex 0xa). Two linefeeds are required for the web server to know the page is complete.

set dns backup <string> // Set the backup host name

Note: Some web servers require a carriage return and linefeed to indication the page is complete. In this case, use \r\n at the end of the string instead of \n\n.


RN-WIFLYCR-UG

4.4.2 Built-In HTML Client ModesYou can set up the module to post data to and get data from a web server automatically without an external host CPU. You enable these advanced web features using the set opt format <flag> command, where <flag> represents a bit-mapped register. Refer to “set opt format <flag>” on page 19 for the bit function descriptions. Table 4-1 describes the wake reason values.

EXAMPLE 4-10: HTML CLIENT MODES

4.4.3 Connect to a Web Server AutomaticallyYou can configure the module to post data to a webserver automatically using the set sys auto <value> command, where <value> is a decimal number representing sec-onds. For example, you can configure the module to connect to the web server every 10 seconds with the set sys auto 10 command. When HTTP mode is set, the module automatically appends two linefeeds (\n\n) to the end of the packet.

TABLE 4-1: WAKE REASON VALUESValue Wake Reason

0 Undefined.1 Power on or hardware reset (battery install or power up).2 Sleep (wake when the sleep timer is expired).3 Sensor.4 Undefined.5 Button (RN370 serial adapter only).6 Software reboot.7 Watchdog.

set option format 1 // Automatically send HTML data // header

set option format 7 // Append sensor data in ASCII hex // format

set option format 11 // Append all key value pairs to the // sensor data

Note: If the HTML header contains spaces, you must use the $ character to indi-cate spaces in the string. (A space is the command delimiter.) When the module’s command parser sees the $, it converts it to a space character.


RN-WIFLYCR-UG

EXAMPLE 4-11: CONNECT TO WEB SERVER EVERY 30 SECONDS

4.4.4 Connect to a Web Server Automatically when UART Data Is Received

The module supports a mode in which it can connect to the web server when it receives UART data.

EXAMPLE 4-12: CONNECT TO WEB SERVER WHEN UART DATA IS RECEIVED

Use the following commands to configure the module to connect to a web server every 30 seconds:set com remote GET$/ob.php?obvar=WEATHER

// Setup the HTML stringset sys auto 30 // Auto-connect every 30 seconds.set option format 1 // Send header automatically when

// connection is openset ip proto 18 // Turn on HTTP mode = 0x10 + TCP

// mode = 0x2

Note: If you attempt to send data by typing characters on the keyboard or if your microcontroller is not sending data fast enough, the module sends out small packets of data (it sends out many packets of small MTU size). To avoid this issue, set the flush timer to a higher value, e.g., set comm time 5000. By default, it is set to 10 ms.

set ip proto 18 // Turn on HTTP mode = 0x10 and // TCP mode = 0x2

set dns name www.webserver.com // Set the web server nameset ip host 0 // Turn on DNSset ip remote 80 // Set the web server port, 80 is

// standardset com remote GET$/userprog.php?DATA=

// Sample server application set uart mode 2 // Automatically connect using data

// trigger modeWhen the serial UART data comes in, the module automatically connects to the web server, and sends:GET /userprog.php?DATA= <users serial data> \n\n


RN-WIFLYCR-UG

4.4.5 Post Binary DataWeb servers expect ASCII data. If the user data is binary, the module can convert it to ASCII format before sending it to the web server.

EXAMPLE 4-13: EXAMPLE: CONVERT DATA FROM BINARY TO ASCII

4.4.6 Post Sensor Data AutomaticallyThe module can send the value of the GPIO and sensor pins to the web server auto-matically. The data arrives as 18 bytes of ASCII hex data in the format <2 bytes GPIO><channel 0 thru 7 sensor data>.

EXAMPLE 4-14: POST SENSOR DATA TO WEB SERVER



// standardset com remote GET$/userprog.php?DATA=

// Sample server applicationset option format 1 // Convert binary data to ASCII hex

// formatFor example, if the incoming UART data is 6 bytes of binary data with hex values 0x01, 0xAB, 0x03, 0xFF, 0x05, and 0x06, the module sends this string GET /user-prog.php?DATA=01AB03FF0506\n\n to the web server.

Note: The analog-to-digital convertor is 14 bits on a 400 mV signal, which trans-lates to about 24 microvolts (0x61A80 in hex). When you use the show q command in command mode, the module displays the raw readings. How-ever, for HTTP web posting and UDP broadcast packets, the module shifts the reading by 4 bits (which is a divide by 16) resulting in a 16-bit number. Therefore, if you want the actual voltage sampled, you must take the 16-bit number and shift it left by 4 bits to get the number of microvolts. If you the value in millivolts (and do not need high accuracy), right shift by another 6 bits, which is the same as dividing by about 1K.



// standard set com remote GET$/userprog.php?DATA=

// Sample server applicationset q sensor 0xff // Module samples all 8 sensor channelsset sys auto 30 // Connect every 30 seconds set option format 7 // Send the header plus the sampled

// binary data converted to ASCII format


RN-WIFLYCR-UG

The resulting string sent to the server is:GET /userprog.php?DATA=0F3000001111222233334444555566667777\n\nThe data format for this example is:

4.4.7 HTML Client Example: Posting Sensor Data AutomaticallyIn this example, the module connects to the web server at www.rovingnetworks.com/server.php?value= and posts the sensor data to the web server every 60 seconds. You set the network connections as described previously, and set additional parame-ters.set ip proto 18 // Turn on HTTP mode = 0x10 and TCP

// mode = 0x2set dns name www.rovingnetworks.com // Set the web server nameset ip host 0 // Turn on DNSset ip remote 80 // Set the web server port, 80 is standardset com remote GET$/server3.php?value=

// Set up the server application stringset sys auto 10 // Automatically connect every 10

// secondsset option format 7 // Send the header and sampled binary

// data converted to ASCIIset q sensor 0xFF // Set the sensor mask to sample all

// channelssave // Save the configuration to the config filereboot // Reboot so that the settings take effectAfter issuing these commands, the web server returns a 200 OK message, as shown in Figure 4-5.

2 Bytes GPIO

Channel 0 Channel 1 Channel 2 Channel 3 Channel 4 Channel 5 Channel 6 Channel 7

0F30 0000 1111 2222 3333 4444 5555 6666 7777


RN-WIFLYCR-UG

FIGURE 4-5: SERVER RESPONSE

You can view the data you sent to the Roving Networks web server at http://rovingnet-works.com/wiflys/view.

4.4.8 HTML Client Example: Posting UART Data to a Web serverThe module can post serial UART data in ASCII or binary format automatically. In this example, when the serial UART data comes in, the module connects and sends data to the web server in the following format:GET /server.php?value=<user serial data> \n\nUse the following commands to set the parameters:set ip proto 18 // Turn on HTTP mode = 0x10 and TCP

// mode = 0x2set dns name www.rovingnetworks.com // Set the web server nameset ip host 0 // Turn on DNSset ip remote 80 // Set the web server port, 80 is standardset com remote GET$/server3.php?value=

// Set up the server application stringset sys auto 10 // Automatically connect every

// 10 secondsset option format 1 // Send a HTML headerset uart mode 2 // Connect automatically using data

// trigger modesave // Save the configuration to the

// configuration filereboot // Reboot so that the settings take effect


http://rovingnetworks.com/wiflys/view


RN-WIFLYCR-UG

With these settings enabled, the module connects to the web server every time it receives data on the RX line. Serial data is sent to the host web server according to the flush timer and the flush size.

You can view the data you sent to the Roving Networks web server at http://rovingnet-works.com/wiflys/view.

4.5 UPGRADING FIRMWARE VIA FTP

The module has a file system for storing firmware and configuration files. Use the ls command to view files. The file size is displayed in sectors and the active boot image is identified in the final message. For example:FL# SIZ FLAGS 11 18 3 WiFly_GSX-2.21 29 1 10 config190 Free, Boot=11, Backup=0

You can store multiple firmware images and configuration files.

The module contains a built-in FTP client for downloading files and updating the firm-ware. The client uses passive mode FTP, which allows operation through firewalls and the Internet. To connect to Roving Networks to obtain the latest released firmware, use the settings shown in Table 4-2.

Note: You cannot append the sampled sensor data to the UART data. Enabling option format 7 with set uart mode 2 results in erroneous data.

Note: The module’s flash file system only is used to store firmware and configu-ration files. Currently, the file system cannot be used to store data files.

TABLE 4-2: FTP SETTINGSSetting Description

FTP server rn.microchip.com (set FTP server using the set dns backup <string> com-mand)

FTP username rovingFTP password Pass123FTP filename Refer to the following sections for the filename used in different versions of

firmware.FTP directory ./public (this parameter cannot be modified)

Note: Before using FTP to upgrade the firmware, the module must first be asso-ciated with an access point that is connected to the Internet.



RN-WIFLYCR-UG

4.5.1 Upgrading with Multiple Image Format Files (Firmware Versions 4.0 & Higher)

Firmware version 4.0 and higher introduces support for Multiple Image Format (.mif) files. .mif files contain the firmware image (.img) and associated applications and files to support all the features of firmware versions 4.0 and higher. Firmware versions 4.0 and higher can unpack the .mif file and install the applications and files into the mod-ule’s flash memory. Download the .mif file using the command:

•ftp update wifly3-400.mif// For RN131 module•ftp update wifly7-400.mif// For RN171 module

After downloading the .mif file, the module unpacks it and automatically reboots into the new boot image with all of the associated files installed into the module’s flash memory. Table 4-3 describes these files.

You can verify the firmware image, applications, and associated files in the flash mem-ory using the ls command. See Example 4-15.

EXAMPLE 4-15: LS COMMAND EXAMPLE OUTPUT

<3.07> lsFL# SIZ FLAGS 2 83576 3 WiFly_EZX-2.45 23 -1 10 config 25 85512 3 wifly-EZX-307 26 46624 3 wps_app-EZX-131 27 66248 3 eap_app-EZX-101 28 74280 3 web_app-EZX-105 29 37014 0 web_config.html 30 512 0 link.html 31 1609 0 logo.png149 Free, Boot=25, Backup=2<3.07>

TABLE 4-3: FIRMWARE & ASSOCIATED APPLICATIONS (VERISON 4.0 & HIGHER)

File Name Description Comments

wifly_EZX-2.45wifly-EZX-307wifly-EZX-400

Firmware image files (.img)

Filenames starting in wifly are typically firmware images.

wps_app-EZX-131 eap_app-EZX-101 web_app-EZX-105

Application files These application files are used for specific mod-ule features.

web_config.htmllink.html

HTML files These files are used for the configuration web server feature.

logo.png Logo file Logo displayed on web pages. Used for the con-figuration web server feature.

config Configuration file The config file stores the module’s boot up parameters.


RN-WIFLYCR-UG

4.5.2 Upgrading Firmware to Version 4.0To update the firmware from a version lower than 4.0, follow this process:1. Update the firmware .img file to version 4.xx using the command:

•ftp update wifly3-400.img// For RN131 module•ftp update wifly7-400.img// For RN171 moduleReboot the module to boot into the new image.

2. Download the .mif file using the command:•ftp update wifly3-400.mif// For RN131 module•ftp update wifly7-400.mif// For RN171 module

After the module downloads the .mif file, the module automatically reboots into the boot image with all of the associated files installed into the module’s flash memory. Refer back to Table 4-3 for a description of these files. You can verify the firmware image, applications, and associated files in the flash memory using the ls command (see Example 4-15).

4.5.3 Upgrading Firmware (Pre-Version 4.0)To update the firmware to a version lower than 4.0 (e.g., from version 2.45 to 3.07), issue the command ftp update <filename>, where <filename> is an optional filename (use the optional name to bypass the default firmware file name).The module retrieves the file and switches the boot image to the new file, resulting in the following messages: <2.20> ftp update<2.20> FTP connecting to 208.109.78.34FTP file=30.......................................................................FTP OK.

The previous firmware becomes the backup image. The following example shows the file system after a successful update:FL# SIZ FLAGS 11 18 3 WiFly_GSX-2.20 29 1 10 config 30 18 3 WiFly_GSX-2.21208 Free, Boot=30, Backup=11

NOTICE

You MUST reset the module to factory default settings at this point using the factory RESET and reboot commands.

Note: After the module reboots with the new firmware, Roving Networks recom-mends that you reset the module to the factory default parameters using the factory RESET command. Failure to do so may result in some variables being initialized with random values.


RN-WIFLYCR-UG

After downloading, the firmware checks the image and compares it to the stored values in the file before committing the image to flash and updating the boot record. If the checksum fails, the module displays UPDATE FAILED=x and deletes the image.

For example, to boot the previous image using the previous example:<2.20> boot image 11Set Boot Image 11, =OK

4.6 FTP CLIENT

In addition to downloading firmware via FTP, with firmware version 2.22 and higher, the module can get and put files to an FTP server.

4.6.1 Connect to an FTP ServerBy default, the module is configured to download the latest firmware from the Roving Networks’ FTP server. To configure the module to connect to your own FTP server, you must adjust the parameters as described in the example below.

EXAMPLE 4-16: CONNECT TO AN FTP SERVER

Note: You must reboot or power cycle the module to use the new firmware. To boot with different firmware, use the command boot image <value>, which sets the current boot image as <value>.

Note: After changing the boot pointer to the new image, you must reboot the mod-ule to boot up with the new image. Once the module boots up with the new image, perform a factory reset on the module to initialize all the parameters to the factory default settings. Then, you can reinitialize the parameters as required.

set ftp address <address> // Set FTP server’s IP address. Default// is 208.109.78.34

set ftp dir <string> // Set the directory in the FTP server. // Default is public.

set ftp user <string> // Set the user name set ftp pass <string> // Set the passwordsave // Save the settingsreboot // Reboot the module

Note: This example assumes that the FTP server is already set up and configured correctly and that the module is already configured to associate with a wire-less network.


RN-WIFLYCR-UG

4.6.2 Creating Files on the FTP ServerOnce the module is configured to connect to the FTP server, it can create files on the FTP server. To create a file, you use the ftp put <filename> command, where <file-name> is up to 64 bytes. This command creates a file on the FTP server with the name <filename> and prints the open string on the UART. By default, the open string is *OPEN*. After you see *OPEN* on the UART, you can begin writing data in to the file. There are two options to close the file: • Send the close string, which is *CLOS* by default. • Use the FTP close timer with the command set ftp timer <value>. Once you finish

writing to the file, this timer begins counting down and closes the file when the timer gets to zero. The timer is one eighth of <value>. For example, to set a 5-sec-ond timer, the command is set ftp timer 40.

The open and close stings are configurable using the following commands:set comm open <string> // Set the open stringset comm close <string> // Set the close string

EXAMPLE 4-17: PUT FILE ON FTP SERVER

4.6.3 Retrieving Files from the FTP ServerThe module can retrieve files from the FTP server. The retrieved file is not stored in module’s flash memory; the module acts as a transporter and passes the file over the UART interface as the file is being transferred. To retrieve a file from the FTP server issue the ftp get <filename> command. The mod-ule prints the open string on the UART and the file begins transferring from the FTP server to the module. When the file transfer complete, the module prints the close string indicating the file is transferred and the FTP connection is closed.

EXAMPLE 4-18: RETRIEVE FILE FROM FTP SERVER

4.7 WI-FI PROTECTED SETUP (WPS)

Wi-Fi Protected Setup (WPS) is a standard for easy and secure establishment of a wireless home network. This standard was created by the Wi-Fi Alliance and officially launched on January 8, 2007.The goal of the WPS protocol is to simplify the process of configuring security on wire-less networks. The protocol is meant to allow home users who know little of wireless security and may be intimidated by the available security options to configure Wi-Fi Protected Access, which is supported by all newer Wi-Fi certified devices (but not older Wi-Fi devices).

ftp put demo.txt // Upload the file demo.txtset ftp timer 40 // Close the connection 5 seconds after

// file uploads

ftp get demo.txt // Download the file demo.txt from the // FTP server


RN-WIFLYCR-UG

The most common mode of WPS is the Push Button Mode (PBC) in which the user sim-ply pushes a button on both the access point and the wireless client (e.g., the Roving Networks’ WiFly module). See Figure 4-6.

FIGURE 4-6: PUSH-BUTTON WPS

The module supports the WPS feature in firmware version 2.28 and higher. To upgrade to the current firmware version and download the WPS application, refer to the WPS application note on the Support page of the Roving Networks web site at http://www.rovingnetworks.com/Support_Overview.

FIGURE 4-7: CONFIRMING WPS APPLICATION IS INSTALLED

Note: Modules that ship with firmware version 2.28 or higher already have the WPS application. You can confirm whether your module has the application using the ls command. See Figure 4-7.




RN-WIFLYCR-UG

4.7.1 Launching a WPS ApplicationThere are two ways to invoke a WPS function:• Using the run wps command in the console.• Using the ad hoc/factory reset pin (GPIO9).To invoke a WPS function using the ad hoc/factory reset (GPIO9) mode:3. Enable the WPS function on GPIO9 using the set sys launch wps_app com-

mand. WPS on GPIO9 is disabled by default to avoid accidentally invoking the WPS function.

4. The WPS application is invoked when GPIO9 goes from low to high. You can enable this mode on the RN134 and RN174 boards by installing and removing the ad hoc/factory reset jumper or by pushing the board’s FN button.

When the WPS application launches, it negotiates the SSID and passphrase with the AP and reboots the module to associate with the WPS-enabled access point.

By default, during the WPS process, the module prints messages on the UART as it scans channels, detects access points, and tries to complete WPS. You can disable these messages using the set sys print 0 command.

4.7.2 Status LEDs during WPS ProcessIn WPS mode, the LEDs indicate activity:• The red LED flashes while the module is scanning for WPS-enabled access

points.• The yellow LED goes on solid while negotiation is in progress with a WPS-

enabled access point. If the process is successful, the WPS application quits and the module reboots.

• If the module is set to use the standard GPIO functions (i.e., not the alternate GPIO4 functions), the green LED blinks once per second. If the alternate GPIO4 function is enabled, the green LED goes high.

4.8 AD HOC NETWORKING MODE

There are two types of networks, infrastructure and ad hoc. Infrastructure networks, in which an access point links all Wi-Fi devices, are the most common. The access point keeps track of devices on the local network and directs IP packets. In many cases, the access point is also a router and forwards packets from the local network to other net-works and the Internet. It is also very common for the access point to run a DHCP server, which tracks and assigns IP addresses.Ad hoc networks are point-to-point networks in that each Wi-Fi device is linked directly to every other Wi-Fi device on the ad hoc network. There is no access point. All Wi-Fi devices on the ad hoc network participate in keeping the network alive and each keeps

Note: If GPIO9 is high, the module boots in ad hoc or soft AP mode, depending on the firmware version. Care must be taken to drive GPIO9 low before the module reboots. A good indicator is the red LED on the RN134 and RN174 boards. When this LED flashes, indicating the module is scanning for a WPS-enabled access point, you should drive GPIO9 low.


RN-WIFLYCR-UG

track of the other active devices on the network by sending and receiving beacon and probe packets. In most cases, IP addresses are assigned through automatic IP, although one of the Wi-Fi devices can be configured as a DHCP server.

4.8.1 Configuring Ad Hoc ModeYou can configure the module to setup an ad hoc network. This mode is useful for point-to-point communications. When in ad hoc mode the device appears like an access point with which other Wi-Fi devices can associate.

You can enable ad hoc mode via hardware or software commands.

4.8.1.1 ENABLE AD HOC MODE IN HARDWARE

To enable ad hoc mode using hardware, set GPIO9 high (3.3 V) at power up. For the RN134 board, GPIO9 is on pin 1 on the jumper block (J2). For the RN174 board, GPIO9 is on the J6 connector. Upon power up with GPIO9 high, the WiFly module cre-ates an ad hoc network with the following settings:SSID: WiFly-GSX-XX, where XX is the final two bytes of the device’s MAC

addressChannel: 1DHCP: OFFIP address: 169.254.1.1Netmask: 255.255.0.0With the ad hoc jumper in place, these settings override any current saved configura-tion settings.

4.8.1.2 ENABLE AD HOC MODE IN SOFTWARE

To enable ad hoc mode in software, you use the set wlan command with the join, ssid, and chan parameters. For example, type the following commands in command mode:set wlan join 4set wlan ssid my_adhoc_networkset wlan chan 1Turn off DHCP so that the module does not attempt to obtain an IP address from another device, and set the module’s IP address and netmask. Because automatic IP assignment fixes the first two bytes of the IP address, use 255.255.0.0 as the netmask

Note: Roving Networks supports ad hoc networking, however, going forward, ad hoc mode will be replaced with soft AP mode. Ad hoc mode and soft AP mode are mutually exclusive and cannot operate at the same time. The support for these modes resides in separate firmware images loaded on the module. By default, Roving Networks modules are shipped with the ad hoc mode image to maintain backwards compatibility with existing applications. Refer to “Access Point (AP) Mode” on page 45 for more information on AP mode.

Note: Currently the module only supports the OPEN mode for creating ad hoc networks.


RN-WIFLYCR-UG

so that other devices connecting to the module can be reached. You can also set the netmask to a smaller subnet if the other device’s IP addresses begin statically at the same subnet as the ad hoc device.set ip address 169.254.1.1set ip netmask 255.255.0.0set ip dhcp 0Save your configuration and reboot. The module will be in ad hoc mode.The module can associate with an ad hoc network created by another device. Type the commands:set wlan ssid my_adhoc_networksaverebootTo associate with an ad hoc network without saving the changes to the module’s flash memory, use the join command, e.g., join my_adhoc_network <cr>. (If the module was already associated with another network, you must first disassociate with it using the leave command.)If DHCP is enabled, the WiFly device obtains an IP address automatically when it asso-ciates with the ad hoc network. By definition, auto IP sets the first two bytes of the sub-net to 169.254.xxx.xxx. The WiFly device requires 2 to 3 seconds to resolve the IP address. To set the IP address statically, disable DHCP and explicitly assign the IP address:

set ip dhcp 0set ip address 169.254.1.2You can confirm that the device has properly associated with the ad hoc network using the ping keyword:

ping 169.254.1.1 10You can associate with the ad hoc network from a computer by specifying the network name (and password, if required) in the operating system. For example, choose Con-trol Panel > Networking and Sharing > Networking and Sharing Center (Windows Vista) or Control Panel > Network Connections (Windows XP). You can then view available networks and select the name of the WiFly ad hoc network.

Once your computer is associated with the ad hoc network, you can use the module’s IP address to open a connection or connect using telnet as you would with an enter-prise connection.

4.8.2 Scanning for Access Points in Ad Hoc ModeThe module supports ad hoc and infrastructure network modes, but not simultaneously. Scanning for wireless networks is a function of infrastructure mode. Therefore, the module disables ad hoc mode before scanning.

Note: Once associated with the ad hoc network, Windows Vista may require a few minutes to allocate an IP address. To work around this issue, assign a static IP address under Network Settings > TCP/IP > Properties.


RN-WIFLYCR-UG

With firmware version 2.22 and higher, the module can scan for networks while in ad hoc mode. Issuing the scan command temporarily disables ad hoc model while the module is scanning. Ad hoc mode is restored automatically when the scan completes. If you are connected to the module over telnet, the scan result is sent over telnet and ad hoc mode is restored.

4.9 ANALOG SENSOR CAPABILITY

The module has 8 analog sensor inputs that can be driven between 0 to 1.2-V DC. You can sample the analog inputs and read digital value using the show q <value> com-mand, where <value> is a decimal number representing the channel. See “show q <value>” on page 38 for more details.

The channel is the analog sensor input from 0 to 7. The value for the analog sensor input is measured in microvolts and is returned as 8xxxxx, where the beginning 8 is a start marker.You can also sample multiple channels by using a bit mask using the show q 0x1 <mask> command, where <mask> is a bit mask of the channels. See “show q 0x1<mask>” on page 38 for more details.

EXAMPLE 4-19: READ CHANNELS 0, 1 & 7

The results are in the format 8<channel 0>, 8<channel 1>, 8<channel 7>\r\nThe analog input hardware specification is: Input voltage range:0 - 1.2 V, however, the analog-to-digital converter saturates at

400 mVResolution: 14 bits = 12 uVSampling frequency: 35 usAccuracy: 5% un-calibrated The accuracy of each analog sensor reading can be offset by up to 5% due to variations from chip to chip. To improve accuracy, Roving Networks recommends using a preci-sion reference voltage on one of the analog inputs to calculate the offset. The offset is the same for all analog inputs. For example: • Drive precision 200 mV reference on analog input 4.• Read analog input 4 and compute the offset. If you read 210 mV you know that the offset is +10 mV. When you read input 5, subtract 10 mV from the result.

4.9.1 Sampling Sensor Pins AutomaticallyThe sensor pins can be sampled automatically and data forwarded in two modes:• The UDP broadcast packet can contain the sample values.• In HTTP mode, the sampled pin data can be forwarded to a remote server

WARNING

Driving these inputs above 1.2 V can permanently damage the module.

show q 0x183 // Read channels 0, 1, and 7


RN-WIFLYCR-UG

To enable these modes, use the set q sensor <mask> command.

EXAMPLE 4-20: SAMPLE ALL SENSOR INPUTS

4.9.2 Using the Built-In Sensor PowerThe modules contain an on-board sensor power pin, which is controlled by the set q sensor <mask> command. <mask> is a bit mask value that determines which sensor pins to sample when sending data using the UDP broadcast packet or the HTTP auto-sample function. See “set q sensor <mask>” on page 21 for more details.

Firmware versions 2.23 and higher support the set q power <value> command. This command sets an 8-bit register with two 4 bit nibbles that automatically turns on the sensor power. See “set q power <value>” on page 21 for more details on using this command.

set q sensor 0xff // Sample all sensor inputs

Note: In versions of firmware prior to 2.23, this command is named set option sensor.


RN-WIFLYCR-UG

NOTES:


RN-WIFLYCR-UG

Appendix A. Default ConfigurationThis section describes the default configuration settings and how to restore them.

A.1 ADHOC PARAMETERS

Beacon 102 (milliseconds) for ad hoc mode onlyProbe 5 (seconds to look for beacons before declaring ad

hoc is lost) for ad hoc mode onlyReboot 0, for adhoc mode only

A.2 BROADCAST PARAMETERS

IP address 255.255.255.255Port 55555Interval 7 (seconds)Backup address0.0.0.0Backup port0

A.3 COMM PARAMETERS

Close string*OPEN*Open string *CLOS*Remote string *HELLO*Flush size 1420Match character 0Flush timer 10 (milliseconds)Idle timer 0Cmd char $

A.4 DNS PARAMETERS

IP address 0.0.0.0Name dns1Backup rn.microchip.com Lease 86400 for soft AP mode only

A.5 FTP PARAMETERS

Server address 0.0.0.0 File Firmware only:

wifly-GSX-<version>.img (RN131)wifly-EZX<version>.img (RN171)Firmware and applications:wifly3-<version>.mif (RN131)wifly7-<version>.mif (RN171)

User roving


RN-WIFLYCR-UG

Password Pass123Dir publicTimeout 200FTP_mode 0x0

A.6 IP PARAMETERS

DHCP ON (1 = enabled)IP address 0.0.0.0Net mask 255.255.255.0Local port 2000Gateway 0.0.0.0Host 0.0.0.0Remote port 2000Protocol 2 (TCP server and client)MTU 1524Flags 0x7TCP mode 0x0Backup 0.0.0.0

A.7 OPTIONAL PARAMETERS

Device ID WiFly-GSXJoin timer/WPA timer 1000Replacement char $ (0x24)Format 0x00Password “” (no password enforced)Signal 0Average 5

A.8 SYSTEM PARAMETERS

Sleep timer 0 Wake timer 0Trigger 0x1 (SENS0 pin wakes up the device)Auto connect 0IOfunc 0x0 (No alternate functions)IOmask 0x20F0 (for RN131) / 0x21F0 (for RN171)IOvalue 0x0Print level 0x1 (Print enabled)Debug Register 0x0 (Unused parameter for future development.

Leave at default value)LaunchString web_app


RN-WIFLYCR-UG

A.9 TIME SERVER PARAMETERS

Enable 0 (disabled)Server address 64.90.182.55 (fixed to port 123 - SNTP protocol)Zone 7 (Pacific time, USA)

A.10 UART PARAMETERS

Baudrate 9600Flow 0 (disabled)Mode 0 Cmd_GPIO 0

A.11 WLAN PARAMETERS

SSID roving1Channel 0 (Automatic scan)External antenna 0 (Off - use on-board chip antenna for RN131 ONLY)Join mode 1 (Automatically scan and join based on SSID) for

firmware version 2.36 (ad hoc mode) and lower0 for firmware version 2.45 (soft AP mode) and higher

Authentication mode OPENMask 0x1FFF (All channels)Rate 12 (24 Mbit)Linkmon 0Passphrase rubygirlTX Power 0 (which implies 12 dBm. Applicable to RN171 mod-ule only)

A.12 STRING VARIABLE SIZES

Table A-1 provides the string variable sizes for the following parameters:TABLE A-1: STRING VARIABLE SIZES

Parameter Value (Bytes)

FTP Parametersfile 32user 16pass 16dir 32wlan Parametersssid 32phrase 64DNS ParametersDNS host name 64DNA backup host name 64


RN-WIFLYCR-UG

A.13 RESTORING DEFAULT CONFIGURATION SETTINGS

You can restore the default factory configuration settings in software and hardware. • Software—In command mode, use the factory RESET command to restore the

defaults. This command automatically loads the default settings and executes a save command. Next, send the reboot command so that the module reboots with the default configuration.

• Hardware—Set GPIO9 high on power up to arm the factory reset function. Then toggle GPIO9 five (5) times, which restores the configuration to the factory reset. GPIO9 is sampled at about 1 Hz; therefore, if you are using a CPU to generate the signal, make sure that GPIO9 transitions (high to low or low to high) are at least 1 second long.

You can specify a user configuration file as the factory reset settings. Prior to this firm-ware version only the hardcoded factory defaults would be restored. If you have stored a configuration file named user, the module reads it as the factory default instead of using the factory hardcoded defaults. If no user configuration file is present, the module uses the hardcoded factory defaults. You create the user configuration file using the save user command, which saves the current configuration settings into a file named user.Even if a user configuration file exists, arming and toggling GPIO9 7 times overrides the user settings and restores the module to the factory hardcoded defaults. This bypass mechanism allows you to restore the factory defaults in case a bad configura-tion is saved into the user file.Issuing the factory RESET command while in command mode restores the module to a factory default state.

comm Parametersopen 32close 32remote 64deviceid 32

TABLE A-1: STRING VARIABLE SIZESParameter Value (Bytes)

Note: You must reboot the module or reset it for the new settings to take effect.


RN-WIFLYCR-UG

Appendix B. Boot-Up Timing ValuesTable B-1 shows the boot-up timing values.

TABLE B-1: BOOT-UP TIMING VALUESFunction Description Time (ms)

Power up Power up time from reset high or power good to boot code loaded. 70Initialization Initialize ECOS. 50Ready Load configuration and Initialize application 30Join Associate using channel = 0 (full channel scan, mask = 0x1FFF). 80

Associate using channel = 0 (primary channel scan, mask = 0x421). 15Associate using channel = X (fixed channel). 5 - 20

Authentication Authenticate using WPA1 or WPA2 (highly dependent on access point response). 50 - 250Acquire IP DHCP obtain IP address (highly dependent on DHCP server response time). AP dependent


RN-WIFLYCR-UG

NOTES:


RN-WIFLYCR-UG

Appendix C. Supported Access PointsThe module should work with any standard access point. Roving Networks has tested the module with the following access points:• Cisco Aeronet series• Linksys (both standard and open WRT Linux) • Netgear WGR614 v8 , WNDR3700 v3.0• Netgear WGN54• DLINK dir-615 • Airlink 101• Apple Airport express• Buffalo networks• Belkin F7D3302 v1.0• Asus RT-N16• TPLink TL-WR741ND• SMC SMCWBR14S-N4• DYNEX DX-WGRTR• Ad hoc mode (Apple iPhone, Microsoft Windows PC with XP, Vista, Ubuntu

Linux)Roving Networks currently does not support WPA2-Enterprise (radius server authenti-cation, EAP-TLS)


RN-WIFLYCR-UG

NOTES:


RN-WIFLYCR-UG

Appendix D. Command Quick Reference GuideTable D-1 through Table D-5 provide a listing of all available commands and their defaults. For more detailed information refer to “Command Reference” on page 9.

TABLE D-1: SET COMMAND LIST (SHEET 1 OF 4)Command Default Description

set adhoc beacon <value> 102 Sets the ad hoc beacon interval in milliseconds.set adhoc probe <value> 5 Sets the ad hoc probe timeout in seconds (ad hoc mode only).set adhoc reboot <value> 0 Sets the reboot timer.set broadcast address <address>

255.255.255.255 Sets the address to which the UDP hello/heartbeat message is sent.

set broadcast backup <address>

0.0.0.0 Sets the secondary broadcast backup address.

set broadcast interval <mask> 7 Sets the interval (in seconds) at which the hello/heartbeat UDP message is sent.

set broadcast port <value> 55555 Sets the port to which the UDP hello/heartbeat message is sent.

set broadcast remote <port> 0 Sets the secondary broadcast port.set comm $ <char> $ Sets character used to enter command mode to <char>.set comm close <string> *CLOS* Sets the ASCI string that is sent to the local UART when the

TCP port is closed.set comm idle <value> 0 Sets the idle timer value in seconds.set comm match <value> | <hex>

0 Sets the match character in hex or decimal.

set comm open <string> *OPEN* Sets the ASCI string that is sent to the local UART when the TCP port is opened.

set comm remote <string> *HELLO* Sets the ASCI string that is sent to the remote TCP client when the TCP port is opened.

set comm size <value> 64 Sets the flush size in bytes.set comm time <value> 5 Sets the flush timer.set dhcp lease <value> 86400 Sets the soft AP mode DHCP lease time in seconds.set dns address <address> 0.0.0.0 Sets the IP address of the DNS sever.set dns backup <string> rn.microchip.com Sets the name of the backup host for TCP/IP connections to

<string>.set dns name <string> server1 Sets the name of the host for TCP/IP connections to <string>.set ftp addr <address> 0.0.0.0 Sets the FTP server’s IP address of the FTP server.set ftp dir <string> public Sets the starting directory on the FTP server.set ftp filename <filename> See description Sets the name of the file that is transferred when issuing the

ftp u command, where <filename> is the firmware image. Firmware version 4.0 default is wifly3-<version>.img (RN131) wifly7-<version>.img (RN171).Firmware prior to 4.0 default is wifly-GSX-<version>.img (RN131) wifly-EZX-<version>.img (RN171).

set ftp pass <string> Pass123 Sets the password for accessing the FTP server.set ftp mode <mask> 0x0 Sets the ftp mode, where <mask> indicates active or passive

mode. Default is passive.set ftp remote <value> 21 Sets the FTP server’s remote port number.


RN-WIFLYCR-UG

set ftp time <value> 200 Sets the FTP timeout value, where <value> is a decimal num-ber that is five times the number of seconds required.

set ftp user <string> roving Sets the user name for accessing the FTP server.set ip address <address> 0.0.0.0 Sets the WiFly module’s IP address.set ip backup <address> 0.0.0.0 Sets a secondary host IP address.set ip dhcp <value> 1 Enables/disables DHCP mode.set ip flags <mask> 0x7 Sets the TCP/IP functions.set ip gateway <address> 0.0.0.0 Sets the gateway IP address.set ip host <address> 0.0.0.0 Sets the remote host’s IP address.set ip localport <value> 2000 Sets the local port number.set ip netmask <address> 255.255.255.0 Sets the network mask.set ip protocol <flag> 2 Sets the IP protocol.set ip remote <value> 2000 Sets the remote host port number.set ip tcp-mode <mask> 0x0 Controls the TCP connect timers, DNS preferences, and

remote configuration options.set opt average <value> 5 Sets the number of RSSI samples used to calculate the running

RSSI average.set opt deviceid <string> WiFly-XXX Sets the configurable device ID, where XXX is GSX for the

RN131 and EZX for the RN171.set opt format <flag> 0x00 Sets the HTTP client/web server information.set opt jointmr <value> 1000 Sets the join timer, which is the length of time (in ms) the join

function waits for the access point to complete the association process.

set opt replace <char> $ (0x24) Sets the replacement character you use to indicate spaces in the SSID and pass phrases, where <char> is a single charac-ter.

set opt password <string> “” (no password required)

Sets the TCP connection password.

set opt signal <value> 0 Configures the threshold level for the RSSI value in infrastruc-ture mode.

set q power <value> 0 Automatically turns on the sensor power.set q sensor <mask> 0 Specifies which sensor pins to sample when sending data

using the UDP broadcast packet or the HTTP auto sample function.

set sys autoconn <value> 0 Sets the auto-connect timer in TCP mode.set sys autosleep <value> 0 Sets the auto-sleep timer in UDP mode.set sys iofunc <mask> 0x0 Sets the I/O port alternate functions.set sys launch_string <string> web_app Sets the application to launch when GPIO9 is high after pow-

erup.set sys mask <mask> 0x20F0 (RN131)

0x21F0 (RN171)Sets the I/O port direction.

set sys printlvl <value> 0x1 Controls the debug print messages printed by the WiFly mod-ule on the UART.

set sys output <mask> <mask> None sets the output GPIO pins high or low. The optional <mask> sets a subset of the pins.



RN-WIFLYCR-UG

set sys sleep <value> 0 Sets the sleep timer.set sys trigger <flag> or <mask>

0x1 With this parameter setting, the module wakes from sleep state using the sensor input 0, 1, 2, and 3.

set sys value <mask> 0x0 Sets the default value of the GPIO pins’ outputs upon power-up.

set sys wake <value> 0 Sets the automatic wake timer in seconds.set time address <address> 64.90.182.55 Sets the time server address.set time enable <value> 0 Tells the module how often to fetch the time from the specified

SNTP time server in minutes.set time port <value> 123 Sets the time server port number.set time raw <value> None Allows you to set the RTC raw value from the console in sec-

onds.set uart baud <value> 9600 Sets the UART baud rate, where <value> is 2400, 4800, 9600,

19200, 38400, 57600, 115200, 230400, 460800, or 921600.set uart flow <value> 0 Sets the flow control mode and parity.set uart instant <value> Not applicable Immediately changes the baud rate, where <value> is 2400,

4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, or 921600.

set uart mode <mask> 0 Sets the UART mode register.set uart raw <value> Not applicable Sets a raw UART value.set uart tx <value> Not applicable Disables or enables the UART’s TX pin (GPIO10), where

<value> is 1 or 0.set wlan auth <value> 0 Sets the authentication mode.set wlan channel <value> <flag>

0 Sets the WLAN channel, where <value> is a decimal number from 1 to 13 representing a fixed channel and <flag> is the optional character i (meaning immediate).

set wlan ext_antenna <value> 0 Determines which antenna is active, where <value> is 0 (use the chip antenna) or 1 (use the U.FL connector).

set wlan fmon <value> 3600 Sets the soft AP mode link monitor timeout threshold for the associated client device.

set wlan id <string> – Reserved for future. use.set wlan hide <value> 0 Hides the WEP key and WPA passphrase, where <value> is 0

or 1.set wlan join <value> 1|0 Sets the policy for automatically associating with network

access points.set wlan key <value> Not applicable Sets the 128-bit WEP key, where <value> is EXACTLY 26

ASCII chars (13 bytes) in hex without the preceding 0x.set wlan linkmon <value> 0 (disabled) Sets the link monitor timeout threshold, where <value> is a

decimal number representing the number of failed scans before the module declares AP is Lost and de-authenticates.

set wlan mask <mask> 0x1FFF (all chan-nels)

Sets the WLAN channel mask, which is used for scanning channels with auto-join policy 1 or 2).

set wlan phrase <string> rubygirl Sets the passphrase for WPA and WPA2 security modes.set wlan number <value> 0 Sets the WEP key number.set wlan rate <value> 12 Sets the wireless data rate.



RN-WIFLYCR-UG

set wlan ssid <string> roving1 Sets the SSID with which the module associates.set wlan tx <value> 0 Sets the Wi-Fi transmit power, where <value> is a decimal

number from 1 to 12 that corresponds to 1 to 12 dBm.set wlan user <string> – Reserved for future use.

TABLE D-2: GET COMMANDS Command Description

get adhoc Displays the ad hoc settings.get broadcast Displays the broadcast UPD address, port, and interval.get com Displays the communication settings.get dns Displays the DNS settings.get everything Displays all of the configuration settings, which is useful for debugging.get ftp Displays the FTP settings.get ip <char> Displays the IP address and port number settings, where <char> is the optional parame-

ter a. Using <char> returns the current IP address.get mac Displays the device’s MAC address.get option Displays the optional settings such as the device ID.get sys Displays the system settings, sleep and wake timers, etc.get time Displays the time server UDP address and port number.get wlan Displays the SSID, channel, and other WLAN settings.get uart Displays the UART settings.ver Displays the firmware version.

TABLE D-3: STATUS COMMANDSCommand Description

show battery Displays current battery voltage, and is only applicable to Roving Networks’ battery-pow-ered products such as the RN370 and temperature sensors (ISENSOR-CB).

show connection Displays the connection status in the hex format 8<XYZ>.show io Displays the GPIO pins’ level status in the hex format 8<ABC>.show net <char> Displays the current network status, association, authentication, etc., where <char> is the

optional parameter n. Using the n parameter displays only the MAC address of the access point with which the module is currently associated.

show q <value> Displays the value of the analog interface pin, where <value> is 0 to 7.show q 0x1<mask> Displays multiple analog interface values simultaneously.show rssi Displays the last received signal strength.show stats Displays the current statistics, packet RX/TX counters, etc.show time Displays the number of seconds since the module was last powered up or rebooted.

TABLE D-4: ACTION COMMANDSCommand Description

$$$ Use this command to enter command mode.apmode <bssid> <chan-nel>

Creates a soft AP network.



RN-WIFLYCR-UG

close Disconnects a TCP connection.exit Exits command mode.factory RESET Loads the factory defaults into the module’s RAM and writes the settings to the standard

configuration file. You must type the word RESET in capital letters.join <string> Instructs the WiFly module to join the network indicated by <string>.join # <value> Use this command to join a network that is shown in the scan list, where <value> is the

entry number listed for the network in the scan list.leave Disconnects the module from the access point to which it is currently associated.lookup <string> Causes the module to perform a DNS query for host name <string>.open <address> <value> Opens a TCP connection to <address>, where <value> is the port number.ping <string> <value> Pings a remote host, where <string> is a parameter setting and <value> is the number of

pings. The default is 1 packet.reboot Forces the module to reboot (similar to a power cycle).run Runs an application using ASCII commands.scan <value> <char> Performs an active probe scan of access points on all 13 channels. The default is 200

ms/channel.sleep Puts the module to sleep.time Sets the real-time clock by synchronizing with the time server specified with the time

server (set time) parameters.

TABLE D-5: FILE I/O COMMANDSCommand Description

del <string> <value> Deletes a file.load <string> Reads in a new configuration file.ls Displays the files in the system.save <string> Saves the your configuration settings to a file.boot image <value> Makes a file represented by <value> the new boot image.ftp update <string> Deletes the backup image file, retrieves a new image file, and updates the boot pointer to

the new image.

TABLE D-4: ACTION COMMANDSCommand Description


RN-WIFLYCR-UG

NOTES:


RN-WIFLYCR-UG

Appendix E. Known ProblemsThe firmware has the following known issues:• Flow control—RTS may fail to de-assert quickly enough for some high-speed

CPUs to stop sending data bytes correctly. For high-speed transfers at baud rates greater than 460,800, Roving Networks recommends limiting the RX data to the maximum Ethernet frame (1,460 bytes) and using a protocol to acknowledge that the remote host receives the data.


RN-WIFLYCR-UG

NOTES:


RN-WIFLYCR-UG

Appendix F. Current Firmware Features & FixesF.1 VERSION 4.00.1 4/19/2013

F.1.1 Features• Added a new feature to indicate the number of clients associated with the module

in soft AP mode in the UART heartbeat message.

F.1.2 Bug Fixes & Improvements• Fixed an issue in which the GPIO4, 5, and 6 alternate mode was not working.• Fixed an issue in which the link monitor was not working in infrastructure mode

when auto join to a wireless network is disabled (set wlan join 0).• Fixed an issue in which a null device ID was not reset to factory defaults when the

factory reset command is issued.• Fixed an issue in the FTP update process in which the module would watchdog

when the module flash does not have enough free sectors.• Fixed an issue in which the show rssi command was not working in infrastructure

mode when auto join to a wireless network is disabled (set wlan join 0).• Fixed an issue in soft AP mode wherein the scan command would not work the

first time.• Added stability to the FTP client mode.

F.2 VERSION 4.0 3/27/13

F.2.1 Features• Added support for Multiple Image Format (.mif) files to download multiple images.

This new file format contains the firmware image, applications such as WPS, EAP, web server, and supporting page files.

• The firmware image supports unpacking the files contained in the .mif package• Added a secondary UDP broadcast packet to send the UDP discovery message

to a secondary server. The size of the secondary packet is 120 bytes (110 bytes of primary broadcast + 6 byte module’s MAC address + 4 byte module’s IP address)

• Added a new link monitor variable for soft AP mode. It is configurable via the set wlan fmon <seconds> command.

• Added a new configuration web server application onto the module for provision-ing/configuring the module to join an infrastructure network.

• Added a new command to launch soft AP mode network: apmode <bssid> <channel>

• Added a new command to launch different applications when GPIO9 is driven high, set system launch_string <string>. Examples:- set sys launch_string web_app // Launches web server (default)- set sys launch_string wps_app // Launches WPS app- set sys launch_string eap_app // Launches EAP app

• Added the command run <string> to launch individual applications. Example:run wps


RN-WIFLYCR-UG

• Deprecated the wps command.

F.2.2 Bug Fixes• Fixed a bug wherein the UART would occasionally lock up upon performing the

factory RESET command and while telnet session was in progress.• Fixed a bug in soft AP mode wherein the module would close the TCP connection

upon another client being deauthorized.• Fixed an issue with the link monitor in AP mode to correctly age out stale clients.• Fixed an issue that would cause the module to crash due to a high-speed optimi-

zation error.

F.3 VERSION 2.36/2.45 9/14/2012

• Firmware versions 2.36 and 2.45 are being shipped together. Version 2.36 sup-ports ad hoc mode, while version 2.45 supports soft AP mode. All modules shipped with these firmware versions will run version 2.36 by default to maintain backward compatibility with previous firmware versions.

You can change the firmware image using the boot image <value> command. After you change the boot image, you MUST reset the module back to the factory defaults using the factory RESET and reboot commands.- Wifly_EZX-236.img—Ad hoc mode firmware for RN-171

Wifly_GSX-236.img—Ad hoc mode firmware for RN-131- Wifly_EZX-245.img—Soft AP mode for RN-171

Wifly_GSX-245.img—Soft AP mode for RN-131• In firmware version 2.36 (ad hoc version), the auto join feature is enabled to main-

tain backwards compatibility. In version 2.45, auto join is disabled and you must explicitly enable auto join mode using the set wlan join 1 command.

• The firmware now supports parity with the set uart flow command.• Added the i flag to the set wlan channel command, which changes the channel

immediately. You can use this feature to go into AP mode without having to reboot or save the settings.

• In AP mode, de-authentication with the link monitor closes the TCP connection, flushes the UART buffer, and tries to clear stuck RTS flow control.

• In some cases flow control can get “stuck,” e.g., during a tcp_close or de-authen-tication in which the UART cannot transmit a TCP packet and is holding it. Added a fix to attempt to clear the buffer.

• In previous firmware, the associated status is always set even if no clients are joined. In version 2.45, the red LED correctly shows the status if there are no devices joined. If you use ALTERNATE IO for associated, it is high if there are 1 or more clients, and low if there are no clients.

• In AP mode, the module supports 7 connections (DHCP and AP).• Fixed an issue with the ping command.

F.4 VERSION 2.30 10/26/2011

• Added support for incorrect WPA modes, namely WAPv1 with AES encryption


RN-WIFLYCR-UG

and WPAv2 with TKIP encryption.• Added support for WEP shared mode• Increased FTP filename size to 64 bytes• Added a new reboot register in ad hoc parameters. This register is reserved for

future development and should not be used. Please leave it to default values.• Added a new debug register in the system parameters. This register is reserved

for future development and should not be used. Please leave it to default values.

F.5 VERSION 2.27 09/08/11

• Added support for Wi-Fi Protected Setup (WPS) push button mode• Added support for WEP64 encryption• Added support for backup IP address• Added a new TCPMODE register to control TCP connect timers, force DNS and

remote configuration• Added new bit in UART mode register (bit 5) in which replaces the <2.23>\r\n in

console with the replace character• Fixed the FTP file “put” mode so it over rides HTTP mode. In version 2.23 if HTTP

protocol is set and/or option format is set, extra data would be added to FTP put file data. This has been fixed in version 2.28.

• Fixed a bug where if the TCP_CLIENT mode is set, the module would randomly attempt outgoing connections.

• Fixed a bug in FTP data write mode whereby sometimes the *OPEN* status string came back over the UART before the file transfer was actually ready. This fix also improves the speed of FTP open in write mode, such that the *OPEN* will be faster.

F.6 VERSION 2.23 04/03/2011

• Created new set of sensor commands: set q sensor <mask> and set q sensor <value>. Also, sensor power can now be configured and applied either only when sampling of sensor inputs occur or at power up and removed upon power down and sleep.

• Added a new FTP client mode to get and put files to a FTP server. Files retrieved from the server are sent over the UART and files created from the UART are stored on the FTP server.

• A new scan output format is implemented in addition to the default output format. This new microprocessor friendly format makes string processing of the scan out-put very easy.

• A new UART heartbeat feature is implemented to notify the embedded micropro-cessor of the state of the WiFly module. The heartbeat message is sent over the UART when the WiFly module is in data mode and not connected to any remote host.

• Fixed a bug in the set uart instant <value> command wherein the WiFly module would not return an AOK over telnet. Now when this command is issued, it returns an AOK over telnet and does not exit command mode.

• Enabled scanning for wireless networks remotely when in ad hoc mode. When the


RN-WIFLYCR-UG

scan command is issued, ad hoc is temporarily disabled and results of the scan are sent over telnet.

• The behavior of the auto connect timer has changed. • Added the ability to set RTC from console.• Added a feature wherein the module can be put to sleep using GPIO8.

F.7 VERSION 2.21 07/11/2010

• The firmware checksum the image (and compare to the stored values in the file) now before committing it to flash and updating the boot record after download. If the checksum fails firmware prints “UPDATE FAILED” and deletes the image.

F.8 VERSION 2.20 06/14/2010

F.8.1 Fixes• Passphrase is now accepts up to 64 chars. A bug introduced in 2.19 causes the

wlan passphrase to be truncated to 32 characters (making it impossible to enter a 32 byte HEX literal PSK).

• Fixed DHCP status when link to Access Point (AP) is lost. It was still reporting DHCP OK. It is now cleared and new DHCP session will start once AP link is reestablished).

• Fixed a bug whereby UDP receive becomes disabled (no packets are received) if AP-LOST and then re-established.

• Improved handling of AP disconnect, and AP link lost due to linkmon timeout or other disconnect.

• If TCP connection was active, connection could be in hung/incorrect state, and once AP is regained in some cases this would not recover. This has been fixed in this version. Refer section set ip flags <value> for more information.

• Added new setting to the UART mode set uart mode 0x10.

F.8.2 Features• Disabled the auto-join feature when in command mode. Auto-join causes the

WiFly module to become unresponsive to $$$ or commands during the period when auto-joining, when auto-joining is failing do to non-existent AP, making it hard to process or interpret commands. Once command mode is exited, auto join will re-enable.

• There are new levels of print out diagnostics that can be enabled/disable with the sys print variable.

• Ability to add prefix to HTML client post, specifically the ability to append &id= and &rtc= in the HTML message.


RN-WIFLYCR-UG

Appendix G. Document InformationCONVENTIONS USED IN THIS GUIDE

This manual uses the following documentation conventions:DOCUMENTATION CONVENTIONS

Description Represents Examples

Arial font:Italic characters Referenced books MPLAB® IDE User’s Guide

Emphasized text ...is the only compiler...Initial caps A window the Output window

A dialog the Settings dialogA menu selection select Enable Programmer

Quotes A field name in a window or dialog

“Save project before build”

Underlined, italic text with right angle bracket

A menu path File>Save

Bold characters A dialog button Click OKA tab Click the Power tab

N‘Rnnnn A number in verilog format, where N is the total number of digits, R is the radix and n is a digit.

4‘b0010, 2‘hF1

Text in angle brackets < > A key on the keyboard Press <Enter>, <F1>Courier New font:Plain Courier New Sample source code #define START

Filenames autoexec.bat

File paths c:\mcc18\h

Keywords _asm, _endasm, staticCommand-line options -Opa+, -Opa-

Bit values 0, 1

Constants 0xFF, ‘A’Italic Courier New A variable argument file.o, where file can be

any valid filenameSquare brackets [ ] Optional arguments mcc18 [options] file

[options]Curly braces and pipe character: { | }

Choice of mutually exclusive arguments; an OR selection

errorlevel {0|1}

Ellipses... Replaces repeated text var_name [, var_name...]

Represents code supplied by user

void main (void){ ...}


RN-WIFLYCR-UG

RECOMMENDED READING

This user’s guide describes how to configure the RN131 and RN171 modules. The mod-ule-specific data sheets contain current information on the module specifications. Other useful documents are listed below. The following Microchip documents are available and recommended as supplemental reference resources:

RN131G & RN131C 802.11 b/g Wireless LAN Module Data SheetThis data sheet provides detailed specifications for the RN131 module.

RN171 802.11 b/g Wireless LAN Module Data SheetThis data sheet provides detailed specifications for the RN171 module.

Lab Manual for RN174 Evaluation BoardThis lab manual provides instruction on configuring WiFly modules. The manual uses the RN174 evaluation board, which contains the RN171 module, to demonstrate a vari-ety of applications.To obtain any of these documents, visit the Microchip web site at www.microchip.com.

DOCUMENT REVISION HISTORY

Revision 1.0r (September 2012)This is the initial released version of the document.

Revision 1.1r (March 2013)Updated the document to reflect the new features in firmware version 4.0.

Revision 1.2r (April 2013)Updated the document to reflect the bug fixes and new features in firmware version 4.00.1.


http://www.microchip.com

RN-WIFLYCR-UG

IndexSymbols.mif, upgrading with .................................................. 84$$$ ........................................................................6, 40

escape buffer ...................................................... 6

Aaccess point

associating........................................................ 73scan in ad hoc mode......................................... 91supported........................................................ 101

access point mode ................................................... 45action commands..................................................... 40ad hoc mode .......................................................30, 89

beacon .............................................................. 10configuring ........................................................ 90default network settings ...................................... 7display settings ................................................. 35enable in hardware ........................................... 90enable in software............................................. 90probe setting ..................................................... 10scan for APs ..................................................... 91

ad hoc network......................................................... 89Airlink ..................................................................... 101Airport Express ...................................................... 101alternate functions.................................................... 22alternate GPIO functions.......................................... 62analog interface pin value ........................................ 38analog interface values, show multiple .................... 38analog sensor .......................................................... 92analog-to-digital convertor ....................................... 80AP mode .................................................................. 45

connect to module ............................................ 47default settings.................................................. 46enable in hardware ........................................... 45enable in software............................................. 46enabling ............................................................ 45GPIO alternative functions................................ 48last device connected ....................................... 48link monitor ....................................................... 48route data between clients ................................ 48view associated devices ................................... 48

AP, associating ........................................................ 73AP, scan for ............................................................. 42apmode command ................................................... 40APs, supported ...................................................... 101associate, AP ........................................................... 73auto pairing, UDP..................................................... 72auto wake timer........................................................ 27auto-connect timer ................................................... 22auto-connect timers ................................................. 57auto-join feature ....................................................... 45automatic connections ............................................. 75

Bbaud rates ................................................................ 29bit-mapped register

ip flags............................................................... 17ip protocol ......................................................... 18ip tcp-mode ....................................................... 19opt format.......................................................... 19show connection ............................................... 37sys trigger ......................................................... 26uart mode.......................................................... 29

boot image ............................................................... 44boot-up, timing ......................................................... 99broadcast, packet byte format.................................. 73broadcast, UDP........................................................ 72browser disconnect timer ......................................... 55Buffalo networks..................................................... 101

Cchannel mask ........................................................... 33Cisco ...................................................................... 101clock, real-time ......................................................... 67close......................................................................... 40close string ............................................................... 12CMD ........................................................................... 6command mode ................................................... 6, 40

command character setting............................... 12exit .................................................................... 40terminal emulator ................................................ 7

command, quick reference..................................... 103commands

overview.............................................................. 9reboot after.......................................................... 9set ..................................................................... 10shorthand ............................................................ 9syntax.................................................................. 9types ................................................................... 9

configuration............................................................... 6ad hoc mode ....................................................... 7default ............................................................... 95using configuration web server ......................... 51

configuration web server .................................... 49, 50configure module .............................................. 51invoke in hardware............................................ 50invoke in software ............................................. 51LED status ........................................................ 51set sys launch_string ........................................ 23using ................................................................. 50

configuring ad hoc mode.......................................... 90connect to module in AP mode ................................ 47connection

automatic .......................................................... 75display status .................................................... 37making .............................................................. 75


RN-WIFLYCR-UG

open.................................................................. 75timer.................................................................. 57to FTP server .................................................... 87to web server .................................................... 78

connectionsmaking .............................................................. 73

controlling connections ............................................ 63creating ad hoc network........................................... 89CTS pin .................................................................... 28Customer Support .................................................. 116

Ddebug messages...................................................... 25debug print levels..................................................... 64debug print message ............................................... 25debugging ................................................................ 64default AP mode settings ......................................... 46default configuration................................................. 95default network, ad hoc mode.................................... 7del ............................................................................ 43device ID setting ...................................................... 20DHCP modes ........................................................... 16display

all settings......................................................... 36analog pin value................................................ 38battery voltage .................................................. 37broadcast settings............................................. 35communication settings .................................... 35connection status.............................................. 37firmware version ............................................... 37multiple analog interface values ....................... 38network status................................................... 37optional settings................................................ 36signal strength .................................................. 38statistics ............................................................ 39system settings ................................................. 36time server settings........................................... 36

DLINK .................................................................... 101DNS

display settings ................................................. 36name setting ..................................................... 14name setting, backup........................................ 14query command ................................................ 41server setting .................................................... 14using settings.................................................... 76

Eenable AP mode in hardware................................... 45enable AP mode in software .................................... 46enabling AP mode.................................................... 45exit ........................................................................... 40

Ffactory reset ............................................................. 41file

boot image ........................................................ 44

delete ................................................................ 43ftp update .......................................................... 44load ................................................................... 43ls ....................................................................... 43save .................................................................. 43

file I/O commands .................................................... 43files

create on FTP server ........................................ 87get from FTP server .......................................... 87

firmwaredisplay version .................................................. 37fixes......................................................... 111, 115known issues .................................................. 109release notes .......................................... 111, 115scan output ................................................. 65, 66upgrading .......................................................... 83

firmware upgradepre-version 4.0 .................................................. 85upgrading to version 4.0 ................................... 85using .mif........................................................... 84version 4.0 and higher ...................................... 84

flow control ......................................................... 28, 60flush size setting....................................................... 13flush timer setting ..................................................... 13FTP

client.................................................................. 86connect to ......................................................... 86create files on server......................................... 87display settings ................................................. 36filename setting................................................. 15get files form server .......................................... 87mode setting ..................................................... 15password........................................................... 16remote port number setting............................... 15server setting .................................................... 14starting directory ............................................... 15timeout setting................................................... 15update ............................................................... 44upgrading firmware ........................................... 83username setting .............................................. 16

ftp update ................................................................. 44

Gget

adhoc ................................................................ 35broadcast .......................................................... 35com ................................................................... 35dns .................................................................... 36everything ......................................................... 36ftp ...................................................................... 36ip ....................................................................... 36mac ................................................................... 36option ................................................................ 36sys..................................................................... 36time ................................................................... 36uart.................................................................... 36


RN-WIFLYCR-UG

wlan .................................................................. 36get commands ......................................................... 35GPIO

alternate functions .......................................22, 60AP mode alternative functions .......................... 48controlling connections with .............................. 63default power-up value setting.......................... 26disable LEDs..................................................... 60output setting .................................................... 25pin bitmask...................................................24, 62pin usage .....................................................24, 62set as inputs or outputs instantly ...................... 24setting alternate functions................................. 62setting direction................................................. 60show pin level status......................................... 37

GPIO10 .................................................................... 30GPIO4 ...................................................................... 27

AP mode ........................................................... 48GPIO5 .................................................................27, 76

AP mode ........................................................... 48GPIO6 .................................................................27, 76

AP mode ........................................................... 48GPIO8 ...................................................................... 26GPIO9

invoking configuration web server .................... 50

Hhardware

invoke configuration web server ....................... 50hardware flow control ............................................... 60heartbeat, UART ...................................................... 67hello string................................................................ 13home network .......................................................... 87HTML

built-in modes ................................................... 78client example..............................................81, 82connect to server .............................................. 78post binary data ................................................ 80post sensor data ............................................... 80retrieve data...................................................... 77using client ........................................................ 77

HTTP client/web server setting ................................ 19

II/O alternate functions.............................................. 22I/O port direction setting........................................... 23idle timer .............................................................55, 57idle timer setting....................................................... 13infrastructure network .............................................. 89inputs, sensor........................................................... 92IP

address setting ................................................. 16address setting, backup.................................... 16default in ad hoc mode ....................................... 7DHCP setting .................................................... 16display settings ................................................. 36

gateway setting ................................................. 17host setting........................................................ 18local port setting................................................ 18netmask setting................................................. 18protocol setting.................................................. 18remote port setting ............................................ 18subnet ................................................................. 8TCP settings ..................................................... 19TCP/IP functions ............................................... 17using backup..................................................... 76

Jjoin............................................................................ 41join #......................................................................... 41join timer................................................................... 19join, network ............................................................. 73

Kknown issues, firmware.......................................... 109

Llast device connected in AP mode ........................... 48launch

web application ................................................. 23WPS application................................................ 23

launching WPS application ...................................... 89leave......................................................................... 41LEDs

configuration web server................................... 51disable............................................................... 60WPS status ....................................................... 89

link monitor............................................................... 33link monitor, AP mode .............................................. 48link timer

soft AP mode .................................................... 32Linksys ................................................................... 101load .......................................................................... 43load configuration file ............................................... 43lookup....................................................................... 41ls............................................................................... 43

MMAC, display settings............................................... 36making connections ........................................... 73, 75match character setting............................................ 13module

accepting data................................................... 56connect to remote host ..................................... 56disconnect from AP........................................... 41factory reset ...................................................... 41reboot................................................................ 42sleep ................................................................. 55wake.................................................................. 55

Module Configuration tab ......................................... 54

NNetgear .................................................................. 101


RN-WIFLYCR-UG

Network Configuration tab ....................................... 52network status, show ............................................... 37network, join ............................................................. 41network, joining ........................................................ 73network, point-to-point ............................................. 89

Oopen ......................................................................... 41open connection....................................................... 75open string ............................................................... 12optional settings, display.......................................... 36

Ppackets, time stamping ............................................ 69parity ...................................................................28, 30passphrase .............................................................. 34passphrase, show or hide ........................................ 32PBC.......................................................................... 88ping .......................................................................... 42pin-level status, show............................................... 37point-to-point network .............................................. 89power, sensor .......................................................... 93power-up, GPIO default setting................................ 26print functions........................................................... 64print messages, setting ............................................ 25pushbutton mode ..................................................... 87push-button WPS..................................................... 87

Rraw baud rates ......................................................... 29Reading, Recommended ....................................... 116real-time clock.....................................................57, 67real-time clock setting .............................................. 43reboot....................................................................... 42release notes ..................................................111, 115replacement character ............................................. 20retry, UDP ................................................................ 72RN131...................................................................... 31RN131 & RN171

comparing ........................................................... 5configuration ....................................................... 6features............................................................... 5

RN134...................................................................... 28RN171...................................................................... 35RSSI

set sample number ........................................... 20set threshold ..................................................... 20

RSSI, show .............................................................. 38RTC...............................................................28, 57, 67RTS/CTS.................................................................. 60

Ssample sensor pins .................................................. 92save ......................................................................... 43scan ......................................................................... 42scan output format

firmware 2.22 - 2.30 .......................................... 66firmware 2.36 & 2.45......................................... 64

scan, in ad hoc mode ............................................... 91security modes ......................................................... 30sending data, UDP ................................................... 71sensor ...................................................................... 92

input trigger values............................................ 26pin voltage settings ........................................... 21post data to web................................................ 80post data to web example ................................. 81power .......................................................... 21, 93sample pins....................................................... 92setting pins to sample ....................................... 21wake on input.................................................... 58

setad hoc beacon .................................................. 10adhoc probe ...................................................... 10adhoc reboot ..................................................... 11broadcast address ............................................ 11broadcast backup.............................................. 11broadcast interval.............................................. 11broadcast port ................................................... 12broadcast remote .............................................. 12comm $ ............................................................. 12comm close....................................................... 12comm idle.......................................................... 13comm match ..................................................... 13comm open ....................................................... 12comm remote .................................................... 13comm size......................................................... 13comm time ........................................................ 13dns address ...................................................... 14dns backup........................................................ 14dns name .......................................................... 14ftp addr.............................................................. 14ftp dir ................................................................. 15ftp filename ....................................................... 15ftp mode ............................................................ 15ftp pass ............................................................. 16ftp remote.......................................................... 15ftp time .............................................................. 15ftp user .............................................................. 16ip address ......................................................... 16ip backup........................................................... 16ip dhcp .............................................................. 16ip flags............................................................... 17ip gateway......................................................... 17ip host ............................................................... 18ip localport......................................................... 18ip netmask......................................................... 18ip protocol ......................................................... 18ip remote ........................................................... 18ip tcp-mode ....................................................... 19opt average ....................................................... 20opt deviceid....................................................... 20


RN-WIFLYCR-UG

opt format.......................................................... 19opt jointmr ......................................................... 19opt password .................................................... 20opt replace ........................................................ 20opt signal .......................................................... 20q power ............................................................. 21q sensor ............................................................ 21sys autoconn..................................................... 22sys autosleep.................................................... 22sys iofunc.......................................................... 22sys launch_string .............................................. 23sys mask........................................................... 23sys mask 0xABCD 1 ......................................... 24sys output ......................................................... 25sys printlvl ......................................................... 25sys sleep........................................................... 25sys trigger ......................................................... 26sys value........................................................... 26sys wake ........................................................... 27time address ..................................................... 27time enable ....................................................... 27time port ............................................................ 27time raw ............................................................ 28uart baud........................................................... 28uart flow ............................................................ 28uart instant ........................................................ 29uart mode.......................................................... 29uart raw............................................................. 29uart tx ................................................................ 30wlan auth .......................................................... 30wlan channel ..................................................... 31wlan ext_antenna.............................................. 31wlan fmon ......................................................... 32wlan hide........................................................... 32wlan join ............................................................ 32wlan key............................................................ 33wlan linkmon ..................................................... 33wlan mask......................................................... 33wlan phrase ...................................................... 34wlan rate ........................................................... 34wlan ssid ........................................................... 35wlan tx............................................................... 35

set commands.......................................................... 10settings, debug print message ................................. 25shorthand ................................................................... 9show

battery............................................................... 37connection ........................................................ 37io ....................................................................... 37net ..................................................................... 37q........................................................................ 38q 0x1 ................................................................. 38rssi .................................................................... 38stats .................................................................. 39time ................................................................... 39

show signal strength ................................................ 38signal strength, show ............................................... 38sleep................................................................... 43, 55

UDP .................................................................. 57sleep timer.......................................................... 25, 57SNTP........................................................................ 27sNTP .................................................................. 27, 67soft AP mode

apmode command ............................................ 40link timer............................................................ 32

softwareinvoke configuration web server ....................... 51

SSIDreplacement character ...................................... 20setting ............................................................... 35

statistics, show ......................................................... 39status commands ..................................................... 37supported access points ........................................ 101system settings, display ........................................... 36system timers ........................................................... 57

TTCP

close connection ......................................... 40, 58connection password ........................................ 20connection timer................................................ 58open connection................................................ 58open connection command............................... 41

Terminal tab ............................................................. 53time .......................................................................... 43time server, display settings..................................... 36time since mode was last powered or booted .......... 39time stamping........................................................... 69timer

auto wake.......................................................... 27autoconnect ...................................................... 22browser disconnect ........................................... 54configuration web server................................... 54connection......................................................... 57idle .................................................................... 54sleep ................................................................. 25TCP connection ................................................ 58transitions.......................................................... 57

timer server port setting ........................................... 27timer server setting................................................... 27timers ....................................................................... 57timing values ............................................................ 99trigger, wakeup setting ............................................. 26

UUART

baud setting ...................................................... 28connect to web server....................................... 79display settings ................................................. 36flow control........................................................ 60flow control setting ............................................ 28


RN-WIFLYCR-UG

GPIO10............................................................. 30heartbeat messages ......................................... 67instant baud change setting.............................. 29mode setting ..................................................... 29posting data to web example ............................ 82raw setting ........................................................ 29TX pin setting.................................................... 30wake on activity ................................................ 59

UDPauto pairing ....................................................... 72broadcast .......................................................... 72retry................................................................... 72sending data ..................................................... 71sleep ................................................................. 57

UDP heartbeat ....................................................11, 12port setting ........................................................ 12secondary address ........................................... 11

upgrade firmwarepre-version 4.0.................................................. 85to version 4.0 .................................................... 85

using configuration web server ................................ 50using GPIO9 ............................................................ 50

Vver ............................................................................ 37view associated devices, AP mode.......................... 48voltage, sensor pins ................................................. 21

Wwake......................................................................... 55wake timer................................................................ 57wake, on sensor input .............................................. 58wake, on UART activity ............................................ 59wakeup trigger setting.............................................. 26Warranty Registration ............................................ 116web application

launch ............................................................... 23web server

connect automatically ..................................78, 79post binary ........................................................ 80retrieve data...................................................... 77

web server, configuration......................................... 49WEP key .................................................................. 33WEP-128.................................................................. 30Wi-Fi protected setup............................................... 87Wi-Fi, transmit power setting.................................... 35WiFly-GSX-XX ........................................................... 7wireless data rate, setting ........................................ 34WLAN

authentication setting........................................ 30channel mask setting ........................................ 33channel setting.................................................. 31display settings ................................................. 36external antenna setting ................................... 31hide WEP key setting........................................ 32join setting......................................................... 32

link monitor setting ............................................ 33passkey setting ................................................. 33passphrase setting............................................ 34SSID setting ...................................................... 35Wi-Fi transmit power setting ............................. 35wireless data rate setting .................................. 34

WPA1 ....................................................................... 30WPA2-PSK............................................................... 30WPE-64.................................................................... 30WPS ......................................................................... 87

launch application ....................................... 23, 89status LEDs....................................................... 89


arduino - wifi - rn-wiflycr-ug-v1.2r - users guide.pdf

Documents

Transcript of arduino - wifi - rn-wiflycr-ug-v1.2r - users guide.pdf