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비트, 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비트·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비트가 실패하는 이유는 무엇인가요?
기준 버전: 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비트·1500 µs.
- 고정 클록을 바꾸지 않고 8비트 입력을 설정합니다.
- 사용 가능한 코드를 내보내기 전에 divider_out_of_range를 확인합니다.
- 해상도를 14비트로 바꾸고 시간 계산 결과를 비교합니다.
예제의 기준 검사 결과
사용할 수 없는 구성
8비트 조합은 분주기 허용 범위를 벗어납니다.
입력과 기준 결과 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비트에서는 공칭 50 Hz와 1500.244140625 µs의 High 펄스가 나옵니다.
알려진 구성 충돌 없음
변경한 기준 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비트·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 · 확인일