Libelium Meshlium Xtreme, Technical Manual

Page 1: ......

Page 2: ... LE910 11 4 Contents of the box 13 5 Specifications 15 6 How to use Meshlium 18 6 1 Power supply 18 6 2 External SIM socket 20 6 3 How to install the antennas 21 6 4 Installation of the IP65 Ethernet cable 22 6 5 Installing Meshlium 25 6 6 Initialization restart and shutdown 25 6 7 Setting the time 26 7 Understanding Meshlium 27 7 1 Concepts 27 7 2 Meshlium models 27 7 3 Storage 28 7 4 Application...

Page 3: ...Meshlium Visualizer 63 11 1 Working with the Visualizer 63 12 Cloud Connectors 66 12 1 Premium Cloud Partners 68 12 1 1 Arrow 68 12 1 2 IBM Bluemix 73 12 1 3 Microsoft Azure Event Hubs 74 12 1 4 Microsoft Azure IoT Hub 81 12 1 5 Nexmachina 85 12 1 6 ElementBlue RightSensor 87 12 1 7 Sofia2 89 12 1 8 ThingPlus 95 12 1 9 ThingWorx 98 12 2 Advanced Cloud Partners 102 12 2 1 Amazon IoT 102 12 2 2 Cumu...

Page 4: ...2 3 23 Simfony 160 12 3 24 SmartPlants 163 12 3 25 TechEdge SAP HANA 164 13 Device connectors 166 13 1 Device Partners 167 13 1 1 Axis 167 14 Smartphone detection 170 14 1 Devices detected 172 14 2 WiFi Scanner 177 14 2 1 Concepts 177 14 2 2 Local database 180 14 2 3 External database 181 14 3 Bluetooth Scanner 183 14 3 1 Concepts 183 14 3 2 Local database 185 14 3 3 External database 186 15 Tools...

Page 5: ...l temperature sensor 199 17 5 Time synchronization 200 18 Upgrading Meshlium 201 18 1 Checking for updates 201 18 2 Local file 202 18 3 URL 203 19 Rescue System 204 19 1 Rescue steps 204 20 Expansion port 206 21 Manager System changelog 207 22 Documentation changelog 209 23 Certifications 210 23 1 General overview 210 23 2 CE Europe 210 23 3 FCC USA 211 23 4 IC Canada 212 23 5 ANATEL Brazil 212 23...

Page 6: ...ort that to Libelium Any other failure reported after these 7 days may not be considered under warranty Do NOT open the enclosure If you do so you will lose the guarantee Do not remove any of the components Do not allow contact between metallic objects and the electronic part to avoid injury and burns NEVER immerse the equipment in any liquid Keep the equipment in a dry place away from any liquids...

Page 7: ...roperly through the Shutdown or Restart buttons in the Manager System Do not open the Meshlium enclosure in any case This will automatically make the warranty void Do not submerge Meshlium in liquids Do not place Meshlium on places or equipment where the device could be exposed to shocks and or vibrations Do not expose Meshlium to temperatures below 20º C or above 50º C Meshlium s microprocessor m...

Page 8: ... of programs and system New expansion port for future use of external I2C USB or UART devices New Meshlium is Microsoft Azure Certified More info https azure microsoft com es es marketplace programs certified 3 1 Capabilities comparison Previous Meshlium version New Meshlium CPU cores 1 4 CPU architecture 32 bits 64 bits CPU frequency 500 MHz 1 GHz RAM 256 MB DDR 2 GB DDR3 Storing Compact Flash 8 ...

Page 9: ... 868 radios Plug Sense Waspmote v1 2 WiFi YES Plug Sense Waspmote v1 2 3G YES Plug Sense Waspmote v1 5 802 15 4 YES Plug Sense Waspmote v1 5 900 YES Plug Sense Waspmote v1 5 868 YES Plug Sense Waspmote v1 5 WiFi YES Plug Sense Waspmote v1 5 4G YES Plug Sense Waspmote v1 5 ZigBee NO Meshlium does not support this RF module 3 3 Compatibility with current cloud software Cloud software Compatible Note...

Page 10: ...asking feature The XBee 868LP is also the industry s first RF module using 868 MHz and surrounding frequencies for LBT AFA Listen Before Talk and Adaptive Frequency Agility This virtually eliminates interference by listening to the radio environment before any transmission starts and automatically shifting to a new channel when interference is detected This patent pending frequency scan occurs aut...

Page 11: ...Outdoor line of sight range Up to 1 8 miles 3 km Up to 9 miles 15 5 km Transmit power 17 dBm 24 dBm Receive sensitivity 100 dBm 110 dBm Transmit current 210 mA 215 mA Receive current 80 mA 29 mA 3 6 3G SIM5215 vs 4G LE910 The new 4G module module supports some changes The new 4G counts with many different models one specifically designed for each market LE910 EU Europe Brazil CE GCF ANATEL LE910 N...

Page 12: ...5 MeshliumXtreme Features Old 3G SIM5215 New 4G LE910 Download max speed 384 kbps 100 Mbps Upload max speed 384 kbps 50 Mbps Antenna diversity No Yes Cellular carriers Any Any Specially tested with AT T SK Telecom Telstra NTT DoCoMo or KDDi ...

Page 13: ...xpansion 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 Fixing a Fixing plate b 2 metal brackets c Screws and wall plugs d Mounting screw ...

Page 14: ... 14 v7 3 Contents of the box MeshliumXtreme Ethernet cable IP65 Ethernet cap Ethernet crossover cable POE injector AC DC adapter ...

Page 15: ...aterial Aluminum Dimensions 300 x 220 x 87 mm Weight 2 2 kg External protection IP65 Temperature range 20 ºC 50 ºC Response time to Ethernet ping 60 s Time to have all the services running 60 s Types of power supply AC 220 V DC 12 V Linux Debian based Meshlium Manager System Management software open source Security Authentication WEP WPA WPA2 HTTPS Only with the accessories supplied by Libelium Fi...

Page 16: ...a and line of sight RF radio modules Model XBee PRO 802 15 4 Frequency 2 4 GHz TX power 18 dBm 10 dBm for EU models Rx sensitivity 100 dBm Antenna 5 dBi dipole Range 1 6 km 750 m in EU models Model XBee 868LP Frequency 868 MHz TX power 14 mW Rx sensitivity 106 dBm Antenna 4 5 dBi dipole Range 8 4 km Model XBee PRO 900HP Frequency 900 MHz TX power 24 dBm Rx sensitivity 110 dBm Antenna 4 5 dBi dipol...

Page 17: ...3G GPRS or GSM Output power Class 4 2 W 33 dBm GSM 850 900 Class 1 1 W 30 dBm GSM 1800 1900 Class E2 0 5 W 27 dBm EDGE 850 900 Class E2 0 4 W 26 dBm EDGE 1800 1900 Class 3 0 25 W 24 dBm UMTS Class 3 0 2 W 23 dBm LTE RX rate Up to 100 Mb s TX rate Up to 50 Mb s Antenna 4 dBi SIM card Access via the External micro SIM socket GPS Module Modes Assisted GPS A GPS Standalone mode NMEA frames Antenna 4 d...

Page 18: ...re that the PoE is indoors 4 Take the supplied power adapter and plug it into the corresponding PoE injector connector labeled as DC 5 Plug the other end of the adapter into the 220 V socket and your Meshlium is now ready to operate Note For equipment powered by an electric outlet a power outlet must be installed near the equipment and it must be easily accessible Figure Connecting Meshlium to 220...

