Libelium Meshlium Xtreme, MESHLIUM EXTREME Technical Manual
-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. Specications ..................................................................................................................................... 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. Conguration ........................................................................................................................................................................... 48
11. Wi AP .............................................................................................................................................. 51
11.1. Conguration ........................................................................................................................................................................... 51
11.2. Clients connected ...................................................................................................................................................................53
-3-
v5.0
Meshlium
X
treme
Index
12. Wi Mesh .......................................................................................................................................... 54
12.1. Conguration ........................................................................................................................................................................... 54
12.2. OLSR Options ........................................................................................................................................................................... 55
12.3. The Gateway Node .................................................................................................................................................................57
13. 3G/GPRS ........................................................................................................................................... 58
13.1. Conguration ........................................................................................................................................................................... 58
14. Joined Networks .............................................................................................................................. 60
15. Wireless Sensor Networks ............................................................................................................... 62
15.1. Conguration ........................................................................................................................................................................... 62
15.2. Conguration 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 Conguration .............................................................................................................................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. Conguring 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. Certications .................................................................................................................................. 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 specied 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 specications 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 specications 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
specications 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 congure 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 congured Meshlium through the terminal, there is not a method to take Meshlium to the conguration 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 conguration 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 conguration 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 conguration that you have purchased.
-10-
v5.0
Specications
Meshlium
X
treme
4. Specications
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
-11-
v5.0
Specications
Meshlium
X
treme
Wi AP - 2.4GHz Radio
WIFI RADIO
Chipset Atheros AR5213A - IEEE 802.11b/g
Tx-Power 100mW - 20 dBm
Distance 500m
*
(*) Depending on antenna and line of sight
ANTENNA
Type Omni-directional
Gain 5dBi
Dimensions 224 x 22 mm
Wi Mesh Dual Band 2.4 GHz / 5GHz Radio
WIFI RADIO
Chipset Atheros AR5213A - IEEE 802.11a/b/g
Tx-Power
20dB - 802.11b/g / 18dB - 802.11a
Distance 2-50km
*
(*) Depending on antenna and line of sight
ANTENNA
Type Omni-directional
Gain 5dBi - 2.4GHz / 8dBi - 5GHz
Dimensions 224 x 22 mm
-12-
v5.0
Specications
Meshlium
X
treme
RF Module Radio (Xbee or LoRa)
Model XBee - PRO - 802.15.4
Frequency 2.4GHz
Tx-Power 100mW
Rx Sensitivity -100dBm
Antenna 5dBi Dipole
Distance 7km
*
Model XBee - PRO - ZigBee
Frequency 2,4GHz
Tx-Power
50mW
Rx Sensitivity -102dBm
Antenna
5dBi Dipole
Distance
7km
*
Model XBee - PRO - 868
Frequency
868MHz
Tx-Power 315mW
Rx Sensitivity -112dBm
Antenna
5dBi Dipole
Distance 12km
*
Model XBee - PRO - 900
Frequency 900MHz
Tx-Power 50mW
Rx Sensitivity -100dBm
Antenna 5dBi Dipole
Distance 10km
*
Model Semtech SX1272
Frequency 868 and 915 MHz
Tx-Power 14 dBm
Rx Sensitivity -137 dBm
Antenna 4.5 dBi dipole
Distance 21+ km
*
(*) Depending on antenna and line of sight
-13-
v5.0
Specications
Meshlium
X
treme
RF Module Radio (Xbee or LoRa) (continuation)
Model XBee - PRO - Digimesh
Frequency 2.4GHz
Tx-Power 100mW
Rx Sensitivity -100dBm
Antenna 5dBi Dipole
Distance 7km
*
(*) Depending on antenna and line of sight
Wi Scanner
Chipset Atheros AR5213A - IEEE 802.11b/g
Distance 50-200m
*
Antenna 5dBi Dipole
(*) Depending on antenna and line of sight
Bluetooth Scanner
Protocol Bluetooth 2.1 + EDR. Class 2
Tx-Power 3dBm
Antenna 5dBi
Power 3dBm
Distance 20-30m
*
(*) Depending on antenna and line of sight
-14-
v5.0
Specications
Meshlium
X
treme
3G/GPRS Module
Protocols 3G * , WCDMA, HSPA, UMTS, GPRS, GSM
Tri Band
900MHz/1900MHz/2100MHZ or
850MHz/1900MHz/2100MHZ
Output power
UMTS 850/900/1900/2100: 0.25W
GSM850/GSM900: 2W
DCS1800/PCS1900: 1W
Rx Rate 7.2Mb/s
Tx Rate 5.5Mb/s
Antenna 3dBi
SIM card Access via the External SIM socket
(*) Note for US users: We tested the 3G shield with the AT&T network which supports natively the GSM and 3G protocols. With other
carriers may also work although we haven’t tried and thus we can not ensure it. For this reason we recommend to use AT&T SIM
cards.
GPS Module
Modes
Assisted GPS (A-GPS),
Standalone mode (NMEA frames)
Server
Server enabled to perform even indoor
location ins A-GPS and S-GPS modes
Antenna 26dBi (+-4.5dBi) - 3m cable. Magnetic
-15-
v5.0
Accessories
Meshlium
X
treme
5. Accessories
Meshlium accessories are not included in the box.
1. 220AC Adapter - car lighter/battery (12V – 300W)
a. Car lighter adapter (on demand)
b. Battery clamps
*
c. 12 VDC - 220 VAC converter
Average power 300 W
Maximum power 600 W
Input voltage 12 VDC
Output voltage 220 VAC
Dimensions 205x165x67 mm
Weight 1 Kg
d. 12 VDC Battery
*
(*) Libelium does not supply these components;
you can purchase it from battery sales points
-16-
v5.0
Accessories
Meshlium
X
treme
2. Solar connection kit (12V – 20W):
a. Solar panel
Power 20 W
Maximum voltage 17 V
Maximum current 1.15 A
Dimensions 480x430x30 mm
Weight 2.50 Kg
b. 12 VDC - 220 VAC converter
Average power 300 W
Maximum power 600 W
Input voltage 12 VDC
Output voltage 220 VAC
Dimensions 205x165x67 mm
Weight 1 Kg
c. 12 VDC Battery
*
d. Charge regulator
Charge voltage range 11.10V - 21.20V
Maximum input current 5A
Dimensions 130x70x25 mm
Weight 200 g
e. Car lighter adapter (on demand)
f. Battery clamps
*
(*) Libelium does not supply these components;
you can purchase it from battery sales points
-17-
v5.0
How to use Meshlium
Meshlium
X
treme
6. How to use Meshlium
6.1. Power supply
How to connect Meshlium to 220V:
1. Take the Meshlium casing and unscrew the Ethernet connector cap shown in the drawing.
2. Join the end that has the IP65 protection of the IP65 Ethernet cable to said connector and screw the cap on to x it.
3. Connect the other end of the cable to the POE input marked “POE”. As explained in the section “Before using Meshlium”
make sure that the POE is indoors.
4. Take the supplied POE power adapter and plug it into the corresponding POE connector.
5. Plug the other end of the adapter into the 220V socket and your Meshlium is now ready to operate.
In addition to this option, you can power Meshlium through a solar panel and battery or through a car lighter socket. The
accessories for these options are NOT included in the box, and the necessary components must be purchased from Libelium.
Except for the battery it is not recommended to use third party components since they have not been tested by Libelium and
could cause failures in the device.
At Libelium we oer an equipment for operating at 12V. It is very important to bear in mind that not all batteries supply the
same voltage. You must use a 12V battery .
Note: Take special care to ensure that the battery you connect has the same power rating as the kit that you have purchased.
-18-
v5.0
How to use Meshlium
Meshlium
X
treme
How to connect Meshlium for powering through the battery:
Additional required components: 12V battery, with exposed terminals for placing the clamps.
1. Connect the end with the IP65 protection of the Ethernet cable to the Meshlium connector that does not have the cap.
2. Connect the end of the Ethernet cable to the POE input marked “POE”. As explained in the section “Before using Meshlium”
make sure that the POE is indoors.
3a. Plug the POE charger into the Inverter output (AC output).
3b. Connect the POE charger cable into the POE.
4. Connect the ends of the cables which come from the Inverter to the battery. To do so, it is advised to use battery clamps.
In this case the cables of the Inverter must be spliced to the cables of the clamps, and they are the clamps the part that is
connected to the terminals of the 12 VDC battery.
Important: Check polarity at all times before making the connections. It is advised to avoid the possibility of contact with the
positive and negative polo at any time. There is lethal shock hazard and the devices can also be damaged.
-19-
v5.0
How to use Meshlium
Meshlium
X
treme
How to connect Meshlium for solar panel and battery powering:
Additional required components: solar panel / 12V-220V and 12V battery, with exposed terminals for placing the clamps.
Important: Check polarity to make sure that the positive (+) and negative (-) poles are connected to the right socket.
1. Connect the end with the IP65 protection of the Ethernet cable to the Meshlium connector that does not have the cap.
2. Connect the end of the Ethernet cable to the POE input marked “POE”. As explained in the section “Before using Meshlium”
make sure that the POE is indoors.
3a. Plug the POE charger into the Inverter output (AC output).
3b. Connect the POE charger cable into the POE.
Important: Check polarity at all times before making the connections. It is advised to avoid the possibility of contact with the
positive and negative polo at any time. There is lethal shock hazard and the devices can also be damaged.
4. Connect a cable to each battery terminal and screw the other end into the socket of the Charge Regulator marked as
“battery”. Take polarity (+) / (-) into consideration.
5. Connect the solar panel cables into the socket of the Charge Regulator marked as “solar”. Take polarity (+) / (-) into
consideration.
6. Connect the ends of the cables which come from the Inverter to the battery. To do so, it is advised to use battery clamps.
In this case the cables of the Inverter must be spliced to the cables of the clamps, and they are the clamps the part that is
connected to the terminals of the 12 VDC battery.
-20-
v5.0
How to use Meshlium
Meshlium
X
treme
How to connect Meshlium for powering through a car lighter:
In this case, you must purchase the required components from Libelium. We do not advise using third party components as they
have not been tested by Libelium and could cause failures in the device or the car.
Important: Bear in mind that not all car lighters supply the same voltage. The Inverter oered by Libelium works at 12 V DC input
voltage. Although it must be checked in each case, cars normally have 12 V as output of the lighter.
1. Connect the end with the IP65 protection of the IP65 Ethernet cable to the Meshlium connector without the cap.
2. Connect the other end of the cable to the POE input marked “POE”. As explained in the section “Before using Meshlium”
make sure that the POE is indoors.
3a. Plug the POE charger into the Inverter output (AC output). You can also connect it to a multi-socket adapter, as the image
shows.
3b. Connect the POE charger cable into the POE.
4. In the case of using a multi-socket adapter, connect the end of its cable to the Inverter.
5. Plug the end of the cable which comes out from the Inverter to the lighter socket of a car.
-21-
v5.0
How to use Meshlium
Meshlium
X
treme
How to connect Meshlium in order to get access by the Ethernet interface:
1. Connect the network crossover cable (it has an identifying label) included in the box to the POE input marked “LAN” and to the
network socket of your PC as shown in the drawing. The procedure is the same for any of the selected power supply options.
(*) See the “Accessing Meshlium” section in order to see how to get access wirelessly.
You can also carry out this connection through a switch (not supplied with Meshlium):
1. Connect the Ethernet cable (not the crossover) to the POE input marked “LAN” and to one of the switch inputs.
2. Connect another Ethernet cable to another one of the switch inputs and the opposite end to the network socket of your PC.
3. Plug the switch into the network.
(*) See the “Accessing Meshlium” section in order to see how to get access wirelessly.
-22-
v5.0
How to use Meshlium
Meshlium
X
treme
6.2. External SIM socket
The External SIM socket replaces the USB socket in two devices:
• Meshlium devices with 3G/GPRS module
• Waspmote Plug & Sense! devices with GPRS, GPRS+GPS or 3G+GPS module
The External SIM socket is composed of 2 connectors:
• micro-SIM card
• micro-USB (type B)
Figure : External SIM socket in a Meshlium with 3G/GPRS module
The micro-SIM card connector allows the user to connect the SIM card he likes from the outside. It is no longer necessary
to send a SIM card to Libelium for proper installation. You can ask your telecommunication provider for a microSIM card. Alternatively you can take a normal SIM card and transform it into a micro-SIM card with a SIM card cutter.
Besides, the micro-SIM card connector has a push-pull mechanism, so it is really easy to remove the card with the aid of one nail.
Figure : Push-pull mechanism in the External SIM socket
-23-
v5.0
How to use Meshlium
Meshlium
X
treme
It is highly important to turn o Meshlium device in a secure way before inserting a micro-SIM card, or removing an existing
SIM-card. The user can damage the device if this operation is done “on-the-y”.
Make sure you closed the External SIM socket with its protection cap before outdoors deployment.
The operation with the micro-USB socket is just the same than with the normal USB socket (please read the Rescue System
section). Just remember to use a micro-USB cable.
Take into account that the External SIM socket has a limited resistance so please be gentle and do not push too hard.
Figure : Inserting a SIM card with care in the External SIM socket
6.3. How to install the antennas
Check the labels next to the antennas to know which is the one that needs to be connected (refer to page 7 to know which
technology corresponds to each antenna). If the antenna is of the GPS, 3G/GPRS, Wi or Dipole 5dBi (868MHz, 900MHz) type,
the corresponding adapter will have to be installed as indicated in gure “a“. All the antennas are screwed into place. To install
the Meshlium antennas place them in the corresponding connectors as shown in the drawing.
-24-
v5.0
How to use Meshlium
Meshlium
X
treme
6.4. Installation of the IP65 Ethernet cable
Fitting of the IP65 cap:
In order to t the IP65 cap you will need a connector-free RJ45 cable. This cable is NOT included in the Meshlium box.
Important: Make sure that you buy a suciently long cable to connect Meshlium from its position to the POE situated indoors.
1. Take from the Meshlium box the bag containing the parts for xing the IP cap. Check that you have all the parts that appear
in the picture.
c
b
d
Joints
Adhesive joints
a
2 . Stick one of the supplied adhesive joints to part C.
3. Slot the joints into part B as shown in the drawing.
-25-
v5.0
How to use Meshlium
Meshlium
X
treme
4. Insert part C into part D.
5. Screw both sets of parts in the direction shown in the diagram.
6. Screw part D to the end.
7. Pass the cable through the tted cap.
8. Crimp the RJ45 connectors at the ends of the cable (the crimping tool is not supplied with Meshlium).
Your IP65 Ethernet cable is now ready for use.
-26-
v5.0
How to use Meshlium
Meshlium
X
treme
How to connect the IP65 Ethernet cable to Meshlium:
1. Take the adhesive joint that has not been used for tting the cap and stick it to the Meshlium bare Ethernet connector.
2. Connect the end of the Ethernet cable to the Meshlium Ethernet socket.
3. Screw part C onto the Meshlium connector. Your Meshlium is now ready for using outdoors.
-27-
v5.0
How to use Meshlium
Meshlium
X
treme
6.5. Installing Meshlium
Meshlium has been designed to operate in a vertical position. You will nd the required xtures for this in the box. The image
shows the steps to follow to secure Meshlium to a vertical post.
1. Place the U-shaped piece tted against the post.
2. Slot the xing plate into the U-shaped piece leaving the post
between the two parts. Secure both parts by turning the nuts
included in the U-piece. Repeat these steps with the second
U-piece.
3. Place Meshlium so that the casing holes coincide with the xing
plate and x Meshlium to the post by turning the screws into these
holes.
As specied in the section “General and Safety Information” the device
must be installed by trained personnel only in an area of restricted
access.
6.6. Initialization, Restart and Shutdown
In order to allow Meshlium to close correctly all the daemons and applications it is important to use the buttons “Restart” and
“Shutdown” placed in the upper right corner in the Manager System. This way you will keep maximum the performance and
lifetime of the system.
If you are connected to Meshlium through a SSH connection you must use the following scripts:
/bin/restart-secure
/bin/shutdown-secure
They can be executed from the terminal directly:
$ restart-secure
$ shutdown-secure
-28-
v5.0
How to use Meshlium
Meshlium
X
treme
Beep! System
Meshlium includes an internal speaker which will emit “beep!” sounds when initializing, rebooting and shutting down in order
to inform about the state of the process.
Initialization beeps:
• 1 short beep when Meshlium is powered
• 1 long beep when Meshlium starts launching the operate system
• 2 long beeps when Meshlium has nished starting and it is ready to be used
Reboot beeps:
• long beep when the reboot order is executed.
• Initialization beeps when Meshlium starts again.
• Do not remove the power cable during this process is carried out.
Shutting down beeps:
• This process could take up to one minute.
• 2 long beeps when Meshlium is about to shutdown. A few seconds after the beeps, Meshlium can be unplugged.
• Do not remove the power cable until this process is totally completed.
Note: The “beep!” sound is not really loud so you will have to take attention and be close to the Meshlium box in order to hear them
clearly.
Note 2: If Meshlium is unplugged before the acoustic signal of shutdown, internal memory could be damaged. Be sure to wait for
several minutes if you are not sure the beeps sounded.
Note 3: The duration of the reboot or shut-down processes may vary. Make sure you heard the corresponing beeps and be patient.
Note 4: If the user does not follow these instructions, the risk is very high. Meshlium will become unresponsive and unaccessible. This
problem is out of the warranty scope, because it is produced by bad use. The only possible solution will be a repair process in Libelium’s
facilities, paid by the user.
6.7. Setting the time
In order to get all the data stored in the Meshlium Local Data Base with the right timestamp you must adjust the System time.
To do so go to the “Setting the Time” section inside the “System” chapter in the current manual.
-29-
v5.0
Understanding Meshlium
Meshlium
X
treme
7. Understanding Meshlium
7.1. Concepts
Meshlium is a Linux router which can contain 6 dierent radio interfaces: Wi 2.4GHz, Wi 5GHz, 3G/GPRS, Bluetooth and RF
communications. RF communications may be implemented by one XBee module or one LoRa module. As well as this Meshlium
can also integrate a GPS module for mobile and vehicular applications and be solar and battery powered. These features along
with an aluminium IP65 enclosure allows Meshlium to be placed anywhere outdoor.
Meshlium can work as:
• an RF (XBee/LoRa) to Ethernet router for Waspmote nodes
*
• an RF (XBee/LoRa) to 3G/GPRS router for Waspmote nodes
*
• a Wi Access Point
• a Wi Mesh node (dual band 2.4GHz-5GHz)
• a Wi to 3G/GPRS router
• a Bluetooth scanner and analyzer
• a GPS-3G/GPRS real-time tracker
• a Smartphone scanner (detects iPhone and Android devices)
(* ) More info about Waspmote at: http://www.libelium.com/waspmote
All the networking options can be controlled from two dierent sources:
1. Manager System: a web interface which comes with Meshlium. It allows you to control all the interfaces and system
options in a secure, easy and quick way.
2. SSH console: for expert users direct access to the shell console is enabled.
Meshlium is also a complete Linux station which oers dierent services, programming environments and storage systems:
Services activated:
• HTTP / HTTPS
• SSH
Examples of programming environments to be installed:
• C (by default)
• C++
• Java
• PHP (by default)
• Python
• Perl
• Ruby
Regarding the information storage Meshlium counts with two dierent data base systems.
• MySQL (by default)
• Postgre
-30-
v5.0
Understanding Meshlium
Meshlium
X
treme
All the information coming from all the interfaces (RF module [XBee/LoRa], Bluetooth, 3G/GPRS, Wi and from the GPS module)
can be stored in the Local File System and/or the Local Data Base as explained in the “Storage Options” section or even exported
to an external Data Base connected to the Internet.
Also, when Meshlium is the central node in a Wireless Sensor Network, it can perform the OTA feature (over the air programming).
That is to say, Meshlium can send to some (or all) Waspmotes in the network a new program via wireless. This feature is
available for Meshliums with all XBee radios (802.15.4, DigiMesh, 868 MHz and 900 MHz) with the exception of Meshliums with
ZigBee radio. Also, OTA can be performed with Waspmotes with GPRS, 3G or WiFi. For more information, please read the OTA
Programming Guide.
7.2. Meshlium Models
There are dierent Meshlium models (“Presets”) depending on the radios integrated and on the fact if they act as a Gateway
(GW) node or not.
Models
Wi AP
(2.4GHz)
Wi Mesh
(2.4GHz /5GHz)
3G/GPRS
RF Module
(XBee/LoRa)
Ethernet GW
Meshlium AP
P P P
Meshlium 3G/GPRS-AP
P P P P
Meshlium Mesh-AP
P P P
Meshlium Mesh-AP-GW
P P P P
Meshlium Mesh-3G/GPRS-AP
P P P P P
Meshlium RF-AP
P P P P
Meshlium RF-3G/GPRS-AP
P P P P P
Meshlium RF-Mesh-AP
P P P P
Meshlium RF-Mesh-AP-GW
P P P P P
Meshlium RF-Mesh-3G/GPRS-AP
P P P P P P
Meshlium Scanner AP
P P P
Meshlium Scanner 3G-/GPRS-AP
P P P P
Meshlium Scanner RF-AP
P P P P
All the congurations will act as GW nodes except the nodes congured to act as simple mesh nodes (Mesh-AP and XBeeMesh-AP) which need one GW node in the mesh network which shares its Internet connection. However, all the nodes can be
changed to act as GW nodes with just one click through the Presets section. LoRa models do not have Mesh capabilities.
All the Meshlium models come with Ethernet (IPv4 and IPv6) interfaces.
Loading...