嵌入式开发终极指南：如何使用defmt高效记录日志

在嵌入式系统开发中，高效的日志记录对于调试和故障排除至关重要。`defmt`（deferred formatting）是一个专为资源受限设备设计的**高效日志框架**，通过延迟格式化和字符串压缩技术，显著提升嵌入式应用的开发效率。## 🚀 为什么选择defmt日志框架？传统的日志记录在嵌入式设备上往往占用大量资源，而`defmt`通过创新的设计理念解决了这一痛点：### 核心技术优势

gitblog_00054

585人浏览 · 2026-01-07 02:17:12

gitblog_00054 · 2026-01-07 02:17:12 发布

嵌入式开发终极指南：如何使用defmt高效记录日志

【免费下载链接】defmt Efficient, deferred formatting for logging on embedded systems 项目地址: https://gitcode.com/gh_mirrors/de/defmt

在嵌入式系统开发中，高效的日志记录对于调试和故障排除至关重要。defmt（deferred formatting）是一个专为资源受限设备设计的高效日志框架，通过延迟格式化和字符串压缩技术，显著提升嵌入式应用的开发效率。

🚀 为什么选择defmt日志框架？

传统的日志记录在嵌入式设备上往往占用大量资源，而defmt通过创新的设计理念解决了这一痛点：

核心技术优势

延迟格式化 - 格式化过程不在执行日志记录的设备上进行，而是在第二台机器（主机）上完成。这意味着不是将255u8格式化为"255"并发送字符串，而是将单字节二进制数据发送到主机，格式化在那里进行。

字符串压缩 - 在编译时构建字符串字面量表，运行时日志记录设备发送索引而不是完整字符串，大大减少了数据传输量。

⚡ 快速开始：5分钟配置defmt

基础环境搭建

对于库项目，只需添加defmt作为依赖：

$ cargo add defmt

对于应用程序，需要额外的配置步骤：

链接器脚本配置

应用程序必须使用包含defmt.x链接器脚本的自定义链接过程。在.cargo/config.toml中添加以下配置：

[target.thumbv7m-none-eabi]
rustflags = [
  "-C", "link-arg=-Tlink.x",
  "-C", "link-arg=--nmagic",
  "-C", "link-arg=-Tdefmt.x",
]

全局日志记录器设置

应用程序必须链接或定义global_logger，它指定日志如何从运行应用的设备发送到显示日志的主机。

🔧 defmt核心组件详解

设备端组件 📟

defmt - 核心日志框架，导出info!、debug!等宏供库使用
defmt-rtt - 通过SEGGER的RTT传输协议发送数据
defmt-itm - 通过ARM的ITM（Instrumentation Trace Macrocell）发送数据
defmt-semihosting - 通过半主机调用发送数据（仅适用于QEMU）

主机端组件 🖥️

defmt-decoder - 将日志帧转换为人类可读的Unicode文本
defmt-print - CLI程序，使用defmt-decoder处理日志帧

🎯 实战演示：defmt-test应用

defmt-test框架允许开发者像普通Rust测试一样验证硬件行为。通过宏自动管理测试初始化和断言，简化嵌入式测试流程。

测试代码示例

#[defmt_test::tests]
mod tests {
    #[init]
    fn init() -> Inputs {
        // GPIO引脚初始化
    }

    #[test]
    fn test_gpio_states() {
        // 验证硬件状态断言
    }
}