Redpine Signals RS-WC-301, User Manual

Page 1: ...i io on n 2 2 5 51 1 December 2012 Redpine Signals Inc 2107 N First Street 680 San Jose CA 95131 Tel 408 748 3385 Fax 408 705 2019 Email info redpinesignals com Website www redpinesignals com Redpine Signals Inc 2107 N First Street 680 San Jose CA 95131 Tel 408 748 3385 Fax 408 705 2019 Email info redpinesignals com Website www redpinesignals com ...

Page 2: ...e Security 30 5 1 Radius Server Configuration 30 5 2 AP Settings 33 5 3 Evaluating EAP TLS Mode 34 5 4 Evaluating EAP TTLS EAP FAST and PEAP Modes 36 6 Evaluation of Wi Fi Direct Mode 39 6 1 Configuration and Test Procedure 39 7 Evaluation of Access Point Mode 44 7 1 Configuration and Test Procedure 44 8 Wireless Configuration 47 8 1 Configuration to join a Specific AP 47 8 2 Configuration to crea...

Page 3: ...P exe in Laptop C 28 Figure 10 Enterprise Security Set up 30 Figure 11 Access Point Settings Enterprise Security Mode 33 Figure 12 Command Flow in Enterprise Security Mode 35 Figure 13 Running of Python Script WiFi_Enterprise_TLS py 35 Figure 14 Wi Fi Direct Set up 39 Figure 15 Messages in Hyper terminal 41 Figure 16 Command Flow in Wi Fi Direct Mode 42 Figure 17 Access Point Set up 44 Figure 20 I...

Page 4: ...d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 List of Tables Table 1 UART Header RS WC 301 8 Table 2 Interface Selection 8 Table 3 General Purpose Header RS WC 301 EVB 10 Table 4 General Purpose Header RS WC 301 EVB 11 Table 5 SPI Header Pins 12 Table 6 Sensor Interface Header 13 ...

Page 5: ...Redpine Signals Inc Page 5 R RS S W WC C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 ...

Page 6: ...equirements to quickly evaluate the major functions of the modules The document should be used in conjunction with the Programming Reference Manual PRM where all commands to configure and operate the modules are described in detail Even if the user does not plan to use the UART interface it is recommended to go through the UART sections because all the set ups to evaluate different functionalities...

Page 7: ...nector Note that this connector is used only for supplying power For actual communication using USB the USB interface described below is used Power Selection Switch The power selection switch should be put in the position shown in the figures above so that the board receives power from the USB connector Reset Push button reset for the board Note that there is a power on reset circuit on the board ...

Page 8: ...left unconnected 3 NC This pin must be left unconnected 4 UART RX Input UART Rx pin of the module 5 UART TX Output UART Tx pin of the module 6 UART CTS Not used in current firmware Should be left unconnected 7 UART RTS Not used in current firmware Should be left unconnected 8 GND Ground 9 GND Ground 10 GND Ground Table 1 UART Header RS WC 301 Mode Selection Switches To select the interface in the ...

Page 9: ...he module wakes up from sleep if a logic high is driven into this pin Used only in SPI mode should be left open in UART mode 6 PT_GPIO2 Output Pass through output pin controllable by Host software Not used in current firmware should be left open 7 ADC2 Input Analog input to internal ADC Not used in current firmware should be left open 8 PT_GPIO1 Output Pass through output pin controllable by Host ...

Page 10: ...onnect 19 NC No connect 20 GND Ground Table 3 General Purpose Header RS WC 301 EVB Pin number Pin name Direction Description 1 SPI_READY Output Handshake signal used in SPI mode and connected to a GPIO pin of the Host MCU In other modes this signal can be left open 2 NC No connect 3 RESET_N Input Active low reset input This can be connected to the Host MCU to reset the module from the Host If not ...

Page 11: ...ndicate through logic high that BT is transmitting high priority traffic When BT coexistence is not used this pin should be grounded 14 NC No connect 15 WLAN_ACTIVE Output Used for BT Coexistence It indicates with logic high that WLAN activity is in progress When low BT device has the opportunity to transmit Not used in current firmware should be left open 16 NC No connect 17 NC No connect 18 NC N...

Page 12: ...are put in the direction shown by the green arrow the DB9 connector for UART is selected If the switches are put in the direction shown by the red arrow the UART Header for MCU is selected Sensor Interface Header This header is present RS WC 301 EVB Pin Number Pin Name Direction Description 1 NC No connect 2 NC No connect 3 GND Ground 4 NC This pin must be left unconnected 5 ADC2 Input Analog inpu...

Page 13: ...1 9 or higher for definition of this mode 2 1 Test Setup The following additional components not included with the EVB are required to complete the procedures described here 1 PC with an available serial port and running Windows XP The PC would be interfaced to the UART port of the EVB 2 An 802 11a 11b 11g or 11n Access Point with administrative access to change its settings 3 A RADIUS server for ...

Page 14: ...aluation Board in UART mode The sections should be used in conjunction with the Programming Reference Manual to understand the commands better 3 1 Configure Serial port in PC To know the COM port name check the computer s Device Manager settings The COM port name is displayed in the window Hyperterminal or Teraterm should be opened and configured accordingly with this COM port name The steps for c...

Page 15: ... 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 Open Hyperterminal Baud Rate 115200 bps Data bits 8 Parity None Stop bits 2 Flow Control None Other baud rates are not currently supported ...

Page 16: ...Redpine Signals Inc Page 16 R RS S W WC C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 Click on ASCII Setup ...

Page 17: ...ine Signals Inc Page 17 R RS S W WC C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 Complete the settings as shown below and click OK ...

Page 18: ... C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 Teraterm can also be used The steps for configuring Teraterm are shown below Open Teraterm Configure COM port settings ...

Page 19: ...ytes A free package is available at http www serial port monitor com while other similar software such as Hterm Docklight etc also provide good interfaces to simultaneously view ASCII and actual bytes exchanged in the UART interface The following sections assume that HHD Free Serial Port Monitor has been installed from the above link Open the HHD Free Serial Port Monitor BEFORE opening the Hyperte...

Page 20: ...Redpine Signals Inc Page 20 R RS S W WC C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 ...

Page 21: ...Page 21 R RS S W WC C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 All bytes exchanged through the UART interface will now be visible on the monitor ...

Page 22: ...Redpine Signals Inc Page 22 R RS S W WC C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 ...

Page 23: ...igure 2 Client Mode Set up with Personal Security In this set up the module acts as a client Wi Fi module It connects to an Access Point with WPA2 PSK security It is assumed in this example that the SSID of the AP is Test_AP and IP of the AP is 192 168 50 1 Note The Serial Port Monitor mentioned in the document works reliably in Windows XP machines PC P RS WC 301 A UART Interface Access Point B Te...

Page 24: ...e Signals Inc Page 24 R RS S W WC C 3 30 01 1 E Ev va al lu ua at ti io on n B Bo oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 Figure 3 Access Point Settings Personal Security Mode ...

Page 25: ...be issued Please refer to the Programming Reference Manual for detailed description of the commands and their responses A command should not be sent until the response of the previous command is received a at rsi_opermode 0 This configures the EVB to function in client mode The module responds with OK b at rsi_band 0 This configures the operating band of the EVB The module responds with OK c at rs...

Page 26: ...nse to the command In the terminal this response might appear as unreadable characters because of ASCII conversion The Serial Port Monitor can however be used to see the exact bytes To get the IP is DHCP mode the command is at rsi_ipconf 1 0 0 0 It is assumed in the following sections that an IP of 192 168 50 10 has been assigned i at rsi_ltcp 5001 This command opens a server TCP socket in the mod...

