Nymi Bluetooth Endpoint uses the Bluetooth adapter to detect nearby Nymi Bands. NBE evaluates the signal strength of a Nymi Band against predefined RSSI settings to decide if a Nymi Band tap has occurred. .
To change how close a user needs to place the Nymi Band near the Bluetooth adapter for Nymi Bluetooth Endpoint to detect a tap, you can adjust the RSSI settings.
How you modify the RSSI parameters depends on the operating system:
- On Windows thick clients, edit the C:\Nymi\Bluetooth_Endpoint\nbe.toml file in administrator mode.
- On HP Thin Pro, edit the /usr/bin/nbe.toml file.
- On IGEL, in UMS, navigate to and define the partition parameters.
There are two types of RSSI parameters that define tap behaviour:
- Tap Windows parameters—Evaluates a defined number of RSSI measurements captured by the Bluetooth Adapter to determine a rolling average. The average allows the Nymi Bluetooth Endpoint to smooth out signal fluctuations and ignore outliers.
- Tap Threshold parameters—Define the specific RSSI levels that trigger an event. For example, when the average RSSI from the tap window parameters exceeds the tap threshold, Nymi Bluetooth Endpoint detects a tap.
The following table provides a list of supported RSSI parameters, their default values and the purpose of each parameter.
| RSSI Parameter | Default Value | Description |
|---|---|---|
| rssi_window_tap | 10 |
Defines how long the user must keep their Nymi Band within the tap threshold distance of the Bluetooth Adapter to complete a Nymi Band tap. A larger value increases the amount of time that a user must keep their Nymi Band within bluetooth range of the Bluetooth Adapter and decreases the sensitivity. |
| rssi_window_long | Bluegiga: 50 |
Defines how often the Nymi Bluetooth Endpoint service checks the distance between the Bluetooth Adapter and the Nymi Band. This helps determine proximity. Nymi Bluetooth Endpoint tracks trends in these changes to trigger a Nymi Lock Control action, such as keep unlocked when present, lock when away, or unlock when present. |
| rssi_tap_threshold | Bluegiga: -42
(must be 0 or negative) |
Determines the range at which a tap event will occur. A smaller
negative value means a closer distance to the BLE antenna.
BLE tap is disabled by default (value = 0). Enter a non-zero, negative number to enable BLE tap. If the Nymi Band maintains a minimum distance specified by rssi_tap_threshold, for the duration of time that is defined by rssi_window_tap, a BLE tap is performed. |
| rssi_cutoff_close | Bluegiga: -70
(must be 0 or negative) |
This determines the outer range of the close distance-threshold
(excluding tap distance) for Nymi Lock Control.
Enter 0 to bypass the proximity functionality of Nymi Lock Control. If the Nymi Band maintains a close distance to the BLE radio antenna and the RSSI values measured are within the rssi_cutoff_close value, Nymi Lock Control keeps the user terminal unlocked. If the Nymi Band moves away from the BLE radio antenna, and the RSSI values measured are on a decreasing trend and goes from the rssi_cutoff_close value to the rssi_cutoff_far value, Nymi Lock Control locks the user terminal. |
| rssi_cutoff_far | Bluegiga: -83
(must be negative) |
This determines the outer range of the far distance-threshold
(excluding tap distance) for Nymi Lock Control. If the Nymi Band moves towards the BLE radio antenna, and the RSSI values measured are on an increasing trend and goes from the rssi_cutoff_far value to the rssi_cutoff_close value, Nymi Lock Control unlocks the user terminal. |
The following figure provides an example of the Partition Parameters window in UMS with each RSSI value.
After you save the changes, restart the Nymi Bluetooth Endpoint, which reloads the parameter settings.
Comments
0 commentsPlease sign in to leave a comment.