将Arduino项目移植到ESP-IDF时遇未定义引用错误求助

编译链接错误日志 #

[1/6] Performing build step for 'bootloader'
[1/1] cmd.exe /C "cd /D C:\Espressif\frameworks\esp-idf-v4.4.5\workspace\GAZZELE_MINI\build\bootloader\esp-idf\esptool_py && C:\Espressif\python_env\idf4.4_py3.11_env\Scripts\python.exe C:/Espressif/frameworks/esp-idf-v4.4.5/components/partition_table/check_sizes.py --offset 0x8000 bootloader 0x1000 C:/Espressif/frameworks/esp-idf-v4.4.5/workspace/GAZZELE_MINI/build/bootloader/bootloader.bin"
Bootloader binary size 0x63f0 bytes. 0xc10 bytes (11%) free.
[2/4] Linking CXX executable GAZZELE_MINI.elf
FAILED: GAZZELE_MINI.elf
cmd.exe /C "cd . && C:\Espressif\tools\xtensa-esp32-elf\esp-2021r2-patch5-8.4.0\xtensa-esp32-elf\bin\xtensa-esp32-elf-g++.exe -mlongcalls -Wno-frame-address  @CMakeFiles\GAZZELE_MINI.elf.rsp -o GAZZELE_MINI.elf  && cd ."
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: esp-idf/main/libmain.a(Camera_Settings.cpp.obj):(.literal.initCameraSettings+0x18): undefined reference to `esp_camera_init'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: esp-idf/main/libmain.a(Camera_Settings.cpp.obj):(.literal.initCameraSettings+0x1c): undefined reference to `esp_camera_sensor_get'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: esp-idf/main/libmain.a(Camera_Settings.cpp.obj):(.literal.capturePhotoSaveSpiffs+0x38): undefined reference to `esp_camera_fb_get'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: esp-idf/main/libmain.a(Camera_Settings.cpp.obj):(.literal.capturePhotoSaveSpiffs+0x40): undefined reference to `esp_camera_fb_return'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: esp-idf/main/libmain.a(Camera_Settings.cpp.obj): in function `initCameraSettings': C:/Espressif/frameworks/esp-idf-v4.4.5/workspace/GAZZELE_MINI/main/DriverModules/CamDrivers/Camera_Settings.cpp:56: undefined reference to `esp_camera_init'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: C:/Espressif/frameworks/esp-idf-v4.4.5/workspace/GAZZELE_MINI/main/DriverModules/CamDrivers/Camera_Settings.cpp:56: undefined reference to `esp_camera_sensor_get'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: C:/Espressif/frameworks/esp-idf-v4.4.5/workspace/GAZZELE_MINI/main/DriverModules/CamDrivers/Camera_Settings.cpp:72: undefined reference to `esp_camera_sensor_get'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: esp-idf/main/libmain.a(Camera_Settings.cpp.obj): in function `capturePhotoSaveSpiffs': C:/Espressif/frameworks/esp-idf-v4.4.5/workspace/GAZZELE_MINI/main/DriverModules/CamDrivers/Camera_Settings.cpp:194: undefined reference to `esp_camera_fb_get'
c:/espressif/tools/xtensa-esp32-elf/esp-2021r2-patch5-8.4.0/xtensa-esp32-elf/bin/../lib/gcc/xtensa-esp32-elf/8.4.0/../../../../xtensa-esp32-elf/bin/ld.exe: C:/Espressif/frameworks/esp-idf-v4.4.5/workspace/GAZZELE_MINI/main/DriverModules/CamDrivers/Camera_Settings.cpp:209: undefined reference to `esp_camera_fb_return'
collect2.exe: error: ld returned 1 exit status
ninja: build stopped: subcommand failed.

解决步骤 #

• 启用ESP-IDF Camera组件：在VSCode中打开命令面板（Ctrl+Shift+P），输入ESP-IDF: SDK Configuration Editor (menuconfig)，进入配置界面后，依次展开Component config -> ESP32-specific -> Camera，勾选Enable Camera，并选择你使用的摄像头型号（如OV2640、OV7670等）。
• 检查CMakeLists.txt配置：确保项目main目录下的CMakeLists.txt中，已将esp_camera添加为依赖。修改idf_component_register行，加入REQUIRES esp_camera，示例：

  idf_component_register(SRCS "Camera_Settings.cpp" "其他源文件.cpp"
                        INCLUDE_DIRS "."
                        REQUIRES esp_camera)
  

  或者在文件末尾添加：

  target_link_libraries(${PROJECT_NAME} PRIVATE esp_camera)
  

• 清理并重建项目：执行以下命令清除编译缓存，避免旧配置干扰：

  idf.py clean
  idf.py build
  

• 验证头文件引用：检查Camera_Settings.cpp文件顶部是否包含了正确的头文件：

  #include "esp_camera.h"
  

  确保拼写正确，没有路径错误。
• 确认组件完整性：检查ESP-IDF安装目录下的components/camera文件夹是否完整，若有缺失或损坏，重新安装对应版本的ESP-IDF框架。

内容的提问来源于stack exchange，提问作者Abhay Kondru