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

Checks and updates touch device firmware.

Description
-----------
This test only works for legacy devices. The name and usage of the
scripts under /opt/google/touch/scripts/* were changed.

The current touch firmware in factory is updated at boot time by
`boot-update-firmware.conf`_. If the fw version on factory branch test image and
FSI image are different then the fw is updated again on the first boot out of
factory.

.. _boot-update-firmware.conf: https://chromium.googlesource.com/chromiumos/platform2/+/main/init/upstart/boot-update-firmware.conf

Test Procedure
--------------
The test runs automatically.

Dependency
----------
- /opt/google/touch/scripts/*

Examples
--------
To check touchpad hover with default parameters without calibration, add this
in test list:

.. test_list::

  generic_touchscreen_examples:TouchscreenTests.TouchDeviceFWUpdate



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

   * - Name
     - Type
     - Description

   * - device_name
     - str
     - Name of the touch device as in/sys/bus/i2c/devices/\*/name)

   * - fw_name
     - str
     - Expected firmware file name (in /lib/firmware)

   * - fw_version
     - str
     - Expected firmware version