Basic Wifi Application

Transcription

1 Basic Wifi Application

2 Table of Contents Prerequisites 3 Connecting the CC3000 & MSP430 to a PC 4 Flashing the CC3000 Drivers/Firmware 5 Flashing the Application to the MSP430 5 Configuring the Hyperterminal 6 Running the Application 9 - SmartConfig Tool for Android 10 - SmartConfig Tool for ios 11 - SmartConfig Tool for a PC 12 Running SmartConfig on CC Backup Detailed Commands 16 Building the Project in IAR 19 Building the Project in CCS 29 Page

3 Prerequisites Hardware 1. 1x MSP-EXP430G2 Launchpad, order from TI estore MSP-EXP430G2 Value Line Development Kit 2. 1x CC3000BOOST, orderable from the TI estore 3. 1x Wi-fi Access Point Software 1. Download and Install the MSP430 Launchpad UART Drivers (Only needed if CCS or IAR is not installed on PC) 2. Download and Install the Patch programmer installer for Launchpad - MSP430G Download and Install the Launchpad - MSP430G2553 Basic Wi-Fi Application (SDK x.xx) 4. One of the following evaluation software is required in order to view and compile the Wifi applications sources. Alternatively the binary can be used to burn directly to the board(included in Patch Programmer download) IAR Embedded Workbench v (MSP430) CCSv Download and Install the CC3000 SmartConfig App (Java/Android/iOS) 6. Download and Install a Hyper Terminal: Such as PuTTY, TeraTerm, etc. Assumptions & Knowledge Base 1. Knowledge of or being familiar with the following will help the user in this demo: The CC3000 Host Driver Overview document Changing WLAN access point (AP) parameters

4 Connecting the CC3000 & MSP430 to a PC 1. Ensure the MSP430 Launchpad is configured to use the Hardware UART (USCI). By placing the first two jumpers in the orientation denoted in the image. 2. Connect the CC3000 BoosterPack to the MSP- EXP430G2-Launchpad board. (as shown in the image J9 of CC3000 should align with J1 of the MSP430) UART Configuration 3. Connect the USB miniport on the MSP-EXP430G2- Launchpad board to a PC. Jumper J13 position (w/o external power supply) for CC3000 Board Reset Button 4. CC3000 Jumper Settings (on the CC3000 BoosterPack): J13 should be located on pins 1 & 2 or nearest to the thick white line. J2 should be located on pins 2 & 3 in User mode USB HyperTerminal connection Network stack Logger pin J2 Connect CC3000 BoosterPack For more information please refer to the MSP-EXP430G2-WiKi

5 Flashing the CC3000 Drivers/Firmware 1. Click Start All Programs CC3000 Patch Programmer MSP430G2553 Download Driver Patches and follow the on screen instructions. 2. Click Start All Programs CC3000 Patch Programmer MSP430G2553 Download Firmware Patches and follow the on screen instructions. Flashing the Application to the MSP Click Start All Programs CC3000 SDK MSP430G2553 Download Basic Wifi Binary and follow the on screen instructions. Note: Please ignore comments about FRAM on Step 3 and follow on screen instructions. At the end look for the Green and Red LEDs to be on.

6 Configuring the HyperTerminal (PuTTY) General Notes The HyperTerminal is the interface through which commands are sent to the CC3000 basic Wi-Fi example application. 1. Use Device Manager or Computer Management to identify MSP430 Application UART COM port for configuring the HyperTerminal. 2. Double-click the MSP430 Application UART to configure the Baud Rate Configure the baud rate as follows (see also the figure to the right): Bits per second: 9600 Data bits: 8 Stop bits: 1 Parity: None Flow control: None

7 3. PuTTY settings: With Session selected in the Category column in the left side of window. (see figure to right) Select Serial for Connection Type Set the Serial line value to the COM port for the MSP430 Application UART (from previous step) Set Speed to With Terminal selected in the Category column in the left side of window. (see figure to right) Select Force on for Local echo

8 5. With Serial selected in the Category column in the left side of window. (see figure to right) Serial Line to connect to: Verify this matches from step 1 Speed(baud): 9600 Data bits: 8 Stop bits: 1 Parity: None Flow control: None 6. Select Open to start the HyperTerminal. If all settings are correct, the terminal will open. To get the driver version to display once the terminal is open press the Reset button (S1) on the Launchpad [you will need to scroll up in the terminal to see the driver information] Note: Occasionally PuTTY needs to be restarted and the Reset button pressed again to view driver information.

