Libelium Meshlium Xtreme Quick start guide

-2-
v7.3
Meshlium X
treme
Index
Document version: v7.3 - 07/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......................................................................................................................... 20
6.3. How to install the antennas........................................................................................................... 21
6.4. Installation of the IP65 Ethernet cable ......................................................................................... 22
6.5. Installing Meshlium......................................................................................................................... 25
6.6. Initialization, restart and shutdown.............................................................................................. 25
6.7. Setting the time............................................................................................................................... 26
7. Understanding Meshlium ..................................................................................................27
7.1. Concepts .......................................................................................................................................... 27
7.2. Meshlium models ........................................................................................................................... 27
7.3. Storage ............................................................................................................................................. 28
7.4. Application model by model.......................................................................................................... 28
8. Accessing Meshlium – make it easy!.................................................................................30
9. Network interfaces setup..................................................................................................32
9.1. Ethernet setup................................................................................................................................. 32
9.2. WiFi Access Point setup.................................................................................................................. 35
9.2.1. Conguration.......................................................................................................................35
9.2.2. Clients connected................................................................................................................37
9.3. Network setup conrmation ......................................................................................................... 38
9.4. 4G setup........................................................................................................................................... 39

-3-
v7.3
Meshlium X
treme
Index
9.5. Proxy setup...................................................................................................................................... 40
9.6. No-IP setup ...................................................................................................................................... 41
10. Wireless Sensor Networks ............................................................................................... 43
10.1. Meshlium and Waspmote............................................................................................................ 43
10.2. Receiving and storing data .......................................................................................................... 44
10.2.1. Receiving trough RF communications ............................................................................44
10.2.2. Receiving trough 4G / WiFi / Ethernet (HTTP) ................................................................51
10.3. Capturer......................................................................................................................................... 51
10.3.1. Local database...................................................................................................................53
10.3.2. External Database.............................................................................................................54
10.3.3. Show me Now....................................................................................................................57
10.3.4. Advanced database options ............................................................................................57
10.4. Logs ................................................................................................................................................ 59
10.5. Sensor list ...................................................................................................................................... 60
10.6. OTA via FTP.................................................................................................................................... 61
11. Meshlium Visualizer .........................................................................................................63
11.1. Working with the Visualizer ......................................................................................................... 63
12. Cloud Connectors..............................................................................................................66
12.1. Premium Cloud Partners ............................................................................................................. 68
12.1.1. Arrow ..................................................................................................................................68
12.1.2. IBM Bluemix.......................................................................................................................73
12.1.3. Microsoft Azure Event Hubs ............................................................................................74
12.1.4. Microsoft Azure IoT Hub ..................................................................................................81
12.1.5. Nexmachina.......................................................................................................................85
12.1.6. ElementBlue – RightSensor..............................................................................................87
12.1.7. Soa2 ..................................................................................................................................89
12.1.8. ThingPlus............................................................................................................................95
12.1.9. ThingWorx..........................................................................................................................98
12.2. Advanced Cloud Partners .......................................................................................................... 102
12.2.1. Amazon IoT ..................................................................................................................... 102
12.2.2. Cumulocity ...................................................................................................................... 107
12.2.3. SmartCityPlatform.......................................................................................................... 108
12.2.4. Telefónica IoT Platform ................................................................................................. 110
12.2.5. Telit .................................................................................................................................. 111
12.3. Basic Cloud Partners .................................................................................................................. 115
12.3.1. Amplía’s OpenGate ........................................................................................................ 115
12.3.2. BaseN............................................................................................................................... 116
12.3.3. B-Scada............................................................................................................................ 118
12.3.4. C2M.................................................................................................................................. 120
12.3.5. DeviceLynk ...................................................................................................................... 122
12.3.6. eagle.io ............................................................................................................................ 124