Page 19: ...shlium 1 Connect the Ethernet cable not the crossover to the PoE input marked LAN and to one of the switch inputs 2 Connect another Ethernet cable to another one of the switch inputs and the opposite end to the network socket of your PC See the Accessing Meshlium section in order to see how to get access via wireless Figure Connecting LAN cable to a switch ...

Page 20: ...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 To insert the SIM press until a click is heard To release the card press until a click is heard and the...

Page 21: ...socket has a limited resistance so please be gentle and push with care 6 3 How to install the antennas Every antenna for each technology has a defined position in which it has to be installed The different positions are Figure Antenna socket numbers 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...

Page 22: ...Ethernet cable can be used for indoors and outdoors deployments Just note that its resistance is limited so in order to maximize its lifetime in harsh conditions direct sunlight extreme temperatures very wet climate we advise to protect the cable with some isolating tube or heat shrink sleeve This is also important for installations where insects birds rats or other animals could try to bite the c...

Page 23: ...ction shown in the diagram Figure Screw both parts 6 Partially screw part D to the end Figure Screw part D 7 Pass the cable through the fitted cap Figure Pass the cable 8 Crimp the RJ45 connectors at the ends of the cable the crimping tool is not supplied with Meshlium Figure Crimp RJ45 Your IP65 Ethernet cable is now ready for use ...

Page 24: ...r fitting the cap and stick it to the Meshlium Ethernet connector Figure Stick joint 2 Connect the end of the Ethernet cable to the Meshlium Ethernet socket Figure Connect RJ45 3 Screw part C onto the Meshlium connector Screw tighter part D to fix the cable too Your Meshlium is now ready to work outdoors Figure Screw connector and tighten part D ...

Page 25: ...oper metric Once the bracket is fixed 1 Attach the box to the bracket fitting the three top notches in the holes of the box 2 Secure the screw in the bottom of the box 3 Secure the Ethernet cable to avoid accidental pulls do not let it loose If the cable gets stretched the joint of the cable with its connector could be damaged 6 6 Initialization restart and shutdown In order to allow Meshlium to c...

Page 26: ...loud so you will have to take attention and be close to the Meshlium box in order to hear them clearly Note 2 If Meshlium is unplugged before the acoustic signal of shutdown internal memory could be damaged Be sure to wait for several minutes if you are not sure the beeps sounded Note 3 The duration of the reboot or shut down processes may vary Make sure you heard the corresponding beeps and be pa...

Page 27: ...anager 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 7 2 Meshlium models There are different Meshlium models depending on the radios integrated Meshlium model Ethernet WiFi AP 4 G 3 G G P R S GSM 802 15 4 868 900 WiFi Bluetooth scanners Meshlium 4G 802 15 4 AP 868 EU P P EU BR version EU version 868 Me...

Page 28: ...l database files can be found in mnt user mysql MeshliumDB 7 4 Application model by model Meshlium RF 4G AP Meshlium can take the sensor data which comes from a Wireless Sensor Network WSN made with Waspmote sensor devices equipped with RF XBee radios and send it to the Internet using the Ethernet interface or the 4G 3G GPRS GSM interface Besides Waspmotes with GPRS GPRS GPS 3G 4G or WiFi can send...

Page 29: ...net 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 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...

Page 30: ...e WiFi connection First of all search the available access points and connect to MeshliumXXXX The four digits at the end allow to identify different Meshliums when working near each other Figure List of AP with Meshlium network No password is needed as the network is open you should change it later in the WiFi AP interface options When you select it Meshlium will give an IP address from the range ...

Page 31: ...um starts with a default IP address 192 168 1 100 In this case you can connect 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 ...

Page 32: ...ng 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: ... automatically from the MAC address of the interface The button Generate IPv6 address performs this task After saving the new options and once you have restarted Meshlium you have to validate the new configuration before the next 5 minutes if not the factory default configuration will be restored to avoid leaving Meshlium without connectivity See section Network setup confirmation for more informa...

Page 34: ...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 ...

Page 35: ...here XXXX are the last four digits of Ethernet MAC This allows to identify different Meshliums installed nearby Figure WiFi Access Point setup 9 2 1 Configuration There three sections in the configuration page Network Radio and Security Network Here you can change the IP of the device in the network and the DHCP setup Here can be setup IP address of the AP Netmask of the Address DHCP range The add...

Page 36: ...sed for transmission according to the next diagram Figure WiFi radio channels Protocol It is possible to use 802 11g and 802 11n Tx power It allows to control the transmission power thus the range of the AP Figure WiFi radio settings Security The WiFi AP can be protected with encryption WEP WPA and WPA2 are available WEP is enabled in the 5 and 13 characters configurations while WPA PSK can be use...

Page 37: ... settings The setup has to be confirmed within 5 minutes after reboot More info in Network setup confirmation Figure Confirmation warning 9 2 2 Clients connected This section shows the list of clients connected to the WiFi AP showing information like the MAC address and the IP assigned It is a quick way to know how many devices are connected and who are they Figure Clients connected ...

Page 38: ...applied again If there are no validated settings default settings will be applied In the confirmation screen the user can select to confirm new settings change to last validated settings or change to default settings All the information of every setup will be shown After the confirmation is done the new settings will be stored as last validated settings for future confirmations The system will sho...

Page 39: ...d as this will make easier the test and validation process and will avoid to block the SIM card Figure 4G setup plugin After setting the 4G parameters and before save them you can test your connection through the Connect now button It will try to connect to your carrier and get a valid IP Once the connection has been made the default gateway of the machine is changed so all the clients connected t...

Page 40: ...t activate the service in the Set as Default Gateway check box before saving Setting this on will connect to the Internet using the 4G radio each time Meshlium restarts If any problem is preventing the device to connect at boot or to reconnect after a connection fall a message will be displayed in the plugin The user can manually stop automatic reconnection by pressing Disconnect now button Figure...

Page 41: ...will be gradually included in other services 9 6 No IP setup This plugin allows to setup a No IP account https www noip com for dynamic IP remote access Configure the following parameters with the information of a valid and active No IP account previously created in the No IP platform Hostname Name of the host to link with the Meshlium IP Username No IP account username Password No IP account pass...

Page 42: ... 42 v7 3 Network interfaces setup MeshliumXtreme Please refer to the interface configuration section to use a proxy Figure NoIP enable control Figure NoIP disable control ...

Page 43: ...n work with different communication technologies like 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 ...

Page 44: ...um 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 RF modules The plugin will show a tab for each module detected in the device 10 2 1 1 1 XBee PRO 802 15 4 radio setup Figure XBee PRO 802 15 4 setup ...

Page 45: ...ode Internal XBee AES 128 bits encryption Disabled by default Encryption key 16 characters MAC 64 bits hardware address of the module It is a read only value divided in two parts MAC high 32 bits 8 hexadecimal digits MAC low 32 bits 8 hexadecimal digits This setup must be consistent with those set on the Waspmote and Plug and Sense nodes In the bottom part of the interface the button Check status ...

Page 46: ... PAN ID It needs to be the same in the nodes too Channel This module allow to select the channels that can be used The module automatically selects the channel for the communication between available ones Once the channels are selected the plugin generates the Channel Frequency Mask read only 8 hex digits that the needs to be set in the nodes Power level 0 4 By default 4 Encrypted mode Internal XB...

