background image

 

 

WiSnap User Manual 2.21 04112011-JF 

Page 

11

 of 

66

 

 

 

Remote configuration using AD-HOC mode  

 
Using ad-hoc mode to configure the device eliminates the need for the module to be associated with 
a network access point.  In ad-hoc mode the module creates it own “on demand” network that you 
can connect to via your computer like you would to any other network. 
 
To enable ad-hoc mode via hardware, set 

PIO9 

high (3.3V) at power up.  On the WiSnap M1, PIO9 is 

on the J1 jumper block, and dipswitch 1 on the WiSnap AAA.  When the module powers up with PIO9 
set high, the WiSnap module creates an ad-hoc network with the following 

SSID:   

WiSnap-XX - where XX is the final two bytes of the device’s MAC address 

Channel: 

DHCP:  

OFF 

IP address:   169.254.1.1 
Netmask: 

255.255.0.0 

 
With the ad-hoc jumper in place, the above settings override the saved software configuration 
settings.   
 
From your computer or smartphone, connect to the WiSnap-XX network.   This is an open network 
which does not require a pass phrase or pass key. 

 
NOTE:

 currently the WiSnap only supports OPEN mode for creating ad-hoc networks.  

 

NOTE:

 It may take a couple of minutes for Auto IP in Windows to assign an IP address and connect 

to the network.   You can check IP address of your Windows computer by running the 

ipconfig

 

command in a command window. If connected, this command will show you the IP address and 
netmask for your computer. 
 
Your IP address must be on the 169.254.x.y subnet otherwise the WiSnap module will not be 
accessible.  
 

NOTE:

 If your machine has both a wireless and wired network interface, you may need to disable 

the wired LAN interface hardware before connecting to the ad-hoc network.  If the wired LAN is 
enabled, the computer may assign an IP address that is not on the same subnet as the WiSnap 
module. 
 
Once connected and you have a valid IP address, telnet into the WiSnap module on port 2000 with 
this command in Windows: 

telnet 169.254.1.1 2000 

You should see the response “*HELLO*” 
 
You can now enter command mode and configure the module. 
 

3.2

 

Common Configurations 

 
Two common modes of operation for the WiSnap module are A) initiating a connection to a server 
and B) listening for a remote host connection. This section will go through the configuration for each 
setup.  The setups are shown using infrastructure network. i.e. with an access point, however the 
same can be done with ad-hoc networking. 
 

Initiating a connection from the WiSnap 

 

Step 1: Set up the WLAN properties so the device will connect to the network automatically upon power up. In this 
example we want to connect to the wireless network my_network. 

Summary of Contents for WiSNAP

Page 1: ...ART 6 2 4 Status Indictors 6 2 4 1 WiSnap M1 SuRFBoard 6 2 4 2 WiSnap AAA Dongle 7 2 5 WiSnap M1 External Antenna 7 2 6 Additional WiSnap AAA Dongle Notes 7 2 6 1 Power Switch and Sleep 7 2 6 2 Dipswi...

Page 2: ...nction 38 10 8 Time Stamping Packets 39 11 Sending data using UDP 40 11 1 Overview 40 11 2 UDP Auto Pairing 40 11 3 UDP Retry 41 11 4 Using the UDP Broadcast function 41 12 Joining Networks and Making...

Page 3: ...21 04112011 JF Page 3 of 66 17 1 Restoring Default configuration settings 58 18 Boot up Timing Values 59 19 Supported Access Points 60 20 Release Notes 61 20 1 Known problems 61 20 2 Current Firmware...

Page 4: ...hoc and Infrastructure mode connections On board ECOS OS TCP IP stacks Wi Fi Alliance certified for WPA2 PSK FCC CE ICS certified and RoHS compliant Features Host Data Rate Up to 2 7 Mbps for UART Mem...

Page 5: ...es 1 The Sensor inputs SENS0 7 are extremely sensitive to over voltage Under no conditions should these pins be driven above 1 2VDC Placing any voltage above this will permanently damage the radio mod...

