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...
The present Guide was created in the hope of helping the developer in the very first 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.
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.
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.
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.
Page 7
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.
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.
Page 9
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...
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: •...
Page 11
The micro-SIM card connector allows now the user to connect the SIM card he likes from the outside. It is no longer necessary to send a SIM card to Libelium for proper installation. You can ask your telecommunication provider for a micro-SIM card.
To connect the antenna, just align it with the connector and screw it carefully. Antenna must be connected in order to ensure RF communication. Figure : Connecting antenna to the enclosure Note: Once Waspmote Plug & Sense! is installed, it is recommended to fix it using a tape like the one shown in the picture below. -12- v4.5...
Page 13
Waspmote Plug & Sense! - Quickstart Guide Figure : Recommended tape Figure : Ensure antenna remains in the right position Do not try to connect other kind of antennas which do not match with SMA RP standard connector and also other antennas not provided by Libelium.
Waspmote IDE using the Debian and Ubuntu distributions, as they have been used during development. The process for Ubuntu 9.04 is explained below. To be able to correctly compile and use Waspmote it is necessary to install some packets related with the version of the compiler for Atmel microcontrollers and Java environment.
Select the option “Not right now” and press the ‘Next’ button. Next select the path where the drivers for the FTDI converter are. These drivers are in the folder where Waspmote was unzipped. Then proceed to the installation of the FTDI converter drivers, which shows the following message when finished.
Waspmote, the program starts again). Every packet contains a message with sensor data formatted as Waspmote Data Frame. The sensor fields added to the frame are: Accelerometer values, RTC internal temperature value, and battery level. In the case the XBee is not using DigiMesh protocol, then the MAC address is added (because of length constraints).
Waspmote GPRS+GPS Networking Guide Meshlium will receive the sensor data sent by Waspmote using the radio module and it will store the frames in the Local Database. That can be done in an automatic way thanks to the Sensor Parser.
Waspmote Plug & Sense! - Quickstart Guide 6. Compiling a New Program To use the Waspmote IDE compiler we must run the executable script called ‘Waspmote’ , which is in the folder where the compiler has been installed. Waspmote IDE is divided into 4 main parts which can be seen in the following figure.
Page 19
Waspmote Plug & Sense! - Quickstart Guide The next step is to configure the folder where the created programs are going to be saved. In the Waspmote IDE, this folder is called ‘sketchbook’ and can be configured by accessing the ‘File/Preferences’ tab. Clicking on this tab will open a new window where the location of the sketchbook can be indicated.
7. Uploading a New Program to Waspmote Plug & Sense! Using the USB connector, a new code can be uploaded to Waspmote without opening Waspmote Plug & Sense!. Just connect one side of the USB cable to this connector, removing protection cap if necessary and connect the other side to a PC. Remember that Waspmote must be ON to allow uploading a new code.
Page 21
Waspmote Plug & Sense! - Quickstart Guide Step 2: Connect the USB cable to Waspmote Plug & Sense! Connect one side of the provided male-to-male USB cable to the USB connector. For models with GPRS, GPRS+GPS or 3G module, a micro-USB is supplied.
Page 22
Figure : Turning ON Waspmote Step 5: Open Waspmote IDE Now open Waspmote IDE. If you do not have Waspmote IDE already installed in your PC, then go to the Development section of Libelium website to download the latest version.
Page 23
Step 7: Select the corresponding API Select the API version corresponding to Waspmote Plug & Sense! going to tools/board. If you do not have the API for Waspmote Plug & Sense!, please go to the Development section of Libelium website and download the latest version.
Page 24
Figure : Selecting the USB port for Waspmote Plug & Sense! Note: the name of the USB ports depends on the OS and the particular PC you have. The best way to find the USB where Waspmote is connected is trial & error.
Page 25
When uploading processes are finished successfully, do not forget to screw the protection cap of USB connector to avoid its damage. Never connect a USB which exceed maximum ratting of the USB standard. Waspmote can be damaged and warranty voided. -25-...
This means you should start from the lower examples and then move to the advanced examples. Reading sensors is also easy and it must be one of the first steps. The Waspmote Plug & Sense! Sensor Guide must be read and then you can execute the related examples or play with the Code Generator.
Waspmote Plug & Sense! - Quickstart Guide 9. Documentation Changelog From v4.4 to v4.5 • References to the new LoRa and GPRS+GPS module • Some general changes From v4.3 to v4.4 • Replaced references to old green IDE • Fixed ON/OFF button references From v4.2 to v4.3:...
Need help?
Do you have a question about the Waspmote and is the answer not in the manual?
Questions and answers