List of Factory Tests (pytests)
===============================

This document describes all tests available throughout the
factory code.

..
   Include a hidden toctree so Sphinx won't complain about missing
   documents.  We'll generate all the links ourselves in
   generate_rst.py.

.. toctree::
   :hidden:
   :glob:

   *

Notes
-----

The components here are AVL components. See this :doc:`link<../hwid/index>` for
the mapping of HWID component and AVL components.

Tests for `Accelerometer/IMU <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Accelerometer%2FIMU">`_
----------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`accelerometers <accelerometers>`
     - A factory test for reading accelerometers

   * - :doc:`accelerometers_calibration <accelerometers_calibration>`
     - A factory test for accelerometers calibration.

   * - :doc:`accelerometers_lid_angle <accelerometers_lid_angle>`
     - This is a lid angle test based on accelerometers.

   * - :doc:`gyroscope <gyroscope>`
     - A factory test for gyroscopes.

   * - :doc:`gyroscope_angle <gyroscope_angle>`
     - A factory test for gyroscopes.

   * - :doc:`gyroscope_calibration <gyroscope_calibration>`
     - A factory test for gyroscopes calibration.

   * - :doc:`spatial_sensor_calibration <spatial_sensor_calibration>`
     - Perform calibration on spatial sensors

   * - :doc:`tablet_mode <tablet_mode>`
     - Tests that certain conditions are met when in tablet mode.

   * - :doc:`tablet_rotation <tablet_rotation>`
     - Tests screen rotation through ChromeOS and accelerometer data.

Tests for `Ambient Light Sensor <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Ambient+Light+Sensor">`_
--------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`light_sensor <light_sensor>`
     - A factory test for ambient light sensor.

   * - :doc:`light_sensor_calibration <light_sensor_calibration>`
     - Calibration test for light sensor (a chamber is needed).

Tests for `Audio Jack Codec <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Audio+Jack+Codec">`_
------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`audio <audio>`
     - Tests audio playback.

   * - :doc:`audio_basic <audio_basic>`
     - Test basic audio record and playback.

   * - :doc:`audio_diagnostic <audio_diagnostic>`
     - Tests to manually test audio playback and record quality.

   * - :doc:`audio_loop <audio_loop>`
     - A factory test for the audio function.

   * - :doc:`audio_quality <audio_quality>`
     - Audio Quality Test the use audio fixture.

Tests for `Battery <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Battery">`_
------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`battery <battery>`
     - A test to check if DUT can communicate with battery.

   * - :doc:`battery_basic <battery_basic>`
     - A basic battery test.

   * - :doc:`battery_current <battery_current>`
     - A factory test to test battery charging/discharging current.

   * - :doc:`battery_cycle <battery_cycle>`
     - This test cycles the battery.

   * - :doc:`battery_sysfs <battery_sysfs>`
     - A hardware test for checking battery existence and its basic status.

   * - :doc:`bcic <bcic>`
     - A test to set and check BC(battery config) in CBI(ChromeOS Board Info).

   * - :doc:`blocking_charge <blocking_charge>`
     - Test that waits the battery to be charged to specific level.

   * - :doc:`charger <charger>`
     - Test if the charger can charge battery in time.

Tests for `CPU <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"CPU">`_
----------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`stressapptest <stressapptest>`
     - A test to stress CPU, memory and disk.

   * - :doc:`thermal_load <thermal_load>`
     - Tests thermal response under load.

   * - :doc:`thermal_slope <thermal_slope>`
     - Determines how fast the processor heats/cools.

   * - :doc:`urandom <urandom>`
     - A factory test to stress CPU, by generating pseudo random numbers.

Tests for `Camera - MIPI <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Camera+-+MIPI">`_
------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`camera <camera>`
     - Fixtureless camera test.

Tests for `Camera - USB <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Camera+-+USB">`_
----------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`camera <camera>`
     - Fixtureless camera test.

   * - :doc:`vsync <vsync>`
     - VSync pin test.

Tests for `Card Reader <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Card+Reader">`_
--------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`removable_storage <removable_storage>`
     - Tests accessing to a removable storage.