Page 6: ...set is active LOW and is optional does not need to be connected The reset pin is 3 3V tolerant and has an internal pull up of 100K to the VBATT 2 3 UART Note The following only applies to the WiSnap M...

Page 7: ...seful if the device will be embedded inside of another metal casing The FCC certified antenna has the following specifications Center Freq 2 45 GHz Bandwidth 120MHz Wavelength wave VSWR 1 9 typ At cen...

Page 8: ...config file named user on the WiSnap AAA Dongle file system it is read in as the factory defaults instead of using the hardcoded defaults If no user config file is present the hardcoded factory defau...

Page 9: ...these are enabled with the jumper do not exceed 3 3 VDC or permanent damage can occur Male Units Female Units Male DB9 Default Config Female DB9 Default Config Jumper 1 2 3 4 Jumper 2 4 1 3 Male DB9...

Page 10: ...de locally over the UART interface at any time when not connected and also when connected if the appropriate settings are enabled NOTE When the WiSnap module is powered up it tries to auto associate t...

Page 11: ...You can check IP address of your Windows computer by running the ipconfig command in a command window If connected this command will show you the IP address and netmask for your computer Your IP addre...

Page 12: ...and no data has been transferred for 30 seconds set sys sleep 120 sleep after 2 minutes if no connection set sys trigger 2 wake on CTS set conn idle 30 disconnect after 30 seconds of no data save sav...

Page 13: ...should to occasionally wake up and listen for the remote host The trade off with these timers is that the longer you sleep the better your battery life will be but the longer it will take the remote...

Page 14: ...what is going on with the interface IP status etc ACTION COMMANDS Perform action such as scan connect disconnect etc FILE IO COMMANDS Upgrade load and save configuration delete files etc NOTE You must...

Page 15: ...addr sets the address to which the UDP hello heartbeat message is sent The default address is 255 255 255 255 set broadcast interval value sets the interval at which the hello heartbeat UDP message is...

Page 16: ...l be sent each time value bytes are received Default is 64 bytes You should set this value to the largest possible setting to maximize TCP IP performance Maximum value 1420 at 9600 bytes NOTE This val...

Page 17: ...ss gateway netmask and DNS server are requested and set upon association with access point Any current IP values are overwritten DHCP Cache mode can reduce the time it takes the module to wake from de...

Page 18: ...nd TCP is connected the connection will be closed set ip gateway addr sets the gateway IP address If DHCP is turned on the gateway IP address is assign and overwritten during association with the acce...

Page 19: ...other device information This information is sent as part of the broadcast hello packet that is sent as a UDP The current value can be shown with the get option or show deviceid commands Max string si...

Page 20: ...0 5 set sys printlvl value sets numerous print functions 0 quiet 1 connect information Default is 1 set sys output value mask sets output PIO pins to HIGH or LOW Bit mapped value Optional mask only se...

Page 21: ...trol is enabled it is important to properly Drive the CTS pin active LOW enabled If CTS is HIGH data will NOT be sent out the UART and further configuration in command mode will be problematic as no r...

Page 22: ...active use 0 for chip antenna 1 for UF L connector Default 0 Only one antenna is active at a time and the module must be power cycled after switching the antenna set wlan join value sets the policy fo...

Page 23: ...commended as some APs will not always respond to probes Default is 0 disabled Without enabling this feature there is no way to detect if an AP is no longer present until it becomes available again if...

Page 24: ...it sec 10 12 Mbit sec 11 18 Mbit sec 12 24 Mbit sec default 13 36 Mbit sec 14 48 Mbit sec 15 54 Mbit sec set wlan ssid string sets the WLAN SSID to associate with 1 32 chars NOTE If the passphrase or...

Page 25: ...display FTP settings get ip a display IP address and port number settings If the a parameter is added on only the current IP address value will be shown get mac display the device MAC address get opt...

