Windows下用MSYS2编译flashrom 1.3全攻略（支持FTDI等主流编程器）

Windows下用MSYS2编译flashrom 1.3全攻略（支持FTDI等主流编程器）

对于许多硬件开发者、嵌入式工程师和固件爱好者来说，flashrom 是一个不可或缺的瑞士军刀。它支持海量的 SPI、并行、LPC 和 FWH 闪存芯片，并且能与市面上绝大多数常见的编程器硬件协同工作。然而，官方发布的 Windows 预编译版本往往更新滞后，或者缺少对一些特定编程器（如基于 FTDI 芯片的型号）的完整支持。如果你手头正好有一块 FT2232H 调试板，或者 CH341A 编程器，却发现下载的二进制文件无法识别，那么自己动手从源码编译一个功能齐全的版本，就成了最直接、最可靠的解决方案。

在 Windows 平台上进行开源工具的编译，常常让人望而却步。传统的 MinGW 或 Cygwin 环境配置复杂，依赖库缺失问题频发，尤其是涉及到 USB 设备访问的库时，更是困难重重。幸运的是，MSYS2 的出现极大地改善了这一状况。它提供了一个近乎原生的 POSIX 兼容环境，拥有强大的包管理器 Pacman，可以轻松安装和维护编译工具链以及各种开发库。本指南将带你一步步在 MSYS2 环境中，从零开始编译出支持 FTDI、CH341A、Dediprog 等主流编程器的完整版 flashrom 1.3，让你在 Windows 下也能获得与 Linux 环境相媲美的强大固件读写能力。

1. 搭建坚实的MSYS2编译环境

在开始编译 flashrom 之前，一个稳定、配置正确的 MSYS2 基础环境是成功的关键。许多编译失败的问题，根源都在于环境准备不充分。

1.1 MSYS2的安装与基础配置

首先，你需要从 MSYS2 的官方网站下载安装程序。建议选择 64 位版本以获得更好的兼容性。安装路径可以保持默认（例如C:\msys64），但请确保路径中不要包含中文或空格，这能避免后续编译过程中可能出现的各种诡异问题。

安装完成后，从开始菜单启动MSYS2 UCRT64。这个环境基于较新的 UCRT 运行时库，对现代软件的支持更好。首次启动后，终端会提示你执行系统更新。这是至关重要的一步，它能确保你的包数据库和核心系统组件是最新的。

pacman -Syu

注意：这个命令可能会分两步进行。第一次运行后，如果提示需要关闭终端，请照做，然后重新打开 MSYS2 UCRT64 终端，再次运行相同的命令，直到系统完全更新完毕。

接下来，我们需要安装最核心的编译工具链。这包括 GNU 编译器集合、自动化构建工具和版本控制系统。

pacman -S --needed base-devel git mingw-w64-ucrt-x86_64-toolchain

base-devel包含make,autoconf,automake等构建工具。mingw-w64-ucrt-x86_64-toolchain则提供了gcc,g++,gdb等针对 Windows 的交叉编译器。--needed参数可以避免重复安装已存在的包。

1.2 安装flashrom的必备依赖库

flashrom 的功能模块化程度很高，对不同编程器的支持依赖于特定的外部库。为了编译出一个功能全面的版本，我们需要预先安装好这些库。以下表格列出了编译支持主流编程器的 flashrom 所需的关键库及其作用：

在 MSYS2 UCRT64 终端中，使用以下命令一次性安装所有必需的开发库：

pacman -S mingw-w64-ucrt-x86_64-libusb mingw-w64-ucrt-x86_64-libftdi mingw-w64-ucrt-x86_64-pciutils

对于libmpsse，它可能不在默认仓库中。如果后续配置阶段提示需要，我们可以考虑从源码编译，但通常libftdi已经足够覆盖大部分 FTDI 设备的需求。安装完成后，你可以使用pkg-config命令来验证库是否已正确安装并可被找到：

pkg-config --list-all | grep -E "(libusb|libftdi)"

如果看到相关的库信息，说明环境配置基本就绪。

2. 获取源码与配置编译选项

有了完善的环境，接下来就是获取 flashrom 的源代码，并根据我们的需求进行精准的配置。

2.1 克隆与准备源码

我们直接从 flashrom 的官方 Git 仓库获取最新代码。这能确保我们获得最新的功能支持和错误修复。

# 进入一个合适的工作目录，例如用户主目录 cd ~ # 克隆 flashrom 仓库 git clone https://github.com/flashrom/flashrom.git cd flashrom

为了保证编译的可重复性和稳定性，建议切换到最新的稳定版本标签。你可以使用git tag查看所有标签，然后选择v1.3或更高的稳定版本。

git checkout v1.3.0

提示：直接使用master分支的代码也可以，但这是开发分支，可能包含未经验证的新特性或引入新的编译问题。对于生产用途，建议使用标签版本。

2.2 理解与执行配置脚本

flashrom 使用make进行构建，但其配置系统可能因版本而异。较新版本通常使用meson，而旧版使用autotools。对于 v1.3.0，我们主要使用make配合明确的变量设置。配置的核心在于启用我们需要的编程器支持。

编译前，我们需要设置一些环境变量，告诉构建系统我们使用 UCRT64 环境的工具链，并指定我们已安装的库的位置。在 MSYS2 UCRT64 环境中，这通常已经自动设置好了。我们可以通过一个简单的配置命令来开启主要功能：

make CONFIG_ENABLE_LIBUSB1_PROGRAMMERS=yes CONFIG_FT2232_SPI=yes CONFIG_CH341A_SPI=yes CONFIG_DEDIPROG=yes

但是，更系统化的方法是检查并设置Makefile的本地配置。flashrom 的编译选项非常丰富，以下是一些关键选项的说明，你可以根据手头的硬件决定是否启用：

• CONFIG_ENABLE_LIBUSB1_PROGRAMMERS=yes:必须启用。这是支持大多数 USB 编程器（如 CH341A, Dediprog, USB-Blaster）的基石。
• CONFIG_FT2232_SPI=yes: 启用对 FTDI FT2232/FT232/FT4232 系列芯片的支持。如果你有基于这些芯片的调试板（如 FT2232H 迷你模块、Olimex ARM-USB-TINY 等），就需要这个。
• CONFIG_CH341A_SPI=yes: 启用对廉价且流行的 CH341A 编程器的支持。
• CONFIG_DEDIPROG=yes: 启用对 Dediprog SF100/SF200/SF600 系列高端编程器的支持。
• CONFIG_BUSPIRATE_SPI=yes: 启用对 Bus Pirate 硬件的支持。
• CONFIG_SERPROG=yes: 启用对 serprog 协议的支持（例如，通过 Arduino 或 Raspberry Pi 作为编程器）。
• CONFIG_INTERNAL=yes: 启用对主板内置编程器的支持（需要 PCI 访问权限，在 Windows 下功能可能受限）。

一个功能全面的编译命令示例如下：

make CC=gcc PREFIX=/usr/local CONFIG_ENABLE_LIBUSB1_PROGRAMMERS=yes CONFIG_FT2232_SPI=yes CONFIG_CH341A_SPI=yes CONFIG_DEDIPROG=yes CONFIG_BUSPIRATE_SPI=yes CONFIG_PICKIT2_SPI=yes

运行此命令会开始编译过程。CC=gcc指定编译器，PREFIX定义了安装路径（虽然我们通常不进行系统安装，而是直接使用编译出的二进制文件）。

3. 解决编译过程中的常见问题

即使按照上述步骤操作，你也可能会遇到一些编译错误。别担心，这些问题大多有明确的解决方案。

3.1 依赖库头文件或链接库找不到

