esp-println - 专为ESP系列芯片优化的Rust日志打印工具

介绍

esp-println是专为ESP系列芯片(如ESP32、ESP32-C3等)设计的Rust日志打印库，提供了高效的println!宏实现。相比标准库的println!，它针对ESP芯片进行了优化，更适合嵌入式开发环境。

主要特点：

• 轻量级实现，减少代码体积
• 支持多种ESP芯片系列
• 与标准println!相似的API，学习成本低
• 可配置的输出目标(串口等)

使用方法

基本使用

首先在Cargo.toml中添加依赖：

[dependencies]
esp-println = "0.3"

然后在代码中使用：

use esp_println::println;

fn main() {
    println!("Hello, ESP world!");  // 输出到默认串口
    println!("Value: {}", 42);      // 支持格式化
}

初始化配置

在使用前通常需要初始化日志系统：

use esp_println::{logger::init_logger, Printer};

// 初始化日志系统，设置波特率
init_logger(Printer::new(115200));

不同日志级别

esp-println也提供了不同日志级别的宏：

use esp_println::{debug, error, info, warn};

fn some_function() {
    debug!("调试信息");
    info!("常规信息");
    warn!("警告信息");
    error!("错误信息");
}

自定义输出目标

可以自定义输出到不同的串口：

use esp_println::{Printer, println};
use embedded_hal::serial::Write;

// 假设uart1是你的串口实例
let printer = Printer::new_with_uart(uart1);
println!(printer, "这条消息会输出到uart1");

示例项目

一个完整的ESP32示例：

#![no_std]
#![no_main]

use esp32_hal::{clock::ClockControl, pac::Peripherals, prelude::*, timer::TimerGroup};
use esp_backtrace as _;
use esp_println::{println, init_logger, Printer};

#[entry]
fn main() -> ! {
    let peripherals = Peripherals::take().unwrap();
    let system = peripherals.DPORT.split();
    let clocks = ClockControl::boot_defaults(system.clock_control).freeze();

    // 初始化日志系统，波特率115200
    init_logger(Printer::new(115200));
    
    // 打印启动信息
    println!("系统启动完成");
    println!("CPU频率: {} MHz", clocks.cpu_clock.to_MHz());
    
    loop {
        println!("心跳...");
        TimerGroup::new(peripherals.TIMG1, &clocks).timer0.delay_ms(1000u32);
    }
}

完整示例DEMO

以下是一个更完整的ESP32-C3示例，展示了多级日志和自定义串口的使用：

#![no_std]
#![no_main]

use esp32c3_hal::{
    clock::ClockControl,
    pac::Peripherals,
    prelude::*,
    timer::TimerGroup,
    Rtc,
    Uart,
    IO,
};
use esp_backtrace as _;
use esp_println::{println, debug, info, warn, error, init_logger, Printer};

#[entry]
fn main() -> ! {
    let peripherals = Peripherals::take().unwrap();
    let system = peripherals.SYSTEM.split();
    let clocks = ClockControl::boot_defaults(system.clock_control).freeze();

    // 初始化串口0作为默认日志输出
    let io = IO::new(peripherals.GPIO, peripherals.IO_MUX);
    let pins = io.pins;
    let uart0 = Uart::new(peripherals.UART0, &clocks);
    
    // 初始化日志系统，波特率115200
    init_logger(Printer::new_with_uart(uart0));

    // 打印启动信息
    println!("系统启动完成");
    info!("CPU频率: {} MHz", clocks.cpu_clock.to_MHz());
    debug!("调试信息只会出现在debug模式下");
    
    // 初始化RTC
    let mut rtc = Rtc::new(peripherals.RTC_CNTL);
    rtc.rwdt.disable();
    
    // 创建一个计时器组
    let timer_group0 = TimerGroup::new(peripherals.TIMG0, &clocks);
    let mut timer0 = timer_group0.timer0;
    
    let mut counter = 0;
    loop {
        counter += 1;
        
        match counter % 4 {
            0 => println!("循环计数: {}", counter),
            1 => debug!("调试计数: {}", counter),
            2 => info!("信息计数: {}", counter),
            3 => warn!("警告计数: {}", counter),
            _ => error!("错误计数: {}", counter),
        }
        
        timer0.delay_ms(500u32);
    }
}

注意事项

1. 确保你的芯片支持所选波特率
2. 在no_std环境下使用需要添加#![no_std]属性
3. 对于复杂项目，考虑结合logcrate使用更完整的日志系统

esp-println是ESP嵌入式开发的实用工具，能显著简化调试和日志输出过程。