Page 26: ...vels status in this HEX format 8ABC Example show i returns 8103 indicates pins 0 1 and 9 high level show net Displays current network status association authentication etc show rssi Displays current l...

Page 27: ...ed from the scan command If network is security enabled you must set the pass phrase with the set wlan phrase command prior to issuing the join command leave disconnects from currently associated Acce...

Page 28: ...s the total scan time down to about 1 second This command also works in ad hoc mode If the optional P parameter is entered the module will perform a passive scan and list all APs that are seen in pass...

Page 29: ...onfig file ls Displays the files in the system save Saves the configuration to config the default file save name Saves the configuration data to a new file name boot image num Makes file num the new b...

Page 30: ...f UART data A better way is to wake up the module on CTS pin Refer section 10 3 for details CTS Pin 3 3VDC ONLY CTS pin via Sensor 1 The CTS pin on the RN 134 is tied to Sensor pin 1 Use set sys trigg...

Page 31: ...WiSnap module is asleep This makes it possible to put the module to sleep and wake up from sleep based on timer intervals using timers The WiSnap module has the following timers available 1 Sleep Tim...

Page 32: ...mer Setting value 0 disables autosleep timer The UDP auto sleep timer is set using two variables The timer interval is a product of the autosleep value and the comm flush timer in milli seconds The ti...

Page 33: ...the set comm idle 5 command The default value of the comm idle timer is 0 never disconnect on idle 10 2 Wake on Sensor Input SENSE 0 to 3 inputs are available to wake the module from sleep SENSE 0 to...

Page 34: ...Flow Control The UART receive buffer is approx 1500 bytes and at lower baudrates less than 115K the system can psend data over TCP IP without the need for flow control Depending on the frequency and q...

Page 35: ...and set the value Otherwise you will over write any previous GPIO settings The hex value represents a bit mask that controls each pin where 1 output and 0 input For example set sys mask 0x0 sets all...

Page 36: ...to power off the Blue LED on the SuRFBoard 10 5 1 Setting the alternate GPIO functions The defaults for GPIO 4 5 6 is to control the LED functionality This default functionality can be overridden to a...

Page 37: ...O 5 and GPIO 6 2 20 set ip host addr set the IP address of the remote host 2 20 set ip remote port set the IP port of the remote host 2 20 set sys iofunc 0x60 set alternate function for GPIO 5 and GPI...

Page 38: ...associated with a network that can access the sNTP server The default sNTP server is at ADDR 129 6 15 28 123 ZONE 7 GMT 7 Use the show time command to see the current time and uptime 2 20 show t Time...

Page 39: ...default settings TIME STAMP MSB to LSB User s TCP or UDP packet Data 63 56 55 48 47 40 39 32 31 24 23 16 15 8 7 0 The 8 bytes represents the 64 bit raw value of the Real Time Clock register The data i...

Page 40: ...ip local port set the port number on which the WiSnap module will listen save saves the settings in config file reboot reboots the module so that the above settings take effect NOTE If you attempt to...

Page 41: ...he package that can be used for auto discovery For example the IP address and port number of the WiSnap are both part of the packet and thus the WiSnap can be connected to and configured remotely with...

Page 42: ...WiSnap User Manual 2 21 04112011 JF Page 42 of 66 NOTE To add sensor data to the UDP broadcast message the sensors have to be enabled using the sensor mask set q sensor 0xff enables all sensors...

Page 43: ...dow on IP address 169 254 1 1 port 2000 If configuring the module using the UART mode either using the RS232 or development board open a terminal emulator on the COM port associated with that deveice...

Page 44: ...g this program note the IP address of the machine it is running on This can be found by running ipconfig in the Microsoft command window With the WiSnap module in command mode type open addr port The...

Page 45: ...ion status 12 5 Using DNS settings WiSnap 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 WiSnap will automatically...

