概述

ulog是AliOS Things的日志模塊，同時支持經典同步機制和異步日志機制，異步機制使其他邏輯任務保持正常工作，支持簡短的日志格式和syslog協議格式，日志內容可以通過不同方式輸出（uart udp vfs uagent）， 此外，文件系統中的日志文件可以通過HTTP上傳至云端。組件支持以下功能：

• 通過串口輸出日志

• 通過UDP輸出日志

• 通過文件系統輸出日志

• 通過uagent輸出日志到云端

版權信息

Apache license v2.0

目錄結構

ulog
├── README.md #ulog說明文檔
├── example
│   └── ulog_example.c      #ulog使用demo
├── include
│   ├── ulog_config.h       #ulog相關配置頭文件
│   └── ulog
│       └── ulog.h          #ulog使用API頭文件
├── internal                #內部頭文件
│   ├──ulog_api.h
│   ├──ulog_ring_fifo.h
│   └──ulog_session_file.h
├── src
│   ├── ulog_async.c        #ulog 異步日志輸出功能
│   ├── ulog.c              #ulog 整體功能
│   ├── ulog_fs_cfg.c       #ulog 文件系統配置
│   ├── ulog_init.c         #ulog 初始化
│   ├── ulog_ring_fifo.c    #ulog ring fifo功能，供異步使用
│   ├── ulog_session_file.c #ulog 日志到文件系統
│   ├── ulog_session_udp.c  #ulog 日志通過UDP發出
│   └── ulog_utility.c      #ulog 通用功能

依賴組件

• vfs

• uagent

常用配置

系統中相關配置已有默認值，如需修改配置，統一在YAML中def_config節點修改，具體如下：

開啟異步打印：默認0, 如需修改，在YAML中修改ULOG_CONFIG_ASYNC配置

def_config:
  ULOG_CONFIG_ASYNC: 1

支持日志實時上傳到云，默認不開啟，可按照實際需要修改YAML配置如：

def_config:
  ULOG_CONFIG_POP_CLOUD: 0
  ULOG_CONFIG_STOP_FILTER_CLOUD: 5

API說明

• 參考 aos_ulog

使用示例

組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具，所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》，下載安裝。待開發環境搭建完成后，可以按照以下步驟進行示例的測試。

depends:
  - ulog: dev_aos # helloworld_demo中引入ulog組件

aos install ulog

source_file:
  - src/ulog_async.c? <ULOG_CONFIG_ASYNC>
  - src/ulog.c
  - src/ulog_fs_cfg.c? <ULOG_CONFIG_POP_FS>
  - src/ulog_init.c
  - src/ulog_ring_fifo.c
  - src/ulog_session_file.c? <ULOG_CONFIG_POP_FS>
  - src/ulog_session_udp.c? <ULOG_CONFIG_POP_UDP>
  - src/ulog_utility.c
  - example/ulog_example.c #add ulog example code

    aos_set_log_level(AOS_LL_DEBUG);

ulog_examp