Peripherals

[中文]

DAC

DAC driver has been redesigned (see DAC API Reference), which aims to unify the interface and extend the usage of DAC peripheral. Although it is 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_continuous.h' instead. The warning can be suppressed by the Kconfig option 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 was used to identify the hardware channel are removed from user space. The channel index now starts from 0, so please use DAC_CHAN_0 and DAC_CHAN_1 instead. And in the new driver, DAC channels can be selected by using dac_channel_mask_t. And these channels can be allocated in a same channel group which is represented by dac_channels_handle_t.

• dac_cw_scale_t is replaced by dac_cosine_atten_t to decouple the legacy driver and the new driver.

• dac_cw_phase_t is replaced by dac_cosine_phase_t. The enumerate value is now the phase angle directly.

• dac_cw_config_t is replaced by dac_cosine_config_t, but the en_ch field is removed because it should be specified while allocating the channel group.

• dac_digi_convert_mode_t is removed. The driver now can transmit DMA data in different ways by calling dac_channels_write_continuously() or dac_channels_write_cyclically().

• dac_digi_config_t is replaced by dac_continuous_config_t.

Breaking Changes in Usage

• dac_pad_get_io_num is removed.

• dac_output_voltage is replaced by dac_oneshot_output_voltage().

• dac_output_enable is removed. For oneshot mode, it will be enabled after the channel is allocated.

• dac_output_disable is removed. For oneshot mode, it will be disabled before the channel is deleted.

• dac_cw_generator_enable is replaced by dac_cosine_start().

• dac_cw_generator_disable is replaced by dac_cosine_stop().

• dac_cw_generator_config is replaced by dac_cosine_new_channel().

• dac_digi_init and dac_digi_controller_config is merged into dac_continuous_new_channels().

• dac_digi_deinit is replaced by dac_continuous_del_channels().

• dac_digi_start, dac_digi_fifo_reset and dac_digi_reset are merged into dac_continuous_enable().

• dac_digi_stop is replaced by dac_continuous_disable().

GPSPI

Following items are deprecated. Since ESP-IDF v5.1, GPSPI clock source is configurable.

• spi_get_actual_clock is deprecated, you should use spi_device_get_actual_freq() instead.

LEDC

• soc_periph_ledc_clk_src_legacy_t::LEDC_USE_RTC8M_CLK is deprecated. Please use LEDC_USE_RC_FAST_CLK instead.

---

Was this page helpful?

• Thank you! We received your feedback.
• If you have any comments, fill in Espressif Documentation Feedback Form.

• We value your feedback.
• Let us know how we can improve this page by filling in Espressif Documentation Feedback Form.