Page 27: ...nd data to the Wi Fi module On being prompted Enter the string to be Transmitted type any string from the Keyboard test in this example On pressing Enter key on the keyboard the data is sent from the Laptop C to the module and the terminal displays it with the AT RSI_READ message c To send data from the Wi Fi module first type Option 2 in Laptop C and then type the below command in the module at r...

Page 28: ...ion of TCP exe in Laptop C 7 HTTP server access The firmware of the module comes with a pre loaded webpage Open the webpage in Laptop C by typing http 192 168 50 10 in the browser of the Laptop 192 168 50 10 is the IP address of the module in this example The source code of the default page is provided in RS WSC x x GENR x x x x x x Resources Applications WebPage webpage html ...

Page 29: ...d Web Fields in the Programming reference manual for more details A new webpage can also be loaded into the module It will overwrite the previously existing webpage For example below is given the source code of a reference page 91 characters in total html head title Untitled Document title head body h1 Hello World h1 body html This can be loaded into the module with the below command at rsi_webpag...

Page 30: ... should be running on a Laptop PC node D in the above figure connected to the Access Point A Linux compatible radius server package is downloadable from http freeradius org Installation instructions can be found in the documentation included in the package Additionally the install process is described below Installation of the Radius Server on a Linux PC If the user wants to use the sample radius ...

Page 31: ...nce Important files for the Radius_Server 1 RS WSC x x GENR x x x x x x Software Applications Radius_server raddb certs wifiuser pem This is the default certificate file provided with the software package The file used for the parameter certificate in the command at rsi_cert when EAP TLS mode is used in the module This certificate file should be present in PC P NOTE To generate a new certificate t...

Page 32: ... key pem redpine cert pem cacert pem File redpine key pem is the new certificate Create Encrypted Certificate mkdir new_certs cd new_certs mkdir sslcert chmod 0700 sslcert cd sslcert mkdir certs private echo 100001 serial touch certindex txt vi openssl cnf CA root openssl req new x509 extensions v3_ca keyout private cakey pem out cacert pem days 365 config openssl cnf Encrypt Private Key use this ...

Page 33: ... used in user_identity and password fields of the command at rsi_eap 3 RS WSC x x GENR x x x x x x Software Applications Radius_server raddb eap conf This file is used to select the EAP methods The password wifi private_key_password wifi inside the file should be used for the field key_password in the command at rsi_cert 5 2 AP Settings A snapshot is shown for AP Settings to work in Enterprise Sec...

Page 34: ...f3 open Path RS WSC x x GENR x x x x x x Resources Applications Radius_server raddb certs wifiuser pem r b SSID of the Access Point at rsi_ssid It should reflect the SSID of the AP you want to connect to c Values for parameters user_identity and security_key should match the values in the file radius server path raddb users d Parameter oper_mode should be 2 e COM port name called param1 in the scr...

Page 35: ... Enterprise Security Mode Figure 9 Running of Python Script WiFi_Enterprise_TLS py Power Up EVB at rsi_opermode at rsi_band at rsi_scan at rsi_cert at rsi_join at rsi_init at rsi_ipconf to acquire IP address Open a server TCP socket with port number 5001 The acquired IP address is displayed by the Python script at rsi_eap Data received by the module sent from Laptop C in step 8 below ...

Page 36: ...e and 3 Exit Enter 1 to send data to the Wi Fi module On being prompted Enter the string to be transmitted type any string from the Keyboard On pressing Enter key on the keyboard the data is sent from the Laptop B to the module and the terminal displays it with the AT RSI_READ message as shown in figure Running of Python Script WiFi_Enterprise_TLS py 9 HTTP server access To access the HTTP server ...

Page 37: ...subnet gateway This command configures the module s IP in static mode not DHCP Make sure the desired IP is in the same subnet as the Access Point The module responds to this command by sending the configured IP address to the Host as response to the command In the terminal this response might appear as unreadable characters because of ASCII conversion The Serial Port Monitor can however be used to...