9 Running the Application Configuring the Basic Wi-Fi Example Application The example application demonstrates basic WLAN connectivity together with the capability of sending data over the WLAN transport with the help of the standard BSD socket interface. General Description Each HyperTerminal command-line interface (CLI) command used in the basic Wi-Fi example application consists of a minimum of 2 bytes opcode. To execute a command, type the command and press Enter. When command execution completes, DONE appears in the HyperTerminal window. (See figure top right) Note: The first operation performed is a first-time configuration Supported Commands Before moving to socket-based operations, additional AP and static IP connections must be configured. Each command must be typed as an ASCII string in the HyperTerminal (see figure to right).

10 SmartConfig Tool for Android 1. Download and Install the Android SmartConfig Application following the on-screen instructions. 2. Navigate to the installed directory similar to below: C:\ti\CC3000AndroidApp\SmartConfigCC3X\bin 3. Copy SmartConfigCC3X.apk file from this directory to your Android device. 4. System Settings > Security & Screen Lock > Device Administration > Unknown Sources and Select Allow 5. Navigate to the SmartConfigCC3X.apk on the Android Device and click to begin the install. Follow all on-screen instructions. 6. Connect your Android devices Wifi connection to your desired AP. 7. Start the SmartConfig App If connected to a Wireless AP the App should autopopulate the SSID and Gateway IP Enter the required Password and/or Key 8. Click Start to begin broadcasting the Router information to the CC Note: MSP-EXP430G2-Launchpad SmartConfig doesn't support encryption mode.

11 SmartConfig Tool for ios 1. Download and Install the TI WiFi SMARTCONFIG App from the itunes Store following the on-screen instructions. 2. Connect your ios devices Wifi connection to your desired AP. 3. Start the SmartConfig App If connected to a Wireless AP the App should autopopulate the SSID and Gateway IP Enter the required Password and/or Key 4. Click Start to begin broadcasting the Router information to the CC3000. TPLINK Note: MSP-EXP430G2-Launchpad SmartConfig doesn't support encryption mode.

12 SmartConfig Tool for a PC 1. Connect your PC s wireless connection to the desired Access Point. 2. Open the CC3000 SmartConfig Java Applet by clicking Start All Programs CC3000 Smart Config Java applet Smart Config. Note: Before opening the Java Applet make sure that ONLY ONE wireless connection exists on your PC. Disable all other wireless connections(i.e. 3G, Wireless Network Connection 2, or Bluetooth) otherwise the applet won t know which access point to pull information for. If you are properly connected to the desired AP the applet should populate the fields automatically and then click Start. Note: You may need to adjust your wireless connection MTU size to For Windows Users: Run Command Prompt as an Administrator and type the following command: netsh interface ipv4 set subinterface Wireless Network Connection mtu=1500 store=persistent Make sure to restart the SmartConfig Java Applet after changing the MTU size. Note: MSP-EXP430G2-Launchpad SmartConfig doesn't support encryption mode.

13 Running SmartConfig on CC In your Terminal type 01 to start Smart Config on the Launchpad. When the device finds an AP, the HyperTerminal displays Smart config DONE and then Done The example application now reboots the CC3000 device. After the reboot, the CC3000 device tries to connect to the AP detected. Following the reboot and as soon as the CC3000 device connects to the AP, the CC3000 IP address will be displayed To test connectivity between the CC3000 device and the PC, execute the ping command using the CC3000 s IP address from the command prompt window. Note: MSP-EXP430G2-Launchpad SmartConfig doesn't support encryption mode.

14 Congratulations! You have successfully connected the CC3000 to your desired wireless access point. Further Information For more details on programming the CC3000 visit the wiki page at: For a detailed description and syntax for see the backup slides attached. For information on how to import the Basic Wifi Application source files into IAR or CCS to compile and edit view the backup slides labeled Building the Project with IAR or Building the Project with CCS.

15 Backup