这是最常见的问题。错误信息通常类似于fatal error: libusb.h: No such file or directory或undefined reference tolibusb_init‘`。

• 原因：MSYS2 的库文件可能安装在非标准路径，pkg-config配置不正确，或者编译命令没有正确链接库。
• 解决方案：
  1. 确认安装：首先用pacman -Qs命令再次确认库已安装。
  2. 使用pkg-config：最优雅的方式是确保 flashrom 的构建系统能通过pkg-config找到库。在 MSYS2 UCRT64 中，这通常是自动配置好的。如果出错，可以手动指定PKG_CONFIG_PATH环境变量，但这种情况较少见。
  3. 手动指定路径（备用方案）：如果上述方法不行，可以在make命令中通过CFLAGS和LDFLAGS手动指定路径。例如，对于 libusb：

     make CFLAGS="-I/mingw64/include" LDFLAGS="-L/mingw64/lib" CONFIG_ENABLE_LIBUSB1_PROGRAMMERS=yes ...

     这里的/mingw64是 MINGW64 环境的典型路径，在 UCRT64 中可能是/ucrt64。你可以使用pacman -Ql mingw-w64-ucrt-x86_64-libusb | grep .h$来查找头文件的具体安装位置。

3.2 特定编程器支持编译失败

例如，配置了CONFIG_FT2232_SPI=yes，但编译时报错找不到ftdi.h或链接失败。

• 原因：libftdi库可能没有安装，或者版本不兼容。
• 解决方案：确保已通过 pacman 安装了mingw-w64-ucrt-x86_64-libftdi。如果问题依旧，可以尝试暂时禁用该编程器支持（CONFIG_FT2232_SPI=no），先编译出一个基础版本，再专门解决 libftdi 的问题。有时，需要同时安装libftdi和libftdi-devel（在 MSYS2 中通常合并为一个包）。

3.3 编译成功但运行时缺少DLL

编译顺利通过，生成了flashrom.exe，但在 Windows 命令行中运行时弹出“无法找到 VCRUNTIME140.dll”或“libusb-1.0.dll”等错误。

• 原因：可执行文件依赖于 MSYS2 环境或 Visual C++ 运行库的动态链接库（DLL），而这些 DLL 不在系统的 PATH 环境变量中。
• 解决方案：
  • 方案A（推荐，便携）：将所需的 DLL 与flashrom.exe放在同一目录下。所需的 DLL 通常可以在 MSYS2 的安装目录下找到（如C:\msys64\ucrt64\bin）。你需要复制以下常见的 DLL：
    • libusb-1.0.dll
    • libftdi1.dll
    • libwinpthread-1.dll
    • libgcc_s_seh-1.dll
    • libstdc++-6.dll
  • 方案B：将 MSYS2 的ucrt64\bin目录（例如C:\msys64\ucrt64\bin）添加到系统的 PATH 环境变量中。这样系统在任何地方都能找到这些 DLL。

4. 验证与使用编译成果

编译完成后，在 flashrom 源码目录下会生成flashrom.exe文件。让我们来验证它的功能是否完整。

4.1 基础功能验证

首先，在不连接任何编程器的情况下，运行最基本的帮助和版本检查命令：

./flashrom.exe --version ./flashrom.exe --help

这应该输出 flashrom 的版本信息（v1.3.0）以及一长串帮助文档。接下来，查看编译时启用了哪些编程器：

./flashrom.exe --programmer dummy

使用dummy（虚拟）编程器运行，它会列出所有检测到并支持的编程器类型。你应该能在输出中看到类似下面的内容：

... Valid choices are: dummy, raiden_debug_spi, ft2232_spi, serprog, buspirate_spi, dediprog, developerbox, pony_spi, usbblaster_spi, pickit2_spi, ch341a_spi, digilent_spi, stlinkv3_spi.

这个列表显示了当前二进制文件支持的所有编程器后端。确认ft2232_spi、ch341a_spi、dediprog等是否在其中。

4.2 连接真实硬件进行测试

现在，将你的编程器（例如 FT2232H 开发板）通过 USB 连接到电脑。在 MSYS2 终端或 Windows 命令行中（确保 DLL 问题已解决），尝试让 flashrom 识别该设备。

对于 FT2232H 设备：

./flashrom.exe --programmer ft2232_spi:type=4232h,port=A --flash-detection

• type=4232h需要根据你的实际 FTDI 芯片型号调整，常见的有2232h,232h,4232h。
• port=A指定使用 FTDI 芯片的哪个端口（A 或 B）。
• --flash-detection尝试探测连接的闪存芯片。

如果一切正常，flashrom 会识别出编程器，并尝试与目标板上的闪存芯片通信。你可能会看到类似“Found chip”的信息。如果出现权限错误（无法打开 USB 设备），在 Windows 下可能需要以管理员身份运行终端，或者为设备安装特定的驱动程序（通常 Zadig 工具可以帮您将驱动替换为 libusb-win32 或 WinUSB）。

对于 CH341A 编程器：

./flashrom.exe --programmer ch341a_spi --flash-detection

命令更简单，因为 CH341A 通常只有一种模式。

4.3 实战操作：读取与写入闪存

在确认编程器和闪存芯片被正确识别后，你就可以进行实际的读写操作了。在进行任何写入操作前，务必先进行读取备份！

1. 读取（备份）闪存内容：

   ./flashrom.exe --programmer ch341a_spi -r backup.bin

   这个命令会将整个闪存芯片的内容读取到backup.bin文件中。建议在不同时间点保存多个备份。

2. 擦除闪存：

   ./flashrom.exe --programmer ch341a_spi -E

   使用-E参数擦除芯片。对于某些芯片，可能在写入前不需要单独擦除。

3. 写入新数据：

   ./flashrom.exe --programmer ch341a_spi -w new_firmware.bin

   将new_firmware.bin文件写入闪存。-w参数包含了擦除和写入的过程。

4. 验证写入：

   ./flashrom.exe --programmer ch341a_spi -v new_firmware.bin

   使用-v参数验证闪存中的内容是否与文件一致。

在整个过程中，如果遇到速度慢的问题，可以尝试为编程器指定更高的时钟频率（如果支持），例如--spi-clock 1000（单位 kHz）。但要注意，过高的频率可能导致通信不稳定。

自己编译 flashrom 的过程，虽然初期需要一些环境配置的投入，但它带来的回报是巨大的：一个完全符合你硬件需求的、最新的、功能强大的工具。从此，你不再受限于他人预编译的二进制文件，可以自由地尝试新版本，甚至根据需要打补丁或修改代码。当你的 FT2232H 调试板被完美识别，并成功读出第一颗芯片的固件时，那种对工具链的掌控感，正是技术探索的乐趣所在。