1. Manuals
  2. Brands
  3. Libelium Manuals
  4. Gateway
  5. Meshlium Xtreme
  6. Technical manual

Libelium Meshlium Xtreme Technical Manual

Hide thumbs Also See for Meshlium Xtreme:
Table of Contents

Advertisement

Quick Links

Download this manual

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

Related Manuals for Libelium Meshlium Xtreme

Summary of Contents for Libelium Meshlium Xtreme

  • Page 2: Table Of Contents

    Meshlium treme Index Document version: v7.3 - 07/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.5. Proxy setup ............................40 9.6. No-IP setup ............................41 10. Wireless Sensor Networks ....................43 10.1. Meshlium and Waspmote ......................43 10.2. Receiving and storing data ......................44 10.2.1. Receiving trough RF communications ................44 10.2.2. Receiving trough 4G / WiFi / Ethernet (HTTP) ..............51 10.3.
  • Page 4 Meshlium treme 12.3.7. Ensura ..........................125 12.3.8. Ericsson AppIoT ......................126 12.3.9. Esri ........................... 129 12.3.10. Extunda ......................... 133 12.3.11. HaibuSmart ........................134 12.3.12. infiswift .......................... 135 12.3.13. IoT-Ticket ........................137 12.3.14. IoTSens .......................... 143 12.3.15. Kii ........................... 144 12.3.16. Labeeb ........................... 147 12.3.17.
  • Page 5 Meshlium treme 15.6.3. Local database ........................ 193 15.6.4. External database ......................194 15.7. Beep .............................. 195 16. Database management ....................196 16.1. Direct access ..........................196 16.2. PhpMyAdmin ..........................196 17. System Information ......................198 17.1. Hostname ............................ 198 17.2. Password management ......................198 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 devicify Eagle.io ElementBlue Extunda IoTSens Sentilo Sofia2 Solvver Thing+ Compatibility with other software: Software Compatible Notes External DB synchronization of Some changes in the tables needed, can be sensor data. done without losing 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. The XBee-PRO 900HP modules are certified for use in multiple countries: Brazil, Australia, US.
  • Page 12 Meshlium treme Meshlium v4.0 vs Meshlium v3.5 Features [Old] 3G (SIM5215) [New] 4G (LE910) Download max 384 kbps 100 Mbps speed Upload max speed 384 kbps 50 Mbps Antenna diversity Any + Specially tested with AT&T, SK Telecom, Telstra, NTT Cellular carriers DoCoMo or KDDi -12-...

  • 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.3...

  • Page 15: Specifications

    60 s services running AC-220 V (DC-12 V) Types of power supply* Linux, Debian based Figure: Meshlium unit Meshlium Manager System Management software (open source) Authentication WEP, WPA, WPA2, Security HTTPS (*) Only with the accessories supplied by Libelium -15- v7.3...
  • 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 4G, LTE, 3G, WCDMA, HSPA, UMTS, GPRS, Protocols 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...

  • Page 18: 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): 1. Unscrew the Ethernet connector cap in Meshlium.
  • Page 19 Meshlium treme How to use Meshlium Figure: Connecting LAN cable to a PC 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: External Sim Socket

    Meshlium treme How to use Meshlium 6.2. External SIM socket The External SIM socket is composed of 2 connectors: micro-SIM card • micro-USB (type B) • Figure: External SIM socket in a Meshlium with 4G/3G/GPRS/GSM module 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.

  • Page 21: How To Install The Antennas

    Meshlium treme How to use Meshlium It is very important to turn off Meshlium in a secure way before inserting a micro-SIM card, or removing an existing SIM card. The user can damage the device if this operation is done with the device on. Make sure the External SIM socket is closed with its protection cap tightly screwed before an outdoors deployment.

  • Page 22: Installation Of The Ip65 Ethernet Cable

    Meshlium treme How to use Meshlium 6.4. Installation of the IP65 Ethernet cable Installation of the IP65 cap: In order to install the IP65 cap you will need a connector-free RJ45 cable. This cable is NOT included in the Meshlium box.
  • Page 23 Meshlium treme How to use Meshlium 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 6. Partially screw part D to the end. •...
  • Page 24 Meshlium treme How to use Meshlium 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 2.

  • Page 25: 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: 1.

  • Page 26: 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. 6.7. Setting the time In order to get all the data stored in the Meshlium local database with the right timestamp, you must adjust the System time.

  • Page 27: Understanding Meshlium

    • * 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 28: Storage

    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 -28- v7.3...
  • Page 29 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.

  • Page 30: 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 -30- v7.3...
  • Page 31 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 • -31- v7.3...

  • Page 32: 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 33 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 34 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 -34- v7.3...

  • Page 35: 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 36 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. Channel.

  • Page 37: 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 38: 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 39: 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.

  • Page 40: 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 41: No-Ip Setup

    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.
  • Page 42 Meshlium treme Network interfaces setup Please, refer to the interface configuration section to use a proxy. Figure: NoIP enable control Figure: NoIP disable control -42- v7.3...

  • Page 43: Wireless Sensor Networks

    WiFi, 4G or XBee among others. 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 44: 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 45 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. Channel: Frequency channel used for transmissions.
  • Page 46 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 •...
  • Page 47 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 •...
  • Page 48 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 49 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 50 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 -50- v7.3...

  • Page 51: 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: receive frames from 4G/3G/GPRS/GSM, WiFi or Ethernet via HTTP •...
  • Page 52 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 -52- v7.3...

  • Page 53: 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 54: 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 55 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 56 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 •...

  • Page 57: 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.
  • Page 58 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: Remove synchronized data.

  • Page 59: 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 • The “Delete logs”...

  • Page 60: 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 61: 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 62 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 63: 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 64 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 -64- v7.3...
  • Page 65 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 66: Cloud Connectors

    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 67 Meshlium treme Cloud Connectors Figure: Cloud Connector main menu on the Manager System -67- v7.3...

  • Page 68: Premium Cloud Partners

    Meshlium treme Cloud Connectors 12.1. Premium Cloud Partners 12.1.1. Arrow 12.1.1.1. Arrow Connect IoT Cloud Platform Arrow Connect is a software solution that plumbs the data from the edge to the cloud. Developed by Arrow Electronics and designed with security, scale, flexibility, device management, open APIs and extensibility as core tenants enabling broad use cases across multiple industries.
  • Page 69 Meshlium treme Cloud Connectors With the developer account, you have a private application instance with full admin access. Upon logging in, click on Administration > Access Keys, then click on the Master Key. You can save the “Client Encrypted API Key” and “Client Encrypted Secret Key”...
  • Page 70 Meshlium treme Cloud Connectors All the default configuration values should be appropriate and you do not need to change them. Click on the “Save” button for storing the configuration fields. API URL • MQTT URL • Encrypted API Key • Encrypted Secret Key •...
  • Page 71 Meshlium treme Cloud Connectors While the program is running, log on to the Arrow Connect portal to check that the Meshlium and Waspmotes have been properly registered and are sending telemetry data. See some example screen-shots below: Figure: Arrow gateways display Figure: Arrow Meshlium display -71- v7.3...
  • Page 72 Meshlium treme Cloud Connectors Figure: Arrow Waspmote display -72- v7.3...

  • Page 73: Ibm Bluemix

    Meshlium treme Cloud Connectors 12.1.2. 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.

  • Page 74: Microsoft Azure Event Hubs

    Meshlium treme Cloud Connectors 12.1.3. 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. This section focuses on Event Hubs, we can refer this technology as a way to send short messages via HTTP REST request.
  • Page 75 Meshlium treme Cloud Connectors 12.1.3.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” and “Create a New Event Hub”: Figure: Create New Event Hub Figure: After clicking on this menu, a new screen will appear.
  • Page 76 Meshlium treme Cloud Connectors Type your event hub name and click “Create a new event hub” button to finish the configuration process. Figure: Type the new Event Hub name 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.
  • Page 77 Meshlium treme Cloud Connectors Figure: Configure the Event Permissions 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 -77- v7.3...
  • Page 78 Meshlium treme Cloud Connectors Copy the “Connection String” that appears in the screen. Figure: Connection String 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: Namespace=Endpoint=sb://NAMESPACE.servicebus.windows.net/;SharedAccessKeyName=DIRECTIVE_ NAME;SharedAccessKey=DIRECTIVE_KEY;EntityPath=EVENTHUB_NAME...
  • Page 79 Meshlium treme Cloud Connectors 12.1.3.4. Configuration As result of previous steps, we should have a namespace, a directive name, a directive key and an event hub name. These are the main properties we should set in the Manager System to configure an Event Hub connection. Now we can access the Meshlium Manager and fulfill the Azure Event Hub fields with the previously obtained configuration.
  • Page 80 Meshlium treme Cloud Connectors 12.1.3.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 81: Microsoft Azure Iot Hub

    Meshlium treme Cloud Connectors 12.1.4. Microsoft Azure IoT Hub Azure IoT Hub is a fully managed service that enables reliable and secure bi-directional communications between millions of Internet of Things (IoT) devices and a solution back end. One of the biggest challenges that IoT projects face is how to reliably and securely connect devices to the solution back end.
  • Page 82 Meshlium treme Cloud Connectors 12.1.4.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 83 Meshlium treme Cloud Connectors 12.1.4.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 84 Meshlium treme Cloud Connectors 12.1.4.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 85: Nexmachina

    Meshlium treme Cloud Connectors 12.1.5. Nexmachina 12.1.5.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 • Display data •...
  • Page 86 Meshlium treme Cloud Connectors Figure: Graphic data from sensors 12.1.5.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 •...

  • Page 87: Elementblue - Rightsensor

    Meshlium treme Cloud Connectors 12.1.6. 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 88 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 89: Sofia2

    Meshlium treme Cloud Connectors 12.1.7. 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 90 Meshlium treme Cloud Connectors 12.1.7.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: Login using your Sofia2 account. •...
  • Page 91 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 -91-...
  • Page 92 Meshlium treme Cloud Connectors 12.1.7.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 93 Meshlium treme Cloud Connectors 12.1.7.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 94 Meshlium treme Cloud Connectors 12.1.7.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 95: Thingplus

    Meshlium treme Cloud Connectors 12.1.8. 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 96 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 •...
  • Page 97 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 98: Thingworx

    Meshlium treme Cloud Connectors 12.1.9. 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. The ThingWorx platform includes flexible device connectivity options, rapid application development tools, scalable storage, and supports various deployment models.
  • Page 99 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 •...
  • Page 100 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 101 Meshlium treme Cloud Connectors 12.1.9.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 102: Advanced Cloud Partners

    Meshlium treme Cloud Connectors 12.2. Advanced Cloud Partners 12.2.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 103 Meshlium treme Cloud Connectors 3. Create a security certificate and download the files for later use Figure: Save the credential files when connecting device -103- v7.3...
  • Page 104 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 105 Meshlium treme Cloud Connectors 12.2.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: Public key: User public key file previously downloaded.
  • Page 106 Meshlium treme Cloud Connectors Figure: Amazon IoT configuration panel 12.2.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.

  • Page 107: Cumulocity

    Meshlium treme Cloud Connectors 12.2.2. 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 108: Smartcityplatform

    Meshlium treme Cloud Connectors 12.2.3. 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 109 Meshlium treme Cloud Connectors 12.2.3.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 110: Telefónica Iot Platform

    Meshlium treme Cloud Connectors 12.2.4. 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.

  • Page 111: Telit

    Cloud Connectors 12.2.5. 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.2.5.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 112 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 113 Meshlium treme Cloud Connectors Figure: Save configuration button At this point the Meshlium Cloud Connector is configured and ready to start. 12.2.5.3. Controlling synchronization Once the Telit deviceWISE IoT Cloud Connector has been configured with the proper runtime parameters, it is ready for operation.
  • Page 114 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 -114- v7.3...

  • Page 115: Basic Cloud Partners

    Meshlium treme Cloud Connectors 12.3. Basic Cloud Partners 12.3.1. Amplía’s OpenGate 12.3.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 116: Basen

    Meshlium treme Cloud Connectors 12.3.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.3.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 117 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.3.2.3.

  • Page 118: B-Scada

    Meshlium treme Cloud Connectors 12.3.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.
  • Page 119 Meshlium treme Cloud Connectors 12.3.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 120: C2M

    Meshlium treme Cloud Connectors 12.3.4. C2M C2M® is an end-to-end IoT and Digital Enterprise platform that allows easy, secure and rapid prototyping and deployment of IoT/M2M solutions. 12.3.4.1. Configuring C2M Platform in Meshlium 1. Select the C2M® plugin located in: Manager System >...
  • Page 121 Meshlium treme Cloud Connectors 2. Select the Data Transfer tab. Here you will see your enabled Waspmote/Sensors. Select your Transmission method, toggle on the devices in which you want to send data and press “Save”. 3. Click on the “Start” button to begin the C2M Sync service. Click the “Stop” button to terminate the C2M Sync service.

  • Page 122: Devicelynk

    Meshlium treme Cloud Connectors 12.3.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. Meshlium Bind Name The name that the DeviceLynk Server uses to identify the Meshlium unit.
  • Page 123 Meshlium treme Cloud Connectors Interface Feature Description DeviceLynk Agent Status The status of the DeviceLynk Agent will be indicated, displaying “Running” or “Stopped”. LUA Script Resource Status The status of the LUA Script Resource will be indicated, displaying “Running” or “Stopped”.

  • Page 124: Eagle.io

    Meshlium treme Cloud Connectors 12.3.6. 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. More information can be found at www.eagle.io.
  • Page 125 Meshlium treme Cloud Connectors 12.3.7. Ensura The Ensura Command & Control platform (http://www.ensuracc.com/) manages live and recorded video, audio, and data flows, and shows simultaneous live and recorded views in a single window. The system provides server- side and sensor-side Video Content Analytics for all video channels, displaying triggered alerts from any 3rd party end-element.
  • Page 126 Meshlium treme Cloud Connectors 12.3.8. Ericsson AppIoT The Ericsson AppIoT cloud connector will integrate Meshlium as an AppIoT gateway with minimal effort and configuration. More information on AppIoT and IoT Accelerator: https://www.ericsson.com/en/industries/iot-for-industry/appiot https://www.ericsson.com/ourportfolio/products/iot-accelerator 12.3.8.1. Register Meshlium in AppIoT Register a gateway with the pre-configured Meshlium gateway type in your device network in AppIoT. If the Meshlium gateway type is missing in your instance of AppIoT, please contact AppIoT support.
  • Page 127 Meshlium treme Cloud Connectors Sensor mapping: Toggles the sensor mapping table used to translate sensor types between Meshlium and AppIoT. An example of the table can be seen in the next image, where the left hand side lists the sensors from Meshlium and the right hand side lists the sensor hardware types from AppIoT.
  • Page 128 Meshlium treme Cloud Connectors 12.3.8.3. Setup Create device types in AppIoT to represent your Waspmotes. • Set the desired synchronization interval and limit, please select these parameters following recommendations. • Set the desired logging level. • Supply the registration ticket field with a valid ticket. •...
  • Page 129 Meshlium treme Cloud Connectors 12.3.9. Esri ArcGIS is a complete spatial information platform provided by Esri, that allows to create, analyze, store and spread data, models, maps and 3D globes. It can be accessed via desktop application, browser or handsets. ArcGIS is targeted at GIS professionals, location analysts and developers that want to create their own applications based on geographical data.
  • Page 130 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.3.9.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 131 Meshlium treme Cloud Connectors 12.3.9.2. Devices 12.3.9.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.3.9.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 132 Meshlium treme Cloud Connectors 12.3.9.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”.
  • Page 133 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 134 Meshlium treme Cloud Connectors 12.3.11. HaibuSmart HaibuSmart is an IoT platform for business. The services include Enterprise Business Applications that involves near real-time information and the integration of sensors as primary data acquisition point. For more information you can reach us at: http://www.haibusmart.com 12.3.11.1.
  • Page 135 Meshlium treme Cloud Connectors 12.3.12. infiswift For more details on the platform, please visit https://www.infiswift.com and review swiftLab documentation. 12.3.12.1. Configuration In order to publish data from the Meshlium Gateway to the infiswift broker, you will need to login to the Meshlium Manager for configuration.
  • Page 136 Meshlium treme Cloud Connectors IP Address: This is the broker IP address (beta.infiswift.com) of the Gateway you want to connect to • Port Number: This is the port you opened upon configuration of Meshlium plugin • User: This is the username of the device created and to be supplied upon configuration of Meshlium plugin •...
  • Page 137 Meshlium treme Cloud Connectors 12.3.13. 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 138 Cloud Connectors 12.3.13.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. Figure: IoT-Ticket Meshlium integration The IoT-Ticket cloud connector settings can be found under the IoT section of the browser-based Meshlium Manager System.
  • Page 139 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. Server specifies the IoT-Ticket server to use, by default my.iot-ticket.com.
  • Page 140 Meshlium treme Cloud Connectors 12.3.13.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 141 Meshlium treme Cloud Connectors 12.3.13.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 142 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 -142- v7.3...
  • Page 143 Meshlium treme Cloud Connectors 12.3.14. 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. IoTSens seamlessly integrates with Meshlium devices by means of MQTT queues so the connector will send all the sensors data to your IoTSens platform in order to be processed.
  • Page 144 Meshlium treme Cloud Connectors 12.3.15. Kii 12.3.15.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.
  • Page 145 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 146 Meshlium treme Cloud Connectors Click again on the Objects icon (the cylinder), then click on the Data Browser tab. In the combo box select Time • series bucket and then click on Thing scope. In the second combo box select Vendor Thing ID and in the text box below, type the name of the node you want to verify.
  • Page 147 Meshlium treme Cloud Connectors 12.3.16. Labeeb Labeeb IoT is a Cloud and On-Premise Internet of Things (IoT) Services Enablement Platform. It provides an attractive environment (i.e. platform-as-a-service, open APIs, development tools, and documentation) for entrepreneurs, third party developers and companies to accelerate the development and deployment of new IoT services, and to help them achieve faster time-to-market.
  • Page 148 Meshlium treme Cloud Connectors 12.3.16.2. Configuration After creating your account, you can use your credentials (enterprise name, username and password) to configure Meshlium. Figure: Labeeb IoT configuration panel 1. Fill the configuration fields with your Labeeb IoT credentials: Hosting Server: the server where your Labeeb IoT account is hosted in (default: MEA for mea.labeeb-iot.com) •...
  • Page 149 Meshlium treme Cloud Connectors 12.3.16.3. Controlling synchronization Once the connector is configured, the user can launch the Meshlium Labeeb IoT script (“Start” button). The program will search for the received frames on the local database, and will send them to the Labeeb IoT Platform. The status indicator displays the current state: “Running”...
  • Page 150 Meshlium treme Cloud Connectors 12.3.17. MQTT MQTT is a publish/subscribe, extremely simple and lightweight messaging protocol, designed by IBM for constrained devices and low-bandwidth, high-latency or unreliable networks, where battery power is critical. Due to its features of delivery assurance and bandwidth reduction, MQTT is being used by some Cloud platforms such as IBM or Carriots, which means that Waspmote data can be stored inside them or in any other one based on this protocol.
  • Page 151 Meshlium treme Cloud Connectors Figure: Server/Broker Configuration 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.3.17.2.
  • Page 152 Meshlium treme Cloud Connectors 12.3.17.3. Platforms using MQTT MQTT has been widely implemented across a variety of industries. As of March 2013, MQTT is in the process of undergoing standardization at OASIS protocol stack. The protocol specification has been openly published with a royalty-free license for many years, and companies such as Eurotech (formerly known as Arcom) have implemented the protocol in their products.
  • Page 153 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 154 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 155 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 156 Meshlium treme Cloud Connectors 12.3.19. Redd Redd is a company focused on delivering telemetry and telecontrol solutions for clients assets, with the aim of optimizing and simplifying operations, and most importantly, providing them with the necessary information to make quick and timely decisions. For more information, please contact iot@reddsystem.com.
  • Page 157 Meshlium treme Cloud Connectors 12.3.20. 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.3.20.1.
  • Page 158 Meshlium treme Cloud Connectors 12.3.21. 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.3.21.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 159 Meshlium treme Cloud Connectors 12.3.22. 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 160 Meshlium treme Cloud Connectors 12.3.23. 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 161 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.3.23.2. Advanced configuration The advanced configuration window of the Connector allows the setting of the following parameters: Connection retries: Controls the number of connection testing retries before suspending operations and •...
  • Page 162 Meshlium treme Cloud Connectors 12.3.23.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 163 Meshlium treme Cloud Connectors 12.3.24. 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.3.24.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 164 • 12.3.25.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. For more information about how to configure the Things Internet service, please contact your TechEdge contact.
  • Page 165 Processing Limit: Limit of simultaneous messages processing in each of HCP cloud deliveries, the figures • are considered 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 166 Meshlium treme Device connectors 13. Device connectors The aim of this chapter is to introduce the user to the Meshlium’s Device Connector functionality. This section will help you to connect your Meshlium to a 3rd party device platform. 3rd party certified connectors are linked with Meshlium by an IP interface. What is a device platform? Devices are equipments which could be easily correlated with Meshlium through an Ethernet or wireless connection.
  • Page 167 Meshlium treme Device connectors 13.1. Device Partners 13.1.1. Axis Axis offers a wide variety of network videocameras and advanced analytic applications. More information: https:// www.axis.com/global/en/products/network-cameras. Thanks to this plugin, the sensor data received on Meshlium can trigger actions on Axis cameras. Figure: Axis plugin 13.1.1.1.
  • Page 168 Meshlium treme Device connectors Figure: Axis configuration panel When all the parameters have been configured, press the “Add Camera” button. This action will add a new rule in the “Devices” section. Figure: New device -168- v7.3...
  • Page 169 Meshlium treme Device connectors 13.1.1.2. Devices In the “Devices” section you can see all the rules that will be evaluated for each device. Apart from checking that the rules are properly configured, you can execute 2 actions: Delete: Delete the device. It will be disappear from this section and the rule will not be evaluated. •...
  • Page 170 Meshlium treme Smartphone detection 14. 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 171 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 172 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 14.1. Devices detected Figure: Devices detection -172- v7.3...
  • Page 173 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 174 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. The antennas are 18 dBi and come with the needed mounting system, 2 m cables and screw adapters.
  • Page 175 Meshlium treme Smartphone detection Anyway, in the case of sending 802.15.4 frames from Waspmote or Plug & Sense! to a Meshlium Scanner equipped with XBee-PRO 802.15.4, it is recommended to perform re-tries in the sender application, just to minimize possible interferences and ensure a good percentage of received frames in Meshlium. 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.
  • Page 176 Meshlium treme Smartphone detection The results not Android or iOS devices may vary depending on the type of system. Usually, APs are detected easily, as they broadcast the SSID. Hidden SSID are detected too. The only APs that can be hard to detect are the APs that do not broadcast their presence.
  • Page 177 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 178 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 179 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 -179- v7.3...
  • Page 180 Meshlium treme Smartphone detection 14.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 • Table: wifiScan •...
  • Page 181 Meshlium treme Smartphone detection 14.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: Setup the parameters of the external database and check the connection. •...
  • Page 182 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 183 Meshlium treme Smartphone detection 14.3. Bluetooth Scanner 14.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 184 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.
  • Page 185 Meshlium treme Smartphone detection 14.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 186 Meshlium treme Smartphone detection 14.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: Setup the parameters of the external database and check the connection. •...
  • Page 187 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 188 Meshlium treme Tools 15. Tools 15.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 189 Meshlium treme Tools 15.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 -189- v7.3...
  • Page 190 Meshlium treme Tools 15.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. 15.5. Netstat Discover which connections IPv4-Port (tcp), and IPv6-Port (tcp6) are active. Figure: Netstat information -190- v7.3...
  • Page 191 Meshlium treme Tools 15.6. GPS 15.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 192 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 193 Meshlium treme Tools 15.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. Database: MeshliumDB •...
  • Page 194 Meshlium treme Tools 15.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 195 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 196 Meshlium treme Database management 16. Database management 16.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 197 Meshlium treme Database management Figure: phpMyAdmin panel -197- v7.3...
  • Page 198 Meshlium treme System Information 17. System Information 17.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 17.2.
  • Page 199 Meshlium treme System Information 17.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 200 Meshlium treme System Information 17.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 201 18.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 202 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 203 Meshlium treme Upgrading Meshlium 18.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 204 19.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 205 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 206 Meshlium treme Expansion port 20. 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 -206- v7.3...
  • Page 207 Meshlium treme Manager System changelog 21. Manager System changelog Version 4.0.4 Added new menu “Devices” • Added Axis device plugin • Added new menu “Activity Monitor” for replacing “Disk Usage” • Added option to change log level in Sensor Parser •...
  • Page 208 Meshlium treme Manager System changelog Version 4.0.0 Network setup reviewed • Added “disable/enable” control to main services • Added compatibility with several radio modules • Added Auto-purge to sensor, Bluetooth scanner, WiFi scanner and GPS data • Cellular connection mechanism improved •...
  • Page 209 Meshlium treme Documentation changelog 22. Documentation changelog From v7.2 to v7.3 Added the new chapter “Device connectors” • Added new device connector for Axis • From v7.1 to v7.2 Added new cloud connectors: Arrow (Arrow Connect), Ericsson (Ericsson AppIoT), Haibu (HaibuSmart), infiswift, •...
  • Page 210 Meshlium treme Certifications 23. Certifications 23.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 23.2.
  • Page 211 Meshlium treme Certifications 23.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) + •...
  • Page 212 Meshlium treme Certifications 23.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 23.5. ANATEL (Brazil) Figure: Back sticker for Meshlium 4G 802.15.4 AP 900 BR 23.6.
  • Page 213 Meshlium treme Maintenance 24. 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 214 Meshlium treme Disposal and recycling 25. 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