Libelium Smart Agriculture Xtreme 1.0 Quick start guide

Smart Agriculture Xtreme 1.0
Technical Guide

-2-
v7.2
Index
Document version: v.7.2 - 03/2019
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. General and safety information ......................................................................................................... 6
2. Important: Read before use................................................................................................................ 7
3. Waspmote Plug & Sense!..................................................................................................................... 8
3.4. Sensor probes.............................................................................................................................................................................14
3.5. Solar powered............................................................................................................................................................................15
3.6. External Battery Module.........................................................................................................................................................16
3.7. Programming the Nodes........................................................................................................................................................ 17
3.8. Program in minutes..................................................................................................................................................................18
3.9. Radio interfaces.........................................................................................................................................................................19
3.10. Industrial Protocols................................................................................................................................................................20
3.11. GPS...............................................................................................................................................................................................22
3.12. Models........................................................................................................................................................................................23
3.12.1. Smart Agriculture Xtreme.....................................................................................................................................24
4. Sensors probes.................................................................................................................................. 27
4.1. General comments...................................................................................................................................................................27
4.2. Non-contact surface temperature measurement sensor probe (Apogee SI-411).............................................28
4.2.1. Specications...............................................................................................................................................................28
4.2.2. Measurement process ..............................................................................................................................................29
4.2.3. Socket.............................................................................................................................................................................29
4.2.4. Installation ....................................................................................................................................................................30
4.2.5. Application examples...............................................................................................................................................31
4.2.6. Certicate of calibration ..........................................................................................................................................31
4.3. Leaf and ower bud temperature sensor probe (Apogee SF-421) .........................................................................32
4.3.1. Specications...............................................................................................................................................................32
4.3.2. Measurement process ..............................................................................................................................................33
4.3.3. Socket.............................................................................................................................................................................33
4.3.4. Installation ....................................................................................................................................................................34
4.3.5. Application examples...............................................................................................................................................35
4.3.6. Quality Assurance Certicate.................................................................................................................................35
4.4. Soil oxygen level sensor probe (Apogee SO-411)......................................................................................................... 36
4.4.1. Specications...............................................................................................................................................................37
4.4.2. Measurement process ..............................................................................................................................................37
4.4.3. Socket.............................................................................................................................................................................38
4.4.4. Installation ....................................................................................................................................................................39
4.4.5. Application examples...............................................................................................................................................40
4.4.6. Quality Assurance Certicate.................................................................................................................................40
4.5. Shortwave radiation sensor probe (Apogee SP-510)..................................................................................................41

-3-
v7.2
Index
4.5.1. Specications...............................................................................................................................................................41
4.5.2. Measurement process ..............................................................................................................................................42
4.5.3. Socket.............................................................................................................................................................................42
4.5.4. Installation ....................................................................................................................................................................43
4.5.5. Application examples...............................................................................................................................................45
4.5.6. Certicate of calibration ..........................................................................................................................................45
4.6. Solar radiation sensor probe for Smart Agriculture Xtreme (Apogee SQ-110) ..................................................46
4.6.1. Specications...............................................................................................................................................................47
4.6.2. Measurement process ..............................................................................................................................................47
4.6.3. Socket.............................................................................................................................................................................48
4.6.4. Installation ....................................................................................................................................................................48
4.6.5. Application examples...............................................................................................................................................50
4.6.6. Certicate of calibration ..........................................................................................................................................50
4.7. Ultraviolet radiation sensor probe for Smart Agriculture Xtreme (Apogee SU-100)........................................ 51
4.7.1. Specications...............................................................................................................................................................52
4.7.2. Measurement process ..............................................................................................................................................52
4.7.3. Socket.............................................................................................................................................................................53
4.7.4. Installation ....................................................................................................................................................................53
4.7.5. Application examples...............................................................................................................................................55
4.7.6. Certicate of calibration ..........................................................................................................................................55
4.8. Temperature, humidity and pressure sensor probe (Bosch BME280)................................................................... 56
4.8.1. Specications...............................................................................................................................................................56
4.8.2. Measurement process ..............................................................................................................................................57
4.8.3. Socket.............................................................................................................................................................................57
4.8.4. Application examples...............................................................................................................................................58
4.9. Conductivity, water content and soil temperature GS3 sensor probe (Decagon GS3) ...................................59
4.9.1. Specications...............................................................................................................................................................60
4.9.2. Measurement process ..............................................................................................................................................60
4.9.3. Socket.............................................................................................................................................................................61
4.9.4. Installation ....................................................................................................................................................................61
4.9.5. Application examples...............................................................................................................................................62
4.9.6. Quality Assurance Certicate.................................................................................................................................62
4.10. Conductivity, water content and soil temperature 5TE sensor probe (Decagon 5TE) .................................63
4.10.1. Specications ............................................................................................................................................................64
4.10.2. Measurement process............................................................................................................................................64
4.10.3. Socket ..........................................................................................................................................................................65
4.10.4. Installation..................................................................................................................................................................66
4.10.5. Application examples.............................................................................................................................................66
4.10.6. Quality Assurance Certicate ..............................................................................................................................66
4.11. Soil temperature and volumetric water content sensor probe (Decagon 5TM) .............................................67
4.11.1. Specications ............................................................................................................................................................68
4.11.2. Measurement process............................................................................................................................................68
4.11.3. Socket ..........................................................................................................................................................................69
4.11.4. Installation..................................................................................................................................................................69
4.11.5. Application examples.............................................................................................................................................70

