Libelium Meshlium Xtreme Quick start guide

-2-
v7.1
Meshlium X
treme
Index
Document version: v7.1 - 03/2017
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. General and safety information ......................................................................................................... 6
2. Important: read me before using ....................................................................................................... 7
3. Meshlium v4.0 vs Meshlium v3.5 ....................................................................................................... 8
3.1. Capabilities comparison............................................................................................................................................................8
3.2. Compatibility with Waspmote and Plug & Sense! nodes ..............................................................................................9
3.3. Compatibility with current cloud software ........................................................................................................................9
3.4. XBee-PRO 868 vs XBee 868LP............................................................................................................................................... 10
3.5. XBee-PRO 900 vs XBee-PRO 900HP.................................................................................................................................... 11
3.6. 3G (SIM5215) vs 4G (LE910)...................................................................................................................................................11
4. Contents of the box ........................................................................................................................... 13
5. Specications..................................................................................................................................... 15
6. How to use Meshlium ........................................................................................................................ 18
6.1. Power supply ..............................................................................................................................................................................18
6.2. External SIM socket ..................................................................................................................................................................19
6.3. How to install the antennas ..................................................................................................................................................20
6.4. Installation of the IP65 Ethernet cable ..............................................................................................................................21
6.5. Installing Meshlium.................................................................................................................................................................. 24
6.6. Initialization, restart and shutdown ................................................................................................................................... 24
6.7. Setting the time.........................................................................................................................................................................25
7. Understanding Meshlium ................................................................................................................. 26
7.1. Concepts ......................................................................................................................................................................................26
7.2. Meshlium models .....................................................................................................................................................................26
7.3. Storage..........................................................................................................................................................................................27
7.4. Application model by model................................................................................................................................................27
8. Accessing Meshlium – make it easy!................................................................................................. 29
9. Network interfaces setup.................................................................................................................. 31
9.1. Ethernet setup............................................................................................................................................................................31
9.2. WiFi Access Point setup...........................................................................................................................................................34
9.2.1. Conguration...............................................................................................................................................................34
9.2.2. Clients connected ......................................................................................................................................................36

-3-
v7.1
Meshlium X
treme
Index
9.3. Network setup conrmation.................................................................................................................................................37
9.4. 4G setup .......................................................................................................................................................................................38
9.5. Proxy setup..................................................................................................................................................................................39
10. Wireless Sensor Networks............................................................................................................... 41
10.1. Meshlium and Waspmote....................................................................................................................................................41
10.2. Receiving and storing data .................................................................................................................................................42
10.2.1. Receiving trough RF communications.............................................................................................................42
10.2.2. Receiving trough 4G / WiFi / Ethernet (HTTP) ...............................................................................................49
10.3. Capturer .....................................................................................................................................................................................49
10.3.1. Local database..........................................................................................................................................................51
10.3.2. External Database....................................................................................................................................................52
10.3.3. Show me Now...........................................................................................................................................................55
10.3.4. Advanced database options................................................................................................................................55
10.4. Logs .............................................................................................................................................................................................57
10.5. Sensor list .................................................................................................................................................................................. 58
10.6. OTA via FTP ...............................................................................................................................................................................59
11. Meshlium Visualizer ........................................................................................................................ 61
11.1. Working with the Visualizer ................................................................................................................................................61
12. Cloud Connectors ............................................................................................................................ 64
12.1. IoT platforms ............................................................................................................................................................................66
12.1.1. Amazon IoT ................................................................................................................................................................66
12.1.2. Esri.................................................................................................................................................................................71
12.1.3. IBM Bluemix...............................................................................................................................................................75
12.1.4. IoT-Ticket.....................................................................................................................................................................76
12.1.5. Microsoft Azure Event Hubs ................................................................................................................................81
12.1.6. Microsoft Azure IoT Hub........................................................................................................................................87
12.1.7. MQTT............................................................................................................................................................................90
12.1.8. RIOT Platform ............................................................................................................................................................93
12.1.9. SensorUp IoT Platform ...........................................................................................................................................94
12.1.10. TechEdge SAP HANA............................................................................................................................................95
12.1.11. Telefónica IoT Platform........................................................................................................................................97
12.1.12. Telit .............................................................................................................................................................................98
12.1.13. ThingWorx.............................................................................................................................................................102
12.2. IoT Solutions...........................................................................................................................................................................106
12.2.1. Amplía’s OpenGate...............................................................................................................................................106
12.2.2. BaseN.........................................................................................................................................................................107
12.2.3. B-Scada.....................................................................................................................................................................109
12.2.4. Cumulocity.............................................................................................................................................................. 111
12.2.5. DeviceLynk..............................................................................................................................................................112
12.2.6. Devicify..................................................................................................................................................................... 114
12.2.7. eagle.io .....................................................................................................................................................................116

-4-
v7.1
Meshlium X
treme
12.2.8. ElementBlue – RightSensor...............................................................................................................................117
12.2.9. Ensura .......................................................................................................................................................................118
12.2.10. Extunda.................................................................................................................................................................. 120
12.2.11. IoTSens ...................................................................................................................................................................121
12.2.12. Kii.............................................................................................................................................................................. 122
12.2.13. Nexmachina .........................................................................................................................................................124
12.2.14. Orchestra............................................................................................................................................................... 126
12.2.15. Sentilo.....................................................................................................................................................................129
12.2.16. Simfony ..................................................................................................................................................................130
12.2.17. SmartCityPlatform .............................................................................................................................................133
12.2.18. SmartPlants .......................................................................................................................................................... 135
12.2.19. Soa2 ......................................................................................................................................................................136
12.2.20. ThingPlus...............................................................................................................................................................142
13. Smartphone detection.................................................................................................................. 145
13.1. Devices detected..................................................................................................................................................................147
13.2. WiFi Scanner ...........................................................................................................................................................................152
13.2.1. Concepts.................................................................................................................................................................. 152
13.2.2. Local database....................................................................................................................................................... 155
13.2.3. External database ................................................................................................................................................. 156
13.3. Bluetooth Scanner ...............................................................................................................................................................158
13.3.1. Concepts.................................................................................................................................................................. 158
13.3.2. Local database....................................................................................................................................................... 160
13.3.3. External database ................................................................................................................................................. 161
14. Tools................................................................................................................................................ 163
14.1. Fresnel calculator..................................................................................................................................................................163
14.2. Iperf ...........................................................................................................................................................................................163
14.3. Ping............................................................................................................................................................................................164
14.4. Traceroute................................................................................................................................................................................165
14.5. Netstat ......................................................................................................................................................................................165
14.6. GPS.............................................................................................................................................................................................166
14.6.1. Concepts.................................................................................................................................................................. 166
14.6.2. Conguring GPS service.....................................................................................................................................166
14.6.3. Local database....................................................................................................................................................... 168
14.6.4. External database ................................................................................................................................................. 169
14.7. Beep...........................................................................................................................................................................................170
15. Database management................................................................................................................. 171
15.1. Direct access...........................................................................................................................................................................171
15.2. PhpMyAdmin .........................................................................................................................................................................171
Index

-5-
v7.1
Meshlium X
treme
16. System Information....................................................................................................................... 173
16.1. Hostname................................................................................................................................................................................173
16.2. Password management......................................................................................................................................................173
16.3. Disk usage ...............................................................................................................................................................................174
16.4. Internal temperature sensor.............................................................................................................................................174
16.5. Time synchronization..........................................................................................................................................................175
17. Upgrading Meshlium .................................................................................................................... 176
17.1. Checking for updates..........................................................................................................................................................176
17.2. Local le...................................................................................................................................................................................177
17.3. URL.............................................................................................................................................................................................178
18. Rescue System ............................................................................................................................... 179
18.1. Rescue steps...........................................................................................................................................................................179
19. Expansion port .............................................................................................................................. 181
20. Manager System changelog ......................................................................................................... 182
21. Documentation changelog........................................................................................................... 183
22. Certications.................................................................................................................................. 184
22.1. General overview..................................................................................................................................................................184
22.2. CE (Europe) .............................................................................................................................................................................184
22.3. FCC (USA).................................................................................................................................................................................185
22.4. IC (Canada)..............................................................................................................................................................................186
22.5. ANATEL (Brazil) ......................................................................................................................................................................186
22.6. RCM (Australia) ......................................................................................................................................................................186
23. Maintenance .................................................................................................................................. 187
24. Disposal and recycling .................................................................................................................. 188
Index

