Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Trình theo dõi lịch sử

Ghi lại lịch sử của các sự kiện khác nhau, ví dụ: thông báo RX và TX hoặc thay đổi thông tin mạng.

Tóm tắt

Tất cả các mục đã theo dõi đều có dấu thời gian.

Các hàm trong mô-đun này sẽ dùng được khi bạn bật OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE.

Bảng liệt kê

anonymous enum{
  OT_HISTORY_TRACKER_MSG_PRIORITY_LOW = OT_MESSAGE_PRIORITY_LOW,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL = OT_MESSAGE_PRIORITY_NORMAL,
  OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH = OT_MESSAGE_PRIORITY_HIGH,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NET = OT_MESSAGE_PRIORITY_HIGH + 1
}
enum
Hằng số thể hiện mức độ ưu tiên của thông báo được dùng trong cấu trúc otHistoryTrackerMessageInfo.
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
enum
Bảng liệt kê này xác định các sự kiện cho thông tin địa chỉ IPv6 (unicast hoặc đa hướng) (tức là xem địa chỉ được thêm hay xóa).
otHistoryTrackerNeighborEvent{
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED = 2,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING = 3
}
enum
Bảng liệt kê này xác định các sự kiện trong thông tin vùng lân cận (tức là
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
}
enum
Bảng liệt kê này xác định các sự kiện cho một mục Dữ liệu mạng (tức là liệu một mục nhập được thêm hay xóa).

Typedef

otHistoryTrackerExternalRouteInfo typedef
Cấu trúc này đại diện cho thông tin tuyến đường bên ngoài về Dữ liệu mạng.
otHistoryTrackerIterator typedef
Loại này đại diện cho biến thể lặp lại theo danh sách lịch sử.
otHistoryTrackerMessageInfo typedef
Cấu trúc này đại diện cho thông tin thông báo IPv6 RX/TX.
otHistoryTrackerMulticastAddressInfo typedef
Cấu trúc này đại diện cho thông tin địa chỉ đa hướng IPv6.
otHistoryTrackerNeighborInfo typedef
Cấu trúc này đại diện cho thông tin của hàng xóm.
otHistoryTrackerNetworkInfo typedef
Cấu trúc này đại diện cho thông tin mạng Thread.
otHistoryTrackerOnMeshPrefixInfo typedef
Cấu trúc này đại diện cho Dữ liệu mạng trên thông tin về tiền tố lưới.
otHistoryTrackerUnicastAddressInfo typedef
Cấu trúc này đại diện cho một thông tin địa chỉ IPv6 đơn giản.

Hàm

otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Hàm này chuyển đổi một độ tuổi đã nhập thành một chuỗi mà con người có thể đọc được.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
Hàm này sẽ chạy một otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Chức năng này lặp lại các mục trong danh sách lịch sử mục nhập tuyến đường bên ngoài trong Dữ liệu mạng.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Hàm này lặp lại các mục trong danh sách lịch sử địa chỉ đa hướng.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Hàm này lặp lại các mục trong danh sách lịch sử lân cận.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Chức năng này lặp lại các mục trong danh sách lịch sử thông tin mạng.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Hàm này lặp lại các mục trong Dữ liệu mạng trên danh sách lịch sử nhập tiền tố mạng lưới.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Chức năng này lặp lại các mục trong danh sách nhật ký tin nhắn RX.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Chức năng này lặp lại các mục trong danh sách nhật ký thông báo TX.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Hàm này lặp lại các mục trong danh sách lịch sử địa chỉ unicast.

Cấu trúc

otHistoryTrackerExternal ngoàiInfo

Cấu trúc này đại diện cho thông tin tuyến đường bên ngoài về Dữ liệu mạng.

otHistoryTrackerIterator

Loại này đại diện cho biến thể lặp lại theo danh sách lịch sử.

otHistoryTrackerMessageInfo

Cấu trúc này đại diện cho thông tin thông báo IPv6 RX/TX.

otHistoryTracker MulticastAddressInfo

Cấu trúc này đại diện cho thông tin địa chỉ đa hướng IPv6.

otHistoryTrackerNeighborInfo

Cấu trúc này đại diện cho thông tin của hàng xóm.

otHistoryTrackerNetworkInfo

Cấu trúc này đại diện cho thông tin mạng Thread.

otHistoryTrackerOnMeshprefixInfo

Cấu trúc này đại diện cho Dữ liệu mạng trên thông tin về tiền tố lưới.

otHistoryTrackerUnicastAddressInfo