-4-
v7.2
4.11.6. Quality Assurance Certicate ..............................................................................................................................70
4.12. Soil water potential sensor probe (Decagon MPS-6).................................................................................................71
4.12.1. Specications ............................................................................................................................................................72
4.12.2. Measurement process............................................................................................................................................72
4.12.3. Socket ..........................................................................................................................................................................73
4.12.4. Installation..................................................................................................................................................................73
4.12.5. Application examples.............................................................................................................................................74
4.12.6. Quality Assurance Certicate ..............................................................................................................................74
4.13. Vapor pressure, temperature, barometric pressure and relative humidity sensor (Decagon VP-4) ......... 75
4.13.1. Specications ............................................................................................................................................................76
4.13.2. Measurement process............................................................................................................................................78
4.13.3. Socket ..........................................................................................................................................................................79
4.13.4. Installation..................................................................................................................................................................79
4.13.5. Application examples.............................................................................................................................................80
4.13.6. Quality Assurance Certicate ..............................................................................................................................80
4.14. Leaf wetness Phytos 31 sensor probe (Decagon Phytos 31) .................................................................................81
4.14.1. Specications ............................................................................................................................................................82
4.14.2. Measurement process............................................................................................................................................82
4.14.3. Socket ..........................................................................................................................................................................82
4.14.4. Installation.................................................................................................................................................................83
4.14.5. Application examples.............................................................................................................................................83
4.14.6. Quality Assurance Certicate ..............................................................................................................................83
4.15. Dendrometer sensor probes for Smart Agriculture Xtreme (Ecomatik DC2, DD-S and DF)........................84
4.15.1. Ecomatik DC2 specications (Trunk diameter)............................................................................................84
4.15.2. Ecomatik DD-S specications (Stem diameter) ............................................................................................85
4.15.3. Ecomatik DF specications (Fruit diameter) ..................................................................................................85
4.15.4. Measurement process............................................................................................................................................85
4.15.5. Socket ..........................................................................................................................................................................86
4.15.6. Installation.................................................................................................................................................................87
4.15.7. Application examples.............................................................................................................................................87
4.16. Weather station sensor probes (Gill Instruments MaxiMet series) ......................................................................88
4.16.1. MaxiMet GMX-100 (PO) sensor probe..............................................................................................................89
4.16.2. MaxiMet GMX-101 (R) sensor probe.................................................................................................................89
4.16.3. MaxiMet GMX-200 (W) sensor probe ...............................................................................................................90
4.16.4. MaxiMet GMX-240 (W-PO) sensor probe........................................................................................................91
4.16.5. MaxiMet GMX-300 (T-H-AP) sensor probe......................................................................................................92
4.16.6. MaxiMet GMX-301 (T-H-AP-R) sensor probe..................................................................................................92
4.16.7. MaxiMet GMX-400 (PO-T-H-AP) sensor probe...............................................................................................93
4.16.8. MaxiMet GMX-500 (W-T-H-AP) sensor probe.................................................................................................94
4.16.9. MaxiMet GMX-501 (W-T-H-AP-R) sensor probe.............................................................................................95
4.16.10. MaxiMet GMX-531 (W-PT-T-H-AP-R) sensor probe....................................................................................96
4.16.11. MaxiMet GMX-541 (W-PO-T-H-AP-R) sensor probe...................................................................................97
4.16.12. MaxiMet GMX-550 (W-x-T-H-AP) sensor probe ..........................................................................................98
4.16.13. MaxiMet GMX-551 (W-x-T-H-AP-R) sensor probe ......................................................................................99
4.16.14. MaxiMet GMX-600 (W-PO-T-H-AP) sensor probe ...................................................................................100
Index

