M5Stack Tab5 camera photos are very dark, and README camera dependencies do not match current esp_video code

[Serj-Pr]

Answers checklist.

• I have read the documentation XiaoZhi AI Programming Guide and the issue is not addressed there.
• I have updated my branch (master or release) to the latest version and checked that the issue is present there.
• I have searched the issue tracker for a similar issue and not found a similar issue.

XiaoZhi AI version.

main

Operating System used.

macOS

How did you build your project?

VS Code IDE/Cursor

If you are using Windows, please specify command line type.

None

What is the expected behavior?

On M5Stack Tab5, the camera works, but captured photos are very dark.

What is the actual behavior?

Hello,

I found a camera-related issue on m5stack-tab5.

Main symptom

On M5Stack Tab5, the camera works, but captured photos are very dark.

In runtime logs, the SC202CS sensor is detected correctly, but ISP initialization fails:

I (...) sc202cs: Detected Camera sensor PID=0xeb52
W (...) esp_video_init: failed to get configuration to initialize ISP controller

This appears consistently in the logs.

Documentation mismatch

The current Tab5 README says that for this board idf_component.yml should be changed to use:

espressif/esp_video: '==0.7.0'
espressif/esp_ipa: '==0.1.0'

That instruction is explicitly written in the Tab5 README.

Current problem

After switching dependencies exactly as described in the README, the project no longer builds because main/boards/common/esp_video.cc does not match the esp_video 0.7.0 API.

Build fails with:

main/boards/common/esp_video.cc:303:22: error: 'MAP_FAILED' was not declared in this scope
main/boards/common/esp_video.cc:380:5: error: 'esp_video_deinit' was not declared in this scope; did you mean 'esp_video_init'?

And the build log confirms that ESP_VIDEO: 0.7.0 and ESP_IPA: 0.1.0 were actually selected.

Expected behavior

For m5stack-tab5, one of these should be true:

The README should point to dependency versions that are compatible with the current source code, or
main/boards/common/esp_video.cc should be updated to build correctly with the README-recommended esp_video == 0.7.0 and esp_ipa == 0.1.0, or
A working Tab5 camera/ISP configuration should be provided so that SC202CS photos are not extremely dark.
Actual behavior

Right now there seems to be a mismatch:

with newer camera dependencies, the project builds, but ISP init fails at runtime and photos are very dark;
with the README-recommended camera dependencies, the project no longer builds.

Steps to reproduce.

1. Step
2. Step
3. Step
   ...

Build or installation Logs.

More Information.

No response