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
  }
}

本案例尚不能证明的事项

  • 勾选框只是声明,不会测量外部上下拉电阻或复位电平。
  • 本例保留待确认,不证明已连接舵机或开发板能安全启动。

参考案例制作日期:

规格资料来源

下列链接保留技术资料的原文标题。请结合案例假设,核对资料版本及核对日期。

联系我们