Difference between revisions of "Teltonika EYE device pairing and data sender configuration example"

From Teltonika Networks Wiki
(37 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<p style="color:red">The information in this page is updated in accordance with firmware version '''[https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads 00.07.03.2]'''.  
 
<p style="color:red">The information in this page is updated in accordance with firmware version '''[https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads 00.07.03.2]'''.  
  
==Introduction and prerequisites==
+
==Introduction==
  
 
In this article, we will explore the usage of Teltonika Eye sensors and beacons with Teltonika Networks devices. The Teltonika Eye sensor is a powerful tool that allows for monitoring and tracking of vehicles and other mobile assets. When paired with Teltonika devices, the sensor can provide a wealth of information such as identification, temperature, humidity and even movement.
 
In this article, we will explore the usage of Teltonika Eye sensors and beacons with Teltonika Networks devices. The Teltonika Eye sensor is a powerful tool that allows for monitoring and tracking of vehicles and other mobile assets. When paired with Teltonika devices, the sensor can provide a wealth of information such as identification, temperature, humidity and even movement.
  
For this use case, we are going to need Teltonika Networks device with '''Bluetooth functionality''', for example, RUTX11. We are also going to need either a [https://teltonika-gps.com/eye/?gclid=Cj0KCQiAw8OeBhCeARIsAGxWtUyTO_kjiPfwAv1v_4Z_r7kg9AsD3a-4dU9sbOfyGgf2uDOm4lXfefMaAgJAEALw_wcB '''Teltonika EYE sensor'''] or [https://teltonika-gps.com/eye/?gclid=Cj0KCQiAw8OeBhCeARIsAGxWtUyTO_kjiPfwAv1v_4Z_r7kg9AsD3a-4dU9sbOfyGgf2uDOm4lXfefMaAgJAEALw_wcB '''Teltonika EYE beacon'''].
+
==Prerequisites==
 +
 
 +
For this use case, we are going to need Teltonika Networks device with Bluetooth support, for example, RUTX11. We are also going to need either a [https://teltonika-gps.com/eye/?gclid=Cj0KCQiAw8OeBhCeARIsAGxWtUyTO_kjiPfwAv1v_4Z_r7kg9AsD3a-4dU9sbOfyGgf2uDOm4lXfefMaAgJAEALw_wcB Teltonika EYE sensor] or [https://teltonika-gps.com/eye/?gclid=Cj0KCQiAw8OeBhCeARIsAGxWtUyTO_kjiPfwAv1v_4Z_r7kg9AsD3a-4dU9sbOfyGgf2uDOm4lXfefMaAgJAEALw_wcB Teltonika EYE beacon].  
  
 
==Connection topology==
 
==Connection topology==
  
Connection topology in this case is simple, we are going to send Bluetooth data from either '''EYE sensor''' or '''EYE beacon''' using [[RUTX11_Data_to_Server|Data to server]] functionality. More detailed topologies are presented in the configuration sections.
+
Connection topology in this case is simple, we are going to send Bluetooth data from either EYE sensor or EYE beacon using [[RUTX11_Data_to_Server|Data to server]] functionality.
  
[[File:Bluetootheyesensorconfiguration topology v1.png|800px|border|class=tlt-border]]
+
[[File:Bluetootheyesensorconfiguration topology v1.png|600px|border|class=tlt-border]]
  
==Adjusting EYE device protocol and settings==
+
==Adjusting EYE device Protocol and settings==
  
 
The Teltonika Eye sensor supports several Bluetooth protocols, including iBeacon and Eddystone. By supporting both Protocols, the Teltonika Eye sensor can be used in a variety of different applications and environments. For more information regarding these settings, please refer to this article: [https://wiki.teltonika-gps.com/view/EYE_BEACON_/_BTSID1#EYE_App_Configuration EYE App configuration]
 
The Teltonika Eye sensor supports several Bluetooth protocols, including iBeacon and Eddystone. By supporting both Protocols, the Teltonika Eye sensor can be used in a variety of different applications and environments. For more information regarding these settings, please refer to this article: [https://wiki.teltonika-gps.com/view/EYE_BEACON_/_BTSID1#EYE_App_Configuration EYE App configuration]
Line 19: Line 21:
 
==Connecting Bluetooth sensors to the device==
 
==Connecting Bluetooth sensors to the device==
  
Follow these steps to pair either EYE sensor or EYE beacon to the RUTX11 or another Teltonika device of your choice.
+
Follow these steps to pair either EYE sensor or EYE beacon to the device.
  
Navigate to '''Services -> Bluetooth''' and follow the steps below:
+
* Navigate to '''Services -> Bluetooth'''
# Press on the toggle to '''Enable Bluetooth'''
+
* Press on the toggle to '''Enable Bluetooth''' (1)
# Press '''Scan'''
+
* Press '''Scan''' (2)
  
 
[[File:Bluetootheyesensorconfiguration enablebluetoothscan v1.png|border|600px|class=tlt-border]]
 
[[File:Bluetootheyesensorconfiguration enablebluetoothscan v1.png|border|600px|class=tlt-border]]
  
Once the Scan is finished, you should be able to see a list with all Bluetooth devices around. You can identify your EYE device by looking at the MAC address on top of it. To Pair an EYE device to our RUTX11, simply select it '''(1)''' and press Pair '''(2)'''.
+
Once the Scan is finished, you should be able to see a list with all Bluetooth devices around. You can identify your EYE device by looking at the MAC address on top of it. To Pair an EYE device to our RUTX11, simply select it (1) and press Pair (2).
  
 
[[File:Bluetootheyesensorconfiguration scanlist v1.png|border|1000px|class=tlt-border]]
 
[[File:Bluetootheyesensorconfiguration scanlist v1.png|border|1000px|class=tlt-border]]
  
If the EYE device has paired successfully, you should be able to find it in the '''Paired Devices''' list. Press on the '''Details''' button to view if the details and protocol are displayed correctly.
+
If the EYE device paired successfully, you should be able to find it in the Paired Devices list. Press on the Details button to view if the details and protocol are displayed correctly.
  
 
[[File:Bluetootheyesensorconfiguration detailsdevice v1.png|border|1000px|class=tlt-border]]
 
[[File:Bluetootheyesensorconfiguration detailsdevice v1.png|border|1000px|class=tlt-border]]
  
Here is how the information should be displayed if you connect Bluetooth EYE Sensor and press the '''Details''' button. You should be able to see information like Humidity, Temperature, Signal Strength, Battery Voltage, etc.
+
Here is how the information should be displayed if you connect Bluetooth EYE Sensor and press the Details button. You should be able to see information like Humidity, Temperature, Signal Strength, Battery Voltage, etc.
  
 
[[File:Bluetootheyesensorconfiguration detailssection v1.png|border|600px|class=tlt-border]]
 
[[File:Bluetootheyesensorconfiguration detailssection v1.png|border|600px|class=tlt-border]]
Line 41: Line 43:
 
==Bluetooth Data to Server via MQTT protocol==
 
==Bluetooth Data to Server via MQTT protocol==
  
In this section, we are going to upload Bluetooth data to server using MQTT Protocol. Here is the connection topology to help you understand things better:
+
In this section, we are going to upload Bluetooth data to server using MQTT Protocol.
 
 
[[File:Eyedevice mqttsection.png|border|800px|class=tlt-border]]
 
 
 
Prerequisites for this example:
 
*MQTT Broker
 
*MQTT Subscriber
 
 
 
You could set up MQTT Broker on Teltonika device, or use an external service as a broker. In order to subscribe to the topic, we are going to use [https://mosquitto.org/ Mosquitto] application.
 
 
 
===Data sender setup===
 
----
 
Follow these steps to configure Data to server functionality:
 
* Navigate to '''Services -> Data to server'''
 
* Press '''Add''' to add new data sender
 
 
 
[[File:Bluetootheyesensorconfiguration addnewsender v1.png|border|1000px|class=tlt-border]]
 
 
 
In the next screen, adjust settings accordingly:
 
 
 
# '''Enable''': on
 
# '''Name''': BT_MQTT (input any preferred name)
 
# '''Data source''': Bluetooth data
 
# '''Protocol''': MQTT
 
# '''JSON format''': {"Data": "%b", "Hour": "%d"} - adjust JSON format according to your needs
 
# '''Segment count''': 1
 
# '''URL/Host/Connection string''': 192.168.1.139 (MQTT broker address)
 
# '''Topic''': BT_data
 
 
 
Leave everything else as default and press '''Save & Apply'''
 
 
 
[[File:Bluetootheyesensorconfiguration mqttdata v1.png|border|600px|class=tlt-border]]
 
 
 
===MQTT Subscriber setup and testing===
 
----
 
Follow these steps to subscribe on the '''BT_data''' topic and get the Bluetooth data via MQTT:
 
* Navigate to your '''Mosquitto''' installation folder
 
* While holding '''Shift''' key, use '''Mouse right-click''' an press '''Open Powershell window here'''
 
 
 
[[File:Bluetootheyesensorconfiguration powershell v1.png|border|300px|class=tlt-border]]
 
 
 
Once open, input this command to subscribe on the topic:
 
 
 
<pre>
 
.\mosquitto_sub -t BT_data -h 192.168.1.139
 
</pre>
 
 
 
Here '''-t''' option means topic and '''-h''' is used to set MQTT broker IP address.
 
 
 
If everything is set up correctly, you should be able to see incoming MQTT messages:
 
 
 
[[File:Bluetootheyesensorconfiguration mqttsub v1.png|border|1000px|class=tlt-border]]
 
  
 
==Bluetooth Data to Server using HTTP protocol==
 
==Bluetooth Data to Server using HTTP protocol==
  
In this section, we are going to upload Bluetooth data to server using HTTP Protocol. Here is the connection topology to help you understand things better:
+
In this section, we are going to upload Bluetooth data to server using HTTP Protocol. We are going to use a [https://www.hw-group.com/software/hercules-setup-utility Hercules] app as a TCP server to get incoming data from the device.
 
 
[[File:Eyedevices Httpserversection.png|border|800px|class=tlt-border]]
 
 
 
We are going to use a [https://www.hw-group.com/software/hercules-setup-utility Hercules] app as a TCP server to get Bluetooth sensor data from the device.
 
  
 
===Data sender setup===
 
===Data sender setup===
Line 106: Line 53:
 
Follow these steps to configure Data to server functionality:
 
Follow these steps to configure Data to server functionality:
 
* Navigate to '''Services -> Data to server'''
 
* Navigate to '''Services -> Data to server'''
* Press '''Add''' to add new data sender
+
* Press Add to add new data sender
  
 
[[File:Bluetootheyesensorconfiguration addnewsender v1.png|border|1000px|class=tlt-border]]
 
[[File:Bluetootheyesensorconfiguration addnewsender v1.png|border|1000px|class=tlt-border]]
  
In the next screen, adjust settings accordingly:
+
In the new screen, adjust settings accordingly:
 
 
# '''Enable''': on
 
# '''Name''': BT_HTTP (input any preferred name)
 
# '''Data source''': Bluetooth data
 
# '''Protocol''': HTTP
 
# '''JSON format''': {"Data": "%b", "Hour": "%d"} - adjust JSON format according to your needs
 
# '''Segment count''': 1
 
# '''URL/Host/Connection string''': 192.168.1.211:8080 (server address and port)
 
 
 
Leave everything else as default and press '''Save & Apply'''
 
 
 
[[File:Bluetootheyesensorconfiguration httpdatatoserver v1.png|border|600px|class=tlt-border]]
 
 
 
===TCP server setup and testing===
 
----
 
Since we are using Hercules application as TCP Server, the setup is simple: start the application and switch to the TCP Server tab. Make sure to listen on the same port '''(1)''' as set up in data sender configuration ('''8080''' for this example) and you should see the Bluetooth data incoming '''(2)'''.
 
 
 
[[File:Bluetootheyesensorconfiguration herculesdata v1.png|border|600px|class=tlt-border]]
 
 
 
==Summary==
 
 
 
This configuration example demonstrates the process of pairing Teltonika Bluetooth Eye Sensors and Beacons with a RUTX11 router. The setup also includes testing the functionality of Bluetooth data transmission to a server using both HTTP and MQTT protocols. The example provides a step-by-step guide on how to connect the sensors and beacons to a router and effectively send data to a remote server for analysis and processing.
 
 
 
==References==
 
 
 
[https://teltonika-gps.com/eye/?gclid=Cj0KCQiAw8OeBhCeARIsAGxWtUyTO_kjiPfwAv1v_4Z_r7kg9AsD3a-4dU9sbOfyGgf2uDOm4lXfefMaAgJAEALw_wcB Teltonika EYE sensor] - More information about Teltonika EYE sensor
 
 
 
[https://teltonika-gps.com/eye/?gclid=Cj0KCQiAw8OeBhCeARIsAGxWtUyTO_kjiPfwAv1v_4Z_r7kg9AsD3a-4dU9sbOfyGgf2uDOm4lXfefMaAgJAEALw_wcB Teltonika EYE beacon] - More information about Teltonika EYE beacon
 
 
 
[[RUTX11_Data_to_Server|RUTX11 Data to server]] - More information about Data to Server functionality
 
 
 
[https://wiki.teltonika-gps.com/view/EYE_BEACON_/_BTSID1#EYE_App_Configuration EYE App configuration] - Teltonika EYE App configuration
 
 
 
[https://mosquitto.org/ Mosquitto] - Mosquitto MQTT Client
 
  
[https://www.hw-group.com/software/hercules-setup-utility Hercules] - Hercules TCP Client / Server application
+
*'''Enable''': on
[[Category:Hardware application]]
+
*'''Name''': BT_HTTP (input any preferred name) (1)
 +
*'''Data source''': Bluetooth data (2)
 +
*'''Protocol''': HTTP (3)
 +
*'''JSON format''': {"Data": "%b", "Hour": "%d"} - adjust JSON format according to your needs (4)
 +
*'''Segment count''': 1 (5)
 +
*'''URL/Host/Connection string''': 192.168.1.211:8080 (server address and port) (6)
 +
* Leave everything else as default and press '''Save & Apply'''

Revision as of 13:47, 25 January 2023

Main Page > General Information > Configuration Examples > Hardware application > Teltonika EYE device pairing and data sender configuration example

The information in this page is updated in accordance with firmware version 00.07.03.2.

Introduction

In this article, we will explore the usage of Teltonika Eye sensors and beacons with Teltonika Networks devices. The Teltonika Eye sensor is a powerful tool that allows for monitoring and tracking of vehicles and other mobile assets. When paired with Teltonika devices, the sensor can provide a wealth of information such as identification, temperature, humidity and even movement.

Prerequisites

For this use case, we are going to need Teltonika Networks device with Bluetooth support, for example, RUTX11. We are also going to need either a Teltonika EYE sensor or Teltonika EYE beacon.

Connection topology

Connection topology in this case is simple, we are going to send Bluetooth data from either EYE sensor or EYE beacon using Data to server functionality.

Bluetootheyesensorconfiguration topology v1.png

Adjusting EYE device Protocol and settings

The Teltonika Eye sensor supports several Bluetooth protocols, including iBeacon and Eddystone. By supporting both Protocols, the Teltonika Eye sensor can be used in a variety of different applications and environments. For more information regarding these settings, please refer to this article: EYE App configuration

Connecting Bluetooth sensors to the device

Follow these steps to pair either EYE sensor or EYE beacon to the device.

  • Navigate to Services -> Bluetooth
  • Press on the toggle to Enable Bluetooth (1)
  • Press Scan (2)

Bluetootheyesensorconfiguration enablebluetoothscan v1.png

Once the Scan is finished, you should be able to see a list with all Bluetooth devices around. You can identify your EYE device by looking at the MAC address on top of it. To Pair an EYE device to our RUTX11, simply select it (1) and press Pair (2).

Bluetootheyesensorconfiguration scanlist v1.png

If the EYE device paired successfully, you should be able to find it in the Paired Devices list. Press on the Details button to view if the details and protocol are displayed correctly.

Bluetootheyesensorconfiguration detailsdevice v1.png

Here is how the information should be displayed if you connect Bluetooth EYE Sensor and press the Details button. You should be able to see information like Humidity, Temperature, Signal Strength, Battery Voltage, etc.

Bluetootheyesensorconfiguration detailssection v1.png

Bluetooth Data to Server via MQTT protocol

In this section, we are going to upload Bluetooth data to server using MQTT Protocol.

Bluetooth Data to Server using HTTP protocol

In this section, we are going to upload Bluetooth data to server using HTTP Protocol. We are going to use a Hercules app as a TCP server to get incoming data from the device.

Data sender setup


Follow these steps to configure Data to server functionality:

  • Navigate to Services -> Data to server
  • Press Add to add new data sender

Bluetootheyesensorconfiguration addnewsender v1.png

In the new screen, adjust settings accordingly:

  • Enable: on
  • Name: BT_HTTP (input any preferred name) (1)
  • Data source: Bluetooth data (2)
  • Protocol: HTTP (3)
  • JSON format: {"Data": "%b", "Hour": "%d"} - adjust JSON format according to your needs (4)
  • Segment count: 1 (5)
  • URL/Host/Connection string: 192.168.1.211:8080 (server address and port) (6)
  • Leave everything else as default and press Save & Apply