otMacCounters

#include <link.h>

แสดงตัวนับเลเยอร์ MAC

สรุป

แอตทริบิวต์สาธารณะ

mRxAddressFiltered
uint32_t
จำนวนเฟรมทั้งหมดที่โมดูลตัวกรอง MAC ลด ตัวอย่างเช่น ได้รับจากโหนดในรายการที่ปฏิเสธ
mRxBeacon
uint32_t
จำนวนเฟรมบีคอน MAC ทั้งหมดที่ได้รับ
mRxBeaconRequest
uint32_t
จำนวนเฟรมคำขอบีคอน MAC ทั้งหมดที่ได้รับ
mRxBroadcast
uint32_t
จำนวนเฟรมของการออกอากาศทั้งหมดที่ได้รับ
mRxData
uint32_t
จำนวนเฟรมข้อมูล MAC ทั้งหมดที่ได้รับ
mRxDataPoll
uint32_t
จำนวนเฟรมแบบสำรวจข้อมูล MAC ทั้งหมดที่ได้รับ
mRxDestAddrFiltered
uint32_t
จำนวนเฟรมทั้งหมดที่ลดจากการตรวจสอบที่อยู่ปลายทาง เช่น เฟรมที่ได้รับสำหรับโหนดอื่น
mRxDuplicated
uint32_t
จำนวนเฟรมทั้งหมดที่ถูกตัดออกเนื่องจากการทำซ้ำ ซึ่งก็คือเมื่อได้รับเฟรมแล้ว
mRxErrFcs
uint32_t
จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจาก FCS ไม่ถูกต้อง
mRxErrInvalidSrcAddr
uint32_t
จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากที่อยู่ต้นทางไม่ถูกต้อง
mRxErrNoFrame
uint32_t
จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากเนื้อหาขาดหายไปหรือมีรูปแบบไม่ถูกต้อง
mRxErrOther
uint32_t
จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากข้อผิดพลาดอื่น
mRxErrSec
uint32_t
จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากข้อผิดพลาดด้านความปลอดภัย
mRxErrUnknownNeighbor
uint32_t
จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากไม่ทราบเพื่อนบ้าน
mRxOther
uint32_t
จำนวนเฟรมประเภทอื่นๆ ทั้งหมดที่ได้รับ
mRxTotal
uint32_t
จำนวนเฟรมทั้งหมดที่ได้รับ
mRxUnicast
uint32_t
จำนวนเฟรม Unicast ทั้งหมดที่ได้รับ
mTxAckRequested
uint32_t
จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกันซึ่งมีคำขอรับทราบ
mTxAcked
uint32_t
จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกันซึ่งมีการรับทราบ
mTxBeacon
uint32_t
จำนวนรวมของคำขอส่งเฟรมบีคอนของ MAC ที่ไม่ซ้ำกัน
mTxBeaconRequest
uint32_t
จำนวนรวมของคำขอส่งเฟรมคำขอ MAC ของ MAC ที่ไม่ซ้ำกัน
mTxBroadcast
uint32_t
จำนวนรวมของคำขอส่งเฟรม MAC สำหรับการออกอากาศที่ไม่ซ้ำกัน
mTxData
uint32_t
จำนวนรวมของคำขอส่งข้อมูลเฟรมข้อมูล MAC ที่ไม่ซ้ำกัน
mTxDataPoll
uint32_t
จำนวนรวมของคำขอส่งเฟรมแบบสำรวจข้อมูล MAC ที่ไม่ซ้ำกัน
mTxDirectMaxRetryExpiry
uint32_t
จำนวนแพ็กเกตการส่ง MAC ที่ไม่ซ้ำกันทั้งหมดที่ตรงตามขีดจำกัดการลองใหม่สูงสุดสำหรับแพ็กเก็ตโดยตรง
mTxErrAbort
uint32_t
จำนวนความล้มเหลวทั้งหมดของคำขอส่ง MAC ที่ไม่ซ้ำกันซึ่งมีสาเหตุมาจากข้อผิดพลาดในการล้มเลิก
mTxErrBusyChannel
uint32_t
จำนวนรวมของคำขอส่ง MAC ที่ล้มเหลวเนื่องจากช่องทางที่ไม่ว่าง (CSMA/CA ล้มเหลว)
mTxErrCca
uint32_t
จำนวนความล้มเหลวทั้งหมดของ CCA
mTxIndirectMaxRetryExpiry
uint32_t
จำนวนแพ็กเกตการส่ง MAC ที่ไม่ซ้ำกันทั้งหมดที่ตรงตามขีดจำกัดการลองอีกครั้งสูงสุดสำหรับแพ็กเก็ตทางอ้อม
mTxNoAckRequested
uint32_t
จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกันโดยไม่ต้องมีการตอบรับ
mTxOther
uint32_t
จำนวนรวมของคำขอส่งเฟรม MAC อื่นๆ ที่ไม่ซ้ำกัน
mTxRetry
uint32_t
จำนวนครั้งทั้งหมดในการส่งข้อมูล MAC อีกครั้ง
mTxTotal
uint32_t
จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกัน
mTxUnicast
uint32_t
จำนวนรวมของคำขอส่งเฟรม MAC ของ Unicast ที่ไม่ซ้ำกัน

