otMacCounters

#include <link.h>

Đại diện cho bộ đếm lớp MAC.

Tóm tắt

Thuộc tính công khai

mRxAddressFiltered
uint32_t
Tổng số khung hình do mô-đun Bộ lọc MAC bỏ qua, ví dụ như số khung hình nhận được qua nút có trong danh sách từ chối.
mRxBeacon
uint32_t
Tổng số khung Báo hiệu MAC nhận được.
mRxBeaconRequest
uint32_t
Tổng số khung Yêu cầu báo hiệu MAC nhận được.
mRxBroadcast
uint32_t
Tổng số khung truyền hình nhận được.
mRxData
uint32_t
Tổng số khung Dữ liệu MAC đã nhận.
mRxDataPoll
uint32_t
Tổng số khung Cuộc thăm dò ý kiến dữ liệu MAC nhận được.
mRxDestAddrFiltered
uint32_t
Tổng số khung hình bị bỏ qua khi kiểm tra địa chỉ đích đến, ví dụ như khung đã nhận cho nút khác.
mRxDuplicated
uint32_t
Tổng số khung hình bị bỏ qua do trùng lặp, tức là khi khung hình đã được nhận.
mRxErrFcs
uint32_t
Tổng số khung hình bị giảm do FCS không hợp lệ.
mRxErrInvalidSrcAddr
uint32_t
Tổng số khung hình đã bị giảm do địa chỉ nguồn không hợp lệ.
mRxErrNoFrame
uint32_t
Tổng số khung hình đã bị giảm do thiếu nội dung hoặc nội dung không đúng định dạng.
mRxErrOther
uint32_t
Tổng số khung hình bị bỏ qua do lỗi khác.
mRxErrSec
uint32_t
Tổng số khung hình bị bỏ qua do lỗi bảo mật.
mRxErrUnknownNeighbor
uint32_t
Tổng số khung hình bị bỏ qua do thiết bị lân cận không xác định.
mRxOther
uint32_t
Tổng số các loại khung hình khác đã nhận.
mRxTotal
uint32_t
Tổng số khung hình đã nhận.
mRxUnicast
uint32_t
Tổng số khung unicast nhận được.
mTxAckRequested
uint32_t
Tổng số yêu cầu truyền khung MAC riêng biệt có xác nhận được yêu cầu.
mTxAcked
uint32_t
Tổng số yêu cầu truyền khung MAC riêng biệt đã được tiếp nhận.
mTxBeacon
uint32_t
Tổng số yêu cầu truyền khung Báo hiệu MAC riêng biệt.
mTxBeaconRequest
uint32_t
Tổng số yêu cầu truyền khung Yêu cầu báo hiệu MAC riêng biệt.
mTxBroadcast
uint32_t
Tổng số yêu cầu truyền khung MAC phát sóng riêng biệt.
mTxData
uint32_t
Tổng số yêu cầu truyền khung Dữ liệu MAC riêng biệt.
mTxDataPoll
uint32_t
Tổng số yêu cầu truyền khung Cuộc thăm dò dữ liệu MAC duy nhất.
mTxDirectMaxRetryExpiry
uint32_t
Tổng số gói truyền MAC riêng biệt đáp ứng giới hạn thử lại tối đa đối với các gói trực tiếp.
mTxErrAbort
uint32_t
Tổng số lần yêu cầu truyền MAC duy nhất không thành công do lỗi huỷ gây ra.
mTxErrBusyChannel
uint32_t
Tổng số yêu cầu truyền MAC riêng biệt không thành công do một kênh bận gây ra (không thành công CSMA/CA).
mTxErrCca
uint32_t
Tổng số lỗi CCA.
mTxIndirectMaxRetryExpiry
uint32_t
Tổng số gói truyền MAC riêng biệt đáp ứng giới hạn thử lại tối đa đối với các gói gián tiếp.
mTxNoAckRequested
uint32_t
Tổng số yêu cầu truyền khung MAC riêng biệt mà không xác nhận.
mTxOther
uint32_t
Tổng số yêu cầu truyền khung MAC riêng biệt khác.
mTxRetry
uint32_t
Tổng số lần truyền lại MAC.
mTxTotal
uint32_t
Tổng số yêu cầu truyền khung MAC riêng biệt.
mTxUnicast
uint32_t
Tổng số yêu cầu truyền khung MAC đơn hướng riêng biệt.

Thuộc tính công khai

mRxAddressFiltered

uint32_t otMacCounters::mRxAddressFiltered