-6-
v7.1
General and safety information
Meshlium X
treme
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 the Limited Warranty and Terms and Conditions of Use before using“Meshlium”.
• Read carefully the “General Conditions of Sale and Use of Libelium”. This document can be found at
http://www.libelium.com/development/meshlium/technical_service
As specied in the Warranty document which you can nd at
http://www.libelium.com/development/meshlium/documentation, the client has 7 days from the day the order is
received to detect any failure and report that to Libelium. Any other failure reported after these 7 days may not be
considered under warranty.
• Do NOT open the enclosure. If you do so, you will lose the guarantee.
• Do not remove any of the components.
• Do not allow contact between metallic objects and the electronic part to avoid injury and burns.
• NEVER immerse the equipment in any liquid.
• Keep the equipment in a dry place away from any liquids that could spill.
• Check from the label that comes with the equipment the maximum permitted voltage and amperage range.
• Keep the equipment within the temperature range indicated in the specications section.
• Do not connect or power the equipment using cables that have been damaged.
• Place the 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 machine.
• If there is a power failure, immediately disconnect from the mains electricity.
• If using the car lighter as a power source, make sure that you follow the voltage and current specications indicated in the
section “How to use Meshlium”.
• If a software failure occurs, consult the section web support.
• Do not place the equipment on trees or plants as they could be damaged by its weight.
• Be particularly careful if you are connected through Ethernet or WiFi; if the settings are incorrectly altered, Meshlium could
become inaccessible.

-7-
v7.1
Important: read me before using
Meshlium X
treme
2. Important: read me before using
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/meshlium/technical_service
Failure to comply with the recommendations of use will entail the guarantee cancellation.
• Do not interrupt the power supply before shutting down Meshlium properly through the “Shutdown” or “Restart” buttons
in the Manager System.
• Do not open the Meshlium enclosure in any case. This will automatically make the warranty void.
• Do not submerge Meshlium in liquids.
• Do not place Meshlium on places or equipment where the device could be exposed to shocks and/or vibrations.
• Do not expose Meshlium to temperatures below -20º C or above 50º C.
• Meshlium’s microprocessor must not overpass 75 Celsius degrees. The user must ensure that this temperature never
overpass. Especially when using WiFi Scan.
• Do not power Meshlium with other power sources than the original provided by Libelium.
For more information: http://www.libelium.com/meshlium

