Libelium Meshlium Xtreme Quick start guide

-2-
v4.1
Meshlium X
treme
Index
Document version: v4.1 - 04/2013
© 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. How to install the antennas ..................................................................................................................................................22
6.3. Installation of the IP65 Ethernet cable ..............................................................................................................................23
6.4. Installing Meshlium..................................................................................................................................................................26
6.5. Initialization, Restart and Shutdown..................................................................................................................................26
6.6. Setting the time.........................................................................................................................................................................27
7. Understanding Meshlium ................................................................................................................. 28
7.1. Concepts ......................................................................................................................................................................................28
7.2. Meshlium Models...................................................................................................................................................................... 29
7.3. Storage Options.........................................................................................................................................................................31
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-
v4.1
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 ..................................................................................................................................65
15.3.1. Local Data Base.........................................................................................................................................................67
15.3.2. External Data Base...................................................................................................................................................68
15.3.3. Show me now! .........................................................................................................................................................72
15.3.4. Advanced Database................................................................................................................................................73
15.4. Capturer logs............................................................................................................................................................................ 75
15.5. Sensors .......................................................................................................................................................................................76
15.6. Capturing and Storing photos and videos....................................................................................................................77
15.7. Sending ZigBee frames from Meshlium to Waspmote .............................................................................................78
15.8. Key Management on Meshlium ........................................................................................................................................79
15.8.1. Link layer key Management (AES-128).............................................................................................................79
15.8.2. Application Layer Key Management (AES-256 / RSA).................................................................................80
15.9. Encryption on Meshlium......................................................................................................................................................84
15.9.1. Message digest.........................................................................................................................................................84
15.10. RSA on Meshlium .................................................................................................................................................................85
15.11. AES on Meshlium ................................................................................................................................................................. 85
15.12. Sending messages...............................................................................................................................................................85
15.13. Decrypting messages......................................................................................................................................................... 86
15.14. Encryption on Meshlium.................................................................................................................................................. 86
15.14.1. Message digest ......................................................................................................................................................86
15.14.2. RSA on Meshlium ..................................................................................................................................................86
15.14.3. AES on Meshlium...................................................................................................................................................87
15.14.4. Sending messages ................................................................................................................................................87
15.14.5. Decrypting messages ..........................................................................................................................................87
16. Smartphone Detection ................................................................................................................... 88
16.1. Wi Scan.....................................................................................................................................................................................92
16.1.1. Concepts.....................................................................................................................................................................92
16.1.2. Capturing and Storing Wi Scans ......................................................................................................................93
16.1.3. Local File System .....................................................................................................................................................94
16.1.4. Local Data Base ........................................................................................................................................................95
16.1.5. External Data Base...................................................................................................................................................96

-4-
v4.1
Meshlium X
treme
16.1.6. Show me now! ..........................................................................................................................................................99
16.2. Bluetooth Scans ....................................................................................................................................................................100
16.2.1. Concepts..................................................................................................................................................................100
16.2.2. Capturing and Storing Bluetooth Scans.......................................................................................................101
16.2.3. Local File System...................................................................................................................................................102
16.2.4. Local Data Base...................................................................................................................................................... 103
16.2.5. External Data Base................................................................................................................................................104
16.2.6. Show me now! .......................................................................................................................................................108
17. GPS.................................................................................................................................................. 109
17.1. Concepts..................................................................................................................................................................................109
17.2. Capturing and Storing GPS Data.....................................................................................................................................111
17.2.1. Local File System...................................................................................................................................................111
17.2.2. Local Data Base...................................................................................................................................................... 112
17.2.3. External Data Base................................................................................................................................................114
17.2.4. Show me now! .......................................................................................................................................................117
18. Networking tools........................................................................................................................... 118
18.1. Ping............................................................................................................................................................................................118
18.2. Iperf ...........................................................................................................................................................................................120
18.3. Traceroute................................................................................................................................................................................121
18.4. Netstat ......................................................................................................................................................................................122
18.5. Beep...........................................................................................................................................................................................122
19. Special options for Wi networks................................................................................................. 123
19.1. Long range links....................................................................................................................................................................123
19.2. Fresnel calculator..................................................................................................................................................................123
20. System ............................................................................................................................................ 124
20.1. Hostname................................................................................................................................................................................124
20.2. Users Manager.......................................................................................................................................................................124
20.3. Setting the time ....................................................................................................................................................................125
20.4. Disk Usage...............................................................................................................................................................................125
20.5. Internal temperature sensors...........................................................................................................................................126
21. Data Base Management................................................................................................................ 127
21.1. MySQL Direct Access...........................................................................................................................................................127
21.2. PHPMyAdmin.........................................................................................................................................................................128
22. FTP Management .......................................................................................................................... 129
22.1. Creating user..........................................................................................................................................................................129
22.2. Setting permission...............................................................................................................................................................129
22.3. Accessing FTP server ...........................................................................................................................................................130
23. Uploading my own applications to Meshlium ............................................................................ 131
Index

-5-
v4.1
Meshlium X
treme
24. Installing new packages and libraries ......................................................................................... 133
25. Upgrading old versions of Meshlium........................................................................................... 134
25.1. Checking the Libelium Repository.................................................................................................................................135
25.2. Local File ..................................................................................................................................................................................136
25.3. URL.............................................................................................................................................................................................137
26. Rescue System ............................................................................................................................... 138
26.1. Steps..........................................................................................................................................................................................138
26.2. How to Recover the le system.......................................................................................................................................140
27. USB Device Connectivity............................................................................................................... 141
28. Documentation Changelog .......................................................................................................... 143
29. Certications.................................................................................................................................. 144
29.1. CE................................................................................................................................................................................................144
29.2. FCC.............................................................................................................................................................................................146
30. Maintenance .................................................................................................................................. 149
31. Disposal and Recycling ................................................................................................................. 150
Index

-6-
v4.1
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-
v4.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.
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.
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-
v4.1
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
(*) Depends on the conguration you choose when you buy
3. Antennas elbow connectors *
(*) Depends on the conguration chosen
4. Fixing
a. Fixing plate
b. 4 washers
c. 2 U-shaped parts
d. 4 screws
e. 4 nuts

-9-
v4.1
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-
v4.1
Specications
Meshlium X
treme
4. Specications
Processor 500MHz (x86)
RAM memory 256MB (DDR)
Disk memory 8GB / 16GB / 32GB *
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.
(*) Depends on the options chosen
(**) Only with the accessories supplied by Libelium