Tests for `Display Panel <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Display+Panel">`_
------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`backlight <backlight>`
     - Test display backlight.

   * - :doc:`brightness.lcd_backlight <brightness.lcd_backlight>`
     - This is a factory test to check the functionality of LCD backlight module.

   * - :doc:`display <display>`
     - Test display functionality.

   * - :doc:`display_images <display_images>`
     - A station-based factory test to test the function of display.

   * - :doc:`display_interactive.display_interactive <display_interactive.display_interactive>`
     - Test display functionality with interactive mode.

   * - :doc:`display_point <display_point>`
     - A factory test to test the function of display panel using some points.

   * - :doc:`edp_panel_timing <edp_panel_timing>`
     - Test eDP panel is supported with proper timing.

   * - :doc:`privacy_screen <privacy_screen>`
     - Test that sets privacy screen to specific state.

Tests for `EC <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"EC">`_
--------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`update_firmware <update_firmware>`
     - Runs chromeos-firmwareupdate to force update Main(AP)/EC/PD firmwares.

Tests for `Ethernet controller <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Ethernet+controller">`_
------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`ethernet <ethernet>`
     - A factory test for basic ethernet connectivity.

Tests for `Fingerprint Sensor <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Fingerprint+Sensor">`_
----------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`fingerprint_mcu <fingerprint_mcu>`
     - A factory test for the Fingerprint sensor.

   * - :doc:`fingerprint_sensor_elan <fingerprint_sensor_elan>`
     - A factory test for the Elan fingerprint sensor.

   * - :doc:`update_fpmcu_firmware <update_fpmcu_firmware>`
     - Update Fingerprint MCU firmware.

Tests for `HPS (Human Presence Sensor) <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"HPS+%28Human+Presence+Sensor%29">`_
--------------------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`hps <hps>`
     - A factory test for HPS (Human Presence Sensor).

Tests for `Memory <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Memory">`_
----------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`memory_size <memory_size>`
     - Test if the memory size is correctly written in the firmware.

   * - :doc:`mrc_cache <mrc_cache>`
     - A factory test to initiate and verify memory re-training process.

   * - :doc:`stressapptest <stressapptest>`
     - A test to stress CPU, memory and disk.

   * - :doc:`update_cbi <update_cbi>`
     - A test to update CBI data to EEPROM.

Tests for `Proximity(SAR) Sensor <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Proximity%28SAR%29+Sensor">`_
--------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`proximity_sensor <proximity_sensor>`
     - A test to check if the proximity sensor triggers events properly.

Tests for `SPI Flash <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"SPI+Flash">`_
----------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`get_intel_desc_status <get_intel_desc_status>`
     - Gets the status of Intel SI_DESC and sets the status to device data.

   * - :doc:`update_firmware <update_firmware>`
     - Runs chromeos-firmwareupdate to force update Main(AP)/EC/PD firmwares.

Tests for `Secure Element <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Secure+Element">`_
--------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`check_cr50_board_id <check_cr50_board_id>`
     - Check the board ID of the Cr50 firmware.

   * - :doc:`check_secdata_version <check_secdata_version>`
     - A factory test to check the secdata version.

   * - :doc:`clear_inactive_gsc_slot <clear_inactive_gsc_slot>`
     - Clears the inactive GSC RW slot.

   * - :doc:`cr50_ap_ro_hash <cr50_ap_ro_hash>`
     - A test to set/clear AP RO hash.

   * - :doc:`cr50_ap_ro_verification <cr50_ap_ro_verification>`
     - A test to ensure the AP RO verification works.

   * - :doc:`ti50_ap_ro_verification <ti50_ap_ro_verification>`
     - A test to ensure the AP RO verification works on Ti50.

   * - :doc:`tpm_clear_owner <tpm_clear_owner>`
     - Requests that the firmware clear the TPM owner on the next reboot.

   * - :doc:`tpm_diagnosis <tpm_diagnosis>`
     - Runs tpm_selftest to perform TPM self-diagnosis.

   * - :doc:`tpm_state <tpm_state>`
     - A test to check the state of TPM die.

   * - :doc:`tpm_verify_ek <tpm_verify_ek>`
     - Verifies the TPM endorsement key.

   * - :doc:`update_cr50_firmware <update_cr50_firmware>`
     - Update Cr50 firmware.

