Microduck Robot●microduck-robot.com
Công cụ

Lập cấu hình chân và PWM ESP32

Chọn đúng bo mạch, dành chân cho ngoại vi rồi cấu hình đầu ra PWM.

Đang tải công cụ…

Chuẩn bị chân và PWM cho ESP32

Kiểm tra cấu hình trước khi tạo firmware. Đúng phiên bản mô-đun quyết định chân đưa ra, chân dành cho bộ nhớ và tài nguyên LEDC.

Bo mạch và xung nhịp cố định

  • 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

Phiên bản quy tắc: 2026-11-12.2

Khai báo tín hiệu và đơn vị

Nhập GPIO, kênh, tần số Hz và độ phân giải bit. Chọn độ rộng xung microgiây hoặc chu kỳ làm việc phần trăm. Danh sách chân ngoại vi theo thứ tự tín hiệu hiển thị; chân USB cố định không thể chuyển tùy ý.

Kiểm tra cấu hình

  1. Chọn bo mạch, bật ngoại vi dự kiến và kiểm tra chân đấu thực tế.
  2. Thêm đầu ra PWM, nhập thời gian mong muốn, xử lý xung đột chân và xem bộ định thời dùng chung.
  3. Đọc tần số danh nghĩa, sai số lượng tử hóa xung và kết quả trước khi tải mã.

Tải và biên dịch

Lưu dự án, báo cáo JSON hoặc kênh CSV. Khi đáp ứng các kiểm tra cần thiết, tải sketch hoặc ZIP gồm mã, cấu hình bo và phiên bản cố định. Cấu hình tùy chọn phải biên dịch bên ngoài; ví dụ ESP32 cổ điển là mô phỏng riêng.

Giới hạn kiểm tra

Tính toán theo trình điều khiển cố định, không cam kết độc lập sau khi đổi tần số động. S3/C3 chỉ hỗ trợ cấu hình và xuất dự án. Không xác minh dây, hành trình servo hay nguồn thật; trang không nạp firmware vào phần cứng.

Ví dụ PWM từng bước

Theo dõi đầu vào và báo cáo của bộ kiểm tra cục bộ với phiên bản cố định. Các thông số thời gian là kết quả tính toán, không phải phép đo trên bo mạch.

Kiểm tra cục bộ không xác minh phần cứng thực hay độ an toàn. Các ví dụ tổng hợp này tách biệt với thông số bạn nhập ở trên. Khi nhập một ví dụ, công cụ sẽ kiểm tra lại đầu vào thay vì tin vào kết luận đã lưu.

Hai đầu ra dùng chung bộ định thời

Hai số kênh khác nhau có bảo đảm đổi tần số độc lập không?

Phiên bản áp dụng: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

Dữ liệu đầu vào và các bước

ESP32-DevKitC V4 / WROOM-32E-N4; APB 80 MHz; GPIO18/kênh 0 và GPIO19/kênh 1; 50 Hz, 14 bit; 1500 µs và 1000 µs.

  1. Chọn đúng bo Classic và giữ các chân đã dành cho ngoại vi.
  2. Thêm hai đầu ra có cùng tần số và độ phân giải, nhưng khác kênh và độ rộng xung.
  3. Kiểm tra cả hai dùng nhóm 0 / bộ định thời 0 và xem sai số xung danh định.

Kết quả kiểm tra tham chiếu

Chưa thấy xung đột cấu hình

Không có xung đột cấu hình đã biết. Hai đầu ra dùng chung bộ định thời 0; sai số khoảng +0.244141 µs và −0.244141 µs.

Xem đầu vào và JSON tham chiếu
{
  "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
  }
}

Những điều ví dụ này chưa xác minh

  • Các kênh riêng vẫn có thể dùng chung bộ định thời. Ví dụ tần số cố định này không bảo đảm việc đổi tần số khi chạy.
  • Độ rộng xung này không chứng minh hành trình servo an toàn. Hãy biên dịch dự án bên ngoài; trang không nạp vào phần cứng.

Ngày tạo bản tham chiếu:

Nguồn thông số

Các liên kết dưới đây giữ tên gốc của tài liệu kỹ thuật. Hãy đọc phiên bản và ngày đối chiếu cùng với các giả định của ví dụ.

Chân được đưa ra nhưng dành cho bộ nhớ

Vì sao GPIO35 bị từ chối trên bo S3 này?

Phiên bản áp dụng: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

Dữ liệu đầu vào và các bước

