Microchip Technology TCP 17051 User manual

Lab Manual for TCP 17051
Page | 1
MASTERs 2013
Lab Manual for TCP 17051
Table of Contents
Hardware Architecture 2
Lab 1 Instructions 4
Appendix A: Command Reference 12
Appendix B: Reference documents 17
Appendix C: Schematics 18
Adding Wi-Fi to Embedded Designs
Using the RN-131/RN-171 modules

Lab Manual for TCP 17051
Page | 2
Hardware Architecture: Development Environment
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 1. 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!
"!
-
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

Lab Manual for TCP 17051
Page | 3
Lab Equipment
For this lab, you need the following hardware and software.
Hardware
•RN-131-EK evaluation board, which contains the RN-131 WiFly module
•Personal computer with a USB port
•USB cable to interface the RN-131-EK to the PC
•Access point(s) configured with WAP2 security (this hardware is already set up in
the lab by the instructor)
Software
•Tera Term software (http://sourceforge.jp/projects/ttssh2/releases/)
Access Point Setup
•We have four Access Points set up for this class, each having a unique SSID
•Three Access Point are configured with WAP2-Personal encryption
•One Access Point is open (has no security enabled)

Lab Manual for TCP 17051
Page | 4
Lab 1: Association and Data Transmission over TCP
Purpose:
This lab will teach you how to:
•Configure the module’s parameters.
•Scan, join, and authenticate to wireless networks.
•Discover the WiFly module on your wireless network via UDP.
•Send data over TCP using the RN-131-EK to your lab partner.

Page | 5
Overview:
The following steps will show you how to:
1. Set up the hardware.
2. Configure the module on the evaluation kit.
3. Associate with a network.
4. Discover the module on the network via UDP broadcast.
5. Send data to your lab partner using TCP.
Part 1: Hardware Setup
1. Connect the evaluation board.
a. Connect the RN-131-EK board to your computer using the USB cable.
b. Use the device manager to find the COM port. See the following figures.
2. Launch the Tera Term terminal software from your PC.
a. Choose Serial.
b. In the drop-down menu, select the COM port you found in step 1b.

Lab Manual for TCP 17051
Page | 6
3. Configure the RN-131-EK to enter command mode:
a. Type the escape sequence (three dollar signs, $$$).
b. The module responds with CMD. When you press the enter key, Tera Term
console displays the version prompt.
4. Review the module’s configuration and initialize the module to the factory default
conditions:
a. Check the configuration and firmware version:
i. ver
b. Perform a factory reset (starts the module in a known state):
i. factory RESET
ii. reboot
You have completed the hardware setup.
Example Output:
CMD
<4.00> ver
wifly-GSX Ver 4.00.1, Apr 19 2013 11:48:31 on RN-131
<4.00> factory RESET
Set Factory Defaults
<4.00> reboot
*Reboot*.wifly-GSX Ver 4.00.1, Apr 19 2013 11:48:28 on RN-131
MAC Addr=00:06:66:21:3a:08
*READY*

Lab Manual for TCP 17051
Page | 7
Part 2: Associating with a Wireless Network (Access Points)
1. Search for wireless networks.
a. $$$ (enter command mode)
b. scan
Example Output:
<4.00> scan
<4.00>
SCAN:Found 15
01,01,-69,08,1104,28,00,00:1a:70:74:15:43,youllneverbelievewhatsinside
02,01,-67,08,3104,28,00,06:90:e8:25:54:86,Moxa
03,01,-73,08,3104,28,00,84:c9:b2:65:5b:54,ADoctorADayKeepsAnAppleAway
04,01,-70,08,3104,28,00,00:15:f9:38:bd:b0,laptastic
05,01,-66,04,1100,28,c0,00:22:3f:6b:95:42,SensorNet
06,01,-74,04,3100,28,00,e0:91:f5:a9:8a:a0,accelbiotech
07,06,-58,06,3100,14,00,d8:c7:c8:aa:e7:a0,mchp-peap
08,06,-65,00,2100,00,00,d8:c7:c8:aa:e7:a1,guest
09,06,-57,08,3100,28,00,d8:c7:c8:aa:e7:a2,mchp-secure
10,06,-52,04,3104,28,00,b8:c7:5d:06:d0:2b,
11,06,-53,04,3104,28,00,00:26:f2:4f:89:d6,roving-guest
12,09,-49,04,3104,28,00,e0:91:f5:57:a3:54,
13,11,-48,04,3104,28,00,00:16:b6:45:63:98,CoolBox
14,11,-64,04,3108,28,00,00:14:d1:af:12:0c,roving1
15,11,-72,00,2100,40,40,00:18:02:70:7e:e8,GPT
END:
The scan output format is shown below:
Index
Channel
RSSI
Security
Mode
Capabilities
WPA
Configuration
WPS
Mode
MAC
Address
SSID
For a more detailed description of the scan output fields, refer to the WiFly Command
Reference, Advanced Features & Applications User’s Guide.
NOTE 1: If you do not see the desired access point in the list, re-issue the scan
command.
2: The module does not display hidden access points in the scan output.

Lab Manual for TCP 17051
Page | 8
2. Auto-join a network with persistent configuration.
a. set wlan ssid <string> // AP name
b. set wlan pass <string> // AP passphrase
c. set wlan join 1 // Enable auto-join to AP after reboot
d. set option deivce-id <string> //Give your module a unique device name
e. save
f. reboot
Example Output:
<4.00> set wlan ssid roving1
AOK
<4.00> set wlan pass rubygirl
AOK
<4.00> set wlan join 1
AOK
<4.00> save
Storing in config
<4.00> reboot
*Reboot*.wifly-GSX Ver 4.00.1, Apr 19 2013 11:48:28 on RN-131
MAC Addr=00:06:66:21:3a:08
*READY*
Auto-Assoc roving1 chan=11 mode=MIXED SCAN OK
Joining roving1 now..
Associated!
DHCP: Start
DHCP in 17ms, lease=60s
IF=UP
DHCP=ON
IP=172.35.1.13:2000
NM=255.255.0.0
GW=172.35.0.1
Listen on 2000
TIP: If the network is secure, set the pass phrase with set wlan pass <string> before
joining the network.

Lab Manual for TCP 17051
Page | 9
Part 3: Discovering Your Devices on the Network Using the UDP Broadcast
Protocol
NOTE: You will be observing this section. There is no action required.
The following figure illustrates device discovery via UDP broadcast. The module sends a
UDP broadcast at programmable intervals to make itself discoverable. The UDP
broadcast contains information that identifies the module on the network.
Device Discovery via UDP Broadcast
The UDP broadcast is a fixed 110 byte packet with the following structure:
Roving
Networks
Device
192.168.0.3
Access Point
DHCP server
Roving
Networks
Device
192.168.0.2
192.168.0.1
174.201.25.16
To Internet
Roving
Networks
Device
Roving
Networks
Device Roving
Networks
Device
Roving
Networks
Device
Roving
Networks
Device
192.168.0.4
192.168.0.5
192.168.0.6
192.168.0.7
192.168.0.8
192.168.0.100
UDP Server
Who is
there
I’m
here
I’m
here
I’m
here
I’m
here
I’m
here
I’m
here
I’m
here
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)

