dac: refactor driver add hal

components/driver/include/driver/dac.h

@@ -12,8 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
-#ifndef _DRIVER_DAC_H_
-#define _DRIVER_DAC_H_
+#pragma once
 
 #ifdef __cplusplus
 extern "C" {
@@ -21,41 +20,30 @@ extern "C" {
 
 #include <stdint.h>
 #include "esp_err.h"
-#include "soc/dac_periph.h"
-
-typedef enum {
-    DAC_CHANNEL_1 = 1,  /*!< DAC channel 1 is GPIO25 (ESP32), GPIO17 (ESP32-S2) */
-    DAC_CHANNEL_2,      /*!< DAC channel 2 is GPIO26 (ESP32), GPIO18 (ESP32-S2) */
-    DAC_CHANNEL_MAX,
-} dac_channel_t;
+#include "driver/gpio.h"
+#include "hal/dac_types.h"
 
 /**
  * @brief Get the gpio number of a specific DAC channel.
- * 
+ *
  * @param channel Channel to get the gpio number
- * 
  * @param gpio_num output buffer to hold the gpio number
- * 
- * @return 
+ * @return
  *   - ESP_OK if success
- *   - ESP_ERR_INVALID_ARG if channal not valid 
  */
 esp_err_t dac_pad_get_io_num(dac_channel_t channel, gpio_num_t *gpio_num);
 
 /**
  * @brief Set DAC output voltage.
- *
- * DAC output is 8-bit. Maximum (255) corresponds to VDD.
+ *        DAC output is 8-bit. Maximum (255) corresponds to VDD3P3_RTC.
  *
  * @note Need to configure DAC pad before calling this function.
  *       DAC channel 1 is attached to GPIO25, DAC channel 2 is attached to GPIO26
- *
  * @param channel DAC channel
  * @param dac_value DAC output value
  *
  * @return
  *     - ESP_OK success
- *     - ESP_ERR_INVALID_ARG Parameter error
  */
 esp_err_t dac_output_voltage(dac_channel_t channel, uint8_t dac_value);
 
@@ -74,21 +62,53 @@ esp_err_t dac_output_enable(dac_channel_t channel);
  *
  * @param channel DAC channel
  * @note DAC channel 1 is attached to GPIO25, DAC channel 2 is attached to GPIO26
+ * @return
+ *     - ESP_OK success
  */
 esp_err_t dac_output_disable(dac_channel_t channel);
 
 /**
  * @brief Enable DAC output data from I2S
+ *
+ * @return
+ *     - ESP_OK success
  */
 esp_err_t dac_i2s_enable(void);
 
 /**
  * @brief Disable DAC output data from I2S
+ *
+ * @return
+ *     - ESP_OK success
  */
 esp_err_t dac_i2s_disable(void);
+
+/**
+ * @brief Enable cosine wave generator output.
+ *
+ * @return
+ *     - ESP_OK success
+ */
+esp_err_t dac_cw_generator_enable(void);
+
+/**
+ * @brief Disable cosine wave generator output.
+ *
+ * @return
+ *     - ESP_OK success
+ */
+esp_err_t dac_cw_generator_disable(void);
+
+/**
+ * @brief Config the cosine wave generator function in DAC module.
+ *
+ * @param cw Configuration.
+ * @return
+ *     - ESP_OK success
+ */
+esp_err_t dac_cw_generator_config(dac_cw_config_t *cw);
+
 #ifdef __cplusplus
 }
 #endif
 
-#endif  /*_DRIVER_DAC_H_*/
-