Trình theo dõi nhật ký

Ghi lại nhật ký của nhiều sự kiện, ví dụ như 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 nhập được theo dõi đều có dấu thời gian.

Các hàm trong mô-đun này có sẵn khi bạn bật OPENTHREAD_CONFIG_HISTORY_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
Các hằng số biểu thị 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
Xác định các sự kiện cho thông tin địa chỉ IPv6 (unicast hoặc multicast) (tức là thông tin địa chỉ được thêm hay bị xoá).
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
Xác định các sự kiện trong thông tin lân cận (ví dụ:
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
} 		enum
Xác định sự kiện cho một mục Dữ liệu mạng (ví dụ: liệu một mục nhập được thêm hay bị xoá).
otHistoryTrackerRouterEvent{
  OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED = 2,
  OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED = 3
} 		enum
Xác định các sự kiện trong thông tin bộ định tuyến (chẳng hạn như

Typedef
otHistoryTrackerExternalRouteInfo typedef
Trình bày thông tin về tuyến đường bên ngoài Dữ liệu mạng.
otHistoryTrackerIterator typedef
Biểu thị một trình lặp để lặp lại qua danh sách nhật ký.
otHistoryTrackerMessageInfo typedef
Đại diện cho thông tin thông báo RX/TX IPv6.
otHistoryTrackerMulticastAddressInfo typedef
Biểu thị thông tin địa chỉ phát đa hướng IPv6.
otHistoryTrackerNeighborInfo typedef
Đại diện cho thông tin của người lân cận.
otHistoryTrackerNetworkInfo typedef
Đại diện cho thông tin mạng Thread.
otHistoryTrackerOnMeshPrefixInfo typedef
Biểu thị Dữ liệu mạng trên thông tin tiền tố lưới.
otHistoryTrackerRouterInfo typedef
Đại diện cho một sự kiện nhập bảng bộ định tuyến.
otHistoryTrackerUnicastAddressInfo typedef
Biểu thị thông tin địa chỉ IPv6 unicast.

Hàm
otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Chuyển đổi độ tuổi đã cho thành một chuỗi mà con người có thể đọc được.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
Khởi động một otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Lặp lại các mục nhập trong danh sách lịch sử mục nhập tuyến bên ngoài cho Dữ liệu mạng.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Lặp lại qua các mục trong danh sách nhật ký địa chỉ phát đa hướng.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
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)
Lặp lại qua các mục trong danh sách nhật ký thông tin mạng.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Lặp lại các mục trong Danh sách mục nhập tiền tố lưới trong Danh sách dữ liệu mạng.
otHistoryTrackerIterateRouterHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Lặp lại các mục trong danh sách nhật ký bộ định tuyến.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Lặp lại các mục trong danh sách nhật ký thông báo RX.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
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)
Lặp lại qua các mục trong danh sách nhật ký địa chỉ unicast.

Cấu trúc
otHistoryTrackerExternalRouteInfo

Trình bày thông tin về tuyến đường bên ngoài Dữ liệu mạng.

otHistoryTrackerIterator

Biểu thị một trình lặp để lặp lại qua danh sách nhật ký.

otHistoryTrackerMessageInfo

Đại diện cho thông tin thông báo RX/TX IPv6.

otHistoryTrackerMulticastAddressInfo

Biểu thị thông tin địa chỉ phát đa hướng IPv6.

otHistoryTrackerNeighborInfo

Đại diện cho thông tin của người lân cận.

otHistoryTrackerNetworkInfo

Đại diện cho thông tin mạng Thread.

otHistoryTrackerOnMeshPrefixInfo

Biểu thị Dữ liệu mạng trên thông tin tiền tố lưới.

otHistoryTrackerRouterInfo

Đại diện cho một sự kiện nhập bảng bộ định tuyến.

otHistoryTrackerUnicastAddressInfo

Biểu thị thông tin địa chỉ IPv6 unicast.

Bảng liệt kê

enum ẩn danh

 anonymous enum

Các hằng số biểu thị 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 chế độ Kiểm soát mạng.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

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

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

