Skip to content

docs: align firmware ESP-IDF version references to v5.4 (fixes #1177 build error)#1292

Open
mvanhorn wants to merge 1 commit into
ruvnet:mainfrom
mvanhorn:fix/1177-docs-align-firmware-esp-idf-version
Open

docs: align firmware ESP-IDF version references to v5.4 (fixes #1177 build error)#1292
mvanhorn wants to merge 1 commit into
ruvnet:mainfrom
mvanhorn:fix/1177-docs-align-firmware-esp-idf-version

Conversation

@mvanhorn

@mvanhorn mvanhorn commented Jul 9, 2026

Copy link
Copy Markdown

Summary

Align firmware ESP-IDF version references to v5.4 (fixes #1177 build error).

Why this matters

Issue #1177 reports an ESP32 firmware build failure: undefined reference to '__ieee754_sqrtf' when building the CSI-node firmware (commit 7831f29, v0.8.2-esp32) with ESP-IDF v5.3 / xtensa-esp-elf 13.2.0 on Apple Silicon. The owner (ruvnet) replied three times that the project is tested against and targets ESP-IDF v5.4, and that v5.2/v5.3 are missing math stubs (__ieee754_sqrtf is pulled in by the sqrtf calls in main/edge_processing.c), so the fix is to build with v5.4. The root cause on the repo side is a stale documentation inconsistency: the firmware README quickstart still instructs users to build with the espressif/idf:v5.2 Docker image and carries an "ESP-IDF v5.2" badge, and

Testing

Changes are scoped to the files named in the fix; added or updated tests where the project has a suite, and matched existing conventions.

Fixes #1177

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

idf.py build flash monitor

1 participant