Microduck Robot●microduck-robot.com

ESP32 LEDC 3.x: chuyển đổi chân, kênh và timer

Thay các lệnh thiết lập đã bỏ và kiểm tra đối số là chân hay kênh trước khi đổi phần cứng. Bài dùng Arduino-ESP32 3.3.8. Khác kênh không có nghĩa là có thể đổi tần số độc lập.

Ví dụ: Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4, Arduino CLI 1.6.0. Kiểm tra nguồn ngày 2026-11-15.

Xác định core thực sự dùng để biên dịch

Khi chuyển từ 2.x sang 3.0, ledcSetup và ledcAttachPin đã bị loại bỏ. Sketch từ bài cũ có thể lỗi biên dịch trước khi tạo PWM. Lỗi này không chẩn đoán được servo hay nguồn điện.

Đọc gói bo mạch và phiên bản core trong nhật ký biên dịch. Giữ lại dự án cùng các phụ thuộc và kiểm tra core mà thư viện ngoài hỗ trợ. Ví dụ cố định này không bảo đảm mọi thư viện cũ đều chạy được.

Đổi API theo mục đích gọi

ledcAttach tự chọn kênh. Dùng ledcAttachChannel nếu cần chỉ định kênh. Cả hai đều trả về kết quả thiết lập. Nếu kênh đã cấu hình, tần số và độ phân giải mới truyền vào sẽ bị bỏ qua.

Với ledcWrite theo chân, 0 là GPIO0, chứ không phải kênh 0. Đầu ra GPIO18 phải truyền 18; muốn chỉ định kênh thì dùng ledcWriteChannel. Một số nguyên sai vai trò vẫn có thể biên dịch, hãy kiểm tra cả giá trị trả về.

Cuộn ngang để so sánh tất cả các cột.

Mục đíchArduino-ESP32 2.xArduino-ESP32 3.3.8
Gắn, tự chọn kênhledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttach(pin, Hz, bits)
Gắn, chỉ định kênhledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttachChannel(pin, Hz, bits, channel)
Ghi dutyledcWrite(channel, duty)ledcWrite(pin, duty) / ledcWriteChannel(channel, duty)

Biên dịch ví dụ cố định cho ESP32 cổ điển

Sketch đầy đủ dành cho hồ sơ ESP32 cổ điển đã nêu: GPIO18, kênh 0, APB 80 MHz, 50 Hz, 14 bit và yêu cầu xung 1500 µs. Mã làm tròn giá trị duty, kiểm tra từng thao tác và từ chối core hoặc chip đích khác.

Sketch ESP32 cổ điển đầy đủ · 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() {}

Lưu thành ledc_migration/ledc_migration.ino rồi biên dịch bằng bộ công cụ cố định. Xung này không phải điểm giữa hay giới hạn hành trình đã hiệu chuẩn cho mọi servo. Dự án S3/C3 cần hồ sơ riêng và biên dịch bên ngoài.

Biên dịch ngoài · 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

Kiểm tra tần số cùng độ phân giải

Khi clock cố định, tần số và số bit cùng xác định hệ số chia. Ở tần số thấp, giảm số bit làm hệ số chia cần thiết tăng lên và có thể vượt phạm vi. Vì vậy giảm bit không phải lúc nào cũng sửa được lỗi. Bảng dùng clock cố định của các hồ sơ trên trang.

Ở 50 Hz và 14 bit, một bước duty danh định khoảng 1.2207 µs. Yêu cầu 1500 µs được làm tròn thành 1229 bước, khoảng 1500.2441 µs. Đây là tính toán theo mô hình chia đã cố định, không phải phép đo oscilloscope hay bảo đảm góc servo thực.

Cuộn ngang để so sánh tất cả các cột.

Clock cố định của hồ sơ50 Hz · 8 bit50 Hz · 14 bit
ESP32 · APB 80 MHzD = 6250 · ngoài phạm viD = 97.65625 · khả thi
ESP32-S3 / C3 · XTAL 40 MHzD = 3125 · ngoài phạm viD = 48.828125 · khả thi

Phân biệt chân, kênh và timer dùng chung

Kênh giữ duty; còn timer quyết định tần số và độ phân giải. Bản triển khai đã chốt có thể tái sử dụng timer có cùng thiết lập. Hai kênh có thể dùng duty khác nhau nhưng chung cơ sở thời gian.

Đổi tần số có thể ảnh hưởng các đầu ra khác dùng cùng timer. Khác số kênh không chứng minh tính độc lập. Xem nhóm/timer trong bộ cấu hình và giữ tần số cố định ở ví dụ này; không hứa có cách đổi động độc lập.

Từ triệu chứng chọn bước kiểm tra

Bắt đầu ở giai đoạn lỗi đầu tiên. Lưu clock, tần số, độ phân giải, chân và kênh trong báo cáo để người khác tái tạo cấu hình.

  1. Thiếu ledcSetup/ledcAttachPin: kiểm tra core rồi áp dụng hàng chuyển đổi phù hợp.
  2. Thiết lập trả false: kiểm tra chân thật, chân dành cho ngoại vi và cặp tần số/độ phân giải.
  3. Biên dịch được nhưng duty không đổi: phân biệt chân với kênh và xem kết quả ghi.
  4. Hai tần số đổi cùng nhau: kiểm tra timer chung; khác kênh không chứng minh độc lập.

Câu hỏi khi chuyển đổi

Vì sao ledcSetup chưa được khai báo?

Đây là API bị bỏ khi chuyển 2.x sang 3.0. Kiểm tra core thực tế rồi thay lệnh thiết lập/gắn chân bằng API 3.3.8 phù hợp. Lỗi này không xác nhận tình trạng dây nối.

Có thể giữ ledcWrite(0,duty) không?

Chỉ khi muốn điều khiển GPIO0 đã cấu hình. Trong 3.3.8, ledcWrite nhận chân. Với kênh 0 dùng ledcWriteChannel(0,duty); với GPIO18 của ví dụ dùng ledcWrite(18,duty).

Vì sao các kênh khác nhau cùng đổi tần số?

Chúng có thể dùng chung timer. Duty thuộc về kênh, còn tần số và độ phân giải thuộc timer. Bản triển khai đã chốt có thể tái sử dụng thiết lập trùng nhau.

Dự án S3 hay C3 có chạy trong trình mô phỏng cổ điển không?

Không. Bộ cấu hình hỗ trợ các hồ sơ S3/C3 đã nêu và xuất dự án, nhưng trình giả lập chỉ chạy ESP32 cổ điển. Hãy biên dịch đích khác bằng bộ công cụ ngoài tương ứng.

Nguồn dự án

Liên hệ