Xác định các sự kiện cho thông tin địa chỉ IPv6 (unicast hoặc multicast) (tức là thông tin địa chỉ được thêm hay bị xoá).

Thuộc tính
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Đã thêm địa chỉ.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

Đã xóa địa chỉ.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Xác định các sự kiện trong thông tin lân cận (ví dụ:

xem người lân cận được thêm, xoá hoặc thay đổi).

Sự kiện OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING chỉ áp dụng cho những trẻ lân cận là trẻ. Trạng thái 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 qua chế độ cài đặt bất biến, đồng thời thiết bị cố gắng khôi phục kết nối với các danh sách đó.

Thuộc tính
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

Đã thêm vùng lân cận.

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ị xoá.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

Thiết bị lân cận đang được khôi phục (chỉ áp dụng cho trẻ em).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Xác định sự kiện cho một mục Dữ liệu mạng (ví dụ: liệu một mục nhập được thêm hay bị xoá).

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

Đã xoá mục nhập dữ liệu mạng.

otHistoryTrackerRouterEvent

 otHistoryTrackerRouterEvent

Xác định các sự kiện trong thông tin bộ định tuyến (chẳng hạn như

thêm, xoá hay thay đổi bộ định tuyến).

Thuộc tính
OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED

Đã thêm bộ định tuyến (đã phân bổ mã bộ định tuyến).

OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED

Chi phí đường dẫn vào bộ định tuyến đã thay đổi (hop tiếp theo như trước).

OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED

hop tiếp theo và chi phí trong bộ định tuyến đã thay đổi.

OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED

Mục nhập bộ định tuyến đã bị xoá (đã giải phóng mã bộ định tuyến).

Typedef

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Trình bày thông tin về tuyến đường bên ngoài Dữ liệu mạng.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Biểu thị một trình lặp để lặp lại qua danh sách nhật ký.

Các trường trong loại này không rõ ràng (dành cho lõi OpenThread sử dụng) và do đó phương thức gọi không được truy cập/sử dụng.

Trước khi sử dụng trình lặp, PHẢI được khởi tạo bằng otHistoryTrackerInitIterator(),

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Đại diện cho thông tin thông báo RX/TX IPv6.

Một số trường trong cấu trúc này chỉ áp dụng 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ả khung mảnh tạo thành một thông báo đã nhận và chỉ áp dụng cho thông báo RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Biểu thị thông tin địa chỉ phát đa hướng IPv6.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Đại diện cho thông tin của người lân cận.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Đại diện cho thông tin mạng Thread.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

Biểu thị Dữ liệu mạng trên thông tin tiền tố lưới.

otHistoryTrackerRouterInfo

struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo

Đại diện cho một sự kiện nhập bảng bộ định tuyến.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Biểu thị thông tin địa chỉ IPv6 unicast.

Hàm

otHistoryTrackerEntryAgeToString

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

Chuyển đổi độ tuổi đã cho thành một chuỗi mà con người có thể đọc được.

Chuỗi độ tuổi mục nhập tuân 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 phạm vi aSize ký tự), thì chuỗi sẽ bị cắt bớt nhưng chuỗi được trả về sẽ luôn kết thúc rỗng.

Thông tin chi tiết
Các tham số
[in] aEntryAge
Độ tuổi truy cập (thời lượng tính bằng mili giây).
[out] aBuffer
Con trỏ đến một mảng char để xuất chuỗi (KHÔNG ĐƯỢC là NULL).
[in] aSize
Kích thước của aBuffer. Bạn nên dùng OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Khởi động một otHistoryTrackerIterator.

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

Bạn có thể khởi động lại một trình lặp lại để bắt đầu từ đầu danh sách.

