Microduck Robot●microduck-robot.com
ツール

ESP32 ピン・PWM 設定

正確なボードを選び、周辺機能のピンを予約してから PWM を設定します。

ツールを読み込み中…

ESP32のピンとPWMを準備する

ファームウェアを作る前に構成を確認します。正確なモジュール版によって、引き出しピン、メモリー予約ピン、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を出力できます。任意の構成は外部でコンパイルします。Classic ESP32の例は別のシミュレーションです。

この検査の限界

固定版ドライバーのモデルで計算し、動的な周波数変更後の独立性は保証しません。S3/C3は構成と出力の対象です。配線、サーボ可動域、実際の電源は検証せず、ハードウェアへの書き込みも行いません。

PWM設定の実例

固定バージョンの入力を使い、ローカル検査の結果まで確認します。時刻やパルス幅は計算値であり、実測値ではありません。

ローカル確認は実機の動作や安全性を保証しません。 ここに示す合成ケースは、上のフォームに入力した値とは別の参考データです。ケースをインポートすると入力から再チェックされ、保存済みの判定はそのまま採用されません。

2出力で同じタイマーを使う

チャンネルを分ければ、周波数も独立して変更できますか?

対象バージョン: 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. 周波数と分解能を揃え、チャンネルとパルス幅を分けて2出力を追加します。
  3. 両方がグループ0/タイマー0を使うことと、パルス幅の公称誤差を確認します。

参考ケースの確認結果

既知の構成矛盾なし

既知の構成矛盾はありません。タイマー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、Highパルス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を入力し、ストラッピング確認はオフのままにします。
  2. pin_strappingを読み、needs_reviewを維持します。
  3. 参照プロジェクトを保存し、宣言を変える前に実機のリセット時の電位条件を確認します。

参考ケースの確認結果

確認が必要

タイミングは計算できますが、起動条件の確認が済むまで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
  }
}

このケースでは確認できないこと

  • チェック欄は申告であり、外付け抵抗やリセット電位の測定ではありません。
  • 本例では判断を保留します。接続したサーボやボードの安全な起動を証明するものではありません。

参考データの作成日:

仕様の出典

以下のリンクには技術資料の原題を記載しています。ケースの前提条件とあわせて、対象バージョンと確認日を確認してください。

お問い合わせ