WiFly click

WiFly click carries RN-131, a standalone, embedded wireless LAN module. It allows you to connect your devices to 802.11 b/g wireless networks. Preloaded firmware simplifies integration. The mikroBUS UART interface alone (RX, TX pins) is sufficient to establish a wireless data connection (with speeds up to 1 Mbps); the module is controlled with simple ASCII commands (for scanning, authenticating and connecting to Wi-Fi networks). Multitude of networking applications are built in: DHCP, UDP, DNS, ARP, ICMP, TCP, HTTP client, and FTP client. Additional functionality is provided by RST, WAKE, RTSb and CTSb pins. 3.3V power supply only.

Specification

WiFly click is the quickest way to add WiFi to your devices. The click features the well-known RN131 802.11 b/g Wi-Fi module from Microchip. With preloaded firmware and built in networking stacks, the integration of the WiFly click is really easy. RN131 is controlled with simple ASCII commands (for scanning, authenticating and connecting to Wi-Fi networks).

The click communicates with the MCU over UART connection and runs on a 3.3V power supply. It has an onboard ceramic chip antenna and a connector for an external antenna.

The RX, TX (UART) pins alone are enough for making a wireless data connection with speed up to 1 Mbps.

Features and usage notes

Low power consumption and speed

RN131 is a fully qualified and Wi-Fi certified 2.4 GHz IEEE 802.11 b/g transceiver. It is so power efficient it can run on two standard AAA batteries for years, considering it uses 40 mA (Rx) and 210 mA (Tx) when awake and 4 uA when it is in sleep mode. When it comes to speed, RN131 can wake up, connect to a wireless network, send data, and return to sleep mode in less than 100 milliseconds.

WiFi Protected Setup (WPS)

WiFi Protected Setup (WPS) protocol is designed for easy and secure establishment of wireless home networks. This protocol is meant to allow users who know little about wireless security to configure their WiFi Protected Access (WPA) without any trouble.

Networking applications

RN131 has built-in TCP/IP stack and networking applications, DHCP client, DNS client, ARP, ICMP ping, FTP client, Telnet, HTTP, UDP, and TCP. This makes it ideal for connecting IoT devices to wireless networks, for home automation systems, handheld devices, etc.

Onboard LEDs

• ASSOC (Red LED) —indicates the TCP/IP connection status. This signal is on high for an active connection, toggles fast to indicate no IP address, and toggles slowly to indicate that the IP address is OK but not connected.
• CONN (Green LED) — toggles when data is transferred.
• DATA (Yellow LED) — indicates the association status. High means the module is not associated with a network, off indicates that it is associated and Internet access is OK.

Pinout diagram

This table shows how the pinout on WiFly click corresponds to the pinout on the mikroBUS™ socket (the latter shown in the two middle columns).

Notes	Pin	mikroBUStm				Pin	Notes
	NC	1	AN	PWM	16	AP	Soft AP mode and factory reset.
Module reset, Active Low	RST	2	RST	INT	15	NC
Force the module to wakeup	WAKE	3	CS	TX	14	UART-TX	UART data Transmit
	NC	4	SCK	RX	13	UART-RX	UART data Receive
	NC	5	MISO	SCL	12	RTSb	UART Request To Send
	NC	6	MOSI	SDA	11	CTSb	UART Clear To Send
+3.3V power input	+3.3V	7	+3.3V	+5V	10	NC
Ground	GND	8	GND	GND	9	GND	Ground

Programming

This is a simple project which demonstrates the use of WiFly click board. After establishing the connection with the TCP server, messages from the server will be displayed on the TFT.

• NOTES:
  • Place WiFly click board in the mikroBUS socket 1 on the EasyPIC Fusion v7 board.
  • Configure SSID, TCP server address and port to match your network settings.

 1 #include "WiFly_Rn_131.h"