16 Detailed Description of Commands Static IP Configuration The example application supports the configuration of the CC3000 device with a static IP. To configure the device IP, execute the command 08XXYYZZUUAABBCCDD where: XXYYZZUU is an IP address assigned to the CC3000 device in hexadecimal form. For example, if the required address is , the hexadecimal value is c0a8270a. Lower case only is supported. AABBCCDD is an IP address of the default gateway in hexadecimal form as well (which can be an IP address of the AP). The example application assumes that the network mask is To test connectivity, execute the ping command. In order to configure DHCP, execute the command with zero value for all fields. Open UDP Socket To open a UDP socket, execute the Socket Open command (03). Note: There is a inactivity default timeout on the UDP socket of 60 seconds. This is refreshed with a sent or received packet. Send Data Please Note: MSP-EXP430G2-Lauchpad supports MAX UDP payload = 8 bytes To transmit a data packet: 1. Execute the Socket Open command (03) as described in the section "Open Socket". 2. Execute the sendto command (04AAX Y02BCDEFGHIKLMN) where: AA is the hexadecimal presentation of the length of data. For example, to send 5 bytes, type 05. The field following AA is data. For example, to send the string 12345, type BCDE is the hexadecimal presentation of the destination port. FGHIKLMN is the hexadecimal presentation of the destination IP address.

17 Detailed Description of Commands (Continued) Receive Data Please Note: MSP-EXP430G2-Lauchpad supports MAX UDP payload = 8 bytes 1. Execute the Socket Open command (03) as described in Section 6.4, Open Socket. 2. Execute the bind command (06XXYY) where XXYY is the port in hexadecimal form. For example, if a port is 51000, the value typed is c Execute the Receive Data command (05). The HyperTerminal displays the received data. Close Socket To close a UDP socket, execute the Socket Close command (07). Connect to AP Note: The Connect-to-AP command is for advanced users. To connect to the AP manually (that is, not during the simple configuration process), execute the command 02XA...D where: X is the SSID name length in hexadecimal presentation. A...D is the SSID name length. Disconnect from AP To disconnect the CC3000 device from the AP, execute the CC3000 Disconnect command (09). Note: By default, the CC3000 device tries to reconnect to the AP automatically as programmed by the Simple Configuration process within the Example Application. To disconnect without reconnecting, the user must remove the policy as described in the section ''Delete Policy''.

18 Detailed Description of Commands (Continued) Delete Policy Note: The Delete Policy command (0a) is for advanced users. To delete the policy of automatic connection to the AP (as programmed by the Simple Configuration process), execute the CC3000 Delete Policy command (0a). After the following reset, automatic reconnection to the AP is not attempted. Send mdns Advertizement Note: The Send mdns Advertizement command (0b) is for advanced users. This command sending mdns Query packet with the data predefined in Basic WiFi application.

19 Building the Project in IAR

20 Running Basic WiFi Application with IAR Working with IAR Embedded Workbench will require opening the provided workspace, compile and burn it to the board following these instructions: In order to open a workspace and compile an application by yourself, please follow these steps: 1. Open the IAR Embedded Workbench. 2. Select File Open Workspace (see the figure to the right). 3. Open the CC3000 basic Wi-Fi example application (BasicWiFiApplication_workspace.eww) as shown in the figure to the right.

21 At this step, a workspace will be opened:(see the figure to the right).

22 4. Project overview:

23 5. In the Workspace window, right-click Example Application - Debug to open a menu. From the menu, select Options (see the figure to the right).

24 6. Build your workspace as follows: 1. In the Workspace window, right-click CC3000 Host Driver - Debug to open a menu. From the menu, select Rebuild All to build the CC3000 host driver (see the figure below).

25 2. In the Workspace window, right-click CC3000Spi - Debug to open a menu. From the menu, select Rebuild All to build the CC3000_Spi (see the figure below).

26 3. In the Workspace window, right-click HyperTerminalDriver - Debug to open a menu. From the menu, select Rebuild All to build the HyperTerminal driver (see the figure below).

27 4. In the Workspace window, right-click Demo Application - Debug to open a menu. From the menu, select Rebuild All to build the example application (see the figure below).

28 7. To download and debug the CC3000 basic Wi-Fi example application, click the button (see the figure below).

29 Building the Project in CCS

30 Running Basic WiFi Application with CCS V5 Working with CCS v5 will require opening the provided workspace, compile and burn it to the board following these instructions: In order to open a workspace and compile an application by yourself, please follow these steps: 1. Open Code Composer Studio v5. 2. Set the workspace to..\ Basic WiFi Application\Basic WiFi Application CCS (see the figure to the right). 3. Select Project->Import Existing CCS/CCE Eclipse Project as shown in the figure below..

31 4. Select Browse and open Basic WiFi Application Folder as shown in the figure to the right. 5. Select Select All and Finish as shown in the figure to the right.

