WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 User Manual and Command Reference 802.11 b/g Wireless LAN Modules WIFLY GSX RN-131G, RN-131C, RN-134, RN-121, RN-123 & RN-125, RN-370 WIFLY EZX RN-171, RN-174, RN-XV Firmware Version 2.30 October 26th 2011 Copyright © 2011 Roving Networks, Inc. All Rights Reserved. The contents of this document can be changed by Roving networks without prior notice and do not constitute any binding undertakings from Roving networks.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Table of Contents 1. 2. 3. Introduction ...............................................................................................................................................4 Overview ...................................................................................................................................................4 Configuration.............................................................................................
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 12.4. Controlling Connections using PIO5 and PIO6 ..............................................................................54 12.5. Using DNS settings .........................................................................................................................55 12.6. Utilizing the Backup IP address/connect function ..........................................................................55 13. Using HTML client feature ........
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 1. Introduction This user guide is applicable to the RN-131 and the RN-171 modules and finished products designed by Roving Networks using these modules. While there are some hardware differences, the same ASCII command set applies to the RN-131 and the RN-171 modules. The RN-XV is built using the RN-171 module and as such all hardware features of RN-171 apply to the RN-XV.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Supports Adhoc and Infrastructure mode connections Push Button WPS mode for easy network configuration On board TCP/IP stack Wi-Fi Alliance certified for WPA2-PSK FCC / CE/ ICS certified and RoHS compliant Features Host Data Rate up to 1 Mbps for UART, 2 Mbps over SPI slave Memory 128 KB RAM, 2 MB ROM, 2 KB battery-backed memory, 8 Mbit Flash.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 3. Configuration 3.1. Entering Command Mode There are two modes in the WiFly module, namely data mode and command mode. In data mode, the module is ready to either accept incoming connections or initiate outgoing connections. To configure the parameters and/or to view the current configuration, the module must be put into command mode (also called configuration mode). At any given time, the module will either be in command mode or in data mode.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Type $$$ in the terminal emulator. You should see CMD returned to you. This will verify that your cable and comm. settings are correct. Most valid commands will return an AOK response, and invalid ones will return an ERR description. To exit command mode, type “exit“. NOTE: You can enter command mode locally over the UART interface at any time when not connected, and also when connected if the appropriate settings are enabled.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 With the adhoc jumper in place the above settings override the current saved configuration settings. From your computer, connect to the WiFly-GSX-XX network. This is an open network that does not require a pass phrase or pass key. Currently the WiFly only supports OPEN mode for creating adhoc networks. NOTE: It may take a couple of minutes for Auto IP in Windows to assign an IP address and connect to the network.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 4. WiFly Command Reference 4.1. Command Syntax To configure different parameters of the module, it needs to be put into command (configuration) mode. This is done by sending the escape sequence of three dollar signs $$$ After the module sees this escape sequence, it will respond with a CMD indicating that it is in command mode. NOTE: The escape sequence is $$$ ONLY. There is no carriage return or line feed after the third dollar sign.
WiFly GSX/EZX www.rovingnetworks.com FILE IO COMMANDS WiFly-RN-UM 11/9/2011 Upgrade, load and save configuration, delete files, etc. NOTE: You must save any changes made or the module will load the previous settings upon reboot or power up. Configuration is saved using the save command. When the system boots, all configuration data is loaded into RAM variables from the file called “config”. The set commands actually only modify the RAM copy of variables in the system.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 5. SET Commands These commands begin with “set”. There are 6 major categories.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 5.3. COMM Parameters set comm $ sets character used to enter command mode. Typically used when “$$$” is a possible data string. Care should be taken when setting this to note the new character as once this setting is saved every subsequent reboot will ignore “$$$” and look for “”. Default is ‘$’ set comm close sets the ASCI string that is sent to the local UART when the TCP port is closed.
WiFly GSX/EZX www.rovingnetworks.com set comm time WiFly-RN-UM 11/9/2011 sets the flush timer. An IP packet will be sent if no additional bytes are received for “num” milliseconds. “num” is one milliseconds interval. Default is 10 (10 milliseconds). Setting this value to 0 will disable forwarding based on the flush timer. Flush timer is one of three ways to control TCP/IP packet forwarding. The others are match character and size. For more information refer to section on UART Receiver. 5.4.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 set ftp user sets the ftp user name for accessing the FTP server. Default is roving set ftp pass sets the ftp password for accessing the FTP server. Default is Pass123 5.6. IP Parameters set ip address sets the IP address of the WiFly GSX module. If DHCP is turned on, the IP address is assigned and overwritten during association with the access point. IP addresses are “.” delimited. Example: set ip a 10.20.20.
WiFly GSX/EZX www.rovingnetworks.com set ip flags WiFly-RN-UM 11/9/2011 Set TCP/IP functions. Value is a bit mapped register. Default = 0x7. Bit 0 1 2 3 4 5 6 7 Function TCP connection status.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 use the TCP Server protocol / bit 2 set. To accept both TCP and UDP use value = 3 (bit 1 and bit 2 set) Bit Position 0 1 Protocol UDP TCP Server & Client (Default) Secure (only receive packets with IP address matches the store host IP) TCP Client only HTTP client mode 2 3 4 set ip remote sets the remote host port number. set ip tcp-mode A new register called TCPMODE is added to the IP parameters in version 2.27 and later.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 5.7. Optional Parameters set opt jointmr Join timer is the time in milliseconds the join function will wait for the an access point to complete the association process. This timer is also the timeout for the WPA handshaking process. Default is 1000. set opt format settings for HTTP client/web server value is a bitmapped register. See section on web server modes for more details.
WiFly GSX/EZX www.rovingnetworks.com set opt password WiFly-RN-UM 11/9/2011 TCP connection password. Provides minimal authentication by requiring any remote device that connects to send and match a challenge . When set, all newly opened connections must first send the exact characters that match the stored password otherwise the WiFly module will close the connection. When the password is set the WiFly module sends the string “PASS?” to the remote host.
WiFly GSX/EZX www.rovingnetworks.com set sys printlvl WiFly-RN-UM 11/9/2011 Controls debug print messages. This configures the debug messages printed by the WiFly module on the UART. Default=1. Please refer section 10.6 on Setting Debug Print levels. Value 0 1 2 4 0x4000 0x10 Description Quiet mode. No messages printed when module wakes up or powers up.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM Bit Position 0 1 2 3 4 5 11/9/2011 Description Trigger Sensor Input 0 Trigger Sensor Input 1 Trigger Sensor Input 2 Trigger Sensor Input 3 Enable WPS function Enable sleep on GPIO 8 The following table describes how the WiFly module can be woken on sensor input.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 To configure GPIO as outputs, use the set sys mask command. For Example, to configure power-up states of GPIO8 (output by default) the commands are: set sys value 0x0100 set sys value 0x0000 //sets GPIO8 HIGH upon power-up //sets GPIO8 LOW upon power-up NOTE: GPIOs 4, 5 and 6 are used by firmware to blink status LEDs.
WiFly GSX/EZX www.rovingnetworks.com set uart instant WiFly-RN-UM 11/9/2011 This immediately changes the baudrate. This is useful when testing baudrate settings, or switching baudrate “on the fly” remotely while connected over TCP (Telnet). This setting does not affect configuration. Returns the AOK response, and then this command will exit command mode. In firmware version 2.22 and later, we fixed a bug wherein the WiFly module would not return an AOK over telnet.
WiFly GSX/EZX www.rovingnetworks.com set uart mode WiFly-RN-UM 11/9/2011 sets the UART mode register. This is a bit-mapped value. Bit Position 0 1 2 3 4 8. Function NOECHO - disables echo of RX data while in command mode DATA TRIGGER makes connection on RX data Reserved for future use Enable Sleep on RX BREAK signal UART RX data buffer. See note below for details* 9. Version string <2.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 5.11. WLAN Parameters set wlan auth Sets the authentication mode. Not needed unless using auto join mode 2. i.e. set wlan join 2 Note: During association the WiFly module interrogates the Access Point and automatically selects the authentication mode.
WiFly GSX/EZX www.rovingnetworks.com set wlan join WiFly-RN-UM 11/9/2011 sets the policy for automatically joining/associating with network access points. This policy is used when the module powers up, including wake up from the sleep timer. Value 0 1 2 3 4 Policy Manual, do not try to join automatically Try to join the access point that matches the stored SSID, passkey and channel. Channel can be set to 0 for scanning.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 set wlan linkmon sets the link monitor timeout threshold. If set to 1 or more, WiFly will scan once per second for the AP it is associated with. The value is the threshold of failed scans before the WiFly declares “AP is Lost”, deauthenticates. The WiFly will retry the association based on the join policy variable. A value of 5 is recommended, as some APs will not always respond to probes. Default is 0 (disabled).
WiFly GSX/EZX www.rovingnetworks.com set wlan rate WiFly-RN-UM sets the wireless data rate. Lowering the rate increases the effective range of the WiFly-GSX module. The value entered is mapped according to the following table: Value 0 1 2 3 4-7 8 9 10 11 12 13 14 15 set wlan ssid 11/9/2011 Wireless Data Rate 1 Mbit/sec 2 Mbit/sec 5.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 5.12. Sensor Parameters set q sensor Bitmask value that determines which sensor pins to sample when sending data using the UDP broadcast packet, or the HTTP auto sample function. NOTE: The sensor pins variable has been changed from “set option sensor ” to set q sensor in ver 2.23 set q power This register is used to automatically turn on the sensor power. This is a 8 bit register with two 4 bit nibbles.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 6. Get Commands These commands begin with “get”. They display the current values. get adhoc display all adhoc settings. get broadcast will display the broadcast UPD address, port and interval get com display comm. settings. get dns display DNS settings. get everything get ftp displays all configuration settings, useful for debug. display FTP settings. get ip display IP address and port number settings.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 7. Status Commands These commands begin with “show”, and they return the current values of variables in the system. In some cases, for example IP addresses, the current values are received from the network, and may not match the stored values.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 8. Action Commands $$$ enter command mode. X characters are PASSED until this exact sequence is seen. If any bytes are seen before these chars, or after these chars, in a 250ms window, command mode will not be entered and these bytes will be passed on to other side. close disconnect a TCP connection. exit exit command mode. Exit command mode. “EXIT” will be displayed. factory RESET Loads factory defaults into the RAM configuration.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 ping g pings the gateway, the gateway IP address is loaded if DHCP is turned on, otherwise it should be set with the set ip gateway command ping h pings the stored host IP address, the host IP address can be set with the set ip host command ping i pings a known Internet server at www.neelum.com by first resolving the URL (proves that DNS is working and proves the device has internet connectivity).
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 9. File IO Commands del Deletes a file. Optional will override the name and use the sector number shown in the “ls” command. load Reads in a new config file. ls Displays the files in the system save Saves the configuration to “config” (the default file). save Saves the configuration data to a new file name boot image Makes file the new boot image.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 10. Advanced features and Settings This chapter describes the advanced features of the WiFly module. It describes the techniques to put the module in sleep, wake up from sleep and methods to open a TCP connection when awake. We also discuss the uart flow control, alternative GPIO functions and Real Time Clock. The table below describes the possible methods of putting the module to sleep.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 When the module wakes up from sleep, it takes a certain amount of time (in milliseconds) to initialize the internal hardware. During this time, any data that is sent to the WiFly module over the uart will not be processed. You can monitor certain signals that indicate that the module is ready to accept data. These are described below.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 The WiFly module has the following timers available: 1. 2. 3. 4. Sleep Timer: Used to put the WiFly module to sleep Wake Timer: Used to wake the WiFly module from sleep Auto-connect Timer: Used to automatically open a TCP connection Idle Timer: Used to automatically close a TCP connection There are 2 timers that can be used to put the module to sleep, and perform a wake up.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 The above diagram shows the transitions between the Sleep state and Awake state based on the sleep and wake timers. 10.1.1. UDP sleep and Connection timers In UDP Only protocol mode (set ip proto 1), the autoconn timer is used as an auto-sleep timer. Upon the start of transmission of the first UDP data packet this timer will count down, after which the module will go to sleep.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Closing the TCP connection: In TCP-Client AND TCP-Server mode (default mode), there is also a disconnect timer. This timer can be used to automatically close a TCP connection after a specified number of seconds with no transmit or receive data. set comm idle For example, to close the TCP connection after 5 seconds of inactivity, use the set comm idle 5 command. The default value of the comm idle timer is 0, never disconnect on idle. 10.2.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 10.3. Wake on UART When the module is in sleep mode, the UART itself is disabled. However, wake on UART can be accomplished by connecting the SENSE pins to the RX data or CTS pin. (Using the appropriate divider resistors mentioned above) The RN-134 and the RN-174 development boards have a built in resistor divider connecting SENSE 0 and SENSE 1 to RXD and CTS respectively. This allows wake on RX and CTS using a 3.3V signal. NOTE: Do not apply 3.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 set comm time sets the flush timer, this is used to make sure that any partial data sitting the RX buffer if no additional data is seen for “value” milliseconds. For example set comm time 1000 would wait for 1 second after no data was sent. When sending more than a few hundred thousand bytes in a single transaction you should enable hardware flow control. Your hardware will need to actively monitor CTS.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 The LEDs on the RN-134) are connected to GPIO 4, 5 and 6. To disable the LEDs, enable the alternative functions of the LEDs (set sys iofunc 0x7). NOTE: The Yellow, Red and Green LEDs can be turned off. The Blue LED on the RN-134 is the power LED and cannot be turned OFF. The Blue LED on the RN-174 is connected to GPIO7 which is output by default. This LED is not driven by the RN-174 board as the default powerup state of GPIO7 is LOW.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 NOTE: The Blue LED is connected to GPIO7 on the Wi-Fi Serial Adapter (RN-370) and the RN-174 development board. 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 as it is directly connected to power. 10.5.1. Setting the alternate GPIO functions The default functions of GPIO 4 5, 6 is to control the LED functionality.
WiFly GSX/EZX www.rovingnetworks.com 10.5.2. WiFly-RN-UM 11/9/2011 Controlling connections with GPIO In embedded applications it is useful to monitor and control the status of the TCP/IP connection. This can be done by enabling the alternate function of GPIO 4, 5 and 6. With the alternate function for these GPIO set, the module will connect to the stored remote host IP address and port when GPIO-5 is driven high and disconnect when driven low.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 10.6. Setting Debug Print levels There are a number of print functions that can be enabled to assist in debugging the operation and status of the module. The following command is used to control these printouts. set sys printlvl sets additional print functions. Value is a bit-mapped register that controls which printout messages are sent to the UART. Print level 0 1 2 4 0x4000 0x10 Description Quiet mode.
WiFly GSX/EZX www.rovingnetworks.com 10.6.1. WiFly-RN-UM 11/9/2011 Enabling new scan format Firmware version 2.22 and higher supports a new comma delaminated scan output format. This format is intended for parsing the RSSI information by microprocessors. The new scan command output format is: Row Count Channel RSSI value (dBm) Security Mode Capabilities Access Point MAC Address SSID The new scan format is enabled using the set sys printlvl 0x4000.
WiFly GSX/EZX www.rovingnetworks.com 10.6.2. WiFly-RN-UM 11/9/2011 UART Heartbeat messages In version 2.22 and later the WiFly module can output UART heartbeat messages. The bit-mapped message is output periodically while in data mode and not connected to a remote host. Messages are not output while in command mode. The heartbeat message encodes the state of the WiFly module for the embedded microprocessor.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 10.7. Using the Real Time Clock Function The real time clock in the module keeps track of the number of seconds since the module was powered on and the actual time when synchronized with the sNTP time server. By default the module keeps track of up time but does not synchronize with the time server since this requires being associated with a network that can access the sNTP server. The Real Time clock reads the time is seconds since 1970.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 <2. 23> get time ENA=1 ADDR=129.6.15.28:123 ZONE=7 To view a complete listing of the time variable use the command <2. 23> show t t Time=09:02:10 UpTime=653 s RTC=1293567548 Restarts=1 Wake=6 RAW=2345ab NOTE: The RAW value is the 64 bit hex RAW value of the RTC which ticks at 32768 Hz. 10.8. Time Stamping Packets This feature can be used to automatically append 8 bytes to a TCP or UDP packet.
WiFly GSX/EZX www.rovingnetworks.com 11. WiFly-RN-UM 11/9/2011 Sending data using UDP 11.1. Overview UDP is a connectionless protocol. There is no initial handshaking between the hosts to set up the UDP connection. There are no acknowledgements sent by the receiver for UDP packets that it receives. This makes UDP an unreliable protocol, as there is no guarantee that the data will be correctly delivered.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 11.2. UDP Auto Pairing UDP auto pairing feature temporarily stores the Host IP address of the first remote device that send a UDP packet into the module. This host IP address is stored in the RAM which will not survive a sleep or power cycle. This feature allows the WiFly module to echo back to any client that sends a UDP packet. To use this feature, the host IP addresses and set the ip flags. set ip host 0.0.0.0 set ip flags 0x40 11.3.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 The format of the packet is 110 bytes of data. AP MAC address Chan Bytes 0-5 6 7 8 10 14 16 18 32 60 92 94 Size 6 1 1 2 4 2 2 13 26 32 2 16 RSSI Local TCP port Real Time Clock Battery Voltage GPIO pins Time of day Version and date code User DEVIC EID Boot time SENSO R pins MAC address of AP that we are Associated with (for location) Channel we are on.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 12. Joining Networks and Making Connections Configuring the module to make connections is a two set process. First you need to associate with a access point (AP) and second you need to open a connection. To configure the module over the WiFi link is a chicken and egg problem. The module must be associated to a network to connect to it and program the network settings.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 You could also have specified the roving1 access point by using the command join # 1 If the access point is security enabled you will need to set the pass phrase prior to issuing the join command. The RN-131G module will attempt to inquire and determine the security protocol of the access point so you do not have to set the authentication mode. To set the pass phrase for WPA use the command set wlan phrase .
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 12.3. Setting up Automatic Connections Often, it is desired on power up (or wakeup) to automatically connect out to a remote server, send data, and then disconnect. This can be configured to happen automatically. In the following example assume the network SSID and security have been set correctly and autojoin is set to 1.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 12.5. Using DNS settings WiFly contains a built in DNS client. If the IP address of the host is not specified (i.e it is set to 0.0.0.0), the DNS protocol will be used. WiFly will automatically attempt to resolve the host address stored with the command: set dns name sets the name of the host for TCP/IP connections. Once the address is resolved an automatic connection will be made.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 13. Using HTML client feature The WiFly GSX module has a built in HTML client. When enabled, the WiFly GSX module is capable of getting or posting data to a web server. Using the HTML client, it is now possible to post serial and/or sensor data to the host web server. This feature make is possible to provide Wi-Fi capabilities to applications such as GPS units, remote sensors, weather station, etc.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 13.1. Built-in HTML Client Modes WiFly can be setup to automatically post data to and get data from a web server without any external HOST CPU. The advanced web features are enabled using the “set option format ” command. This is a bit mapped register. The functions of the bits are described in the table below: set option format Bitmapped value.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 13.2. Automatically connect to web server WiFly module can be setup to automatically post data to a webserver. The auto connect feature is enabled by the set sys auto command. For example, the WiFly module can be configured to connect to the web server every 10 seconds by using the set sys auto 10. The example below illustrates the commands to configure WiFly for connecting to the web server every 30 seconds. set com remote GET$/ob.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 13.4. Posting binary data: Web servers expect ASCII data, so if the User data is binary, WiFly can convert binary data to ASCII format before sending it to the web server. Example: using the same settings as above but this time use the set ip proto 18 // turn on HTTP mode=0x10 + TCP mode = 0x2 set dns name www.webserver.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 In the above example, the data format is 2 Bytes GPIO 0F30 Channel 0 0000 Channel 1 1111 Channel 2 2222 Channel 3 3333 Channel 4 4444 Channel 5 5555 Channel 6 6666 Channel 7 7777 13.6. Examples using the HTML client Example#1: Auto posting sensor data: In this example, we will connect to the web server at www.rovingnetworks.com/server.php?value= and send the sensor data as a web post to the web server every 60 seconds.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Example#2: Posting UART data to web server The WiFly module is capable of auto posting serial UART data in ASCII or Binary format. In this example we will configure the WiFly module such that when the serial UART data comes in, the WiFly will connect and automatically send data to the web server in the following format: GET /server.php?value= \n\n The other parameters that need to be set are described below: set dns name www.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 With the above settings enabled, the WiFly module will connect out 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. . NOTE: You cannot append the sampled sensor data to the UART data. Enabling “option format 7” along with “set uart mode 2” will result in erroneous data being sent.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 14. Firmware Upgrade over FTP WiFly module has a file system for storing firmware and config files. Use the ls command to view files.. File size is displayed in sectors and the active boot image is identified in the final message. FL# 11 29 SIZ 18 1 FLAGS 3 10 WiFly_GSX-2.21 config 190 Free, Boot=11, Backup=0 Multiple firmware images and config files can be stored on the module file system.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 NOTE: After the module reboots with the new firmware, it is recommended to reset the module to factory default parameters using the factory R command. Failure to do so may result in some variables being initialized with random values. The previous firmware will become the backup image. Here is an example of what you should see after a successful update: FL# 11 29 30 SIZ 18 1 18 FLAGS 3 10 3 WiFly_GSX-2.20 config WiFly_GSX-2.
WiFly GSX/EZX www.rovingnetworks.com 15. WiFly-RN-UM 11/9/2011 FTP Client Roving Networks adds FTP client capability to its standard firmware which enables the WiFly module to “get” and “put” files to a FTP server. Earlier, FTP was used by the WiFly modules to update firmware only. Now, with the release of firmware version 2.22, it is possible to get and put files to a FTP server in addition to upgrading the module firmware.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 There are two options to close the file. A file can be closed either by sending the close string. By default the close string is *CLOS*. The second method to close the file is by using the FTP close timer set ftp timer . Once you finish writing to the file, this timer will start counting down and close the file when the timer counts down to zero. The timer is 1/8th of the actual value.
WiFly GSX/EZX www.rovingnetworks.com 16. WiFly-RN-UM 11/9/2011 Wi-Fi Protected Setup (WPS) 16.1. Introduction to WPS Wi-Fi Protected Setup (WPS) is a standard for easy and secure establishment of a wireless home network, 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 wireless networks.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 16.2. Launching the WPS application Once the module is updated to version 2.28 (or later) and the WPS App is installed, there are two modes of invoking the WPS function: 1. From the console, use the “wps” command 2. By using the ADHOC/factory reset GPIO 9: In this mode, the WPS app is invoked when GPIO goes from LOW to HIGH. This can be achieved on the RN-134 and RN-174 boards by installing and removing the Adhoc/factory reset jumper.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 16.4. Updated scan output format to show WPS enabled AP The scan output is modified to show AP that support WPS feature. Also, when a scan is performed after the WPS button is pushed on the AP, the scan returns a –A to indicate the AP is in WPS “active mode”. In the above diagram, the APs that support WPS are listed with WPSPB in the security suites. When the WPS button is pushed on an AP, it will show up as –A shown below.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 17. Adhoc Networking Mode 17.1. Infrastructure and adhoc comparison There are two types of networks. The most common network is infrastructure in which an access point (AP) is the common point linking all Wi-Fi devices. The access point keeps track of who’s on the local network and directs IP packets. In many cases the AP is also a router and will forward packets from the local network to other networks and the internet.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 To enable adhoc mode from software: From command mode, the module is configured for adhoc mode using the join command. You will also need to set the ssid and channel. set wlan join 4 set wlan ssid my_adhoc_network set wlan chan 1 Turn off DHCP and set the IP address and netmask so other devices know where to connect to the adhoc WiFly GSX. Since auto IP fixes the first two bytes of the IP address you want to use the netmask of 255.255.0.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Open the “Control Panel / Networking and Sharing / Networking and Sharing Center” dialog in Vista or “Control Panel / Network Connections” dialog in Windows XP. From here, view available networks and select the name of the adhoc network. NOTE: Once associated with the adhoc network, Vista auto IP may take a couple minutes to allocate an IP address for your computer.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 18. Analog Sensor Capability The WiFly-GSX has 8 analog sensor inputs that can be driven between 0 to 1.2VDC. The analog inputs are sampled and the digital value read by using the show q command. Warning: Driving these inputs above 1.2V will cause permanent damage. The hardware specifications of the analog input is: Input voltage range: 0 - 1.2 V, however the A2D saturates at 400mV.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 18.1. Automatic sampling of sensor pins: The sensor pins can be automatically sampled and data forwarded in 2 modes: 1. the UDP broadcast packet will contain the value of the samples. 2. in HTTP mode, the pin sampled data can be forwarded to a remote server to enable the above modes, use the set q sensor command. For example, to sample all sensors inputs, use the set q sensor 0xff command. 18.2.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Example: To set the power to 1.2V automatically upon power up, the command would be set q power 0x20. To set sensor power to 1.2V when sampling event occurs, the command is set q power 0x02 Example: To set the power to 3.3V automatically upon power up, the command would be set q power 0x40. To set sensor power to 3.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 19. Default Configuration Settings as of version 2.28 firmware ADHOC PARAMETERS Beacon Probe Reboot 100 (milliseconds) 5 (seconds to look for beacons before declaring adhoc is lost) 0 (Unused parameter for future development. Please leave it to default values) BROADCAST PARAMETERS IP address 255.255.255.
WiFly GSX/EZX www.rovingnetworks.com Protocol MTU Flags TCP mode Backup WiFly-RN-UM 11/9/2011 2 ( TCP server and client ) 1524 0x7 0x0 0.0.0.
WiFly GSX/EZX www.rovingnetworks.com Linkmon Passphrase TX Power WiFly-RN-UM 11/9/2011 0 rubygirl 0 (which implies 12 dBm) Applicable to RN-171 module only 809 University Avenue • Los Gatos, CA 95032 • Tel (408) 395-6539 • info@RovingNetworks.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 19.1. Restoring Default configuration settings: From command interface use the factory RESET command to restore the defaults. This command automatically loads default settings, and executes a “save” command. You then need to issue the reboot command so that the module reboots with the default configurations.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 20. Boot-up Timing Values Function Power up Initialization Ready Join Description Powerup Time from Reset HIGH or power good to boot code loaded.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 21. Supported Access Points Access points that are set to MIXED mode (WPA1 and WPA2) may cause problems during association because some of these incorrectly report their security mode. We also currently do not support WPA2-Enterprise (radius server authentication, EAP-TLS) The WiFly GSX should work with any standard Access Point.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 22. Release Notes 22.1. Known problems The UART does not support odd or even parity, only no parity is supported. Flow control: RTS may fail to de-assert quickly enough for some high speed CPUs to correctly stop sending data bytes. For high speed transfers at baudrates > 460800, it is best to limit RX data to the maximum Ethernet frame (1460 bytes) and have a protocol to acknowledge data is received by the remote host. 22.2.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 As of ver 2.23 04/03/2011 Firmware fixes and features: 1. Created new set of sensor commands: set q sensor and set q sensor . 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. 2. Added a new FTP client mode to get and put files to a FTP server.
WiFly GSX/EZX www.rovingnetworks.com WiFly-RN-UM 11/9/2011 Added new setting to the UART mode “set uart mode 0x10". Features: Disabled the auto-join feature when in command mode. Auto-join causes WiFly 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.