-4-
v7.3
Meshlium X
treme
12.3.7. Ensura.............................................................................................................................. 125
12.3.8. Ericsson AppIoT.............................................................................................................. 126
12.3.9. Esri ................................................................................................................................... 129
12.3.10. Extunda ......................................................................................................................... 133
12.3.11. HaibuSmart................................................................................................................... 134
12.3.12. inswift.......................................................................................................................... 135
12.3.13. IoT-Ticket....................................................................................................................... 137
12.3.14. IoTSens .......................................................................................................................... 143
12.3.15. Kii ................................................................................................................................... 144
12.3.16. Labeeb........................................................................................................................... 147
12.3.17. MQTT ............................................................................................................................. 150
12.3.18. Orchestra ...................................................................................................................... 153
12.3.19. Redd............................................................................................................................... 156
12.3.20. RIOT Platform ............................................................................................................... 157
12.3.21. SensorUp IoT Platform ................................................................................................ 158
12.3.22. Sentilo............................................................................................................................ 159
12.3.23. Simfony ......................................................................................................................... 160
12.3.24. SmartPlants .................................................................................................................. 163
12.3.25. TechEdge SAP HANA.................................................................................................... 164
13. Device connectors..........................................................................................................166
13.1. Device Partners ........................................................................................................................... 167
13.1.1. Axis................................................................................................................................... 167
14. Smartphone detection ...................................................................................................170
14.1. Devices detected......................................................................................................................... 172
14.2. WiFi Scanner ................................................................................................................................ 177
14.2.1. Concepts.......................................................................................................................... 177
14.2.2. Local database................................................................................................................ 180
14.2.3. External database .......................................................................................................... 181
14.3. Bluetooth Scanner ...................................................................................................................... 183
14.3.1. Concepts.......................................................................................................................... 183
14.3.2. Local database................................................................................................................ 185
14.3.3. External database .......................................................................................................... 186
15. Tools .................................................................................................................................188
15.1. Fresnel calculator........................................................................................................................ 188
15.2. Iperf .............................................................................................................................................. 188
15.3. Ping............................................................................................................................................... 189
15.4. Traceroute ................................................................................................................................... 190
15.5. Netstat.......................................................................................................................................... 190
15.6. GPS ............................................................................................................................................... 191
15.6.1. Concepts.......................................................................................................................... 191
15.6.2. Conguring GPS service ................................................................................................ 191

-5-
v7.3
Meshlium X
treme
15.6.3. Local database................................................................................................................ 193
15.6.4. External database .......................................................................................................... 194
15.7. Beep.............................................................................................................................................. 195
16. Database management..................................................................................................196
16.1. Direct access................................................................................................................................ 196
16.2. PhpMyAdmin............................................................................................................................... 196
17. System Information........................................................................................................198
17.1. Hostname .................................................................................................................................... 198
17.2. Password management ............................................................................................................. 198
17.3. Disk usage.................................................................................................................................... 199
17.4. Internal temperature sensor..................................................................................................... 199
17.5. Time synchronization ................................................................................................................. 200
18. Upgrading Meshlium ......................................................................................................201
18.1. Checking for updates ................................................................................................................. 201
18.2. Local le ....................................................................................................................................... 202
18.3. URL................................................................................................................................................ 203
19. Rescue System................................................................................................................. 204
19.1. Rescue steps................................................................................................................................ 204
20. Expansion port ................................................................................................................206
21. Manager System changelog...........................................................................................207
22. Documentation changelog ............................................................................................ 209
23. Certications...................................................................................................................210
23.1. General overview ........................................................................................................................ 210
23.2. CE (Europe) .................................................................................................................................. 210
23.3. FCC (USA) ..................................................................................................................................... 211
23.4. IC (Canada)................................................................................................................................... 212
23.5. ANATEL (Brazil)............................................................................................................................ 212
23.6. RCM (Australia)............................................................................................................................ 212
24. Maintenance....................................................................................................................213
25. Disposal and recycling....................................................................................................214

-6-
v7.3
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.3
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.3
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.3
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

-10-
v7.3
Meshlium v4.0 vs Meshlium v3.5
Meshlium X
treme
Cloud software Compatible Notes
devicify yes
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