Page 38: ...ring from the Keyboard On pressing Enter key on the keyboard the data is sent from the Laptop B to the module and the Hyperterminal displays it with the AT RSI_READ message c To send data from the Wi Fi module type Option 2 in Laptop C and then type the below command in the module at rsi_snd socket_handle 0 0 0 abcdefgh socket_handle is the parameter returned when the TCP socket is opened in the m...

Page 39: ... The following steps should be executed 1 Enable Wi Fi Direct Mode in the phone Below is shown an example with an Android 2 3 phone The Wi Fi Direct mode can be configured by going into the phone s Wi Fi Settings The Configure Wi Fi Direct button can be clicked to set the device name accordingly Android_phone in this case 2 Open the Serial Port Monitor to see the actual bytes exchanged Open Hypert...

Page 40: ...tarts the Wi Fi Direct functionality in the module The first parameter in this command is called the Group_Owner_Intent It gives the willingness of the module to become a Group Owner It has been set to the highest value of 15 in this case Refer to the Programming Reference Manual for more details The module responds with OK 6 After issuing the last command the module starts scanning for Wi Fi Dire...

Page 41: ...ription for the command Join in the Programming Reference Manual The parameter GO_Status returned with the OK response of the Join command is used to determine whether the module became a GO or not If the module becomes the GO it will internally assign itself the IP 192 168 100 76 and will act as a DHCP server The Wi Fi Direct phone will acquire an IP address from the module automatically assuming...

Page 42: ...rget device name Scan for Wi Fi Direct devices Issue join or connect instruction to the Phone within 1 minute of issuing at rsi_join in the RS WC 301 module Module granted GO status Node B is GO Group Owner Module associates to the GO WPA2 PSK is the security mode used Module and Node B associate The module configures its IP as 192 168 100 76 Node B gets IP address from the DHCP server of the modu...

Page 43: ...1 is the example port number of the socket opened Once the socket is opened a client socket should be opened at the remote peer phone to connect to this socket and establish a TCP connection The module responds with OK socket_type socket_handle lport module_ipaddr The socket_handle parameter will be used in the subsequent sections to send data b After the TCP connection is established data can be ...

Page 44: ...Hyperterminal or Teraterm 2 Configure the EVB in UART mode connect a UART cable and Power on the EVB 3 The terminal will show the message Welcome To WiSeConnect The module boots up Card Ready LED2 glows on successful completion of boot up and a string READY is sent from module to host 4 Enter the following commands A command should be entered only after getting the response of the previous command...

Page 45: ... the AP by providing the correct password 12345678 in this example it acquires an IP address It is assumed for illustrative purposes that the IP of the Laptop is 192 168 50 2 5 Exchanging data between the client Laptop B and the Access Point a Open a Listening TCP socket on the module by issuing the command at rsi_ltcp 5001 b Open a TCP socket on the client Laptop B Windows OS based by typing the ...

Page 46: ...when a socket is opened in the module Refer to the programming reference manual for more details A second Laptop I can also be connected to the module s AP and data transfers can be done between it and Laptop B 6 HTTP server access To access the HTTP server the step 7 in section Configuration and Test Procedure should be used The URL http module s IP Address should be opened in any of the connecte...

Page 47: ...RT interface and power up the module 2 Configure the module to become an AP by issuing commands from PC P as in section Evaluation of Access Point Mode The sequence of commands is given below a at rsi_opermode 6 b at rsi_band 0 c at rsi_init d at rsi_fwversion e at rsi_ipconf 0 192 168 50 1 255 255 255 0 192 168 5 0 1 f at rsi_apconf 1 redpine 2 2 12345678 300 2 4 g at rsi_join redpine 0 2 The mod...

Page 48: ... DHCP client otherwise an IP should be hard coded in the web page Channel Channel number at which the target AP is present Set to 0 in this example For more details refer to the section on wireless configuration in the PRM Click on Submit Query button The information is sent to the module and stored in its internal flash 5 The module should now be power cycled or hard reset It boots up and then au...