Page 47: ...o Channel This module allow to select the channels that can be used The module automatically selects the channel for the communication between available ones Once the channels are selected the plugin generates the Channel Frequency Mask read only 16 hex digits that the needs to be set in the nodes In the bottom part of the interface is shown the minimum number of channels that have to be selected ...

Page 48: ...yption Key Must be 16 characters See section XBee module setup for more details about setting encryption 10 2 1 2 1 Application layer key management Meshlium is capable to properly receive encrypted data from Waspmote The coding process is made in the application layer so it is Waspmote and Meshlium processor and not XBee module who encrypts and decrypts the messages The user have to set a key for...

Page 49: ...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 That can be done in an automatic way thanks to the Sensor Parser The Sensor Parser is a software system which is able to do the following tasks in an easy and t...

Page 50: ...ored 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 ...

Page 51: ...cal Database synchronize the local Database with an external database Frames received by this method are stored the same way that RF frames and are identically processed at synchronization stage No configuration of any kind is needed to use HTTP If HTTPS is needed certificate configuration would be needed in many cases self signed certificate is included with Meshlium Like the case of RF modules r...

Page 52: ...s Sensor Networks MeshliumXtreme 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 ...

Page 53: ...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 Table sensorParser IP localhost Port 3306 User root Password libelium2007 Figure Local database tab ...

Page 54: ... 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 Figure Autopurge setup 10 3 2 External Database Meshlium can synchronize all the sensor information stored in the local database to an external MySQL database managed by the user Figure External database tab ...

Page 55: ...ronization Figure Control to enable or disable synchronization Show last data inserted in the external database up to 500 data Figure Show last inserted data Show the SQL script used to create the database and table needed for the synchronization Figure Show SQL script Mark all data in the local database as synchronized so it will not be sent to the external database Figure Mark as synchronized bu...

Page 56: ...nge the setup of the connection to match 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 maki...

Page 57: ...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 10 3 4 Advanced database options This tab shows information about local database Figure Mark as synchronized button ...

Page 58: ...oves from the database all the frames already synchronized with external database Be careful as this could give unexpected results if you are using several cloud or external services A confirmation will be prompted Remove ALL content This removes all the sensor information from the database A confirmation will be prompted WARNING The sensor data will permanently deleted from the database and will ...

Page 59: ...n 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 button will delete the files allowing to clean some space in the device ...

Page 60: ...n easy and simple way To add a new sensor the user must complete the fields ASCII ID sensor id for ASCII frame Fields This field specifies the number of sensor fields sent in the frame This helps to calculate the frame length Type type of fields uint8_t int float string ulong array ulong Units Units for the sensor added Once all fields are filled in click on the button Add sensor Figure Sensor lis...

Page 61: ...m to update program name version size etc Step 2 If the information given is correct Waspmote queries the FTP server for a new program binary file and it updates its flash memory in order to run the new program Figure OTA via FTP protocol 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 p...

Page 62: ...ing path mnt user ota Secondly the program version is always set by the user before generating the new UPGRADE TXT file There is a specific input to indicate the program version It must be defined as a 1 unsigned byte number range from 0 to 255 Finally there is a button to generate the new UPGRADE TXT file Once these steps have been completed the binary file and the proper UPGRADE TXT file will be...

Page 63: ...imple form to make all your queries To do so just follow these steps Figure Filling Meshlium Visualizer s form 1 Select one Plug Sense from the list All Plug Sense units with frames in the database will be shown 2 Once a Plug Sense Is selected all its sensors will be loaded This process is repeated each time you change the selected Plug Sense 3 Select the period of time you want to see in the char...

Page 64: ...um 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 ...

Page 65: ...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 Sense units between these dates Data can be exported in 5 formats CSV SQL XML TXT HTML and compressed in ZIP Figure Configuring Meshlium Visualizer to export data ...

Page 66: ...in our industry One of the most important parts of that paradigm are cloud platforms This kind of platforms let developers write applications that run in the cloud use services provided from the cloud or both Meshlium Cloud Connector Meshlium runs a set of scripts for implementing the data synchronization from its internal database to the cloud In other words those scripts send data to webservers ...

Page 67: ... 67 v7 3 Cloud Connectors MeshliumXtreme Figure Cloud Connector main menu on the Manager System ...

Page 68: ...more all from a single platform Arrow Connect makes device management easy so you can focus on driving business value via data analytics and machine learning tools Visit http iot arrow com developer html for more information 12 1 1 2 Register Meshlium in Arrow Connect To request for a developer account in Arrow Connect platform follow the Developer Registration process on https portal arrowconnect...

Page 69: ...ministration Access Keys then click on the Master Key You can save the Client Encrypted API Key and Client Encrypted Secret Key to the notepad This pair of keys will be used to configure the Meshlium to connect to your cloud account Figure Access Key 12 1 1 3 Configuration Paste the keys above into the 2 text areas as screen shot below Figure Configure Arrow ...

Page 70: ...ver be updated while the Arrow Connect IoT Cloud Connector is running Use the Start Stop buttons as described below to stop it before making changes restart it after saving changes 12 1 1 4 Controlling synchronization Launch the Meshlium Arrow Connect IoT Cloud background process Start button The program will search for the received frames on the local database and will send them to the Arrow Conn...

Page 71: ... 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 ...

Page 72: ... 72 v7 3 Cloud Connectors MeshliumXtreme Figure Arrow Waspmote display ...

Page 73: ...tform credentials API user User generated in the API platform section API password Password generated in the API platform section Event ID Used to configure the event where you want to send the information If you do not know what to type in this field you can use eid Interval Used to delay the communication after a bunch of messages were sent 12 1 2 2 Controlling synchronization You can stop or st...

Page 74: ...M2M technology For more information about Event Hubs see the following link https azure microsoft com en us services event hubs 12 1 3 1 Setup in Azure Creating NameSpace Before getting the parameters to connect to Event Hub it is necessary to create a Service Bus Namespace skip this section if you already have one Go to the Azure Event Hub Portal https manage windowsazure com Select the Service B...

Page 75: ... 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 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 choos...

Page 76: ... data with custom credentials Once we entered on event hub information by clicking on event hub these credentials can be set up in the configuration section this menu is on top of the screen Figure Configure the Event Click on the configure option and a new screen will be displayed Here you can configure message retention event hub state partition count and shared access policies This last point s...

Page 77: ...eme 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 ...

Page 78: ...ng 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 Note that the namespace is only a part of the string Endpoint it does NOT include the sb neither the servicebus windows ...

Page 79: ...re service cloud Directive name Name of the directive created in Azure Directive key Key of the directive associated to the previous name Name Name of the Event Hub established in Azure Template file Users can define their own data structure using these wild cards as you can see in the previous figure ID Unique identifier for data ID_WASP Identifies the Waspmote unit ID_SECRET Secret identifier SE...

Page 80: ...ud 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 status Figure Azure Event Hubs synchronization service is running If you want to stop this process just press the Stop button You can start stop this process whenever you want Figure Azure Event Hubs synchronization service is stopped ...

Page 81: ... how to reliably and securely connect devices to the solution back end To address this challenge IoT Hub Offers reliable device to cloud and cloud to device hyper scale messaging Enables secure communications using per device security credentials and access control Includes the most popular communication protocols More information https www microsoft com en us cloud platform internet of things azu...

