Roving Networks WiFly RN-131-EK User manual

!
!
! !
RN-WIFLY-EVAL-UM
WiFly Evaluation Kit
USER MANUAL
© 2012 Roving Networks. All rights reserved.
RN-WIFLY-EVAL-UM Version 1.32r 10/9/2012
Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 2
RN-WIFLY-EVAL-UM
OVERVIEW
This document describes the hardware and software setup for Roving Networks evaluation kits, which contain the
hardware you need to evaluate the RN-171 or RN-131 WiFly 802.11 b/g modules. The RN-171 and RN-131 WiFly
modules are mounted to evaluation boards. Each board contains status LEDs, connections for the programmer and UART
interfaces, a voltage regulator, and easy access to GPIO pins.
You can use the evaluation kits to configure and program the WiFly module using the command interface, create
connections, and transfer data. The command interface is made up of simple ASCII commands. See “Resources &
Related Documents” on page 13 for information on available documentation.
Evaluation Kit Description
The evaluation kits include the hardware required to connect the evaluation board to your computer. See Table 1 for
information on which hardware is provided with each kit. Additionally, Appendix A provides photographs and detailed
information on each kit’s contents. To evaluate the module on the evaluation board, you need a computer with a USB port
running the Microsoft Windows or Mac OS-X operating system.
NOTE: Before beginning your evaluation, you may need to install the driver for the USB cable. You can download the
drivers (as well as other tools and utilities) from the Roving Networks website at
http://www.rovingnetworks.com/support.php.
Table 1. Evaluation Kit Hardware, Note (1)
Hardware
Description
RN-131-EK
RN-171-EK
Evaluation board
Contains the WiFly module and connectors.
For RN-131
module
For RN-171
module
USB cable
Links your computer to the evaluation board.
✔
✔
Battery pack
Provides power to the evaluation board (requires 2 AA batteries).
✔
PCB trace antenna
Trace antenna included on the PCB.
✔
On-board chip antenna
and U.FL.
The PCB includes an on-board chip antenna and a U.FL.
connector.
✔
Notes:
1. See “Appendix A: Legacy Evaluation Kits” on page 14 for more information on evaluation boards that use a serial cable.
Figure 1 shows the RN-131-EK evaluation board and pin information. Table 2 describes the LED indicators.
Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 3
RN-WIFLY-EVAL-UM
Figure 1. RN-131-EK Evaluation Board
UART Interface (J3)
!
RX - input to evaluation board
TX - output from evaluation board
Pin
Description
1
3.3 VDC output
2
GND
3
UART RX
4
UART TX
5
UART RTS
6
UART CTS
7
GPIO4
8
GPIO5
9
GPIO6
10
GPIO7
11
GPIO8
12
GPIO9
13
Reset
Sensors (J1)
!
Pin
Description
1
Sensor Power
2
Sensor 4 (3.3-V tolerant)
3
Sensor 5 (3.3-V tolerant)
4
Sensor 7 (1.2 V only)
5
Sensor 5 (1.2 V only)
6
Sensor 4 (1.2 V only)
7
Sensor 6 (1.2 V only)
8
Sensor 3 (1.2 V only)
9
GND
WARNING: Sensors must not have more
than 1.2-V DC. Otherwise, the module may
be permanently damaged.
Table 2. RN-131-EK Evaluation Board LED Indicators
Condition
Blue LED
Red LED
Yellow LED
Green LED
On solid!
Unused
"!
"!
Connected over TCP
Fast blink!
Unused
Not associated!
Rx/Tx data transfer!
No IP address
Slow blink!
Unused
Associated, no Internet!
"!
IP address OK
Off!
Unused!
Associated, Internet OK!
"!
-
Figure 2 shows the RN-171-EK evaluation board and pin information. Table 3 describes the LED indicators.
Sensor
Interface (J1)
LED Indicators
UART Interface
(J3)
Reset
Pushbutton
USB
Connector
AP/WPS/Factory Reset
Pushbutton (GPIO9)
1
2
3
4
5
6
7
8
9
10
11
12
13
95234678 1
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 4
RN-WIFLY-EVAL-UM
Figure 2. RN-171-EK Evaluation Board
!
Sensor Interface (J5)
!
Pin
Description
1
Sensor Power
2
Sensor 4 (3.3-V tolerant)
3
Sensor 5 (3.3-V tolerant)
4
Sensor 7 (1.2 V only)
5
Sensor 5 (1.2 V only)
6
Sensor 4 (1.2 V only)
7
Sensor 6 (1.2 V only)
8
Sensor 3 (1.2 V only)
9
GND
WARNING: Voltage on pins marked 1.2 V
Only should not exceed 1.2 V or
permanent damage will occur.
UART Interface
(J4)
!
RX - input to evaluation board
TX - output from evaluation board
Pin
Description
1
3.3-VDC Output
2
GND
3
UART RX
4
UART TX
5
UART RTS
6
UART CTS
7
GPIO4
8
GPIO5
9
GPIO6
10
GPIO7
11
GPIO8, (1)
12
GPIO9
13
RESET
!
Note:
1. The RN-171 module drives GPIO8 HIGH on powerup, which overrides software configured powerup values, such as set sys value
0x0000 on GPIO8.
!
LED Indicators
UART Interface
(J4)
Sensor
Interface (J5)
PCB Trace
Antenna
AP/WPS/Factory Reset
Pushbutton (GPIO9)
Reset
Pushbutton
95234678 1
1
2
3
4
5
6
7
8
9
10
11
12
13
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 5
RN-WIFLY-EVAL-UM
Table 3. RN-171-EK Evaluation Board LED Indicators
Condition
Blue LED
Red LED
Yellow LED
Green LED
On solid!
Not used!
"!
"!
Connected over TCP
Fast blink!
Not used!
Not associated!
Rx/Tx data transfer!
No IP address
Slow blink!
Not used!
Associated, no Internet!
"!
IP address OK
Off!
Not used!
Associated, Internet OK!
"!
-
HARDWARE SETUP
To set up the evaluation hardware, perform the following steps:
1. Provide power to the board:
•RN-131-EK—The USB cable supplies power to the board.
•RN-171-EK—Insert 2 AAA batteries into the battery pack. Alternatively, the USB cable can supply power to
the board.
2. Connect the USB cable to a USB port on your computer and to the USB connector on the evaluation board.
Windows should automatically install the drivers for the cable. If it does not, download and install the FTDI drivers
from the Support page on the Roving Networks website at http://www.rovingnetworks.com/support.php. Note the
COM port to which you have attached the cable.
Figure 3 shows the completed hardware setup for the evaluation boards.
Figure 3. Hardware Setup
RN-131-EK Evaluation Board Hardware Setup
!
RN-171-EK Evaluation Board Hardware Setup
!
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 6
RN-WIFLY-EVAL-UM
CONFIGURATION
The WiFly module operates in two modes: data mode (default) and command mode. While in data mode, the WiFly
module is essentially a data pipe. When the module receives data over Wi-Fi, it strips the TCP/IP headers and trailers and
passes the user data to the UART. When data is written to the UART, the module constructs the TCP/IP packet and sends
it out over Wi-Fi. Thus, the entire process of sending/receiving data to the host is transparent to the end microprocessor.
See Figure 4.
Figure 4. Data & Command Modes
!
By default, the module is in data mode. Sending the escape sequence $$$ causes the module to enter command mode.
Once in command mode, you can configure the WiFly device using simple ASCII commands. To exit command mode and
return to data mode, type exit <cr>.
Basic configuration only requires the wireless network access point’s name (SSID) and authentication password. The WiFly
module can only associate with one network at a time. Roving Networks recommends that you begin your evaluation by
configuring the WiFly module using an open access point to simplify the setup.
There are two ways to configure the WiFly module:
•Over the UART, which is connected to a computer or microprocessor
•Via Wi-Fi using ad hoc networking
You need a terminal emulator to complete the setup.
NOTE: Roving Networks suggests using either the TeraTerm (Windows OS) or CoolTerm (Mac OS-X) terminal
emulator program.
Configuration Using a Cable
The RN-131-EK and RN-171-EK boards use a USB cable to allow your computer to communicate with the WiFly module
on your evaluation board. The following instructions describe how to use a terminal emulator to go into configuration mode,
send commands to find networks, associate with an access point, and save your configuration.
UART Wi-Fi Interface
WiFly
Module
Command
Mode
$$$ $$$
AB
User Data Wi-Fi
Wi-F
Fi
Host
AB
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 7
RN-WIFLY-EVAL-UM
Configure the Module Using a Terminal Emulator
To communicate with the module using a terminal emulator, perform the following steps:
1. Determine the COM port that was assigned to the USB cable. If you do not know the COM port number, you can find
it using the Windows Device Manager, which is in the system tools. In the Device Manager, browse and expand the
selection for Ports (COM & LPT). In the example shown in Figure 5, the port is COM9.
For OS-X, if you are using CoolTerm, you can view and select the port from within the application.
NOTE: Legacy evaluation boards use a USB-to-serial cable. If you are using one of these boards, use the COM port to
which the USB-to-serial cable is attached.
2. Open your terminal emulation program.
3. Specify the COM port. If you are using TeraTerm, select Serial and choose the COM port number from the Port drop-
down list box.
NOTE:The default serial port setting for the WiFly module is 9600 baud, 8 bits, no parity, and 1 stop bit.
Figure 5. Finding the COM Port Number in Windows
!
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 8
RN-WIFLY-EVAL-UM
Enter Command Mode
To enter command mode, perform the following steps in the terminal emulator:
1. Type $$$. You must type $$$ together quickly with no additional characters before or after them. The module replies
with CMD to indicate it is in command mode.
2. Type show net <cr> to display the current network settings.
NOTE: When a command completes, the terminal displays a prompt in the format <X.XX> where X.XX indicates the
module’s firmware version. In Figure 6, the version is 2.28.
Figure 6. Show Current Network Settings
!
To issue commands to the module, you send a keyword followed by optional parameters. 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. Additionally, 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
NOTE: You cannot use shorthand for command keywords. For example, s uart baudrate 115200 is illegal.
The WiFly module supports a variety of command keywords. The Advanced User Manual, which is available on the
Support page of the Roving Networks website, provides a complete command reference. For evaluation purposes, you may
view the current settings using the get command; get everything shows all parameters.
Table 4 shows additional parameters for the set and get commands.
!
Example COM
Port Setting
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 9
RN-WIFLY-EVAL-UM
Table 4. Basic set & get Parameters
Parameter
Function
adhoc
Controls the ad hoc parameters.
broadcast
Controls the broadcast hello/heartbeat UDP message.
comm
Communication and data transfer, matching characters.
dns
DNS host and domain.
ftp
FTP host address and login information.
ip
IP settings.
option
Optional and infrequently used parameters.
sys
System settings, such as sleep and wake timers.
time
Realtime clock settings.
uart
Serial port settings, such as baud rate and parity.
wlan
Wireless interface, such as SSID, channel, and security options.
Find Available Networks
Once you are in command mode, you can instruct the WiFly module to search for available networks. Type scan <cr> in
the terminal emulator to view a list of Wi-Fi networks within range. See Figure 7.
Figure 7. Scan for Networks
!
Associate with an Access Point
You use the join keyword to associate with an open access point. As shown in the scan list, roving1 is an open access
point. To associate with an access point, type the following commands (refer back to Figure 7):
join roving1
or
join # 1
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.

!
www.rovingnetworks.com Version 1.32r 10/9/2012 10
RN-WIFLY-EVAL-UM
To disconnect from a network, type leave <cr>. The red LED blinks quickly when the WiFly module is not associated with
an access point.
If you want the module to associate with a network automatically upon booting (i.e., persistent configuration), use the
set wlan command with the SSID name. For example, type:
set wlan ssid roving1
save
reboot
When the module wakes or power cycles, the module attempts to associate with the network roving1.
To associate with a secure network you must also include the network password. The WiFly module determines the
security type automatically. In this case, type:
set wlan ssid roving1
set wlan pass rubygirl
save
reboot
See Figure 8. You can confirm the security settings by typing get wlan <cr>.
Figure 8. Connect to a Secure Network
!
Configuration Using Ad Hoc Mode
You can configure the WiFly module over the air via an ad hoc network. Ad hoc networks are useful for point-to-point
communication. In ad hoc mode, the WiFly appears as an access point with which other Wi-Fi devices can associate. You
can turn on ad hoc mode using hardware or software configuration.
NOTE: The WiFly module only supports the OPEN mode for ad hoc networks.
Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.Downloaded from Arrow.com.