Cấu trúc này đại diện cho một thông tin địa chỉ IPv6 đơn giản.

Bảng liệt kê

enum ẩn danh

 anonymous enum

Hằng số thể hiện mức độ ưu tiên của thông báo được dùng trong cấu trúc otHistoryTrackerMessageInfo.

Thuộc tính
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

Mức độ ưu tiên cao.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

Mức độ ưu tiên thấp.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

Mức độ ưu tiên của tùy chọn kiểm soát mạng.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Mức độ ưu tiên bình thường.

otHistoryTrackerAddressEventEvent

 otHistoryTrackerAddressEvent

Bảng liệt kê này xác định các sự kiện cho thông tin địa chỉ IPv6 (unicast hoặc đa hướng) (tức là xem địa chỉ được thêm hay xóa).

Thuộc tính
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Đã thêm địa chỉ.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

Địa chỉ đã bị xóa.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Bảng liệt kê này xác định các sự kiện trong thông tin vùng lân cận (tức là

cho dù người lân cận được thêm, bị xóa hoặc thay đổi).

Sự kiện OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING chỉ áp dụng cho trẻ em thân thiết. Chế độ này được kích hoạt sau khi thiết bị khởi động lại và khi danh sách con trước đó được truy xuất từ chế độ cài đặt không biến động và thiết bị sẽ cố gắng khôi phục kết nối với các thiết bị đó.

Thuộc tính
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

Đã thêm hàng xóm.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

Vùng lân cận đã thay đổi (ví dụ: cờ chế độ thiết bị đã thay đổi).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

Vùng lân cận đã bị xóa.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

Đang khôi phục hàng xóm (chỉ áp dụng cho trẻ em).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Bảng liệt kê này xác định các sự kiện cho một mục Dữ liệu mạng (tức là liệu một mục nhập được thêm hay xóa).

Thuộc tính
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

Đã thêm mục dữ liệu mạng.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

Đã xóa mục dữ liệu mạng.

Typedef

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Cấu trúc này đại diện cho thông tin tuyến đường bên ngoài về Dữ liệu mạng.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Loại này đại diện cho biến thể lặp lại theo danh sách lịch sử.

Các trường trong loại này được làm mờ (dự định để sử dụng trong lõi OpenThread) và do đó người dùng không nên truy cập/sử dụng các trường này.

Trước khi sử dụng biến lặp, bạn phải khởi tạo biến này bằng otHistoryTrackerInitIterator(),

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Cấu trúc này đại diện cho thông tin thông báo IPv6 RX/TX.

