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_lcd component provides a Hardware Abstraction Layer for LCD (Liquid Crystal Display) controllers and MIPI DSI (Display Serial Interface) peripherals across ESP-IDF supported targets. This HAL enables efficient communication with various display interfaces including I80 parallel, RGB parallel, and MIPI DSI serial interfaces.

Architecture

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

HAL Layer (Upper): Defines the operational steps and data structures required to control LCD peripherals (e.g., initialization, clock configuration, data transmission).
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.

Supported LCD Interfaces

This HAL supports various LCD interface types depending on the ESP chip:

I80 (Intel 8080) Parallel Interface: 8-bit/16-bit parallel interface commonly used for MCU-based displays
RGB Parallel Interface: Direct RGB pixel data interface for high-performance displays
MIPI DSI Interface: High-speed serial interface supporting:
- DSI Host Controller
- DSI Bridge Controller
- PHY layer configuration
- DCS (Display Command Set) commands
- Generic read/write operations

Features

LCD Common Features

Pixel clock (PCLK) calculation and configuration
Multiple color format support using FourCC standard:
- RGB565, RGB888
- YUV422 (YUYV, YVYU, VYUY, UYVY)
- GRAY8 (8-bit grayscale)
RGB data endian configuration (MSB/LSB first)
Color space conversion (RGB ↔ YUV)
YUV conversion standards (BT.601, BT.709)
Color range control (Limited/Full)

MIPI DSI Specific Features

PHY PLL configuration for high-speed lanes
Virtual channel management
DCS command transmission (short/long writes)
Generic interface for command/data operations
Test pattern generation (vertical/horizontal bars, BER patterns)
Multi-lane data transmission support
DPI (Display Pixel Interface) clock configuration

Usage

The HAL functions primarily serve ESP-IDF LCD peripheral drivers such as esp_lcd component.

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

Dependencies

soc: Provides chip-specific register definitions and peripheral capabilities
hal: Core hardware abstraction utilities, macros, and color type definitions