Ghi nhật ký – Nền tảng

Mô-đun này bao gồm tính năng tóm tắt nền tảng cho dịch vụ nhật ký gỡ lỗi.

Tóm tắt

Bảng liệt kê

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
}
enum
Đại diện cho các vùng trong nhật ký.

Typedef

otLogLevel typedef
int
Đại diện cho cấp độ nhật ký.
otLogRegion typedef
Đại diện cho các vùng trong nhật ký.

Hàm

otPlatLog(otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aFormat, ...)
void
Nhật ký đầu ra.
otPlatLogHandleLevelChanged(otLogLevel aLogLevel)
void
Xử lý các thay đổi về cấp độ nhật ký OpenThread.

Bảng liệt kê

otLogRegion

 otLogRegion

Đại diện cho các vùng trong nhật ký.

Tính năng hỗ trợ vùng nhật ký sẽ bị xoá. Thay vào đó, mỗi mô-đun cốt lõi có thể tự xác định tên riêng của mình để thêm vào nhật ký. Tuy nhiên, cách liệt kê otLogRegion vẫn được định nghĩa như trước đây để hỗ trợ các nền tảng mà chúng ta có thể dùng trong quá trình triển khai otPlatLog(). Lõi OT sẽ luôn phát ra mọi nhật ký có OT_LOG_REGION_CORE.

Thuộc tính
OT_LOG_REGION_API

API OpenThread.

OT_LOG_REGION_ARP

Liên kết EID đến RLOC.

OT_LOG_REGION_BBR

Bộ định tuyến xương sống (hoạt động kể từ Thread 1.2)

OT_LOG_REGION_BR

Bộ định tuyến biên.

OT_LOG_REGION_CLI

CLI.

OT_LOG_REGION_COAP

CoAP.

OT_LOG_REGION_CORE

Lõi OpenThread.

OT_LOG_REGION_DNS

DNS.

OT_LOG_REGION_DUA

Địa chỉ miền Unicast (có từ Thread 1.2)

OT_LOG_REGION_ICMP

ICMP phiên bản 6.

OT_LOG_REGION_IP6

IPv6.

OT_LOG_REGION_MAC

IEEE 802.15.4 MAC.

OT_LOG_REGION_MEM

Bộ nhớ.

OT_LOG_REGION_MESH_COP

Giao thức uỷ quyền lưới.

OT_LOG_REGION_MLE

MLE.

OT_LOG_REGION_MLR

Đăng ký trình nghe Multicast (có sẵn kể từ Luồng 1.2)

OT_LOG_REGION_NCP

NCP.

OT_LOG_REGION_NET_DATA

Dữ liệu mạng.

OT_LOG_REGION_NET_DIAG

Chẩn đoán mạng.

OT_LOG_REGION_PLATFORM

Nền tảng.

OT_LOG_REGION_SRP

Giao thức đăng ký dịch vụ (SRP)

OT_LOG_REGION_TCP

TCP.

OT_LOG_REGION_UTIL

Mô-đun tiện ích.

Typedef

otLogLevel

int otLogLevel

Đại diện cho cấp độ nhật ký.

otLogRegion

enum otLogRegion otLogRegion

Đại diện cho các vùng trong nhật ký.

Tính năng hỗ trợ vùng nhật ký sẽ bị xoá. Thay vào đó, mỗi mô-đun cốt lõi có thể tự xác định tên riêng của mình để thêm vào nhật ký. Tuy nhiên, cách liệt kê otLogRegion vẫn được định nghĩa như trước đây để hỗ trợ các nền tảng mà chúng ta có thể dùng trong quá trình triển khai otPlatLog(). Lõi OT sẽ luôn phát ra mọi nhật ký có OT_LOG_REGION_CORE.

Hàm

otPlatLog

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

Nhật ký đầu ra.

Lưu ý rằng tính năng hỗ trợ vùng nhật ký sẽ bị xoá. Lõi OT sẽ luôn phát ra mọi nhật ký có OT_LOG_REGION_CORE dưới dạng aLogRegion.

Thông tin chi tiết
Các tham số
[in] aLogLevel
Cấp độ nhật ký.
[in] aLogRegion
Khu vực nhật ký.
[in] aFormat
Con trỏ đến chuỗi định dạng.
[in] ...
Đối số cho thông số kỹ thuật về định dạng.

otPlatLogHandleLevelChanged

void otPlatLogHandleLevelChanged(
  otLogLevel aLogLevel
)

Xử lý các thay đổi về cấp độ nhật ký OpenThread.

Hàm nền tảng này được gọi mỗi khi cấp độ nhật ký OpenThread thay đổi. Hàm nền tảng này là không bắt buộc vì bạn đã cung cấp một cấu hình triển khai yếu và trống.

Thông tin chi tiết
Các tham số
[in] aLogLevel
Cấp độ nhật ký OpenThread mới.

Macro

OT_LOG_LEVEL_CRIT

 OT_LOG_LEVEL_CRIT 1

Cấp độ nhật ký là Quan trọng.

OT_LOG_LEVEL_DEBG

 OT_LOG_LEVEL_DEBG 5

Gỡ lỗi ở cấp độ nhật ký.

OT_LOG_LEVEL_INFO

 OT_LOG_LEVEL_INFO 4

Cung cấp thông tin ở cấp độ nhật ký.

OT_LOG_LEVEL_NONE

 OT_LOG_LEVEL_NONE 0

Cấp độ nhật ký là Không.

OT_LOG_LEVEL_NOTE

 OT_LOG_LEVEL_NOTE 3

Thông báo về cấp độ nhật ký.

OT_LOG_LEVEL_WARN

 OT_LOG_LEVEL_WARN 2

Cảnh báo ở cấp độ nhật ký.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có trên GitHub. Để biết thêm thông tin hoặc để đóng góp cho tài liệu của chúng tôi, hãy tham khảo Tài nguyên.