Tag Effects

Tag Effects

Feedback Features: Light and Vibration

A DISPLAX Active OR Tag provides two types of feedback:

  • Light feedback through a full ring light around the tag

  • Vibration feedback using the built-in vibration motor

These features can be triggered in two ways:

  1. Programmatically using the
    DisplaxSDK

  2. In Displax Connect (mainly for testing purposes)

Note: After executing a feedback effect, the sleep mode timeout is reset.


Light Effects

To trigger a light effect, the following parameters must be defined along with the Tag ID:

  • color – RGB value (hexadecimal)

  • effect – predefined light effect ID

  • number of cycles – how many times the effect repeats

  • time duration – time in milliseconds for each cycle

Parameters in Detail

  • Color: RGB hex code (example: FF0000 for red)

  • Effect Types:

effect ID

Effect

Comments

0

FadeToColor

Fade from last effect color to new color. The fade takes time duration milisseconds to reach the final color.  

This effect is power consuming, as the final color will remain active, until a different effect is sent or the tag enters sleep mode.

1

Blink

Fade from last color to color (20% duty cycle), maintains the color (60% duty cycle), and fade to blackness (20% duty cycle).

2

ShortPulse

Fade from last color to color (20% duty cycle) and fade to blackness (80% duty cycle).

3

TriangularWave

Fade from last color to color (50% duty cycle) and fade to blackness (50% duty cycle).

4

ToothsawWave

Fade from last color to color (99% duty cycle) and goes to blackness (1% duty cycle).

5

Heartbeat

color (10% duty cycle), followed by blackness (10% duty cycle), followed by color with 20% brigthness (20% duty cycle), followed by darkness (60% duty cycle)



Vibration Effects

To trigger a vibration effect, the following parameters must be defined along with the Tag ID:

  • number of cycles – repetitions of the vibration sequence

  • level – vibration intensity (0–100)

  • time_on – milliseconds motor stays on per cycle

  • time_off – milliseconds motor stays off per cycle

Parameters in Detail

  • Number of cycles: Defines total repetitions. Each cycle = time_on + time_off.

  • Level: Vibration intensity (0 = none, 100 = max).

  • Time_on: Motor on duration (ms).

  • Time_off: Motor off duration (ms).

Example: With level = 80, number of cycles = 3, time_on = 200 ms, time_off = 100 ms, the motor vibrates strongly for 200 ms, pauses 100 ms, and repeats three times.


⚠️ Important Notes

  • Light and vibration effects can be used independently or together.

  • Use Displax Connect to test feedback functions before full SDK integration.

  • Effects reset the sleep mode timer, keeping the tag active longer.

    • Related Articles

    • Effects Editor

      Effects Editor in DISPLAX Connect The Effects Editor in DISPLAX Connect allows you to customize the color (light) and vibration effects of Active OR Tags. This feature is mainly used for testing, prototyping, or creating interactive feedback patterns ...
    • Light codes

      Light Codes – Active OR Tags DISPLAX Active OR tags use visual light effects (LED codes) to indicate their system state or the result of specific actions. Understanding these light codes helps ensure correct setup, troubleshooting, and use of the ...
    • DISPLAX SDK

      DISPLAX SDK For Application Integration The DISPLAX SDK is a bundle of lightweight libraries that provides developers with easy access to the DISPLAX Service. It simplifies communication by abstracting the API requests and notifications between your ...
    • Overview

      Overview DISPLAX Active Object Recognition (DPXActiveOR) is a complete solution combining hardware and middleware to enable developers to create next-generation interactive experiences that go far beyond traditional OR systems. With Active OR, ...
    • Active OR Pairing Video Tutorial

      Tags Pairing Video This video tutorial demonstrates how to pair Active Tags with your controller quickly and efficiently. Follow the step-by-step instructions to ensure all Tags are correctly recognized and connected, allowing you to take full ...