Editing Nymi Bluetooth Endpoint Configuration for Various Use Cases

You can use Nymi Enabled applications such as Nymi Lock Control on Windows thick clients and through Windows Terminal Service from an HP Thin Pro or IGEL.

Nymi Bluetooth Endpoint defines Received Signal Strength Indicator(RSSI) parameters that control how the solution detects and responds to BLE taps.

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 System > Firmware Customization > Custom Partition > Partition and define the partition parameters.

Edit the RSSI values. The following table provides a list of supported RSSI parameters, their default values and the purpose of each parameter as outlined in the following table.

For IGEL, specify all RSSI parameter names in capital letters.

Note: On Windows and HP Thin Client, when the nbe.toml file is not present, Nymi Bluetooth Endpoint uses the default values. On IGEL, when the parameters are undefined in UMS, Nymi Bluetooth Endpoint uses the default values.
RSSI Parameter Default Value Description
rssi_window_tap 10

This determines the duration the Nymi Band must be within tap-distance of the BLE radio antenna to complete a tap.

A larger value increases the duration required to perform and decrease the sensitivity.

rssi_window_long 50

This determines the frequency that Nymi Bluetooth Endpoint checks the distance between the BLE radio antenna and the Nymi Band.

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

-42

(must be 0 or negative)

This 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. Nymi recommends an RSSI value of -42.

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

-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

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

Table 1. RSSI Values

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.

Articles in this section

Was this article helpful?
0 out of 0 found this helpful
Share

Comments

0 comments

Please sign in to leave a comment.