-5-
v7.2
4.16.15. Specications for each weather station sensor.......................................................................................101
4.16.16. Measurement process ......................................................................................................................................102
4.16.17. Socket.....................................................................................................................................................................103
4.16.18. Installation ............................................................................................................................................................103
4.16.20. Product test report ............................................................................................................................................106
4.17. Solar radiation and temperature Datasol MET probe (Atersa Datasol MET)...................................................107
4.17.1. Specications .........................................................................................................................................................107
4.17.2. Measurement process......................................................................................................................................... 108
4.17.3. Socket ....................................................................................................................................................................... 108
4.17.4. Installation............................................................................................................................................................... 109
4.17.5. Application examples..........................................................................................................................................112
4.17.6. Certicate of calibration.....................................................................................................................................112
4.18. Luminosity sensor (AMS TSL2561)..................................................................................................................................113
4.18.1. Specications .........................................................................................................................................................113
4.18.2. Measurement process......................................................................................................................................... 114
4.18.3. Socket ....................................................................................................................................................................... 114
4.18.4. Application examples..........................................................................................................................................114
4.19. Ultrasound sensor probe (Maxbotix MB7040)..........................................................................................................115
4.19.1. Specications .........................................................................................................................................................115
4.19.2. Measurement process......................................................................................................................................... 116
4.19.3. Socket ....................................................................................................................................................................... 116
4.19.4. Installation............................................................................................................................................................... 117
4.19.5. Application examples..........................................................................................................................................117
5. Board conguration and programming ........................................................................................ 118
5.1. Hardware conguration .......................................................................................................................................................118
5.2. API.................................................................................................................................................................................................118
5.2.1. Before starting to program..................................................................................................................................118
5.2.2. Sending sensor values with the Frame class.................................................................................................119
6. Consumption ................................................................................................................................... 120
6.1. Consumption table.................................................................................................................................................................120
7. API changelog.................................................................................................................................. 121
8. Documentation changelog............................................................................................................. 122
9. Certications.................................................................................................................................... 123
10. Maintenance ................................................................................................................................. 124
11. Disposal and recycling ................................................................................................................. 125

-6-
v7.2
General and safety information
1. General and safety information
Important:
•All documents and any examples they contain are provided as-is and are subject to change without notice.
Except to the extent prohibited by law, Libelium makes no express or implied representation or warranty of
any kind with regard to the documents, and specically disclaims the implied warranties and conditions of
merchantability and tness for a particular purpose.
•The information on Libelium’s websites has been included in good faith for general informational purposes
only. It should not be relied upon for any specic purpose and no representation or warranty is given as to its
accuracy or completeness.
•Read carefully Limited Warranty and Terms and Conditions of Use before using “Waspmote Plug & Sense!”.
•Do not open casing and do not damage black warranty stickers. If you do so, you will lose warranty.
•Do not remove any of the connectors.
•Do not allow contact between metallic objects and electronic parts to avoid injury and burns.
•Never immerse equipment in any liquid.
•Keep equipment within temperature range indicated in recommendation section.
•Do not connect or power equipment using cables that have been damaged.
•Place equipment in an area to which only maintenance personnel can have access (in a restricted access zone).
•In any case keep children away from the equipment.
•If there is a power failure, immediately disconnect from the mains.
•If using a battery whether or not in combination with a solar panel as a power source follow the voltage and
current specications indicated in the section “External solar panel connector”.
•If a software failure occurs, contact Libelium technical support before doing any action by yourself.
•Do not place equipment on trees or plants as they could be damaged by its weight.
•Be particularly careful if you are connected through a software interface for handling the machine; if settings
of that interface are incorrectly altered, it could become inaccessible.
•If you need to clean the node, wipe it with a dry towel.
•If Waspmote Plug & Sense! needs to be returned please send it completely dry and free from contaminants.
•Waspmote Plug & Sense! is not designed to be placed in hard environmental conditions, under dangerous
chemical elements, explosive atmospheres with ammable gases, high voltage installations or special
installations. Please contact Libelium technical support to ensure your application is compatible with
Waspmote Plug & Sense!

-7-
v7.2
Important: Read before use
2. Important: Read before use
The following list shows just some of the actions that produce the most common failures and warranty-voiding.
Complete documentation about usage can be found at http://www.libelium.com/development. Failure to comply
with the recommendations of use will entail the warranty cancellation.
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 ensure 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 -20 ºC or above 60 ºC.
•Do not power Waspmote 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.
•Do not get the magnet close to a metal object. The magnet is really powerful and will get stuck.
•Do not place the magnet close to electronic devices, like PCs, batteries, etc, they could be damaged, or
information could be deleted.

-8-
v7.2
Waspmote Plug & Sense!
3. Waspmote Plug & Sense!
This section shows main parts of Waspmote Plug & Sense! and a brief description of each one. In later sections
all parts will be described deeply.
3.1. Specications
• Material: polycarbonate
• Sealing: polyurethane
• Cover screws: stainless steel
• Ingress protection: IP65
• Impact resistance: IK08
• Rated insulation voltage AC: 690 V
• Rated insulation voltage DC: 1000 V
• Heavy metals-free: Yes
• Weatherproof: true - nach UL 746 C
• Ambient temperature (min.): -30 °C*
• Ambient temperature (max.): 70 °C*
• Approximated weight: 800 g
* Temporary extreme temperatures are supported. Regular recommended usage: -20, +60 ºC.
In the pictures included below it is shown a general view of Waspmote Plug & Sense! main parts. Some elements
are dedicated to node control, others are designated to sensor connection and other parts are just identication
elements. All of them will be described along this guide.
164 mm
124 mm
175 mm
410 mm
160 mm
122 mm
85 mm
Figure: Main view of Waspmote Plug & Sense!

-9-
v7.2
Waspmote Plug & Sense!
Figure: Control side of the enclosure
Control side of the enclosure for 4G model
Figure: Sensor side of the enclosure

-10-
v7.2
Waspmote Plug & Sense!
Figure: Antenna side of the enclosure
Figure: Front view of the enclosure
Figure: Back view of the enclosure