Page 46: ...u can send open www webserver com 80 The user s microprocessor should write to the UART GET ob php obvar WEATHER n n Where the n is the LINEFEED character decimal 10 or hex 0xa Two linefeeds are requi...

Page 47: ...r 13 3 Automatically connect to web server on UART data WiSnap supports a mode in which it can connect to the web server when it receives UART data In this mode connection to the web server will be tr...

Page 48: ...ver port set com remote GET userprog php DATA sample server application set q sensor 0xff sets WiSnap to sample all 8 sensor channels set sys auto 30 automatically make the connection every 30 seconds...

Page 49: ...sting serial UART data in ASCII or Binary format In this example we will configure the WiSnap module such that when the serial UART data comes in the WiSnap will connect and automatically send data to...

Page 50: ...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 da...

Page 51: ...Internet IMPORTANT NOTE Do NOT upgrade the firmware with a WiSnap AAA dongle Only the WiSnap M1 module is supported by this firmware ONLY PERFORM FIRMWARE UPDATE AFTER CONFIRMATION WITH FACTORY OR SER...

Page 52: ...ts the current boot image num For example to boot the previous image from above use 2 20 boot image 11 Set Boot Image 11 OK To upload your own firmware or config file to the module change the stored F...

Page 53: ...unications The WiSnap device is in Ad hoc mode the device looks like access point for other Wi Fi devices to join NOTE Currently the WiSnap only supports OPEN mode for creating ad hoc networks Ad hoc...

Page 54: ...an statically set the IP address by disabling the DHCP service and explicitly assigning the IP address set ip address 169 254 1 2 set ip dhcp 0 You can confirm the device has properly connected to the...

Page 55: ...drive precision 200mV reference on analog input 4 read analog input 4 and compute the offset If you read 210mv you would know that the offset is 10mv When you read input 5 you would subtract 10mv from...

Page 56: ...s used for setting the power are described in the table below Value Sensor pin voltage 0 Turn off the sensor power 1 GROUND the sensor pin 2 1 2V internal regulated reference 3 VBATT input pin 4 3 3V...

Page 57: ...timer 0 Cmd char DNS PARAMETERS IP address 0 0 0 0 Name server1 Backup backup2 FTP PARAMETERS Server address 208 109 78 34 Roving default update server port 21 File Wifly GSX img User roving Password...

Page 58: ...functional and toggling PIO9 five 5 times there after causes the configuration setting to restored to the factory reset PIO9 is sampled at about 1 Hz so if using a CPU to generate the signal make sur...

Page 59: ...dy Load configuration and Initialize application 30 Total time to READY 600 Join Associate using channel 0 full channel scan mask 0x1FFF 80 Associate using channel 0 primary channel scan mask 0x421 15...

Page 60: ...o currently do not support WPA2 Enterprise radius server authentication EAP TLS The WiFly GSX should work with any standard Access Point We have tested the WiFly GSX module with the following access p...

Page 61: ...still reporting DHCP OK It is now cleared and new DHCP session will start once AP link is reestablished Fixed a bug whereby UDP receive becomes disabled no packets are received if AP LOST and then re...

Page 62: ...ifications by not responding to WPA authentication within 250ms The set option jointimer xxxx command which specifies the timeout in ms for a join now also applies to the WPA timeout The default is no...

Page 63: ...ng to sleep UART NOECHO mode The command set UART mode 1 is now used to disable echoing of RX chars while in command mode This is useful when embedded controllers are used to send commands to the modu...

Page 64: ...t packet By default the WiSnap module now sends out a UDP broadcast to 255 255 255 255 on port 55555 at a programmable interval The broadcast address port and interval are set using the set broadcast...

Page 65: ...de no listen server only outbound connections can be made Bug fixes Ad hoc mode client associates properly You can now enter the WPA passkey after setting the SSID previously the pass key had to be en...

Page 66: ...ld verify that such information is current and complete SerialIO com assumes no liability for applications assistance or customer product design Customers are responsible for their products and applic...

Reviews: