...
This page describes the parameters currently available in the Touch Sensor Module Firmware 1.55 and Neonode Touch Sensor Module Firmware 2.0 (NTSMF 2.0-BETA), except for ). The parameter "Scanning Range which " is only available in from NTSMF 2.0 -BETA through zForce Programmer.
The parameters described in this document can be adjusted by changing the Touch Sensor Modules configuration. These parameters can be configured using Neonode Workbench, an application using zForce SDK, Arduino Library (I2C) or zForce Programmer. The parameters that have been configured using either Neonode Workbench, zForce SDK or Arduino Library, are stored in the RAM memory, meaning that the new configuration will have to be re-applied after each reboot. If the parameters are instead configured using zForce Programmer, the parameters will not have to be re-applied after each reboot.
Configuration | Range | Measurement | Default | Description |
Range Settings | Sets the scanning range dynamically | |||
Scanning Range | 10-1·mm | Mechanical Data (col. B * 10) | Scanning range with max value according to column B (extended range available for 295, 310 and 346 mm Touch Sensor Modules).The area (width and height / columns and rows) the TSM will scan for an object with lasers and photodiodes (PD). This value also sets the limit for Max Y below. | |
Touch Active Area Adjustments | Contains settings for modifying the active touch area and the reported touch coordinates | |||
Low Bound X (Min X) | 10-1·mm | 36 | Start position of the (Sub)TAA in x-direction. Min X, Max X, Min Y & Max Y make up the Touch Active Area. | |
Low Bound Y (Min Y) | 10-1·mm | 0 | Start position of the (Sub)TAA in y-direction. Min X, Max X, Min Y & Max Y make up the Touch Active Area. | |
High Bound X (Max X) | 10-1·mm | Mechanical Data (col. A * 10) + 36 | End position of the (Sub)TAA in x-direction. Min X, Max X, Min Y & Max Y make up the Touch Active Area. | |
High Bound Y (Max Y) | 10-1·mm | Mechanical Data (col. B * 10) | End position of the (Sub)TAA in y-direction. Min X, Max X, Min Y & Max Y make up the Touch Active Area. | |
Reverse X | True/False | Boolean | False | Reverses the x-coordinates of reported touches. |
Reverse Y | True/False | Boolean | False | Reverses the y-coordinates of reported touches. |
Flip XY | True/False | Boolean | False | Swaps the y- with the x-coordinates of the reported touches. |
Offset X | 10-1·mm | 0 | Offsets the projected (Sub)TAA in x-direction, on the display. | |
Offset Y | 10-1·mm | 0 | Offsets the projected (Sub)TAA in y-direction, on the display. | |
HID Display Size | The size of the display reported by the Touch Sensor Module to the host. Only usable when connecting with USB HID | |||
Hid Display Size X | 10-1·mm | Mechanical Data (col. A * 10) | Width of the display. | |
Hid Display Size Y | 10-1·mm | Mechanical Data (col. B * 10) | Height of the display. | |
Object Size Restrictions | Only reports touches with an object size that is within the defined limits | |||
Max Size Enabled | True/False | Boolean | False | Allows a maximum touch object size. |
Max Size | 10-1·mm | 0 | Max limitation of a touch object (if Max Size Enabled =True). | |
Min Size Enabled | True/False | Boolean | False | Allows a minimum touch object size. |
Min Size | 10-1·mm | 0 | Min limitation of a touch object (if Min Size Enabled =True). | |
Click On Touch | Configures the Touch Sensor Module to send an Up (touch event) after Down within a defined threshold to create an instant touch experience | |||
Enabled | True/False | Boolean | False | Enables and disables the Click On Touch Feature |
Time To Up | ms | 100 | Time from the Down event until the Up event is sent. | |
Distance | 10-1·mm | 100 | Distance from the initial location that a touch must stay within for Click On Touch to be enabled for a touch | |
Frequency Settings | Changes the Touch Sensor Modules update frequency | |||
Idle Frequency | Frequency | Hz | 100 | Scanning frequency when the Touch Sensor Module has not registered any touch object. |
Finger Frequency | Frequency | Hz | 33 | Scanning frequency when the Touch Sensor Module has registered and tracking a touch object. |
Floating Protection Settings | Wait for the object to stabilize on the Y-axis, in order to identify the position of the object in a reliable way | |||
Enabled | True/False | Boolean | True | Floating protection enabled |
Floating Protection Time | 10-1·ms | 400 | Time to wait before reporting touch registration | |
Miscellaneous Settings | ||||
Number Of Reported Touches | 1-10 touches | Quantity | 2 | The number of touches that can be reported simultaneously. |
Reflective Edge Filter | True/False | Boolean | False | Useful when there is a risk that there are highly reflective materials right outside the active touch area |
...
This setting is only available through zForce Programmer. Modifying the scanning range can be useful when the range has to be extended on longer touch sensor modules (346, 330, and 310) for certain sensor with default scanning range lower than maximum and also offers the possibility to set a shorter scanning range. This differs from setting the touch active area Max Y setting as it modifies the actual scanning range of the sensor. If only the Max Y setting would be used, it would still be able to see touches outside of the touch active area, but it would invalidate them and not report them as touches.
For the definition of scanning range, refer to TSM - Definitions
Touch Active Area Adjustments
...