View source for Teltonika EYE device pairing and data sender configuration example

<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==

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'''].

==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.

[[File:Bluetootheyesensorconfiguration topology v1.png|800px|border|class=tlt-border]]

==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]

==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.

Navigate to '''Services -> Bluetooth''' and follow the steps below:
# Press on the toggle to '''Enable Bluetooth'''
# Press '''Scan'''

[[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)'''.

[[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.

[[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.

[[File:Bluetootheyesensorconfiguration detailssection v1.png|border|600px|class=tlt-border]]

==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:

[[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==

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:

[[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===
----
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_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
[[Category:Hardware application]]