准备 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 · 核对日期