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
信号と単位を指定
GPIO、チャンネル、周波数(Hz)、分解能(bit)を入力し、パルス幅(マイクロ秒)かデューティ比(%)を選びます。周辺機能のピンは表示された信号順に並べます。USBなどの固定ピンは自由に変更できません。
構成を確認する手順
- ボードを選び、使用予定の周辺機能を有効にして実際の配線ピンを確認します。
- PWM出力とタイミングを追加し、ピン競合とタイマー共有を確認します。
- 公称周波数、パルス量子化誤差、検査結果を読んでからコードを保存します。
保存とコンパイル
プロジェクト、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。
- 指定のClassicボードを選び、周辺機能の予約ピンはそのままにします。
- 周波数と分解能を揃え、チャンネルとパルス幅を分けて2出力を追加します。
- 両方がグループ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
}
}
このケースでは確認できないこと
- 別チャンネルでもタイマーを共有します。実行中の周波数変更はこの固定周波数例の対象外です。
- このパルス幅はサーボの安全な可動域を保証しません。任意のプロジェクトは外部でコンパイルし、サイトから書き込みは行いません。
参考データの作成日:
仕様の出典
以下のリンクには技術資料の原題を記載しています。ケースの前提条件とあわせて、対象バージョンと確認日を確認してください。
- 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、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のファームウェアは本シミュレーターの外でコンパイルして確認してください。
参考データの作成日:
仕様の出典
以下のリンクには技術資料の原題を記載しています。ケースの前提条件とあわせて、対象バージョンと確認日を確認してください。
- 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を入力し、ストラッピング確認はオフのままにします。
- pin_strappingを読み、needs_reviewを維持します。
- 参照プロジェクトを保存し、宣言を変える前に実機のリセット時の電位条件を確認します。
参考ケースの確認結果
確認が必要
タイミングは計算できますが、起動条件の確認が済むまで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 · 確認日