Libelium Meshlium Xtreme Quick start guide

-2-
v5.0
Meshlium X
treme
Index
Document version: v5.0- 04/2015
© Libelium Comunicaciones Distribuidas S.L.
INDEX
1. General and safety information ......................................................................................................... 6
2. Important: read me before using ....................................................................................................... 7
3. Contents of the box ............................................................................................................................. 8
4. Specications..................................................................................................................................... 10
5. Accessories ........................................................................................................................................ 15
6. How to use Meshlium ........................................................................................................................ 17
6.1. Power supply ..............................................................................................................................................................................17
6.2. External SIM socket ..................................................................................................................................................................22
6.3. How to install the antennas ..................................................................................................................................................23
6.4. Installation of the IP65 Ethernet cable ..............................................................................................................................24
6.5. Installing Meshlium..................................................................................................................................................................27
6.6. Initialization, Restart and Shutdown..................................................................................................................................27
6.7. Setting the time.........................................................................................................................................................................28
7. Understanding Meshlium ................................................................................................................. 29
7.1. Concepts ......................................................................................................................................................................................29
7.2. Meshlium Models...................................................................................................................................................................... 30
7.3. Storage Options.........................................................................................................................................................................32
7.4. Applications model by model..............................................................................................................................................32
8. Meshlium Presets............................................................................................................................... 43
8.1. Presets........................................................................................................................................................................................... 43
8.2. Validation of Changes in Interfaces....................................................................................................................................45
9. Accessing Meshlium - Make it Easy! ................................................................................................. 46
10. Ethernet............................................................................................................................................ 48
10.1. Conguration........................................................................................................................................................................... 48
11. Wi AP .............................................................................................................................................. 51
11.1. Conguration........................................................................................................................................................................... 51
11.2. Clients connected...................................................................................................................................................................53

-3-
v5.0
Meshlium X
treme
Index
12. Wi Mesh .......................................................................................................................................... 54
12.1. Conguration........................................................................................................................................................................... 54
12.2. OLSR Options...........................................................................................................................................................................55
12.3. The Gateway Node.................................................................................................................................................................57
13. 3G/GPRS ........................................................................................................................................... 58
13.1. Conguration........................................................................................................................................................................... 58
14. Joined Networks.............................................................................................................................. 60
15. Wireless Sensor Networks............................................................................................................... 62
15.1. Conguration........................................................................................................................................................................... 62
15.2. Conguration of the ZigBee interface ............................................................................................................................ 63
15.3. Capturing and storing sensor data ..................................................................................................................................66
15.3.1. Capturing and storing sensor data from XBee / LoRa ................................................................................66
15.3.2. Capturing and storing data from 3G/GPRS, WiFi and Ethernet...............................................................68
15.3.3. Local Data Base.........................................................................................................................................................69
15.3.4. External Data Base...................................................................................................................................................70
15.3.5. Show me now! .........................................................................................................................................................74
15.3.6. Advanced Database................................................................................................................................................75
15.4. Capturer logs............................................................................................................................................................................ 77
15.5. Sensors .......................................................................................................................................................................................78
15.6. OTA via FTP ...............................................................................................................................................................................79
15.7. Sending frames from Meshlium to Waspmote............................................................................................................81
15.8. Key Management on Meshlium ........................................................................................................................................82
15.8.1. Link layer key Management (AES-128).............................................................................................................82
15.8.2. Application Layer Key Management (AES-192/256)...................................................................................83
15.9. AES on Meshlium....................................................................................................................................................................84
16. Cloud Connector.............................................................................................................................. 85
16.1. Introduction .............................................................................................................................................................................85
16.2. Geographic Information Systems (GIS)...........................................................................................................................86
16.2.1. Esri.................................................................................................................................................................................86
16.3. M2M Platform ..........................................................................................................................................................................92
16.3.1. Axeda ...........................................................................................................................................................................92
16.3.2. Thingworx...................................................................................................................................................................96
16.3.3. Telefónica DCA..........................................................................................................................................................97
16.3.4. Microsoft Azure Service Bus ................................................................................................................................98
16.3.5. Sentilo....................................................................................................................................................................... 102
16.4. MQTT Solutions.....................................................................................................................................................................103
16.4.1. Server/Broker Conguration.............................................................................................................................103
16.4.2. MQTT program ...................................................................................................................................................... 104
16.4.3. Platforms using MQTT......................................................................................................................................... 106

