Trigger Automatic Reference Frame

Trigger Automatic Reference Frame

Overview

The Automatic Reference Frame Trigger feature allows the Touch Controller to automatically “clean” noise from sensor edges when specific touch conditions are met.

This is especially useful when:

  • False touches appear near sensor edges

  • EMI fluctuates during operation

  • Manual reference frames are impractical

Command Syntax

displaxservice -a 127.0.0.1 --te2fnref o x y

Parameters Explained

o – Edge Area Size
Defines how many rows/columns around the edges are affected.

Each row or column equals 50 units:

  • 1 line → o = 50

  • 2 lines → o = 100

  • 3 lines → o = 150

  • N lines → o = 50 × N

x – Touches at the Edges

  • Number of touches within the edge area required to trigger the reference

  • Recommended value: 2 or 3

y – Touches in Active Area

  • Number of touches allowed in the active area

  • Recommended value: 0 (no touches)

Example

displaxservice --te2fnref 100 2 0

This triggers a new reference frame when:

  • Two lines around all edges are monitored

  • There are 2 touches at the edges

  • There are 0 touches in the active area

Making the Setting Permanent

To save this configuration to the Touch Controller:

displaxservice --device-settings save



    • Related Articles

    • Trigger A New Frame Of Reference

      Overview The Frame of Reference feature in DISPLAX Service creates a baseline snapshot of the current sensor state, at the moment the controller receives power. This reference frame is then used as a comparison point for all subsequent signal ...

    • Shield

      Overview The Shield feature in DISPLAX Service is used to reduce the effects of electromagnetic interference (EMI) on a touch sensor. Increasing the Shield value helps suppress noise that can cause false touches or unstable touch behavior, especially ...

    • Count Number of Current Touches

      Overview The Current Number of Touches command reports how many touches are being detected at this exact moment. This is particularly helpful for: Detecting ghost or false touches Verifying palm or object rejection Monitoring live touch activity How ...

    • What is DISPLAX Service?

      DISPLAX Service Overview DISPLAX Service is a background process (agent/daemon) installed alongside DISPLAX Connect that enables low-level communication with your DISPLAX Touch Controllers. It acts as a command-line interface, allowing advanced ...

    • Limit the Number of Touches

      Overview DISPLAX Service allows you to limit the maximum number of simultaneous touches reported by a touch controller. This is useful for performance optimization, application compatibility, and filtering out unintended or excessive touch input. By ...