警告

This document is not updated for ESP32C5 yet, so some of the content may not be correct.

This warning was automatically inserted due to the source file being in the add_warnings_pages list.

Linux 环境下从源码编译 OpenOCD

[English]

除了从 Espressif 官方 直接下载 OpenOCD 可执行文件,你还可以选择从源码编译得到 OpenOCD。如果想要快速设置 OpenOCD 而不是自行编译,请备份好当前文件,前往 安装 OpenOCD 章节查阅。

下载 OpenOCD 源码

支持 ESP32-C5 的 OpenOCD 源代码可以从乐鑫官方的 GitHub 获得,网址为 https://github.com/espressif/openocd-esp32。请使用以下命令来下载源代码:

cd ~/esp
git clone --recursive https://github.com/espressif/openocd-esp32.git

克隆后的源代码被保存在 ~/esp/openocd-esp32 目录中。

安装依赖的软件包

安装编译 OpenOCD 所需的软件包。

备注

依次安装以下软件包,检查安装是否成功,然后继续下一个软件包的安装。在进行下一步操作之前,要先解决当前报告的问题。

sudo apt-get install make
sudo apt-get install libtool
sudo apt-get install pkg-config
sudo apt-get install autoconf
sudo apt-get install automake
sudo apt-get install texinfo
sudo apt-get install libusb-1.0

备注

  • pkg-config 应为 0.2.3 或以上的版本。

  • autoconf 应为 2.6.4 或以上的版本。

  • automake 应为 1.9 或以上的版本。

  • 当使用 USB-Blaster,ASIX Presto,OpenJTAG 和 FT2232 作为适配器时,需要下载安装 libFTDI 和 FTD2XX 的驱动。

  • 当使用 CMSIS-DAP 时,需要安装 HIDAPI。

构建 OpenOCD

配置和构建 OpenOCD 的流程如下:

cd ~/esp/openocd-esp32
./bootstrap
./configure
make

你可以选择最后再执行 sudo make install ,如果你已经安装过别的开发平台的 OpenOCD,请跳过这个步骤,因为它可能会覆盖掉原来的 OpenOCD。

备注

  • 如果发生错误,请解决后再次尝试编译,直到 make 成功为止。

  • 如果 OpenOCD 存在子模块问题,请 cdopenocd-esp32 目录,并输入 git submodule update --init 命令。

  • 如果 ./configure 成功运行,JTAG 被使能的信息会被打印在 OpenOCD configuration summary 下面。

  • 如果你的设备信息未显示在日志中,请根据 ../openocd-esp32/doc/INSTALL.txt 文中的描述使用 ./configure 启用它。

  • 有关编译 OpenOCD 的详细信息,请参阅 openocd-esp32/README

一旦 make 过程成功结束,OpenOCD 的可执行文件会被保存到 ~/openocd-esp32/bin 目录中。

下一步

想要进一步配置调试环境,请前往 配置 ESP32-C5 目标板 章节。