Page 49: ...tion of Client Mode with Personal Security 3 Connect a Laptop B to the same AP Open the URL http Module s IP address config htm in the Laptop For example if the module was configured to have an IP of 192 168 100 20 then the URL is http 192 168 100 20 config htm Make sure the browser in the laptop does not have any proxies enabled 4 In the web page that opens select Client mode and enter desired va...

Page 50: ... and stored in its internal flash 5 The module should now be power cycled or hard reset It boots up and then automatically scans channels for the target AP and connects to it and gets an IP address The module will send out two responses to the Host the first corresponds to the internally given Join command and the second to the Set IP Parameters command Note that once the module is restarted no co...

Page 51: ...92 168 100 1 then the URL is http 192 168 100 1 config htm Make sure the browser in the laptop does not have any proxies enabled 4 In the web page that opens select Access Point mode and enter desired values SSID This is the SSID of the AP which will be created after configuration is over Data rate Set the data rate to 0 Tx Power RF power for Tx Set this value to 2 Security mode PSK security type ...

Page 52: ...ith the configured parameters The module will send out two responses to the Host the first corresponds to the internally given Set IP Parameters command and the second to the Join command Note that once the module is restarted no commands need to be given The module automatically and internally executes the commands to create an AP The stored configuration parameters can be retrieved using the com...

Page 53: ...L http Module s IP address config htm in the Laptop For example if the module was configured to have an IP of 192 168 100 20 then the URL is http 192 168 100 20 config htm Make sure the browser in the laptop does not have any proxies enabled 4 In the web page that opens select Access Point mode and enter desired values SSID This is the SSID of the AP which will be created after configuration is ov...

Page 54: ...s internal flash 5 The module should now be power cycled or hard reset It boots up and then automatically creates and AP with the configured parameters The module will send out two responses to the Host the first corresponds to the internally given Set IP Parameters command and the second to the Join command Note that once the module is restarted no commands need to be given The module automatical...

Page 55: ...ct 0x0102 bcdDevice 0x0002 iManufacturer 0x01 NOTE It is essential to read all the previous sections of the document that describes how to use the module in UART mode The steps t use the module in USB mode are the same 1 Configure the EVB in USB mode Interface Selection and connect the USB interface of a PC to that of the module The PC prompts for installing the driver Install the file from RS WSC...

Page 56: ... the UART mode except for a few exceptions described in the Programming Reference Manual Python scripts can also be run to configure and operate the module A sample script is given for EAP TLS mode refer section Evaluation of Client Mode with Enterprise Security inside RS WSC x x GENR x x x x x x Resources USB WiFi_Enterprise_TLS_F or_USB py can be run in the USB mode The USB interface of the modu...

Page 57: ...s may be needed 1 Avoid using long cables to connect the Host platform with the EVB s SPI interface If a cable is used minimize its length to as small as possible preferably to within two inches 2 Increase the number of ground connections between the Wi Fi PCB and the MCU PCB 3 Add a series resistor into the clock line Choice of value is mentioned in the Module Integration Guide 4 If the SPI clock...

Page 58: ...on Driver Porting Guide for SPI c The section RS WC 301 in SPI mode in RS WC 301_Software_PRM pdf should be carefully read to understand all the commands to configure and operate the module 4 The following settings should be observed to use the SPI interface a SPI CPOL 0 b SPI CPHASE 0 c Max SPI Clock 12 5 Mhz For detailed timing information on the SPI signals please refer to the Datasheet d The I...

Page 59: ...Set IP Parameters Open a Server TCP Socket Open a Client socket at the remote terminal using TCP exe and transfer data Band Init Set EAP Query Firmware Version Scan Set Certificate if TLS mode is used Join Set IP Parameters Open a Server TCP Socket Open a Client socket at the remote terminal using TCP exe and transfer data Band Init Configure WFD P2P GOIntent 15 Query Firmware Version Join Set IP ...

