Wifi Web Server Module w TF Socket User s Guide

Transcription

1 Wifi Web Server Module w TF Socket User s Guide Sure Electronics Inc. MB-CM14117_Ver1.0

2 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Table of Contents Chapter 1. Overview Overview Features Quick Start Save All Files in a Micro SD Card Connection Install CP2102 Driver Browse Webpage... 6 Chapter 2. Hardware Detail...7 Chapter 3. Configuration Infrastructure Mode Adhoc Mode Hyper Terminal... 8 Chapter 4. Function Demonstration Webpage Status Monitoring Leds Control Example of Using Command Configuration of AD-HOC Mode View the Current Status Send Data to Webpage Chapter 5. Mechanical Drawing...14 Chapter 6. Appendix WiFi Connection Failure Command Set Standalone Commands puthttp Command iwconfig Commands ifconfig Commands iwpriv Commands Chapter 7. Contact Us Sure Electronics Inc. MB-CM14117_Ver1.0_Page i

3 Wifi Web Server Module w TF Socket NOTES: Product Version : Ver 1.0 Document Version : Ver 1.0 MB-CM14117_Ver1.0_Page ii Sure Electronics Inc

4 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Chapter 1. Overview 1.1 Overview Thanks for using this WiFi web server module by Sure Electronics. This is a demonstration board for evaluating Wi-Fi connectivity using PIC24FJ256GB106 and the MRF24WB0MB which is an agency certified IEEE Wi-Fi radio transceiver module having an ufl connector for an external antenna, matching circuitry, and supports Wi-Fi with the free TCP/IP protocol stack. It can simply demonstrate to you the function of Web Server Module based on Microchip TCP/IP Stack v5.25. After configuration, you can browse the webpage of the demo board by entering the IP address. Of course, you can also directly enter in the browser. Two functions, Status Monitoring and Leds Control, are demonstrated on the page. FIGURE 1-1 OVERVIEW Sure Electronics Inc. MB-CM14117_Ver1.0_Page 1

5 Wifi Web Server Module w TF Socket FIGURE 1-2 ACCESSORY Note: All the diagrams in this manual are for reference only. 1.2 Features Powered by minib USB cable Saving webpages in a micro SD card Support dynamic page display Wi-Fi wireless network, configurable via UART interface Web-based status monitoring Web-based LEDs control 1.3 Quick Start Save All Files in a Micro SD Card As shown below, save all the files in WebPages.zip provided to the root directory of a micro SD card. FIGURE 1-3 SAVE WEBPAGES Root directory of a micro SD card MB-CM14117_Ver1.0_Page Sure Electronics Inc

6 Overview Connection Follow the figure and steps below for connection. FIGURE 1-4 CONNECTION SCHEMATIC 1. Connect the external antenna with the wifi module on the back of the wifi board 2. A converter module (DB-UC001-A) is introduced here to help the communication between the wifi module and PC. Connect the wifi module and the converter board with three Dupont wires. Connect the converter board to PC with a USB Cable. The following is an up-close of the converter board and pin description of the wifi board. FIGURE 1-5 UP-CLOSE OF CONVETER BOARD Sure Electronics Inc. MB-CM14117_Ver1.0_Page 3

7 Wifi Web Server Module w TF Socket TABLE 1-1 PIN DESCRIPTION OF THE WIFI BOARD Pin Number Name Description 1 GND Ground 2 RTS Request to send 3 +5V +5V supply 4 RXD Receive data 5 TXD Transmit data 6 CTS Clear to send Pin connection between the converter board and wifi board is as follows: GND (pin 1 of wifi module) <-----> GND of the converter board RXD (pin 4 of wifi module) <------> TXD of the converter board TXD (pin 5 of wifi module) <------> RXD of the converter board Note: Secure each connection by tightening the screws of the terminal block with a screw driver. 3. Insert the micro SD card into the socket and power the wifi board via USB mini B port Install CP2102 Driver CP2102 driver helps establish the communication channel between the wifi board and PC with the help of the converter, so it must be installed first. It can be downloaded from The full name of CP2102 driver downloaded is CP210x_VCP_Win2K_XP_S2K3.exe. Double-click it and the following will be displayed: Click Next > to proceed. MB-CM14117_Ver1.0_Page Sure Electronics Inc

8 Overview Click I accept the terms of the license agreement and Next > to continue installation. Click Browse to specify the path that CP2102 driver is to be installed if necessary. Otherwise, click Next > to proceed Sure Electronics Inc. MB-CM14117_Ver1.0_Page 5

9 Wifi Web Server Module w TF Socket Click Install to start installation. It may take a few seconds for installation to complete and the following will pop up after the installation: Click Finish to complete the installation of CP2102 driver Browse Webpage Enter or the current IP address in a browser and you can get more information. Google Chrome is recommended. MB-CM14117_Ver1.0_Page Sure Electronics Inc