Tests for `Smart Speaker Amplifier <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Smart+Speaker+Amplifier">`_
--------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`audio <audio>`
     - Tests audio playback.

   * - :doc:`audio_basic <audio_basic>`
     - Test basic audio record and playback.

   * - :doc:`audio_diagnostic <audio_diagnostic>`
     - Tests to manually test audio playback and record quality.

   * - :doc:`audio_loop <audio_loop>`
     - A factory test for the audio function.

   * - :doc:`audio_quality <audio_quality>`
     - Audio Quality Test the use audio fixture.

   * - :doc:`dsm_calibration <dsm_calibration>`
     - A factory test to calibrate the smart speaker amplifier.

Tests for `Speaker Amplifier <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Speaker+Amplifier">`_
--------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`audio <audio>`
     - Tests audio playback.

   * - :doc:`audio_basic <audio_basic>`
     - Test basic audio record and playback.

   * - :doc:`audio_diagnostic <audio_diagnostic>`
     - Tests to manually test audio playback and record quality.

   * - :doc:`audio_loop <audio_loop>`
     - A factory test for the audio function.

   * - :doc:`audio_quality <audio_quality>`
     - Audio Quality Test the use audio fixture.

Tests for `Storage <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Storage">`_
------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`bad_blocks <bad_blocks>`
     - Tests a storage device by running the badblocks command.

   * - :doc:`storage_simple_stress <storage_simple_stress>`
     - Performs consecutive read/write operations on a single file.

   * - :doc:`stressapptest <stressapptest>`
     - A test to stress CPU, memory and disk.

   * - :doc:`verify_root_partition <verify_root_partition>`
     - Verifies the integrity of the root partition.

Tests for `Storage bridge (PCIE-eMMC) <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Storage+bridge+%28PCIE-eMMC%29">`_
------------------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`bad_blocks <bad_blocks>`
     - Tests a storage device by running the badblocks command.

   * - :doc:`storage_simple_stress <storage_simple_stress>`
     - Performs consecutive read/write operations on a single file.

   * - :doc:`stressapptest <stressapptest>`
     - A test to stress CPU, memory and disk.

Tests for `TPM <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"TPM">`_
----------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`check_secdata_version <check_secdata_version>`
     - A factory test to check the secdata version.

   * - :doc:`tpm_clear_owner <tpm_clear_owner>`
     - Requests that the firmware clear the TPM owner on the next reboot.

   * - :doc:`tpm_diagnosis <tpm_diagnosis>`
     - Runs tpm_selftest to perform TPM self-diagnosis.

   * - :doc:`tpm_state <tpm_state>`
     - A test to check the state of TPM die.

   * - :doc:`tpm_verify_ek <tpm_verify_ek>`
     - Verifies the TPM endorsement key.

Tests for `Touch screen Controller (non stylus) <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Touch+screen+Controller+%28non+stylus%29">`_
--------------------------------------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`touch_device_fw_update <touch_device_fw_update>`
     - Checks and updates touch device firmware.

   * - :doc:`touchscreen <touchscreen>`
     - Tests touchscreen or stylus by drawing in any order or in spiral pattern.

Tests for `Touch screen controller (EMR Stylus) <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Touch+screen+controller+%28EMR+Stylus%29">`_
--------------------------------------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`stylus <stylus>`
     - Test stylus functionality.

   * - :doc:`stylus_garage <stylus_garage>`
     - Tests stylus garage detection functionality.

   * - :doc:`touch_device_fw_update <touch_device_fw_update>`
     - Checks and updates touch device firmware.

   * - :doc:`touchscreen <touchscreen>`
     - Tests touchscreen or stylus by drawing in any order or in spiral pattern.

Tests for `Touch screen controller (USI Stylus) <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Touch+screen+controller+%28USI+Stylus%29">`_
--------------------------------------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`stylus <stylus>`
     - Test stylus functionality.

   * - :doc:`stylus_garage <stylus_garage>`
     - Tests stylus garage detection functionality.

   * - :doc:`touch_device_fw_update <touch_device_fw_update>`
     - Checks and updates touch device firmware.

   * - :doc:`touchscreen <touchscreen>`
     - Tests touchscreen or stylus by drawing in any order or in spiral pattern.

Tests for `Touchpad Controller <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Touchpad+Controller">`_
------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`touch_device_fw_update <touch_device_fw_update>`
     - Checks and updates touch device firmware.

   * - :doc:`touch_uniformity <touch_uniformity>`
     - A factory test for checking touch uniformity.

   * - :doc:`touchpad <touchpad>`
     - A factory test to test the functionality of touchpad.

   * - :doc:`touchpad_hover <touchpad_hover>`
     - Touchpad Hover Test.

