Sensors
The Sensors component displays read-only information from a TSC Series Gen 3 touch screen controller's Ambient Light Sensor, Proximity Sensor (TSC-70-G3 and TSC-101-G3 only), and Near Field Communications (NFC) Sensor. You can also configure a brightness threshold value to trigger the display to become brighter as ambient lighting conditions change, as well as configure a proximity threshold value to trigger the display to wake.
Note: To see the location of these sensors on the hardware, refer to the individual TSC Series Gen 3 hardware topics.
Ambient Light Sensor
All TSC Series Gen 3 touch screen controller models include an Ambient Light Sensor. This sensor is always enabled and produces a numeric value proportional to ambient light intensity. Greater light intensity (higher brightness) produces larger number values.
To view the numeric value of the sensor:
-
Drag the Sensors component into the schematic workspace.
-
Save and run the design to the Core.
-
Double-click the Sensors component to view the Brightness value of the sensor. Adjusting room lighting or placing an object over the sensor will change the reported Brightness value.
Tip: You can configure a threshold Brightness value to automatically trigger the display to increase its brightness level. To enable this feature, see the Auto Bright property.
Proximity Sensor
The TSC-70-G3 and TSC-101-G3 touch screen controller models include a Proximity Sensor. This sensor is always enabled and produces a numeric value proportional to detection of nearby objects. Detection of objects closer to the sensor produces larger numeric values. Sensitivity is greatest for objects within 0.5 meters of the front of the display. To view the numeric value of the sensor:
-
Drag the Sensors component into the schematic workspace.
-
Save and run the design to the Core.
-
Double-click the Sensors component to view the Proximity value of the sensor. Objects within the sensor’s range affect the numeric value displayed.
Tip: You can configure a threshold Proximity value to automatically wake the display. To enable this feature, see the Auto Wake property.
NFC Sensor
All TSC Series Gen 3 touch screen controller models include a wireless Near Field Communications (NFC) initiator/reader that is compliant with ISO and IEC standards and also supports custom protocols. The sensor is always enabled and can scan for, detect, and read passive targets that are within range of the sensor.
TSC Series Gen 3 touch screen controllers support Type 2 tags (T2T) that are compliant with ISO/IEC 14443A, including MiFare Classic and MiFare Ultralight tags having NTAG21x series ICs. Supported tags are commercially available in a variety of form factors and storage capacities. Q-SYS Designer Software components can be configured to display tag attributes and identification (UID) as well as the data content type or record type from non-encrypted tags.
To view attributes for a given target:
-
Drag the Sensors component into the schematic workspace.
-
Save and run the design to the Core.
-
Double-click the Sensors component to open the control panel.
-
Place a compatible T2T tag over the touch screen controller's NFC antenna until the NFC attributes are populated – typically within 1 to 3 seconds.
-
Click the Clear button to purge the attribute data. (A subsequent read event also purges the current attribute data.)
These properties are specific to the Sensors component for the TSC Series Gen 3 touch screen controllers. Other TSC touch screen property definitions can be found in the Status/Control (Touch Screen) topic.
Auto Bright
Select 'Yes' to expose the Auto Bright control in the Sensors component control panel, which allows you to configure a threshold brightness value that, when reached, automatically triggers an increase in the display's brightness level. Enabling and setting this control is especially useful when the display is placed in a room with changing lighting conditions, such as a room with exterior windows, skylights, etc. Auto Bright is disabled by default.
Note: Room reflections, the type and location of artificial lighting, and even UCI brightness and background color selection can impact the ambient light detected by the sensor. You might need to experiment with Auto Bright control value to achieve the desired result.
Auto Wake
Select 'Yes' to expose the Auto Wake control in the Sensors component control panel, which allows you to configure a threshold proximity value that, when reached, automatically wakes the display.
Note: Moving objects in a room not related to touch screen controller use can be detected by the sensor. You might need to experiment with the Auto Wake control to achieve the desired result.
Brightness
The current brightness level detected by the Ambient Light Sensor, from 0 to 2000. The higher the value, the brighter the lighting conditions.
Auto Bright
When the Auto Bright property is enabled, set the threshold brightness at which to trigger the screen to increase in brightness automatically, from 0 to 2000 (default is 500).
Proximity
The current proximity value for the detected objects in front of the Proximity Sensor, from 0 to 2000. The higher the value, the closer the detected objects are to the sensor.
Auto Wake
When the Auto Wake property is enabled, set the threshold proximity at which to trigger the display to wake, from 0 to 2000 (default is 500).
NFC UID
This is the detected read-only unique identifier provided by the tag manufacturer.
NFC ATQA
This is the detected read-only Answer to Request value.
NFC SAK
This is the detected read-only Select Acknowledge value.
NFC Type
This is the detected read-only NFC tag type.
NFC Payload
This is the detected payload data from the tag.
Pin Name |
Value |
String |
Position |
Pins Available |
---|---|---|---|---|
NFC |
||||
ATQA |
(text) |
Output |
||
Clear |
(trigger) |
Input / Output |
||
Payload |
(text) |
Output |
||
SAK |
(text) |
Output |
||
Type |
(text) |
Output |
||
UID |
(text) |
Output |
||
Sensor |
||||
Auto Bright |
0 to 2000 |
0 to 2000 |
0 to 1.00 |
Input / Output |
Auto Wake |
0 to 2000 |
0 to 2000 |
0 to 1.00 |
Input / Output |
Brightness |
0 to 2000 |
0 to 2000 |
0 to 1.00 |
Output |
Proximity |
0 to 2000 |
0 to 2000 |
0 to 1.00 |
Output |