記錄 - 平台

這個模組包含偵錯記錄檔服務的平台抽象化機制。

摘要

列舉

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 }

列舉 代表記錄區域。

Typedefs
otLogLevel	typedef int 代表記錄層級。
otLogRegion	typedef enum otLogRegion 代表記錄區域。

函式
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	骨幹路由器 (自 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	公用程式模組

Typedefs

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_CORE 為 aLogRegion 的記錄。

詳細說明
參數	[in] aLogLevel 記錄層級。 [in] aLogRegion 記錄區域。 [in] aFormat 格式字串的指標。 [in] ... 格式規格的引數。

otPlatLogHandleLevelChanged

void otPlatLogHandleLevelChanged(
  otLogLevel aLogLevel
)

處理 OpenThread 記錄層級變更。

只要 OpenThread 記錄層級有所變更，就會呼叫這個平台函式。這個平台函式為選用項目，因為已提供空白的弱式實作。

注意：僅適用於 OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1 的情況。

詳細說明
參數	[in] aLogLevel 新的 OpenThread 記錄層級。

巨集

OT_LOG_LEVEL_CRIT

 OT_LOG_LEVEL_CRIT 1

記錄層級關鍵。

注意：記錄層級會定義，讓嵌入的實作可透過 #if/#else/#endif 在編譯時間排除程式碼。

OT_LOG_LEVEL_DEBG

 OT_LOG_LEVEL_DEBG 5

記錄層級偵錯。

注意：記錄層級會定義，讓嵌入的實作可透過 #if/#else/#endif 在編譯時間排除程式碼。

OT_LOG_LEVEL_INFO

 OT_LOG_LEVEL_INFO 4

記錄層級資訊。

注意：記錄層級會定義，讓嵌入的實作可透過 #if/#else/#endif 在編譯時間排除程式碼。

OT_LOG_LEVEL_NONE

 OT_LOG_LEVEL_NONE 0

記錄層級無。

注意：記錄層級會定義，讓嵌入的實作可透過 #if/#else/#endif 在編譯時間排除程式碼。

OT_LOG_LEVEL_NOTE

 OT_LOG_LEVEL_NOTE 3

記錄層級通知。

注意：記錄層級會定義，讓嵌入的實作可透過 #if/#else/#endif 在編譯時間排除程式碼。

OT_LOG_LEVEL_WARN

 OT_LOG_LEVEL_WARN 2

記錄層級警告。

注意：記錄層級會定義，讓嵌入的實作可透過 #if/#else/#endif 在編譯時間排除程式碼。

資源

OpenThread API 參考資料主題源自原始碼，請前往 GitHub 取得。如要瞭解詳情或對說明文件做出貢獻，請參閱資源。