Page 82: ...etstarted 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 You will need this parameter later for the Meshlium configuration In the Microsoft Azure Portal go to IoT Hub menu and select Devices myCreatedDevice Shared access policies iothubowner Connection string primary key You have to annota...

Page 83: ...ft 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 Number Requests Number of requests to send per iteration Protocol Choose the protocol to communicate with Azure IoT Hub Valid protocols are MQTT by default AMQPS and HTTPS Figure Azure IoT Hub configurat...

Page 84: ...oft 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 or Stopped Figure Azure IoT Hub sender is running You can stop the Azure IoT Hub program anytime clicking on the Stop button Figure Azure IoT sender is stopped ...

Page 85: ... Things created by Nexmachina Characteristics Simple and practical Multi language Multi device Multi user Features Monitoring devices and sensors Display data Configurable alarms Export data Configurable interface Technical requirements User Web browser Chrome Firefox IE8 or higher Figure iQmenic Dashboard Figure Sensors on the map ...

Page 86: ...Password for your iQmenic platform as well as the configuration parameters for connecting your Meshlium to iQmenic 2 Log in your Meshlium and go to Cloud Connector IoT Solutions iQmenic Fill the form with the configuration data and click on the Save button Figure Configuring Orchestra 3 To send data from Meshlium to iQmenic just click on the Start button Data will be sent by MQTT protocol and you ...

Page 87: ...rkflows and actions based on the data for use in industrial environments To use the service you must have an account with Element Blue s SensorInsight Industrial Internet of Things Platform For more information visit www sensorinsight io and www rightsensor com 12 1 6 1 Configuration By expanding the RightSensor menu item on the list you can see the form in which to set your connection parameters ...

Page 88: ...se parameters can be obtained from your SensorInsight account page Learn more at www sensorinsight io 12 1 6 2 Controlling synchronization To launch the cloud connector service and start sending your data to RightSensor press the Start button Figure ElementBlue RightSensor synchronization service is running You can stop at any moment clicking on the Stop button Figure ElementBlue RightSensor synch...

Page 89: ...revious step required to connect the Meshlium with Sofia2 At the end of the registration process you will obtain the configuration parameters needed to set up the Meshlium plugin properly This configuration includes the following information Measures Ontology Collection table or storage where the measures from Waspmote sensors sent by Meshlium the gateway will be stored into the platform Monitorin...

Page 90: ...egister 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 Create a new account if you do not have a valid login user ...

Page 91: ... 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 92: ...mpleted Alternatively these fields can be filled in manually with the information received from the configuration page of Sofia2 showed in the first step 12 1 7 4 Select communication protocol 12 1 7 4 1 REST REST is a stateless communication protocol over HTTP Using this protocol the Cloud Connector is a client of the Sofia2 platform that periodically opens a connection with the platform to send ...

Page 93: ...ection Timeout Timeout to establish a connection Response Timeout Timeout to wait response from the Sofia2 server Auth user Optional MQTT protocol authentication user Auth password Optional MQTT protocol authentication password Figure Sofia2 MQTT protocol 12 1 7 4 3 Websocket It is a stateful communication protocol over HTTP Using this protocol the Cloud Connector is a client of Sofia2 platform th...

Page 94: ...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 button Figure Sofia2 synchronization service running You can stop the process at any moment by clicking on the Stop button Figure Sofia2 synchronization service stopped ...

Page 95: ...rigger condition action based rule engine for alert notifications or to control actuators and results in the form of an event timeline 12 1 8 1 Get API Key Get the Gateway ID to register Open the Meshlium Manager System Click Cloud Connector Open the ThingPlus plugin You can see ThingPlus configuration and Gateway ID Copy the Gateway ID Get the API Key Go to your ThingPlus service if you have no r...

Page 96: ...I 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 Figure Enter API Key in the ThingPlus plugin Click the Save button ThingPlus gateway app will restart If the status is STOPPED then click on the Start button after saving API Key ...

Page 97: ... same MAC address when registering gateway Select Device Model as Waspmote Basic Input Device Address Waspmote address is the id_wasp field Input Device Name Select Sensors to register all sensors are selected as default Select Site Name default Click Register a Gateway Devices and Sensors button ThingPlus gateway app will restart and send the sensor data in a few minutes You can see the sensor da...

Page 98: ...rag and drop Mashup Builder empowers developers and business users to rapidly create rich interactive applications real time dashboards collaborative workspaces and mobile interfaces without the need for coding Execution and Storage Engine ThingWorx s event driven execution engine and 3 Dimensional storage allows companies to make business sense of the massive amounts of data from their people sys...

Page 99: ...rver Click on the Save button to write this setup to the ThingWorx service The steps to setup Waspmotes to send to ThingWorx are Click on the button Load local WM This will read Waspmotes that have data in the sensor database Figure Getting Waspmotes from the system A panel with the devices is displayed with a list of the sensors received from each Waspmote Figure Waspmotes to be send to ThingWorx...

Page 100: ... services the setup will be applied and you will see your devices in your ThingWorx server If you click again on the Get Waspmotes from DB button the plugin will read again the DB and display all the Waspmotes If you do not write this changes to ThingWorx setup this will not propagate to the EMS service You can recover the current ThingWorx EMS service setup by clicking on the Load WM from ThingWo...

Page 101: ... the data is and allows secure efficient communication back to the ThingWorx Platform This section will concentrate on the EMS and the corresponding Edge Thing software components In order to send data to the ThingWorx environment another component is needed the LUA Script Resource service This service needs to be running at the same time with Edge Micro Server to allow data acquisition To launch ...

Page 102: ...TTP More information http aws amazon com iot With this plugin Waspmote sensor data can be directly integrated with Amazon AWS IoT broker Figure Amazon IoT plugin 12 2 1 1 Register Meshlium in Amazon IoT To register Meshlium in Amazon IoT you have to create a thing in your Amazon AWS IoT dashboard attach a security certificate and policy statement and copy the parameters to the plugin Follow these ...

Page 103: ... 103 v7 3 Cloud Connectors MeshliumXtreme 3 Create a security certificate and download the files for later use Figure Save the credential files when connecting device ...

Page 104: ...opy 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: ...on Log Level Generate log messages From fewer to more details the levels are OFF ERROR INFO DEBUG REPORT Default is OFF Topic template Topic of your message The user can use these wild cards creating a personalized structure ID Unique identifier for data MESHLIUM Host name of the Meshlium unit ID_WASP Identifies the Waspmote unit ID_SECRET Secret identifier SENSOR Identifies the sensor VALUE Value...

Page 106: ...m 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 or Stopped Figure Amazon IoT sender is running You can stop the Amazon IoT program anytime clicking on the Stop button Figure Amazon IoT sender is stopped ...

Page 107: ...ata from your Waspmote or Plug Sense units Please access to the Cumulocity cloud configurator in the Manager System You need to fill the following fields with your correct Cumulocity account settings Figure Configuring Cumulocity in Meshlium IP address Address provided by Cumulocity Port number Port Number provided by Cumulocity User Username provided by Cumulocity Password Password provided by Cu...

Page 108: ... your Meshlium in the authentication server The server provides you with credentials which you will enter in the form below When you finish configuring click the Save button to save the configuration Figure SmartCityPlatform cloud connector configuration panel Hostname the IP or hostname of the sensor broker Port the port where the sensor broker is listening for connections Account server the IP o...

