Libelium Meshlium Xtreme Technical Manual

Hide thumbs Also See for Meshlium Xtreme:
Table of Contents

Advertisement

Quick Links

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Meshlium Xtreme and is the answer not in the manual?

Questions and answers

Summary of Contents for Libelium Meshlium Xtreme

  • Page 2: Table Of Contents

    Meshlium treme Index Document version: v7.1 - 03/2017 © Libelium Comunicaciones Distribuidas S.L. INDEX 1. General and safety information ......................6 2. Important: read me before using ....................... 7 3. Meshlium v4.0 vs Meshlium v3.5 ....................... 8 3.1. Capabilities comparison ................................8 3.2.
  • Page 3 Meshlium treme Index 9.3. Network setup confirmation ..............................37 9.4. 4G setup ....................................... 38 9.5. Proxy setup ....................................39 10. Wireless Sensor Networks ....................... 41 10.1. Meshlium and Waspmote ..............................41 10.2. Receiving and storing data ..............................42 10.2.1. Receiving trough RF communications ......................42 10.2.2.
  • Page 4 Meshlium treme Index 12.2.8. ElementBlue – RightSensor ..........................117 12.2.9. Ensura ..................................118 12.2.10. Extunda .................................. 120 12.2.11. IoTSens ................................... 121 12.2.12. Kii ....................................122 12.2.13. Nexmachina ................................. 124 12.2.14. Orchestra ................................126 12.2.15. Sentilo..................................129 12.2.16. Simfony .................................. 130 12.2.17.
  • Page 5 Meshlium treme Index 16. System Information ........................173 16.1. Hostname ....................................173 16.2. Password management ..............................173 16.3. Disk usage ....................................174 16.4. Internal temperature sensor .............................174 16.5. Time synchronization ................................175 17. Upgrading Meshlium ........................176 17.1. Checking for updates ................................176 17.2. Local file ....................................177 17.3.
  • 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

    Meshlium’s microprocessor must not overpass 75 Celsius degrees. The user must ensure that this temperature never overpass. Especially when using WiFi Scan. • Do not power Meshlium with other power sources than the original provided by Libelium. For more information: http://www.libelium.com/meshlium...
  • Page 8: Meshlium V4.0 Vs Meshlium V3.5

    Meshlium treme Meshlium v4.0 vs Meshlium v3.5 3. Meshlium v4.0 vs Meshlium v3.5 This evolution of Meshlium includes an important upgrade of the hardware capabilities. The most important changes are: • Big step forward in performance, CPU performance 10 times better and RAM capacity 8 times bigger. •...
  • Page 9: Compatibility With Waspmote And Plug & Sense! Nodes

    Meshlium treme Meshlium v4.0 vs Meshlium v3.5 3.2. Compatibility with Waspmote and Plug & Sense! nodes Old hardware Compatible Notes Plug & Sense! (Waspmote v1.2) 802.15.4 Plug & Sense! (Waspmote v1.2) ZigBee Old ZigBee modules are EoL Plug & Sense! (Waspmote v1.2) DigiMesh Old 900 MHz modules are EoL.
  • Page 10: Xbee-Pro 868 Vs Xbee 868Lp

    Meshlium treme Meshlium v4.0 vs Meshlium v3.5 Cloud software Compatible Notes Eagle.io ElementBlue Extunda IoTSens Sentilo Sofia2 Solvver Thing+ Compatibility with other software: Software Compatible Notes External DB synchronization of sensor Some changes in the tables needed, can be done data.
  • Page 11: Xbee-Pro 900 Vs Xbee-Pro 900Hp

    Meshlium treme Meshlium v4.0 vs Meshlium v3.5 3.5. XBee-PRO 900 vs XBee-PRO 900HP The new XBee 900HP modules support some changes: • The new XBee-PRO 900HP uses greater power transmission compared to the old version. Thus, the ranges achieved by these new modules are larger than before.
  • Page 12 Meshlium treme Meshlium v4.0 vs Meshlium v3.5 Features [Old] 3G (SIM5215) [New] 4G (LE910) Upload max speed 384 kbps 50 Mbps Antenna diversity Any + Specially tested with AT&T, SK Telecom, Telstra, NTT DoCoMo or Cellular carriers KDDi -12- v7.1...
  • Page 13: Contents Of The Box

    Meshlium treme Contents of the box 4. Contents of the box Meshlium a) IP65 casing b) Ethernet connector c) micro-SIM + micro-USB connector d) Expansion connector e) Antenna connectors Antennas a) Dipole 5 dBi (Bluetooth, WiFi, XBee-PRO 802.15.4) b) 4G / GPS (3 antennas for EU, US or BR models; 2 antennas for AU models) c) Dipole 4.5 dBi (XBee 868LP, XBee-PRO 900HP) (*) Number and type of antennas depend on the model purchased.
  • Page 14 Meshlium treme Contents of the box Ethernet cable IP65 Ethernet cap Ethernet crossover cable POE injector AC/DC adapter -14- v7.1...
  • Page 15: Specifications

    60 s running AC-220 V (DC-12 V) Types of power supply* Linux, Debian based Figure : Meshlium unit Meshlium Manager System Management software (open source) Security Authentication WEP, WPA, WPA2, HTTPS (*) Only with the accessories supplied by Libelium -15- v7.1...
  • Page 16 Meshlium treme Specifications WiFi (2.4 GHz) radio (Access Point/Scanner) WiFi radio Chipset Qualcomm Atheros QCA9882 TX power 20 dBm Range 500 m* Antenna 5dBi dipole Type Omni-directional, dipole Gain 5 dBi Dimensions 224 x 22 mm (*) Depending on antenna and line of sight RF radio modules Model XBee-PRO 802.15.4...
  • Page 17 Meshlium treme Specifications 4G/LTE module Protocols 4G, LTE, 3G, WCDMA, HSPA, UMTS, GPRS, GSM LTE - 800 (B20) / 1800 (B3) / 2600 (B7) Frequency bands, EU/BR UMTS - 850 (B5) / 900 (B8) / 2100 (B1) version GSM/GPRS - 900 /1800 LTE - 700 (B17) / 850 (B5) / AWS1700 (B4) / 1900 (B2) Frequency bands, US version...
  • Page 18: How To Use Meshlium

    How to use Meshlium 6. How to use Meshlium 6.1. Power supply Meshlium needs a 220 V power connection. The device must be powered with the power source provided by Libelium. How to connect Meshlium to 220 V (110 V compatible): •...
  • Page 19: External Sim Socket

    Meshlium treme How to use Meshlium 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. •...
  • Page 20: How To Install The Antennas

    Meshlium treme How to use Meshlium The micro-SIM card connector allows the user to connect the SIM card. You can ask your Mobile Network Operator for a micro- SIM card. It is better to use a normal micro-SIM card, not a card which can be broken into a nano-SIM card. The micro-SIM card connector has a push-push mechanism, so it is really easy to remove the card using one nail or a small tool.
  • Page 21: Installation Of The Ip65 Ethernet Cable

    Meshlium treme How to use Meshlium • WiFi AP – Socket 2 • 4G with adapter n-to-SMA– Socket 1 and 6 • GPS with adapter n-to-SMA – Socket 3 • RF module 802.15.4 – Socket 5 • RF module 868 MHz / 900 MHz with adapter n-to-RP-SMA – Socket 4 •...
  • Page 22 Meshlium treme How to use Meshlium • 3. Introduce the joints into part B as shown in the drawing. Figure : Introduce joints • 4. Insert part C into part D. Figure : Insert part C • 5. Screw both sets of parts in the direction shown in the diagram. Figure : Screw both parts •...
  • Page 23 Meshlium treme How to use Meshlium Your IP65 Ethernet cable is now ready for use. How to connect the IP65 Ethernet cable to Meshlium: • 1. Take the adhesive joint that has not been used for fitting the cap and stick it to the Meshlium Ethernet connector. Figure : Stick joint •...
  • Page 24: Installing Meshlium

    Meshlium treme How to use Meshlium 6.5. Installing Meshlium Meshlium has been designed to operate in a vertical position with the antennas and connectors facing down. You will find the required bracket to mount Meshlium in a pole or in a wall. To fix the bracket to a wall: •...
  • Page 25: Setting The Time

    Note 4: If the user does not follow these instructions, the risk is very high. Meshlium will become unresponsive and inaccessible. 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.
  • Page 26: Understanding Meshlium

    (detects iPhone and Android devices) * More info about Waspmote at: http://www.libelium.com/waspmote All the networking options can be controlled from the 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 27: Storage

    HTTP protocol. Users can connect directly to Meshlium using the WiFi interface to control it and access to the sensor data. Users can also connect to Meshlium via WiFi with laptops and smart phones and get access to the Internet (as a common Access Point). http://www.libelium.com/waspmote Figure : Meshlium RF 4G AP -27-...
  • Page 28 Meshlium treme Understanding Meshlium Meshlium Scanner 4G 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 interface or the 4G/3G/GPRS/GSM connectivity. Besides, Waspmotes with GPRS, GPRS+GPS, 3G, 4G or WiFi can send sensor info through the access point or through the Internet via HTTP protocol.
  • Page 29: Accessing Meshlium - Make It Easy

    Meshlium will give an IP address from the range 10.10.10.10 – 10.10.10.250. Now you can open your browser on your PC, tablet or smartphone and access the Meshlium Manager System: URL: • http://10.10.10.1/ManagerSystem user: admin • • password: libelium Figure : Manager System login screen -29- v7.1...
  • Page 30 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: admin • password: libelium • -30- v7.1...
  • Page 31: Network Interfaces Setup

    Meshlium treme Network interfaces setup 9. Network interfaces setup Access the network interfaces setup clicking on the button “Interfaces”: Figure : Interfaces setup plugin 9.1. Ethernet setup By default Meshlium comes with the Ethernet interface activated to get dynamically the IP using the DHCP service. In case a static configuration is required the next parameters can be configured: Figure : Ethernet setup Figure : Ethernet setup form...
  • Page 32 Meshlium treme Network interfaces setup 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 replace IPv4. The next parameters can be configured: Figure : IPV6 setup 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 33 Meshlium treme Network interfaces setup If your Internet Service Provider does not support external IPv6 addresses yet, you can change it to a local address. Figure : Ping IPv6 with address Then press “Do Test”. If something like next image appears, you have IPv6 correctly configured. Figure : Ping results -33- v7.1...
  • Page 34: Wifi Access Point Setup

    Meshlium treme Network interfaces setup 9.2. WiFi Access Point setup Meshlium is a WiFi Access Point and can supply network connectivity trough WiFi. The most useful feature of the AP is to provide access to Manager System from a tablet or laptop without any physical connection with Meshlium. By default the AP hast the ESSID “meshliumXXXX”...
  • Page 35 Meshlium treme Network interfaces setup Radio These are specific WiFi parameters. Here can be setup: • ESSID of the network. This is the name that appear in the devices that are searching WiFi networks. It can be public or hidden, allowing only connections manually started. •...
  • Page 36: Clients Connected

    Meshlium treme Network interfaces setup Figure : WiFi AP WPA2 Saving After saving the setup, a message will warn the user about setup confirmation. A reboot is needed to apply new settings. The setup has to be confirmed within 5 minutes after reboot. More info in “Network setup confirmation”. Figure : Confirmation warning 9.2.2.
  • Page 37: Network Setup Confirmation

    Meshlium treme Network interfaces setup 9.3. Network setup confirmation After changing Ethernet or WiFi AP setup, a reboot is needed to apply new settings. After this reboot, the user has to confirm the settings in order to definitely apply them. If after 5 minutes of the reboot the user has not confirmed the new settings, last validated settings will be applied again.
  • Page 38: Setup

    Meshlium treme Network interfaces setup 9.4. 4G setup This plugin allows to setup the parameters of the modem connection. 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. Ask your mobile company for the information required to connect (APN, Username, Password) and add the PIN code of the SIM card used (leave empty if there is no PIN).
  • Page 39: Proxy Setup

    Meshlium treme Network interfaces setup If connection is established, the IP will be shown in the interface. Once the modem is connected a process will check the connection every 15 minutes and will try to reconnect in case of disconnection. Figure : 4G successfully connected Once validated your settings press the Disconnect button and save your configuration.
  • Page 40 Meshlium treme Network interfaces setup The proxy can be enabled or disabled from the control of the interface. Figure : Proxy enable control Figure : Proxy disable control Note: Currently the proxy feature is only available for visualizer plugin. This feature will be gradually included in other services. -40- v7.1...
  • Page 41: Wireless Sensor Networks

    More than 70 sensors are already available and a complete open source IDE (API libraries + compiler) make really easy to start working with the platform. More info at: http://www.libelium.com/products/waspmote/ http://www.libelium.com/products/plug-sense/ In the main page of “Sensor Networks” tab will be shown the devices in the system showing the last received data.
  • Page 42: Receiving And Storing Data

    Meshlium treme Wireless Sensor Networks 10.2. Receiving and storing data 10.2.1. Receiving trough RF communications 10.2.1.1. RF module setup Meshlium can equip three different RF modules: XBee-PRO 802.15.4 (2.4 GHz), XBee 868LP (868 MHz) and XBee-PRO 900HP (900 MHz). It can equip several modules at the same time. RF modules setup can be found in: Sensor Networks →...
  • Page 43 Meshlium treme Wireless Sensor Networks In this module the parameters to setup are: PAN ID: Personal Area Network ID (also known as Network ID). It is the identifier of the network. It has to be the same in all • the nodes in order to be able to send data to this Meshlium.
  • Page 44 Meshlium treme Wireless Sensor Networks 10.2.1.1.2. XBee 868LP radio setup Figure : XBee 868LP setup In this module the parameters to setup are: PAN ID: Personal Area Network ID (also known as Network ID). It is the identifier of the network. It has to be the same in all •...
  • Page 45 Meshlium treme Wireless Sensor Networks 10.2.1.1.3. XBee-PRO 900HP radio setup Figure : XBee-PRO 900HP setup In this module the parameters to setup are: • PAN ID: Personal Area Network ID (also known as Network ID). It is the identifier of the network. It has to be the same in all the nodes in order to be able to send data to this Meshlium.
  • Page 46 Meshlium treme Wireless Sensor Networks 10.2.1.2. Encryption setup Link layer key management (AES-128) This feature is provided by XBee modules. 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 47 Bear in mind that to use this feature, the frame have to be created with the Waspmote libraries for AES frames. You can see further information about this in the Waspmote guides. http://www.libelium.com/waspmote 10.2.1.3. Capturing and storing sensor data from RF module Meshlium will receive the sensor data sent by Waspmote and Plug and Sense using the RF radio and it will store the frames in the local database.
  • Page 48 Meshlium treme Wireless Sensor Networks All the data is stored in the local database in the first place, then it can be synchronized to an external database as per user needs. Figure : Storage options The data stored can be synchronized too to external services using the Internet connection. Figure : External synchronization options -48- v7.1...
  • Page 49: Receiving Trough 4G / Wifi / Ethernet (Http)

    Meshlium treme Wireless Sensor Networks 10.2.2. Receiving trough 4G / WiFi / Ethernet (HTTP) Figure : HTTP data reception Meshlium accepts POST and GET requests in any of its interfaces so Waspmotes are capable of sending frames, through GPRS, 3G, 4G or WiFi modules, via HTTP requests. Meshlium, through HTTP requests is capable of: •...
  • Page 50 Meshlium treme Wireless Sensor Networks Capturer plugin have several tabs where the user can see recent data received, manage external database synchronization and perform some local database operations. Figure : Capturer plugin -50- v7.1...
  • Page 51: Local Database

    Meshlium treme Wireless Sensor Networks 10.3.1. Local database Meshlium has a MySQL database up and running which is used to locally store the information captured. In the “Local Data Base” tab the user can see the default connection parameters. Database: MeshliumDB •...
  • Page 52: External Database

    Meshlium treme Wireless Sensor Networks In this tab the user can: • Show last insertions, up to 500. Figure : Show last data • Setup Auto-purge. This function allow to program a daily maintenance in the local database that deletes old data, keeping only the number of days configured, and allowing to delete synchronized data (only external database) or all data.
  • Page 53 Meshlium treme Wireless Sensor Networks In this tab the user can: • Setup the parameters of the external database and check the connection. Figure : External database setup • Enable or disable the synchronization. Figure : Control to enable or disable synchronization Show last data inserted in the external database (up to 500 data).
  • Page 54 Meshlium treme Wireless Sensor Networks The steps to setup the synchronization are: • Before configuring anything, make sure you have a MySQL database working under your control. Make sure the database listen to connections in an external IP. • Press the “Show SQL script” button, copy the SQL code. You can modify user, password, database name and table, as long as you change the setup of the connection to match.
  • Page 55: Show Me Now

    Meshlium treme Wireless Sensor Networks 10.3.3. Show me Now In this tab the user can show the last frame received. The user can show only last frame or can specify if the information will be updated periodically with the defined interval just checking the “Use the Defined Interval” button. Figure : Show me Now tab The screen can be cleaned with the button in the top right.
  • Page 56 Meshlium treme Wireless Sensor Networks It shows: • Database name • Database size • Database table used • Number of total sensor entries • Number of frames already synchronized with external services • Number of unsynchronized frames There are too two controls to: •...
  • Page 57: Logs

    Meshlium treme Wireless Sensor Networks 10.4. Logs In this section the user can see the last lines of the logs of frames and sensor data received. Figure : Logs visualizing plugin • The “Refresh” button will load again the log files •...
  • Page 58: Sensor List

    In this section, the user can view the list of available sensors in the system and add or delete user custom sensors. By default, Meshlium recognize all Libelium official sensors frames. All sensor frames that Meshlium can capture and store must be specified in an XML file. The button “update sensors” update the Libelium official sensor list. User sensors remaining unchanged.
  • Page 59: Ota Via Ftp

    Besides, a default user is configured in Meshlium FTP Server with the following settings: • user: ota • password: libelium This user directly connects to the following path in Meshlium’s system directory where the application creates all the binary and UPGRADE.TXT files: /mnt/user/ota Inside “Sensor Network”...
  • Page 60 Meshlium treme Wireless Sensor Networks Figure : OTA-FTP plugin Firstly, there are three possibilities to be chosen: • Select NO_FILE to inform Waspmote that no OTA is necessary • Select a new file generated by the Waspmote platform IDE so as to update the Waspmote’s program. •...
  • Page 61: Meshlium Visualizer

    Figure : Meshlium Visualizer can plot graphs and geo-locate data on maps Please note that this is a paid service. In every IoT Vertical Kit, each Meshlium comes with 100 visualizations. After 100 visualizations, users can contact Libelium Sales Department (salesteam@libelium.com) if they want to continue using the service.
  • Page 62 Meshlium treme Meshlium Visualizer Figure : Meshlium Visualizer showing one graph If your query has GPS results (data frames with GPS information), the “Map” tab will be shown. If it is not the case, like in the previous picture, this tab remains disabled. Figure : Locating nodes on a map thanks to Meshlium Visualizer -62- v7.1...
  • Page 63 Meshlium treme Meshlium Visualizer The “Data” tab shows a list of sensor values, ordered by time. Figure : Meshlium Visualizer showing the Data tab The “Export” tab shows two calendars to select the initial and final date. This feature does not take into account the block on the top of the page, it will export all data from all Plug &...
  • Page 64: Cloud Connectors

    IoT Platforms are professional development frameworks for developing data management applications, including Esri, ThingWorx, IBM Bluemix, Telefónica and Microsoft Azure. IoT Solutions are specific applications focused in different verticals. Libelium promotes the Cloud Partnership Program for any cloud service provider that would like to foster their very own solution using our products.
  • Page 65 Meshlium treme Cloud Connectors Figure : Cloud Connector main menu on the Manager System -65- v7.1...
  • Page 66: Iot Platforms

    Meshlium treme Cloud Connectors 12.1. IoT platforms 12.1.1. Amazon IoT Amazon Web Services IoT enables secure, bi-directional communication between Internet-connected things (such as sensors, actuators, embedded devices, or smart appliances) and the AWS cloud over MQTT and HTTP. More information: http://aws.amazon.com/iot/. With this plugin, Waspmote sensor data can be directly integrated with Amazon AWS IoT broker.
  • Page 67 Meshlium treme Cloud Connectors 3. Create a security certificate and download the files for later use Figure : Save the credential files when connecting device -67- v7.1...
  • Page 68 Meshlium treme Cloud Connectors 4. Create and attach a policy 5. Copy the HTTPS connection string for later use Figure : Annotate the value of the field It is important to annotate the configuration displayed and save the credential files when connecting the device. You will need these files and parameters later for the Meshlium configuration.
  • Page 69 Meshlium treme Cloud Connectors 12.1.1.2. Configuration You will use the previously obtained configuration from the AWS IoT platform to certificate your Meshlium as a valid sender of MQTT messages. Amazon IoT plugin is located in: Manager System > Cloud Connector > IoT Platforms > Amazon Web Services In the Configuration panel, the user can set: •...
  • Page 70 Meshlium treme Cloud Connectors Figure : Amazon IoT configuration panel -70- v7.1...
  • Page 71: Esri

    Meshlium treme Cloud Connectors 12.1.1.3. Controlling synchronization Once configured the server/broker, the user can launch the Meshlium Amazon IoT script (Start button). The program will search for the received frames on the local database, and will send them to the Amazon IoT platform via MQTT protocol. The status indicator displays the current state, saying “Running”...
  • Page 72 Meshlium treme Cloud Connectors Figure : ArcGIS Online “Start” button Clicking on the “Stop” button will disable the Esri Cloud connector so Meshlium device stops feeding the ArcGIS Online service with data. Figure : ArcGIS Online “Stop” button 12.1.2.1.1. Check the Feature Server in ArcGIS Online In order to check that data is arriving to ArcGIS Online, you should login in the platform: https://www.arcgis.com/home/signin.html Click on the option named “Gallery”...
  • Page 73 Meshlium treme Cloud Connectors 12.1.2.2. Devices 12.1.2.2.1. Meshlium In the Meshlium section, the user can set and modify the name and description of the Meshlium. Figure : Meshlium info in ArcGIS 12.1.2.2.2. Waspmotes In the Waspmotes section, the user can manage the Waspmote units which are sending information to Meshlium. Figure : Waspmotes list in ArcGIS To add a new Waspmote, click on “Add new”.
  • Page 74 Meshlium treme Cloud Connectors 12.1.2.2.3. Devices location In the section Devices location, there is a viewer where the user can see Meshlium and Waspmote located on a map. Figure : Devices location in ArcGIS To change the location of the devices, center the map on the desired location, select the device, and click on “Set Position”. -74- v7.1...
  • Page 75: Ibm Bluemix

    Meshlium treme Cloud Connectors 12.1.3. IBM Bluemix IBM Bluemix is a cloud platform as a service (PaaS) developed by IBM that gives a wide scope of services to use the cloud, one of them is based on MQTT communications. This is a great alternative if the user do not want to build his own MQTT server. 12.1.3.1.
  • Page 76: Iot-Ticket

    Meshlium treme Cloud Connectors 12.1.4. IoT-Ticket IoT-Ticket is one of the world’s most complete, advanced and easy to use Industrial Internet of Things platforms with over 1.6 million users mainly in the energy and mobile machinery industry. Using IoT-Ticket you can build IoT applications in your web- browser in minutes, no plug-ins required.
  • Page 77 Cloud Connectors 12.1.4.1. IoT-Ticket Meshlium integration Once Libelium’s Cloud Connector has been configured, all your available data will show up automatically in your IoT-Ticket web- based dashboard / report designer from where you can easily design Internet of Things applications.
  • Page 78 Meshlium treme Cloud Connectors The Login Configuration section sets up the information for your IoT-Ticket account, and consists of four parts: • Service Owner/Key gives the username and password of the my.iot-ticket.com service account to which you wish to connect your Meshlium device. •...
  • Page 79 Meshlium treme Cloud Connectors 12.1.4.3. Validation of settings Configuration settings are validated to make sure the entered data fields make sense (e.g. numeric fields such as sleep and query size must be numbers). Additionally, the validation will issue warnings if any parameters might cause high system load on Meshlium.
  • Page 80: Synchronization Status

    Meshlium treme Cloud Connectors 12.1.4.5. Synchronization status This section allows the user to start and stop the connector and displays information about its current status. When the connector is off, the indicator marker is red. Figure : Start button After clicking ”Start”, the connector shows a startup sequence, and when finished the running status will be indicated by the status icon turning green.
  • Page 81: Microsoft Azure Event Hubs

    Meshlium treme Cloud Connectors You can now configure your own dashboard with sensor data and have it up and running in a matter of minutes. Figure : IoT-Ticket panel 12.1.5. Microsoft Azure Event Hubs Azure is a cloud platform provided by Microsoft. This platform has a lot of services to reach communication between machines and devices.
  • Page 82 Meshlium treme Cloud Connectors Figure : Create new Namespace 12.1.5.2. Setup in Azure - Creating an Event Hub In this section we will create an Event Hub that will receive our data from Meshlium. After we dive into the Service Bus we have previously created, we can see a menu on the top of the screen, then we should choose “Event Hubs”...
  • Page 83 Meshlium treme Cloud Connectors After clicking on this menu, a new screen will appear. At this point we can create a new event hub clicking on the bottom left icon labeled as New: Figure : Create a New Event Hub After click this button, a pop-up window raises above and you are now able to create an event hub, we are going to choose “quick create”...
  • Page 84 Meshlium treme Cloud Connectors You have created an Event hub for one day data retention, which means that your data will be kept one day.This method sets a partition section with value ‘4’ , which means the number of partitions the Event Hub may have. 12.1.5.3.
  • Page 85 Meshlium treme Cloud Connectors Finally, we will copy the information needed to connect the Event Hub connector. In order to do that, go to the “Dashboard” of the Event Hub and select “View Connection String”. Figure : Event Hub Dashboard Copy the “Connection String”...
  • Page 86 Meshlium treme Cloud Connectors We will extract the information needed to connect the Meshlium from the “Connection String”. You have to copy the NAMESPACE, the DIRECTIVE_NAME, the DIRECTIVE_KEY and the EVENTHUB_NAME from the string as the following example: N a m e s p a ce = E n d p o i nt = s b : / / NAMESPACE. s e r v i ce b u s. w i n d ows. n e t / ; S h a re d Acce s s K e y N a m e = DIREC TIVE_ NAME;SharedAccessKey=DIRECTIVE_KEY;EntityPath=EVENTHUB_NAME Note that the namespace is only a part of the string Endpoint, it does NOT include the “sb://”...
  • Page 87: Microsoft Azure Iot Hub

    Meshlium treme Cloud Connectors 12.1.5.5. Controlling synchronization Once you have saved the configuration, you can start sending your data via Event Hub to your Azure Cloud by pressing the “Start” button. You will notice about it because the screen shows a spinning wheel when the process starts and displays a “running”...
  • Page 88 Meshlium treme Cloud Connectors 12.1.6.1. Register Meshlium in Azure Portal To register Meshlium in Azure Portal, you have to follow the guide: Get started with Azure IoT Hub for Java: https://azure.microsoft.com/en-us/documentation/articles/iot-hub-java-java-getstarted/. The guide explains how to create an IoT Hub and a device entity. It is important to annotate the connection string generated after creating the device entity.
  • Page 89 Meshlium treme Cloud Connectors 12.1.6.2. Configuration You will use the previously obtained “connection string” from the Azure portal to certificate your Meshlium as a valid sender of messages. Microsoft Azure IoT Hub plugin is located in: Manager System > Cloud Connector > IoT Platforms > Azure IoT Cloud In the Configuration panel, the user can set: Connection String: Connection string previously copied.
  • Page 90: Mqtt

    Meshlium treme Cloud Connectors 12.1.6.3. Controlling synchronization Once configured the server/broker, the user can launch the Meshlium Microsoft Azure IoT Hub script (Start button). The program will send test messages to the Azure IoT Hub platform via the selected protocol. The status indicator displays the current state, saying “Running”...
  • Page 91 Meshlium treme Cloud Connectors 12.1.7.1. Configuration The broker is a key agent in MQTT protocol. The broker is a server which receives all the frames and distributes each one of them to the subscribers clients. MQTT plugin is located in: Manager System >...
  • Page 92 Meshlium treme Cloud Connectors Examples about MQTT Servers/Brokers: • http://mqtt.org/wiki/doku.php/brokers • http://mosquitto.org/ • http://mqtt.io/ Note: in this example, the broker was running on a computer inside our local network for test purposes only. For professional use, it is recommended to work with a 24/7 server with static IP address. 12.1.7.2.
  • Page 93: Riot Platform

    Meshlium treme Cloud Connectors 12.1.8. RIOT Platform RIOT is a Sensing as a Service Platform developed by REDtone IOT. It manages connectivity from sensors or data sources with various communication protocols including MQTT and RESTful. Please visit http://riot.com.my/ for more information. 12.1.8.1.
  • Page 94: Sensorup Iot Platform

    Meshlium treme Cloud Connectors 12.1.9. SensorUp IoT Platform SensorUp provides an open standard IoT platform that enables information from all different kinds of sensors accessible in a single platform. 12.1.9.1. Configuration You can access the SensorUp IoT platform plugin from the Cloud Connector menu, and setup all the information needed to connect Meshlium to the SensorUp IoT platform.
  • Page 95: Techedge Sap Hana

    Manage devices and their messages remotely through programming interfaces (API) 12.1.10.1. Configuring SAP HANA To make the connection between the platform and the SAP HCP Gateway Meshlium by Libelium, so we can receive the data sent from the gateway, a pre-configuration of Things Internet service is required.
  • Page 96 • between 100 and 200, these are the figures recommended by Libelium to ensure a high performance in the Gateway. After setting all fields described above, it is necessary to save the changes by clicking the “Save” button at the bottom of the configuration form.
  • Page 97: Telefónica Iot Platform

    Meshlium treme Cloud Connectors 12.1.11. Telefónica IoT Platform Telefónica provides an M2M cloud to collect and analyze data. This platform is based on assets and models and you can optimize your business processes implementing rules and notifications, and subscribing to data from different hosts. 12.1.11.1.
  • Page 98: Telit

    Cloud Connectors 12.1.12. Telit The Meshlium Cloud Connector for the Telit deviceWISE IoT Cloud platform is provided to connect Libelium Waspmote sensor devices to the Telit Cloud Platform. 12.1.12.1. Register in Telit The basic steps required to connect Waspmote sensors to the cloud platform are simple and straight forward: A) Using the Telit Management Portal at portal.telit.com...
  • Page 99 Meshlium treme Cloud Connectors Figure : Telit configuration options Where: • ‘Cloud Server URL’ specifies the target Telit IoT Cloud Platform. • ‘Meshlium Id’ indicates the unique name that you would like your Meshlium Gateway to be known as in the Telit IoT Cloud Platform.
  • Page 100 Meshlium treme Cloud Connectors Figure : Save configuration button At this point the Meshlium Cloud Connector is configured and ready to start. 12.1.12.3. Controlling synchronization Once the Telit deviceWISE IoT Cloud Connector has been configured with the proper runtime parameters, it is ready for operation. To initiate the connection from the Meshlium gateway to the Telit IoT Cloud Platform and start the background service awaiting data frames from Waspmote sensor device nodes, press the Start button.
  • Page 101 Meshlium treme Cloud Connectors To stop the background service from awaiting data frames from Waspmote sensor device nodes and terminate the connection from the Meshlium gateway to the Telit IoT Cloud Platform, press the Stop button. Figure : Telit Stop button -101- v7.1...
  • Page 102: Thingworx

    Meshlium treme Cloud Connectors 12.1.13. ThingWorx ThingWorx is the first software platform designed to build and run the applications of the connected world. ThingWorx reduces the time, cost, and risk required to build innovative Machine-to-Machine (M2M) and Internet of Things applications by providing a complete application design, runtime, and intelligence environment.
  • Page 103 Meshlium treme Cloud Connectors The parameters to setup are: • Server address: The address of your ThingWorx server. Server Port: The port where your ThingWorx server is accessible. • Meshlium bind name: The name of the Meshlium “thing” in ThingWorx. Meshlium thing is detected in ThingWorx but will •...
  • Page 104 Meshlium treme Cloud Connectors • Once the list is correct, clicking on the button “Write ThingWorx setup” will push this setup to the ThingWorx EMS service. Figure : Write the setup to ThingWorx service After restarting the EMS and LUA Script services, the setup will be applied and you will see your devices in your ThingWorx server.
  • Page 105 Meshlium treme Cloud Connectors 12.1.13.2. Using the Edge MicroServer (EMS) ThingWorx has the ability to connect very quickly and easily to the physical world and structured data systems. ThingWorx supports a variety of communication protocols and system interfaces. Many are implemented directly on the ThingWorx Platform.
  • Page 106: Iot Solutions

    Meshlium treme Cloud Connectors 12.2. IoT Solutions 12.2.1. Amplía’s OpenGate 12.2.1.1. Configuration Inside the Amplía’s plugin you can find the different fields that you must configure for using your Meshlium against OpenGate. Figure : Amplía Cloud Connector configuration panel Server Host: You must enter the host name that you are going to use for collecting the Meshlium events. •...
  • Page 107: Basen

    Meshlium treme Cloud Connectors 12.2.2. BaseN Follow this short instruction to get Meshlium synchronized to BaseN Platform running. This guide assumes that you are already a customer of BaseN and have access to your BaseN admin wiki. 12.2.2.1. Configuring Microagent receiver in the BaseN Platform In your chosen wiki page, configure the following minimum setup for synchronizing with the BaseN Platform.
  • Page 108 Meshlium treme Cloud Connectors BASEN_URL: Usually • http://customername.basen.com/_ua/customername/ • BASEN_ID: Unique ID of this Microagent receiver BASEN_USER: Username to authenticate the Microagent receiver • BASEN_PASSWORD: Password to authenticate the Microagent receiver • After setting the parameters, save the configuration clicking on the “Save” icon. 12.2.2.3.
  • Page 109: B-Scada

    Meshlium treme Cloud Connectors 12.2.3. B-Scada B-Scada® VoT platform allows you to create rich, sophisticated IoT and M2M applications that consolidate and organize data from anywhere, and visualize it in real-time on any device. Connect to thousands of potential data sources. Visualize your data using modern, high-performance customized graphics.
  • Page 110 Meshlium treme Cloud Connectors 12.2.3.2. Controlling synchronization The synchronization will be done for all data that has not been synchronized in the Sensor Parser table each time. You can start and stop the data synchronization to the VoT service. In the interface you can see an indicator of whether the status service is running or not.
  • Page 111: Cumulocity

    Meshlium treme Cloud Connectors 12.2.4. Cumulocity Cumulocity IoT solution allows for a seamless integration of your Meshlium and Waspmote devices to the cloud. Once Meshlium is connected to this cloud, the Cumulocity IoT solution will automatically manage all your devices. Registering and gathering device data to Cumulocity Platform provides a fully customizable interface, allowing for deep data analysis.
  • Page 112: Devicelynk

    Meshlium treme Cloud Connectors 12.2.5. DeviceLynk DeviceLynk is a high-level cloud service based on the ThingWorx cloud. Interface walk-through: Interface Feature Description DeviceLynk logo Click to jump to the DeviceLynk website. Server Address The DeviceLynk Server address you wish to connect to.
  • Page 113 Meshlium treme Cloud Connectors Interface Feature Description LUA Script Resource Status The status of the LUA Script Resource will be indicated, displaying “Running” or “Stopped”. Start/Stop Service Toggle button Click to start/stop the service that this button is next to. Steps to start the DeviceLynk plugin: •...
  • Page 114: Devicify

    ThingWorx server. These two sides of the solution are seamlessly unified as a cohesive application leveraging a common Account and Device model. Devicify’s integration with Libelium is meant to help Libelium users easily sync their sensor data into their Devicify CPM platform, allowing for seamless integration between their Libelium sensor network, ThingWorx, and Salesforce.
  • Page 115 Meshlium treme Cloud Connectors 12.2.6.2. Controlling synchronization Clicking the start button will begin the sync process. Sensor data entries will be synced at the interval designated in the configuration section. If there are more than 100 non-synced entries at the start of any sync process, the Devicify plugin will continuously sync in “batches”...
  • Page 116: Eagle.io

    Meshlium treme Cloud Connectors 12.2.7. eagle.io eagle.io is a hub connecting monitoring assets, engineers and decision makers. Acquire data in real-time from Meshlium and Waspmote devices, receive alerts for critical events, and share access with stakeholders. Transform your time-series data into beautifully presented, actionable information.
  • Page 117: Elementblue - Rightsensor

    Meshlium treme Cloud Connectors 12.2.8. ElementBlue – RightSensor RightSensor is a solution company designed to provide sensors, services and support for Industrial Internet of Things projects. Figure : ElementBlue RightSensor Cloud The RightSensor cloud connects interface works directly with Element Blue’s SensorInsight® Industrial Internet of Things Platform.
  • Page 118: Ensura

    Meshlium treme Cloud Connectors The form accepts the following 4 parameters: • Client ID: This is a unique ID provided to you from the SensorInsight service. Gateway ID: This is an ID you provide to uniquely identify this Meshlium device. •...
  • Page 119 Meshlium treme Cloud Connectors 12.2.9.1. Configuration Figure : Configuring Ensura in Meshlium • Server: The IP address or the URL of your Ensura Sensor Server Port: The port number on which the Ensura Sensor Server is listening for connections • Client Key: The identifier that the Ensura Sensor Server is configured to accept information from •...
  • Page 120: Extunda

    Cloud Connectors 12.2.10. Extunda Extunda IoT platform (http://www.extunda.com/) is a horizontal platform which also enables vertical applications. Libelium Smart Cities, agriculture and various devices are ready to be launched for service over Extunda IoT platform. The sensor data can be gathered, analyzed, stored and reported so the users can interpret and develop actions based on online data.
  • Page 121: Iotsens

    Meshlium treme Cloud Connectors 12.2.11. IoTSens IoTSens (http://www.iotsens.com/) is a horizontal platform for the development of smart cities which provides functionalities for gathering, integrating, storing and analyzing data from the city from a global point of view, so managers and citizens know what is happening and can immediately act.
  • Page 122: Kii

    Meshlium treme Cloud Connectors 12.2.12. Kii 12.2.12.1. Introduction Kii Cloud is an MBaaS (Mobile Backend as a Service) and an IoT (Internet of Things) cloud platform provided by Kii Corporation. Kii offers a cloud service that provides various server-side functions as versatile APIs for mobile apps and IoT solutions. By leveraging these APIs, the user can provide services making mobile apps and things Internet-ready without the server-side implementations and operations.
  • Page 123 Meshlium treme Cloud Connectors Then fill in the fields as follows: Server Location: Enter server location of your app (either US, JP, EU, CN3 or SG) created at developer.kii.com. For more info • on creating an app see this page. App ID: Enter the App Id of your app created at developer.kii.com.
  • Page 124: Nexmachina

    Meshlium treme Cloud Connectors 12.2.13. Nexmachina 12.2.13.1. What is iQmenic? iQmenic is a cloud solution for the Internet of Things created by Nexmachina. Characteristics: • Simple and practical • Multi-language • Multi-device • Multi-user Features: • Monitoring devices and sensors •...
  • Page 125 Meshlium treme Cloud Connectors Figure : Graphic data from sensors 12.2.13.2. Meshlium cloud connection to iQmenic If you want to connect your Meshlium with iQmenic, follow these steps: • 1. Contact Nexmachina. We will provide you a URL, User and Password for your iQmenic platform as well as the configuration parameters for connecting your Meshlium to iQmenic.
  • Page 126: Orchestra

    For getting your own API-key you have to send a mail to services@orchestra.it with the subject “[ Libelium – Activation ] New activation request”, signaling the number of sensors and the numbers of venues or Meshliums being used, and Orchestra will provide the account to access the platform where you can get the needed information.
  • Page 127 Meshlium treme Cloud Connectors To activate the API secret key and get the client Id, you have to go to the “Profile” section of the Orchestra account and then select the checkbox in the “Orchestra API” section and click the “Generate key” button. Then you have to save the information generated by clicking on the “Save”...
  • Page 128 Meshlium treme Cloud Connectors Once you click the “Save” button, a select box will appear with the venues you can choose. Figure : Orchestra Cloud Connector configuration panel After that, press the “Start” button, and you will start to receive data from the configured Meshlium. If you want to stop the event sending, just press the “Stop”...
  • Page 129: Sentilo

    Meshlium treme Cloud Connectors 12.2.15. Sentilo Sentilo is an open source sensor and actuator platform designed to fit in the Smart City architecture of any city who looks for openness and easy interoperability. It is built, used, and supported by an active and diverse community of cities and companies that believe that using open standards and free software is the first smart decision a Smart City should take.
  • Page 130: Simfony

    Meshlium treme Cloud Connectors 12.2.16. Simfony Simfony’s IoT Platform is focused on providing the core set of tools that enables the rapid roll-out of any IoT project or service. Companies can use the service to easily and rapidly design, prototype and deploy IoT projects that match their exact needs and requirements, rather than looking for an off the shelf product that fits best.
  • Page 131: Advanced Configuration

    Meshlium treme Cloud Connectors All the data retrieved automatically from the Cloud can also be entered manually. The user must use the Save button to save any newly configured data or apply any changes to it. 12.2.16.2. Advanced configuration The advanced configuration window of the Connector allows the setting of the following parameters: •...
  • Page 132 Meshlium treme Cloud Connectors 12.2.16.3. Running the connector After the entire configuration is complete, the user can start the connector using the “Start” button of the GUI. The Connector will be started and run seamlessly in background. Figure : Simfony start button The Status box will show the Connector’s state whenever the page is viewed by the user.
  • Page 133: Smartcityplatform

    Meshlium treme Cloud Connectors 12.2.17. SmartCityPlatform The SmartCityPlatform connects all the core elements of a successfully managed city. It allows the SmartMayor to manage urban development, socio-economic development and technological development of the city, measuring and reporting progress in real time. By using this cloud connector, you connect to the Sense module, which is a part of SmartCityPlatform.
  • Page 134 Meshlium treme Cloud Connectors 12.2.17.2. Controlling synchronization With the configuration saved, you can start using the cloud connector. To start the synchronization, press the green “Start” button on the right. Figure : SmartCityPlatform start button You get a “loading” status inside the synchronization control section, indicating the synchronization is starting. Figure : SmartCityPlatform loading button When the cloud connector starts, a green dot on the left appears, indicating the synchronization is running.
  • Page 135: Smartplants

    Meshlium treme Cloud Connectors 12.2.18. SmartPlants Smartplants Cloud integration enables secure communications between the devices connected to the Meshlium device and the cloud. Smartplants plugin is located in: Manager System > Cloud Connector > IoT Solutions > Smartplants 12.2.18.1. Configuration You will receive the configuration information that is required to connect your Meshlium to the SmartPlants system via an e-mail from Smartplants.
  • Page 136: Sofia2

    Meshlium treme Cloud Connectors 12.2.19. Sofia2 Sofia2 is a middleware developed by Indra that allows the interoperability of multiple systems and devices, offering a semantic platform to make real world information available to smart applications (Internet of Things). It is multi-language and multi-protocol, enabling the interconnection of heterogeneous devices. It provides publishing and subscription mechanisms, facilitating the orchestration of sensors and actuators in order to monitor and act on the environment.
  • Page 137 Meshlium treme Cloud Connectors 12.2.19.2. Register Meshlium in Sofia2 To register Meshlium in Sofia2, click on the link Get Configuration From Sofia2. Figure : Sofia2 configuration link You will be redirected to the following page: Figure : Sofia2 configuration portal Where: •...
  • Page 138 Meshlium treme Cloud Connectors Logging in Sofia2 platform will redirect to the following page that suggests a name for your collections of measures and monitoring data, and for your gateway identifier (KP in Sofia2 terms): Figure : Sofia2 configuration information Finally, after creating the configuration, you will obtain a JSON file containing all configuration values ready to be pasted on the Manager System, in order to setup the Sofia2 Cloud Connector: Figure : Sofia2 JSON configuration...
  • Page 139 Meshlium treme Cloud Connectors 12.2.19.3. Configure the Cloud connector The configuration from Sofia2 can be setup in Meshlium just by clicking Paste configuration received from Sofia2 and pasting the JSON generated in the previous step. Figure : Sofia2 pasting JSON configuration Configuring the plugin this way, the fields for Measures Ontology, Monitoring Ontology, Client Name, Client Identifier and Authentication Token will be completed.
  • Page 140 Meshlium treme Cloud Connectors 12.2.19.4.2. MQTT MQTT is a stateful communication protocol over TCP. Using this protocol, the Cloud Connector is a client of the Sofia2 platform, that initially opens a connection with the platform, maintains it alive during that time, and periodically sends an MQTT packet containing the sensor measurements.
  • Page 141 Meshlium treme Cloud Connectors 12.2.19.5. Save the configuration and start the connector Once all configuration and connection parameters are setup, they can be stored and the connector can be started to send information to Sofia2. To save the configuration, click on the “Save” button: Figure : Sofia2 save configuration button After saving the configuration, the Cloud Connector can be started by clicking on the “Start”...
  • Page 142: Thingplus

    Meshlium treme Cloud Connectors 12.2.20. ThingPlus Thing+ allows customers to build their own IoT services with high speed, reliability, scalability, and cost competitiveness, connected by a SaaS or PaaS IoT platform. When Thing+ Embedded devices connect to the Thing+ Cloud (public or private), customers can visualize various data graphs and charts from sensors directly on the Thing+ Portal.
  • Page 143 Meshlium treme Cloud Connectors • Fill form Gateway ID Select “API Key” (Authentication Type) • Click “Get API Key” • Copy the “API Key” Figure : Get the API Key in the ThingPlus panel • Set “API Key” in the Meshlium Manager System Go to ThingPlus configuration again Paste the “API Key”...
  • Page 144 Click the + button in the upper right corner • Fill the form: Select Gateway Model as “Libelium Meshlium” Input Gateway ID (the same MAC address when registering gateway) Select Device Model as “Waspmote Basic” Input Device Address (Waspmote address is the id_wasp field)
  • Page 145: Smartphone Detection

    Meshlium treme Smartphone detection 13. Smartphone detection Meshlium 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 a specific Access Point, enabling the detection of any smartphone, laptop or hands-free car kit device which comes into the coverage area of Meshlium.
  • Page 146 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) •...
  • Page 147: Devices Detected

    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. Figure : Calculate the average speed 13.1. Devices detected Figure : Devices detection -147- v7.1...
  • Page 148 Meshlium treme Smartphone detection Detection includes any of the last models even those that implement low consumption techniques when using the radio interfaces: • • iPhone (*all models*): 4, 4S, 5, 5S, 5C, iPad (2, 3, 4, Air, Mini, Retina) •...
  • Page 149 Meshlium treme Smartphone detection For Vehicle Traffic Monitoring applications, it is recommended to purchase the special pack of 2 directional antennas which will extend the range of WiFi and Bluetooth scanning in the required direction. The size of one antenna is 40 x 36 x 4 cm. Each one weights about 2 kg.
  • Page 150 Meshlium treme Smartphone detection Figure : Bluetooth, WiFi and ZigBee radios coexist Under which conditions do you get a 95% detection rate of devices? A set of conditions must be respected to keep the detection rate high. The devices to be detected must be some meters away from the Scanner and must remain some seconds inside the coverage area to give time to the system to detect them.
  • Page 151 Meshlium treme Smartphone detection Our tests results are shown in these tables: Android: Screen OFF Screen OFF Screen ON (power saving off) (power saving on) WiFi radio OFF WiFi radio ON (not connected to an AP) (almost every scan cycle) (most of scan cycle) WiFi radio ON (connected to an AP)
  • Page 152: Wifi Scanner

    Bluetooth device in his car can be detected as 2 different users by Meshlium. To sum up, in Libelium we consider that the total number of people can be approximated multiplying the number of detected devices by a factor, from 3 or 5: 3*Detected devices <...
  • Page 153 Meshlium treme Smartphone detection Figure : Configuring WiFi Scanner We can also activate the anonymization of the MAC addresses. This option will store the MAC address encoded with an MD5 hash. The hash will be consistent in the same day, but will change from one day to another. This system allows to follow a particular user in the same day, but keeps the privacy of the user, not storing the real MAC of the device and not allowing to track a user more than one day.
  • Page 154 Meshlium treme Smartphone detection It is possible to perform two different storage options with the data captured: • Local database. This is always used. • External database The data is synchronized to an external database from the local database. Figure : WiFi Scanner data storing -154- v7.1...
  • Page 155: Local Database

    Meshlium treme Smartphone detection 13.2.2. Local database 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 156: External Database

    Meshlium treme Smartphone detection 13.2.3. External database Meshlium can synchronize all the WiFi devices information stored in the local database to an external MySQL database managed by the user. Figure : External database tab In this tab the user can: •...
  • Page 157 Meshlium treme Smartphone detection Figure : SQL script • Enter the connection settings and press “Save” button. You can check the connection now to ensure the settings are correct. • Enable the service with the checkbox and save. The synchronization service runs every 60 seconds and synchronizes up to 200 data every loop. The service synchronizes first newer data, as it is more relevant for decision making.
  • Page 158: Bluetooth Scanner

    Meshlium treme Smartphone detection 13.3. Bluetooth Scanner 13.3.1. Concepts This Bluetooth radio integrated in Meshlium Scanner 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 159 Meshlium treme Smartphone detection If the user manually stops the service, it will be automatically relaunched upon reboot. In order to completely disable service, the user have to click on the slider “Disable Service”. This will stop the service and avoid it to run upon reboot. Setup cannot be changed when disabled, but already stored data is available to be shown.
  • Page 160: Local Database

    Meshlium treme Smartphone detection 13.3.2. Local database Meshlium has a MySQL database 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 Table: bluetoothData •...
  • Page 161: External Database

    Meshlium treme Smartphone detection 13.3.3. External database Meshlium can synchronize all the WiFi devices information stored in the local database to an external MySQL database managed by the user. Figure : External database tab In this tab the user can: •...
  • Page 162 Meshlium treme Smartphone detection Figure : SQL script • Enter the connection settings and press “Save” button. You can check the connection now to ensure the settings are correct. • Enable the service with the checkbox and save. The synchronization service runs every 60 seconds and synchronizes up to 200 data every loop. The service synchronizes first newer data, as it is more relevant for decision making.
  • Page 163: Tools

    Meshlium treme Tools 14. Tools 14.1. Fresnel calculator The Fresnel Zone is the space which should be empty of objects in a wireless transmission between two points to get the maximum throughput and transmission quality. Here you can find a tool in order to calculate when choosing the right points for your nodes.
  • Page 164: Ping

    Meshlium treme Tools 14.3. Ping It lets you test if you can reach a certain IP or Hostname through a specific network Interface: Ethernet (IPv4), Ethernet (IPv6), WiFi AP, and 4G/LTE. Figure : Ping plugin Meshlium can also perform this test over IPv6 on Ethernet interface. Figure : IPv6 ping -164- v7.1...
  • Page 165: Traceroute

    Meshlium treme Tools 14.4. Traceroute Another interesting tool to discover the path of the communication between Meshlium and the selected host. Figure : Traceroute plugin Meshlium can also perform this test over the Ethernet (IPv6) interface. 14.5. Netstat Discover which connections IPv4-Port (tcp), and IPv6-Port (tcp6) are active. Figure : Netstat information -165- v7.1...
  • Page 166: Gps

    Meshlium treme Tools 14.6. GPS 14.6.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 167 Meshlium treme Tools The GPS service can be enabled or disabled. If the user disables the service the service will be stopped and will not be launched when Meshlium is powered on. In addition, setup will be blocked and cannot be changed. When the service is disabled no GPS information will be read or stored.
  • Page 168: Local Database

    Meshlium treme Tools 14.6.3. Local database Meshlium has a MySQL database up and running which is used to store locally the information captured. In the “Local Data Base” tab you can see the connection parameters. A service in Meshlium will read periodically the GPS to gather location and will store it in the local database. •...
  • Page 169: External Database

    Meshlium treme Tools 14.6.4. External database Meshlium can synchronize all the WiFi devices information stored in the local database to an external MySQL database managed by the user. Figure : External database tab In this tab the user can: • Setup the parameters of the external database and check the connection.
  • Page 170: Beep

    Meshlium treme Tools Figure : SQL script • Enter the connection settings and press “Save” button. You can check the connection now to ensure the settings are correct. • Enable the service with the checkbox and save. The synchronization service runs every 60 seconds and synchronizes up to 200 data every loop. The service synchronizes first newer data, as it is more relevant for decision making.
  • Page 171: Database Management

    Meshlium treme Database management 15. Database management 15.1. Direct access In order to access to the Meshlium Database from an external application you have to use the next parameters: • WiFi: 10.10.10.1 Ethernet: Depending on your DHCP server (You can specify a static IP in the Interfaces section). 192.168.1.100 (if there is no DHCP server).
  • Page 172 Meshlium treme Database management Figure : phpMyAdmin panel -172- v7.1...
  • Page 173: System Information

    Meshlium treme System Information 16. System Information 16.1. Hostname This plugin allow the user to change the hostname of the gateway. By default the name is “meshliumXXXX” where XXXX are the last four digits of Ethernet MAC address. To change the hostname, enter the desired value and press “Save and Apply” button. Figure : Hostname change form 16.2.
  • Page 174: Disk Usage

    Meshlium treme System Information 16.3. Disk usage This plugin offers a graphical board to see the amount of disk being used in each partition. The most important partition is /dev/sda2 which is mounted in the “/mnt/user” folder. All the data captured (XBee, Scanner, GPS) is stored in this partition.
  • Page 175: Time Synchronization

    Meshlium treme System Information 16.5. Time synchronization In order to store correctly in the file system and in the local database the data captured from the RF modules and scanner is important to previously set the system time. Figure : Time Synchronization plugin The plugin allow the user to set the time, manually selecting the time from the selectors and setting the timezone.
  • Page 176: Upgrading Meshlium

    17.1. Checking for updates In order to use this feature Meshlium needs to be connected to the Internet and with access to Libelium web page. Given so, press the “Check for updates” button to access the Libelium repository and search for new versions.
  • Page 177: Local File

    Some updates can download big files from the Internet instead of packing them inside the update file. Ask Libelium support for complete update files if this is stated in the update log.
  • Page 178: Url

    Meshlium treme Upgrading Meshlium 17.3. URL Update files can be side loaded trough an URL. Enter the URL of the update file in the form and press “Download” button. The system will download the file and check if it is a valid update. Figure : Enter the URL of the file If so, it will show the file and the “Install Update”...
  • Page 179: Rescue System

    18.1. Rescue steps You will need a USB pen drive of at least 8 GB. The first thing to do is download from the website of Libelium the image file “meshliumrescue.iso” needed to restore Meshlium to factory defaults. Note: You need to contact first our Technical Service Department in order to get the user and password and URL to download the image.
  • Page 180 Meshlium treme Rescue System To create the rescue you have to: Start unetbootin and select the option “Diskimage” • • Select the iso of the rescue image in the file selector • Select the USB unit where the image will be written •...
  • Page 181: Expansion Port

    Meshlium treme Expansion port 19. Expansion port Meshlium includes an expansion port with some extra connectivity options. It includes access to a UART, an I2C bus and a USB port. This port is available for development purposes. Figure : Meshlium expansion port -181- v7.1...
  • Page 182: Manager System Changelog

    Meshlium treme Manager System changelog 20. Manager System changelog Version 4.0.1 • Add new cloud connectors: Cumulocity Nexmachina RedTone SmartPlants TechEdge(SAP) Version 4.0.0 • Network setup reviewed • Added “disable/enable” control to main services • Added compatibility with several radio modules •...
  • Page 183: Documentation Changelog

    Meshlium treme Documentation changelog 21. Documentation changelog From v7.0 to v7.1 • Add new cloud connectors: BaseN, Cumulocity, Ensura, Kii, Orchestra, Microsoft Azure IoT Hub, Nexmachina, RedTone, SensorUP, SmartCityPlatform, SmartPlants, TechEdge SAP HANA, Telit. • Update cloud connectors: Amazon IoT, Microsoft Azure Event Hubs, MQTT, Sentilo. •...
  • Page 184: Certifications

    Meshlium treme Certifications 22. Certifications 22.1. General overview Products Europe Canada Australia Brazil Meshlium 4G 802.15.4 AP 868 EU Meshlium 4G 802.15.4 AP 900 US FCC / PTCRB / AT&T Meshlium 4G 802.15.4 AP 900 AU Meshlium 4G 802.15.4 AP 900 BR ANATEL 22.2.
  • Page 185: Fcc (Usa)

    Meshlium treme Certifications 22.3. FCC (USA) This document applies to the following Meshlium models: Model FCC ID Meshlium 4G 802.15.4 AP 900 US XKM-MESHLIUM-V1 Compliance with regulations: • Electromagnetic Compatibility: FCC Part 15B ed.10.1.13 • Radiofrequency (radiated spurious): FCC Part 15.247 (2013) + CFR 47 Part 15.247 (2013) + FCC Part 22 (2014) + FCC Part 24 (2014) + FCC Part 27 (2014) PTCRB compliance: •...
  • Page 186: Ic (Canada)

    Meshlium treme Certifications 22.4. IC (Canada) This document applies to the following Meshlium models: Model IC ID Meshlium 4G 802.15.4 AP 900 US 8472A-MESHLIUMV1 Figure : Back sticker for Meshlium 4G 802.15.4 AP 900 US 22.5. ANATEL (Brazil) Figure : Back sticker for Meshlium 4G 802.15.4 AP 900 BR 22.6.
  • Page 187: Maintenance

    Meshlium treme Maintenance 23. Maintenance • Although Meshlium is a highly resistant product (IP65), please handle with care in order to enjoy a longer life of the product. • Handle Meshlium with care, do not allow it to drop or move roughly. •...
  • Page 188: Disposal And Recycling

    Meshlium treme Disposal and recycling 24. 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. •...

Table of Contents