Microduck Robot●microduck-robot.com
工具

ESP32 腳位與 PWM 配置器

先選準確的開發板,預留周邊腳位,再配置 PWM 輸出。

正在載入工具…

準備 ESP32 腳位與 PWM 配置

編寫韌體前,先核對聲明的板卡配置。請選擇具體模組版本:不同 ESP32 系列的引出腳、記憶體保留腳與 LEDC 資源並不相同。

板卡配置與固定時鐘

  • ESP32-DevKitC V4 / WROOM-32E-N4 · APB 80 MHz · esp32:esp32 3.3.8 / ESP-IDF 5.5.4
  • ESP32-S3-DevKitC-1 v1.1 / WROOM-1-N16R8 · XTAL 40 MHz · esp32:esp32 3.3.8 / ESP-IDF 5.5.4
  • ESP32-C3-DevKitM-1 / MINI-1-N4X · XTAL 40 MHz · esp32:esp32 3.3.8 / ESP-IDF 5.5.4

規則版本: 2026-11-12.2

說明需要的訊號

填寫 GPIO、通道、頻率(Hz)與解析度(bit),再選擇脈寬(微秒)或占空比(%)。外設腳位清單須按頁面所示訊號順序填寫;USB 等固定路由不能任意改腳。

從板卡到已檢查配置

  1. 選擇板卡,啟用計畫使用的外設,並核對實際接線腳位。
  2. 新增 PWM 輸出與目標時序,處理腳位衝突並查看計時器共用情況。
  3. 閱讀標稱頻率、脈寬量化誤差與檢查項,再下載程式碼。

下載與編譯

可儲存專案、JSON 報告或通道 CSV。必要檢查通過後,可下載草圖或包含原始碼、板卡設定與鎖定版本的 ZIP 專案封裝。任意配置需要在外部編譯;連結中的經典 ESP32 範例是獨立的模擬環境。

檢查範圍與限制

時鐘與計時器行為按鎖定的驅動模型計算,不承諾動態改頻後仍獨立。S3、C3 僅提供配置與專案匯出。離線檢查不能驗證接線、伺服馬達行程或供電實況,頁面不會燒錄硬體。

PWM 完整操作案例

以固定版本的輸入逐步核對結果。時序與脈寬是計算值,並非開發板實測值。

離線配置檢查不代表真實硬體或安全性已驗證。 這些合成案例與上方表單輸入的配置相互獨立。匯入案例後會重新檢查輸入,不直接採用已儲存的結論。

兩個輸出共用一個計時器

通道編號不同,執行時改頻就一定互不影響嗎?

適用版本: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

輸入條件與操作步驟

ESP32-DevKitC V4 / WROOM-32E-N4;APB 80 MHz;GPIO18/通道 0 與 GPIO19/通道 1;50 Hz、14 bit;脈寬 1500 µs 與 1000 µs。

  1. 選擇指定 Classic 開發板,保留範例的周邊腳位預留。
  2. 新增兩個輸出:頻率與解析度相同,通道與脈寬不同。
  3. 確認兩個輸出都使用 group 0/timer 0,並查看標稱脈寬誤差。

參考檢查結果

未發現已知配置衝突

未發現已知設定衝突。兩個輸出共用 timer 0;標稱誤差約為 +0.244141 µs 與 −0.244141 µs。

查看輸入與參考結果 JSON
{
  "inputs": {
    "profileId": "esp32-devkitc-v4-wroom32e-n4",
    "peripherals": {
      "uart0": true,
      "usb": false,
      "i2c": false,
      "spi": false,
      "jtag": false,
      "onboardLed": true
    },
    "peripheralPins": {
      "uart0": [
        1,
        3
      ],
      "usb": [],
      "i2c": [
        21,
        22
      ],
      "spi": [
        5,
        23,
        19,
        18
      ],
      "jtag": [
        12,
        13,
        14,
        15
      ],
      "onboardLed": []
    },
    "allowStrapping": false,
    "dynamicFrequency": false,
    "outputs": [
      {
        "gpio": 18,
        "channel": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "mode": "pulse",
        "pulseUs": 1500
      },
      {
        "gpio": 19,
        "channel": 1,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "mode": "pulse",
        "pulseUs": 1000
      }
    ]
  },
  "status": "no_known_conflict",
  "findings": [],
  "outputs": {
    "board": "ESP32-DevKitC V4 / WROOM-32E-N4",
    "clock": {
      "source": "APB",
      "hz": 80000000,
      "unit": "Hz",
      "sourceRef": "arduino-ledc"
    },
    "channels": [
      {
        "index": 0,
        "gpio": 18,
        "header": "J3.9",
        "channel": 0,
        "group": 0,
        "timer": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "dividerRaw": 25000,
        "divider": 97.65625,
        "actualFrequencyHz": 50,
        "readbackFrequencyHz": 50,
        "periodUs": 20000,
        "precision": 16384,
        "mode": "pulse",
        "targetHighUs": 1500,
        "duty": 1229,
        "effectiveTicks": 1229,
        "actualHighUs": 1500.244140625,
        "pulseErrorUs": 0.244140625,
        "actualDutyPercent": 7.501220703125,
        "sharedChannel": false
      },
      {
        "index": 1,
        "gpio": 19,
        "header": "J3.8",
        "channel": 1,
        "group": 0,
        "timer": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "dividerRaw": 25000,
        "divider": 97.65625,
        "actualFrequencyHz": 50,
        "readbackFrequencyHz": 50,
        "periodUs": 20000,
        "precision": 16384,
        "mode": "pulse",
        "targetHighUs": 1000,
        "duty": 819,
        "effectiveTicks": 819,
        "actualHighUs": 999.755859375,
        "pulseErrorUs": -0.244140625,
        "actualDutyPercent": 4.998779296875,
        "sharedChannel": false
      }
    ],
    "enabledResources": [
      {
        "resource": "uart0",
        "pins": [
          1,
          3
        ]
      },
      {
        "resource": "onboardLed",
        "pins": []
      }
    ],
    "timerUse": [
      {
        "group": 0,
        "used": 1,
        "maximum": 4
      },
      {
        "group": 1,
        "used": 0,
        "maximum": 4
      }
    ],
    "simulatorSupported": true,
    "fixedFrequencyOnly": true,
    "codeReady": true
  }
}

本案例尚不能證明的事項

  • 不同通道仍可能共用計時器;本固定頻率案例不保證後續執行時改頻獨立。
  • 這些脈寬不代表伺服馬達行程安全。任意專案須在外部編譯,網站不燒錄硬體。

參考案例製作日期:

規格資料來源

下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。

引出的腳位仍可能被記憶體占用

這款 S3 為什麼不能使用 GPIO35?

適用版本: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

輸入條件與操作步驟

ESP32-S3-DevKitC-1 v1.1 / WROOM-1-N16R8;GPIO35/通道 0;50 Hz、14 bit、1500 µs。

  1. 選擇確切的 N16R8 設定,輸入 GPIO35。
  2. 查看 pin_reserved:此模組的 GPIO35–37 用於記憶體連接。
  3. 只將輸出腳位改成 GPIO18,再核對調整後的報告。

參考檢查結果

此配置不可使用

原設定因使用保留腳位而被阻擋。

查看輸入與參考結果 JSON
{
  "inputs": {
    "profileId": "esp32s3-devkitc1-v1.1-n16r8",
    "peripherals": {
      "uart0": true,
      "usb": false,
      "i2c": false,
      "spi": false,
      "jtag": false,
      "onboardLed": true
    },
    "peripheralPins": {
      "uart0": [
        43,
        44
      ],
      "usb": [
        19,
        20
      ],
      "i2c": [
        8,
        9
      ],
      "spi": [
        10,
        11,
        13,
        12
      ],
      "jtag": [
        39,
        40,
        41,
        42
      ],
      "onboardLed": [
        38
      ]
    },
    "allowStrapping": false,
    "dynamicFrequency": false,
    "outputs": [
      {
        "gpio": 35,
        "channel": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "mode": "pulse",
        "pulseUs": 1500
      }
    ]
  },
  "status": "blocked",
  "findings": [
    {
      "code": "pin_reserved",
      "severity": "blocked",
      "fieldPath": "outputs.0.gpio",
      "messageKey": "pinReserved",
      "details": {
        "gpio": 35,
        "reason": "octal_psram"
      },
      "sourceRef": "s3-board"
    }
  ],
  "outputs": {
    "board": "ESP32-S3-DevKitC-1 v1.1 / WROOM-1-N16R8",
    "clock": {
      "source": "XTAL",
      "hz": 40000000,
      "unit": "Hz",
      "sourceRef": "arduino-ledc"
    },
    "channels": [],
    "enabledResources": [
      {
        "resource": "uart0",
        "pins": [
          43,
          44
        ]
      },
      {
        "resource": "onboardLed",
        "pins": [
          38
        ]
      }
    ],
    "timerUse": [
      {
        "group": 0,
        "used": 0,
        "maximum": 4
      }
    ],
    "simulatorSupported": false,
    "fixedFrequencyOnly": true,
    "codeReady": false
  }
}

調整後重新檢查

改用 GPIO18 後,這份宣告設定的已知衝突消失。

未發現已知配置衝突

查看調整後的參考 JSON
{
  "inputs": {
    "profileId": "esp32s3-devkitc1-v1.1-n16r8",
    "peripherals": {
      "uart0": true,
      "usb": false,
      "i2c": false,
      "spi": false,
      "jtag": false,
      "onboardLed": true
    },
    "peripheralPins": {
      "uart0": [
        43,
        44
      ],
      "usb": [
        19,
        20
      ],
      "i2c": [
        8,
        9
      ],
      "spi": [
        10,
        11,
        13,
        12
      ],
      "jtag": [
        39,
        40,
        41,
        42
      ],
      "onboardLed": [
        38
      ]
    },
    "allowStrapping": false,
    "dynamicFrequency": false,
    "outputs": [
      {
        "gpio": 18,
        "channel": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "mode": "pulse",
        "pulseUs": 1500
      }
    ]
  },
  "status": "no_known_conflict",
  "findings": [],
  "outputs": {
    "board": "ESP32-S3-DevKitC-1 v1.1 / WROOM-1-N16R8",
    "clock": {
      "source": "XTAL",
      "hz": 40000000,
      "unit": "Hz",
      "sourceRef": "arduino-ledc"
    },
    "channels": [
      {
        "index": 0,
        "gpio": 18,
        "header": "J1.11",
        "channel": 0,
        "group": 0,
        "timer": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "dividerRaw": 12500,
        "divider": 48.828125,
        "actualFrequencyHz": 50,
        "readbackFrequencyHz": 50,
        "periodUs": 20000,
        "precision": 16384,
        "mode": "pulse",
        "targetHighUs": 1500,
        "duty": 1229,
        "effectiveTicks": 1229,
        "actualHighUs": 1500.244140625,
        "pulseErrorUs": 0.244140625,
        "actualDutyPercent": 7.501220703125,
        "sharedChannel": false
      }
    ],
    "enabledResources": [
      {
        "resource": "uart0",
        "pins": [
          43,
          44
        ]
      },
      {
        "resource": "onboardLed",
        "pins": [
          38
        ]
      }
    ],
    "timerUse": [
      {
        "group": 0,
        "used": 1,
        "maximum": 4
      }
    ],
    "simulatorSupported": false,
    "fixedFrequencyOnly": true,
    "codeReady": true
  }
}

本案例尚不能證明的事項

  • 限制適用於這個模組與記憶體版本,不能套用到所有 S3 開發板。
  • S3 僅提供設定與外部編譯專案匯出;本站不模擬 S3 韌體,也不驗證實體接線。

參考案例製作日期:

規格資料來源

下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。

低頻也需要可實現的分頻組合

C3 的 50 Hz、8 bit 為什麼無法通過?

適用版本: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

輸入條件與操作步驟

ESP32-C3-DevKitM-1 / MINI-1-N4X;XTAL 40 MHz;GPIO4/通道 0;50 Hz、8 bit、1500 µs。

  1. 維持固定時脈,輸入 8 bit 設定。
  2. 先閱讀 divider_out_of_range,再考慮匯出可用程式碼。
  3. 將解析度改成 14 bit,比較時序結果。

參考檢查結果

此配置不可使用

8 bit 組合超出分頻器允許範圍。

查看輸入與參考結果 JSON
{
  "inputs": {
    "profileId": "esp32c3-devkitm1-n4x",
    "peripherals": {
      "uart0": true,
      "usb": false,
      "i2c": false,
      "spi": false,
      "jtag": false,
      "onboardLed": true
    },
    "peripheralPins": {
      "uart0": [
        21,
        20
      ],
      "usb": [
        18,
        19
      ],
      "i2c": [
        8,
        9
      ],
      "spi": [
        7,
        6,
        5,
        4
      ],
      "jtag": [
        4,
        5,
        6,
        7
      ],
      "onboardLed": [
        8
      ]
    },
    "allowStrapping": false,
    "dynamicFrequency": false,
    "outputs": [
      {
        "gpio": 4,
        "channel": 0,
        "frequencyHz": 50,
        "resolutionBits": 8,
        "mode": "pulse",
        "pulseUs": 1500
      }
    ]
  },
  "status": "blocked",
  "findings": [
    {
      "code": "divider_out_of_range",
      "severity": "blocked",
      "fieldPath": "outputs.0.frequencyHz",
      "messageKey": "frequencyUnavailable",
      "details": {
        "frequency": 50,
        "bits": 8
      },
      "sourceRef": "idf-ledc"
    }
  ],
  "outputs": {
    "board": "ESP32-C3-DevKitM-1 / MINI-1-N4X",
    "clock": {
      "source": "XTAL",
      "hz": 40000000,
      "unit": "Hz",
      "sourceRef": "arduino-ledc"
    },
    "channels": [],
    "enabledResources": [
      {
        "resource": "uart0",
        "pins": [
          21,
          20
        ]
      },
      {
        "resource": "onboardLed",
        "pins": [
          8
        ]
      }
    ],
    "timerUse": [
      {
        "group": 0,
        "used": 0,
        "maximum": 4
      }
    ],
    "simulatorSupported": false,
    "fixedFrequencyOnly": true,
    "codeReady": false
  }
}

調整後重新檢查

14 bit 時標稱頻率為 50 Hz,高電位脈寬為 1500.244140625 µs。

未發現已知配置衝突

查看調整後的參考 JSON
{
  "inputs": {
    "profileId": "esp32c3-devkitm1-n4x",
    "peripherals": {
      "uart0": true,
      "usb": false,
      "i2c": false,
      "spi": false,
      "jtag": false,
      "onboardLed": true
    },
    "peripheralPins": {
      "uart0": [
        21,
        20
      ],
      "usb": [
        18,
        19
      ],
      "i2c": [
        8,
        9
      ],
      "spi": [
        7,
        6,
        5,
        4
      ],
      "jtag": [
        4,
        5,
        6,
        7
      ],
      "onboardLed": [
        8
      ]
    },
    "allowStrapping": false,
    "dynamicFrequency": false,
    "outputs": [
      {
        "gpio": 4,
        "channel": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "mode": "pulse",
        "pulseUs": 1500
      }
    ]
  },
  "status": "no_known_conflict",
  "findings": [],
  "outputs": {
    "board": "ESP32-C3-DevKitM-1 / MINI-1-N4X",
    "clock": {
      "source": "XTAL",
      "hz": 40000000,
      "unit": "Hz",
      "sourceRef": "arduino-ledc"
    },
    "channels": [
      {
        "index": 0,
        "gpio": 4,
        "header": "J3.11",
        "channel": 0,
        "group": 0,
        "timer": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "dividerRaw": 12500,
        "divider": 48.828125,
        "actualFrequencyHz": 50,
        "readbackFrequencyHz": 50,
        "periodUs": 20000,
        "precision": 16384,
        "mode": "pulse",
        "targetHighUs": 1500,
        "duty": 1229,
        "effectiveTicks": 1229,
        "actualHighUs": 1500.244140625,
        "pulseErrorUs": 0.244140625,
        "actualDutyPercent": 7.501220703125,
        "sharedChannel": false
      }
    ],
    "enabledResources": [
      {
        "resource": "uart0",
        "pins": [
          21,
          20
        ]
      },
      {
        "resource": "onboardLed",
        "pins": [
          8
        ]
      }
    ],
    "timerUse": [
      {
        "group": 0,
        "used": 1,
        "maximum": 4
      }
    ],
    "simulatorSupported": false,
    "fixedFrequencyOnly": true,
    "codeReady": true
  }
}

本案例尚不能證明的事項

  • 低頻邊界取決於時脈與解析度,並非 C3 的通用最低頻率。
  • 結果是計算值,不是波形實測。C3 韌體須在此模擬器之外編譯與驗證。

參考案例製作日期:

規格資料來源

下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。

數值合法仍可能需要核對

GPIO0 為什麼不能自動判定通過?

適用版本: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

輸入條件與操作步驟

Classic ESP32 設定;GPIO0/通道 0;50 Hz、14 bit、1500 µs;allowStrapping=false。

  1. 輸入 GPIO0,不勾選 strapping 條件確認。
  2. 閱讀 pin_strapping,保留 needs_review 結果。
  3. 儲存參考專案供檢查;核對實際重設電位條件後,才能改變宣告。

參考檢查結果

需要進一步核對

時序可以計算,但 strapping 條件未確認時 codeReady 仍為 false。

查看輸入與參考結果 JSON
{
  "inputs": {
    "profileId": "esp32-devkitc-v4-wroom32e-n4",
    "peripherals": {
      "uart0": true,
      "usb": false,
      "i2c": false,
      "spi": false,
      "jtag": false,
      "onboardLed": true
    },
    "peripheralPins": {
      "uart0": [
        1,
        3
      ],
      "usb": [],
      "i2c": [
        21,
        22
      ],
      "spi": [
        5,
        23,
        19,
        18
      ],
      "jtag": [
        12,
        13,
        14,
        15
      ],
      "onboardLed": []
    },
    "allowStrapping": false,
    "dynamicFrequency": false,
    "outputs": [
      {
        "gpio": 0,
        "channel": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "mode": "pulse",
        "pulseUs": 1500
      }
    ]
  },
  "status": "needs_review",
  "findings": [
    {
      "code": "pin_strapping",
      "severity": "needs_review",
      "fieldPath": "outputs.0.gpio",
      "messageKey": "pinStrapping",
      "details": {
        "gpio": 0
      },
      "sourceRef": "classic-board"
    }
  ],
  "outputs": {
    "board": "ESP32-DevKitC V4 / WROOM-32E-N4",
    "clock": {
      "source": "APB",
      "hz": 80000000,
      "unit": "Hz",
      "sourceRef": "arduino-ledc"
    },
    "channels": [
      {
        "index": 0,
        "gpio": 0,
        "header": "J3.14",
        "channel": 0,
        "group": 0,
        "timer": 0,
        "frequencyHz": 50,
        "resolutionBits": 14,
        "dividerRaw": 25000,
        "divider": 97.65625,
        "actualFrequencyHz": 50,
        "readbackFrequencyHz": 50,
        "periodUs": 20000,
        "precision": 16384,
        "mode": "pulse",
        "targetHighUs": 1500,
        "duty": 1229,
        "effectiveTicks": 1229,
        "actualHighUs": 1500.244140625,
        "pulseErrorUs": 0.244140625,
        "actualDutyPercent": 7.501220703125,
        "sharedChannel": false
      }
    ],
    "enabledResources": [
      {
        "resource": "uart0",
        "pins": [
          1,
          3
        ]
      },
      {
        "resource": "onboardLed",
        "pins": []
      }
    ],
    "timerUse": [
      {
        "group": 0,
        "used": 1,
        "maximum": 4
      },
      {
        "group": 1,
        "used": 0,
        "maximum": 4
      }
    ],
    "simulatorSupported": true,
    "fixedFrequencyOnly": true,
    "codeReady": false
  }
}

本案例尚不能證明的事項

  • 核取方塊只是宣告,不會量測外部上拉/下拉電阻或重設電位。
  • 本例保留待確認,不證明已連接的伺服馬達或開發板能安全啟動。

參考案例製作日期:

規格資料來源

下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。

聯絡我們