Links

Installation

This section explains how to install the Waspmote IDE in your Operating System.
First, download the Waspmote IDE from the Waspmote software webpage:
And then select your OS:
Figure: Waspmote IDE download links ‌
If you are using Linux and do not know if you should download the 32-bit or 64-bit version, you can open a terminal and type uname -p to find out (it will probably be the 2nd option).

Windows

Unzip
When the download finishes, unzip the downloaded file (waspmote-pro-ide-vXX-windows.zip). Make sure to preserve the folder structure. Double-click on the folder to open it. There should be a few files and sub-folders inside.
Prepare the computer
Then connect your Waspmote board to the computer with the mini-USB cable. When you connect the board, Windows should start the driver installation process (if you haven\'t used the computer with Waspmote before).
On Windows Vista and greater versions, the driver will automatically be downloaded and installed.
If the driver is not installed properly or the computer does not have an Internet connection when Waspmote is connected, the user will have to install the driver manually.
To check if the driver has been installed correctly, rigth-click on 'Start' → 'System' → 'Device Manager'. Look for the 'Ports (COM & LPT)' section. If the driver has not been installed, the device will be shown in 'Other devices'.
FIGURE
Figure: Device not recognized
Manual installation process
  • First of all, the driver must be downloaded from the manufacturer\'s
    web page or must have been previously downloaded from the
    developer's web page: www.ftdichip.com/Drivers/VCP.htm
FIGURE
Figure: FTDI download portal
  • Open the downloaded zip file and execute 'CDM21224_Setup' and
    click on the 'Extract' button on the image below.
FIGURE
Figure: FTDI CDM Driver extraction window
  • When the extraction has been done, a new window will appear. To
    start the installation process click on the 'Next' button
FIGURE
Figure: FTDI CDM Driver start installation
  • After accepting the License agreement, the installation shall begin.
FIGURE
Figure: FTDI CDM Driver installing
  • Once the installation have finished, the installation wizard will
    show if the FTDI CDM Driver is ready for usage. Go to 'Start' →
    'System' → 'Device Manager' to see that our device has been
    moved from the 'Other devices' section to 'Ports (COM & LPT)'.
FIGURE
Figure: FTDI CDM Driver installation finished
FIGURE
Figure: Device recognized
Launch Waspmote IDE
Double-click on the IDE application.
If the Waspmote software loads in the wrong language, you can change it in the preferences menu. See the "Environment" section for more details.

Mac OS X

Unzip
When the download finishes, double-click on the downloaded file (waspmote-pro-ide-vXX-macosx.zip). This will expand the Waspmote application. Copy the Waspmote application into the Applications folder.
Prepare the computer
You need to download the latest version of the drivers from the FTDI website http://www.ftdichip.com/Drivers/VCP.htm. One downloaded, double click on the package and follow the instructions in the installer. You will need to restart your computer after installing the drivers.
Then connect your Waspmote board to the computer with the mini-USB cable, and the Mac OS will detect it automatically.
Launch Waspmote IDE
Double-click on the IDE application.
If the Waspmote software loads in the wrong language, you can change it in the preferences menu. See the "Environment" section for more details.
To check if the drivers have been correctly installed, you should see a device called /dev/tty.usbserial-XXXXXX in the IDE\'s Serial Port.
Figure: Waspmote correctly detected by Mac OS ‌

Linux

Unzip
When the download finishes, double-click on the downloaded file (waspmote-pro-ide-vXX-linuxXX.tar.gz). Make sure to preserve the folder structure. Double-click the folder to open it. There should be a few files and sub-folders inside.
Prepare computer
You will need to install some programs to use the Waspmote IDE under Linux (the way you do this depends on your distribution):
  • A Java Runtime Environment: openjdk-7-jre, openjdk-6-jre, Sun's Java 6 runtime or Oracle JRE 7.
  • Waspmote IDE has an internal pre-build gcc compiler, but if you have installed your own avr-gcc compiler, make sure you use 4.7.2 version or newer.
  • librxtx-java package.
Then connect your Waspmote board to the computer with the mini-USB cable, and the Linux OS should identify it like /dev/ttyUSBX.
Launch Waspmote IDE
Copy the extracted files to a directory (or your desktop) and run the "waspmote" script.
* For Ubuntu distributions higher or equal to 12.04 (with Unity UI) we provide a script to create a launcher App:
  • Go to the unzipped folder
  • Double-click on createAppUnivity.sh
  • Move the IDE application to your launcher
Figure: Waspmote IDE on Linux Unity desktop ‌
These tests were done using Ubuntu 14.04.
Other notes:
  • Locking assertion failure from Java when using Xinerama
To fix, run this:
sudo sed -i \'s/XINERAMA/FAKEEXTN/g\' /usr/lib/jvm/java-6-sun/jre/lib/amd64/motif21/libmawt.so
  • USB-Serial devices not detected
Check Waspmotes (and other USB-serial devices) end up as /dev/ttyUSBX.
  • Kernel configuration
If you configured your own kernel, the driver is in one of these 2 paths:
  • Device Drivers → USB Support → USB Serial Converter Support → USB FTDI Single Port Serial Driver
  • Device Drivers → USB Support → USB Modem (CDC ACM) support
Select [Y], to have it "built-in" to the kernel or [M] to have it built as a module.
Dmesg then should show the device like this:
ftdi_sio 2-2:1.0: FTDI USB Serial Device converter detected
or like this:
cdc_acm 5-2:1.0: ttyUSB0: USB ACM device
  • User access rights
Make sure you are in the tty group. On some distributions, you might need to create an Udev rule for the FTDI USB Serial Device converter.