10 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Chapter 2. Hardware Detail PIC24FJ256GB106 IC MRF24WB0MB Wi-Fi radio transceiver module TF socket Five LED indicators USB minib port A thermistor An external antenna UART interface external serial port converter board required Sure Electronics Inc. MB-CM14117_Ver1.0_Page 7

11 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Chapter 3. Configuration 3.1 Infrastructure Mode The default mode this wifi board works in is Infrastructure mode. Following is the configuration of wireless router when the wifi mode works in this mode. When the wifi board is reconfigured, the wireless router should be correspondingly configured. TABLE 3-1 CONFIGURATION Parameter Configuration SSID MicrochipDemoAP Encryption Function Disabled Channel 6 AP Mode Access Point SSID Broadcast Enabled DHCP server Enabled 4X Mode(if there s) Disabled 3.2 Adhoc Mode When the wifi board works in Adhoc mode, IP address should be in the same network as the wifi board. Gateway and subnet mask of the wifi board must be the same with those of PC. 3.3 Hyper Terminal 1. Open Hyper Terminal. Create a new connection and name it. FIGURE 3-1 NEW CONNECTION MB-CM14117_Ver1.0_Page Sure Electronics Inc.

12 Wifi Web Server Module w TF Socket FIGURE 3-2 NEW NAME 2. Finish settings such as COM (COM11 is taken as an example here), baud rate and so on. FIGURE 3-3 COM SELECTION Sure Electronics Inc. MB-CM14117_Ver1.0_Page 9

13 Configuration FIGURE 3-4 PORT SETTINGS Power the Wi-Fi board and information of it will be displayed on Hyper Terminal. The default is Infrastructure mode. New IP address will be given. Here IP is given as follows. If the connection is wrong, please refer to Chapter 6 Appendix for details. MB-CM14117_Ver1.0_Page Sure Electronics Inc

14 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Chapter 4. Function Demonstration 4.1 Webpage You can browse the webpage of the demo board by entering the IP address in a browser in the Internet-linked device. You can also directly enter in the browser. Two functions, Status Monitoring and Leds Control, are demonstrated on the pages. The webpage is shown as follows: FIGURE 4-1 WEBPAGE 4.2 Status Monitoring There re three real-time displays on the webpage: Real-time display of the current temperature (temperature of the board) Real-time display of the current LED status (LED status can be changed under Web-Based Control) Real-time display of the data from the serial port of the demo board (Baud rate: 19200, Parity check: None, Data bit: 8, Stop bit: 1) Sure Electronics Inc. MB-CM14117_Ver1.0_Page 11

15 Wifi Web Server Module w TF Socket 4.3 Leds Control As shown in figure 4-1, on-board LED indicators can be controlled via webpage. 4.4 Example of Using Command Configuration of AD-HOC Mode Enter command iwconfig mode idle and press Enter key, and then enter command iwconfig mode adhoc and press Enter key. There will be a tip Event: Connection Successful, which means the current mode is AD-HOC mode View the Current Status 1. Enter command ifconfig and press Enter key. Then you can use commands (refer to appendix) to close DHCP, modify IP address and finish other operations. 2. Enter command iwconfig and press Enter key. MB-CM14117_Ver1.0_Page Sure Electronics Inc

16 Demonstration Note: Command iwconfig mode idle should be entered first, and then the mode can be modified, including SSID, pwrsave, etc Send Data to Webpage To send data to webpage, command puthttp is used. For example, enter command puthttp data from uart and data from uart will be displayed on the webpage Sure Electronics Inc. MB-CM14117_Ver1.0_Page 13

17 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Chapter 5. Mechanical Drawing FIGURE 5-1 MECHANICAL DRAWING MB-CM14117_Ver1.0_Page Sure Electronics Inc.

18 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Chapter 6. Appendix 6.1 WiFi Connection Failure When Wi-Fi connection failures, there will come up number as shown in the following table. TABLE 6-1 COMMAND SET Number Description 2 JOIN FAILURE 3 AUTHENTICATION FAILURE 4 ASSOCIATION FAILURE 5 WEP HANDSHAKE FAILURE 6 PSK CALCULATION FAILURE 7 PSK HANDSHAKE FAILURE 8 ADHOC JOIN FAILURE 9 SECURITY MISMATCH FAILURE 10 NO SUITABLE AP FOUND FAILURE 11 RETRY FOREVER NOT SUPPORTED FAILUR 6.2 Command Set There re four command sets as follows: TABLE 6-2 COMMAND SET Name Description Standalone Commands Standalone CLI commands for talking with the MRF24WB0M puthttp Commands Send data to the monitoring of web iwconfig Commands Commands for controlling the wireless network interface ifconfig Commands Commands for controlling the network interface iwpriv Commands Commands for controlling the wireless encryption settings Standalone Commands These CLI commands are not related to the wireless or networking interface directly. TABLE 6-3 COMMANDS Name Description help Lists all the available CLI commands for the MRF24WB0M getwfver Lists the WiFi firmware and host driver version numbers reset Issues a host reset puthttp Command This command takes the following structure and example above. Data ranges from 1 to 16 SCII characters. puthttp <data> iwconfig Commands Most of these items should not be changed while the device is in a connected state to a network. iwconfig commands take the following structure Sure Electronics Inc. MB-CM14117_Ver1.0_Page 15

