Imported from furyhawk/rlcd42 (AGENTS.md). Install upstream with npx skills add furyhawk/rlcd42. Copyright stays with the author.

AGENTS

Name: rlcd42
Author: furyhawk

This repository is an ESP-IDF application for ESP32-S3 with LVGL UI, board support layers, and user-level app tasks.

Start Here

If using CLI instead of the ESP-IDF extension, standard commands are:

main: app bootstrap and LVGL display flush callback wiring.
components/port_bsp: low-level board drivers (display, I2C, SD, buttons, codec glue).
components/app_bsp: platform services (LVGL port, Wi-Fi, BLE scan).
components/ui_bsp: UI source and generated assets.
components/user_app: app behavior, FreeRTOS tasks, integration logic.
components/ExternLib: local reusable libraries.

When changing behavior, prefer editing the highest-level component that owns it instead of patching lower layers.

Keep UI calls thread-safe: LVGL object updates should run under the LVGL lock model from components/app_bsp/lvgl_bsp.cpp.
Keep hardware pin and display assumptions consistent with main/main.cpp and components/port_bsp/display_bsp.cpp.
Do not edit generated build output under build.
Preserve component registration style in each component CMake file.

Memory-sensitive paths: audio/frame buffers use SPIRAM; check heap capability usage in components/user_app/user_app.cpp.
Display timing/performance: flush callback and pixel loops in main/main.cpp can affect frame rate.
Partition/flash layout changes: validate partitions.csv and related sdkconfig settings together.