-4-
v5.0
Meshlium X
treme
17. Smartphone Detection ................................................................................................................. 107
18. Update! (Version 3.1.4) ................................................................................................................. 110
18.1. Wi Scan...................................................................................................................................................................................113
18.1.1. Concepts..................................................................................................................................................................113
18.1.2. Capturing and Storing Wi Scans ................................................................................................................... 114
18.1.3. Local File System ..................................................................................................................................................115
18.1.4. Local Data Base .....................................................................................................................................................116
18.1.5. External Data Base................................................................................................................................................117
18.2. Bluetooth Scans ....................................................................................................................................................................120
18.2.1. Concepts..................................................................................................................................................................120
18.2.2. Capturing and Storing Bluetooth Scans.......................................................................................................121
18.2.3. Local File System...................................................................................................................................................122
18.2.4. Local Data Base...................................................................................................................................................... 123
18.2.5. External Data Base................................................................................................................................................124
19. GPS.................................................................................................................................................. 127
19.1. Concepts..................................................................................................................................................................................127
19.2. Conguring GPS service.....................................................................................................................................................127
19.3. Capturing and Storing GPS Data.....................................................................................................................................128
19.3.1. Local Data Base...................................................................................................................................................... 128
19.3.2. External Data Base................................................................................................................................................130
19.3.3. Show me now! .......................................................................................................................................................133
20. Networking tools........................................................................................................................... 134
20.1. Ping............................................................................................................................................................................................134
20.2. Iperf ...........................................................................................................................................................................................135
20.3. Traceroute................................................................................................................................................................................136
20.4. Netstat ......................................................................................................................................................................................137
20.5. Beep...........................................................................................................................................................................................137
21. Special options for Wi networks................................................................................................. 138
21.1. Long range links....................................................................................................................................................................138
21.2. Fresnel calculator..................................................................................................................................................................138
22. System ............................................................................................................................................ 139
22.1. Hostname................................................................................................................................................................................139
22.2. Users Manager.......................................................................................................................................................................139
22.3. Setting the time ....................................................................................................................................................................139
22.4. Disk Usage...............................................................................................................................................................................140
22.5. Internal temperature sensors...........................................................................................................................................140
23. Data Base Management................................................................................................................ 141
23.1. MySQL Direct Access...........................................................................................................................................................141
23.2. PHPMyAdmin.........................................................................................................................................................................142
Index

-5-
v5.0
Meshlium X
treme
24. FTP Management .......................................................................................................................... 143
24.1. Creating user..........................................................................................................................................................................143
24.2. Setting permission...............................................................................................................................................................143
24.3. Accessing FTP server ...........................................................................................................................................................144
25. Uploading my own applications to Meshlium ............................................................................ 145
26. Installing new packages and libraries ......................................................................................... 147
27. Upgrading old versions of Meshlium........................................................................................... 148
27.1. Checking the Libelium Repository.................................................................................................................................149
27.2. Local File ..................................................................................................................................................................................149
27.3. URL.............................................................................................................................................................................................150
28. Rescue System ............................................................................................................................... 151
28.1. Steps..........................................................................................................................................................................................151
28.2. How to Recover the le system.......................................................................................................................................152
29. USB Device Connectivity............................................................................................................... 153
30. ManagerSystem Changelog ......................................................................................................... 155
31. Documentation Changelog .......................................................................................................... 158
32. Certications.................................................................................................................................. 160
32.1. CE................................................................................................................................................................................................160
32.2. FCC.............................................................................................................................................................................................162
33. Maintenance .................................................................................................................................. 165
34. Disposal and Recycling ................................................................................................................. 166
Index

-6-
v5.0
General and safety information
Meshlium X
treme
1. General and safety information
• 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 casing. 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 for powering
it and use a power transformer within that 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.
• 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 using a battery whether or not in combination with a solar panel as a power source follow the voltage and current
specications indicated in the section “How to use Meshlium”.
• If a software failure occurs, consult the section Libelium 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 an interface to the software for handling the machine; if the settings of
that interface are incorrectly altered, it could become inaccessible.