Page 60: ... firmware of the module with a newer version the following flow should be used 1 Connect a PC to the Module through the UART interface using a UART cable 2 Open the application RS WSC x x GENR x x x x x x Resources UART Firmware_upgrade WSC _FW_Upgrade_Util exe in the PC This application can be found in the software release package The application will automatically scan for UART ports in the PC a...

Page 61: ...rt Upgrade button 9 The Message window prompts Upgradation Completed This completed the Firmware Upgrade Process The module should now be reset or power cycled to operate in normal mode NOTE The utility WSC_FW_Upgrade_Util exe is not compatible with Windows 7 64 bit systems For Users migrating to 2 1 0 1 2 5 This section is for users who want to upgrade from Version x to Version 2 1 0 1 2 5 x bein...

Page 62: ... down box select the COM port that is connected to the module s UART interface Click Open S19 button Select the file RS WSC x x GENR 2 1 0 1 2 5 Firmware WiSe_WLAN S19 Now press Connect button 11 Within 10 secs of pressing the Connect button give a hard reset to the module 12 The message window of the GUI will prompt to start the upgrade Click on Start Upgrade button 13 The Message window prompts ...

Page 63: ... oa ar rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 2 Wired firmware upgrade using the UART interface For this option follow the process in the sub section For Users of Firmware Version lower than 2 1 0 1 2 5 The process for upgrade is same as listed in that section ...

Page 64: ...Firmware Wirelessly If the user already has firmware version 2 1 0 1 2 5 or above in the module this section should be followed To upgrade the firmware of the module pins WF_HNDSHKE1 and WF_HNDSHKE2 should be connected to corresponding GPIO pins of the Host Figure 16 Set up for Wireless Firmware Upgrade The steps are mentioned below 1 Set WF_HNDSHKE1 to logic 1 from the Host 2 Power up the module ...

Page 65: ... Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 6 Click on the Connect button Then click on the button Upgrade Folder Select the files RS WSC x x GENR x x x x x x Firmware WFU control_file rps and RS WSC x x GENR x x x x x x Firmware WFU wlan_file rps in the browsing window that comes up ...

Page 66: ...rd d U Us se er r G Gu ui id de e V Ve er rs si io on n 2 2 5 51 1 7 Tick the check boxes and click on the Upgrade button The progress of the upgrade is shown in the progress bars After the files are transferred it may take up to 1 min for the final upgrade confirmation to come in as shown below ...

Page 67: ...the upgrade was successful after a delay of 1 msec after the first pulse This process would confirm the final upgrade status to the Host The module can now be power cycled for normal operation WF_HNDSHKE1 should be kept 0 in normal operation Figure 17 Signal Status During Firmware Upgrade After the confirmation the module should be power cycled and operated normally thereafter WF_HNDSHKE1 WF_HNDSH...

Page 68: ...n the user wants to upgrade the module s firmware wirelessly The feature of Wireless Firmware Upgrade is not dependent on the interface UART SPI USB The file RS WSC x x GENR x x x x x x Firmware WFU control_file rps is exactly same as RS WSC x x GENR x x x x x x Firmware WiSe_Control S19 The former is in a different format and is used to wirelessly upgrade the firmware while the latter is used to ...

Page 69: ...is device may not cause interference and 2 This device must accept any interference including interference that may cause undesired operation of the device Le présent appareil est conforme aux CNR d Industrie Canada applicables aux appareils radio exempts de licence L exploitation est autorisée aux deux conditions suivantes 1 l appareil ne doit pas produire de brouillage et 2 l utilisateur de l ap...

Page 70: ...onformément aux instructions il peut provoquer des interférences sur les communications radio Cependant il n est pas garanti que des interférences ne se produiront pas dans certaines installations Si cet équipement cause des interférences à la reception radio ou télévisée ce qui peut être vérifi é en éteignant l appareil puis en le remettant sous tension l utilisateur peut enter de ésoudre en suiv...