...
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.
Known issues
Double click prevention with floating protection filter enabled
...
Configuration | Range | Measurement | Default | Description | ||
I2C settings | Configures I2C on the TSM | |||||
Address | 0 to 127 | 7-bit value | 80 (0x50) | The I2C address for the TSM. | ||
System Enabled | Configures the startup state of the TSM | |||||
System Enabled | True/False | Boolean | True | Enables or disables the TSM | ||
Operation Mode | Configures the default operation mode | |||||
detection | True/False | Boolean | True | Operation mode ASN.1 over either I2C or USB Raw HID | ||
detectionHID | True/False | Boolean | True | Operation mode USB HID | ||
Range Settings | Sets the scanning range dynamically | |||||
Scanning Range | 10-1·mm | Mechanical Data (col. B * 10) | Scanning range with max value according to B(exteedange ouch The area (width and height) the Touch Sensor Module (TTSM) available for 295, 310 and 346 mm Touch Sensor Modules).will scan for an object with lasers and photodiodes (PD). This value also sets the limit for High Y (Max Y) below. | |||
Frequency Settings | Changes the Touch Sensor Modules update frequency | |||||
Idle Frequency | Frequency | Hz | 33 | Scanning frequency when the Touch Sensor Module has not registered any touch object. | ||
Finger Frequency | Frequency | Hz | 100 | Scanning frequency when the Touch Sensor Module has registered and tracking a touch object. | ||
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 Touch Active Area (TAA) in X-direction. LowHighLowHighLow X, High X, Low Y & High Y make up the TAA. | |||
Low Bound Y Low Bound Y (Min Y) | 10-1·mm | 0 | Start position of the Touch Active Area (TAA) in Y-direction. LowHighLowHighLow X, High X, Low Y & High Y make up the TAA. | |||
High Bound X (Max X) | 10-1·mm | Mechanical Data (col. A * 10) + 36 | End position of the Touch Active Area (TAA) in X-direction. LowHighLowHighLow X, High X, Low Y & High Y make up the TAA. | |||
High Bound Y (Max Y) | 10-1·mm | Mechanical Data (col. B * 10) | End position of the Touch Active Area (TAA) in Y-direction. LowHighLowHighLow X, High X, Low Y & High Y make up the TAA. | |||
Reverse X | True | Reverse X | True/False | Boolean | False | Reverses the X-coordinates of reported touches. Note, that the origin of the vast majority of the displays is in the top left corner. |
Reverse Y | True/False | Boolean | False | Reverses the Y-coordinates of reported touches. Note, that the origin of the vast majority of the displays is in the top left corner. | ||
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 TAA in X-direction, on the display. | |||
Offset Y | 10-1·mm | 0 | Offsets the projected 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 physical display. It is very important to set this parameter correct since the TSM will report touch coordinated in percentage of the physical display length/height. | |||
Hid Display Size Y | 10-1·mm | Mechanical Data (col. B * 10) | Height of the physical display. It is very important to set this parameter correct since the TSM will report touch coordinated in percentage of the physical display length/height. | |||
Snapping | Configure the snapping area around the edges of the Touch Active Area (TAA) | |||||
Enabled | True/False | Boolean | False | Enables or disables the snapping filter. | ||
Left Inner | Mechanical Data | 10-1 mm | 0 | Distance from edge to the inner snapping edge, left side of TAA. | ||
Left Outer | Mechanical Data | 10-1 mm | 0 | Distance from edge to the outer snapping edge, left side of TAA. | ||
Right Inner | Mechanical Data | 10-1 mm | 0 | Distance from edge to the inner snapping edge, right side of TAA. | ||
Right Outer | Mechanical Data | 10-1 mm | 0 | Distance from edge to the outer snapping edge, right side of TAA. | ||
Top Inner | Mechanical Data | 10-1 mm | 0 | Distance from edge to the inner snapping edge, top side of TAA. | ||
Top Outer | Mechanical Data | 10-1 mm | 0 | Distance from edge to the outer snapping edge, top side of TAA. | ||
Bottom Inner | Mechanical Data | 10-1 mm | 0 | Distance from edge to the inner snapping edge, bottom side of TAA. | ||
Bottom Outer | Mechanical Data | 10-1 mm | 0 | Distance from edge to the outer snapping edge, bottom side of TAA. | ||
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 | |||
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. This parameter should not be set at the same time as Double-Click Prevention is turned on. | |||||
Enabled | True/False | Boolean | True | Floating protection enabled. | ||
Floating Protection Time | ms | 400 | Time to wait before reporting touch registration. | |||
Double-Click Prevention Settings | Configuration of the filter prevention area and timeout. This parameter should not be set at the same time as Floating Protection is turned on. | |||||
Enabled | True/False | Boolean | False | Enables or disables the double-click prevention filter. | ||
Prevention Time | >0 | ms | 500 | The time period when no additional touches will be reported in prevention area. | ||
Prevention Radius | >0 | 10-1 mm | 220 | The radius of the area around the touch defining area where touches are suppressed. | ||
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). | |||
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 |
...
Scanning Range defines the Scanning Area of the sensor. For the definition of Scanning Area, refer to TSM - Definitions. This setting can only be changed through the zForceProgrammer. The Scanning Range can beset to a lower ((shorter range) value. It can also be set to a higher value than the default if the TSM FirmWare (FW) allows Extended or Maximum Range in Y-axis. As default the Scanning Range is set to a DefaultRange, see for the values.he Mechanical Data, Table 1for the values.
Frequency Settings
The frequency parameters set the various scanning frequencies. The maximum scanning frequencies ae are depending on This the product variffrs rom settiantvariant.
Fg the touch actinger Frequency
Finger Frequency
Activated when objects Acve area Max Y settivated wheng as it mobjectsdiies the actual with characteristics matching regular fingers of athe det sected.nsoare detected.
Idle . If only Frequency
Activated when nax objectsY arse detected tting would be used, order to m would still be able t see touches outside of the touch active area, but it would inimize power uvalidate them and not report them as touchesageno objects are detected in order to minimize power usage.
Touch Active Area Adjustments
...
When the snapping filter is enabled, an outer- and inner distance to the edge of the scanning area can be configured. It can be configured for the left, right, top and bottom edge of the scanning area with the unit of 10-1 mm. When a touch is detected between the inner- and outer distance regions, the reported touch location is snapped to the edge of the configured touch area.
Click On Touch
...
The filter is designed to prevent multiple touches within a defined area for a short period of time. Both the prevention radius (10-1 mm) and the prevention time (ms) are configurable parameters.
When enabled the system will define a prevention area for each touch and will not react to additional touches in those areas until the prevention time has expired. This way undesired double-clicks can be prevented for a certain area while maintaining quick response times outside of the prevention areas on the TAA.
...