Peripherals
===========

:link_to_translation:`zh_CN:[中文]`

.. only:: SOC_DAC_SUPPORTED

    DAC
    ---

    DAC driver has been redesigned (see :doc:`DAC API Reference <../../../api-reference/peripherals/dac>`), which aims to unify and extend the usage of DAC peripheral. Although it's recommended to use the new driver APIs, the legacy driver is still available in the previous include path ``driver/dac.h``. However, by default, including ``driver/dac.h`` will bring a build warning like `The legacy DAC driver is deprecated, please use 'driver/dac_oneshot.h', 'driver/dac_cosine.h' or 'driver/dac_conti.h' instead`. The warning can be suppressed by the Kconfig option :ref:`CONFIG_DAC_SUPPRESS_DEPRECATE_WARN`.

    The major breaking changes in concept and usage are listed as follows:

    Breaking Changes in Concepts
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    - ``dac_channel_t`` which used to identify the hardware channel are removed from user space, the channel index now starts from ``0``, please use  `DAC_CHAN_0` and `DAC_CHAN_1` instead. And in the new driver, DAC channels can be seleted by :cpp:type:`dac_channel_mask_t`. And these channels can be allocated in a same channel group which is represented by :cpp:type:`dac_channels_handle_t`.
    - ``dac_cw_scale_t`` is replaced by :cpp:type:`dac_cosine_atten_t`, to decupling the legacy driver and the new driver.
    - ``dac_cw_phase_t`` is replaced by :cpp:type:`dac_cosine_phase_t`, the enum value is now the phase angle directly.
    - ``dac_cw_config_t`` is replaced by :cpp:type:`dac_cosine_config_t`, but the ``en_ch`` field is removed because it should be specify while allocate the channel group.

    .. only:: esp32s2

        - ``dac_digi_convert_mode_t`` is removed. The driver now can transmit DMA data in different ways by calling :cpp:func:`dac_channels_write_continuously` or :cpp:func:`dac_channels_write_cyclically`.
        - ``dac_digi_config_t`` is replaced by :cpp:type:`dac_conti_config_t`.

    Breaking Changes in Usage
    ~~~~~~~~~~~~~~~~~~~~~~~~~

    - ``dac_pad_get_io_num`` is removed.
    - ``dac_output_voltage`` is replaced by :cpp:func:`dac_oneshot_output_voltage`.
    - ``dac_output_enable`` is removed, for oneshot mode, it will be enabled after the channel allocated.
    - ``dac_output_disable`` is removed, for oneshot mode, it will be disabled before the channel deleted.
    - ``dac_cw_generator_enable`` is replaced by :cpp:func:`dac_cosine_start`.
    - ``dac_cw_generator_disable`` is replaced by :cpp:func:`dac_cosine_stop`.
    - ``dac_cw_generator_config`` is replaced by :cpp:func:`dac_new_cosine_channel`.

    .. only:: esp32

        - ``dac_i2s_enable`` is replaced by :cpp:func:`dac_conti_enable`, but it needs to allocate the continuous DAC channel first by :cpp:func:`dac_new_conti_channels`.
        - ``dac_i2s_disable`` is replaced by :cpp:func:`dac_conti_disable`.

    .. only:: esp32s2

        - ``dac_digi_init`` and ``dac_digi_controller_config`` is merged into :cpp:func:`dac_new_conti_channels`.
        - ``dac_digi_deinit`` is replaced by :cpp:func:`dac_del_conti_channels`.
        - ``dac_digi_start``, ``dac_digi_fifo_reset`` and ``dac_digi_reset`` are merged into :cpp:func:`dac_conti_enable`.
        - ``dac_digi_stop`` is replaced by :cpp:func:`dac_conti_disable`.