Page 2: Table Of Contents
Meshlium 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. Specifications ............................. 10 5.
Page 3 Meshlium treme Index 12. Wifi Mesh ............................54 12.1. Configuration ................................... 54 12.2. OLSR Options ................................... 55 12.3. The Gateway Node ................................. 57 13. 3G/GPRS ............................58 13.1. Configuration ................................... 58 14. Joined Networks ..........................60 15. Wireless Sensor Networks ....................... 62 15.1.
Page 4 Meshlium treme Index 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.
Page 5 Meshlium treme Index 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.
Page 6: General And Safety Information
As specified in the Warranty document which you can find 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.
Page 7: Important: Read Me Before Using
In the case you configured Meshlium through the terminal, there is not a method to take Meshlium to the configuration 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 configuration by clicking the “Presets”...
Page 8: Contents Of The Box
Meshlium treme Contents of the box 3. Contents of the box 1. Meshlium a. IP65 casing b. Ethernet connectors c. Antenna connectors 2. Antennas a. Dipole 5dBi (Bluetooth, ZigBee, Wifi 2.4GHz low) b. Dipole 5dBi (868MHz, 900MHz) c. Omnidirectional 5dBi Dual (2.4GHz / 5GHz) d.
Page 9 Meshlium treme Contents of the box 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 configuration that you have purchased. v4.1...
Page 10: Specifications
Linux, Debian. OLSR Mesh communication protocol. System Madwifi Drivers. Meshlium Manager System Management software (open source) Authentication WEP, WPA-PSK, HTTPS and Security SSH access. (*) Depends on the options chosen (**) Only with the accessories supplied by Libelium -10- v4.1...
Page 11 Meshlium treme Specifications Wifi 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 Omnidirectional Gain 5dBi Dimensions 224 x 22 mm Wifi Mesh Dual Band 2.4 GHz / 5GHz Radio WIFI RADIO Chipset...
Page 12 Meshlium treme Specifications Zigbee Radio Model XBee - PRO - 802.15.4 Frequency 2.4GHz Tx-Power 100mW Rx Sensitivity -100dBm Antenna 5dBi Dipole Distance Model XBee - PRO - ZigBee Frequency 2,4GHz Tx-Power 50mW Rx Sensitivity -102dBm Antenna 5dBi Dipole Distance Model XBee - PRO - 868 Frequency 868MHz...
Page 13 Meshlium treme Specifications Zigbee Radio (continuation) Model XBee - PRO - Digimesh Frequency 2.4GHz Tx-Power 100mW Rx Sensitivity -100dBm Antenna 5dBi Dipole Distance (*) Depending on antenna and line of sight Wifi Scanner Chipset Atheros AR5213A - IEEE 802.11b/g Distance 50-200m Antenna 5dBi Dipole...
Page 14 Meshlium treme Specifications 3G/GPRS Module Protocols , WCDMA, HSPA, UMTS, GPRS, GSM Quad Band 850MHz/900MHz/1900MHz/2100MHz UMTS 850/900/1900/2100: 0.25W Output power GSM850/GSM900: 2W DCS1800/PCS1900: 1W Rx Rate 7.2Mb/s Tx Rate 5.5Mb/s Antenna 3dBi (*) Note for US users: We have tested the new 3G shield with the AT&T network which supports nativelly the GSM and 3G proto- colos.
Page 15: Accessories
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 -15- v4.1...
Page 16 Charge voltage range 11.10V - 21.20V Maximum input current Dimensions 130x70x25 mm Weight 200 g e. Car lighter adaptor (on demand) Battery clamps (*) Libelium does not supply these components; you can purchase it from battery sales points -16- v4.1...
Page 17: How To Use Meshlium
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 offer 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 .
Page 18 Meshlium treme How to use Meshlium How to connect Meshlium for powering through the battery: Additional required components: 12V battery, with exposed terminals for placing the clamps. Connect the end with the IP65 protection of the Ethernet cable to the Meshlium connector that does not have the cap. Connect the end of the Ethernet cable to the POE input marked “POE”.
Page 19 Meshlium treme How to use Meshlium 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. Connect the end with the IP65 protection of the Ethernet cable to the Meshlium connector that does not have the cap.
Page 20 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 offered by Libelium works at 12 V DC input voltage.
Page 21 Meshlium treme How to use Meshlium How to connect Meshlium in order to get access by the Ethernet interface: 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.
Page 22: How To Install The Antennas
Meshlium treme How to use Meshlium 6.2. 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, Wifi or Dipole 5dBi (868MHz, 900MHz) type, the corresponding adaptor will have to be installed as indicated in figure “a“.
Page 23: Installation Of The Ip65 Ethernet Cable
Meshlium treme How to use Meshlium 6.3. Installation of the IP65 Ethernet cable Fitting of the IP65 cap: In order to fit 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 sufficiently long cable to connect Meshlium from its position to the POE situated indoors.
Page 24 Meshlium treme How to use Meshlium Insert part C into part D. Screw both sets of parts in the direction shown in the diagram. Screw part D to the end. Pass the cable through the fitted cap. 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.
Page 25 Meshlium treme How to use Meshlium How to connect the IP65 Ethernet cable to Meshlium: Take the adhesive joint that has not been used for fitting the cap and stick it to the Meshlium bare Ethernet connector. Connect the end of the Ethernet cable to the Meshlium Ethernet socket. Screw part C onto the Meshlium connector.
Page 26: Installing Meshlium
Meshlium treme How to use Meshlium 6.4. Installing Meshlium Meshlium has been designed to operate in a vertical position. You will find the required fixtures for this in the box. The image shows the steps to follow to secure Meshlium to a vertical post. Place the U-shaped piece fitted against the post.
Page 27: Setting The Time
Meshlium treme How to use Meshlium 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 •...
Page 28: Understanding Meshlium
• 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 different 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.
Page 29: Meshlium Models
Meshlium treme Understanding Meshlium 7.2. Meshlium Models There are 13 Meshlium models (“Presets”) depending on the radios integrated and on the fact if they act as a Gateway (GW) node or not. Wifi AP Wifi Mesh Models 3G/GPRS ZigBee Ethernet (2.4GHz) (2.4GHz /5GHz) Meshlium AP...
Page 30 Meshlium treme Understanding Meshlium On some of them two extra modules can be installed: Bluetooth and GPS. 8GB / 16GB / 32 GB Wifi Models Bluetooth Scans Scans Storage options Meshlium AP Meshlium 3G/GPRS-AP Optional Meshlium Mesh-AP Meshlium Mesh-AP-GW Optional Meshlium Mesh-3G/GPRS-AP Meshlium ZigBee-AP Optional...
Page 31: Storage Options
Meshlium treme Understanding Meshlium 7.3. Storage Options There are three different Hard disk sizes for Meshlium: • • 16GB • 32GB The Operate System and the Manager takes ~2.5GB. This means the space which can be used to store the data captured and to be used by the applications loaded by the user is: •...
Page 32: Applications Model By Model
Meshlium treme Understanding Meshlium 7.4. Applications model by model Meshlium AP Clients can connect to Meshlium via Wifi with laptops and smart phones and get access to the Internet. In order to give Internet access Meshlium uses the Ethernet connection. Just connect it to your hub or switch and it will get automatically an IP from your network using DHCP.
Page 33 Meshlium treme Understanding Meshlium Meshlium 3G/GPRS AP Clients can connect to Meshlium via Wifi with laptops and smart phones and get access to the Internet. In order to give Internet access Meshlium uses the 3G/GPRS connection. -33- v4.1...
Page 34 Meshlium treme Understanding Meshlium Meshlium Mesh AP - Meshlium Mesh AP GW Meshlium can work as a Mesh node. This means we can interconnect several Meshliums in order to share a common resource as the Internet connection. This way, the clients connected to a certain node can access to the Internet connection of a third node which is some hops far away the actual connecting point.
Page 35 Meshlium treme Understanding Meshlium Meshlium Mesh AP - Meshlium Mesh 3G/GPRS AP: Meshlium can work as a Mesh node. This means we can interconnect several Meshliums in order to share a common resource as an Internet connection. This way, the clients connected to a certain node can access to the Internet connection of a third node which is some hops far away the actual connecting point.
Page 36 Meshlium can take the sensor data which comes from a ZigBee Wireless Sensor Network (WSN) made with Waspmote sensor devices and send it to the Internet using the Ethernet interface. Users can also connect directly to Meshlium using the Wifi interface to control it and access to the sensor data. (*) http://www.libelium.com/waspmote -36- v4.1...
Page 37 Meshlium can take the sensor data which comes from a Wireless Sensor Network (WSN) made with Waspmote sensor devices and send it to the Internet using the 3G/GPRS interface. Users can also connect directly to Meshlium using the Wifi interface to control it and access to the sensor data. (*) http://www.libelium.com/waspmote -37- v4.1...
Page 38 Meshlium treme Understanding Meshlium Meshlium ZigBee Mesh AP - Meshlium ZigBee Mesh AP GW: Meshlium can work as a ZigBee Mesh node. This means we can interconnect several nodes in order to share a common resource as an Internet connection. This way, the sensor nodes connected to a node via ZigBee can send the information to the Internet link set on a third node which is some hops far away the actual point.
Page 39 Meshlium treme Understanding Meshlium Meshlium ZigBee Mesh AP - Meshlium ZigBee Mesh 3G/GPRS AP Meshlium can work as a ZigBee Mesh node. This means we can interconnect several nodes in order to share a common resource as an Internet connection. This way, the sensor nodes connected to a node via ZigBee can send the information to the Internet link set on a third node which is some hops far away the actual point.
Page 40 Meshlium treme Understanding Meshlium Meshlium Scanner AP It allows to detect Smartphones (iPhone, Android) and in general any device which works with Wifi or Bluetooth interfaces. The collected data can be send to the Internet by using the Ethernet. Clients can also connect to Meshlium via Wifi with laptops and smart phones and get access to the Internet (as a common Access Point).
Page 41 Meshlium treme Understanding Meshlium Meshlium Scanner 3G-AP It allows to detect Smartphones (iPhone, Android) and in general any device which works with Wifi or Bluetooth interfaces. The collected data can be send to the Internet by using the Ethernet, and 3G/GPRS connectivity. Clients can also connect to Meshlium via Wifi with laptops and smart phones and get access to the Internet (as a common Access Point).
Page 42 Meshlium treme Understanding Meshlium Meshlium Scanner ZigBee-AP It allows to detect Smartphones (iPhone, Android) and in general any device which works with Wifi or Bluetooth interfaces. It can also capture the sensor data which comes from the Wireless Sensor Network (WSN) made with Waspmote sensor devices. The collected data can be send to the Internet by using the Ethernet and Wifi connectivity.
Page 43: Meshlium Presets
Meshlium treme Meshlium Presets 8. Meshlium Presets 8.1. Presets The Presets section allows us to set a certain node type as presented in the Meshlium Models section. This means you can change quickly from one setting to another just pressing one button. The different Meshlium configurations you can set depends on the hardware and if they have a GW roll or not.
Page 44 Meshlium treme Meshlium Presets On the one hand if we try to access to an Interface such as ZigBee or 3G/GPRS or to a module which is not physically installed, we get the message “The XXX module is not installed”. On the other hand if we try to access to an Interface which is physically installed but it is not internally activated in the current preset the next message will be shown: “Please go to presets and select the right one”.
Page 45: Validation Of Changes In Interfaces
Meshlium treme Meshlium Presets 8.2. Validation of Changes in Interfaces After changing a parameter in any Interface (Ethernet, Wifi AP, Wifi Mesh, 3G/GPRS) and once Meshlium is restarted you have to validate the changes done in the next 5 minutes. This is a security mechanism in order to make sure that the user is still able to communicate with Meshlium after changes are performed.
Page 46: Accessing Meshlium - Make It Easy
No password is needed as the network is public (you can change it later in the Wifi AP Interface options). When you select it, Meshlium will give an IP from the range 10.10.10.10 - 10.10.10.250. Now you can open your browser and access to the Meshlium Manager System: • URL: http://10.10.10.1/ManagerSystem user: • root password: libelium • -46- v4.1...
Page 47 Meshlium through the Wifi connection (which is always available) or with the crossover cable provided with Meshlium. If you want to access to the Manager System using the crossover ethernet cable go to: • URL: http://192.168.1.100/ManagerSystem user: • root password: libelium • -47- v4.1...
Page 48: Ethernet
Meshlium treme Ethernet 10. Ethernet 10.1. Configuration By default Meshlium comes with the Ethernet interface activated to get dynamically the IP using the DHCP service. If the case a static configuration is required the next parameters can be configured: -48- v4.1...
Page 49 Meshlium treme Ethernet You can also use IPv6 (Internet Protocol version 6) by setting the check box “Use IPv6”. IPv6 is a version of the Internet Protocol (IP) intended to succeed IPv4. The next parameters can be configured: In many cases, IPv6 addresses are composed of two logical parts: a prefix of 64-bit (2001::) and a 64 bit part that is generated automatically from the MAC address of the interface.
Page 50 Meshlium treme Ethernet Then press “Do Test”. If something like next image appears, you have IPv6 correctly configured. -50- v4.1...
Page 51: Wifi Ap
Meshlium treme Wifi AP 11. Wifi AP By default Meshlium comes with a 2.4GHz Wifi interface ready to work as an Access Point (AP). It also comes with the DHCP Service activated so when users connect through the Wifi connection will get automatically an IP from the range 10.10.10.10 - 10.10.10.250.
Page 52 Meshlium treme Wifi AP Radio: These are specific Wifi parameters. You can change the public name of the AP which is offered to the clients -ESSID-, by default is set “Meshlium”. You can also make it invisible so that only users who know it can connect. You can also change the radio channel which is being used for the transmissions, according to the next diagram: The Protocols that can be used are 802.11b for long links and 802.11g for high bandwidth links.
Page 53: Clients Connected
Meshlium treme Wifi AP Security: You can activate encryption in the communication using the WEP and WPA protocols. WEP is enabled in the 5 and 13 characters configurations while WPA-PSK can be used with a password from 8 to 63 characters. We recommend use WPA in order to get the a major security in the network.
Page 54: Wifi Mesh
Meshlium treme Wifi Mesh 12. Wifi Mesh The Wifi Mesh Interface enables dual band networks as it can be configured to work in the 2.4GHz or in the 5GHz in order to avoid interferences with common Wifi networks. The mesh protocol used is Optimized Link State Routing (OLSR), an open source protocol which allows us to control if a certain node has to work as a fixed node or as a mobile one.
Page 55: Olsr Options
Meshlium treme Wifi Mesh By default all the nodes with a Mesh preset come with the same ESSID and CELL ID. It is important all the nodes have this two fields with the same data. On the one hand the ESSID will allow the nodes to share a common ID in order to be detected as the same mesh network.
Page 56 Meshlium treme Wifi Mesh In the “OLSR Summary” section you can see direct information of the mesh daemon which is running inside Meshlium. The Links/Topology section shows the direct brothers and the two hop neighbours along with the “next hop” node which will be accessed in order to reach these nodes.
Page 57: The Gateway Node
Meshlium treme Wifi Mesh 12.3. The Gateway Node In a mesh network there is a node which shares its Internet connection to the rest of the neighbours. It is called the Gateway (GW). There is only one GW in the mesh network and it has to be specified in the OLSR configuration (as pointed before) checking the “Share Internet Connection”...
Page 58: G/Gprs
Meshlium treme 3G/GPRS 13. 3G/GPRS 13.1. Configuration Here you can set the parameters of the mobile operator you have chosen. There is a list with some initial configurations depending on the country and the operator . However, this list may not be updated with the last valid configuration of your mobile provider.
Page 59 Meshlium treme 3G/GPRS Once validated your settings press the Disconnect button and save your configuration. If you want the 3G/GPRS to be the Default Gateway of Meshlium each time it starts just activate the service in the “Set as Default Gateway” check box before saving.
Page 60: Joined Networks
Meshlium treme Joined Networks 14. Joined Networks This is an information section where you will find how the networks have been joined in order to give access from one to other interface. Possible networks joined are: Wireless AP -> Ethernet This bridge allows the clients connected to the Wifi AP access to the Internet through the Meshlium Ethernet connexion.
Page 61 Meshlium treme Joined Networks Wireless Mesh -> 3G/GPRS This bridge allows a Gateway node in a Wifi Mesh Network to share its Internet connection established via 3G/GPRS with the rest of the nodes in the Mesh Network and the clients connected to their Wifi AP interface. The real union of the networks is made automatically when setting the node type in the Presets section.
Page 62: Wireless Sensor Networks
0.7uA which allows to save battery when it is not transmitting. More than 50 sensors already available and a complete open source IDE (API libraries + compiler) made really easy to start working with the platform. More info at: http://www.libelium.com/waspmote -62- v4.1...
Page 63: Configuration Of The Zigbee Interface
Meshlium treme Wireless Sensor Networks 15.2. Configuration of the ZigBee interface There are 5 different XBee models can can be configured:  XBee 802.15.4  XBee ZigBee (ZB)  XBee 868MHz  XBee 900MHz  XBee DigiMesh Depending the kind of XBee model the parameters to be configured may vary. -63- v4.1...
Page 64 MAC-low: 32b (hex field) These parameters must be also configured in the Waspmote sensor nodes. Access to all the information related to Waspmote at: http://www.libelium.com/waspmote To discover the MAC address of the XBee module just press the “Load MAC” button.
Page 65: Capturing And Storing Sensor Data
Meshlium treme Wireless Sensor Networks Note: When you buy a Waspmote Developer kit with Meshlium and with the XBee ZB as ZigBee radio both the Waspmote GW and Meshlium come configured as Coordinator of the network. Take into account that only one of them can be working at the same time. Note: If the encryption check fails but the rest of parameters are OK, it means the ZigBee radio has an old version of the firmware but it is working perfectly.
Page 66 Meshlium treme Wireless Sensor Networks They are formed by the accelerometer values, RTC internal temperature value, and battery level. The MAC address is added and other helpful information. In order to add your own sensor frames properly go to the section “Capturing and storing your own ZigBee frames”. All frames captured will be able to stored on Local Database, however the frame has not been defined is stored in the database.
Page 67: Local Data Base
Meshlium treme Wireless Sensor Networks 15.3.1. Local Data Base Meshlium has a MySQL data base up and running which is used to store locally the information captured. In the “Local Data Base” tab you can see the connection parameters. Database: MeshliumDB •...
Page 68: External Data Base
Meshlium treme Wireless Sensor Networks 15.3.2. External Data Base Meshlium can also store the information captured in an External Data Base. Steps: 1. Pressing the “Show sql script” you will get the code needed to create the data base along with the table and the right privileges. 2.
Page 69 Meshlium treme Wireless Sensor Networks 5. Set the check box “Store frames in external database”, you can defined the interval how often to synchronize the local database with external database and press the “Save” button. From this time Meshlium will automatically perform Scans and will store the results in the External Data Base each . This process will also continue after restarting Meshlium.
Page 70 Meshlium treme Wireless Sensor Networks You can also choose to sync when you want. Just press the “Synchronize Now” button. -70- v4.1...
Page 71 Meshlium treme Wireless Sensor Networks At any time you can see the last “x” records stored. Just set how many insertions you want to see and press the “Show data” button. -71- v4.1...
Page 72: Show Me Now
Meshlium treme Wireless Sensor Networks 15.3.3. Show me now! In the “Show me now!” tab you can see in real time the Scans captured. You can specify if you want the information to be updated periodically with the defined interval just checking the “Use the Defined Interval”...
Page 73: Advanced Database
Meshlium treme Wireless Sensor Networks 15.3.4. Advanced Database In the “Advanced” tab you can see information about the state in which they are databases. It displays information about the Loca and Externall database, showing the following information: • Local and External Database names •...
Page 74 Meshlium treme Wireless Sensor Networks In addition can display a log of the date of the last synchronization between the local database and external database was successful. -74- v4.1...
Page 75: Capturer Logs
Meshlium treme Wireless Sensor Networks 15.4. Capturer logs Inside “Sensor Networks” exist the section Logs, in this section you can see the last frames received on Meshlium. First show the “sensor log”, in this logs shows the frames are stored after being processed. ASCII-35690399-N1-253-198-,STR:XBee frame,BAT:93,IN_TEMP:31.50 Secondly shown “Frame Log”, in this logs shows the frames stored as the arrive to Meshlium.
Page 76: Sensors
15.5. Sensors In section “Sensor List”, the user can add new sensors or delete sensors. By default Meshlium recognize all Libelium official sensors frames. All sensors frames that Meshlium can capture and store must be specified in an XML file.
Page 77: Capturing And Storing Photos And Videos
From version 3.0.6, Meshlium can also store photos and videos. New feature allows storing photos and videos sent by Waspmote (only available with XBee DigiMesh, Libelium is working for extend to XBee 802.15.4 and XBee ZigBee). Inside “Sensor Network” there is the section Photo / Video. In the tab Photos, users can watch the photos received from Waspmote.
Page 78: Sending Zigbee Frames From Meshlium To Waspmote
Important: If you want to create a “ZigBee sending” daemon that is executed each time Meshlium starts you have to deactivate the “ZigBee Capturer” daemon (/etc/init.d/ZigbeeScanD.sh) as the ZigBee radio has to be used by one process at a time. You will find support in the Libelium Forum at: http://www.libelium.com/forum -78-...
Page 79: Key Management On Meshlium
Meshlium treme Wireless Sensor Networks 15.8. Key Management on Meshlium 15.8.1. Link layer key Management (AES-128) Encryption is this layer provided through the AES 128b algorithm. Specifically through the type AES-CTR. In this case the Frame Counter field has a unique ID and encrypts all the information contained in the Payload field which is the place in the link layer frame where the data to be sent is stored.
Page 80: Application Layer Key Management (Aes-256 / Rsa)
Meshlium treme Wireless Sensor Networks 15.8.2. Application Layer Key Management (AES-256 / RSA) Meshlium will be responsible for generating keys to be distributed to Waspmote. Using openssl program that is installed by default in Meshlium can generated RSA keys. The instructions to calculate all RSA keys through terminal with openssl are: Generate keys: # openssl genrsa -out mykey.pem 1024 The previous instruction generates the file “mykey.pem”, this file stored the RSA key.
Page 81 Meshlium treme Wireless Sensor Networks In Manager System, inside section Tools, go to encryption section: For each Waspmote can send frames to Meshlium, Waspmotes keys can be added to encryptionData database on section Key Management. In this interface the user must specify the node ID, the Waspmote AES-256 secret key, and Waspmote RSA public key.
Page 82 Meshlium treme Wireless Sensor Networks The AES-256 secret key is necessary to recognize the frames sent each Waspmote to Meshlium. When a frame arrives at Meshlium should be consulted in the encryptionData database the AES-256 secret key, and use the AES algorithm to decrypt the message.
Page 83 Meshlium treme Wireless Sensor Networks Manager System allows renew all AES-256 secret keys of nodes. it is possible to do this in the section Key Renewal To renew the key, follow these step: 1. Select the Waspmote you want to renew the Waspmote AES-256 secret key. 2.
Page 84: Encryption On Meshlium
Meshlium treme Wireless Sensor Networks rsa.mod, to Meshlium RSA modulus. Necessary to private and public RSA Keys. • rsa.priv, to Meshlium RSA private key. • • rsa.pub, to Meshlium RSA public key. This operation generate the new key generated according to the diagram explained above: Important: The Waspmote node must have Meshlium public key, otherwise, will not decrypt the new AES-256 secret key.
Page 85: Rsa On Meshlium
Meshlium treme Wireless Sensor Networks 15.10. RSA on Meshlium Through instruction ./encryptionapp on command line allows, allows calculate encrypted and decrypted messages using RSA algorithm. This must be passed as a parameter rsa. Below are examples of how to pass cihpertext, plaintext public key, private key and modulus parameters.
Page 86: Decrypting Messages
Meshlium treme Wireless Sensor Networks 15.13. Decrypting messages The following instruction, from the command line, returns the deciphered message, you have to specify “node_id” of origin Waspmote. Return the decrypted message. ./encryptionapp storer node_id Important: The node must be in the encryptedData database. 15.14.
Page 87: Aes On Meshlium
Meshlium treme Wireless Sensor Networks Example of use: Calculating encrypted message with RSA Algorithm on Meshlium: # ./encryptionapp rsa -e plaintext -public public_key -m modulus Calculating decrypted message with RSA Algorithm on Meshlium: # ./encryptionapp rsa -d ciphertext -private private_key -m modulus 15.14.3.
Page 88: Smartphone Detection
Smartphone Detection 16. Smartphone Detection The new Meshlium Xtreme allows to detect iPhone and Android devices and in general any device which works with Wifi or Bluetooth interfaces. These devices can be detected without the need of being connected to an specific Access Point, enabling the detection of any Smartphone, laptop or handsfree device which comes into the coverage area of Meshlium.
Page 89 Meshlium treme Smartphone Detection Applications related to Shopping and Street activities: • Number of people passing daily in a street • Average time of the stance of the people in a street • Differentiate between residents (daily matches) and visitants (sporadic matches) • Walking routes of people in shopping malls and average time in each area The Vehicle Traffic Monitoring is also another important application as understanding the flow and congestion of vehicular traffic is essential for efficient road systems in cities. Smooth vehicle flows reduce journey times, reduce emissions and save energy.
Page 90 Meshlium treme Smartphone Detection The monitoring system can also be used to calculate the average speed of the vehicles which transit over a roadway by taking the time mark at two different points. Do the users need to have an specific app installed or interact somehow to be detected? No, the scan is performed silently, Meshlium just detects the “beacon frames”...
Page 91 Meshlium treme Smartphone Detection What about privacy? The anonymous nature of this technique is due to the use of MAC addresses as identifiers. MAC addresses are not associated with any specific user account or mobile phone number not even to any specific vehicle. Additionally, the “inquiry mode” (visibility) can be turned off so people have always chosen if their device will or won’t be detectable.
Page 92: Wifi Scan
16.1. Wifi Scan 16.1.1. Concepts The Wifi radio integrated in the new Meshlium Xtreme allows to scan Wifi devices in a range of action up to 200m depending on the line of sight conditions. The idea is to search for Wifi devices in a defined interval which can be configured. Meshlium will get the MAC address, the Access Point (AP) to which the device is connected (if any), the signal strength (RSSI) of the devices along with a timestamp which identifies when the scan was performed.
Page 93: Capturing And Storing Wifi Scans
Meshlium treme Smartphone Detection 16.1.2. Capturing and Storing Wifi Scans We can perform three different storage options with the data captured. • Local File System • Local Data Base • External Data Base -93- v4.1...
Page 94: Local File System
Meshlium treme Smartphone Detection 16.1.3. Local File System Steps: Give a name to create a new file where the Wifi Scans will be saved. Select this file and press the “Select file” button. Set the check box “Store frames in the selected file” and press the “Save” button. From now Meshlium will automatically perform Scans and will store the results in this file.
Page 95: Local Data Base
Meshlium treme Smartphone Detection 16.1.4. Local Data Base Meshlium has a MySQL data base up and running which is used to store locally the information captured. In the “Local Data Base” tab you can see the connection parameters. Database: MeshliumDB •...
Page 96: External Data Base
Meshlium treme Smartphone Detection 16.1.5. External Data Base Meshlium can also store the information captured in an External Data Base. Steps: Pressing the “Show sql script” you will get the code needed to create the data base along with the table and the right privileges.
Page 97 Meshlium treme Smartphone Detection Now press the “Check Connection” button to see if the configuration is correct. -97- v4.1...
Page 98 Meshlium treme Smartphone Detection Set the check box “Store frames in the selected file” and press the “Save” button. From this time Meshlium will automatically perform Scans and will store the results in the Local Data Base. This process will also continue after restarting Meshlium.
Page 99: Show Me Now
Meshlium treme Smartphone Detection 16.1.6. Show me now! In the “Show me now!” tab you can see in real time the Scans captured. You can specify if you want the information to be updated periodically with the defined interval just checking the “Use the Defined Interval”...
Page 100: Bluetooth Scans
Meshlium treme Smartphone Detection 16.2. Bluetooth Scans 16.2.1. Concepts This radio integrated in Meshlium allows to scan Bluetooth devices in a range of action up to 200m depending on the line of sight conditions. The idea is to search for Bluetooth devices in a defined interval which can be configured. Meshlium will get the MAC address, the Bluetooth ID and the RSSI of the devices along with a timestamp which identifies when the scan was performed.
Page 101: Capturing And Storing Bluetooth Scans
Meshlium treme Smartphone Detection 16.2.2. Capturing and Storing Bluetooth Scans We can perform three different storage options with the data captured. • Local File System • Local Data Base • External Data Base -101- v4.1...
Page 102: Local File System
Meshlium treme Smartphone Detection 16.2.3. Local File System Steps: Give a name to create a new file where the Bluetooth Scans will be saved. Select this file and press the “Select file” button. Set the check box “Store frames in the selected file” and press the “Save” button. From now Meshlium will automatically perform Scans and will store the results in this file.
Page 103: Local Data Base
Meshlium treme Smartphone Detection 16.2.4. Local Data Base Meshlium has a MySQL data base up and running which is used to store locally the information captured. In the “Local Data Base” tab you can see the connection parameters. Database: MeshliumDB •...
Page 104: External Data Base
Meshlium treme Smartphone Detection 16.2.5. External Data Base Meshlium can also store the information captured in an External Data Base. Steps: Pressing the “Show sql script” you will get the code needed to create the data base along with the table and the right privileges. -104- v4.1...
Page 105 Meshlium treme Smartphone Detection Insert this code in your MySQL management application. Fill the Connection Data fields with the information about where the data base is located (IP, Port) and with the authentication options (Database, Table, User, Password). -105- v4.1...
Page 106 Meshlium treme Smartphone Detection Now press the “Check Connection” button to see if the configuration is correct. -106- v4.1...
Page 107 Meshlium treme Smartphone Detection Set the check box “Store frames in the selected file” and press the “Save” button. From this time Meshlium will automatically perform Scans and will store the results in the Local Data Base. This process will also continue after restarting Meshlium.
Page 108: Show Me Now
Meshlium treme Smartphone Detection 16.2.6. Show me now! In the “Show me now!” tab you can see in real time the Scans captured. You can specify if you want the information to be updated periodically with the defined interval just checking the “Use the Defined Interval”...
Page 109: Gps
Meshlium treme 17. GPS 17.1. Concepts Meshlium can integrate a GPS receiver which allows to know the exact location of the router any time. It is specially interesting for mobile and vehicular applications and when setting long range links as the GPS position also gives information about the height of each point so the Fresnel Zone can be accurately known.
Page 110 Meshlium treme - Assisted GPS (A-GPS): This is the more complex mode of positioning calculation. The GPS module uses the NMEA sentences along with calculations made in a external server which uses also the cell information provided by the 3G module. For this purpose the GPS module will use the 3G/GPRS radio in order to connect to a web server to make the external calculations.
Page 111: Capturing And Storing Gps Data
Meshlium treme 17.2. Capturing and Storing GPS Data We can perform three different storage options with the data captured. • Local File System • Local Data Base • External Data Base 17.2.1. Local File System Steps: Give a name to create a new file where the GPS data will be saved Select this file and press the “Select file”...
Page 112: Local Data Base
Meshlium treme At any time you can see the last “x” lines added to the file. Just set how many lines you want to see and press the “Show data” button. 17.2.2. Local Data Base Meshlium has a MySQL data base up and running which is used to store locally the information captured. In the “Local Data Base”...
Page 113 Meshlium treme Steps: Set the check box “Store frames in the selected file” and press the “Save” button From this time Meshlium will automatically perform Scans and will store the results in the Local Data Base. This process will also continue after restarting Meshlium.
Page 114: External Data Base
Meshlium treme 17.2.3. External Data Base Meshlium can also store the information captured in an External Data Base. Steps: Pressing the “Show sql script” you will get the code needed to create the data base along with the table and the right privileges.
Page 115 Meshlium treme Now press the “Check Connection” button to see if the configuration is correct. Set the check box “Store frames in the selected file” and press the “Save” button. From this time Meshlium will automatically perform Scans and will store the results in the Local Data Base. This process will also continue after restarting Meshlium.
Page 116 Meshlium treme At any time you can see the last “x” records stored. Just set how many insertions you want to see and press the “Show data” button. -116- v4.1...
Page 117: Show Me Now
Meshlium treme 17.2.4. Show me now! In the “Show me now!” tab you can see in real time the Scans captured. You can specify if you want the information to be updated periodically with the defined interval just checking the “Use the Defined Interval”...
Page 118: Networking Tools
Meshlium treme Networking tools 18. Networking tools 18.1. Ping It let you test if you can reach a certain IP or Hostname through a specific Interface: Ethernet (IPv4), Ethernet (IPv6), Wifi AP, Wifi Mesh and 3G/GPRS. -118- v4.1...
Page 119 Meshlium treme Networking tools Meshlium Xtreme can also perform this test over the Ethernet (IPv6) interface. -119- v4.1...
Page 120: Iperf
Meshlium treme Networking tools 18.2. Iperf This tool let you know the real bandwidth between two different nodes through a specific Interface. Meshlium comes with the Iperf service activated by default so you can test the bandwidth quality of a link between two Meshlium just setting the IP of the node in the input box.
Page 121: Traceroute
Another interesting tool to discover which is the route performed by the data which is being sent through a certain Interface while trying to reach a host. Meshlium Xtreme can also perform this test over the Ethernet (IPv6) interface. -121-...
Page 122: Netstat
Meshlium treme Networking tools 18.4. Netstat Discover which connections IPv4-Port (tcp), and IPv6-Port (tcp6) are active. 18.5. Beep When setting up and configuring several Meshlium at a time in the laboratory, can be difficult to distinguish between them (overall when the IP addresses are given by a external DHCP router). For this reason we have added a “Beep” button in the “Tools” section which will make the current Meshlium to make a short sound (“beep!”).
Page 123: Special Options For Wifi Networks
Meshlium treme Special options for Wifi networks 19. Special options for Wifi networks 19.1. Long range links If you want to make long range Wifi links (km) between several Meshlium you will need to adjust some parameters (Acktimeout, Ctstimout, Slottime) in the Wifi interfaces. We have enabled in the tools section the possibility of doing it automatically. Just set the number of Km of the link desired and Save.
Page 124: System
Meshlium treme System 20. System 20.1. Hostname Set the name of the node. By default is “Meshlium”. 20.2. Users Manager Here you can change two different passwords. The “Users Manager” section contains the password needed to access to the Manager System. It is the same password used in the system to access by SSH.
Page 125: Setting The Time
Meshlium treme System 20.3. Setting the time In order to store correctly in the File System and in the Local Data Base the data captured from the ZigBee and Bluetooth radios and from the GPS module is important to set the system time previously. The idea is each sensor data frame to be stored along with a time stamp so that they can be chronologically ordered.
Page 126: Internal Temperature Sensors
Meshlium treme System 20.5. Internal temperature sensors You can see in real time the microprocessor (upper) and mother board temperature in Celsius degrees. -126- v4.1...
Page 127: Data Base Management
Via Ethernet (if there is no DHCP server): $ ssh root@192.168.1.100 user: • root • password: libelium Now execute you can enter the MysQL shell (password: libelium2007) meshlium:$ mysql -u root -p >libelium2007 mysql> use MeshliumDB; Database changed mysql> select * from XXX order by YYY;...
Page 128: Phpmyadmin
Meshlium treme Data Base Management 21.2. PHPMyAdmin Also you can manage all mysql databases in Meshlium using “phpmyadmin”. Go to the phpMyAdmin plugin in the Tools section and work directly there or open it in a new browser window. You can also access with at: http://10.10.10.1/phpmyadmin. If you are not accessing via Wifi or you changed this interface the IP may change.
Page 129: Ftp Management
Meshlium treme FTP Management 22. FTP Management As of version 3.0.6 or later an FTP sever has been added to Meshlium. FTP is built on a client-server architecture and uses separate control and data connections between the client and the server. FTP users may authenticate themselves using a username and password, but can connect anonymously if the server is configured to allow it.
Page 130: Accessing Ftp Server
Meshlium treme FTP Management 22.3. Accessing FTP server To access Meshlium FTP server from any computer, you can use FTP client like FileZilla. To connect to FTP server you must enter: • Meshlium IP • Username • Password Once connected to the FTP server the user can perform operations like download, delete, or modify storage data. -130- v4.1...
Page 131: Uploading My Own Applications To Meshlium
If you have any doubt ask to our Development team at: http://www.libelium.com/forum You can access through SSH using the same user and password of the Manager System.
Page 132 Alternatively you can use a sftp client program, like Filezilla, and use it from you pc to upload files to Meshlium: Using the following data: Host: • 10.10.10.1 Server Type: SFTP • • Port: User: • root • Password: libelium -132- v4.1...
Page 133: Installing New Packages And Libraries
Once dependencies are solved press the “g” key and the new package will be download and installed. If you are not sure about using “aptitude” do not perform any action as the system could get damaged. You can ask to our Developing team at: http://www.libelium.com/forum -133-...
Page 134: Upgrading Old Versions Of Meshlium
To see your current version go to the “Help” section. In the “Update Manager” section you can upgrade the entire Manager System or a certain plugin individually. There are three ways of getting the new version installed. • Checking the Libelium Repository • Local File •...
Page 135: Checking The Libelium Repository
In order to use this version you need to have Meshlium connection to the Internet. If so just press the “Check for updates” button and the system will connect with the Libelium server and will download the latest updates. All the available updates are shown. It is possible that several “middle step” updates have to be done before getting the latest version installed.
Page 136: Local File
You can also make installations in “offline” mode. To do so download first the desired package from the next URL: http://www.libelium.com/downloads/managersystem/updates/ Then select it from your hard disk using the “Select” button. The Libelium Packages will have the extension: • libupd - Manager System updates Once uploaded the update package just press the “Install”...
Page 137: Url
Upgrading old versions of Meshlium 25.3. URL You can also make installations using an specific URL (www.libelium.com/downloads/managersystem/updates/updates. xml). To do so just write this URL into the right input box and press the “Download” button. Remember that in the same way as in the “Checking for updates”...
Page 138: Rescue System
26.1. Steps You wil need a USB pen drive of at least 4 GB. The first thing to do is download from the website of Libelium the image file “meshliumrescue.img” needed to restore Meshlium to factory defaults. Go to: http://www.libelium.com/downloads/meshlium/ Note: You need to contact first our Technical Service Department in order to get the user and password to download the image.
Page 139 Meshlium treme Rescue System - Windows Important: Be careful when using “dd” in Linux or Windows. A mistake in the path of the USB disk could destroy the information contained in your hard disk. Download the last version of “dd for Windows”: (http://www.chrysocome.net/download) Unzip dd-0.xx.zip Execute cmd Insert a USB stick into a USB port on the computer.
Page 140: How To Recover The File System
Meshlium treme Rescue System 26.2. How to Recover the file system Unplug the power Ethernet cable in Meshlium. Unscrew with the hand the right stopper (next to the Ethernet connector). Plug the recovery USB pen drive to Meshlium. Connect the Ethernet cable to Meshlium. After the initial short beeps It will then start emitting a long series of “beeps”, which means the system from the USB pen drive is being copied to Meshlium.
Page 141: Usb Device Connectivity
Meshlium treme USB Device Connectivity 27. USB Device Connectivity The external USB connector lets you connect any USB device to Meshlium. The only limitation is that your device must be supported by a Linux system (obviously you can install its drivers through a repository or uploading the files directly). In the next example we will connect a webcam and will capture several images which will be accessed from a web page.
Page 142 Create “webcam.html” in the directory “/var/www/” with the following content: <!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”> <html> <head> <meta http-equiv=”content-type” content=”text/html; charset=iso-8859-1” /> <meta name=”author” content=”libelium@libelium.com” /> <title>Webcam - Test</title> </head> <body> <img src=”http://192.168.1.92:9192” width=”640” height=”480” alt=”Webcam” > </body>...
Page 143: Documentation Changelog
Meshlium treme Documentation Changelog 28. Documentation Changelog • Added section “Capturing and Storing photos and videos”. • Added section ”FTP Management”. -143- v4.1...
Page 144: Certifications
Meshlium treme Certifications 29. Certifications 29.1. CE In compliance with the 1999/05/EC directive, Libelium Comunicaciones Distribuidas declares that Meshlium complies with the following norms: • EN 55022:1998 • EN 55022:1998/A1:2000 • EN 55022:1998/A2:2003 • EN 61000-4-2:1995 • EN 61000-4-2/A1:1998 •...
Page 145 Important: Libelium Comunicaciones Distribuidas S.L does not list the entire set of standards that must be met for each country. Libelium customers assume full responsibility for learning and meeting the required guidelines for each country in their distribution market. For more information relating to European compliance refer to the following web sites: •...
Page 146: Fcc
Meshlium treme Certifications 29.2. FCC Meshlium models: Meshlium AP Contains: • FCC ID: NKRCM9 • FCC ID: Q87-USBBT100V2 Meshlium 3G/GPRS-AP Contains: • FCC ID: NKRCM9 • FCC ID: Q87-USBBT100V2 • FCC ID: UDV-0200901181058 Meshlium Mesh-AP Contains: • FCC ID: NKRCM9 •...
Page 147 Meshlium treme Certifications Meshlium ZigBee-Mesh-AP Contains: • FCC ID: NKRCM9 • FCC ID: Q87-USBBT100V2 • FCC ID: OUR-XBEEPRO • FCC ID: MCQ-XBEEPRO2 • FCC ID: MCQ-XBEE09P Meshlium ZigBee-Mesh-AP-GW Contains: • FCC ID: NKRCM9 • FCC ID: Q87-USBBT100V2 • FCC ID: OUR-XBEEPRO •...
Page 148 Meshlium treme Certifications Module Grant Restrictions: FCC ID OUR-XBEEPRO: The antenna(s) used for this transmitter must be installed to provide the separation distances, as described in this filing, and must not be co-located or operating in conjunction with any other antenna or transmitter. Grantee must coordinate with OEM integrators to ensure the end-users of products operating with this module are provided with operating instructions and installation requirements to satisfy RF exposure compliance.
Page 149: Maintenance
Meshlium treme Maintenance 30. Maintenance • Although Meshlium is a highly resistant product, please handle with care in order to enjoy a longer useful life. • Handle Meshlium with care, do not allow it to drop or move roughly. • Avoid placing the devices in areas reaching high temperatures that could damage the electronic components.
Page 150: Disposal And Recycling
Meshlium treme Disposal and Recycling 31. Disposal and Recycling • When Meshlium reaches the end of its useful life it must be taken to a recycling point for electronic equipment. • The equipment should be disposed of separately from solid urban waste, please dispose of correctly. •...

Libelium Meshlium Xtreme Technical Manual

1 General and Safety Information

2 Important: Read Me before Using

3 Contents of the Box

4 Specifications

5 Accessories

6 How to Use Meshlium

7 Understanding Meshlium

8 Meshlium Presets

9 Accessing Meshlium - Make It Easy

10 Ethernet

11 Wifi AP

12 Wifi Mesh

13 G/Gprs

14 Joined Networks

15 Wireless Sensor Networks

16 Smartphone Detection

17 Gps

18 Networking Tools

19 Special Options for Wifi Networks

20 System

21 Data Base Management

22 FTP Management

23 Uploading My Own Applications to Meshlium

24 Installing New Packages and Libraries

25 Upgrading Old Versions of Meshlium

26 Rescue System

27 USB Device Connectivity

28 Documentation Changelog

29 Certifications

30 Maintenance

31 Disposal and Recycling

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Libelium Meshlium Xtreme

Summary of Contents for Libelium Meshlium Xtreme

Table of Contents