แอตทริบิวต์สาธารณะ

mRxAddressFiltered

uint32_t otMacCounters::mRxAddressFiltered

จำนวนเฟรมทั้งหมดที่โมดูลตัวกรอง MAC ลด ตัวอย่างเช่น ได้รับจากโหนดในรายการที่ปฏิเสธ

mRxBeacon

uint32_t otMacCounters::mRxBeacon

จำนวนเฟรมบีคอน MAC ทั้งหมดที่ได้รับ

mRxBeaconRequest

uint32_t otMacCounters::mRxBeaconRequest

จำนวนเฟรมคำขอบีคอน MAC ทั้งหมดที่ได้รับ

mRxBroadcast

uint32_t otMacCounters::mRxBroadcast

จำนวนเฟรมของการออกอากาศทั้งหมดที่ได้รับ

mRxData

uint32_t otMacCounters::mRxData

จำนวนเฟรมข้อมูล MAC ทั้งหมดที่ได้รับ

mRxDataPoll

uint32_t otMacCounters::mRxDataPoll

จำนวนเฟรมแบบสำรวจข้อมูล MAC ทั้งหมดที่ได้รับ

mRxDestAddrFiltered

uint32_t otMacCounters::mRxDestAddrFiltered

จำนวนเฟรมทั้งหมดที่ลดจากการตรวจสอบที่อยู่ปลายทาง เช่น เฟรมที่ได้รับสำหรับโหนดอื่น

mRxDuplicated

uint32_t otMacCounters::mRxDuplicated

จำนวนเฟรมทั้งหมดที่ถูกตัดออกเนื่องจากการทำซ้ำ ซึ่งก็คือเมื่อได้รับเฟรมแล้ว

ตัวนับนี้อาจเพิ่มขึ้น เช่น เมื่อเฟรม ACK ที่สร้างโดยเครื่องรับไม่ถึงโหนดเครื่องส่งที่ทำการส่งซ้ำ

mRxErrFcs

uint32_t otMacCounters::mRxErrFcs

จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจาก FCS ไม่ถูกต้อง

mRxErrInvalidSrcAddr

uint32_t otMacCounters::mRxErrInvalidSrcAddr

จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากที่อยู่ต้นทางไม่ถูกต้อง

mRxErrNoFrame

uint32_t otMacCounters::mRxErrNoFrame

จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากเนื้อหาขาดหายไปหรือมีรูปแบบไม่ถูกต้อง

mRxErrOther

uint32_t otMacCounters::mRxErrOther

จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากข้อผิดพลาดอื่น

mRxErrSec

uint32_t otMacCounters::mRxErrSec

จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากข้อผิดพลาดด้านความปลอดภัย

ระบบอาจเพิ่มตัวนับนี้ได้ เช่น เมื่อมีการใช้ตัวนับเฟรมที่ต่ำกว่าที่คาดไว้เพื่อเข้ารหัสเฟรม

mRxErrUnknownNeighbor

uint32_t otMacCounters::mRxErrUnknownNeighbor

จำนวนเฟรมทั้งหมดที่ลดลงเนื่องจากไม่ทราบเพื่อนบ้าน

mRxOther

uint32_t otMacCounters::mRxOther

จำนวนเฟรมประเภทอื่นๆ ทั้งหมดที่ได้รับ

mRxTotal

uint32_t otMacCounters::mRxTotal

จำนวนเฟรมทั้งหมดที่ได้รับ

ตัวนับนี้นับเฟรมทั้งหมดที่รายงานโดยไดรเวอร์วิทยุของแพลตฟอร์ม รวมถึงเฟรมที่หลุด เช่น เนื่องจากข้อผิดพลาด FCS

mRxUnicast

uint32_t otMacCounters::mRxUnicast

จำนวนเฟรม Unicast ทั้งหมดที่ได้รับ

mTxAckRequested

uint32_t otMacCounters::mTxAckRequested

จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกันซึ่งมีคำขอรับทราบ

mTxAcked

uint32_t otMacCounters::mTxAcked

จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกันซึ่งมีการรับทราบ

mTxBeacon

uint32_t otMacCounters::mTxBeacon

จำนวนรวมของคำขอส่งเฟรมบีคอนของ MAC ที่ไม่ซ้ำกัน

mTxBeaconRequest

uint32_t otMacCounters::mTxBeaconRequest

จำนวนรวมของคำขอส่งเฟรมคำขอ MAC ของ MAC ที่ไม่ซ้ำกัน

mTxBroadcast

uint32_t otMacCounters::mTxBroadcast

จำนวนรวมของคำขอส่งเฟรม MAC สำหรับการออกอากาศที่ไม่ซ้ำกัน

mTxData

uint32_t otMacCounters::mTxData

จำนวนรวมของคำขอส่งข้อมูลเฟรมข้อมูล MAC ที่ไม่ซ้ำกัน

mTxDataPoll

uint32_t otMacCounters::mTxDataPoll

