Libelium Waspmote Plug & Sense! Smart Agriculture 3.0 Quick start guide

Smart Agriculture 3.0Smart Agriculture 3.0
Technical GuideTechnical Guide

-2- v7.8
Index
Document version: v7.8 - 02/2020
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. General ................................................................................................................................................. 5
1.1. General and safety information..............................................................................................................................................5
1.2. Conditions of use .........................................................................................................................................................................5
2. New version: Smart Agriculture v3.0 ................................................................................................. 7
3. Waspmote Plug & Sense!..................................................................................................................... 8
3.1. Features ...........................................................................................................................................................................................8
3.2. General view ..................................................................................................................................................................................9
3.2.1. Specications.................................................................................................................................................................9
3.2.2. Parts included..............................................................................................................................................................12
3.2.3. Identication................................................................................................................................................................13
3.3. Sensor probes.............................................................................................................................................................................15
3.4. Solar powered............................................................................................................................................................................ 16
3.5. External Battery Module.........................................................................................................................................................17
3.6. Programming the Nodes........................................................................................................................................................18
3.7. Program in minutes.................................................................................................................................................................. 19
3.8. Radio interfaces......................................................................................................................................................................... 20
3.9. Industrial Protocols...................................................................................................................................................................21
3.10. GPS...............................................................................................................................................................................................23
3.11. Models........................................................................................................................................................................................ 24
4. Hardware............................................................................................................................................ 27
4.1. General description..................................................................................................................................................................27
4.2. Specications .............................................................................................................................................................................27
4.3. Electrical characteristics .........................................................................................................................................................27
4.4. Agriculture v3.0 Board versions...........................................................................................................................................28
5. Sensors ............................................................................................................................................... 29
5.1. Temperature, humidity and pressure sensor (BME280) .............................................................................................29
5.1.1. Specications...............................................................................................................................................................29
5.1.2. Measurement process ..............................................................................................................................................30
5.1.3. Socket.............................................................................................................................................................................31
5.2. Leaf Wetness sensor (LWS).....................................................................................................................................................32
5.2.1. Specications...............................................................................................................................................................32
5.2.2. Measurement process ..............................................................................................................................................32
5.2.3. Socket.............................................................................................................................................................................32
5.3. Soil moisture sensor (Watermark).......................................................................................................................................33
5.3.1. Specications...............................................................................................................................................................33
5.3.2. Measurement process ..............................................................................................................................................33

-3- v7.8
Index
5.3.3. Socket.............................................................................................................................................................................34
5.4. Soil temperature sensor (DS18B20)....................................................................................................................................36
5.4.1. Specications...............................................................................................................................................................36
5.4.2. Measurement Process...............................................................................................................................................36
5.4.3. Socket.............................................................................................................................................................................36
5.5. Soil temperature sensor (Pt-1000).....................................................................................................................................37
5.5.1. Specications...............................................................................................................................................................37
5.5.2. Measurement process ..............................................................................................................................................37
5.5.3. Socket.............................................................................................................................................................................38
5.6. Trunk diameter dendrometer (Ecomatik DC3) ...............................................................................................................39
5.6.1. Specications...............................................................................................................................................................39
5.6.2. Installation process....................................................................................................................................................40
5.6.3. Measurement process ..............................................................................................................................................40
5.6.4. Socket.............................................................................................................................................................................41
5.7. Stem diameter dendrometer (Ecomatik DD-S) ..............................................................................................................42
5.7.1. Specications...............................................................................................................................................................42
5.7.2. Installation process....................................................................................................................................................42
5.7.3. Measurement process ..............................................................................................................................................43
5.7.4. Socket.............................................................................................................................................................................44
5.8. Fruit diameter dendrometer (Ecomatik DF) .................................................................................................................... 45
5.8.1. Specications...............................................................................................................................................................45
5.8.2. Installation process....................................................................................................................................................46
5.8.3. Measurement process ..............................................................................................................................................47
5.8.4. Socket.............................................................................................................................................................................49
5.9. Solar radiation sensor - PAR (SQ-110) ................................................................................................................................50
5.9.1. Specications...............................................................................................................................................................50
5.9.2. Measurement process ..............................................................................................................................................51
5.9.3. Socket.............................................................................................................................................................................52
5.10. Ultraviolet Radiation sensor (SU-100) ............................................................................................................................. 53
5.10.1. Specications ............................................................................................................................................................53
5.10.2. Measurement process............................................................................................................................................54
5.10.3. Socket ..........................................................................................................................................................................54
5.11. Weather station (WS-3000) .................................................................................................................................................55
5.11.1. Anemometer .............................................................................................................................................................55
5.11.2. Wind vane...................................................................................................................................................................57
5.11.3. Pluviometer................................................................................................................................................................59
5.12. Ultrasonic Sensor (MaxSonar® from MaxBotix™) ........................................................................................................61
5.12.1. Specications ............................................................................................................................................................61
5.12.2. Measurement Process............................................................................................................................................63
5.12.3. Socket ..........................................................................................................................................................................64
5.13. Luminosity sensor (TSL2561) .............................................................................................................................................65
5.13.1. Specications ............................................................................................................................................................65
5.13.2. Measurement process............................................................................................................................................65
5.14. Sockets for casing...................................................................................................................................................................66