Khi lặp lại qua 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 cung cấp tương ứng với thời gian khởi tạo trình lặp, tức là độ tuổi mục nhập được cung cấp dưới dạng khoảng thời gian (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 trình lặp.

Thông tin chi tiết
Các tham số
[in] aIterator
Một con trỏ tới trình lặp để khởi chạy (PHẢI KHÔNG là NULL).

otHistoryTrackerIterateExternalRouteHistory

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

Lặp lại các mục nhập trong danh sách lịch sử mục nhập tuyến bên ngoài cho Dữ liệu mạng.

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

otHistoryTrackerIterateMulticastAddressHistory

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

Lặp lại qua các mục trong danh sách nhật ký địa chỉ phát đa hướng.

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

otHistoryTrackerIterateNeighborHistory

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

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 tham số
[in] aInstance
Con trỏ đến thực thể OpenThread.
[in,out] aIterator
Con trỏ đến một biến lặp. PHẢI được khởi tạo hoặc hành vi không xác định.
[out] aEntryAge
Con trỏ đến một biến để trả về độ tuổi của mục nhập. KHÔNG ĐƯỢC là RỖNG. Độ tuổi được cung cấp dưới dạng khoảng thời gian (tính bằng mili giây) kể từ khi mục nhập được ghi lại đến thời gian khởi chạy aIterator. Thuộc tính này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập lớn hơn độ tuổi tối đa.
Trả về
Mục otHistoryTrackerNeighborInfo hoặc NULL nếu không có mục nào khác trong danh sách.

otHistoryTrackerIterateNetInfoHistory

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

Lặp lại qua các mục trong danh sách nhật ký thông tin mạng.

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

otHistoryTrackerIterateOnMeshPrefixHistory

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

Lặp lại các mục trong Danh sách mục nhập tiền tố lưới trong Danh sách dữ liệu mạng.

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

otHistoryTrackerIterateRouterHistory

const otHistoryTrackerRouterInfo * otHistoryTrackerIterateRouterHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

Lặp lại các mục trong danh sách nhật ký bộ định tuyến.

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

otHistoryTrackerIterateRxHistory

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

Lặp lại các mục trong danh sách nhật ký thông báo RX.

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

otHistoryTrackerIterateTxHistory

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

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 tham số
[in] aInstance
Con trỏ đến thực thể OpenThread.
[in,out] aIterator
Con trỏ đến một biến lặp. PHẢI được khởi tạo hoặc hành vi không xác định.
[out] aEntryAge
Con trỏ đến một biến để trả về độ tuổi của mục nhập. KHÔNG ĐƯỢC là RỖNG. Độ tuổi được cung cấp dưới dạng khoảng thời gian (tính bằng mili giây) kể từ khi mục nhập được ghi lại đến thời gian khởi chạy aIterator. Thuộc tính này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập lớn hơn độ tuổi tối đa.
Trả về
Mục otHistoryTrackerMessageInfo hoặc NULL nếu không có mục nào khác trong danh sách.

otHistoryTrackerIterateUnicastAddressHistory

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

Lặp lại qua các mục trong danh sách nhật ký địa chỉ unicast.

Thông tin chi tiết
Các tham số
[in] aInstance
Con trỏ đến thực thể OpenThread.
[in,out] aIterator
Con trỏ đến một biến lặp. PHẢI được khởi tạo hoặc hành vi không xác định.
[out] aEntryAge
Con trỏ đến một biến để trả về độ tuổi của mục nhập. KHÔNG ĐƯỢC là RỖNG. Độ tuổi được cung cấp dưới dạng khoảng thời gian (tính bằng mili giây) kể từ khi mục nhập được ghi lại đến thời gian khởi chạy aIterator. Thuộc tính này được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho các mục nhập lớn hơn độ tuổi tối đa.
Trả về
Con trỏ đến mục nhập otHistoryTrackerUnicastAddressInfo hoặc NULL nếu không có mục nhập 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 chuỗi đại diện của độ tuổi nhập.

OT_HISTORY_TRACKER_INFINITE_PATH_COST

 OT_HISTORY_TRACKER_INFINITE_PATH_COST 0

Chi phí đường dẫn vô hạn – được dùng trong otHistoryTrackerRouterInfo.

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 là 49 ngày (tính bằng mili giây).

Các mục nhập cũ hơn độ tuổi tối đa sẽ cung cấp giá trị này dưới dạng độ tuổi của chúng.

OT_HISTORY_TRACKER_NO_NEXT_HOP

 OT_HISTORY_TRACKER_NO_NEXT_HOP 63

Không có hop tiếp theo – Cho mNextHop tại otHistoryTrackerRouterInfo.

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.