ESP32-S3-DevKitC-1 v1.1 / WROOM-1-N16R8; GPIO35/kênh 0; 50 Hz, 14 bit, 1500 µs.

  1. Chọn đúng cấu hình N16R8 rồi nhập GPIO35.
  2. Đọc pin_reserved: mô-đun này dùng GPIO35–37 để kết nối bộ nhớ.
  3. Chỉ đổi chân đầu ra sang GPIO18 và kiểm tra lại báo cáo.

Kết quả kiểm tra tham chiếu

Không thể dùng cấu hình

Đầu vào ban đầu bị chặn vì chân đã được dành riêng.

Xem đầu vào và JSON tham chiếu
{
  "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
  }
}

Điều chỉnh rồi kiểm tra lại

GPIO18 loại bỏ xung đột đã khai báo; cấu hình điều chỉnh không còn xung đột đã biết.

Chưa thấy xung đột cấu hình

Xem JSON tham chiếu sau điều chỉnh
{
  "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
  }
}

Những điều ví dụ này chưa xác minh

  • Giới hạn thuộc mô-đun và loại bộ nhớ này, không áp dụng cho mọi bo S3.
  • Có thể xuất dự án S3 để biên dịch bên ngoài. Trang không mô phỏng firmware S3 hay xác minh dây thật.

Ngày tạo bản tham chiếu:

Nguồn thông số

Các liên kết dưới đây giữ tên gốc của tài liệu kỹ thuật. Hãy đọc phiên bản và ngày đối chiếu cùng với các giả định của ví dụ.

Tần số thấp cần bộ chia phù hợp

Vì sao 50 Hz với 8 bit không hợp lệ trong cấu hình C3?

Phiên bản áp dụng: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

Dữ liệu đầu vào và các bước

ESP32-C3-DevKitM-1 / MINI-1-N4X; XTAL 40 MHz; GPIO4/kênh 0; 50 Hz, 8 bit, 1500 µs.

  1. Nhập cấu hình 8 bit mà không đổi xung nhịp cố định.
  2. Đọc divider_out_of_range trước khi xuất mã có thể dùng.
  3. Đổi độ phân giải sang 14 bit và so sánh thời gian tính được.

Kết quả kiểm tra tham chiếu

Không thể dùng cấu hình

Tổ hợp 8 bit vượt phạm vi bộ chia cho phép.

Xem đầu vào và JSON tham chiếu
{
  "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
  }
}

Điều chỉnh rồi kiểm tra lại

Với 14 bit, kết quả danh định là 50 Hz và xung cao 1500.244140625 µs.

Chưa thấy xung đột cấu hình

Xem JSON tham chiếu sau điều chỉnh
{
  "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
  }
}

Những điều ví dụ này chưa xác minh

  • Giới hạn thấp phụ thuộc xung nhịp và độ phân giải; đây không phải tần số tối thiểu chung cho C3.
  • Đây không phải phép đo dạng sóng. Firmware C3 cần được biên dịch và kiểm tra ngoài trình mô phỏng này.

Ngày tạo bản tham chiếu:

Nguồn thông số

Các liên kết dưới đây giữ tên gốc của tài liệu kỹ thuật. Hãy đọc phiên bản và ngày đối chiếu cùng với các giả định của ví dụ.

Số hợp lệ vẫn có thể cần kiểm tra thêm

Vì sao GPIO0 không tự động được thông qua?

Phiên bản áp dụng: Microduck rules 2026-11-12.2 · Arduino-ESP32 3.3.8 · ESP-IDF 5.5.4

Dữ liệu đầu vào và các bước

Cấu hình ESP32 Classic; GPIO0/kênh 0; 50 Hz, 14 bit, 1500 µs; allowStrapping=false.

  1. Nhập GPIO0 và để phần xác nhận strapping ở trạng thái tắt.
  2. Đọc pin_strapping và giữ kết quả needs_review.
  3. Lưu dự án tham khảo; kiểm tra mức điện áp thật khi reset trước khi đổi khai báo.

Kết quả kiểm tra tham chiếu

Cần kiểm tra thêm

Có thể tính thời gian, nhưng codeReady vẫn false khi chưa xác nhận điều kiện khởi động.

Xem đầu vào và JSON tham chiếu
{
  "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
  }
}

Những điều ví dụ này chưa xác minh

  • Đánh dấu ô chỉ là khai báo, không đo điện trở kéo hay mức điện áp khi reset.
  • Ví dụ để ngỏ kết luận; không chứng minh bo hoặc servo đã nối sẽ khởi động an toàn.

Ngày tạo bản tham chiếu:

Nguồn thông số

Các liên kết dưới đây giữ tên gốc của tài liệu kỹ thuật. Hãy đọc phiên bản và ngày đối chiếu cùng với các giả định của ví dụ.

Liên hệ