-4- v7.8
6. Board conguration and programming .......................................................................................... 69
6.1. Hardware conguration .........................................................................................................................................................69
6.2. API...................................................................................................................................................................................................69
6.2.1. Agriculture Class.........................................................................................................................................................69
6.2.2. dendrometerClass......................................................................................................................................................70
6.2.3. ds18b20Class..............................................................................................................................................................70
6.2.4. leafWetnessClass ........................................................................................................................................................70
6.2.5. pt1000Class ..................................................................................................................................................................70
6.2.6. radiationClass ..............................................................................................................................................................70
6.2.7. watermarkClass..........................................................................................................................................................71
6.2.8. weatherStationClass..................................................................................................................................................71
7. API changelog.................................................................................................................................... 72
8. Documentation changelog............................................................................................................... 73
9. Consumption ..................................................................................................................................... 74
9.1. Tables of consumption............................................................................................................................................................74
9.2. Low consumption mode........................................................................................................................................................74
10. Maintenance .................................................................................................................................... 75
11. Disposal and recycling .................................................................................................................... 76
12. Certications.................................................................................................................................... 77
Appendix 1: Watermark sensor’s interpretation reference................................................................ 78
Appendix 2: Solar sensors mounting accessory installation guide................................................... 81
Index

-5- v7.8
General
1. General
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.
1.1. General and safety information
•In this section, the term “Waspmote” encompasses both the Waspmote device itself and its modules and
sensor boards.
•Read through the document “General Conditions of Libelium Sale and Use”.
•Do not allow contact of metallic objects with the electronic part to avoid injuries and burns.
•NEVER submerge the device in any liquid.
•Keep the device in a dry place and away from any liquid which may spill.
•Waspmote consists of highly sensitive electronics which is accessible to the exterior, handle with great care
and avoid bangs or hard brushing against surfaces.
•Check the product specications section for the maximum allowed power voltage and amperage range and
consequently always use a current transformer and a battery which works within that range. Libelium is only
responsible for the correct operation of the device with the batteries, power supplies and chargers which it
supplies.
•Keep the device within the specied range of temperatures in the specications section.
•Do not connect or power the device with damaged cables or batteries.
•Place the device in a place only accessible to maintenance personnel (a restricted area).
•Keep children away from the device in all circumstances.
•If there is an electrical failure, disconnect the main switch immediately and disconnect that battery or any
other power supply that is being used.
•If using a car lighter as a power supply, be sure to respect the voltage and current data specied in the “Power
Supplies” section.
•If using a battery in combination or not with a solar panel as a power supply, be sure to use the voltage and
current data specied in the “Power supplies” section.
•If a software or hardware failure occurs, consult the Libelium Web Development section.
•Check that the frequency and power of the communication radio modules together with the integrated
antennas are allowed in the area where you want to use the device.
•Waspmote is a device to be integrated in a casing so that it is protected from environmental conditions such
as light, dust, humidity or sudden changes in temperature. The board supplied “as is” is not recommended for
a nal installation as the electronic components are open to the air and may be damaged.
1.2. Conditions of use
•Read the “General and Safety Information” section carefully and keep the manual for future consultation.
•Use Waspmote in accordance with the electrical specications and the environment described in the “Electrical
Data” section of this manual.
•Waspmote and its components and modules are supplied as electronic boards to be integrated within a nal
product. This product must contain an enclosure to protect it from dust, humidity and other environmental
interactions. In the event of outside use, this enclosure must be rated at least IP-65.
•Do not place Waspmote in contact with metallic surfaces; they could cause short-circuits which will permanently
damage it.

-6- v7.8
General
Further information you may need can be found at: http://www.libelium.com/development/waspmote
The “General Conditions of Libelium Sale and Use” document can be found at:
http://www.libelium.com/development/waspmote/technical_service