Tests for `USB Composite Integrated Component <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"USB+Composite+Integrated+Component">`_
------------------------------------------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`battery_current <battery_current>`
     - A factory test to test battery charging/discharging current.

   * - :doc:`external_display <external_display>`
     - Test external display with optional audio playback test.

   * - :doc:`removable_storage <removable_storage>`
     - Tests accessing to a removable storage.

Tests for `WWAN <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"WWAN">`_
------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`cellular_switch_firmware <cellular_switch_firmware>`
     - A factory test for switching the modem's firmware.

   * - :doc:`lte_verify_config <lte_verify_config>`
     - Verifies the LTE module config.

   * - :doc:`modem_security <modem_security>`
     - Verify and close modem access authority.

   * - :doc:`probe_cellular_info <probe_cellular_info>`
     - Probes information from /org/freedesktop/ModemManager1.

   * - :doc:`probe_sim <probe_sim>`
     - Probes SIM card information from 'modem status'.

   * - :doc:`probe_sim_card_tray <probe_sim_card_tray>`
     - Probes SIM card tray

   * - :doc:`vswr.vswr <vswr.vswr>`
     - VSWR measures the efficiency of the transmission line.

Tests for `Wifi / Bluetooth <https://chromeos.google.com/partner/dlm/avl/component?q=componentType:"Wifi+%2F+Bluetooth">`_
--------------------------------------------------------------------------------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`bluetooth <bluetooth>`
     - A factory test to verify the functionality of bluetooth device.

   * - :doc:`bluetooth_host <bluetooth_host>`
     - Station-based Bluetooth scan and pair test, using hciconfig and hcitool.

   * - :doc:`probe_device_info <probe_device_info>`
     - A factory test for probing device information and updating device data.

   * - :doc:`rf_graphyte.rf_graphyte <rf_graphyte.rf_graphyte>`
     - Tests RF chip's transmitting and receiving capabilities using Graphyte.

   * - :doc:`vswr.vswr <vswr.vswr>`
     - VSWR measures the efficiency of the transmission line.

   * - :doc:`wifi_throughput <wifi_throughput>`
     - WiFi throughput test.

   * - :doc:`wireless_antenna <wireless_antenna>`
     - A factory test for basic Wifi.

   * - :doc:`wireless_connect <wireless_connect>`
     - Connect to an AP.

Tests for CHROMEBOOK_PlUS (Device feature component)
----------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`branded_chassis <branded_chassis>`
     - A test to check if chassis is branded.

   * - :doc:`feature_compliance_version <feature_compliance_version>`
     - A factory test to check the feature compliance version.

Tests for FAN (Device feature component)
----------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`fan_speed <fan_speed>`
     - A factory test to ensure the functionality of CPU fan.

Tests for HARDWARE_BUTTON (Device feature component)
----------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`button <button>`
     - Tests button functionality.

Tests for HARDWARE_ID (Device feature component)
------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`feature_compliance_version <feature_compliance_version>`
     - A factory test to check the feature compliance version.

   * - :doc:`finalize <finalize>`
     - The finalize test is the last step before DUT switching to release image.

   * - :doc:`hwid <hwid>`
     - Uses HWID v3 to generate, encode, and verify the device's HWID.

   * - :doc:`probe.probe <probe.probe>`
     - A factory test to check if the components can be probed successfully or not.

Tests for KEYBOARD (Device feature component)
---------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`keyboard <keyboard>`
     - Tests keyboard functionality.

   * - :doc:`keyboard_backlight <keyboard_backlight>`
     - This is a factory test to test keyboard backlight.

   * - :doc:`keyboard_smt <keyboard_smt>`
     - Tests keyboard pin connectivity in SMT factory test.

Tests for LED (Device feature component)
----------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`brightness.led_brightness <brightness.led_brightness>`
     - This is a factory test to check the LED brightness.

   * - :doc:`led <led>`
     - A factory test for the led function.

Tests for PSR (Device feature component)
----------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`setup_psr_feature <setup_psr_feature>`
     - A test to set/check PSR EOM NVAR and start PSR Log.

   * - :doc:`update_psr_oem_data <update_psr_oem_data>`
     - A test to update and verify PSR OEM Data.

