Page tree
Skip to end of metadata
Go to start of metadata

User Interface

The user interface mainly consists of two panels. 

The panel on the left, Workspace Explorer, contains all items in the currently loaded workspace represented as nodes in the tree. Double click on a node to open the corresponding view. Note that not all nodes in the workspace have a view.

The panel on the right is the Document View. When a node in the workspace is opened it ends up as a document in the document view. Each document has its own tab in the top of the document view. The documents contain one or more sections that can be hidden/visible through an arrow button.


Notifications that contain status or error information appear in the top center of the application. For example, a status notification will appear when a sensor is connected or disconnected.

Sensor Information

The zForce AIR Sensor Gadget node contains sensor information such as firmware version, protocol version etc.

Sensor Configuration

The zForce AIR Sensor Device is used to control and configure the sensor.

Control Panel

These settings are sent to the sensor immediately after they are changed. 

  • The Is Enabled checkbox is used to enable or disable the sensor.
  • The Mode dropdown list contains the sensor modes: Detection and DetectionHid. Detection sends touches to Workbench and DetecionHid sends touches to the OS (DetectionHid corresponds to the HID Digitizer mode of the sensor).

Device Configuration

Configuration NameDescriptionUnit
Sub Area Low Bound XStart of the Touch Active Area (TAA) in X-direction0.1 mm
Sub Area Low Bound Y

Start of the TAA in Y-direction

0.1 mm 
Sub Area High Bound XEnd of the TAA in X-direction0.1 mm
Sub Area High Bound YEnd of the TAA in Y-direction0.1 mm 
Sub Area Reverse XInverts the X axisN/A
Sub Area Reverse YInverts the Y axisN/A
Sub Area Flip XYSwaps the X and Y axis. Other sub area configurations are applied after the swap.N/A
Sub Area Offset XAdds a static offset of the TAA in X-direction0.1 mm
Sub Area Offset YAdds a static offset of the TAA in Y-direction0.1 mm
Number Of Reported TouchesHow many objects the sensor detectsNumber of objects
Hid Display Size XDisplay size in X and Y-direction. Can for example be used when the screen size is larger than the TAA and the touches should be reported only inside the TAA (not scaled up to the entire screen). Only applicable in DetectionHid mode (HID Digitizer mode of the sensor).0.1 mm
Hid Display Size Y
Finger FrequencyScanning frequency when one or more fingers are detectedHz
Idle FrequencyScanning frequency when no finger is activeHz

Click Send Configuration to activate the current configuration. The sent configuration is temporarily stored in the workspace and then permanently stored when the workspace is saved.

Click Set Original Configuration to revert back to the sensor configuration used when it was first connected to Workbench.

If the Send Saved Configuration On Connect checkbox is enabled, the currently stored configuration is sent to the sensor when it is connected. This can be useful since the configuration is stored in RAM on the sensor, which means that the sensor will go back to default configuration after a power reset.


Tracking Visualizer

The Tracking Visualizer node is a touch visualizing tool. The tool contains a canvas for the active area of the sensor, an information table with the active touches with ID, X and Y coordinates and so on, as well as options regarding trailing and sizing.

Open/Short-Circuit Test

The Open Short Test node is an electrical test tool. There is a button to tell the sensor to perform an open short test on all photo diodes and laser diodes and report the result. The result will show up in the UI where every component that was tested are represented by a box with a number inside it. The box will either be green which indicates that the test has passed or red for fail.

Helper tool

The Message Generator Tool can be used to generate ASN.1 encoded messages in hexadecimal format. Simply choose the message to be generated and set the desired settings. This can for example be useful when using a microcontroller unit as a host for the sensor, and a specific message needs to be sent in hexadecimal ASN.1 format.

  • No labels