-7- v7.8
New version: Smart Agriculture v3.0
2. New version: Smart Agriculture v3.0
This guide explains the new Smart Agriculture Sensor Board v3.0. This board was specically designed for our new
product lines Waspmote v15 and Plug & Sense! v15, released on October 2016.
This board is not compatible with Waspmote v12 or Plug & Sense! v12, so it is NOT recommended to mix product
generations. If you are using previous versions of our products, please use the corresponding guides, available on
our Development website.
You can get more information about the generation change on the document “New generation of Libelium product
lines”.
Dierences of Smart Agriculture v3.0 with previous versions:
•Included the new BME280 temperature, humidity and air pressure sensor. This tiny, digital and cost-ecient
sensor measures 3 parameters with great accuracy and range.
•The BME280 replaces the previous analog Temperature sensor (MCP9700A), the analog Humidity sensor
(808H5V5), the double Sensirion sensor (SHT75) and the Atmospheric Pressure sensor (MPX4115A).
•Many internal changes have been made on the board circuitry to reduce the BoM. Now some sensors are
multiplexed, avoiding duplicate parts.
•Clearer silkscreen for easier connection.
•Digital Bus socket allows the connections of digital sensors.
•Added an Digital Bus isolator chip to avoid aecting to the Waspmote Digital Bus.
•The library has been improved to make easier the board handling.
•New connectors to improve the Plug & Sense! wiring, making it more robust.
•Included ultrasound sensor and luminosity sensor.

-8- v7.8
Waspmote Plug & Sense!
3. Waspmote Plug & Sense!
The Waspmote Plug & Sense! line allows you to easily deploy Internet of Things networks in an easy and scalable
way, ensuring minimum maintenance costs. The platform consists of a robust waterproof enclosure with specic
external sockets to connect the sensors, the solar panel, the antenna and even the USB cable in order to reprogram
the node. It has been specially designed to be scalable, easy to deploy and maintain.
Note: For a complete reference guide download the “Waspmote Plug & Sense! Technical Guide” in the Development
section of the Libelium website.
3.1. Features
• Robust waterproof IP65 enclosure
• Add or change a sensor probe in seconds
• Solar powered external panel option
• Radios available: 802.15.4, 868 MHz, 900 MHz, WiFi, 4G, Sigfox and LoRaWAN
• Over the air programming (OTAP) of multiple nodes at once (via WiFi or 4G radios)
• Special holders and brackets ready for installation in street lights and building fronts
• Graphical and intuitive interface Programming Cloud Service
• Built-in, 3-axes accelerometer
• External, contactless reset with magnet
• Optional industrial protocols: RS-485, Modbus, CAN Bus
• Optional GPS receiver
• Optional External Battery Module
• External SIM connector for the 4G models
• Fully certied: CE (Europe), FCC (USA), IC (Canada), ANATEL (Brazil), RCM (Australia), PTCRB (USA, cellular
connectivity), AT&T (USA, cellular connectivity)
Figure: Waspmote Plug & Sense!

-9- v7.8
Waspmote Plug & Sense!
3.2. General view
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.2.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!

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

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

-12- v7.8
Waspmote Plug & Sense!
Figure: Warranty stickers of the enclosure
Important note: Do not handle black stickers seals 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
automatically void.
3.2.2. Parts included
Next picture shows Waspmote Plug & Sense! and all of its elements. Some of them are optional accessories that
may not be included.
1
2
3
4
5
7
6
8
9
10
Figure: Waspmote Plug & Sense! accessories: 1 enclosure, 2 sensor probes, 3 external solar panel, 4 USB cable, 5 antenna, 6 cable ties,
7 mounting feet (screwed to the enclosure), 8 extension cord, 9 solar panel cable, 10 wall plugs & screws

-13- v7.8
Waspmote Plug & Sense!
3.2.3. Identication
Each Waspmote model is identied by stickers. Next gure shows front sticker.
Model identication colour
Enclosure model
Figure: Front sticker of the enclosure
There are many congurations of Waspmote Plug & Sense! line, all of them identied by one unique sticker. Next
image shows all possibilities.
Figure: Dierent front stickers

-14- v7.8
Waspmote Plug & Sense!
Moreover, Waspmote Plug & Sense! includes a back sticker where it is shown identication numbers, radio MAC
addresses, etc. It is highly recommended to annotate this information and save it for future maintenance. Next
gure shows it in detail.
Figure: Back sticker
Sensor probes are identied too by a sticker showing the measured parameter and the sensor manufacturer
reference.
CO - TGS2442
Measure
parameter
Sensor
reference
Figure: Sensor probe identication sticker

-15- v7.8
Waspmote Plug & Sense!
3.3. Sensor probes
Sensor probes can be easily attached by just screwing them into the bottom sockets. This allows you to add new
sensing capabilities to existing networks just in minutes. In the same way, sensor probes may be easily replaced
in order to ensure the lowest maintenance cost of the sensor network.
Figure: Connecting a sensor probe to Waspmote Plug & Sense!
Go to the Plug & Sense! Sensor Guide to know more about our sensor probes.

-16- v7.8
Waspmote Plug & Sense!
3.4. Solar powered
The battery can be recharged using the waterproof USB cable but also the external solar panel option.
The external solar panel is mounted on a 45º holder which ensures the maximum performance of each outdoor
installation.
Figure: Waspmote Plug & Sense! powered by an external solar panel

