touch_uniformity
================
**Source code:** `touch_uniformity.py <https://chromium.googlesource.com/chromiumos/platform/factory/+/refs/heads/main/py/test/pytests/touch_uniformity.py>`_

A factory test for checking touch uniformity.

Description
-----------
This test is intended to be run during run-in without a fixture or operator.
The test recalibrates the touch device then reads raw reference (baseline) data.
Each value must fall within a specified max and min range. Delta values (the
baseline - current reading) are also checked.

The args thresholds in need to be experimentally determined by checking
a set of machines. The test logs the actual max and min values found.

Currently, the test only supports Atmel based touch devices.

Test Procedure
--------------
The test runs automatically. The touch device shouldn't be touched when
calibrating.

Dependency
----------
- Device API `cros.factory.device.touch`.

Examples
--------
Sample test_list entry:

.. test_list::

  generic_touchscreen_examples:TouchscreenTests.TouchscreenUniformity



Test Arguments
--------------
.. list-table::
   :widths: 20 10 60
   :header-rows: 1
   :align: left

   * - Name
     - Type
     - Description

   * - device_index
     - int
     - (optional; default: ``0``) Index of touch device to test.

   * - check_list
     - list
     - A list of sequence. Each sequence consists of six elements: frame_idx, label, min_val, max_val, rows, cols.
       frame_idx: Index of frame to check.
       label: A i18n translation dictionary of frame label.
       min_val: Lower bound for values in this frame.
       max_val: Upper bound for values in this frame.
       rows: Number of rows from top to check, or zero to check all.
       cols: Number of columns from left to check, or zero to check all.

   * - keep_raw_logs
     - bool
     - (optional; default: ``True``) Whether to attach the log by Testlog