© 2020 Nexmosphere. All rights reserved. v1.0 / 11-20
All content contained herein is subject to change without prior notice
N ex m o s p h e re
Le H av re 1 3 6
5 6 2 7 SW E i n d h ove n • T h e N e t h e r l a n d s
T
+ 3 1 4 0 2 4 0 7 0 7 0
E
s u p p o r t @ n ex m o s p h e re.c o m
4
PRODUCT MANUAL | XT-EF SERIES AIR GESTURE SENSOR
3.3 - AirWheel
The XT-EF Series can detect circular gestures ("AirWheels")
within the detection field of the sensor. The output for
AirWheel detection can be set to two different modes:
"incremental" and "absolute value". Per default, AirWheel
detection is disabled. It can be activated by sending one of
the following settings:
Enable AirWheel incremental mode
Enable AirWheel absolute value mode
Incremental mode
When the mode is set to incremental, an API output is
send each time an AirWheel is detected. The API output
for these triggers is as follows:
X001B[Wd=CW]
AirWheel direction CLOCKWISE
X001B[Wd=CCW]
AirWheel direction COUNTER-
CLOCKWISE
Absolute value mode
When the mode is set to absolute value, the sensor
keeps track of a value between 1-100 and increases this
value when the detected AirWheel direction is clockwise
and decreases this value when the detected direction is
counter clockwise. The API output for AirWheel detection
in "absolute value" mode is as follows:
X001B[Wv=XXX]
AirWheel value
(XXX = 001-100)
When implementing AirWheel triggers, consider the
following:
• The amount of API triggers per full rotation can be
adjusted. Please see section 3.4 "Settings", page 9.
• When the absolute value has reached 100 (max),
clockwise rotations will not result in new API triggers.
The same goes for value 1 (min) and counter clockwise
rotations.
• The sensitivity/range of the AirWheel detection level
is fixed and can't be adjusted.
• The maximum range for AirWheel detection is
different for each XT-EF sensor model. Please see the
overview on page 1 for more info.
• When an AirButton command is send while executing
an AirWheel, consider increasing the AirButton
delay setting. For more info please see section 3.4
"Settings", page 9.
Air Wheel
Clockwise
Air Wheel
Counter-
clockwise
XT-EF650
transceiving side
LEFT
UP
DOWN
RIGHT
XT-EF650
transceiving side
LEFT
UP
DOWN
RIGHT
EF sensor
fix
ed
Sideview illustration of
an AirWheel gesture
with indication of the
(fixed) detection range
X001S[7:2]
X001S[7:3]
X001B[SETW=XXX]
The airwheel value can be (re)set to a value between 001-
100 by sending the following API command:
For example, to set the AirWheel value to 075, send:
X001B[SETW=075]
Set AirWheel value
(XXX= 001 - 100)
