From 8d71518f1a97d0924eee6c76307939fa15086a12 Mon Sep 17 00:00:00 2001 From: w0x7ce Date: Tue, 16 Jul 2024 14:25:24 +0800 Subject: [PATCH] Add: ESP32 pio_nrf & idf.py_mcpwm new file: docs/micro-controladores/ESP32/esp32-mcpwm-usage-and-examples.md modified: docs/micro-controladores/ESP32/esp32-rf24-demo.md modified: sidebars.js --- .../ESP32/esp32-mcpwm-usage-and-examples.md | 226 ++++++++++++++++++ .../ESP32/esp32-rf24-demo.md | 2 +- sidebars.js | 1 + 3 files changed, 228 insertions(+), 1 deletion(-) create mode 100644 docs/micro-controladores/ESP32/esp32-mcpwm-usage-and-examples.md diff --git a/docs/micro-controladores/ESP32/esp32-mcpwm-usage-and-examples.md b/docs/micro-controladores/ESP32/esp32-mcpwm-usage-and-examples.md new file mode 100644 index 000000000..39e1f375e --- /dev/null +++ b/docs/micro-controladores/ESP32/esp32-mcpwm-usage-and-examples.md @@ -0,0 +1,226 @@ +--- +slug: esp32-mcpwm-usage-and-examples +title: ESP32 MCPWM EXAMPLE +authors: + - name: w0x7ce + title: Embedded Systems Engineer + url: https://github.com/tianrking + image_url: https://github.com/tianrking.png +tags: [ESP32, embedded systems, state machine optimization] +--- + +## ESP32 引腳功能推薦 + +### 通用 GPIO (輸入/輸出) +推薦使用以下引腳，這些引腳沒有特殊功能限制，可以安全地用於大多數項目： +- GPIO 13, 14, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33 + +### ADC (模數轉換) +ESP32 提供兩組 ADC，推薦使用以下引腳： +- **ADC1**: GPIO 36, 39, 32, 33, 34, 35 +- **ADC2** (僅在 Wi-Fi 未啟用時可用): GPIO 4, 0, 2, 15, 13, 12, 14, 27, 25, 26 + +### DAC (數模轉換) +僅限以下引腳： +- GPIO 25, 26 + +### PWM (脈衝寬度調變) +除了 GPIO 34-39 和 SPI flash 引腳 (6-11) 外，所有輸出引腳都可用，推薦使用以下引腳： +- GPIO 13, 14, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33 + +### MCPWM (高級 PWM) +ESP32 有兩個 MCPWM 單元（MCPWM0 和 MCPWM1），每個單元有 3 個定時器和 6 個輸出。 +- **MCPWM0** 和 **MCPWM1** 可用引腳：GPIO 0, 2, 4, 5, 12, 13, 14, 15, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33 +- 推薦使用：GPIO 13, 14, 16, 17, 18, 19, 21, 22, 23, 25, 26, 27, 32, 33 + +#### 互補輸出 +每個 MCPWM 單元的 6 個輸出被分為 3 對，每對可以輸出互補信號。互补对可以分配到几乎任意GPIO组合。對於互補輸出，您需要選擇同一 MCPWM 單元中的一對輸出。例如： +- **MCPWM0**： + - PWM0A - PWM0B + - PWM1A - PWM1B + - PWM2A - PWM2B +- **MCPWM1** 同理 + +### I2C +默認引腳如下： +- SDA：GPIO 21 +- SCL：GPIO 22 +可配置為其他引腳，但推薦使用默認值。 + +### SPI +ESP32 支持兩組 SPI 引腳： +- **VSPI (默認)**： + - MOSI：GPIO 23 + - MISO：GPIO 19 + - CLK：GPIO 18 + - CS：GPIO 5 +- **HSPI**： + - MOSI：GPIO 13 + - MISO：GPIO 12 + - CLK：GPIO 14 + - CS：GPIO 15 + +### UART +ESP32 有三個 UART 模組，引腳配置如下： +- **UART0 (默認)**： + - TX：GPIO 1 + - RX：GPIO 3 +- **UART1**： + - TX：GPIO 10 + - RX：GPIO 9 +- **UART2**： + - TX：GPIO 17 + - RX：GPIO 16 + +### 電容式觸摸傳感器 +推薦使用以下引腳，避免使用 Strapping 引腳： +- GPIO 13, 14, 27, 32, 33 + +### RTC GPIO (深度睡眠模式可用) +可用引腳如下： +- GPIO 0, 2, 4, 12-15, 25-27, 32-39 + +### 模擬霍爾傳感器 +僅限以下引腳： +- GPIO 36, 39 + + +```c++ title="互補PWM" +#include "freertos/FreeRTOS.h" +#include "freertos/task.h" +#include "esp_log.h" +#include "driver/mcpwm_prelude.h" +#include + +static const char *TAG = "example"; + +// 定義 MCPWM 參數 +#define MCPWM_TIMER_RESOLUTION_HZ 10000000 // 10MHz, 1 tick = 0.1us +#define MCPWM_FREQ_HZ_INITIAL 10000 // 初始頻率為 10KHz +#define MCPWM_GPIO_A 18 // PWM 輸出 A 的 GPIO +#define MCPWM_GPIO_B 21 // PWM 輸出 B 的 GPIO +#define MCPWM_DUTY_CYCLE_INITIAL 30 // 初始占空比為 30% + +// PWM 配置結構體 +typedef struct { + mcpwm_timer_handle_t timer; + mcpwm_oper_handle_t oper; + mcpwm_cmpr_handle_t cmpa; + mcpwm_cmpr_handle_t cmpb; + mcpwm_gen_handle_t gena; + mcpwm_gen_handle_t genb; +} pwm_config_t; + +// 初始化 PWM +static pwm_config_t init_pwm(void) { + pwm_config_t config; + + ESP_LOGI(TAG, "初始化 MCPWM 模組"); + + // 步驟 1: 創建 MCPWM 定時器 + mcpwm_timer_config_t timer_config = { + .group_id = 0, + .clk_src = MCPWM_TIMER_CLK_SRC_DEFAULT, + .resolution_hz = MCPWM_TIMER_RESOLUTION_HZ, + .period_ticks = MCPWM_TIMER_RESOLUTION_HZ / MCPWM_FREQ_HZ_INITIAL, + .count_mode = MCPWM_TIMER_COUNT_MODE_UP, + }; + ESP_ERROR_CHECK(mcpwm_new_timer(&timer_config, &config.timer)); + + // 步驟 2: 創建 MCPWM 運算器 + mcpwm_operator_config_t operator_config = { + .group_id = 0, + }; + ESP_ERROR_CHECK(mcpwm_new_operator(&operator_config, &config.oper)); + + // 步驟 3: 將定時器連接到運算器 + ESP_ERROR_CHECK(mcpwm_operator_connect_timer(config.oper, config.timer)); + + // 步驟 4: 創建比較器 + mcpwm_comparator_config_t comparator_config = { + .flags.update_cmp_on_tez = true, + }; + ESP_ERROR_CHECK(mcpwm_new_comparator(config.oper, &comparator_config, &config.cmpa)); + ESP_ERROR_CHECK(mcpwm_new_comparator(config.oper, &comparator_config, &config.cmpb)); + + // 步驟 5: 創建 PWM 生成器 + mcpwm_generator_config_t generator_config = { + .gen_gpio_num = MCPWM_GPIO_A, + }; + ESP_ERROR_CHECK(mcpwm_new_generator(config.oper, &generator_config, &config.gena)); + generator_config.gen_gpio_num = MCPWM_GPIO_B; + ESP_ERROR_CHECK(mcpwm_new_generator(config.oper, &generator_config, &config.genb)); + + // 步驟 6: 設置生成器 A 的動作 (占空比) + ESP_ERROR_CHECK(mcpwm_generator_set_actions_on_timer_event(config.gena, + MCPWM_GEN_TIMER_EVENT_ACTION(MCPWM_TIMER_DIRECTION_UP, MCPWM_TIMER_EVENT_EMPTY, MCPWM_GEN_ACTION_HIGH), + MCPWM_GEN_TIMER_EVENT_ACTION_END())); + ESP_ERROR_CHECK(mcpwm_generator_set_actions_on_compare_event(config.gena, + MCPWM_GEN_COMPARE_EVENT_ACTION(MCPWM_TIMER_DIRECTION_UP, config.cmpa, MCPWM_GEN_ACTION_LOW), + MCPWM_GEN_COMPARE_EVENT_ACTION_END())); + + // 步驟 7: 設置生成器 B 的動作 (互補輸出) + ESP_ERROR_CHECK(mcpwm_generator_set_actions_on_timer_event(config.genb, + MCPWM_GEN_TIMER_EVENT_ACTION(MCPWM_TIMER_DIRECTION_UP, MCPWM_TIMER_EVENT_EMPTY, MCPWM_GEN_ACTION_LOW), + MCPWM_GEN_TIMER_EVENT_ACTION_END())); + ESP_ERROR_CHECK(mcpwm_generator_set_actions_on_compare_event(config.genb, + MCPWM_GEN_COMPARE_EVENT_ACTION(MCPWM_TIMER_DIRECTION_UP, config.cmpa, MCPWM_GEN_ACTION_HIGH), + MCPWM_GEN_COMPARE_EVENT_ACTION_END())); + + // 步驟 8: 設置初始比較值 (決定初始占空比) + uint32_t compare_val = (MCPWM_TIMER_RESOLUTION_HZ / MCPWM_FREQ_HZ_INITIAL) * MCPWM_DUTY_CYCLE_INITIAL / 100; + ESP_ERROR_CHECK(mcpwm_comparator_set_compare_value(config.cmpa, compare_val)); + ESP_ERROR_CHECK(mcpwm_comparator_set_compare_value(config.cmpb, compare_val)); + + // 步驟 9: 啟用 MCPWM 定時器 + ESP_ERROR_CHECK(mcpwm_timer_enable(config.timer)); + + // 步驟 10: 啟動 MCPWM 定時器 + ESP_ERROR_CHECK(mcpwm_timer_start_stop(config.timer, MCPWM_TIMER_START_NO_STOP)); + + ESP_LOGI(TAG, "MCPWM 互補輸出已啟動"); + ESP_LOGI(TAG, "GPIO%d: %d%% 占空比, GPIO%d: %d%% 占空比", + MCPWM_GPIO_A, MCPWM_DUTY_CYCLE_INITIAL, MCPWM_GPIO_B, 100 - MCPWM_DUTY_CYCLE_INITIAL); + ESP_LOGI(TAG, "頻率: %dHz", MCPWM_FREQ_HZ_INITIAL); + + return config; +} + +// 設置占空比 +static void set_duty_cycle(pwm_config_t* config, float duty_cycle) { + uint32_t compare_val = (MCPWM_TIMER_RESOLUTION_HZ / MCPWM_FREQ_HZ_INITIAL) * duty_cycle / 100; + ESP_ERROR_CHECK(mcpwm_comparator_set_compare_value(config->cmpa, compare_val)); + ESP_ERROR_CHECK(mcpwm_comparator_set_compare_value(config->cmpb, compare_val)); +} + +// 設置頻率 +static void set_frequency(pwm_config_t* config, uint32_t freq_hz) { + ESP_ERROR_CHECK(mcpwm_timer_set_period(config->timer, MCPWM_TIMER_RESOLUTION_HZ / freq_hz)); +} + +void app_main(void) +{ + // 初始化 PWM 配置 + pwm_config_t pwm_config = init_pwm(); + + // 初始占空比和頻率 + float duty_cycle = MCPWM_DUTY_CYCLE_INITIAL; + uint32_t freq_hz = MCPWM_FREQ_HZ_INITIAL; + + while (1) { + // 每 5 秒鐘改變一次占空比 (30% -> 70% -> 30% ...) + duty_cycle = (duty_cycle == 30) ? 70 : 30; + set_duty_cycle(&pwm_config, duty_cycle); + ESP_LOGI(TAG, "占空比已設置為 %.0f%%", duty_cycle); + + vTaskDelay(pdMS_TO_TICKS(5000)); + + // 每 10 秒鐘改變一次頻率 (10kHz -> 5kHz -> 10kHz ...) + freq_hz = (freq_hz == 10000) ? 5000 : 10000; + set_frequency(&pwm_config, freq_hz); + ESP_LOGI(TAG, "頻率已設置為 %"PRIu32" Hz", freq_hz); + + vTaskDelay(pdMS_TO_TICKS(5000)); + } +} +``` \ No newline at end of file diff --git a/docs/micro-controladores/ESP32/esp32-rf24-demo.md b/docs/micro-controladores/ESP32/esp32-rf24-demo.md index b51583b13..78ef4659c 100644 --- a/docs/micro-controladores/ESP32/esp32-rf24-demo.md +++ b/docs/micro-controladores/ESP32/esp32-rf24-demo.md @@ -8,7 +8,7 @@ authors: url: https://github.com/tianrking image_url: https://github.com/tianrking.png -tags: [RP2040, PIO, LED Control, Resource Management, Raspberry Pi Pico, embedded systems, state machine optimization] +tags: [ESP32, Resource Management, embedded systems] --- ### RP2040 和 NRF24L01 引腳對應關係及 RF 參數設置 diff --git a/sidebars.js b/sidebars.js index 9e9d26d37..29d36bb53 100644 --- a/sidebars.js +++ b/sidebars.js @@ -47,6 +47,7 @@ const sidebars = { label: ' ', href: '#' }, + 'micro-controladores/ESP32/esp32-mcpwm-usage-and-examples', 'micro-controladores/ESP32/esp32-rf24-demo' ] },