Atmel QTouch Safety Library USER GUIDE - Microchip …

1 Atmel -42230G-SAM- Atmel -SAMD- QTouch -Safet y- Library -UserGuide_07/2016 DescriptionAtmel QTouch Peripheral Touch Controller (PTC) offers built-in hardware forbuttons, sliders, and wheels. PTC supports both mutual and self capacitancemeasurement without the need for any external component. It offers superbsensitivity and noise tolerance, as well as self-calibration and minimizes thesensitivity tuning effort by the PTC is intended for acquiring capacitive touch sensor signals. The externalcapacitive touch sensor is typically formed on a PCB, and the sensor electrodesare connected to the analog charge integrator of the PTC using the device I/Opins.

2 The PTC supports mutual capacitance sensors organized as capacitivetouch matrices in different X-Y configurations, including Indium Tin Oxide (ITO)sensor grids. In mutual capacitance mode, the PTC requires one pin per X line(drive line) and one pin per Y line (sense line). In self capacitance mode, the PTCrequires only one pin with a Y-line driver for each self-capacitance PTC supports two sets of libraries, the QTouch Library and the QTouchSafety Library . The QTouch Library supports both mutual and self capacitancemethods. The QTouch Safety Library is available for both GCC and IAR.

3 TheQTouch Safety Library also supports both the mutual capacitance method and selfcapacitance method along with the additional Safety features. Atmel QTouch Safety LibraryPeripheral Touch ControllerUSER GUIDE3 Atmel | SMART SAM QTouch Safety Library [USER GUIDE ] Atmel -42230G-SAM- Atmel -SAMD- QTouch - Safety - Library -UserGuide_07 Tools .. Variants Supported .. Safety Library .. Overview.. of Operation .. Flow .. Parameters .. Configuration .. Configuration .. Parameters .. Global Parameters .. Parameters .. Immunity Global Parameters.

4 Immunity Features .. Lockout .. Auto Tune .. Library Error Reporting Mechanism .. Library Program Counter Test .. Program Flow Test .. Counter Test .. on Touch Input Configuration .. Inverse Memory Check .. to Touch Library .. Library to Application .. Burst Again Mechanism .. Requirement .. Requirement for IAR Safety Library .. Execution Time .. Capacitance API Execution Time .. Capacitance API Execution Time .. Interpretation .. Codes Returned Synchronously .. Codes Returned Through Callback.

5 And Function Protection .. Tolerance .. Tolerance Group .. Group .. Re-burst .. Quick Re-burst and Application Burst again .. Sensor States .. Library Suspend Resume Operation .. on Disabled Sensors .. Safety Library API .. Library Acquisition Status Bit Fields.. State Configurations.. Library GAIN Setting(tag_gain_t) .. 53 Atmel | SMART SAM QTouch Safety Library [USER GUIDE ] Atmel -42230G-SAM- Atmel -SAMD- QTouch - Safety - Library -UserGuide_07 Level Setting (tag_filter_level_t) .. Library AUTO OS Setting (tag_auto_os_t).

6 Error Code (tag_touch_ret_t) .. Channel (tag_channel_t) .. Library State (tag_touch_lib_state_t) .. Type (tag_sensor_type_t) .. Library Acquisition Mode (tag_touch_acq_mode_t) .. Group (tag_aks_group_t) .. Gain Setting (tag_gain_t) .. Recalibration Threshold (tag_recal_threshold_t) .. Slider Resolution (tag_resolution_t) .. Tune Setting (tag_auto_tune_type_t) .. Clock Prescale Setting (tag_prsc_div_sel_t) .. Series Resistor Setting (tag_rsel_val_t) .. Acquisition Frequency Delay Setting (freq_hop_sel_t).

7 Acquisition Frequency Mode Setting (tag_freq_mode_sel_t) .. Sensor Lockout Setting (nm_sensor_lockout_t) .. Group Setting (moisture_grp_t) .. Group Setting (mltch_grp_t) .. Structures .. Library Configuration Type .. Library Safety Type .. Library Double Inverse Type .. Library Parameter Type .. Library Measurement Data Type .. Library Filter Data Type .. Library Time Type .. Library Info Type .. Library Version .. Variables .. Library Initialization .. Library Sensor Configuration .. Library Sensor Calibration.

8 Library Sensor Measurement .. Library Sensor Specific Touch Delta Read .. Library Sensor Specific Parameter Configuration Read-write .. Library Sensor Specific Acquisition Configuration Read-write .. Library Sensor Global Parameter Configuration Read-write .. Library Info Read .. Library Program Counter .. Library CRC Configuration Check .. Library Double Inverse check .. Library Enable Disable Sensor .. Library Version Information .. Library Moisture Tolerance .. PTC Peripheral Enable Disable.

9 Library Suspend Resume .. 785 Atmel | SMART SAM QTouch Safety Library [USER GUIDE ] Atmel -42230G-SAM- Atmel -SAMD- QTouch - Safety - Library -UserGuide_07 Library Re-Initialization .. Inverse Memory Check .. to FMEA .. to Application .. Requirement .. Requirement for IAR Library .. Execution Time .. Capacitance API Execution Time .. Capacitance API Execution Time .. Interpretation .. and Function Protection .. Considerations .. API .. Structures .. Variables .. Touch Library and FMEA RAM Area.

10 The IAR Linker File .. GCC Linker File .. Rules .. Firmware Action Upon Fault Detection .. Action Upon Fault Detection.. Library and FMEA Synchronization .. Firmware Package .. Firmware Certification Scope.. Time .. Dependency .. and Tuning .. compliance .. Certification .. Issues .. 112 Atmel | SMART SAM QTouch Safety Library [USER GUIDE ] Atmel -42230G-SAM- Atmel -SAMD- QTouch - Safety - Library -UserGuide_07 History .. 1137 Atmel | SMART SAM QTouch Safety Library [USER GUIDE ] Atmel -42230G-SAM- Atmel -SAMD- QTouch - Safety - Library -UserGuide_07/2016 FeaturesThe following features are available only in the QTouch Safety Library .