Tổng số khung hình do mô-đun Bộ lọc MAC bỏ qua, ví dụ như số khung hình nhận được qua nút có trong danh sách từ chối.

mRxBeacon

uint32_t otMacCounters::mRxBeacon

Tổng số khung Báo hiệu MAC nhận được.

mRxBeaconRequest

uint32_t otMacCounters::mRxBeaconRequest

Tổng số khung Yêu cầu báo hiệu MAC nhận được.

mRxBroadcast

uint32_t otMacCounters::mRxBroadcast

Tổng số khung truyền hình nhận được.

mRxData

uint32_t otMacCounters::mRxData

Tổng số khung Dữ liệu MAC đã nhận.

mRxDataPoll

uint32_t otMacCounters::mRxDataPoll

Tổng số khung Cuộc thăm dò ý kiến dữ liệu MAC nhận được.

mRxDestAddrFiltered

uint32_t otMacCounters::mRxDestAddrFiltered

Tổng số khung hình bị bỏ qua khi kiểm tra địa chỉ đích đến, ví dụ như khung đã nhận cho nút khác.

mRxDuplicated

uint32_t otMacCounters::mRxDuplicated

Tổng số khung hình bị bỏ qua do trùng lặp, tức là khi khung hình đã được nhận.

Bộ đếm này có thể tăng lên, ví dụ như khi khung ACK do bộ thu tạo ra chưa đến nút bộ phát đã thực hiện việc truyền tải lại.

mRxErrFcs

uint32_t otMacCounters::mRxErrFcs

Tổng số khung hình bị giảm do FCS không hợp lệ.

mRxErrInvalidSrcAddr

uint32_t otMacCounters::mRxErrInvalidSrcAddr

Tổng số khung hình đã bị giảm do địa chỉ nguồn không hợp lệ.

mRxErrNoFrame

uint32_t otMacCounters::mRxErrNoFrame

Tổng số khung hình đã bị giảm do thiếu nội dung hoặc nội dung không đúng định dạng.

mRxErrOther

uint32_t otMacCounters::mRxErrOther

Tổng số khung hình bị bỏ qua do lỗi khác.

mRxErrSec

uint32_t otMacCounters::mRxErrSec

Tổng số khung hình bị bỏ qua do lỗi bảo mật.

Bộ đếm này có thể tăng lên, ví dụ như khi Bộ đếm khung hình thấp hơn dự kiến được dùng để mã hoá khung.

mRxErrUnknownNeighbor

uint32_t otMacCounters::mRxErrUnknownNeighbor

Tổng số khung hình bị bỏ qua do thiết bị lân cận không xác định.

mRxOther

uint32_t otMacCounters::mRxOther

Tổng số các loại khung hình khác đã nhận.

mRxTotal

uint32_t otMacCounters::mRxTotal

Tổng số khung hình đã nhận.

Bộ đếm này tính tất cả khung hình do trình điều khiển vô tuyến của nền tảng báo cáo, bao gồm cả những khung hình bị bỏ đi (ví dụ: do lỗi FCS).

mRxUnicast

uint32_t otMacCounters::mRxUnicast

Tổng số khung unicast nhận được.

mTxAckRequested

uint32_t otMacCounters::mTxAckRequested

Tổng số yêu cầu truyền khung MAC riêng biệt có xác nhận được yêu cầu.

mTxAcked

uint32_t otMacCounters::mTxAcked

Tổng số yêu cầu truyền khung MAC riêng biệt đã được tiếp nhận.

mTxBeacon

uint32_t otMacCounters::mTxBeacon

Tổng số yêu cầu truyền khung Báo hiệu MAC riêng biệt.

mTxBeaconRequest

uint32_t otMacCounters::mTxBeaconRequest

Tổng số yêu cầu truyền khung Yêu cầu báo hiệu MAC riêng biệt.

mTxBroadcast

uint32_t otMacCounters::mTxBroadcast

Tổng số yêu cầu truyền khung MAC phát sóng riêng biệt.

mTxData

uint32_t otMacCounters::mTxData

Tổng số yêu cầu truyền khung Dữ liệu MAC riêng biệt.

mTxDataPoll

uint32_t otMacCounters::mTxDataPoll

Tổng số yêu cầu truyền khung Cuộc thăm dò dữ liệu MAC duy nhất.

mTxDirectMaxRetryExpiry

uint32_t otMacCounters::mTxDirectMaxRetryExpiry

Tổng số gói truyền MAC riêng biệt đáp ứng giới hạn thử lại tối đa đối với các gói trực tiếp.

mTxErrAbort

uint32_t otMacCounters::mTxErrAbort

Tổng số lần yêu cầu truyền MAC duy nhất không thành công do lỗi huỷ gây ra.

mTxErrBusyChannel

uint32_t otMacCounters::mTxErrBusyChannel

Tổng số yêu cầu truyền MAC riêng biệt không thành công do một kênh bận gây ra (không thành công CSMA/CA).

mTxErrCca

uint32_t otMacCounters::mTxErrCca

Tổng số lỗi CCA.

Ý nghĩa của bộ đếm này có thể khác nhau và tuỳ thuộc vào khả năng điều khiển vô tuyến của nền tảng.

Nếu bạn bật chế độ OT_RADIO_CAPS_CSMA_BACKOFF, thì bộ đếm này thể hiện tổng số lần gửi CSMA/CA không thành công đầy đủ và mỗi lần truyền lại sẽ tăng thêm một lần (trong trường hợp CSMA/CA không thành công).

Nếu bạn bật chế độ OT_RADIO_CAPS_TRANSMIT_RETRIES, thì bộ đếm này thể hiện tổng số lần gửi CSMA/CA không thành công đầy đủ và số lần truy cập sẽ tăng thêm 1 lần cho mỗi yêu cầu khung dữ liệu riêng lẻ (bất kể số lần truyền lại).

mTxIndirectMaxRetryExpiry

uint32_t otMacCounters::mTxIndirectMaxRetryExpiry

Tổng số gói truyền MAC riêng biệt đáp ứng giới hạn thử lại tối đa đối với các gói gián tiếp.

mTxNoAckRequested

uint32_t otMacCounters::mTxNoAckRequested

Tổng số yêu cầu truyền khung MAC riêng biệt mà không xác nhận.

mTxOther

uint32_t otMacCounters::mTxOther

Tổng số yêu cầu truyền khung MAC riêng biệt khác.

Bộ đếm này hiện được dùng để đếm các khung hình ngoài băng tần.

mTxRetry

uint32_t otMacCounters::mTxRetry

Tổng số lần truyền lại MAC.

Xin lưu ý rằng bộ đếm này sẽ tăng thêm một đơn vị cho mỗi lần truyền lại mà có thể được kích hoạt do thiếu xác nhận, lỗi CSMA/CA hoặc một loại lỗi truyền dẫn khác. Bộ đếm mTxRetry được tăng lên cho cả khung unicast và MAC truyền tin.

Sửa đổi các thông số cấu hình sau để kiểm soát số lượt truyền lại trong hệ thống:

  • OPENTHREAD_CONFIG_MAC_DEFAULT_MAX_FRAME_RETRIES_DIRECT
  • OPENTHREAD_CONFIG_MAC_DEFAULT_MAX_FRAME_RETRIES_INDIRECT
  • OPENTHREAD_CONFIG_MAC_TX_NUM_BCAST
  • OPENTHREAD_CONFIG_MAC_MAX_CSMA_BACKOFFS_DIRECT
  • OPENTHREAD_CONFIG_MAC_MAX_CSMA_BACKOFFS_INDIRECT

Hiện tại, bộ đếm này không hợp lệ nếu chức năng trình điều khiển vô tuyến của nền tảng bao gồm OT_RADIO_CAPS_TRANSMIT_RETRIES.

mTxTotal

uint32_t otMacCounters::mTxTotal

Tổng số yêu cầu truyền khung MAC riêng biệt.

Xin lưu ý rằng bộ đếm này chỉ tăng lên một lần đối với mỗi yêu cầu truyền MAC, bất kể số lần CCA không thành công, số lần xác minh CSMA-CA hay số lần truyền lại.

Quy tắc tăng này áp dụng cho các bộ đếm sau:

  • mTxUnicast
  • mTxBroadcast
  • mTxAckRequested
  • mTxNoAckRequested
  • mTxData
  • mTxDataPoll
  • mTxBeacon
  • mTxBeaconRequest
  • mTxOther
  • mTxErrAbort
  • mTxErrBusyChannel

Các phương trình sau đây hợp lệ:

  • mTxTotal = mTxUnicast + mTxBroadcast
  • mTxTotal = mTxAckRequested + mTxNoAckRequested
  • mTxTotal = mTxData + mTxDataPoll + mTxBeacon + mTxBeaconRequest + mTxOther

mTxUnicast

uint32_t otMacCounters::mTxUnicast

Tổng số yêu cầu truyền khung MAC đơn hướng riêng biệt.

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.