Page 109: ...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 To stop the synchronization simply click on the red Stop button on the right Figure SmartCityPlatfo...

Page 110: ... service of Telefónica IoT This address should be provided without the http usually int dca tid es Port The port in which the API listens to connections API The security key to send data to Telefónica IoT All this data are provided by Telefónica service administrators 12 2 4 2 Controlling synchronization The synchronization will be done in packs of 100 data at a time so the system is not overloade...

Page 111: ...nition B Using the Meshlium Manager System web browser interface Access the Telit deviceWISE TR 50 Cloud Platform Configuration Panel Enter and Save the configuration details for your Meshlium including the Application Token created above Start the deviceWISE TR 50 Sensor Processing Service Once your Telit IoT Cloud account has been configured with the new Thing Definitions and Application in supp...

Page 112: ...es how often the cloud connector should check for and process newly received data frames from the associated Waspmote Edge devices Valid values range from 30 to 120 seconds Process Limit specifies the maximum number of waiting records to process during the data frame processing cycle Valid values range from 8 to 200 Once all settings are provided save the configuration settings by pressing the Sav...

Page 113: ...oper 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 To initiate the connection from the Meshlium gateway to the Telit IoT Cloud Platform and start the background service awaiting data frames from Waspmote s...

Page 114: ...iumXtreme 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 ...

Page 115: ...g the access to the Host Click on the Save button for storing the configuration fields 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 button In the OpenGate OSS web portal you could check the different values collected by Meshlium and by the Waspmote units which have sent messages using the...

Page 116: ...um setup for synchronizing with the BaseN Platform Figure Configuration of Microagent Receiver Id Unique ID of this Microagent receiver Path Measurement data path for data storage Username Username for authentication of Microagent receiver Password Password for authentication of Microagent receiver 12 3 2 2 Configuring BaseN Platform in Meshlium Use the same Microagent receiver parameters in the M...

Page 117: ...etting the parameters save the configuration clicking on the Save icon 12 3 2 3 Start BaseN Cloud Connector Click on Start for Cloud Synchronization A green icon should start rolling to indicate synchronization is running 12 3 2 4 Verify BaseN Cloud Connector synchronization Go to the BaseN Platform wiki where the Microagent Receiver and MicroAgentConfig were configured and check under Debug Infor...

Page 118: ...mation about VoT Platform http www votplatform com 12 3 3 1 Configuration A new option is shown in the M2M Platforms menu the B Scada Cloud Connector If you expand it you can see this form with 6 fields in it Figure Configuring B Scada in Meshlium URL IP address of the VoT platform service by B Scada This address should be provided by B Scada Port The port in which the VoT Server is listening to c...

Page 119: ...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 If you click on Start the synchronization will begin Figure B Scada synchronization service is running You can stop the synchronization at any moment clicking on the Stop button Figure B Scada synchronization service is stopped ...

Page 120: ...ls If you do not have C2M credentials please click the Sign Up button at the bottom of the screen to register Figure C2M logging 12 3 4 2 Controlling synchronization 1 Select the Onboard tab and press the button on the Waspmote Sensors that you wish to onboard Turn the switch On to enable the Waspmote Sensor To Disable the Channel Toggle the On Off switch to Off To Delete the Channel Press the Tra...

Page 121: ...e Stop button to terminate the C2M Sync service To temporarily pause a node toggle the On Off switch to Off and press Save Figure C2M Data Transfer tab 4 Login to your C2M account at https cloud c2m net login aspx to analyze visualize and automate your data Figure C2M log There is also a Log tab Here you will find access to various log levels Default log view is set to WARNING Once you change the ...

Page 122: ...rnal logging Save Button Clickto savetheServerAddress Meshlium Bind Name and Logging configuration Load Local Waspmotes button Click this button to load the list of Waspmotes that the Meshlium is connected to Load WM Config from DeviceLynk button Click to load the list of Waspmotes which are connected to the DeviceLynk Server Write DeviceLynk Setup button Clickto write thecurrentlistofWaspmotes to...

Page 123: ...hlium Bind Name that the DeviceLynk Server will use to identify the Meshlium device 3 Click the Save button 4 Click the Load Local Waspmotes button All Waspmotes connected to this Meshlium unit will show up 5 Delete the Waspmotes that you do not want to be connected to the DeviceLynk Server by clicking on their respective Delete button 6 Click the Write DeviceLynk Setup button to make the DeviceLy...

Page 124: ...this box is checked then any time field contained in a Meshlium database record will be used as the eagle io timestamp for the record If this box is not checked the data reception time of the record will be used as the eagle io timestamp After changing any of these parameters save the configuration by clicking the Save button then restart the eagle io synchronization if it is currently running by ...

Page 125: ...d sites concurrently Ensura uses its Sensor Server to receive data from the Meshlium devices over HTTP requests 12 3 7 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 i...

Page 126: ...onfiguration overview Sync Interval Sets the number of seconds to synchronize with AppIoT The default value is 60 seconds Please take into consideration when setting this value that Meshlium is a resource constrained device The shortest synchronization interval is 30 seconds Records per sync Sets the number of sensor values read from the Meshlium s database per synchronization The default value is...

Page 127: ...ton will start the connector When clicked it changes into a stop button To stop the connector press the red stop button Figure Gateway status Serial numbers The drop down lists all the Waspmotes available and or registered in AppIoT The configured state between AppIoT and the Waspmotes are displayed next to the Waspmote ID There are 3 states Not registered Registered and Registered Not seen The No...

Page 128: ...he Meshlium or when registered in AppIoT If the Waspmotes are already transmitting to your Meshlium use the copy function to get the correct IDs Save and start A restart of the connector is always required for saved changes to take effect Stop the connector before saving 12 3 8 4 Notes When registering a Waspmote in AppIoT the serial number used in AppIoT must correspond to the serial number shown...

Page 129: ...ions following the configuration steps described for ArcGIS Online service 12 3 9 1 ArcGIS Online We can configure in this form all the parameters needed to connect and send data to the ArcGIS Online platform Figure ArcGIS Online configuration The parameters to setup are esri_user User for the Esri ArcGIS online platform esri_password Password for this Esri user esri_service_name Name of the servi...

Page 130: ...home signin html Click on the option named Gallery and you should see a new Feature Server with the name that you provided in the Meshlium configuration plugin Figure ArcGIS Gallery Opening the new content you should see a map where each layer is one sensor type available in your project Clicking on the table icon all the data collected for this type of sensor will be displayed Figure ArcGIS senso...

Page 131: ...ote name Must match with the Waspmote identifier used with the frame See chapter Capturing and storing sensor data for more information Description A description of that Waspmote unit Sensor count Number of sensors on that Waspmote Must match with the number of fields of the frame See chapter Capturing and storing sensor data for more information And click on the Add button To modify a Waspmote cl...

Page 132: ...on 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: ...xtunda server is listening for connections User Name Password This is the Extunda Server username password to be used for connecting to Extunda servers This information will be provided by Extunda Waspmote ID When you login to your Extunda IoT platform account with your username and password you are authorized to define and match your Waspmote with a specific definition i e Istanbul_gases_1 Your W...