32 6. At this step a workspace will be created: 7. Build your workspace as follows: 1. In the workspace click CC3000 Host Driver and press the hammer icon in order to build.

33 2. In the Workspace window, click CC3000 Spi and press the hammer icon in order to build. 3. In the Workspace window, click Hyper Terminal Driver and press the hammer icon in order to build.

34 4. In the Workspace window, click Basic WiFi Application and press the hammer icon in order to build. 8. To download and debug the CC3000 basic Wi-Fi example application, click the button (see the figure below).

35 IMPORTANT NOTICE Texas Instruments Incorporated and its subsidiaries (TI) reserve the right to make corrections, enhancements, improvements and other changes to its semiconductor products and services per JESD46, latest issue, and to discontinue any product or service per JESD48, latest issue. Buyers should obtain the latest relevant information before placing orders and should verify that such information is current and complete. All semiconductor products (also referred to herein as components ) are sold subject to TI s terms and conditions of sale supplied at the time of order acknowledgment. TI warrants performance of its components to the specifications applicable at the time of sale, in accordance with the warranty in TI s terms and conditions of sale of semiconductor products. Testing and other quality control techniques are used to the extent TI deems necessary to support this warranty. Except where mandated by applicable law, testing of all parameters of each component is not necessarily performed. TI assumes no liability for applications assistance or the design of Buyers products. Buyers are responsible for their products and applications using TI components. To minimize the risks associated with Buyers products and applications, Buyers should provide adequate design and operating safeguards. TI does not warrant or represent that any license, either express or implied, is granted under any patent right, copyright, mask work right, or other intellectual property right relating to any combination, machine, or process in which TI components or services are used. Information published by TI regarding third-party products or services does not constitute a license to use such products or services or a warranty or endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual property of the third party, or a license from TI under the patents or other intellectual property of TI. Reproduction of significant portions of TI information in TI data books or data sheets is permissible only if reproduction is without alteration and is accompanied by all associated warranties, conditions, limitations, and notices. TI is not responsible or liable for such altered documentation. Information of third parties may be subject to additional restrictions. Resale of TI components or services with statements different from or beyond the parameters stated by TI for that component or service voids all express and any implied warranties for the associated TI component or service and is an unfair and deceptive business practice. TI is not responsible or liable for any such statements. Buyer acknowledges and agrees that it is solely responsible for compliance with all legal, regulatory and safety-related requirements concerning its products, and any use of TI components in its applications, notwithstanding any applications-related information or support that may be provided by TI. Buyer represents and agrees that it has all the necessary expertise to create and implement safeguards which anticipate dangerous consequences of failures, monitor failures and their consequences, lessen the likelihood of failures that might cause harm and take appropriate remedial actions. Buyer will fully indemnify TI and its representatives against any damages arising out of the use of any TI components in safety-critical applications. In some cases, TI components may be promoted specifically to facilitate safety-related applications. With such components, TI s goal is to help enable customers to design and create their own end-product solutions that meet applicable functional safety standards and requirements. Nonetheless, such components are subject to these terms. No TI components are authorized for use in FDA Class III (or similar life-critical medical equipment) unless authorized officers of the parties have executed a special agreement specifically governing such use. Only those TI components which TI has specifically designated as military grade or enhanced plastic are designed and intended for use in military/aerospace applications or environments. Buyer acknowledges and agrees that any military or aerospace use of TI components which have not been so designated is solely at the Buyer's risk, and that Buyer is solely responsible for compliance with all legal and regulatory requirements in connection with such use. TI has specifically designated certain components as meeting ISO/TS16949 requirements, mainly for automotive use. In any case of use of non-designated products, TI will not be responsible for any failure to meet ISO/TS Products Applications Audio Automotive and Transportation Amplifiers amplifier.ti.com Communications and Telecom Data Converters dataconverter.ti.com Computers and Peripherals DLP Products Consumer Electronics DSP dsp.ti.com Energy and Lighting Clocks and Timers Industrial Interface interface.ti.com Medical Logic logic.ti.com Security Power Mgmt power.ti.com Space, Avionics and Defense Microcontrollers microcontroller.ti.com Video and Imaging RFID OMAP Applications Processors TI E2E Community e2e.ti.com Wireless Connectivity Mailing Address: Texas Instruments, Post Office Box , Dallas, Texas Copyright 2013, Texas Instruments Incorporated