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.

Уточните, какой core выполняет сборку

При переходе с 2.x на 3.0 удалены ledcSetup и ledcAttachPin. Старый скетч может не собраться ещё до появления PWM. Ошибка компилятора не является диагнозом сервопривода или питания.

Проверьте пакет платы и версию core в журнале сборки. Сохраните старый проект с зависимостями и уточните поддержку core сторонней библиотекой. Этот фиксированный пример не обещает совместимость всех старых библиотек.

Переносите API по назначению вызова

ledcAttach выбирает канал автоматически. Для явного выбора служит ledcAttachChannel. Оба вызова сообщают результат настройки. Если канал уже настроен, новые значения частоты и разрешения игнорируются.

В ledcWrite с адресацией по выводу 0 означает GPIO0, а не канал 0. Для 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 бит и запрос импульса 1500 µs. Он округляет значение заполнения и проверяет операции. Другой core или целевой чип отклоняется.

Полный скетч классического 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 бит номинальный шаг составляет около 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: проверьте core и примените нужную строку миграции.
  2. Настройка вернула false: проверьте вывод платы, резервирование периферией и сочетание частоты с разрешением.
  3. Код собрался, но заполнение не меняется: различайте вывод и канал, проверьте запись.
  4. Частоты меняются вместе: проверьте общий таймер; разные каналы не доказывают независимость.

Вопросы о миграции

Почему ledcSetup не объявлен?

Это вызов API, удалённого при переходе 2.x→3.0. Уточните реальный core и замените настройку и подключение подходящим API 3.3.8. Ошибка сама по себе не проверяет проводку.

Можно оставить ledcWrite(0,duty)?

Только если нужен настроенный GPIO0. В 3.3.8 ledcWrite адресует вывод. Для канала 0 используйте ledcWriteChannel(0,duty), для GPIO18 из примера — ledcWrite(18,duty).

Почему разные каналы меняют частоту вместе?

Они могут использовать общий таймер. Заполнение относится к каналу, частота и разрешение — к таймеру. Закреплённая реализация повторно использует совпадающие настройки.

Запустит ли классический симулятор проект S3 или C3?

Нет. Планировщик поддерживает указанные конфигурации S3/C3 и экспорт проекта, но эмулятор исполняет только классический ESP32. Другие цели собирайте соответствующей внешней цепочкой.

Источники проекта

Связаться с нами