Một số trường trong cấu trúc này chỉ áp dụng được cho thông báo RX hoặc thông báo TX (ví dụ: mAveRxRss là RSS trung bình của tất cả các khung mảnh tạo nên một thông báo đã nhận và chỉ áp dụng cho một thông báo RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Cấu trúc này đại diện cho thông tin địa chỉ đa hướng IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Cấu trúc này đại diện cho thông tin của hàng xóm.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Cấu trúc này đại diện cho thông tin mạng Thread.

otHistoryTrackerOnMeshprefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

Cấu trúc này đại diện cho Dữ liệu mạng trên thông tin về tiền tố lưới.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Cấu trúc này đại diện cho một thông tin địa chỉ IPv6 đơn giản.

Hàm

otHistoryTrackerentryAgeToString

void otHistoryTrackerEntryAgeToString(
  uint32_t aEntryAge,
  char *aBuffer,
  uint16_t aSize
)

Hàm này chuyển đổi một độ tuổi đã nhập thành một chuỗi mà con người có thể đọc được.

Chuỗi tuổi nhập sau theo định dạng "::." cho giờ, phút, giây và mili giây (nếu ngắn hơn một ngày) hoặc "

ngày ::." (nếu dài hơn một ngày).

Nếu chuỗi kết quả không vừa với aBuffer (trong aSize ký tự), thì chuỗi sẽ bị cắt bớt nhưng chuỗi được xuất sẽ luôn bị chấm dứt do không có giá trị.

Thông tin chi tiết
Các thông số
[in] aEntryAge
Độ tuổi nhập (thời lượng tính bằng msec).
[out] aBuffer
Con trỏ đến một mảng ký tự để xuất chuỗi (MUST NOT là NULL).
[in] aSize
Kích thước của aBuffer. Khuyên dùng OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Hàm này sẽ chạy một otHistoryTrackerIterator.

Một biến lặp PHẢI được khởi tạo trước khi sử dụng.

Có thể khởi tạo lại biến lặp để bắt đầu từ đầu danh sách.

Khi lặp lại các mục nhập trong một danh sách, để đảm bảo độ tuổi của mục nhập nhất quán, độ tuổi được chọn tương ứng với thời gian khởi tạo biến, tức là tuổi nhập được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ sự kiện (khi mục nhập được ghi lại) đến thời gian khởi tạo biến.

Thông tin chi tiết
Các thông số
[in] aIterator
Con trỏ đến biến lặp để khởi tạo (MUST NOT là NULL).

otHistoryTrackerIterateExternalRouteHistory

const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Chức năng này lặp lại các mục trong danh sách lịch sử mục nhập tuyến đường bên ngoài trong Dữ liệu mạng.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Mục nhập otHistoryTrackerExternalRouteInfo hoặc NULL nếu không có mục nhập nào khác trong danh sách.

otHistoryTrackerIterateMulticastAddressHistory

const otHistoryTrackerMulticastAddressInfo * otHistoryTrackerIterateMulticastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Hàm này lặp lại các mục trong danh sách lịch sử địa chỉ đa hướng.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Con trỏ đến mục otHistoryTrackerMulticastAddressInfo hoặc NULL nếu không có mục nào khác trong danh sách.

otHistoryTrackerIterateNeighborHistory

const otHistoryTrackerNeighborInfo * otHistoryTrackerIterateNeighborHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Hàm này lặp lại các mục trong danh sách lịch sử lân cận.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Mục nhập otHistoryTrackerNeighborInfo hoặc NULL nếu không có mục nhập nào khác trong danh sách.

otHistoryTrackerIterateNetInfoHistory

const otHistoryTrackerNetworkInfo * otHistoryTrackerIterateNetInfoHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Chức năng này lặp lại các mục trong danh sách lịch sử thông tin mạng.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Con trỏ đến mục otHistoryTrackerNetworkInfo hoặc NULL nếu không có mục nào khác trong danh sách.

otHistoryTrackerIterateOnMeshprefixHistory

const otHistoryTrackerOnMeshPrefixInfo * otHistoryTrackerIterateOnMeshPrefixHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Hàm này lặp lại các mục trong Dữ liệu mạng trên danh sách lịch sử nhập tiền tố mạng lưới.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Mục nhập otHistoryTrackerOnMeshPrefixInfo hoặc NULL nếu không có mục nhập nào khác trong danh sách.

otHistoryTrackerIterateRxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateRxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Chức năng này lặp lại các mục trong danh sách nhật ký tin nhắn RX.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Mục nhập otHistoryTrackerMessageInfo hoặc NULL nếu không có mục nhập nào khác trong danh sách.

otHistoryTrackerIterateTxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateTxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Chức năng này lặp lại các mục trong danh sách nhật ký thông báo TX.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Mục nhập otHistoryTrackerMessageInfo hoặc NULL nếu không có mục nhập nào khác trong danh sách.

otHistoryTrackerIterateUnicastAddressHistory

const otHistoryTrackerUnicastAddressInfo * otHistoryTrackerIterateUnicastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Hàm này lặp lại các mục trong danh sách lịch sử địa chỉ unicast.

Thông tin chi tiết
Các thông số
[in] aInstance
Con trỏ tới phiên bản OpenThread.
[in,out] aIterator
Con trỏ đến biến lặp. PHẢI được khởi tạo hoặc hành vi không được xác định.
[out] aEntryAge
Con trỏ đến một biến để xuất độ tuổi của mục nhập. KHÔNG PHẢI là NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) từ khi mục nhập được ghi lại đến thời gian khởi tạo aIterator. Giá trị này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập cũ hơn độ tuổi tối đa.
Trả về
Con trỏ đến mục otHistoryTrackerUnicastAddressInfo hoặc NULL nếu không có mục nào khác trong danh sách.

Macro

OT_HISTORY_TRACKER_entry_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Kích thước đề xuất cho biểu diễn chuỗi của độ tuổi nhập.

OT_HISTORY_TRACKER_MAX_AGE

 OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)

Hằng số này chỉ định độ tuổi tối đa của các mục nhập là 49 ngày (tính bằng msec).

Các mục nhập cũ hơn độ tuổi tối đa sẽ cung cấp giá trị này làm độ tuổi.

Tài nguyên

Các chủ đề về Tham chiếu API OpenThread được tạo từ mã nguồn, có sẵn 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 phần Tài nguyên.