mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
fc80d3e568
MCPWM group clock pre scale was originally fixed to 2, which is inconvenient. Set group clock prescale dynamically. Now the maximum resolution of the MCPWM timer is up to 160MHz(when the prescale set to 1). And add a resulotion config for MCPWM capture.
246 lines
11 KiB
C
246 lines
11 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include "esp_err.h"
|
|
#include "driver/mcpwm_types.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief MCPWM capture timer configuration structure
|
|
*/
|
|
typedef struct {
|
|
int group_id; /*!< Specify from which group to allocate the capture timer */
|
|
mcpwm_capture_clock_source_t clk_src; /*!< MCPWM capture timer clock source */
|
|
uint32_t resolution_hz; /*!< Resolution of capture timer */
|
|
} mcpwm_capture_timer_config_t;
|
|
|
|
/**
|
|
* @brief Create MCPWM capture timer
|
|
*
|
|
* @param[in] config MCPWM capture timer configuration
|
|
* @param[out] ret_cap_timer Returned MCPWM capture timer handle
|
|
* @return
|
|
* - ESP_OK: Create MCPWM capture timer successfully
|
|
* - ESP_ERR_INVALID_ARG: Create MCPWM capture timer failed because of invalid argument
|
|
* - ESP_ERR_NO_MEM: Create MCPWM capture timer failed because out of memory
|
|
* - ESP_ERR_NOT_FOUND: Create MCPWM capture timer failed because can't find free resource
|
|
* - ESP_FAIL: Create MCPWM capture timer failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_new_capture_timer(const mcpwm_capture_timer_config_t *config, mcpwm_cap_timer_handle_t *ret_cap_timer);
|
|
|
|
/**
|
|
* @brief Delete MCPWM capture timer
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer, allocated by `mcpwm_new_capture_timer()`
|
|
* @return
|
|
* - ESP_OK: Delete MCPWM capture timer successfully
|
|
* - ESP_ERR_INVALID_ARG: Delete MCPWM capture timer failed because of invalid argument
|
|
* - ESP_FAIL: Delete MCPWM capture timer failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_del_capture_timer(mcpwm_cap_timer_handle_t cap_timer);
|
|
|
|
/**
|
|
* @brief Enable MCPWM capture timer
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer handle, allocated by `mcpwm_new_capture_timer()`
|
|
* @return
|
|
* - ESP_OK: Enable MCPWM capture timer successfully
|
|
* - ESP_ERR_INVALID_ARG: Enable MCPWM capture timer failed because of invalid argument
|
|
* - ESP_ERR_INVALID_STATE: Enable MCPWM capture timer failed because timer is enabled already
|
|
* - ESP_FAIL: Enable MCPWM capture timer failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_timer_enable(mcpwm_cap_timer_handle_t cap_timer);
|
|
|
|
/**
|
|
* @brief Disable MCPWM capture timer
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer handle, allocated by `mcpwm_new_capture_timer()`
|
|
* @return
|
|
* - ESP_OK: Disable MCPWM capture timer successfully
|
|
* - ESP_ERR_INVALID_ARG: Disable MCPWM capture timer failed because of invalid argument
|
|
* - ESP_ERR_INVALID_STATE: Disable MCPWM capture timer failed because timer is disabled already
|
|
* - ESP_FAIL: Disable MCPWM capture timer failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_timer_disable(mcpwm_cap_timer_handle_t cap_timer);
|
|
|
|
/**
|
|
* @brief Start MCPWM capture timer
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer, allocated by `mcpwm_new_capture_timer()`
|
|
* @return
|
|
* - ESP_OK: Start MCPWM capture timer successfully
|
|
* - ESP_ERR_INVALID_ARG: Start MCPWM capture timer failed because of invalid argument
|
|
* - ESP_FAIL: Start MCPWM capture timer failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_timer_start(mcpwm_cap_timer_handle_t cap_timer);
|
|
|
|
/**
|
|
* @brief Start MCPWM capture timer
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer, allocated by `mcpwm_new_capture_timer()`
|
|
* @return
|
|
* - ESP_OK: Stop MCPWM capture timer successfully
|
|
* - ESP_ERR_INVALID_ARG: Stop MCPWM capture timer failed because of invalid argument
|
|
* - ESP_FAIL: Stop MCPWM capture timer failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_timer_stop(mcpwm_cap_timer_handle_t cap_timer);
|
|
|
|
/**
|
|
* @brief Get MCPWM capture timer resolution, in Hz
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer, allocated by `mcpwm_new_capture_timer()`
|
|
* @param[out] out_resolution Returned capture timer resolution, in Hz
|
|
* @return
|
|
* - ESP_OK: Get capture timer resolution successfully
|
|
* - ESP_ERR_INVALID_ARG: Get capture timer resolution failed because of invalid argument
|
|
* - ESP_FAIL: Get capture timer resolution failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_timer_get_resolution(mcpwm_cap_timer_handle_t cap_timer, uint32_t *out_resolution);
|
|
|
|
/**
|
|
* @brief MCPWM Capture timer sync phase configuration
|
|
*/
|
|
typedef struct {
|
|
mcpwm_sync_handle_t sync_src; /*!< The sync event source */
|
|
uint32_t count_value; /*!< The count value that should lock to upon sync event */
|
|
mcpwm_timer_direction_t direction; /*!< The count direction that should lock to upon sync event */
|
|
} mcpwm_capture_timer_sync_phase_config_t;
|
|
|
|
/**
|
|
* @brief Set sync phase for MCPWM capture timer
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer, allocated by `mcpwm_new_capture_timer()`
|
|
* @param[in] config MCPWM capture timer sync phase configuration
|
|
* @return
|
|
* - ESP_OK: Set sync phase for MCPWM capture timer successfully
|
|
* - ESP_ERR_INVALID_ARG: Set sync phase for MCPWM capture timer failed because of invalid argument
|
|
* - ESP_FAIL: Set sync phase for MCPWM capture timer failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_timer_set_phase_on_sync(mcpwm_cap_timer_handle_t cap_timer, const mcpwm_capture_timer_sync_phase_config_t *config);
|
|
|
|
/**
|
|
* @brief MCPWM capture channel configuration structure
|
|
*/
|
|
typedef struct {
|
|
int gpio_num; /*!< GPIO used capturing input signal */
|
|
int intr_priority; /*!< MCPWM capture interrupt priority,
|
|
if set to 0, the driver will try to allocate an interrupt with a relative low priority (1,2,3) */
|
|
uint32_t prescale; /*!< Prescale of input signal, effective frequency = cap_input_clk/prescale */
|
|
struct {
|
|
uint32_t pos_edge: 1; /*!< Whether to capture on positive edge */
|
|
uint32_t neg_edge: 1; /*!< Whether to capture on negative edge */
|
|
uint32_t pull_up: 1; /*!< Whether to pull up internally */
|
|
uint32_t pull_down: 1; /*!< Whether to pull down internally */
|
|
uint32_t invert_cap_signal: 1; /*!< Invert the input capture signal */
|
|
uint32_t io_loop_back: 1; /*!< For debug/test, the signal output from the GPIO will be fed to the input path as well */
|
|
uint32_t keep_io_conf_at_exit: 1; /*!< For debug/test, whether to keep the GPIO configuration when capture channel is deleted.
|
|
By default, driver will reset the GPIO pin at exit. */
|
|
} flags; /*!< Extra configuration flags for capture channel */
|
|
} mcpwm_capture_channel_config_t;
|
|
|
|
/**
|
|
* @brief Create MCPWM capture channel
|
|
*
|
|
* @note The created capture channel won't be enabled until calling `mcpwm_capture_channel_enable`
|
|
*
|
|
* @param[in] cap_timer MCPWM capture timer, allocated by `mcpwm_new_capture_timer()`, will be connected to the new capture channel
|
|
* @param[in] config MCPWM capture channel configuration
|
|
* @param[out] ret_cap_channel Returned MCPWM capture channel
|
|
* @return
|
|
* - ESP_OK: Create MCPWM capture channel successfully
|
|
* - ESP_ERR_INVALID_ARG: Create MCPWM capture channel failed because of invalid argument
|
|
* - ESP_ERR_NO_MEM: Create MCPWM capture channel failed because out of memory
|
|
* - ESP_ERR_NOT_FOUND: Create MCPWM capture channel failed because can't find free resource
|
|
* - ESP_FAIL: Create MCPWM capture channel failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_new_capture_channel(mcpwm_cap_timer_handle_t cap_timer, const mcpwm_capture_channel_config_t *config, mcpwm_cap_channel_handle_t *ret_cap_channel);
|
|
|
|
/**
|
|
* @brief Delete MCPWM capture channel
|
|
*
|
|
* @param[in] cap_channel MCPWM capture channel handle, allocated by `mcpwm_new_capture_channel()`
|
|
* @return
|
|
* - ESP_OK: Delete MCPWM capture channel successfully
|
|
* - ESP_ERR_INVALID_ARG: Delete MCPWM capture channel failed because of invalid argument
|
|
* - ESP_FAIL: Delete MCPWM capture channel failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_del_capture_channel(mcpwm_cap_channel_handle_t cap_channel);
|
|
|
|
/**
|
|
* @brief Enable MCPWM capture channel
|
|
*
|
|
* @note This function will transit the channel state from init to enable.
|
|
* @note This function will enable the interrupt service, if it's lazy installed in `mcpwm_capture_channel_register_event_callbacks()`.
|
|
*
|
|
* @param[in] cap_channel MCPWM capture channel handle, allocated by `mcpwm_new_capture_channel()`
|
|
* @return
|
|
* - ESP_OK: Enable MCPWM capture channel successfully
|
|
* - ESP_ERR_INVALID_ARG: Enable MCPWM capture channel failed because of invalid argument
|
|
* - ESP_ERR_INVALID_STATE: Enable MCPWM capture channel failed because the channel is already enabled
|
|
* - ESP_FAIL: Enable MCPWM capture channel failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_channel_enable(mcpwm_cap_channel_handle_t cap_channel);
|
|
|
|
/**
|
|
* @brief Disable MCPWM capture channel
|
|
*
|
|
* @param[in] cap_channel MCPWM capture channel handle, allocated by `mcpwm_new_capture_channel()`
|
|
* @return
|
|
* - ESP_OK: Disable MCPWM capture channel successfully
|
|
* - ESP_ERR_INVALID_ARG: Disable MCPWM capture channel failed because of invalid argument
|
|
* - ESP_ERR_INVALID_STATE: Disable MCPWM capture channel failed because the channel is not enabled yet
|
|
* - ESP_FAIL: Disable MCPWM capture channel failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_channel_disable(mcpwm_cap_channel_handle_t cap_channel);
|
|
|
|
/**
|
|
* @brief Group of supported MCPWM capture event callbacks
|
|
* @note The callbacks are all running under ISR environment
|
|
*/
|
|
typedef struct {
|
|
mcpwm_capture_event_cb_t on_cap; /*!< Callback function that would be invoked when capture event occurred */
|
|
} mcpwm_capture_event_callbacks_t;
|
|
|
|
/**
|
|
* @brief Set event callbacks for MCPWM capture channel
|
|
*
|
|
* @note The first call to this function needs to be before the call to `mcpwm_capture_channel_enable`
|
|
* @note User can deregister a previously registered callback by calling this function and setting the callback member in the `cbs` structure to NULL.
|
|
*
|
|
* @param[in] cap_channel MCPWM capture channel handle, allocated by `mcpwm_new_capture_channel()`
|
|
* @param[in] cbs Group of callback functions
|
|
* @param[in] user_data User data, which will be passed to callback functions directly
|
|
* @return
|
|
* - ESP_OK: Set event callbacks successfully
|
|
* - ESP_ERR_INVALID_ARG: Set event callbacks failed because of invalid argument
|
|
* - ESP_ERR_INVALID_STATE: Set event callbacks failed because the channel is not in init state
|
|
* - ESP_FAIL: Set event callbacks failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_channel_register_event_callbacks(mcpwm_cap_channel_handle_t cap_channel, const mcpwm_capture_event_callbacks_t *cbs, void *user_data);
|
|
|
|
/**
|
|
* @brief Trigger a catch by software
|
|
*
|
|
* @param[in] cap_channel MCPWM capture channel handle, allocated by `mcpwm_new_capture_channel()`
|
|
* @return
|
|
* - ESP_OK: Trigger software catch successfully
|
|
* - ESP_ERR_INVALID_ARG: Trigger software catch failed because of invalid argument
|
|
* - ESP_ERR_INVALID_STATE: Trigger software catch failed because the channel is not enabled yet
|
|
* - ESP_FAIL: Trigger software catch failed because of other error
|
|
*/
|
|
esp_err_t mcpwm_capture_channel_trigger_soft_catch(mcpwm_cap_channel_handle_t cap_channel);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|