Difference between revisions of "NBL-3"

From Wiki Knowledge Base | Teltonika GPS
m (Text replacement - "Bluetooth(?!®)" to "Bluetooth®")
 
(39 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
 
==Introduction to the product==
 
==Introduction to the product==
 
[[File:NBL-3.png|right|frameless|300x300px]]
 
[[File:NBL-3.png|right|frameless|300x300px]]
Line 4: Line 5:
 
'''Description:'''
 
'''Description:'''
  
Netronix NBL-3 -  wireless Bluetooth RFID reader with additional buttons.
+
Netronix NBL-3 -  wireless Bluetooth® RFID reader with additional buttons.
  
 
'''NBL-3 is great in these use cases:'''
 
'''NBL-3 is great in these use cases:'''
 
*Authorized driving - track who is driving your vehicle. You will receive a card ID every time a driver applies a card to NBL-3 reader.
 
*Authorized driving - track who is driving your vehicle. You will receive a card ID every time a driver applies a card to NBL-3 reader.
*Private mode – this solution will allow your company car to be used by employees for personal purposes without violating the EU General Data Protection Regulations by masking all the personal data while vehicle is used in Private mode. Moreover, self-employed people can easily convert their own car into a business asset and ensure that the data provided (Example - distance traveled) is correct and shown only working hours' driven distance. Private/business mode can be easily switched by any of the NBL-3 buttons.
+
*[[Private/Business_Driving_Mode_Functionality|Business/Private mode]]  – this solution will allow your company car to be used by employees for personal purposes without violating the EU General Data Protection Regulations by masking all the personal data while vehicle is used in Private mode. Moreover, self-employed people can easily convert their own car into a business asset and ensure that the data provided (Example - distance traveled) is correct and shown only working hours' driven distance. Private/business mode can be easily switched by any of the NBL-3 buttons.
*ID read notification - functionality works when it's necessary to provide the output to the driver then the card is read.
+
*[[FMC130_Features_settings#iButton_Read_Notification|ID read notification]] - functionality allows to control digital output while card is present.
*Remember iButton - RFID card ID value is send to server while trip is detected.
+
*[[FMC130_Trip/Odometer_settings#Advanced_Trip_Settings|Remember iButton]] - functionality allows to remember RFID card ID value and send it to server while Trip scenario is detected.
*
+
 
  
  
 
'''Features:'''
 
'''Features:'''
  
*Mifare® Classic, Desfire card supports
+
* Mifare® Classic, Desfire card supports
*Bluetooth low energy module
+
* Bluetooth® low energy module
*Operating frequency - 13,56MHz
+
* Operating frequency - 13,56MHz
 
* Built in two LED indicators
 
* Built in two LED indicators
 
* Built in two buttons
 
* Built in two buttons
*Built in light sensor
+
* Built in light sensor
 
* UID and card DATA available
 
* UID and card DATA available
*Configure via BL link
+
* Configure via BL link
*Firmware update via Bluetooth
+
* Firmware update via Bluetooth®
 +
 
 
==Product Specification==
 
==Product Specification==
 
{| class="wikitable"
 
{| class="wikitable"
Line 33: Line 35:
 
|Sensor
 
|Sensor
 
|Humidity
 
|Humidity
 +
 +
Temperature
  
 
Light
 
Light
Line 51: Line 55:
  
  
==NBL-3 Configuration==
+
==Updating NBL-3 firmware==
'''For the NBL Tools application, contact the Netronix NBL manufacturer.'''
 
  
==='''Updating NBL-3'''===
+
Please visit https://netronix.pl/en/nbl-readers/nbl-3 download section for manual and NBL tool.
 
 
How to update the NBL-3 device is shown in the link below.
 
 
 
https://netronix.pl/en/nbl-readers/nbl-3
 
  
 
==Device configuration==
 
==Device configuration==
This functionality is available from firmware version FMB.Ver.03.29.00.Rev.230 or newer
+
NBL-3 support is available from firmware version '''03.29.00.Rev.233'''.
  
 
Setting up NBL-3 device to connect with FMB device.
 
Setting up NBL-3 device to connect with FMB device.
  
Go to Teltonika configurator -> Bluetooth 4.0 and set it up like it shown in this screenshot (MAC address will depend on your particular NBL sensor):
+
Go to Teltonika configurator -> Bluetooth® 4.0 and set it up like it shown in this screenshot (MAC address will depend on your particular NBL sensor):
  
[[File:NBL3 1.png|frameless|660x660px]]
+
[[File:NBL3 11.png|frameless|660x660px]]
  
 
'''Mandatory setting condition: Non Stop Scan'''
 
'''Mandatory setting condition: Non Stop Scan'''
  
[[File:Nbl2 2.png|frameless|350x350px]]
+
[[File:Nbl2 22.png|frameless|350x350px]]
  
 
Then go to I/O settings:  
 
Then go to I/O settings:  
Line 77: Line 76:
 
Make sure to enable the BLE RFID #1 parameter (ID: 51740). We would recommend to set the operand to „[[Template:FMB I/O settings#Operand On Change|On Change]]“.
 
Make sure to enable the BLE RFID #1 parameter (ID: 51740). We would recommend to set the operand to „[[Template:FMB I/O settings#Operand On Change|On Change]]“.
  
[[File:Nbl2 3.png|frameless|999x999px]]
+
[[File:Nbl2 31.png|frameless|999x999px]]
 
 
Trip > Remember iButton
 
[[File:NBL3 Advanced Trip settings.png|left|frameless]]
 
 
 
 
 
 
 
Features > Immobilizer
 
[[File:NBL3 Immobilizer.png|left|frameless]]
 
 
 
 
 
 
 
Features > ID read Notification
 
[[File:NB3 ID Read notification.png|left|frameless|alt=|300x300px]]
 
 
 
 
 
  
  
 +
Configuration options can be navigated in the windows below.
 +
[[File:NBL3 conf1.png|left|frameless|alt=|720x720px]]
  
  
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
  
 
+
==Setting up Private/Business mode ==
 
 
 
 
 
 
==Setting up Private/Business mode==
 
 
Make sure to enable Private/Business mode in Trip/Odometer settings. It can be done using SMS commands or a configurator. Not every device has these parameters visible in the configurator, therefore they should be configured via SMS commands. It can be done by sending  ''setparam'' SMS (how to send SMS commands: [[FMB120 SMS/GPRS Commands|https://wiki.teltonika-gps.com/view/FMB120_SMS/GPRS_Commands]]). Set it to High or Low priority (parameter ID: 11850). Enable triggers as NBL Button1 or NBL Button2 (parameter ID: 11811).
 
Make sure to enable Private/Business mode in Trip/Odometer settings. It can be done using SMS commands or a configurator. Not every device has these parameters visible in the configurator, therefore they should be configured via SMS commands. It can be done by sending  ''setparam'' SMS (how to send SMS commands: [[FMB120 SMS/GPRS Commands|https://wiki.teltonika-gps.com/view/FMB120_SMS/GPRS_Commands]]). Set it to High or Low priority (parameter ID: 11850). Enable triggers as NBL Button1 or NBL Button2 (parameter ID: 11811).
  
Line 116: Line 113:
 
[[Private/Business Driving Mode Functionality|More information about Private/Business Driving Mode Functionality.]]
 
[[Private/Business Driving Mode Functionality|More information about Private/Business Driving Mode Functionality.]]
  
==NBL-3 broadcasting behavior==
+
==NBL-3 broadcasting behaviour==
When NBL-3 device captures RFID value it keeps broadcasting it for roughly a minute (it varies). As of 2023.07.20 NBL-3 manufacturer Netronix states that it is currently impossible to detect when the same RFID is attached to NBL-3 device again (when RFID value is still present after first read). New RFID read can only indicated after NBL-3 value retention timeout is finished.
 
  
When attaching different cards each time to reader, all will be read without issues.
+
* When NBL-3 device captures RFID value it keeps broadcasting it for roughly a minute (it varies). NBL-3 manufacturer Netronix states that it is currently impossible to detect when the same RFID is attached to NBL-3 device again (when RFID value is still present after first read). New RFID read can only be indicated after NBL-3 value retention timeout is finished. When attaching different cards each time to reader, all will be read without issues.
 +
<br>
 +
 
 +
* During testing another behaviour was spotted, that if Netronix NBL reader being configured in Advanced mode, only configured features are being shown in I/O elements. However FW stops detecting button states and cannot trigger immobilizer feature even when RFID card is being successfully read in I/O. As well as for immobilizer, Private/Business mode does not change state while pressing buttons. Issue being fixed when same MAC being configured as NBL reader in second connection. For that reason 2 BLE Connections need to be used for correctly working functions of single reader.
  
 
==Testing NBL-3 RFID card reading and Buttons==
 
==Testing NBL-3 RFID card reading and Buttons==
'''1.    Using the Configurator'''
 
  
 +
====Using Telonika Configurator====
 
Power up the FMB device, connect it to PC and open Configurator application. Configure devices as shown above.
 
Power up the FMB device, connect it to PC and open Configurator application. Configure devices as shown above.
  
Line 137: Line 136:
  
  
'''2.    Using the Terminal application'''
+
====Using Terminal application====
  
 
Power up the FMB device, connect it to PC and start logging it into the Terminal application.  
 
Power up the FMB device, connect it to PC and start logging it into the Terminal application.  
Line 147: Line 146:
 
''IO ID[451]: 0x0000000000000000''
 
''IO ID[451]: 0x0000000000000000''
  
When the RFID card is activated (card touched to NBL-2 and followed by two beeps) BLE RFID #1 parameter should look like this:
+
When the RFID card is activated (card touched to NBL-3 and followed by two beeps) BLE RFID #1 parameter should look like this:
  
 
''IO ID[451]: 0x0004193EF2576680''
 
''IO ID[451]: 0x0004193EF2576680''
Line 225: Line 224:
 
|Temp
 
|Temp
 
|Humi
 
|Humi
|Light
+
| Light
 
|Card
 
|Card
|0
+
| 0
 
|B1
 
|B1
 
|B2
 
|B2

Latest revision as of 15:28, 28 December 2023

Introduction to the product

NBL-3.png

Description:

Netronix NBL-3 -  wireless Bluetooth® RFID reader with additional buttons.

NBL-3 is great in these use cases:

  • Authorized driving - track who is driving your vehicle. You will receive a card ID every time a driver applies a card to NBL-3 reader.
  • Business/Private mode – this solution will allow your company car to be used by employees for personal purposes without violating the EU General Data Protection Regulations by masking all the personal data while vehicle is used in Private mode. Moreover, self-employed people can easily convert their own car into a business asset and ensure that the data provided (Example - distance traveled) is correct and shown only working hours' driven distance. Private/business mode can be easily switched by any of the NBL-3 buttons.
  • ID read notification - functionality allows to control digital output while card is present.
  • Remember iButton - functionality allows to remember RFID card ID value and send it to server while Trip scenario is detected.


Features:

  • Mifare® Classic, Desfire card supports
  • Bluetooth® low energy module
  • Operating frequency - 13,56MHz
  • Built in two LED indicators
  • Built in two buttons
  • Built in light sensor
  • UID and card DATA available
  • Configure via BL link
  • Firmware update via Bluetooth®

Product Specification

Supply voltage two AAA batteries
Sensor Humidity

Temperature

Light

Magnetic field

Low battery voltage

Operating temperature -20ºC to +70ºC
Size (mm) 100 x 58 x 18
Type RFID reader


Updating NBL-3 firmware

Please visit https://netronix.pl/en/nbl-readers/nbl-3 download section for manual and NBL tool.

Device configuration

NBL-3 support is available from firmware version 03.29.00.Rev.233.

Setting up NBL-3 device to connect with FMB device.

Go to Teltonika configurator -> Bluetooth® 4.0 and set it up like it shown in this screenshot (MAC address will depend on your particular NBL sensor):

NBL3 11.png

Mandatory setting condition: Non Stop Scan

Nbl2 22.png

Then go to I/O settings:

Make sure to enable the BLE RFID #1 parameter (ID: 51740). We would recommend to set the operand to „On Change“.

Nbl2 31.png


Configuration options can be navigated in the windows below.

















Setting up Private/Business mode

Make sure to enable Private/Business mode in Trip/Odometer settings. It can be done using SMS commands or a configurator. Not every device has these parameters visible in the configurator, therefore they should be configured via SMS commands. It can be done by sending  setparam SMS (how to send SMS commands: https://wiki.teltonika-gps.com/view/FMB120_SMS/GPRS_Commands). Set it to High or Low priority (parameter ID: 11850). Enable triggers as NBL Button1 or NBL Button2 (parameter ID: 11811).

Don't forget to set up data masking in Private mode if necessary.

Nbl2 4.png


Don‘t forget to save all these changes to the device and you are ready to test the NBL-3 sensor.

More information about Private/Business Driving Mode Functionality.

NBL-3 broadcasting behaviour

  • When NBL-3 device captures RFID value it keeps broadcasting it for roughly a minute (it varies). NBL-3 manufacturer Netronix states that it is currently impossible to detect when the same RFID is attached to NBL-3 device again (when RFID value is still present after first read). New RFID read can only be indicated after NBL-3 value retention timeout is finished. When attaching different cards each time to reader, all will be read without issues.


  • During testing another behaviour was spotted, that if Netronix NBL reader being configured in Advanced mode, only configured features are being shown in I/O elements. However FW stops detecting button states and cannot trigger immobilizer feature even when RFID card is being successfully read in I/O. As well as for immobilizer, Private/Business mode does not change state while pressing buttons. Issue being fixed when same MAC being configured as NBL reader in second connection. For that reason 2 BLE Connections need to be used for correctly working functions of single reader.

Testing NBL-3 RFID card reading and Buttons

Using Telonika Configurator

Power up the FMB device, connect it to PC and open Configurator application. Configure devices as shown above.

When the RFID card is not enabled, the BLE RFID #1 parameter (AVL ID: 451) will show a specific value.

Example (Status tab => I/O Info):

NBL-2 cfg1.png

When the RFID card is activated (card touched to NBL-2 and followed by two beeps) BLE RFID #1 parameter should look like this:

NBL-2 cfg2.png


Using Terminal application

Power up the FMB device, connect it to PC and start logging it into the Terminal application.

When the RFID card is not enabled, the BLE RFID #1 parameter (AVL ID: 451) will show a specific value.

Example:

IO ID[451]: 0x0000000000000000

When the RFID card is activated (card touched to NBL-3 and followed by two beeps) BLE RFID #1 parameter should look like this:

IO ID[451]: 0x0004193EF2576680


When Private/Business mode is enabled (Button1 or Button2 is pressed):

IO ID[451]: 0x0000000000000000

and

IO ID[391]: 1

NBL-3 packet

NBL-T data is being read via broadcast packets only. The packet structure is described below:

EIR Type Description / Value LEN
Flags – 0x01 0x06

GeneralDiscoverable,

BrEdrNotSupported

3B
Complete name – 0x09 ‘NBL-3’ 7B
Service data – 0x16 Data format
BYTE: 0..1 2 3 4..5 6..7 8 9 10..18
Field: UUID Status Batt Temp Humi Light CID_Len CID
Field Description
UUID ‘NX’
Status Data format:
MSB LSB
Prox Temp Humi Light Card 0 B1 B2

Prox – state of magnetic field sensor

Motion – if 1, the measured temperature is outside the defined values

Motion – if 1, the measured humidity is outside the defined range

Light – if 1, the measured light is outside the definied range

Card – if 1, the ID is read

Btn1 – state of button 1

Btn2 – state of button 2


Batt Battery level in %
Temp Temperature
Humi Humidity
Light Light (8 oldest bits)
CID_Len ID length
CID ID card number
21B

Total packet length: 31B.