Page 134: ...etween Meshlium and HaibuSmart Figure HaibuSmart architecture 12 3 11 2 Registering your Meshlium with HaibuSmart Add your API KEY in the HaibuSmart panel of the Cloud Connector tab in the Manager System Enter your API KEY choose the Log Level and press Save Figure HaibuSmart Cloud configuration 12 3 11 3 Synchronization services Pressing the Start Button the HaibuSmart Cloud Connector will be lau...

Page 135: ...roker you will need to login to the Meshlium Manager for configuration Navigate to Cloud Connector Basic Cloud Partner infiswift You will need to complete the following fields in the infiswift Configuration Figure Configuration panel With this plugin the Waspmote sensor data can be directly integrated with an infiswift MQTT broker Pull required configuration information from infiswift portal using...

Page 136: ... Template This is the message template of the data you want to send Meshlium generates a default template but you can provide your own if it is aligned with the Meshlium specifications Meshlium will start to listen for and ingest data coming from your device and then forward it to infiswift s cloud 12 3 12 2 Controlling synchronization Once infiswift s swiftPV server broker is configured the user ...

Page 137: ...ware and server The platform is continuously developed further with new features and options Easy to get started and integrated You can use the platform as a service SaaS or PaaS or deploy to your own servers We can integrate IoT Ticket with any of your other information systems Flexibility and choice Use the whole IoT Ticket platform or part of it Use IoT Ticket specific electronics or use your o...

Page 138: ...asily 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 The configuration is split into three parts Login Configuration Connector Settings and Waspmote Filtering as well as a section for information about the current status of the connector with contro...

Page 139: ...t Values less than 60 seconds may consume high system resources Sleep between queries is the time the program sleeps between SQL queries in order to conserve resources Max size of SQL query is the maximum number of results for a single SQL query to the Meshlium database Values greater than 200 may lead to high system load The section also allows for configuring connector logging Log file max size ...

Page 140: ...by ticking the Waspmote filtering active checkbox Figure Waspmotes list Refresh Waspmotes reloads the list of Waspmotes from the Meshlium database Select Unselect All allows for quick selection or deselection of all present Waspmotes The Waspmote infobox contains the following values Name in the top left shows the name a Waspmote broadcasts to the Meshlium with its readings this is set in Waspmote...

Page 141: ... link View log files will allow you to see the status of the running connector via its log files A filtered set of this logging data will also be available as a data node in your IoT Ticket enterprise 12 3 13 6 IoT Ticket view Once the connector is running you can use your web browser to see the Meshlium data coming into your IoT Ticket Dashboards and Enterprise Manager on my iot ticket com In you...

Page 142: ... 142 v7 3 Cloud Connectors MeshliumXtreme 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 ...

Page 143: ...ng to the MQTT Server This field can be empty if no user is required Additionally the IoTSens plugin supports the configuration of some parameters regarding how the synchronization process works Sleeping time The synchronization process sleeps some time between executions This parameter configures how many seconds it will sleep before starting the synchronization process again once it has finished...

Page 144: ...lected features of the Kii Cloud SDK to accelerate IoT solutions Devices which are part of IoT solutions are called things in the Kii Cloud environment 12 3 15 3 Connector basics The Kii Cloud connector runs on Meshlium as an agent daemon that periodically checks the local database for incoming sensor data eg frames coming from remote Waspmotes The Meshlium unit itself is registered as a gateway a...

Page 145: ...ast allow for 1 second per frame in order to allow the daemon to keep up eg if you choose 200 frames select an interval of at least 200 seconds Log Level Enter the log level From fewer to more details the levels are OFF ERROR INFO DEBUG REPORT Default is OFF You can start and stop the service by using the Start Stop button in the Manager System plugin Figure Configuring Kii in Meshlium Figure Conf...

Page 146: ...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 A pop up box will appear with the node and you must click on it Now click on ts_history and you will see a list of sensor entries for that node Click on each of them to verify the sensor data ...

Page 147: ...ation 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 For more information http www labeeb iot com Figure Labeeb IoT plugin 12 3 16 1 Register Meshlium in Labeeb IoT Platform Create a Labeeb IoT account previously to register Meshlium in Labeeb IoT Platform http mea labeeb iot com...

Page 148: ...te portal account Username username of your portal account Password password of your portal account Log level used for debugging level errors reports etc Max number of records The maximum number of records to be synchronized to Labeeb IoT every some time interval Sync frequency sec specific time interval to perform synchronization defined in seconds 2 Save the configuration by pressing the button ...

Page 149: ...t state Running or Stopped The Meshlium Labeeb IoT cloud connector will start sending the data of any new Waspmote device to Labeeb IoT Platform after a maximum of 60 min Figure Labeeb IoT sender is running You can stop the Labeeb IoT script anytime by clicking on the Stop button Figure Labeeb IoT sender is stopped You can get all the data sent from the Waspmote devices on the Labeeb IoT portal Cl...

Page 150: ...plugin is located in Manager System Cloud Connector IoT Platforms MQTT Solutions In Server Broker Configuration the user can set IP Address Server IP address Port number Server port number User Server user name to log in the MQTT system Password Server password to log in the MQTT server Topic template Topic of your message The user can use these wild cards creating a personalized structure MESHLIU...

Page 151: ...it is recommended to work with a 24 7 server with static IP address 12 3 17 2 Controlling status Once configured the server broker the user can launch the Meshlium MQTT program Start button The program will search for the received frames on the local database and will send them to the broker via MQTT protocol The status indicator displays the current state saying Running or Stopped Figure MQTT sen...

Page 152: ...shed with a royalty free license for many years and companies such as Eurotech formerly known as Arcom have implemented the protocol in their products Here are a number of notable projects that have made use of MQTT and related technologies Companies like Cisco Eclipse Foundation Eurotech IBM Kaazing M2Mi Red Hat Software AG TIBCO and Carriots among other companies are working with this protocol M...

Page 153: ...gyourownAPI keyyouhavetosendamailtoservices orchestra itwiththesubject 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 Figure Configuring Orchestra Below there are a couple of images showing where you will find the API i...

Page 154: ...ing on the Save button in the same section Figure Orchestra platform API panel 12 3 18 2 Configuration Figure Orchestra Cloud Connector configuration panel API Base URL You must enter the API URL that you are going to use for collecting the Meshlium data Secret Key The secret key to access the API Client Id Security key used for validating the access to the Host Click on the Modify button to enabl...

Page 155: ...n 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 button ...

Page 156: ...nnector configuration panel User this field recognizes the information sent to Redd by you Token unique identifier that enables access of your information to Redd Click on the Save button for storing the configuration fields The tab log will allow you to see the status of the running connector via its log files 12 3 19 2 Controlling synchronization Once configured the Redd Cloud Connector you can ...

Page 157: ...Gateway Field to identify which Meshlium device the data came from when the platform receives the data so that we can trace the location Note In the Waspmote sensor board make sure you identify each board with their own ID so that we can trace which sensor board the data originated 12 3 20 2 Controlling synchronization The synchronization will be executed for all the data that has not been synchro...

Page 158: ...g plugin Server SensorUp IoT platform server Organization Identifier of your organization Service Key Key used to access SensorUp IoT platform All these parameters are provided by SensorUp 12 3 21 2 Controlling synchronization Once you have saved the configuration you can send your data to the SensorUp IoT platform by pressing the Start button You will notice about it because the screen shows a sp...

Page 159: ...he http Connection Port The port in which the API listens to connections Sentilo Provider The provider is the identity of who is sending data to Sentilo Sentilo Key The security key to send data to Sentilo This data will be provided by the administrators of the Sentilo system you are using Sensor Types and Components are not created automatically you need to manually create them in Sentilo as a pr...