Lab Manual for TCP 17051
Page | 10
Part 4: Communicating with your lab partner over TCP
This lab section will teach you how to:
•Connect from the module to a remote host using TCP (client).
•Connect to module from remote host using TCP (server).
Student A’s module initiates the TCP open and acts as the client. Student B’s module
accepts the TCP connection and acts as the server.
TCP connections are point-to-point connections that provide reliable, guaranteed, in
order data delivery. They are also known as sockets. See the following figure.
TCP Connections
1. Restore the module to the factory defaults:
a. $$$ // Enter command mode.
b. factory RESET // Restore module to factory defaults
c. reboot // Reboot module with factory defaults
2. Associate with AP
a. $$$ // Enter command mode
b. set wlan ssid <string> // Enter AP SSID
c. set wlan pass <string> // Enter AP passphrase
d. set wlan join 1 // Enable auto join
e. save
f. reboot
WiFly Module Opens TCP Connection
Sensing applications
Sending data to web server
Data acquisition systems
Fleet management
Remote Host Opens TCP Connection
Industrial controls
Home automation
Universal remotes
open 192.168.1.200 5000 open 192.168.1.50 2000
RN-134-K
192.168.1.50
Listen on Port 2000
Access Point
DHCP server
Remote
Host
192.168.1.200
Listen on Port 5000