Tests for THERMAL_SENSOR (Device feature component)
---------------------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`thermal_load <thermal_load>`
     - Tests thermal response under load.

   * - :doc:`thermal_sensors <thermal_sensors>`
     - Test for temperature sensors control.

   * - :doc:`thermal_slope <thermal_slope>`
     - Determines how fast the processor heats/cools.

Tests for VPD (Device feature component)
----------------------------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`accelerometers_lid_angle <accelerometers_lid_angle>`
     - This is a lid angle test based on accelerometers.

   * - :doc:`check_serial_number <check_serial_number>`
     - Checks if serial number is set correctly on a device.

   * - :doc:`dsm_calibration <dsm_calibration>`
     - A factory test to calibrate the smart speaker amplifier.

   * - :doc:`finalize <finalize>`
     - The finalize test is the last step before DUT switching to release image.

   * - :doc:`light_sensor_calibration <light_sensor_calibration>`
     - Calibration test for light sensor (a chamber is needed).

   * - :doc:`provision_drm_key <provision_drm_key>`
     - Provision Widevine keybox to the VPD.

   * - :doc:`read_device_data_from_vpd <read_device_data_from_vpd>`
     - Setup device data from VPD (Vital Product Data).

   * - :doc:`scan <scan>`
     - Prompts the operator to input a string of data.

   * - :doc:`spatial_sensor_calibration <spatial_sensor_calibration>`
     - Perform calibration on spatial sensors

   * - :doc:`update_device_data <update_device_data>`
     - Updates Device Data (manually or from predefined values in test list).

   * - :doc:`verify_keybox <verify_keybox>`
     - A test to check the correctness of widevine keybox.

   * - :doc:`write_device_data_to_vpd <write_device_data_to_vpd>`
     - Writes device data to VPD (Vital Product Data).

Uncategorized pytests
---------------------


