日志记录 - 平台

此模块包含调试日志服务的平台抽象。

摘要

枚举

otLogRegion{
  OT_LOG_REGION_API = 1,
  OT_LOG_REGION_MLE = 2,
  OT_LOG_REGION_ARP = 3,
  OT_LOG_REGION_NET_DATA = 4,
  OT_LOG_REGION_ICMP = 5,
  OT_LOG_REGION_IP6 = 6,
  OT_LOG_REGION_TCP = 7,
  OT_LOG_REGION_MAC = 8,
  OT_LOG_REGION_MEM = 9,
  OT_LOG_REGION_NCP = 10,
  OT_LOG_REGION_MESH_COP = 11,
  OT_LOG_REGION_NET_DIAG = 12,
  OT_LOG_REGION_PLATFORM = 13,
  OT_LOG_REGION_COAP = 14,
  OT_LOG_REGION_CLI = 15,
  OT_LOG_REGION_CORE = 16,
  OT_LOG_REGION_UTIL = 17,
  OT_LOG_REGION_BBR = 18,
  OT_LOG_REGION_MLR = 19,
  OT_LOG_REGION_DUA = 20,
  OT_LOG_REGION_BR = 21,
  OT_LOG_REGION_SRP = 22,
  OT_LOG_REGION_DNS = 23
}
枚举
表示日志区域。

类型定义符

otLogLevel typedef
int
表示日志级别。
otLogRegion typedef
表示日志区域。

函数

otPlatLog(otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aFormat, ...)
void
输出日志。
otPlatLogHandleLevelChanged(otLogLevel aLogLevel)
void
处理 OpenThread 日志级别更改。

枚举

otLogRegion

 otLogRegion

表示日志区域。

取消了对日志区域的支持,改为每个核心模块都可以定义自己的名称以附加到日志。不过,otLogRegion 枚举仍然像以前一样定义,以帮助一些平台可能在其 otPlatLog() 实现中使用此枚举。OT 核心将始终使用 OT_LOG_REGION_CORE 发出所有日志。

属性
OT_LOG_REGION_API

OpenThread API。

OT_LOG_REGION_ARP

EID 到 RLOC 的映射。

OT_LOG_REGION_BBR

Backbone Router(自 Thread 1.2 起提供)

OT_LOG_REGION_BR

边界路由器。

OT_LOG_REGION_CLI

CLI。

OT_LOG_REGION_COAP

CoAP

OT_LOG_REGION_CORE

OpenThread Core。

OT_LOG_REGION_DNS

DNS。

OT_LOG_REGION_DUA

域 Unicast 地址(从 Thread 1.2 开始提供)

OT_LOG_REGION_ICMP

ICMPv6。

OT_LOG_REGION_IP6

IPv6。

OT_LOG_REGION_MAC

IEEE 802.15.4 MAC。

OT_LOG_REGION_MEM

记忆。

OT_LOG_REGION_MESH_COP

网格调试协议。

OT_LOG_REGION_MLE

MLE。

OT_LOG_REGION_MLR

多播监听器注册(从 Thread 1.2 开始提供)

OT_LOG_REGION_NCP

NCP。

OT_LOG_REGION_NET_DATA

网络数据。

OT_LOG_REGION_NET_DIAG

网络诊断。

OT_LOG_REGION_PLATFORM

平台。

OT_LOG_REGION_SRP

服务注册协议 (SRP)

OT_LOG_REGION_TCP

TCP。

OT_LOG_REGION_UTIL

实用程序模块

类型定义符

otLogLevel

int otLogLevel

表示日志级别。

otLogRegion

enum otLogRegion otLogRegion

表示日志区域。

取消了对日志区域的支持,改为每个核心模块都可以定义自己的名称以附加到日志。不过,otLogRegion 枚举仍然像以前一样定义,以帮助一些平台可能在其 otPlatLog() 实现中使用此枚举。OT 核心将始终使用 OT_LOG_REGION_CORE 发出所有日志。

函数

otPlatLog

void otPlatLog(
  otLogLevel aLogLevel,
  otLogRegion aLogRegion,
  const char *aFormat,
  ...
)

输出日志。

请注意,不再支持日志区域。OT 核心将始终发出所有 OT_LOG_REGION_COREaLogRegion 的日志。

具体说明
参数
[in] aLogLevel
日志级别。
[in] aLogRegion
日志区域。
[in] aFormat
指向格式字符串的指针。
[in] ...
表示格式规范的参数。

otPlatLogHandleLevelChanged

void otPlatLogHandleLevelChanged(
  otLogLevel aLogLevel
)

处理 OpenThread 日志级别更改。

每当 OpenThread 日志级别发生变化时,系统都会调用此平台函数。此平台函数是可选的,因为提供的是空的弱实现。

具体说明
参数
[in] aLogLevel
新的 OpenThread 日志级别。

OT_LOG_LEVEL_CRIT

 OT_LOG_LEVEL_CRIT 1

日志级别:严重。

OT_LOG_LEVEL_DEBG

 OT_LOG_LEVEL_DEBG 5

日志级别调试。

OT_LOG_LEVEL_INFO

 OT_LOG_LEVEL_INFO 4

日志级别信息。

OT_LOG_LEVEL_NONE

 OT_LOG_LEVEL_NONE 0

日志级别“无”。

OT_LOG_LEVEL_NOTE

 OT_LOG_LEVEL_NOTE 3

日志级通知。

OT_LOG_LEVEL_WARN

 OT_LOG_LEVEL_WARN 2

日志级别警告。

资源

OpenThread API 参考文档源自 GitHub 上提供的源代码。如需了解详情,或者为我们的文档做贡献,请参阅资源