SoC 能力宏
==========

:link_to_translation:`en:[English]`

不同型号的 ESP 芯片内部会集成不同的硬件模块。哪怕是同一种模块，在不同的芯片上也可能具有细微的差异。ESP-IDF 中提供了一份小型的“数据库”来描述不同芯片之间的差异（注意，我们不描述共性，只描述差异）。这份“数据库“的内容以宏定义的形式定义在 **soc/soc_caps.h** 文件中，我们称之为 **SoC 能力宏**。用户可以通过在代码中使用条件编译指令（比如 ``#if``）来使用这些宏，从而控制实际需要编译的代码内容。

.. note::

    请注意， **soc/soc_caps.h** 中的内容目前还不稳定，未来可能会发生重大更改。

使用 SoC 能力宏
---------------

我们推荐通过下面的宏函数来间接地访问 SoC 能力宏：

.. list-table::
    :widths: 30 60 80
    :header-rows: 1

    * - 宏函数
      - 描述
      - 示例
    * - :c:macro:`SOC_IS`
      - 判断芯片型号
      - ``#if SOC_IS(ESP32)`` 判断是否为 ESP32 芯片
    * - :c:macro:`SOC_HAS`
      - 判断芯片是否具有某个硬件模块或功能
      - ``#if SOC_HAS(DAC)`` 判断是否具有 DAC 模块


API 参考
--------

.. include-build-file:: inc/soc_caps.inc
.. include-build-file:: inc/soc_caps_eval.inc