When mounting your tag, make sure that the UWB antenna of the tag is facing upwards if possible for optimal positioning accuracy.

The Device Configurator is a separate tool designed to easily configure Mini tags and Wearable tags via NFC, and Developer tags using USB. It can be used to change the tag’s positioning protocol (TDOA or TWR), its ID, its UWB settings, and its positioning parameters such as update rate and more.

For use with NFC, a USB NFC reader is required. The NFC reader shown below is typically delivered together with your Mini tags or Wearable tags:

For use with USB, a USB data cable is delivered in your Enterprise kit.

Download & Installation

The Pozyx Device Configurator is available for download from www.pozyx.io/products-and-services/device-configurator. More information about the installation is also available on this page.

Configuring your tag

After starting the Pozyx Device Configurator, connect the tag to your computer. The Developer tag can be connected with the provided USB data cable. The Mini tag or Wearable tag should be placed on the NFC reader, which is connected with USB to your computer. The settings of your tag will become visible once the tag is correctly connected and USB/NFC is selected.

UWB settings

With these settings, you can change UWB related parameters such as the UWB channel, the data rate, the preamble length of the UWB transmission, the pulse repetition frequency and the UWB transmission power. Changing these settings also requires a change of the settings in the gateway via the Pozyx web application as described in the UWB settings section to ensure that both the tags and the system are aligned.
Power of the tag should be selected high enough so that the surrounding anchors can receive the UWB packets from the tag. On the other hand, it is not always beneficial to use the highest available power, as higher power may also result in more reflections of the UWB signal. In an optimal configuration, minimal power is assigned that still results in good connection with the surrounding anchors.

ALOHA TDOA

With these parameters, you can configure the update rate of the tag and control the variation. The update rate is the number of times per second a new positioning transmission is sent. One position transmission is called a ‘blink’. The variation is a parameter to control the possibility of packet collisions between multiple tags. Keeping this to 10 ms should be fine in most cases.

Accelerometer settings (only for Mini and Wearable tag)

The UWB update rate is adjustable and gives the frequency of the number of position updates. The accelerometer data of the tag is used to control the automatic sleep functionality of the Mini and Wearable tag. The tag will automatically decrease its update rate when it is not moving. The sleep mode functionality is configurable by the following settings:

  • Sleep delay: the tag can only go into sleep mode if it is not moving for at least a number of blinks equal to the sleep delay.
  • The sleep threshold setting determines the amount of movement required for the tag to remain active.
  • Skipped blinks gives the number of blinks that will be left out and not sent when the tag is in sleep mode.

For example, if the tag has an update rate of 10 Hz (10 blinks per second), a sleep delay of 25 blinks, skipped blinks equals 50 and the threshold is set to 150 mg; the tag will go to sleep if the tag did not reach the 150 mg threshold during 25 blinks (2.5 seconds). When in sleep mode, the tag will only send a blink every 50 blinks (every 5 seconds). If at any time the tag experiences movement higher than the threshold, the sleep delay counter is reset to 0 and the tag will resume updating at the configured update rate (10 Hz).

Button configuration (only for the Interactive Wearable tag)

With the Pozyx Device Configurator you can configure a multitude of settings to customize the behavior of the button and LED to best suit your needs. Disabling the button all together can be done by selecting “Off” in the Actions selector.

For other configurations you can press the “Configure Actions button” to create your own button configuration profile:

  • The long press can be configured to activate/deactivate the tag.
  • By default, the short press will send an event ID. This is configurable.
  • A third option is to cycle through different states when pressing the button. Up to 3 different states can be configured and will be cycled through 1 2 3 1 2…
  • Similar functionality is possible with the double press. Both types of presses have separate configurable event ID’s.

The event and state information are available through the MQTT API.

CommandDescription
Long pressPress and hold the button for 3 seconds
Single pressPush the button for less than 1 second
Double pressPush the button twice in half a second

Depending on the configuration the following table gives the LEDs behavior per action:

DescriptionActionLED behavior
Long pressActivateGreen LED lights up for 1 second
DeactivateRed LED lights up for 1 second
Single pressSend an eventGreen LED blinks 1 time
Double pressSend an eventGreen LED blinks 2 times
Single/Double press
configured for changing state
Change stateColor of the state gets blinked.
State 1: Green
State 2: Blue
State 3: Red
By default, the LED will blink once per second, and the color of the LED will indicate the current state. However, the default behavior can be disabled in the configuration.

Battery impact

The default settings provide the best battery life. Changing to a lower data rate or to a longer preamble length will result in a higher power consumption. The same is true for a higher TDOA update rate, the use of TWR and accelerometer update rate; the more updates that are sent the more the tag will use its battery capacity. Disabling the LED to blink every second will also slightly improve the battery life.

Caveats

We recommend that the update rate of the TDOA and accelerometer are roughly aligned. One blink can contain a maximum of 28 accelerometer measurements.

This means that e.g. if we have an accelerometer update rate of 25Hz and a TDOA update rate of 0.5Hz, 50 measurements will need to be sent in one blink. If this situation occurs, the tag will throw away the first 22 measurements and only transmit the last 28 measurements.
If you don’t want to lose any accelerometer updates, make sure your update rates comply to the following formula:

(Accelerometer update rate (Hz))/(TDOA update rate (Hz)) < 28