19 Wifi Web Server Module w TF Socket TABLE 6-4 COMMANDS Name Description Name ranges from 1 to 32 ASCII characters, spaces iwconfig ssid <name> currently aren t available in the SSID name. idle: forces the MRF24WB0M to disconnect from any currently connected network (adhoc or infrastructure). managed: the MRF24WB0M will connect to the iwconfig mode SSID in infrastructure mode. Note that all the <idle/managed/adhoc> network parameters must be correct before this command is called. adhoc: the MRF24WB0M will connect to the SSID in adhoc mode. Note that all the network. channel list: a comma separated list of all the iwconfig channel <channel channels to scan. list/all> all: sets the MRF24WB0M to scan all channels in the given regulatory domain. reenable: enables all power saving features (PS_POLL) of the MRF24WB0M. disable: disables any power savings features. The MRF24WB0M will always be in an active power state. iwconfig power unicast: the MRF24WB0M will be in it's deepest <reenable/disable/unicast/all> sleep state, only waking up at periodic intervals to check for unicast data. The MRF24WB0M will not wake up on the DTIM period for broadcast or multicast traffic. all: the MRF24WB0M will wake up to check for all types of traffic (unicast, multicast, and broadcast) ifconfig Commands These items should not be changed while the device is in a connected state to a network. ifconfig commands take the following structure: MB-CM14117_Ver1.0_Page Sure Electronics Inc

20 Appendix TABLE 6-5 COMMANDS Name Description Use a static IP address. IP address must be in dot-decimal notation. Note: this command will return an invalid parameter ifconfig <IP address> if the DHCP client is enabled. First disable the DHCP attempts (ifconfig auto-dhcp stop) before running this command. Redefine the device MAC address. MAC address must be specified in hexadecimal colon notation. ifconfig <MAC address> This command can only be issued when the MRF24WB0M is in idle mode. Doing so at other times can have unexpected results. Use the specified IP address for the netmask. The ifconfig netmask <IP address> netmask value is specified in dot-decimal notation. Configure the gateway address. The gateway value ifconfig gateway <IP address> is specified in dot-decimal notation. start: e Starts the DHCP client. Only valid if the DHCP module has been compiled in. DHCP client is started by default. ifconfig auto-dhcp <start/drop> drop: Stops the DHCP client. A static IP address will need to be assigned to the device. Only valid if the DHCP module has been compiled in iwpriv Commands These items should not be changed while the device is in a connected state to a network. iwpriv commands take the following structure: Sure Electronics Inc. MB-CM14117_Ver1.0_Page 17

21 Wifi Web Server Module w TF Socket TABLE 6-6 COMMANDS Name iwpriv enc <none/wep/wpa-psk/wpa-phrase> iwpriv key <[1]/[2]/ [3]/[4]> <value> iwpriv psk <value> iwpriv phrase <value> Description none: the MRF24WB0M will not use any encryption to connect to the specified network. wep: the MRF24WB0M will use either WEP-40 (short) or WEP-104 (long) encryption to connect to the specified network. wpa-psk: the MRF24WB0M will use the specified 32-byte PSK to connect to the WPA/WPA2 network. wpa-phrase: the MRF24WB0M will take the given 1-32 ASCII character passphrase, along with the SSID, and compute the required 32-byte PSK for the network. Note that doing so takes approximately 30 seconds to complete the calculation. Instructs the MRF24WB0M to use this key for connecting to the WEP encrypted network. Only key 1 is considered safe to use among different AP vendors. Keys 2-4 can have implementation specific entries that may not be compatible from AP to AP. If value is specified, this will instruct the MRF24WB0M to use the specified key number and also program the device with this key value. For WEP-40 networks, this implies the key is either 5 ASCII characters of 10 hex characters in length. For WEP-104 networks, this implies the key is either 13 ASCII characters or 26 hex characters in length. The console only accepts hex WEP keys. Therefore, the user must do the ASCII to hex conversion for their ASCII keys. 32-byte hex value for the PSK. This value can be calculated from the following website hosted on the Wireshark website. An 8-63 ASCII character phrase (delimited with quotes if using spaces). This phrase will be used along with the SSID to generate the 32-byte PSK value for the network. MB-CM14117_Ver1.0_Page Sure Electronics Inc

22 WIFI WEB SERVER MODULE W TF SOCKET USER S GUIDE Chapter 7. Contact Us Sure Electronics Co., Ltd. East zone, 3F, Building 6 Jingang Technology Innovation Center No.108 Ganjiabian Rd (ZIP: ) Qixia District Nanjing P.R.China Tel: Fax: Website: customerservice@sure-electronics.com Sure Electronics Inc. MB-CM14117_Ver1.0_Page 19