defmt

defmt ("de format"，缩写为 "deferred formatting") 是一个高效的日志框架，针对资源受限的设备，如微控制器。

有关框架的更多详细信息，请参阅https://defmt.ferrous-systems.com中的书籍。

defmt 书籍的 git 版本可以在 https://defmt-next.ferrous-systems.com/ 中查看。

设置

新建项目

开始使用 defmt 的最快方法是使用我们的 app-template 来设置一个新的 Cortex-M 嵌入式项目。

现有项目

要将 defmt 包含到您的现有项目中，请遵循我们的 应用设置指南。

MSRV

defmt 总是在最新的 stable Rust 版本 上编译。这是通过我们的 CI 构建和测试强制执行的。

它可能在旧的 Rust 版本上仍能工作，但这没有保证。

defmt 生态系统

以下图表展示了 defmt 框架的用户界面和内部包。

开发者信息

运行测试

使用 cargo xtask 运行测试 —— 虽然这只是一个别名（在 .cargo/config.toml 中定义），代表 cargo run --package xtask --

要查看选项列表，请参阅 xtask/src/main.rs，或运行

$ cargo xtask help

例如，要运行所有测试，请运行

$ cargo xtask test-all

您需要安装并配置qemu-system-arm到您的$PATH中，以便进行某些测试（例如 test-snapshot）。

支持

defmt是Knurling项目的一部分，是Ferrous Systems努力改进用于嵌入式系统开发的工具的努力。

如果您认为我们的工作很有用，请考虑通过GitHub Sponsors进行赞助。

许可证

根据您的选择，许可如下：

• Apache License, Version 2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)

• MIT license (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

。

贡献

除非您明确声明，否则根据Apache-2.0许可证定义的，任何有意提交以包含在作品中的贡献，都应按照上述方式许可，不附加任何其他条款或条件。