-7-
v5.0
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.
Software:
• Do not access Meshlium with the shell terminal unless you have advanced Linux skills. Use the Meshlium Manager web
application in order to congure and setup Meshlium. A bad usage of the shell terminal commands may leave Meshlium
without connection or within a unstable mode. All the failures derived from a wrong usage of the shell terminal are not
covered under the warranty.
• In the case you congured Meshlium through the terminal, there is not a method to take Meshlium to the conguration by
default: the only way to get connection again is sending Meshlium back to Libelium and hiring this service. However, if you
only use the Manager System, you can always go to the default conguration by clicking the “Presets” button.
• Do not interrupt the power supply before shutting down Meshlium properly through the “Shutdown” or “Restart” buttons
in the Manager System or through the ’restart-secure’and ’shutdown-secure’commands from the terminal. If you do
not do so you may take the system corrupted.
• If you need to modify a le or directory, after executing the command ’remountrw’and modifying it, execute immediately
the command ’remountro’.
• In the case of developing an application for Meshlium, store the les in ’/mnt/user’ and not in other directory.
• Regarding packages:
- Do not ever use ’apt-get’; if needed, use ’aptitude’.
- Do not ever make an ’upgrade’ of the entire system (not even using ’aptitude’).
- Before installing new packages with ’aptitude’, execute the ’update’ option.
• The SSH password cannot contain special chars (e.g. $, %, =). The SSH password can only be composed of letters and
numbers. Be careful since Meshlium could be damaged with a not appropriate password.
Hardware:
• Do not open the Meshlium enclosure in any case. This will automatically make the warranty void.
• Do not handle the numbered metallic seals in the screws of Meshlium: their integrity is the proof that the Meshlium
enclosure has not been opened. If they have been handled, opened or broken, the warranty is 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 70 Celsius degrees. The user must ensure that this temperature never
overpass. Especially when using Wi Scan.
• Do not power Meshlium with other power sources than the original provided by Libelium.
For more information: http://www.libelium.com/meshlium

-8-
v5.0
Contents of the box
Meshlium X
treme
3. Contents of the box
1. Meshlium
a. IP65 casing
b. Ethernet connectors
c. Antenna connectors
2. Antennas *
a. Dipole 5dBi
(Bluetooth, ZigBee, Wi 2.4GHz low)
b. Dipole 5dBi (868MHz, 900MHz)
c. Omnidirectional 5dBi
Dual (2.4GHz / 5GHz)
d. 3G/GPRS
e. 3G/GPRS
f. GPS
(*) ewwpends on the conguration you choose when you buy
3. Antennas elbow connectors *
(*) Allow to connect antennas at 90º angle, if needed
4. Fixing
a. Fixing plate
b. 4 washers
c. 2 U-shaped parts
d. 4 screws
e. 4 nuts

-9-
v5.0
Contents of the box
Meshlium X
treme
5. Ethernet cable
6. IP65 Ethernet cap
7. Crossover cable
8. POE
9. Charger
Note: you may receive an empty foam protector in the packaging, depending on the Meshlium conguration that you have purchased.

-10-
v5.0
Specications
Meshlium X
treme
4. Specications
Processor 500MHz (x86)
RAM memory 256MB (DDR)
Disk memory 8GB
Power 5W (18V)
Power Source POE (Power Over Ethernet)
Normal Current Consumption 270mA
High Current Consumption 450mA
Max Supply Current 1’5A
Enclosure
Material Aluminium
Dimensions 210x175x50mm
Weight 1,2Kg
External protection IP65
Temperature Range -20ºC / 50ºC
Response Time to ethernet
ping 60s
Time to have all the services
running 90s
Types of power supply *
for POE
AC-220V
Battery – solar panel (DC-12V)
Car lighter (DC-12V)
System
Linux, Debian. OLSR Mesh communication
protocol.
Madwi Drivers.
Management software
Meshlium Manager System
(open source)
Security Authentication WEP, WPA-PSK, HTTPS and
SSH access.
(*) Only with the accessories supplied by Libelium