CC3x Config Tool Getting Started

From Texas Instruments Wiki
Jump to: navigation, search

Overview

The CC3x Config Tool is an Android application used to easily broadcast the string used for the First Time Config. The way it works is the application scans all available networks and allows the user to select the network they would like the CC3000 to connect to. The user can select the 3-character vendor prefix and enter in the WiFi network's password.

Installation

Typical commercial applications can be found in the Android market place. However, this is only a demo application (a useful utility nevertheless) and so the Android Market is not supported. There are two other ways of installing the application on your mobile device via email or the Android developer tools.

Install by Email

This is the easiest of the two methods if you have gmail access on the mobile device that you are installing the application on to. Simply email the APK file as an attachment to the gmail email account on the phone. Open the email and click the "install" button. The application will then install.

Install by Developer Tools

This method allows one to install the application even if they don't have email access on the mobile device. This method uses the Android developers tools to install the application over the USB port.

  1. go to http://developer.android.com/sdk/index.html and install the developer tools and USB drivers for your OS
  2. install USB drivers. Refer to http://developer.android.com/sdk/win-usb.html
  3. You need to modify your Android’s mobile device settings to allow installations of an application from non-market place sources. Under your mobile device's “Settings,” select “Application Settings” and then enable “Unknown Sources.” Also under “Settings,” select “SD Card” and “Phone Storage,” and finally enable “Disable Use for USB Storage”
  4. Open a Command Prompt and type the following: adb install path_to_apk/filename.apk replacing with the correct path and filename.

Operation

The operation of the CC3x Config Tool application is very simple. First launch the application. After the splash screen you should see a screen similar to this.


ScreenShotCfgToolHome.PNG

The next step is to select the vendor prefix which is found in the settings menu. Click the SettingsButton button on the lower left to pull up the settings menu then select the CC3x Prefix option. Enter in the case-sensitive 3-character vendor prefix and select OK.


ScreenShotCfgToolPrefix.png

Navigate back to the main screen.

The network is not automatically scanned so if you don't see the network you are looking for click the Scan button. Once you have found the WiFi network that you would like the CC3000 to connect to select it from the list. The application will detect the security settings of the network. If the network is open then it will just automatically start sending the First Time Config broadcast message. If the network is secure then a dialog will open allowing you to select the security mode and enter in the WiFi network's security pass phrase.


ScreenShotCfgToolexecute.png

Enter in the passphrase and select the "Confiigure CC3x for<Network's SSID>" button. At this point the application will start to broadcast the First Time Config message.

Limitations

The First Time config string is limited to 32 characters. This includes the 3-character vendor prefix, Length of the SSID character, name of the SSID, Security mode character and pass phrase. Therefore one must be careful not to try the first time config process with an SSID name + security passphrase combined length greater than 27 characters.

Devices Tested On

The following is a list of Android devices the CC3x Config Tool has been shown to work on:

  • HTC Desire - Android Froyo 2.2
  • Motorla Droid - Android Froyo 2.2
  • ViewSonic ViewPad7 - Android Froyo 2.2
  • Asus Transformer - Android Honeycomb 3.1

Support

E2E Community

For further information or to ask questions directly to other Engineers, visit the WLAN Applications Forum in the E2E Community.

External Links

Note

The CC3x Config tool was developed by Pacific Design Engineering (PDE), a full-service company engaged in custom product design and development. PDE, a Texas Instruments Elite Design House Network partner, provides contract engineering support in specialized areas or will assume turnkey design responsibility for a product, from idea to production.


Site Map