Skip to content

1.3 Preferred Settings

In this section, we will discuss the settings of your device connection and how to change them.

Changing connection settings

Your connection settings need to be changed before you are connected to your device. The easiest way to achieve this is by using the didStartConnecting callback function.

override fun didStartConnecting(device: NIMMSTADevice) {
    // Change connection settings here
}

@Override
public void didStartConnecting(NIMMSTADevice nimmstaDevice) {
    // Change connection settings here
}

prefersReconnect

If set to true the device should automatically try to reconnect if the connection is lost.

Default is true.

device.prefersReconnect = true

nimmstaDevice.setPrefersReconnect(true);

reconnectTimeout

Defines the TimeSpan (typically in ms) until no reconnection attempt will occur anymore.

Default is 30 minutes.

device.reconnectTimeout = TimeSpan(1000.0)
device.reconnectTimeout = 20.minutes

nimmstaDevice.setReconnectTimeout(20); // 20 min

prefersShutdownOnCharge

If set to true the scanner should shut down when placed on the charging pad.

Default is false.

device.prefersShutdownOnCharge = false

nimmstaDevice.setPrefersShutdownOnCharge(false);

preferredTriggerMode

Defines when scanning should be triggered.

  • Use the default trigger mode when enabled (DefaultEnabled)
  • By Motion Trigger (Beta), Button Press, and by pressing on the touchscreen (MotionAndButtonAndTouch)
  • By Motion Trigger (Beta) and by pressing on the touchscreen (MotionAndTouch)
  • By Motion Trigger (Beta) and by button press (MotionAndButton)
  • By Motion Trigger (Beta) only (Motion)
  • By Button press and by pressing on the touchscreen (ButtonAndTouch)
  • Only by button press (Button)
  • Only by pressing on the touchscreen (Touch)
  • Disabled (Disabled)

Default is ButtonAndTouch.

device.preferredTriggerMode = ChangeTriggerModeRequest.ScanTriggerMode.ButtonAndTouch

nimmstaDevice.setPreferredTriggerMode(ChangeTriggerModeRequest.ScanTriggerMode.ButtonAndTouch);

preferredPickingMode

Defines if PickingMode is enabled or disabled.

In PickingMode if the button is pressed red crosshairs are shown while no barcodes will be scanned yet. Only the second time scanning is triggered a barcode will be scanned. The crosshairs are disabled after a timeout.

If PickingMode is disabled scanning must be triggered until a barcode is scanned.

Default is Disabled.

device.preferredPickingMode = ChangeTriggerModeRequest.ScanPickingMode.DISABLED

nimmstaDevice.setPreferredPickingMode(ChangeTriggerModeRequest.ScanPickingMode.DISABLED);

Enable Motion Trigger

To enable our motion trigger (Beta), globally, there is a new setting available. It will then always allow for using the motion trigger when the trigger mode allows for the "Button" being triggered.

connectionManager.interpretButtonAsMotionTrigger = true

connectionManager.setInterpretButtonAsMotionTrigger(true);

Decoder Board Settings

Decoder Board Settings can be used to change how the scan engine works. You can disable or enable symbologies and much more options. Most options are configurable using the Configurator in the B2B Portal. If you need even more options, feel free to contact support for more information.

To generate Decoder Board Settings, the easiest is:

  1. Create your Configuration using Configurator on the B2B Portal (NIMMSTA Config). Set your Settings using "Edit Symbologies for example"
  2. Download nimmstaconfig file ("Download Config", not installer)
  3. Unzip nimmstaconfig file (Rename to .zip and extract)
  4. Use hs50_settings.json file
  5. For Web Library: Put it in using device.hs50_settings. Put in JSON into constructor of HS50Settings object.
// Change DecoderBoardSettings to only allow QR Codes to be scanned
device.hs50Settings = HS50Settings("{\"decoderboardSettings\":{\"00\":\"00\",\"01\":\"00\",\"02\":\"00\",\"04\":\"00\",\"05\":\"00\",\"06\":\"00\",\"07\":\"00\",\"08\":\"00\",\"F163\":\"00\",\"09\":\"00\",\"F046\":\"00\",\"E3\":\"00\",\"0A\":\"00\",\"0B\":\"00\",\"0C\":\"00\",\"0D\":\"00\",\"0E\":\"00\",\"F16A\":\"00\",\"0F\":\"00\",\"53\":\"00\",\"54\":\"00\",\"55\":\"00\",\"59\":\"00\",\"F150\":\"00\",\"F073\":\"00\",\"5A\":\"00\",\"5B\":\"00\",\"5F\":\"00\",\"60\":\"00\",\"F80538\":\"00\",\"28\":\"00\",\"29\":\"00\",\"F140\":\"00\",\"F142\":\"00\",\"F022\":\"00\",\"F80772\":\"00\",\"F023\":\"00\",\"F145\":\"00\",\"F024\":\"00\",\"F026\":\"00\",\"2A\":\"00\",\"F8048F\":\"00\",\"F052\":\"00\",\"F053\":\"00\",\"F098\":\"00\",\"F054\":\"00\",\"F055\":\"00\",\"F056\":\"00\",\"7B\":\"00\",\"F13D\":\"00\",\"F13E\":\"00\"},\"appSettings\":{}}'")