2 #include "resources.h"
3 
4 // WiFly click connections
5 sbit WiFly_Rn_131_RST at LATC.B1;
6 sbit WiFly_Rn_131_RST_DIR at TRISC.B1;
7 // WiFly click connections
8 
9 unsigned char isConnect = 0;
10 unsigned char isOpen = 0;
11 
12 unsigned char recMessage[2048];
13 unsigned char tmp;
14 unsigned int data_len = 0;
15 unsigned char data_ready = 0;
16 unsigned char tryToConnect = 0;
17 unsigned char recFromServer = 0;
18 unsigned char recMessServer = 0;
19 
20 // Network/server information
21 char SSID_string[] ="mikroe_test";
22 char TCP_Server_port[] ="8001";
23 char TCP_Server_Address[] ="192.168.1.2";
24 
25 void UART2interrupt() iv IVT_UART_2 ilevel 6 ics ICS_AUTO {
26 tmp = UART2_Read();
27 
28 if (tmp == '>' || (tmp == 0x0D && recFromServer ) || data_len > 100) {
29 if(tmp == '>')
30 recMessage[data_len + 1] = '>';
31 else 
32 recMessage[data_len + 1] = 0;
33 recMessage[data_len + 2] = 0;
34 data_ready = 1;
35 }
36 else {
37 if(recMessServer && (data_len == 5))
38 data_ready = 1;
39 recMessage[data_len] = tmp;
40 data_len++;
41 }
42 U2RXIF_bit = 0;
43 }
44 
45 void resetUart(){
46 data_ready = 0;
47 data_len = 0;
48 }
49 
50 void checkUartError(){
51 if(U2STAbits.OERR){
52 U2STAbits.OERR = 0;
53 }
54 }
55 
56 void readData(){
57 while(!data_ready)
58 ;
59 resetUart();
60 }
61 
62 void main() {
63 // Set all pins to digital
64 AD1PCFG = 0xFFFF;
65 JTAGEN_bit = 0;
66 
67 // Set WiFly Reset pin as output
68 WiFly_Rn_131_RST_DIR = 0;
69 
70 // Reset WiFly module
71 WiFly_Rn_131_RST = 1;
72 delay_ms(10);
73 WiFly_Rn_131_RST = 0;
74 delay_ms(10);
75 WiFly_Rn_131_RST = 1;
76 delay_ms(10);
77 
78 DrawScreen();
79 
80 // Initialize UART
81 UART2_Init(9600);
82 
83 // Set UART interrupt
84 U2IP0_bit = 0; // Set UART2 interrupt
85 U2IP1_bit = 1; // Set interrupt priorities
86 U2IP2_bit = 1; // Set UART2 interrupt to level 6
87 
88 U2RXIF_bit = 0; // Ensure interrupt not pending
89 U2RXIE_bit = 1; // Enable intterupt
90 EnableInterrupts();
91 
92 // Enter command mode
93 WiFly_Rn_131_EnterInCmdMode();
94 delay_ms(100);
95 
96 // Scan for the network
97 TFT_Write_Text("Scanning for the network...", 80, 60);
98 WiFly_Rn_131_Scan();
99 delay_ms(5000);
100 
101 // Set network
102 WiFly_Rn_131_SetWlan(ssid_string);
103 delay_ms(100);
104 
105 // Join network
106 TFT_Write_Text("Connecting to network...", 80, 80);
107 WiFly_Rn_131_JoinNet();
108 delay_ms(1000);
109 
110 TFT_Write_Text("Connected to network!", 80, 100);
111 
112 // Try to connect to TCP server
113 while(!isOpen) {
114 delay_ms(1000);
115 TFT_Write_Text("Connecting to TCP server...", 80, 125);
116 checkUartError();
117 resetUart();
118 
119 // Connect to TCP server
120 WiFly_Rn_131_OpenConn("192.168.1.2", "8001");
121 readData();
122 
123 recMessServer = 1;
124 
125 while(!data_ready)
126 ;
127 
128 if(strstr(recMessage, "OPEN")) {
129 isOpen = 1;
130 recMessServer = 0;
131 }
132 else {
133 tryToConnect++;
134 recMessServer = 0;
135 }
136 
137 // If not connected to TCP server
138 if(tryToConnect > 8) {
139 // Exit from command mode
140 WiFly_Rn_131_ExitFromCmdMode();
141 TFT_Write_Text("Can't connect to TCP server!", 80, 145);
142 while(1)
143 ;
144 }
145 }
146 
147 TFT_Write_Text("Connected to TCP server!", 80, 145);
148 delay_ms(1000);
149 TFT_Write_Text("Received data :", 80, 170);
150 
151 // Exit from command mode
152 WiFly_Rn_131_ExitFromCmdMode();
153 
154 while(!data_ready)
155 ;
156 
157 resetUart();
158 recFromServer = 1;
159 
160 // Receive data from TCP server
161 while(1){
162 checkUartError();
163 while(!data_ready)
164 ;
165 
166 TFT_Set_Pen(CL_WHITE, 10);
167 TFT_Set_Brush(1, CL_WHITE, 0, 0, 0, 0);
168 TFT_Rectangle(80, 190, 250, 205);
169 TFT_Write_Text(recMessage, 80, 190);
170 
171 resetUart();
172 }
173 }