-8-
v7.1
Meshlium v4.0 vs Meshlium v3.5
Meshlium X
treme
3. Meshlium v4.0 vs Meshlium v3.5
This evolution of Meshlium includes an important upgrade of the hardware capabilities. The most important changes are:
• Big step forward in performance, CPU performance 10 times better and RAM capacity 8 times bigger.
• Cellular connection upgraded to 4G for a very fast Internet connection and data synchronization.
• WiFi AP upgraded to WiFi b/g/n (up to 144 Mbps).
• New models of radio module for the 868 MHz and 900 MHz bands.
• Up to two RF (XBee) modules can be installed in the device, working with the 4G radio at the same time (2.4 GHz and
868/900 MHz).
• GPS/GLONASS capabilities for a faster global location.
• New improved design.
• Operating system updated including new versions of programs and system.
• New expansion port for future use of external I2C, USB or UART devices.
• New Meshlium is Microsoft Azure Certied (More info: https://azure.microsoft.com/es-es/marketplace/programs/certied/).
3.1. Capabilities comparison
Previous Meshlium version New Meshlium
CPU cores 1 4
CPU architecture 32 bits 64 bits
CPU frequency 500 MHz 1 GHz
RAM 256 MB DDR 2 GB DDR3
Storing Compact Flash 8 GB SSD disk 16 GB
Linux Kernel 2.6 3.16
Simultaneous cloud services 2-4 15-20
Boot time ~2 minutes Less than 1 minute
WiFi a/b/g (up to 54 Mbps) a/b/g/n (up to 144 Mbps)
Cellular
Up to 7.2 Mbps downlink (SIM5218)
Up to 384 kbps downlink (SIM5215)
Up to 42 Mbps downlink
Antenna connectors 4 10
RF module sockets 1 2
Geolocation GPS GPS + GLONASS
Root access Yes No
Power consumption ~10 W ~15 W (depending on number of radios)
Enclosure (mm) 210 x 190 x 60 30 x 220 x 80
Certications CE / FCC / IC
CE (Europe) / FCC (US) / IC (Canada) /
ANATEL (Brazil) / RCM (Australia) / PTCRB
(US) / AT&T (US)

-9-
v7.1
Meshlium v4.0 vs Meshlium v3.5
Meshlium X
treme
3.2. Compatibility with Waspmote and Plug & Sense! nodes
Old hardware Compatible Notes
Plug & Sense! (Waspmote v1.2) 802.15.4 YES
Plug & Sense! (Waspmote v1.2) ZigBee NO Old ZigBee modules are EoL
Plug & Sense! (Waspmote v1.2) DigiMesh NO
Plug & Sense! (Waspmote v1.2) 900 NO Old 900 MHz modules are EoL. Substituted by the
new 900HP radios.
Plug & Sense! (Waspmote v1.2) 868 NO Old 868 MHz modules are EoL. Substituted by the
new 868 radios.
Plug & Sense! (Waspmote v1.2) WiFi YES
Plug & Sense! (Waspmote v1.2) 3G YES
Plug & Sense! (Waspmote v1.5) 802.15.4 YES
Plug & Sense! (Waspmote v1.5) 900 YES
Plug & Sense! (Waspmote v1.5) 868 YES
Plug & Sense! (Waspmote v1.5) WiFi YES
Plug & Sense! (Waspmote v1.5) 4G YES
Plug & Sense! (Waspmote v1.5) ZigBee NO Meshlium does not support this RF module
3.3. Compatibility with current cloud software
Cloud software Compatible Notes
Amazon IoT yes
Esri yes Only ArcGIS online
IBM Bluemix yes
IOT-Ticket yes
Azure Event Hubs yes
Azure Service Bus no Obsolete: use Event Hubs
MQTT yes
Telefónica yes
ThingWorx yes
amplía yes
Simfony yes
Smart City Platform yes
B-Scada yes
DeviceLynk yes
devicify yes

-10-
v7.1
Meshlium v4.0 vs Meshlium v3.5
Meshlium X
treme
Cloud software Compatible Notes
Eagle.io yes
ElementBlue yes
Extunda yes
IoTSens yes
Sentilo yes
Soa2 yes
Solvver yes
Thing+ yes
Compatibility with other software:
Software Compatible Notes
External DB synchronization of sensor
data. yes Some changes in the tables needed, can be done without losing data.
3.4. XBee-PRO 868 vs XBee 868LP
The new XBee 868LP module supports some changes:
• The new XBee 868LP operates between 863 and 870 MHz, making it deployable in several regions throughout the world
including approved European countries and India by utilizing a software selectable channel masking feature.
• The XBee 868LP is also the industry’s rst RF module using 868 MHz and surrounding frequencies for LBT + AFA (Listen
Before Talk and Adaptive Frequency Agility). This virtually eliminates interference by listening to the radio environment
before any transmission starts, and automatically shifting to a new channel when interference is detected. This patent-
pending frequency scan occurs automatically and in a matter of microseconds so as not to impact performance.
Features comparison:
Feature [Old] XBee-PRO 868 [New] XBee 868LP
Frequency band 868 MHz (1 channel) 863 to 870 MHz (32 channels)
RF data rate 24 kbps 10 kbps
Indoor/urban range Up to 550 m Up to 112 m
Outdoor/line-of-sight range Up to 40 km Up to 8.4 km
Transmit power 25 dBm 14 dBm
Receive sensitivity -112 dBm -106 dBm
Transmit current 500 mA 48 mA
Receive current 65 mA 27 mA
LBT + AFA No Yes