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.

Công cụ theo dõi lịch sử

Ghi lại lịch sử của các sự kiện khác nhau, 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 đã theo dõi đều có dấu thời gian.

Các chức năng trong mô-đun này khả dụng khi OPENTHREAD_CONFIG_HISTOR_TRACKER_ENABLE được bật.

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ố đại diện cho mức độ ưu tiên của thông báo được sử dụng trong cấu trúc otHistoryTrackerMessageInfo.
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
}
enum
Việc liệt kê này xác định các sự kiện cho thông tin địa chỉ IPv6 (trung tính hoặc đa hướng) (tức là liệu địa chỉ được thêm hay bị 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
Giá trị liệt kê này 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
Giá trị 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 được thêm hay bị xóa).

Loại

otHistoryTrackerExternalRouteInfo typedef
Cấu trúc này thể hiện thông tin tuyến đường nâng cao Dữ liệu mạng.
otHistoryTrackerIterator typedef
Loại này thể hiện lặp lại thông qua danh sách lịch sử.
otHistoryTrackerMessageInfo typedef
Cấu trúc này thể hiện thông tin thông báo IPv6 RX/TX.
otHistoryTrackerMulticastAddressInfo typedef
Cấu trúc này thể hiện thông tin địa chỉ đa hướng IPv6.
otHistoryTrackerNeighborInfo typedef
Cấu trúc này thể hiện thông tin về vùng lân cận.
otHistoryTrackerNetworkInfo typedef
Cấu trúc này thể hiện thông tin về chuỗi chuỗi.
otHistoryTrackerOnMeshPrefixInfo typedef
Cấu trúc này đại diện cho Dữ liệu mạng trên thông tin tiền tố lưới.
otHistoryTrackerUnicastAddressInfo typedef
Cấu trúc này thể hiện 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 độ tuổi đã cho thành chuỗi mà người dùng có thể đọc được.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
Hàm này khởi chạy otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(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ử mục nhập tuyến đường bên ngoài của 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 nhập trong danh sách lịch sử của vùng lân cận.
otHistoryTrackerIterateNetInfoHistory(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ử 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 nhập trong danh sách lịch sử mục nhập tiền tố lưới trong Dữ liệu mạng.
otHistoryTrackerIterateRxHistory(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ử thông báo RX.
otHistoryTrackerIterateTxHistory(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ử 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 nhập trong danh sách lịch sử địa chỉ đơn giản.

Cấu trúc

otHistoryTrackerExternalTrackerInfo

Cấu trúc này thể hiện thông tin tuyến đường nâng cao Dữ liệu mạng.

otHistoryTrackerIterator

Loại này thể hiện lặp lại thông qua danh sách lịch sử.

otHistoryTrackerMessageInfo

Cấu trúc này thể hiện thông tin thông báo IPv6 RX/TX.

otHistoryTrackerMulticastAddressInfo

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

otHistoryTrackerNeighborInfo

Cấu trúc này thể hiện thông tin về vùng lân cận.

otHistoryTrackerNetworkInfo

Cấu trúc này thể hiện thông tin về chuỗi chuỗi.

otHistoryTrackerOnMeshPrefixInfo

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

otHistoryTrackerUnicastAddressInfo

Cấu trúc này thể hiện thông tin địa chỉ IPv6 đơn giản.

Bảng liệt kê

enum ẩn danh

 anonymous enum

Hằng số đại diện cho mức độ ưu tiên của thông báo được sử dụng trong cấu trúc otHistoryTrackerMessageInfo.

Tài sản
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 Kiểm soát mạng.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Mức độ ưu tiên thông thường.

otHistoryTrackerAddressAddress

 otHistoryTrackerAddressEvent

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

Tài sản
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Đã thêm địa chỉ.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

Địa chỉ này đã bị xóa.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Giá trị liệt kê này xác định các sự kiện trong thông tin lân cận (ví dụ:

liệu hàng xóm có được thêm, bị xóa hoặc được thay đổi hay không).

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

Tài sản
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

Hàng xóm đã bị xóa.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

Vùng lân cận đang được khôi phục (chỉ áp dụng cho trẻ em).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Giá trị 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 được thêm hay bị xóa).

Tài sản
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

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

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

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

Loại

otHistoryTrackerExternalTrackerInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Cấu trúc này thể hiện thông tin tuyến đường nâng cao Dữ liệu mạng.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Loại này thể hiện lặp lại thông qua danh sách lịch sử.

Các trường thuộc loại này bị mờ (dự kiến sẽ sử dụng trong lõi OpenThread) nên sẽ không được người gọi truy cập/sử dụng.

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

otHistoryTrackerMessageMessageThông tin

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Cấu trúc này thể hiện 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 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 phân đoạn tạo thành thông báo đã nhận và chỉ áp dụng cho thông báo RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

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

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Cấu trúc này thể hiện thông tin về vùng lân cận.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Cấu trúc này thể hiện thông tin về chuỗi chuỗi.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

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

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Cấu trúc này thể hiện thông tin địa chỉ IPv6 đơn giản.

Hàm

otNhậtTrackerTrackerEntryAgeToString

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

Hàm này chuyển đổi độ tuổi đã cho thành chuỗi mà người dùng có thể đọc được.

Chuỗi độ tuổi nhập sẽ có định dạng "::," cho giờ, phút, giây và mili giây (nếu ngắn hơn 1 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 trong aBuffer (trong aSize ký tự của chuỗi), thì chuỗi sẽ bị cắt bớt nhưng chuỗi đã xuất luôn bị rỗng.

Thông tin chi tiết
Thông số
[in] aEntryAge
Độ tuổi truy cậ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 be NULL).
[in] aSize
Kích thước của aBuffer. Bạn nên sử dụng OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Hàm này khởi chạy otHistoryTrackerIterator.

Phải lặp lại một biến lặp trước khi sử dụng.

Bạn có thể khởi chạy một biến lặp để bắt đầu lại từ đầu danh sách.

Khi lặp lại trên các mục nhập trong danh sách, để đảm bảo các độ tuổi mục nhập nhất quán, độ tuổi được đưa ra so với thời gian trình khởi tạo được khởi chạy, tức là độ tuổi mục 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 là vào thời gian khởi tạo biến lặp.

Thông tin chi tiết
Thông số
[in] aIterator
Con trỏ tới biến lặp để khởi chạy (MUST NOT NULL).

otHistoryTrackerIterateExternalVersionHistory

const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory(
  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ử mục nhập tuyến đường bên ngoài của Dữ liệu mạng.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
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
)

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
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
Con trỏ tới 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 nhập trong danh sách lịch sử của vùng lân cận.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
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
)

Hàm 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
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
Con trỏ tới 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 nhập trong danh sách lịch sử mục nhập tiền tố lưới trong Dữ liệu mạng.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
Mục otHistoryTrackerOnMeshPrefixInfo 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
)

Hàm này lặp lại các mục trong danh sách lịch sử thông báo RX.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
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
)

Hàm này lặp lại các mục trong danh sách lịch sử thông báo TX.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
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
)

Hàm này lặp lại các mục nhập trong danh sách lịch sử địa chỉ đơn giản.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến bản sao Openthread.
[in,out] aIterator
Con trỏ trỏ đến một 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ỏ tới một biến để xuất tuổi của mục nhập. MUST NOT be NULL. Độ tuổi được cung cấp dưới dạng thời lượng (tính bằng mili giây) kể từ khi ghi lại mục này cho đến thời gian khởi chạy aIterator. Chế độ này đã được đặt thành OT_HISTORY_TRACKER_MAX_AGE cho những mục cũ hơn độ tuổi tối đa.
Lấy lại được quyền truy cập
Con trỏ tới mục otHistoryTrackerUnicastAddressInfo hoặc NULL nếu không có mục nào khác trong danh sách.

Macro

OT_VIDEO_FOLLOWER_MERCHANT_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Kích thước đề xuất cho chuỗi đại diện cho độ tuổi mục nhập.

OT_VIDEO_FOLLOWER_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.

Nguồn lực

Các chủ đề trong API tham chiếu Openthread có nguồn gốc 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 phần Tài nguyên.