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 ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล