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

A factory test to initiate and verify memory re-training process.

Description
-----------
The test either requests memory re-training on next boot (if ``mode`` is
``'create'``), or verifies the MRC cache. (if ``mode`` is ``'verify_update'``
or ``'verify_no_update'``).

Please refer to py/tools/mrc_cache.py for more details.

Test Procedure
--------------
This is an automated test without user interaction.

Dependency
----------
``flashrom``

Examples
--------
To run the complete memory training and verification flow described in
py/tools/mrc_cache.py, add this to test list:

.. test_list::

  generic_dram_examples:DRAMTests.MRCCache



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

   * - Name
     - Type
     - Description

   * - mode
     - str
     - Specify the phase of the test, valid values are:
       - "create": erase MRC cache and request memory retraining on the next boot.
       - "verify_update": verify the MRC cache update result and request memory retraining on next boot.
       - "verify_no_update": verify the MRC cache is not updated.