-17- v7.8
Waspmote Plug & Sense!
3.5. External Battery Module
The External Battery Module (EBM) is an accessory to extend the battery life of Plug & Sense!. The extension
period may be from months to years depending on the sleep cycle and radio activity. The daily charging period is
selectable among 5, 15 and 30 minutes with a selector switch and it can be combined with a solar panel to extend
even more the node’s battery lifetime.
Note: Nodes using solar panel can keep using it through the External Battery Module. The EBM is connected to
the solar panel connector of Plug & Sense! and the solar panel unit is connected to the solar panel connector
of the EBM.
Figure: Plug & Sense! with External Battery Module
Figure: Plug & Sense! with External Battery Module and solar panel

-18- v7.8
Waspmote Plug & Sense!
3.6. Programming the Nodes
Waspmote Plug & Sense! can be reprogrammed in two ways:
The basic programming is done from the USB port. Just connect the USB to the specic external socket and then
to the computer to upload the new rmware.
Figure: Programming a node
Over the Air Programming (OTAP) is also possible once the node has been installed (via WiFi or 4G radios). With
this technique you can reprogram, wireless, one or more Waspmote sensor nodes at the same time by using a
laptop and Meshlium.
Figure: Typical OTAP process

-19- v7.8
Waspmote Plug & Sense!
3.7. Program in minutes
The Programming Cloud Service is an intuitive graphic interface which creates code automatically. The user just
needs to to ll a web form to obtain binaries for Plug & Sense!. Advanced programming options are available,
depending on the license selected.
Check how easy it is to handle the Programming Cloud Service at:
https://cloud.libelium.com/
Figure: Programming Cloud Service

-20- v7.8
Waspmote Plug & Sense!
3.8. Radio interfaces
Radio Protocol Frequency
bands
Transmission
power Sensitivity Range* Certication
XBee-PRO 802.15.4
EU 802.15.4 2.4 GHz 10 dBm -100 dBm 750 m CE
XBee-PRO 802.15.4 802.15.4 2.4 GHz 18 dBm -100 dBm 1600 m FCC, IC, ANATEL,
RCM
XBee 868LP RF 868 MHz 14 dBm -106 dBm 8.4 km CE
XBee 900HP US RF 900 MHz 24 dBm -110 dBm 15.5 km FCC, IC
XBee 900HP BR RF 900 MHz 24 dBm -110 dBm 15.5 km ANATEL
XBee 900HP AU RF 900 MHz 24 dBm -110 dBm 15.5 km RCM
WiFi
WiFi
(HTTP(S),
FTP, TCP,
UDP)
2.4 GHz 17 dBm -94 dBm 500 m CE, FCC, IC,
ANATEL, RCM
4G EU/BR
4G/3G/2G
(HTTP, FTP,
TCP, UDP)
GPS
800, 850, 900,
1800, 2100, 2600
MHz
4G: class 3
(0.2 W, 23 dBm)
4G: -102
dBm
- km - Typical
base station
range
CE, ANATEL
4G US v2
4G/3G
(HTTP, FTP,
TCP, UDP)
700, 850, 1700,
1900 MHz
4G: class 3
(0.2 W, 23 dBm)
4G: -103
dBm
- km - Typical
base station
range
FCC, IC, PTCRB,
AT&T
4G AU
4G
(HTTP, FTP,
TCP, UDP)
700, 1800, 2600
MHz
4G: class 3
(0.2 W, 23 dBm)
4G: -102
dBm
- km - Typical
base station
range
RCM
Sigfox EU Sigfox 868 MHz 16 dBm -126 dBm
- km - Typical
base station
range
CE
Sigfox US Sigfox 900 MHz 24 dBm -127 dBm
- km - Typical
base station
range
FCC, IC
Sigfox AU / APAC /
LATAM Sigfox 900 MHz 24 dBm -127 dBm
- km - Typical
base station
range
-
LoRaWAN EU LoRaWAN 868 MHz 14 dBm -136 dBm > 15 km CE
LoRaWAN US LoRaWAN 902-928 MHz 18.5 dBm -136 dBm > 15 km FCC, IC
LoRaWAN AU LoRaWAN 915-928 MHz 18.5 dBm -136 dBm > 15 km -
LoRaWAN IN LoRaWAN 865-867 MHz 18.5 dBm -136 dBm > 15 km -
LoRaWAN ASIA-PAC
/ LATAM LoRaWAN 923 MHz 18.5 dBm -136 dBm > 15 km -
LoRaWAN JP / KR LoRaWAN
923 MHz,
920-923 MHz
16 dBm / 14 dBm -135.5 dBm > 15 km -
* Line of sight and Fresnel zone clearance with 5dBi dipole antenna.