Microduck Robot●microduck-robot.com

ESP32 LEDC 3.x 마이그레이션: 핀·채널·타이머

삭제된 설정 호출을 바꾸고 각 인수가 핀인지 채널인지 확인한 뒤 하드웨어를 변경하세요. 이 문서는 Arduino-ESP32 3.3.8을 기준으로 합니다. 채널이 달라도 주파수 변경이 독립적이라는 뜻은 아닙니다.

예제 기준: Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4, Arduino CLI 1.6.0. 자료 확인:2026-11-15.

실제 컴파일에 쓰이는 코어 확인

2.x에서3.0으로 바뀌며 ledcSetup과 ledcAttachPin이 제거됐습니다. 오래된 예제는 PWM을 출력하기 전에 컴파일부터 실패할 수 있습니다. 이 오류만으로 서보나 전원을 진단할 수는 없습니다.

빌드 출력에서 보드 패키지와 코어 버전을 확인하세요. 기존 프로젝트와 의존성을 보관하고 외부 라이브러리의 지원 코어도 확인합니다. 이 고정 예제는 모든 이전 라이브러리의 호환성을 보장하지 않습니다.

호출 목적에 맞게 API 변경

ledcAttach는 채널을 자동 선택합니다. 채널을 지정하려면 ledcAttachChannel을 사용하세요. 두 호출 모두 설정 성공 여부를 반환합니다. 이미 설정된 채널을 쓰면 새 주파수와 분해능은 무시됩니다.

핀 기반 ledcWrite에서0은 채널0이 아니라 GPIO0입니다. GPIO18 출력에는18을 넘기세요. 채널을 직접 지정하려면 ledcWriteChannel을 씁니다. 정수의 의미가 틀려도 컴파일될 수 있으므로 반환값도 확인하세요.

옆으로 스크롤하여 모든 열을 비교하세요.

목적Arduino-ESP32 2.xArduino-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를 사용합니다. 듀티 값을 반올림하고 각 설정·쓰기 결과를 확인하며 다른 코어나 칩 대상은 거부합니다.

클래식 ESP32 전체 스케치 · Arduino-ESP32 3.3.8
#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 1.6.0
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 bit50 Hz · 14 bit
ESP32 · APB 80 MHzD = 6250 · 범위 밖D = 97.65625 · 설정 가능
ESP32-S3 / C3 · XTAL 40 MHzD = 3125 · 범위 밖D = 48.828125 · 설정 가능

핀·채널·공유 타이머 구분

듀티는 채널에 속하고 주파수와 분해능은 타이머가 정합니다. 고정 버전 구현은 설정이 같은 타이머를 재사용할 수 있습니다. 서로 다른 채널이 다른 듀티를 쓰면서 시간 기준은 공유할 수 있습니다.

주파수를 바꾸면 같은 타이머를 쓰는 다른 출력에도 영향을 줄 수 있습니다. 채널 번호를 나눴다고 독립성이 입증되지는 않습니다. 플래너의 그룹·타이머를 확인하고 이 예제는 고정 주파수로 유지하세요. 동적 재설정 우회법은 보장하지 않습니다.

증상에서 다음 점검 단계 찾기

처음 실패한 단계부터 확인하세요. 클록,주파수,분해능,핀,채널을 보고서에 남기면 같은 구성을 재현할 수 있습니다.

  1. ledcSetup/ledcAttachPin 없음: 설치 코어를 확인하고 해당 이전 항목을 적용합니다.
  2. 설정이 false: 실제 핀,주변 장치 예약,주파수·분해능 조합을 확인합니다.
  3. 컴파일되지만 듀티가 안 바뀜: 핀과 채널을 구분하고 쓰기 결과를 확인합니다.
  4. 두 주파수가 함께 바뀜: 공유 타이머를 확인합니다. 채널 분리는 독립성의 증거가 아닙니다.

이전 과정의 질문

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만 실행합니다. 해당 외부 도구로 컴파일하세요.

프로젝트 출처

문의하기