실제 컴파일에 쓰이는 코어 확인
2.x에서3.0으로 바뀌며 ledcSetup과 ledcAttachPin이 제거됐습니다. 오래된 예제는 PWM을 출력하기 전에 컴파일부터 실패할 수 있습니다. 이 오류만으로 서보나 전원을 진단할 수는 없습니다.
빌드 출력에서 보드 패키지와 코어 버전을 확인하세요. 기존 프로젝트와 의존성을 보관하고 외부 라이브러리의 지원 코어도 확인합니다. 이 고정 예제는 모든 이전 라이브러리의 호환성을 보장하지 않습니다.
호출 목적에 맞게 API 변경
ledcAttach는 채널을 자동 선택합니다. 채널을 지정하려면 ledcAttachChannel을 사용하세요. 두 호출 모두 설정 성공 여부를 반환합니다. 이미 설정된 채널을 쓰면 새 주파수와 분해능은 무시됩니다.
핀 기반 ledcWrite에서0은 채널0이 아니라 GPIO0입니다. GPIO18 출력에는18을 넘기세요. 채널을 직접 지정하려면 ledcWriteChannel을 씁니다. 정수의 의미가 틀려도 컴파일될 수 있으므로 반환값도 확인하세요.
옆으로 스크롤하여 모든 열을 비교하세요.
| 목적 | Arduino-ESP32 2.x | Arduino-ESP32 3.3.8 |
|---|---|---|
| 연결·채널 자동 | ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel) | ledcAttach(pin, Hz, bits) |
| 연결·채널 지정 | ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel) | ledcAttachChannel(pin, Hz, bits, channel) |
| 듀티 쓰기 | ledcWrite(channel, duty) | ledcWrite(pin, duty) / ledcWriteChannel(channel, duty) |
클래식 ESP32 고정 예제 컴파일
완전한 스케치는 지정한 클래식 ESP32 프로필용입니다. GPIO18,채널0,APB 80 MHz,50 Hz,14 bit,요청 펄스1500 µs를 사용합니다. 듀티 값을 반올림하고 각 설정·쓰기 결과를 확인하며 다른 코어나 칩 대상은 거부합니다.
#include <Arduino.h>
#include <esp_arduino_version.h>
#if ESP_ARDUINO_VERSION != ESP_ARDUINO_VERSION_VAL(3, 3, 8)
#error "Use Arduino-ESP32 3.3.8 for this example"
#endif
#if !CONFIG_IDF_TARGET_ESP32
#error "This example targets the classic ESP32 profile"
#endif
constexpr uint8_t SERVO_PIN = 18;
constexpr uint8_t SERVO_CHANNEL = 0;
constexpr uint32_t FREQ_HZ = 50;
constexpr uint8_t RES_BITS = 14;
constexpr uint32_t PULSE_US = 1500;
constexpr uint32_t DUTY =
(uint64_t(PULSE_US) * FREQ_HZ * (1UL << RES_BITS) + 500000ULL)
/ 1000000ULL;
void setup() {
Serial.begin(115200);
bool ok = ledcSetClockSource(LEDC_USE_APB_CLK);
if (ok) {
ok = ledcAttachChannel(SERVO_PIN, FREQ_HZ, RES_BITS, SERVO_CHANNEL);
}
if (ok) {
ok = ledcWrite(SERVO_PIN, DUTY); // pin, not channel
}
Serial.println(ok ? "LEDC configured" : "LEDC setup failed");
}
void loop() {}
ledc_migration/ledc_migration.ino로 저장한 뒤 고정된 도구 버전으로 컴파일하세요. 이 펄스는 모든 서보의 보정된 중립점이나 이동 한계가 아닙니다. S3/C3 프로젝트에는 각 프로필과 외부 컴파일이 필요합니다.
arduino-cli version
arduino-cli core list
arduino-cli compile --fqbn "esp32:esp32:esp32:FlashMode=dio,FlashSize=4M,PartitionScheme=default" --export-binaries ./ledc_migration
주파수와 분해능을 함께 확인
클록이 고정되면 주파수와 비트 수가 함께 분주값을 결정합니다. 낮은 주파수에서 비트를 줄이면 필요한 분주값이 커져 범위를 넘을 수 있습니다. 따라서 비트를 낮추는 것이 항상 해결책은 아닙니다. 표는 이 사이트의 고정 프로필 클록을 사용합니다.
50 Hz·14 bit에서 공칭 듀티 한 단계는 약1.2207 µs입니다.1500 µs 요청은1229단계,약1500.2441 µs로 반올림됩니다. 고정 분주 모델의 계산값이며 오실로스코프 측정이나 실제 서보 각도 보장이 아닙니다.
옆으로 스크롤하여 모든 열을 비교하세요.
| 고정 프로필 클록 | 50 Hz · 8 bit | 50 Hz · 14 bit |
|---|---|---|
| ESP32 · APB 80 MHz | D = 6250 · 범위 밖 | D = 97.65625 · 설정 가능 |
| ESP32-S3 / C3 · XTAL 40 MHz | D = 3125 · 범위 밖 | D = 48.828125 · 설정 가능 |
증상에서 다음 점검 단계 찾기
처음 실패한 단계부터 확인하세요. 클록,주파수,분해능,핀,채널을 보고서에 남기면 같은 구성을 재현할 수 있습니다.
- ledcSetup/ledcAttachPin 없음: 설치 코어를 확인하고 해당 이전 항목을 적용합니다.
- 설정이 false: 실제 핀,주변 장치 예약,주파수·분해능 조합을 확인합니다.
- 컴파일되지만 듀티가 안 바뀜: 핀과 채널을 구분하고 쓰기 결과를 확인합니다.
- 두 주파수가 함께 바뀜: 공유 타이머를 확인합니다. 채널 분리는 독립성의 증거가 아닙니다.
이전 과정의 질문
ledcSetup이 선언되지 않는 이유는 무엇인가요?
2.x에서3.0으로 바뀌며 제거된 API이기 때문입니다. 실제 코어를 확인하고 설정·연결 호출을 맞는3.3.8 API로 바꾸세요. 이 오류만으로 배선은 확인할 수 없습니다.
ledcWrite(0,duty)를 그대로 써도 되나요?
설정된 GPIO0을 조작하려는 경우에만 가능합니다.3.3.8의 ledcWrite는 핀을 지정합니다. 채널0은 ledcWriteChannel(0,duty),예제의 GPIO18은 ledcWrite(18,duty)를 쓰세요.
다른 채널의 주파수가 같이 바뀌는 이유는 무엇인가요?
같은 타이머를 공유할 수 있기 때문입니다. 듀티는 채널에,주파수·분해능은 타이머에 속합니다. 고정 버전 구현은 같은 설정을 재사용할 수 있습니다.
S3나 C3 프로젝트를 클래식 시뮬레이터에서 실행할 수 있나요?
아니요. 플래너는 지정 S3/C3 구성과 프로젝트 내보내기를 지원하지만 에뮬레이터는 클래식 ESP32만 실행합니다. 해당 외부 도구로 컴파일하세요.