[BUG]Framebuffer example fails on hardware without overlay support (ESP32 + ILI9341 tested)

[siddhitripathi25]

Description / Steps to reproduce the issue

Summary

The framebuffer example (apps/examples/fb) fails on displays without overlay support. Tested on ESP32 + ILI9341.

Steps to Reproduce

1. Configure NuttX for ESP32 DevKit V1 with ILI9341 display
2. Enable CONFIG_VIDEO_FB=y and CONFIG_EXAMPLES_FB=y in menuconfig
3. Build and flash to ESP32
4. Run fb command from NSH

Actual Result

The example fails because it expects overlay support (CONFIG_FB_OVERLAY) which my display doesn't have.

Expected Result

The example should run successfully and show test patterns on the display.

Root Cause

In apps/examples/fb/fb_main.c, overlay-specific code is guarded by #ifdef CONFIG_FB_OVERLAY. On displays without overlays, this code path causes issues.

This is a known problem. The PinePhone framebuffer documentation confirms the same issue and shows a workaround: changing #ifdef CONFIG_FB_OVERLAY to #ifdef NOTUSED.

Reference: https://lupyuen.github.io/articles/fb#framebuffer-interface

On which OS does this issue occur?

[OS: Mac]

What is the version of your OS?

macOS Sequoia 15.x

NuttX Version

master

Issue Architecture

[Arch: xtensa]

Issue Area

[Area: Applications]

Host information

No response

Verification

• I have verified before submitting the report.

[terry0012]

Please check your nuttx/.config to verify if CONFIG_FB_OVERLAY is enabled. @siddhitripathi25
If your LCD driver does not support overlay functionality, you must disable CONFIG_FB_OVERLAY. This will exclude the code in fb_main.c from being compiled into the firmware. CC @jianglianfang