esp-println

一个库，为 Espressif 设备提供 print!、println!、dbg! 实现和日志功能。

• 支持所有 Espressif ESP32 系列设备。
• 支持不同的通信方法
  • UART（默认）
  • JTAG-Serial（仅适用于 ESP32-C3、ESP32-C6、ESP32-H2、ESP32-S3）
  • No-op：将打印转换为无操作
• 支持 defmt 后端

使用方法

esp-println = { version = "0.9.1", features = ["esp32c2"] }

或 cargo add esp-println --features esp32c2 确保指定您的目标设备作为功能。

然后在您的程序中

use esp_println::println;

现在您可以像往常一样 println!("Hello world")。

功能

• 每个支持的目标都有一个功能：esp32、esp32c2、esp32c3、esp32c6、esp32h2、esp32s2 和 esp32s3。
  • 必须启用其中一个功能。
  • 一次只能启用这些功能中的一个。
• 每个支持的通信方法都有一个功能：uart、jtag-serial 和 auto。
  • 一次只能启用这些功能中的一个。
• no-op：不打印任何内容。
• log：使用 log 包 启用日志记录。
• colors：启用彩色日志。
  • 仅在启用log功能时有效。
• critical-section：启用临界区。
• defmt-espflash：此功能旨在与espflash一起使用，请参阅-L/--log-format参数的flash或monitor子命令，以及cargo-espflash。使用rzCOBS编码并添加帧。

默认功能

默认情况下，我们使用auto、critial-section和colors功能。这意味着它将自动检测是否需要打印到UART或JTAG-Serial，使用临界区，并且输出的消息将是彩色的。如果我们想使用不是auto默认的通信方式，我们需要禁用默认功能。

日志记录

启用log功能后，您可以使用以下方式初始化简单的记录器

init_logger(log::LevelFilter::Info);

存在一个默认功能colors，它启用了彩色日志输出。

此外，您还可以使用

init_logger_from_env();

在这种情况下，使用了以下环境变量

• ESP_LOGLEVEL设置日志级别，可以使用trace、info等值。
• ESP_LOGTARGETS如果设置，您应提供需要记录的crates的名称（可选带有路径，例如esp_wifi::compat::common），用,分隔，并且之间没有额外的空白。