History

Fábio Coutada 98ed638f3c WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules All uncommitted work from ESP32 GDB stub development session. Includes: - GDB stub (uos_gdbstub.c/.h/_entry.S) - Startup vector table rewrite - ESP32 HAL integration files - Boot chain design docs - AGENTS.md absolute rules (commit before refactor, no unauthorized changes) - All prior deepseek session work This commit prevents further data loss. No claims of correctness.		2026-07-17 01:36:58 +01:00
..
esp32	WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules	2026-07-17 01:36:58 +01:00
esp32s3	WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules	2026-07-17 01:36:58 +01:00
include/hal	WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules	2026-07-17 01:36:58 +01:00
CMakeLists.txt	WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules	2026-07-17 01:36:58 +01:00
ledc_hal.c	WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules	2026-07-17 01:36:58 +01:00
ledc_hal_iram.c	WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules	2026-07-17 01:36:58 +01:00
README.md	WIP: emergency commit — ESP32 GDB stub, boot chain work, docs, AGENTS.md rules	2026-07-17 01:36:58 +01:00

README.md

ESP Hardware Abstraction Layer for LEDC Peripheral

Note

This component is currently in beta. Its API, behavior, and compatibility may change at any time and without notice; backward compatibility is not guaranteed. Use caution when integrating into production systems.

Overview

The esp_hal_ledc component provides a Hardware Abstraction Layer for the LEDC (LED PWM Controller) peripheral across all ESP-IDF supported targets.

Architecture

The LEDC HAL is structured in two main sub-layers:

HAL Layer (Upper): Defines the operational steps and data structures required to control LEDC (e.g., timer/channel configuration, duty updates, fade and low-power helpers).
Low-Level Layer (Bottom): Serves as a translation layer between the HAL and the register files defined in the soc component, handling target-specific register configurations.

Features

Multi-timer and multi-channel PWM generation
High-speed and low-speed modes (on supported chips)
Duty cycle setting and smooth fading
Timer resolution and frequency configuration
Interrupt-driven operations
Low-power helpers (on supported chips)

Usage

The HAL functions primarily serve ESP-IDF peripheral drivers such as esp_driver_ledc.

Advanced developers can use these interfaces directly when implementing custom drivers, with the understanding that API stability is not guaranteed.

Dependencies

soc: Provides chip-specific register definitions
hal: Core hardware abstraction utilities and macros