Repository navigation
docs: correct ESP32-S3-EYE peripheral list (add QMA7981 accelerometer, fix ESP-WHO claim) - #643
Closed
tanghao-xiaomi wants to merge 1 commit into
Closed
tanghao-xiaomi wants to merge 1 commit into
tanghao-xiaomi wants to merge 1 commit into
Conversation
The ESP32-S3-EYE entry was missing several peripherals that are already adapted on the dev-ai-contest-2026 branch, and pointed participants at an AI stack that cannot be used on openvela. Changes: - Add the adapted-peripheral table with device nodes, sourced from vendor_espressif/boards/esp32s3/esp32s3-eye/README_zh-cn.md. Notably the QMA7981 3-axis accelerometer (/dev/accel0) was not documented at all, so entries were being reviewed under the assumption that the board has no IMU. microSD, BLE, BOOT button and power LED were also undocumented. - Note the two hardware limits that affect project feasibility: no touch panel (/dev/input0 returns ENOENT by design) and no speaker/amplifier (the openvela defconfig only enables I2S0 RX, so there is no audio output path). - Drop the "ESP-WHO AI framework" claim and state explicitly that ESP-WHO / ESP-DL are ESP-IDF-private stacks unavailable on openvela. On-device inference should use apps/mlearning/tflite-micro; the openvela camera example only captures and displays frames, it does not infer. All facts verified against the vendor board README and configs/openvela/defconfig on the same branch.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The ESP32-S3-EYE entry on the contest hardware page was missing several peripherals that are already adapted on this branch, and pointed participants at an AI stack that cannot be used on openvela.
The most consequential omission: the QMA7981 3-axis accelerometer was not documented at all. Submissions were being reviewed under the assumption that the board has no IMU, which led to interaction designs being downgraded unnecessarily (e.g. tap/knock detection falling back to the single BOOT button).
Changes
Single file:
zh-cn/contest_2026/hardware_porting/supported_hardware.mdAdded the adapted-peripheral table with device nodes. Previously undocumented: QMA7981 accelerometer (
/dev/accel0), microSD (/dev/mmcsd1), BLE 5 (bnep0), BOOT button (/dev/buttons), power LED (/dev/userleds).Added two hardware limits that affect project feasibility:
/dev/input0returnsENOENTby design.# CONFIG_ESP32S3_I2S0_TX is not set, so there is no audio output path. Proposals that need voice playback must pick a board with a codec or add an external amplifier.Removed the "ESP-WHO AI framework" claim. ESP-WHO / ESP-DL are ESP-IDF-private stacks and are not available on openvela. Replaced with explicit guidance: use
apps/mlearning/tflite-microfor on-device inference, and note that the openvela camera example only captures and displays frames — it does not perform inference.Item 3 matters because the old wording implied a ready-made face-detection pipeline. At least one submission planned around "modify the existing face detection example", which does not exist on the openvela side.
Verification
All facts cross-checked against the same branch:
vendor_espressif/boards/esp32s3/esp32s3-eye/README_zh-cn.md— supported-peripheral table, device node list, and the documented limitations sectionvendor_espressif/boards/esp32s3/esp32s3-eye/configs/openvela/defconfig—CONFIG_SENSORS_QMA7981=y,CONFIG_ESP32S3_CAM=y,CONFIG_ESP32S3_BLE=y,CONFIG_GRAPHICS_LVGL=y,# CONFIG_ESP32S3_I2S0_TX is not setNo content changes to any other board entry.