View source for NBL-3


==Introduction to the product==
[[File:NBL-3.png|right|frameless|300x300px]]

'''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.
*[[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.
*[[FMC130_Features_settings#iButton_Read_Notification|ID read notification]] - functionality allows to control digital output while card is present.
*[[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:'''

* 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==
{| class="wikitable"
|-
|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.230''' or newer. 

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

[[File:NBL3 11.png|frameless|660x660px]]

'''Mandatory setting condition: Non Stop Scan'''

[[File:Nbl2 22.png|frameless|350x350px]]

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 „[[Template:FMB I/O settings#Operand On Change|On Change]]“.

[[File:Nbl2 31.png|frameless|999x999px]]

Trip > Remember iButton
[[File:NBL3 Advanced Trip settings.png|left|frameless|alt=|220x220px]]



Features > Immobilizer
[[File:NBL3 Immobilizer.png|left|frameless|alt=|440x440px]]



Features > ID read Notification
[[File:NB3 ID Read notification.png|left|frameless|alt=|300x300px]]

<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>

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

[[File:NBL3_conf12_1.png|alt=|frameless|500x500px]]

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

[[File:Nbl2 4.png|frameless|335x335px]]


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

[[Private/Business Driving Mode Functionality|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.

==Testing NBL-3 RFID card reading and Buttons==
<br>
==== 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):

[[File:NBL-2 cfg1.png|frameless|900x900px]]

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

[[File:NBL-2 cfg2.png|frameless|900x900px]]


==== 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:
{| class="wikitable"
|+
!EIR Type
!Description / Value
!LEN
|-
|Flags – 0x01
|0x06 
GeneralDiscoverable, 

BrEdrNotSupported
|3B
|-
|Complete name – 0x09
|‘NBL-3’
|7B
|-
|Service data – 0x16
|Data format
{| class="wikitable"
!BYTE:
!0..1
!2
!3
!4..5
!6..7
!8
!9
!10..18
|-
|Field:
|UUID
|Status
|Batt
|Temp
|Humi
|Light
|CID_Len
|CID
|}
{| class="wikitable"
!Field
!Description
|-
|UUID
|‘NX’
|-
|Status
|Data format:
{| class="wikitable"
|+
!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.