在介紹 ulog 前，我們先來了解一些日志的概念：

日志的定義：日志會將軟件運行的狀態、過程等信息，輸出到不同的介質中（例如：文件、控制臺、顯示屏等），并進行顯示和保存。為軟件調試、維護過程中的問題提供追溯、性能分析、系統監控、故障預警等功能，同時提供參考依據。可以說，日志的使用，幾乎占用了軟件生命周期至少 80% 的時間。

日志的重要性：對于操作系統而言，由于其軟件的復雜度非常大，單步調試在一些場景下并不適合，所以日志組件在操作系統上幾乎都是標配。完善的日志系統也能讓操作系統的調試事半功倍。

RT-Thread 一直缺少小巧、實用的日志組件，而 ulog 的誕生補全了這塊的短板。今天，它將作為 RT-Thread 的基礎組件被開源出來，讓我們的開發者也能用上簡潔易用的日志系統，提高開發效率。

ulog 介紹

ulog 是一個非常簡潔、易用的 C/C++ 日志組件，第一個字母 u 代表 μ，即微型的意思。它能做到最低ROM<1K, RAM<0.2K的資源占用。ulog 不僅有小巧體積，同樣也有非常全面的功能，其設計理念參考的是另外一款 C/C++ 開源日志庫：EasyLogger（簡稱 elog），并在功能和性能等方面做了非常多的改進。主要特性如下：

主要特性

線程安全

日志輸出被設計為是線程安全的方式，當前線程日志輸出不會被其他線程打斷干擾。不用再擔心像使用 rt_kprintf 那樣，多線程并發輸出日志時，日志顯示錯位、截斷等問題。

高可靠

日志系統可靠性高，在中斷 ISR中、Hardfault等復雜環境下依舊可用。不僅留給用戶的限制更少，還能夠保證系統在出錯場景下，記錄的日志依舊準確、全面，成為用戶的調試利器。而這點在其他常見的日志系統中是做不到的。

后端多樣化

ulog 可以將日志輸出到終端、串口、網絡，文件、閃存等位置，這些地方在 ulog 里統稱為后端。ulog 采用了前后端分離式設計，保證了日志的后端代碼的獨立性以及可擴展性。無論什么樣的后端，只要實現出來，都可以注冊上去。

當前 ulog 已經集成了兩種后端：

console 控制臺：即大家常用的 rt_kprintf 輸出的位置；

Flash 存儲：該后端已集成到 RT-Thread 的軟件包中，具體位置如下：

未來還將會有更多的后端加入進來，也期待大家一起參與，實現你們需要的后端，然后分享出來。

支持異步輸出

在 ulog 中，默認的輸出模式是同步模式，在很多場景下用戶可能還需要異步模式。用戶在調用日志輸出 API 時，會將日志緩存到緩沖區中，會有專門負責日志輸出的線程取出日志，然后輸出到后端。

這樣日志輸出不會阻塞當前線程，日志調試代碼也就不會影響當前線程運行時序。

靈活的過濾配置

支持運行階段/編譯階段開關控制全局的日志輸出級別；

各模塊的日志支持運行階段/編譯階段設置輸出級別；

日志內容支持按關鍵詞及標簽方式進行全局過濾；

以上運行階段的配置也都支持通過 Finsh/MSH 命令進行操作。

兼容 syslog

ulog 提供了 syslog 模式的支持，不僅僅前端 API 與 syslog API 完全一致，日志的格式也符合 RFC 標準，更好的兼容了來自 linux 平臺上的軟件代碼。

支持 hexdump

hexdump 也是日志輸出時較為常用的功能，通過 hexdump 可以將一段數據以 hex 格式輸出出來。大致效果如下：

支持浮點數打印

這個一直以來都是大家用 rt_kprintf 的痛點，現在在 ulog 上得到了徹底的解決。使用前，需要先在 menuconfig 中配置開啟 ulog 的浮點數支持。

兼容 rtdbg.h 及 elog

rtdbg 是 RT-Thread 早期的日志頭文件，當前 rtdbg 已完成無縫對接ulog ，開啟 ulog 后，舊項目中使用 rtdbg 的代碼無需做任何修改，即可使用 ulog 完成日志輸出。

elog 是 EasyLogger 的簡稱，對于 elog 來說，ulog 能完全做到 API 層面的兼容。使用時，只需要將舊項目源代碼中的 #include 更換為 #include 即可，其他代碼無需再做任何改動。

使用流程

ulog 的代碼目前開源在 RT-Thread 的 GitHub 倉庫中，代碼位于 rt-thread/components/utilities/ulog 下，大致使用流程如下：

開啟：通過 ENV 工具，在 menuconfig 中的 utilities 菜單下選中 ulog 組件；

使用：可以參考 ulog 的應用筆記，ulog 的主要日志 API 非常簡單，基本用法如下：