flash_chip
==========
Get information of flash chips.

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

   * - Name
     - Type
     - Description

   * - chip
     - ['ec', 'main', 'pd']
     - The flash chip. It should be one of ['main', 'ec', 'pd']

Description
-----------
This function runs the command ``flashrom -p <chip_type> --flash-name``
to get the information of the flash chip and output them.

The ``<chip_type>`` in above commnand is determind by the ``chip`` argument
if this function.  Following is a table to show the corresponding
``<chip_type>`` value of the specific ``chip`` argument.

.. list-table::
   :header-rows: 1

   * - Argument ``chip``
     - Corresponding ``<chip_type>``
   * - ``main``
     - ``internal``
   * - ``ec``
     - ``ec``
   * - ``pd``
     - ``ec:type=pd``

Examples
--------
Let's assume that the output of ``flashrom -p internal --flash-name`` is ::

  vendor="Google"
  name="Chip1"

And we have the probe statement::

  {
    "eval": "flash_chip:main"
  }

Then the probed results will be ::

  [
    {
      "vendor": "Google",
      "name": "Chip1"
    }
  ]