espflash

用于烧录 Espressif 设备的库和命令行工具。

支持 ESP32、ESP32-C2/C3/C6、ESP32-H2、ESP32-P4、ESP32-S2/S3。

目录

• 安装
• 用法
  • Linux 上的权限
  • Windows 子系统 for Linux
  • Cargo Runner
• 将 espflash 作为库使用
• 配置文件
  • 配置优先级
• 日志格式
• 许可证
  • 贡献

安装

如果您是从源代码安装 espflash（即使用 cargo install），则必须在您的系统上安装 rustc>=1.76.0。

如果您正在运行 Linux，则还必须安装 libudev；这可以通过大多数流行的软件包管理器获取。如果您正在运行 Windows 或 macOS，则可以忽略此步骤。

# Debian/Ubuntu/etc.
apt-get install libudev-dev
# Fedora
dnf install systemd-devel

安装

cargo install espflash

或者，您可以使用 cargo-binstall 从 发布版 下载预编译的工件，并用它们代替

cargo binstall espflash

用法

A command-line tool for flashing Espressif devices

Usage: espflash <COMMAND>

Commands:
  board-info       Print information about a connected target device
  completions      Generate completions for the given shell
  erase-flash      Erase Flash entirely
  erase-parts      Erase specified partitions
  erase-region     Erase specified region
  flash            Flash an application in ELF format to a connected target device
  hold-in-reset    Hold the target device in reset
  monitor          Open the serial monitor without flashing the connected target device
  partition-table  Convert partition tables between CSV and binary format
  read-flash       Read SPI flash content
  reset            Reset the target device
  save-image       Generate a binary application image and save it to a local disk
  write-bin        Write a binary file to a specific address in a target device's flash
  checksum-md5     Calculate the MD5 checksum of the given region
  help             Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Linux 上的权限

在 Linux 中，当使用需要使用串行端口的任何命令时，当前用户可能没有访问串行端口，并可能出现“权限被拒绝”或“端口不存在”错误。

在大多数Linux发行版中，解决方案是将用户添加到dialout组（例如，使用ls -l /dev/ttyUSB0来查找组）的命令，如下所示：sudo usermod -a -G dialout $USER. 使用su - $USER可以启用串口读写权限，而无需注销并重新登录。

[target.'cfg(any(target_arch = "riscv32", target_arch = "xtensa"))']
runner = "espflash flash --baud=921600 --monitor /dev/ttyUSB0"

espflash = { version = "2.1", default-features = false }