Community Archive

Release Notes: WICED Studio 6.6.0

OSX Install:

• Download the attached .zip file
• Double click the zip file and extract all contents from the installer to a local folder
  • Note: When using the Safari Browser, it will automatically unzip the contents and create a folder
• Note: the next two steps below are needed as a workaround for a known OSX 10.12 install issue called "App Translocation"
  1. Move the contents of the folder to another folder using ‘Finder’; Do not move the files using ‘Terminal’
     • Be sure to move the entire folder contents including the installer app file and config.eml.
  2. Run the command below using Terminal window:
     > xattr -r -d com.apple.quarantine <path>/WICED-Studio-X.X.X.X-IDE-Installer.app
• See "Additional Installation Notes" below before installing
• Double click the "WICED-Studio-X.X.X.X-IDE-Installer" app to execute the installer
• After the installation in complete, launch the WICED Studio IDE from shortcut in the $HOME/Cypress $HOME/WICED/WICED-Studio-X folder

OSX Uninstall:

• From Finder, navigate to User > <name> -> Applications  -> Cypress and launch 'Uninstall'
• To clean up all WICED components manually, delete files and folders for the IDE and SDK, typically in User -> <name> -> WICED/WICED-Studio-X and User -> <name> -> Documents -> WICED/WICED-Studio-X  or from terminal $HOME/Cypress/WICED*, $HOME/WICED/WICED-Studio-X and $HOME/Documents/WICED/WICED-Studio-X

Additional Installation Notes:

1.

Open xterm, run the "java -version" command.  If it fails to return any results or states that you are running version 1.6, then you need to install the Java SE Development Kit 8, which can be found here: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html. Once the Java SE Development Kit 8 is installed, run the "java -version" command again with xterm.  If this command returns "1.6", then you will need to fix the symbolic link using the following commands:

> rm -f /usr/bin/java

> ln -s /System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands/java /usr/bin/java

2.

Application downloads on WICED platforms may fail on certain OSX versions due to an incompatibility between the OSX version and the installed driver for the FTDI USB to serial chip.  On OSX versions 10.10 and earlier, a specific version of the FTDI driver must be installed using the instructions available here: https://learn.sparkfun.com/tutorials/how-to-install-ftdi-drivers/mac

On OS X versions 10.11 and greater, the Apple version of the FTDI driver must be used, and any previous instance of the FTDI version of the driver must be removed from the system, by executing the following command in xterm:

> sudo rm -rf /Library/Extensions/FTDIUSBSerialDriver.kext /System/Library/Extensions/FTDIUSBSerialDriver.kext

Reboot the system after performing the rm command

Release Notes: WICED Studio 6.6.0

Windows Install:

• Download the attached .zip file
• Extract the installer exe and config.eml file from the zip file to temp folder on your computer; do not execute the installer from the zip file
• Double click the installer exe to install WICED Studio
• After installation in completed, launch WICED Studio IDE from shortcut on desktop

Windows Uninstall:

• Uninstall "WICED Studio" from Control Panel -> Programs and Features OR (in Win 10)
• Start Menu -> Settings -> System -> Apps & features -> WICED-Studio -> Uninstall
• To clean up all WICED components manually, delete files and folders for the IDE and SDK, typically in "C:\Users\<name>\Documents\WICED" and "C:\Users\<name>\AppData\Local\WICED"

Release Notes: WICED Studio 6.6.0

Linux Install:

• Installer has been tested on Ubuntu 16.04 and Fedora 23
• Download the attached .zip file
• Extract the installer .bin and config.eml file from the zip file to temp folder on your computer (for example /home/user1/wiced_install); do not execute the installer from the zip file
• Apply execute permissions to the installer and execute from terminal command line as below:
  • [user1]$ pwd
  • /home/user1/wiced_install
  • [user1]$ ls
  • config.eml  WICED-Studio-X.X.X.X-IDE-Installer.bin
  • [user1]$ chmod +x ./WICED-Studio-X.X.X.X-IDE-Installer.bin
  • [user1]$ ./WICED-Studio-X.X.X.X-IDE-Installer.bin
• During install, the installer will ask for sudo permissions to install the WICED drivers; please enter the sudo password
  •   Note: On some Linux installations, you may also need to enter the sudo password on the terminal console where the installer was executed
• After installation is complete, launch the WICED Studio IDE from shortcut located in $HOME/Cypress folder

Linux Uninstall:

• At the terminal prompt, > cd $HOME/Cypress
  • Run script >./uninstall
• To clean up all WICED components manually, delete files and folders for the IDE and SDK, typically found in $HOME/Cypress/WICED*, $HOME/WICED/WICED-Studio-X and $HOME/Documents/WICED/WICED-Studio-X

Additional installation notes for Linux:

1.

Note that an additional step is required when connecting a WICED development board to a computer running Linux. On common Linux distributions, the serial UART ports (usually /dev/ttySx or /dev/ttyUSBx devices) belongs to the root user and to the dialout group. Standard users are not allowed to access these devices.

An easy way to allow the current user access to the Linux machine's serial ports is by adding the user to the dialout group.

This can be done using the following command: $sudo usermod -a -G dialout $USER

Note also that for this command to take effect, the user must log out and then log back in.

2.

If the following error is encountered during the installation process: “Installer User Interface Mode Not Supported”, you will need to run the following command in order to update Java to version 1.8: “sudo dnf install java”

3.

If Linux OS version is older than mentioned above, you might see this issue below when compiling applications -

     gnu/libstdc++.so.6: version `GLIBCXX_3.4.21' not found

In this case, newer version of libstdc is needed. You might need to upgrade your Linux OS or try -

> sudo apt-get install libstdc++6

The purpose of this document is to demonstrate the use of common HCI commands needed for Bluetooth radio testing.

Additional detail on the associated commands can be found in the Bluetooth Core Specification: https://www.bluetooth.com/specifications/

Note that the commands contained within this document are intended for use with Cypress' own Bluetooth BR/EDR and BLE Controllers.