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

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 <inttypes.h>
+
+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));
+    }
+}
+```

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 參數設置

sidebars.js

@@ -47,6 +47,7 @@ const sidebars = {
                 label: ' ',
                 href: '#'
               },
+              'micro-controladores/ESP32/esp32-mcpwm-usage-and-examples',
               'micro-controladores/ESP32/esp32-rf24-demo'
             ]
         },