Installation

This section explains how to install the Waspmote IDE in your Operating System.

First, download the Waspmote IDE from the Waspmote software webpage:

https://development.libelium.com/waspmote/software

And then select your OS:

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.

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

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.

Last updated