Windows 环境下从源码编译 OpenOCD¶
除了从 Espressif 官方 直接下载 OpenOCD 可执行文件,你还可以选择从源码编译得到 OpenOCD。如果想要快速设置 OpenOCD 而不是自行编译,请备份好当前文件,前往 安装 OpenOCD 章节查阅。
下载 OpenOCD 源码¶
支持 ESP32-C3 的 OpenOCD 源代码可以从乐鑫官方的 GitHub 获得,网址为 https://github.com/espressif/openocd-esp32。请使用以下命令来下载源代码:
cd ~/esp
git clone --recursive https://github.com/espressif/openocd-esp32.git
克隆后的源代码被保存在 ~/esp/openocd-esp32
目录中。
安装依赖的软件包¶
安装编译 OpenOCD 所需的软件包。
注解
依次安装以下软件包,检查安装是否成功,然后继续下一个软件包的安装。在进行下一步操作之前,要先解决当前报告的问题。
pacman -S libtool
pacman -S autoconf
pacman -S automake
pacman -S texinfo
pacman -S mingw-w64-i686-libusb-compat-git
pacman -S pkg-config
注解
安装 pkg-config
会破坏 esp-idf 的工具链,因而在 OpenOCD 构建完成后,应将其卸载。详见文末进一步说明。如果想要再次构建 OpenOCD,你需要再次运行 pacman -S pkg-config
。此步骤安装的其他软件包(在 pkg-config
之前)并不会出现这一问题。
构建 OpenOCD¶
配置和构建 OpenOCD 的流程如下:
cd ~/esp/openocd-esp32
./bootstrap
./configure
make
你可以选择最后再执行 sudo make install
,如果你已经安装过别的开发平台的 OpenOCD,请跳过这个步骤,因为它可能会覆盖掉原来的 OpenOCD。
注解
如果发生错误,请解决后再次尝试编译,直到
make
成功为止。如果 OpenOCD 存在子模块问题,请
cd
到openocd-esp32
目录,并输入git submodule update --init
命令。如果
./configure
成功运行,JTAG 被使能的信息会被打印在OpenOCD configuration summary
下面。如果您的设备信息未显示在日志中,请根据
../openocd-esp32/doc/INSTALL.txt
文中的描述使用./configure
启用它。有关编译 OpenOCD 的详细信息,请参阅
openocd-esp32/README.Windows
。
一旦 make
过程成功完成,OpenOCD 的可执行文件会被保存到 ~/esp/openocd-esp32/src/openocd
目录中。
如安装依赖步骤所述,最后还需要移除 pkg-config
软件包:
pacman -Rs pkg-config
下一步¶
想要进一步配置调试环境,请前往 配置 ESP32-C3 目标板 章节。