© 2021 Nexmosphere. All rights reserved. v1.0 / 08-21
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
2
PRODUCT MANUAL | XZ LIGHT SENSOR
3. Functionalities and API commands
The XZ Light sensor provides the following functionalities:
1. Pick-up and place-back detection
- detect if an object is picked-up or placed-back
2. Raw light measurement
- measure the raw value of the light reaching the sensor
When implementing pick-up or place-back detection,
consider the following:
• If the object or top panel is translucent, light can still
reach the sensor when the object is placed back. In
this case additional calibration might be required.
Please see page 3 and 4 for more information.
• Particularly in retail environments, LED strips are often
placed in such a way that the top panel is lit. In these
cases we recommend to add a small non-translucent
shaft in the cut-out, to block light coming from the lit
top panel. Please see page 3 for more information.
3.1 - Pick-up and place-back detection
When an object is picked up, light will reach the sensor and
an API command is triggered. Vice versa, when the object
is placed back, less light will reach the sensor and an API
command is triggered as well. These API messages have
the following format:
3.2 - Raw light measurement
The XZ Light sensor can also indicate the amount of
light reaching the sensor as a raw decimal value.
The raw decimal value is a unfiltered direct AD
conversion of the light measurement circuit and will
therefore fluctuate.
We recommend to not use Raw
Light values for normal operation
. Instead, the Raw
light measurement mode is intended to be used for
calibration purposes. Please see page 4 for more
information.
The following sections will cover each of these functionalities in detail. Please note that for each API example in this
document, X-talk interface address 001 is used (X001). When the sensor is connected to another X-talk channel,
replace the "001" with the applicable X-talk address.
Object is picked up
X
= raw light value
value between
0-255
Object is placed back
X001A[3]
X001A[
X
]
X001A[0]
light
dark
X001S[4:2]
Per default, the sensor is set to pick-up detection mode. In
order to activate Raw light measurement output, send the
following setting:
The higher the raw light value, the more light is reaching
the sensor. The lower the light value, the darker.
Example commands
The measured raw light value is "7"
The measured raw light value is "51"
The measured raw light value is "178"
X001A[7]
X001A[51]
X001A[178]
pick-up
place-back