Page 160: ...ticated and authorized into the Cloud Service with a specific set of credentials provided through the Self Care portal These credentials are not stored on the Meshlium or by the Connector and will have to be entered manually each time an Auto Configuration action is requested through the web GUI This functionality runs on the user s browser that is connected to the Meshlium device and requires Int...

Page 161: ... of DB records The minimum number of new database records that will trigger a sending procedure of the Connector If the found new number of records is lower strictly than the value of this parameter the transmit phase will be suspended until the number or records reaches the threshold or the condition expires see Maximum transmit interval in Simfony Meshlium Connector User Guide Default 1 Aggregat...

Page 162: ...unicating with the Simfony Cloud MQTT and HTTP Both of them are available in the encrypted version also i e MQTT SSL and HTTPS The customer it is able to choose the most appropriate protocol for his application Each Cloud Connector Meshlium device must be individually authenticated and authorized before it can send data to the Simfony Cloud Service The IoT platform will perform protocol specific a...

Page 163: ...eshlium to the SmartPlants system via an e mail from Smartplants 12 3 24 2 Controlling synchronization Once you configured the server broker the user can launch the Meshlium SmartPlants script clicking on the Start button The program will search for the received frames on the local database and will send them to the Smartplants Cloud platform via an MQTT protocol The status indicator displays the ...

Page 164: ...omers and new income It allows to connect the business processes with field devices through Internet of things IoT services This platform allows Enable remote services management of devices Communicate through secure protocols with field devices Manage devices and their messages remotely through programming interfaces API 12 3 25 1 Configuring SAP HANA To make the connection between the platform a...

Page 165: ...clicking the Save button at the bottom of the configuration form 12 3 25 3 Controlling synchronization After saving the configuration you can now start the service To do this click on the Start button Figure TechEdge status Running When the service has started Platform Status is displayed in green and the Start button changes to Stop Note The Data synchronization with Meshlium will be held as maxi...

Page 166: ...vices perform actions like taking images activation on systems industrial control etc Interfacing with 3rd party devices allows Meshlium to execute actions manually or automatically responding to events detected in the info sent by Waspmote or Plug Sense and received on Meshlium Meshlium Device Connector Meshlium runs the software necessary for implementing the analysis of its internal database an...

Page 167: ...by default is OFF Execution interval Time interval between checking camera s rules In the Add Camera panel the user can set Name Device rule name IP IP address of the camera User User name configured on the camera Password The password configured on the camera by the user defined in the previous step PTZ Preset Preset of the camera to be used when the rule is executed For obtaining a list of avail...

Page 168: ... Device connectors MeshliumXtreme 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 ...

Page 169: ...en The image names will vary depending if the picture was taken manually or automatically Manually the name of the file will be NAME_YYYY MM DD_HH MM SS jpg Automatically the name of the file will be NAME_WASPNAME_SENSORNAME jpg 13 1 1 3 Controlling synchronization Once the devices are configured the user can launch the Meshlium Axis service Start button The program will search for the received fr...

Page 170: ...send a hello message telling about their presence The information read from each user contains The MAC address of the wireless interface which allows to identify it uniquely The strength of the signal RSSI which gives us the average distance of the device from the scanning point The vendor of the smartphone Apple Nokia etc The WiFi Access Point where the user is connected if any and the Bluetooth ...

Page 171: ...n cities Smooth vehicle flows reduce journey times reduce emissions and save energy Similarly the efficient flow of pedestrians in an airport stadium or shopping center saves time and can make the difference between a good and a bad visit Monitoring traffic whether road vehicles or people is useful for operators of roads attractions and transport hubs Figure Vehicle Traffic Detection Applications ...

Page 172: ...e 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 ...

Page 173: ... smartphones Vehicle Traffic Monitoring Due to the reduction of the time between scanning intervals now vehicle traffic detection rate has increased from 50 to 80 even at a speed of 100 km h 62 miles h Monitor in real time the number of vehicles passing for a certain point in highways and roads Detect average time of vehicle stance for traffic congestion prevention Monitor average speed of vehicle...

Page 174: ...es can also be increased or decreased by using a different antenna for the module as it counts with a standard N Male connector The default antenna which comes with the scanning modules is an omnidirectional antenna with a gain of 5dBi How do I calculate the distance of any of the devices detected In the inquiry process we receive the MAC address of the Bluetooth device along with the Received Sig...

Page 175: ... the Scanner and must remain some seconds inside the coverage area to give time to the system to detect them The setup of the WifiScan feature in Meshlium is 40 seconds of scan span This means Meshlium Scanner listens for 40 seconds and then stores the results of the scan Android and iOS devices have a special option to disable WiFi connection when the user locks the screen in order to save batter...

Page 176: ...to ignore the polling request Nevertheless Bluetooth scan is still useful in some applications like car detection as most of modern cars have a Bluetooth hands free device and these devices are most of the time listening for connections Any smartphone can be configured to be visible or not by other Bluetooth devices Putting this option as NOT VISIBLE will make the smartphone undetectable by any ot...

Page 177: ...nistrator of Meshlium Scanner can perform real tests in order to find the exact value of this factor in the specific scenario under study 14 2 WiFi Scanner 14 2 1 Concepts The additional 2nd WiFi radio integrated in Meshlium Scanner allows to scan WiFi devices in a range of action up to 200 m depending on the line of sight conditions The idea is to search for WiFi devices in a defined interval whi...

Page 178: ... device and not allowing to track a user more than one day From this section the user can start and stop the service from the button next to the status indicator Figure WiFi Scanner was stopped 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 ...

Page 179: ...reme 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 ...

Page 180: ...oints or clients Just set how many and what kind of insertions you want to see and press the Show data button The maximum number of data to display is 500 The data from the database can be deleted pressing the button Delete all data Be careful as this option deletes all the information of WiFi scans in the local database There is an option to program an automatic purge in the database every day ke...

Page 181: ...ted in the external database up to 500 data Show the SQL script used to create the database and table needed for the synchronization Mark all data in the local database as synchronized so it will not be sent to the external database 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 ...

Page 182: ...able 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 This could make data in external database to be out of order As every data has a timestamp this should not be a problem for using the data in any external application ...

Page 183: ...07 56 25 00 26 7e 5f 3c 18 myCar 72 Handsfree PARROT SA 78005 2012 04 20 12 59 27 09 11 26 D8 2A 7E 0E C3 10 Tropic 85 Smartphone Nokia Corporation We can configure the Scanning Type which specifies the use of our Bluetooth Scanner Indoor type is recommended to scan static devices or devices with slow movement offices malls etc This option retrieves device names after about 15 seconds scanning Out...

Page 184: ... changed when disabled but already stored data is available to be shown To enable the service again click on the slider Enable Service Figure Enable and Disable controls Note Last versions of Android and iOS devices may need the Bluetooth Setup Screen be activated to be detected We have two different storage options for the data captured Local database This is always active External database This ...

Page 185: ... points or clients Just set how many and what kind of insertions you want to see and press the Show data button The maximum number of data to display is 500 The data from the database can be deleted pressing the button Delete all data Be careful as this option deletes all the information of Bluetooth scans in the local database There is an option to program an automatic purge in the database every...