จำนวนรวมของคำขอส่งเฟรมแบบสำรวจข้อมูล MAC ที่ไม่ซ้ำกัน

mTxDirectMaxRetryExpiry

uint32_t otMacCounters::mTxDirectMaxRetryExpiry

จำนวนแพ็กเกตการส่ง MAC ที่ไม่ซ้ำกันทั้งหมดที่ตรงตามขีดจำกัดการลองใหม่สูงสุดสำหรับแพ็กเก็ตโดยตรง

mTxErrAbort

uint32_t otMacCounters::mTxErrAbort

จำนวนความล้มเหลวทั้งหมดของคำขอส่ง MAC ที่ไม่ซ้ำกันซึ่งมีสาเหตุมาจากข้อผิดพลาดในการล้มเลิก

mTxErrBusyChannel

uint32_t otMacCounters::mTxErrBusyChannel

จำนวนรวมของคำขอส่ง MAC ที่ล้มเหลวเนื่องจากช่องทางที่ไม่ว่าง (CSMA/CA ล้มเหลว)

mTxErrCca

uint32_t otMacCounters::mTxErrCca

จำนวนความล้มเหลวทั้งหมดของ CCA

ความหมายของตัวนับนี้อาจแตกต่างกันไปและขึ้นอยู่กับความสามารถของพนักงานขับรถวิทยุของแพลตฟอร์ม

หากเปิดใช้ OT_RADIO_CAPS_CSMA_BACKOFF ไว้ ตัวนับนี้จะแสดงจำนวนทั้งหมดของความพยายามที่ล้มเหลว CSMA/CA ทั้งหมด และเพิ่มขึ้นครั้งละ 1 ครั้งต่อการส่งแต่ละครั้ง (ในกรณีที่ CSMA/CA ล้มเหลว)

หากเปิดใช้ OT_RADIO_CAPS_TRANSMIT_RETRIES ตัวนับนี้ ตัวนับนี้จะแสดงจำนวนครั้งทั้งหมดของความพยายาม CSMA/CA ที่ล้มเหลว และเพิ่มขึ้นทีละ 1 ครั้งสำหรับคำขอเฟรมข้อมูลแต่ละรายการ (โดยไม่คำนึงถึงจำนวนการส่งซ้ำ)

mTxIndirectMaxRetryExpiry

uint32_t otMacCounters::mTxIndirectMaxRetryExpiry

จำนวนแพ็กเกตการส่ง MAC ที่ไม่ซ้ำกันทั้งหมดที่ตรงตามขีดจำกัดการลองอีกครั้งสูงสุดสำหรับแพ็กเก็ตทางอ้อม

mTxNoAckRequested

uint32_t otMacCounters::mTxNoAckRequested

จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกันโดยไม่ต้องมีการตอบรับ

mTxOther

uint32_t otMacCounters::mTxOther

จำนวนรวมของคำขอส่งเฟรม MAC อื่นๆ ที่ไม่ซ้ำกัน

ขณะนี้ตัวนับยังใช้สำหรับการนับเฟรมนอกย่านความถี่

mTxRetry

uint32_t otMacCounters::mTxRetry

จำนวนครั้งทั้งหมดในการส่งข้อมูล MAC อีกครั้ง

โปรดทราบว่าตัวนับนี้จะเพิ่มขึ้น 1 ครั้งสำหรับความพยายามในการส่งแต่ละครั้ง ซึ่งอาจเกิดจากการไม่รับทราบ ความล้มเหลวของ CSMA/CA หรือข้อผิดพลาดในการส่งประเภทอื่นๆ ตัวนับ mTxRetry เพิ่มขึ้นทั้งสำหรับเฟรม Unicast และเฟรม MAC การออกอากาศ

แก้ไขพารามิเตอร์การกำหนดค่าต่อไปนี้เพื่อควบคุมจำนวนการส่งซ้ำในระบบ

  • 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

ปัจจุบันตัวนับนี้ไม่ถูกต้องหากความสามารถของไดรเวอร์วิทยุของแพลตฟอร์มมี OT_RADIO_CAPS_TRANSMIT_RETRIES

mTxTotal

uint32_t otMacCounters::mTxTotal

จำนวนรวมของคำขอส่งเฟรม MAC ที่ไม่ซ้ำกัน

โปรดทราบว่าตัวนับนี้จะเพิ่มครั้งละ 1 คำขอสำหรับการส่งข้อมูล MAC เท่านั้น โดยไม่คำนึงถึงจำนวนความล้มเหลวของ CCA, ความพยายาม CSMA-CA หรือการส่งซ้ำ

กฎการเพิ่มขึ้นนี้จะใช้กับตัวนับต่อไปนี้:

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

สมการต่อไปนี้ถูกต้อง

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

mTxUnicast

uint32_t otMacCounters::mTxUnicast

จำนวนรวมของคำขอส่งเฟรม MAC ของ Unicast ที่ไม่ซ้ำกัน

แหล่งข้อมูล

หัวข้ออ้างอิง API ของ OpenThread จะมาจากซอร์สโค้ดซึ่งพร้อมใช้งานใน GitHub ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล