準備 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
說明需要的訊號
填寫 GPIO、通道、頻率(Hz)與解析度(bit),再選擇脈寬(微秒)或占空比(%)。外設腳位清單須按頁面所示訊號順序填寫;USB 等固定路由不能任意改腳。
從板卡到已檢查配置
- 選擇板卡,啟用計畫使用的外設,並核對實際接線腳位。
- 新增 PWM 輸出與目標時序,處理腳位衝突並查看計時器共用情況。
- 閱讀標稱頻率、脈寬量化誤差與檢查項,再下載程式碼。
下載與編譯
可儲存專案、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。
- 選擇指定 Classic 開發板,保留範例的周邊腳位預留。
- 新增兩個輸出:頻率與解析度相同,通道與脈寬不同。
- 確認兩個輸出都使用 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
}
}
本案例尚不能證明的事項
- 不同通道仍可能共用計時器;本固定頻率案例不保證後續執行時改頻獨立。
- 這些脈寬不代表伺服馬達行程安全。任意專案須在外部編譯,網站不燒錄硬體。
參考案例製作日期:
規格資料來源
下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。
- Espressif ESP32-DevKitC V4 user guideesp-dev-kits 1b4c83b · 核對日期
- Arduino-ESP32 LEDC implementationArduino-ESP32 3.3.8 b4f85baa · 核對日期
- ESP-IDF LEDC divider implementationESP-IDF 5.5.4 73550728 · 核對日期
- ESP-IDF Classic ESP32 hardware capabilitiesESP-IDF 5.5.4 73550728 · 核對日期
引出的腳位仍可能被記憶體占用
這款 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。
- 選擇確切的 N16R8 設定,輸入 GPIO35。
- 查看 pin_reserved:此模組的 GPIO35–37 用於記憶體連接。
- 只將輸出腳位改成 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 韌體,也不驗證實體接線。
參考案例製作日期:
規格資料來源
下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。
- Espressif ESP32-S3-DevKitC-1 v1.1 user guidev1.1; esp-dev-kits 1b4c83b · 核對日期
- Espressif ESP32-S3-WROOM-1 module datasheetv1.8; ESP32-S3-WROOM-1-N16R8 · 核對日期
- Arduino-ESP32 LEDC implementationArduino-ESP32 3.3.8 b4f85baa · 核對日期
低頻也需要可實現的分頻組合
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。
- 維持固定時脈,輸入 8 bit 設定。
- 先閱讀 divider_out_of_range,再考慮匯出可用程式碼。
- 將解析度改成 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 韌體須在此模擬器之外編譯與驗證。
參考案例製作日期:
規格資料來源
下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。
- Espressif ESP32-C3-DevKitM-1 user guideesp-dev-kits 1b4c83b · 核對日期
- ESP-IDF ESP32-C3 hardware capabilitiesESP-IDF 5.5.4 73550728 · 核對日期
- ESP-IDF LEDC divider implementationESP-IDF 5.5.4 73550728 · 核對日期
- Arduino-ESP32 LEDC implementationArduino-ESP32 3.3.8 b4f85baa · 核對日期
數值合法仍可能需要核對
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。
- 輸入 GPIO0,不勾選 strapping 條件確認。
- 閱讀 pin_strapping,保留 needs_review 結果。
- 儲存參考專案供檢查;核對實際重設電位條件後,才能改變宣告。
參考檢查結果
需要進一步核對
時序可以計算,但 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
}
}
本案例尚不能證明的事項
- 核取方塊只是宣告,不會量測外部上拉/下拉電阻或重設電位。
- 本例保留待確認,不證明已連接的伺服馬達或開發板能安全啟動。
參考案例製作日期:
規格資料來源
下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。
- Espressif ESP32-DevKitC V4 user guideesp-dev-kits 1b4c83b · 核對日期
- Espressif ESP32-WROOM-32E module datasheetv2.1; ESP32-WROOM-32E-N4 · 核對日期
- Arduino-ESP32 LEDC implementationArduino-ESP32 3.3.8 b4f85baa · 核對日期