Page 186: ...ted in the external database up to 500 data Show the SQL script used to create the database and table needed for the synchronization Mark all data in the local database as synchronized so it will not be sent to the external database 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 ...

Page 187: ...able 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 This could make data in external database to be out of order As every data has a timestamp this should not be a problem for using the data in any external application ...

Page 188: ...g the right points for your nodes Figure Fresnel calculator plugin 15 2 Iperf This tool lets you know the real bandwidth between Meshlium and an iperf server This plugin uses the correct interface in local networks and uses the default gateway for external networks The default gateway is 4G LTE if connected or Ethernet otherwise To use the tool enter the IP address or the host of the iperf server ...

Page 189: ... 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 ...

Page 190: ...cover 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 ...

Page 191: ...ks as the GPS position also gives information about the height of each point so the Fresnel Zone can be accurately known The GPS module gives us information about latitude longitude height meters speed km h date time Data captured form GPS is stored in the local database In addition the data can be synchronized to an external MySQL database to be used in an other systems Figure GPS storage options...

Page 192: ...s 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 Figure Enable control Figure Disable control The user can set the time interval between data acquisition Figure GPS data read interval The service can be manually started and stopped Figure Service stop button Figure Service start button ...

Page 193: ... last x records stored filtered by access points or clients Just set how many and what kind of insertions you want to see and press the Show data button The maximum number of data to display is 500 The data from the database can be deleted pressing the button Delete all data Be careful as this option deletes all the information of Bluetooth scans in the local database There is an option to program...

Page 194: ...the external database up to 500 data Show the SQL script used to create the database and table needed for the synchronization Mark all data in the local database as synchronized so it will not be sent to the external database 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 connect...

Page 195: ... as it is more relevant for decision making This could make data in external database to be out of order As every data has a timestamp this should not be a problem for using the data in any external application 15 7 Beep When configuring several Meshlium at the same time in the laboratory it can be difficult to distinguish between them specially when the IP addresses are given by a external DHCP r...

Page 196: ... can list the tables of the database Port 3306 User root Password libelium2007 You can use any management MySQL application like MySQL Workbench or SQLYog to access the database in Meshlium and perform any maintenance operation 16 2 PhpMyAdmin Meshlium has a built in PhpMyAdmin instance that allow local database management Go to Tools phpMyAdmin Click on Open in a new window to open the phpMyAdmin...

Page 197: ... 197 v7 3 Database management MeshliumXtreme Figure phpMyAdmin panel ...

Page 198: ...ge the hostname enter the desired value and press Save and Apply button Figure Hostname change form 17 2 Password management The Users Manager section is a plugin that allows to change the password needed to access to the Manager System The user is always admin To change it press Change Password button introduce and confirm new password and press Ok You can abort operation pressing Cancel Figure P...

Page 199: ...ser folder All the data captured XBee Scanner GPS is stored in this partition This partition also stores the logs of all the services Figure Disk usage plugin 17 4 Internal temperature sensor In this plugin the user can see in real time the processor temperature in Celsius degree Figure Temperature Sensors plugin A temperature above 70 ºC is considered high and a temperature above 100 ºC could be ...

Page 200: ...r to set the time manually selecting the time from the selectors and setting the timezone Press the Set button to apply the time selected Figure Manually selecting time and timezone In the plugin the user can use too an NTP server to perform a synchronization This option runs a one time synchronization but does not activate any service for continuous synchronization To perform the synchronization ...

Page 201: ...le from an URL 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 If there are new versions the plugin will display the changelog of every version and will show an Update button This button will download an...

Page 202: ...date and reboot Meshlium Considerations You have to finish the installation of a previous package in order to install the next one If you upload a new package without installing the previous one it will be removed 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 Al...

Page 203: ...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 button Press Install Update button to perform the update Meshlium will reboot after finishing the update process ...

Page 204: ...ocess will delete all the user information stored in Meshlium including sensor information stored in the internal database The rescue process can potentially damage the device and left it unusable The rescue process may not work if the file system is severely damaged 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 ...

Page 205: ...eshlium Power off the device Plug the USB pendrive in the micro USB connector trough a USB OTG cable Figure USB pendrive connected to Meshlium Power on the device When the rescue starts Meshlium will emit a beep The process can take a few minutes so be patient When the rescue process finishes Meshlium will emit several beeps to notify Power off Meshlium and unplug the USB pendrive Your Meshlium sh...

Page 206: ...umXtreme 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 ...

Page 207: ...tion added with NoIP2 agent Added new cloud plugins Ericsson infiswift PlasmaComp Redd System Updated cloud connectors Azure Hub Bluemix Augmented default log level in all the cloud plugins Corrected 4G connection bugs Corrected WiFiScan bug detection empty Version 4 0 2 Added support for new protocol Device to Cloud New cloud distribution premium advanced basic Added new cloud connectors Arrow Ha...

Page 208: ...vices Added compatibility with several radio modules Added Auto purge to sensor Bluetooth scanner WiFi scanner and GPS data Cellular connection mechanism improved Added Azure IoT Hub cloud connector Update process improved No reboot between updates needed Added option to synchronize with NTP server Improved speed and stability ...

Page 209: ... Redd System Redd Updated cloud connectors classification Added notes for NoIP config in the Interfaces menu From v7 0 to v7 1 Added new cloud connectors BaseN Cumulocity Ensura Kii Orchestra Microsoft Azure IoT Hub Nexmachina RedTone SensorUP SmartCityPlatform SmartPlants TechEdge SAP HANA Telit Updated cloud connectors Amazon IoT Microsoft Azure Event Hubs MQTT Sentilo Updated antenna position i...

Page 210: ...4 AP 900 US FCC PTCRB AT T IC Meshlium 4G 802 15 4 AP 900 AU RCM Meshlium 4G 802 15 4 AP 900 BR ANATEL 23 2 CE Europe Compliance with regulations Electromagnetic Compatibility EN 301 489 1 1 9 2 17 2 2 1 24 1 5 1 EN 55022 2010 Electrical Security EN 60950 1 2006 A11 2009 A1 2010 A12 2011 Ac 2011 A2 2013 except appendix Zx Figure Back sticker for Meshlium 4G 802 15 4 AP 868 EU ...

Page 211: ...t 15 247 2013 CFR 47 Part 15 247 2013 FCC Part 22 2014 FCC Part 24 2014 FCC Part 27 2014 PTCRB compliance Radiated Spurious Emissions 3GPP TS 51 010 1 s 12 2 x 3GPP TS 36 124 s 8 2 Bands LTE FDD2 FDD4 FDD5 FDD17 2G 900 1800 OTA CTIA Test Plan for Mobile Station OTA Performance v3 3 2 AT T document 13340 version 5 6 Device Requirements Bands LTE FDD2 FDD4 FDD5 FDD17 2G 900 1800 Measures TRP TIS ICS...

Page 212: ...lowing 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 RCM Australia Figure Back sticker for Meshlium 4G 802 15 4 AP 900 AU IC ...

Page 213: ...c components The antennas screw on gently to the connector do not force them while installing or you could damage the connectors Do not use any type of paint on the device it could affect the operation of connections and closing mechanisms Power accessories must only be used indoors Do not store Meshlium in places exposed to dirt and dust in order to avoid damage to electronic components Never ope...

Page 214: ...ts 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 Your distributor will advise you on the most appropriate and environmentally friendly way of disposing of the product and its packing ...