Libelium Waspmote User manual

Waspmote Plug & Sense!
Quickstart Guide

-2-
v4.5
Index
Document version: v4.5 - 11/2014
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. Introduction......................................................................................................................................... 3
2. General and safety information ......................................................................................................... 4
3. Waspmote Plug & Sense!’s Hardware Setup ...................................................................................... 5
3.1. ON/OFF Button ............................................................................................................................................................................5
3.2. External LED...................................................................................................................................................................................6
3.3. Resetting Waspmote Plug & Sense! with an external magnet ....................................................................................6
3.4. USB ....................................................................................................................................................................................................8
3.4.1. External SIM socket....................................................................................................................................................10
3.5. Antenna........................................................................................................................................................................................12
4. Waspmote IDE: Download and Installation..................................................................................... 14
4.1. Linux ..............................................................................................................................................................................................14
4.2. Windows.......................................................................................................................................................................................14
4.3. Mac.................................................................................................................................................................................................15
5. Receiving Frames from Waspmote Plug & Sense! ........................................................................... 16
5.1. In the Waspmote Gateway.....................................................................................................................................................16
5.2. In Meshlium ................................................................................................................................................................................17
6. Compiling a New Program ................................................................................................................ 18
7. Uploading a New Program to Waspmote Plug & Sense!................................................................. 20
8. Next Steps: using the Developers Guides....................................................................................... 26
9. Documentation Changelog .............................................................................................................. 27

-3-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
1. Introduction
The aim of this Guide is to introduce the user to Waspmote Plug & Sense! in a practical way.
Waspmote Plug & Sense! is a complex device and a learning process must be completed. Libelium oers many Guides and
examples which will help the developer.
The present Guide was created in the hope of helping the developer in the very rst steps with Waspmote Plug & Sense!. We
advice to follow this Guide when the user wants to start the learning process. The last chapter will try to plan a learning process,
proposing further steps.

-4-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
2. General and safety information
Software:
• Upload code only using Waspmote IDE. If a dierent IDE is used, Waspmote can be damaged and can become
unresponsive. This use is not covered under warranty.
• Do not unplug any connector while uploading code. Waspmote can become unresponsive. This use is not covered under
warranty.
• Do not connect or disconnect any connector while Waspmote is ON. Waspmote can become unstable or unresponsive,
and internal parts can be damaged. This fact is not covered under warranty.
Hardware:
• Do not handle black stickers seals on both sides of the enclosure (Warranty stickers). Their integrity is the proof that
Waspmote Plug & Sense! has not been opened. If they have been handled, damaged or broken, the warranty is void.
• Do not open Waspmote Plug & Sense! in any case. This will automatically make the warranty void.
• Do not handle the four metallic screws of Waspmote Plug & Sense!. They ensures waterproof seal.
• Do not submerge Waspmote Plug & Sense! in liquids.
• Do not place nodes on places or equipment where it could be exposed to shocks and/or big vibrations.
• Do not expose Waspmote Plug & Sense! to temperatures below -10ºC or above 50ºC.
• Do not powerWaspmote with other power sources than the original provided by Libelium.Voltage and current maximum
ratings can be exceeded, stopping Waspmote working and voiding warranty.
• Do not try to extract, screw, break or move Waspmote Plug & Sense! connectors far from necessary usage, waterproof
sealing can be damaged and warranty will be voided. For more information: http://www.libelium.com
• Do not connect any sensor on the solar panel connector and also do not connect the solar panel to any of sensor
connectors. Waspmote can be damaged and warranty void.
• Do not connect any sensor not provided by Libelium.
• Do not place Waspmote Plug & Sense! where water can reach internal parts of sensors.

-5-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
3. Waspmote Plug & Sense!’s Hardware Setup
For the advanced hardware setup, please consult the Waspmote Plug & Sense! Technical Guide. Here we show the most basic
points about the hardware conguration:
3.1. ON/OFF Button
This button is used to turn ON or OFF Waspmote. It is a latch type button with two static positions as shown below. In ON
position, the button remains a bit lower than LED ring.
Figure : On / O button at o position
Figure : Turning On Waspmote

-6-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
3.2. External LED
ON / OFF button includes a red ring led, which can be managed by software. This led can be used for instance to know that
Waspmote is ON, or for debugging purposes at developing phase. By default, Waspmote Plug & Sense! comes with a code that
blinks briey (3 times in less than one second) this led when it is turned ON. The LED can be managed specifying ON time or
just setting this state with specic API functions. The user should take into account that the usage of this led will increase power
consumption due to external LED consumes 4.4 mA.
Figure : Waspmote turned On
3.3. Resetting Waspmote Plug & Sense! with an external magnet
Waspmote Plug & Sense! it can be reset with an external magnet, with no contact. If one node stops working or if a defective
behavior is detected, it would be costly to uninstall the node to bring it back to laboratory. This feature allows the network
manager to reset the node in a quick and easy way.
The hardware consists of a reed switch connected to the Waspmote reset line. When the user gets the magnet close to the reed-
switch, the reset is activated. When the user moves the magnet away, the reset line is released (the external LED will blink) and
Waspmote executes the bootloader rst and then, the setup function. After the setup, it will continue with the loop function.
Next pictures shows the right way to reset the node using an external magnet, rst moving it closer, and then moving it away.
Figure : Moving the magnet closer to the node.

-7-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
Figure : Moving the magnet away from the node.
The magnet is made of neodymium. It is a special, high-power magnet. We only advise to use the magnet Libelium provides.
It is not mandatory, but highly recommended to consider this feature when designing the project. The user should design the
software in a way the node can be reset if things go wrong. Remember that laboratory tests are always needed to validate the
feature before your nal deployment.
When the node is already deployed in the eld, and for instance it is installed in a trac light, this feature can be used to reset
the node easily, as it is shown in the diagram below, where a technician uses a pole with the magnet attached in one side.
Figure : Applying the magnet in a real deployment

-8-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
3.4. USB
This connector is used to upload code into Waspmote with a male to male USB cable provided by Libelium. Just connect one
side of the cable to this connector, removing protection cap and connect the other side to a PC to upload a code or to charge
the battery in case your model has a rechargeable battery. Next picture shows an example.
Figure : USB connector and protective cap
Figure : Connecting the USB cable to Waspmote
When uploading processes are nished, do not forget to screw rmly the protection cap to avoid connector damage. Never
connect a USB which exceed maximum ratings of USB standard.

-9-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
Figure : Connecting USB charger
For indoor deployments the nodes can be recharged using the USB charger.
Important: Use the USB charger just with the models which includes rechargeable battery.
Figure : Charging the mote by USB

-10-
v4.5
Waspmote Plug & Sense! - Quickstart Guide
3.4.1. External SIM socket
The External SIM socket replaces the USB socket in two devices:
• Waspmote Plug & Sense! devices with GPRS module, GPRS+GPS or 3G module
• Meshlium devices with 3G/GPRS module
The External SIM socket is composed of 2 connectors:
• micro-SIM card
• micro-USB (type B)
Figure : External SIM socket in a Plug & Sense! with GPRS, GPRS+GPS or 3G module
The operation with the micro-USB socket is just the same than with the normal USB socket. Just remember to use a micro-USB
cable.
Figure : Connecting the micro-USB cable to Plug & Sense!