.. list-table::
   :widths: 30 70
   :header-rows: 1
   :align: left

   * - pytest name
     - description

   * - :doc:`ac_power <ac_power>`
     - A test to ensure the power type and status of device under test.

   * - :doc:`bft_fixture <bft_fixture>`
     - A generic interface to control the BFT fixture.

   * - :doc:`brightness.brightness <brightness.brightness>`
     - This is a factory test to check the brightness of LCD backlight or LEDs.

   * - :doc:`buzzer <buzzer>`
     - This is a buzzer test.

   * - :doc:`cec <cec>`
     - Test and check cec power control feature on Chrome OS device.

   * - :doc:`check_image_version <check_image_version>`
     - Check release or test OS image version on internal storage.

   * - :doc:`check_pdc_firmware <check_pdc_firmware>`
     - A test to check PDC firmware information.

   * - :doc:`check_release_lvm_stateful <check_release_lvm_stateful>`
     - Check if release image has enabled LVM stateful partition.

   * - :doc:`check_retimer_firmware <check_retimer_firmware>`
     - Check the retimer firmware version.

   * - :doc:`check_test_list <check_test_list>`
     - A step to check test list.

   * - :doc:`compass <compass>`
     - Compass test which requires operator place the DUT heading north and south.

   * - :doc:`copy_minios <copy_minios>`
     - Selectively copies the miniOS part that has the same recovery key ver as FW.

   * - :doc:`countdown <countdown>`
     - A count down monitor for better user interface in run-in tests.

   * - :doc:`download_from_factory_drive <download_from_factory_drive>`
     - Retrieve factory drive files from factory server.

   * - :doc:`exec_python <exec_python>`
     - A test to run arbitrary python scripts.

   * - :doc:`exec_shell <exec_shell>`
     - A test to invoke a list of shell commands.

   * - :doc:`factory_state <factory_state>`
     - A pytest helps you control FactoryStateLayer

   * - :doc:`flash_netboot <flash_netboot>`
     - Flash system main (AP) firmware to netboot firmware.

   * - :doc:`lid_switch <lid_switch>`
     - Tests lid switch functionality.

   * - :doc:`lightbar <lightbar>`
     - Factory test for lightbar on A-case.

   * - :doc:`line_check_item <line_check_item>`
     - A factory test to interactively check a sequence of shell commands on DUT.

   * - :doc:`message <message>`
     - Displays a message.

   * - :doc:`model_sku <model_sku>`
     - A test to confirm and set SKU information.

   * - :doc:`mouse <mouse>`
     - A factory test to test the functionality of a mouse/trackpoint.

   * - :doc:`network_setup.network_setup <network_setup.network_setup>`
     - A pytest to wait operators setup network connection.

   * - :doc:`nop <nop>`
     - An no-op test.

   * - :doc:`partition_table <partition_table>`
     - Checks that the partition table extends nearly to the end of the storage
       device.

   * - :doc:`pd_fw_min_version <pd_fw_min_version>`
     - Check firmware version of PD (TCPC) chip equal to or larger than minimum
       version noted in corresponding EC driver.

   * - :doc:`ping_test <ping_test>`
     - Ping connection test.

   * - :doc:`plankton_cc2_pull_test <plankton_cc2_pull_test>`
     - Plankton USB type-C CC2 function test for Whale fixture.

   * - :doc:`plankton_cc_flip_check <plankton_cc_flip_check>`
     - USB type-C CC line polarity check and operation flip test w/ Plankton-Raiden.

   * - :doc:`plankton_charge <plankton_charge>`
     - Test USB type-C port charging function with Plankton-Raiden board.

   * - :doc:`plankton_display <plankton_display>`
     - Tests USB type-C DP function with Plankton.

   * - :doc:`read_device_data_from_cros_config <read_device_data_from_cros_config>`
     - Setup device data from ChromeOS Config.

   * - :doc:`record_csv_entry_example <record_csv_entry_example>`
     - An example pytest to show case how to save a CSV entry.

   * - :doc:`retrieve_config <retrieve_config>`
     - Retrieve JSON config file from either an USB stick or a factory server.

   * - :doc:`robot_movement <robot_movement>`
     - Control a robot to move a device for testing specific sensors.

   * - :doc:`sample_customized_test <sample_customized_test>`
     - This is the sample code of a board specific test.

   * - :doc:`select_for_sampling <select_for_sampling>`
     - Decide if this device is selected for certain sampling tests.

   * - :doc:`serial_echo <serial_echo>`
     - Checks the communication between DUT and SMT test fixture.

   * - :doc:`shopfloor_service <shopfloor_service>`
     - Invoke remote procedure call for interaction with shopfloor backend.

   * - :doc:`shutdown <shutdown>`
     - Shutdown/Reboot the device.

   * - :doc:`start <start>`
     - A test to make sure everything is set for the following test in test list.

   * - :doc:`station_entry <station_entry>`
     - Starts or ends a station-based test.

   * - :doc:`station_setup <station_setup>`
     - Setup a station for station-based test.

   * - :doc:`summary <summary>`
     - Displays a status summary for all tests in the current section.

   * - :doc:`suspend_resume <suspend_resume>`
     - Suspend and resume device with given cycles.

   * - :doc:`suspend_stress <suspend_stress>`
     - Suspend and resume device with given cycles.

   * - :doc:`switch_test_list <switch_test_list>`
     - A step to switch test list.

   * - :doc:`sync_factory_server <sync_factory_server>`
     - Connect to factory server to find software updates and upload logs.

   * - :doc:`sync_time <sync_time>`
     - Sync the clock of DUT with the clock of station.

   * - :doc:`thunderbolt_loopback <thunderbolt_loopback>`
     - Tests thunderbolt port with a loopback card.

   * - :doc:`update_detachable_base <update_detachable_base>`
     - Detachable base update test

   * - :doc:`update_kernel <update_kernel>`
     - Applies new kernel to DUT (for testing).

   * - :doc:`update_plugin_firmware <update_plugin_firmware>`
     - Update vendor plugin firmware using fwupdtool.

   * - :doc:`verify_component <verify_component>`
     - Verify peripheral components.

   * - :doc:`video_playback <video_playback>`
     - A video playback test.

   * - :doc:`wait_external_test <wait_external_test>`
     - A stub test waiting for external fixture to finish testing.

   * - :doc:`wait_fixture_ready <wait_fixture_ready>`
     - Waits Fixture until it's ready.

   * - :doc:`webgl_aquarium <webgl_aquarium>`
     - WebGL performance test that executes a set of WebGL operations.

   * - :doc:`whale_check_voltage <whale_check_voltage>`
     - Checks voltages.

   * - :doc:`whale_cover <whale_cover>`
     - Checks if Whale's cover is opened / closed.

   * - :doc:`wireless_charge <wireless_charge>`
     - Test wireless charge port functionality.

   * - :doc:`write_protect_switch <write_protect_switch>`
     - Verifies that the write-protect switch is on.