लिंक मेट्रिक

इस मॉड्यूल में ऐसे फ़ंक्शन शामिल हैं जो लिंक मेट्रिक प्रोटोकॉल को कंट्रोल करते हैं.

खास जानकारी

गिनती
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum
बेहतर-ACK फ़्लैग.
otLinkMetricsStatus enum
लिंक मेट्रिक के स्टेटस की वैल्यू.

टाइपडीफ़
otLinkMetricsEnhAckFlags typedef
बेहतर-ACK फ़्लैग.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
Enh-ACK Probing IE के मिलने पर पॉइंटर को कॉल किया जाता है.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
लिंक मेट्रिक मैनेजमेंट से जुड़ा जवाब मिलने पर पॉइंटर को कॉल किया जाता है.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
लिंक वाली मेट्रिक की रिपोर्ट मिलने पर पॉइंटर को कॉल किया जाता है.
otLinkMetricsSeriesFlags typedef
यह दिखाता है कि फ़ॉरवर्ड ट्रैकिंग सीरीज़ में कौनसे फ़्रेम शामिल किए जाते हैं.
otLinkMetricsStatus typedef
लिंक मेट्रिक के स्टेटस की वैल्यू.
otLinkMetricsValues typedef
लिंक मेट्रिक क्वेरी के नतीजे (वैल्यू) दिखाता है.

फ़ंक्शन
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
यह MLE लिंक वाली मेट्रिक के मैनेजमेंट का अनुरोध भेजता है, ताकि बेहतर-ACK आधारित प्रोबिंग को कॉन्फ़िगर किया जा सके.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
फ़ॉरवर्ड ट्रैकिंग सीरीज़ को कॉन्फ़िगर करने या मिटाने के लिए, एमएलई लिंक वाली मेट्रिक के मैनेजमेंट का अनुरोध भेजता है.
otLinkMetricsManagerGetMetricsValueByExtAddr(otInstance *aInstance, const otExtAddress *aExtAddress, otLinkMetricsValues *aLinkMetricsValues)
पड़ोसी के बड़े पते के आधार पर लिंक मेट्रिक का डेटा पाएं.
otLinkMetricsManagerSetEnabled(otInstance *aInstance, bool aEnable)
void
लिंक मेट्रिक मैनेजर को चालू या बंद करें.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
लिंक मेट्रिक की क्वेरी करने के लिए, MLE डेटा अनुरोध भेजता है.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
एमएलई लिंक प्रोब मैसेज भेजता है.

संरचना
otLinkMetricsSeriesFlags

यह दिखाता है कि फ़ॉरवर्ड ट्रैकिंग सीरीज़ में कौनसे फ़्रेम शामिल किए जाते हैं.

otLinkMetricsValues

लिंक मेट्रिक क्वेरी के नतीजे (वैल्यू) दिखाता है.

गिनती

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

बेहतर-ACK फ़्लैग.

इन पैरामीटर का इस्तेमाल, बेहतर-एसीके पर आधारित प्रोबिंग में किया जाता है. इससे यह पता चलता है कि प्रोबिंग को रजिस्टर करना है या उसे पूरा करना है.

प्रॉपर्टी
OT_LINK_METRICS_ENH_ACK_CLEAR

आसान.

OT_LINK_METRICS_ENH_ACK_REGISTER

रजिस्टर करें.

otLinkMetricsStatus

 otLinkMetricsStatus

लिंक मेट्रिक के स्टेटस की वैल्यू.

टाइपडीफ़

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

बेहतर-ACK फ़्लैग.

इन पैरामीटर का इस्तेमाल, बेहतर-एसीके पर आधारित प्रोबिंग में किया जाता है. इससे यह पता चलता है कि प्रोबिंग को रजिस्टर करना है या उसे पूरा करना है.

otLinkMetricsEnhAckProbingIeReportCallback

void(* otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext)

Enh-ACK Probing IE के मिलने पर पॉइंटर को कॉल किया जाता है.

जानकारी
पैरामीटर
[in] aShortAddress
प्रोबिंग विषय का Mac छोटा पता.
[in] aExtAddress
प्रोबिंग विषय के Mac एक्सटेंडेड पते की जानकारी देने वाला पॉइंटर.
[in] aMetricsValues
IE से मिलने वाली, लिंक मेट्रिक की वैल्यू का पॉइंटर.
[in] aContext
ऐप्लिकेशन के हिसाब से संदर्भ के लिए पॉइंटर.

otLinkMetricsMgmtResponseCallback

void(* otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext)

लिंक मेट्रिक मैनेजमेंट से जुड़ा जवाब मिलने पर पॉइंटर को कॉल किया जाता है.

जानकारी
पैरामीटर
[in] aSource
सोर्स पते का पॉइंटर.
[in] aStatus
जवाब में दिया गया स्टेटस कोड.
[in] aContext
ऐप्लिकेशन के हिसाब से संदर्भ के लिए पॉइंटर.

otLinkMetricsReportCallback

void(* otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext)

लिंक वाली मेट्रिक की रिपोर्ट मिलने पर पॉइंटर को कॉल किया जाता है.

जानकारी
पैरामीटर
[in] aSource
सोर्स पते का पॉइंटर.
[in] aMetricsValues
लिंक मेट्रिक की वैल्यू (क्वेरी का नतीजा) का पॉइंटर.
[in] aStatus
रिपोर्ट में स्टेटस कोड (सिर्फ़ तब काम करता है, जब aMetricsValues NULL हो).
[in] aContext
ऐप्लिकेशन के हिसाब से संदर्भ के लिए पॉइंटर.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

यह दिखाता है कि फ़ॉरवर्ड ट्रैकिंग सीरीज़ में कौनसे फ़्रेम शामिल किए जाते हैं.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

लिंक मेट्रिक के स्टेटस की वैल्यू.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

लिंक मेट्रिक क्वेरी के नतीजे (वैल्यू) दिखाता है.

फ़ंक्शन

otLinkMetricsConfigEnhAckProbing

otError otLinkMetricsConfigEnhAckProbing(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  otLinkMetricsEnhAckFlags aEnhAckFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext,
  otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback,
  void *aEnhAckCallbackContext
)

यह MLE लिंक वाली मेट्रिक के मैनेजमेंट का अनुरोध भेजता है, ताकि बेहतर-ACK आधारित प्रोबिंग को कॉन्फ़िगर किया जा सके.

इस सुविधा के लिए, OT_LINK_METRICS_ बताएँ जाने की सुविधा चालू होना ज़रूरी है.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aDestination
डेस्टिनेशन पते की ओर एक पॉइंटर.
[in] aEnhAckFlags
Enh-ACK फ़्लैग से यह जानकारी दी जाती है कि जांच को रजिस्टर करना है या पूरा करना है. इवेंट मिटाने के लिए 0 और रजिस्टर करने के लिए 1 चुकाएं. अन्य वैल्यू रिज़र्व हैं.
[in] aLinkMetricsFlags
क्वेरी की जाने वाली मेट्रिक के बारे में बताने के लिए पॉइंटर. aEnhAckFlags के 0 होने पर, NULL होना चाहिए.
[in] aCallback
किसी फ़ंक्शन का पॉइंटर, जिसे लिंक मेट्रिक के साथ बेहतर खाता मिलने पर कहा जाता है.
[in] aCallbackContext
ऐप्लिकेशन के हिसाब से संदर्भ के लिए पॉइंटर.
रिटर्न वैल्यू
OT_ERROR_NONE
लिंक मेट्रिक मैनेजमेंट के अनुरोध का मैसेज भेजा गया.
OT_ERROR_NO_BUFS
एमएलई लिंक मेट्रिक मैनेजमेंट के अनुरोध का मैसेज जनरेट करने के लिए, बफ़र की संख्या काफ़ी नहीं है.
OT_ERROR_INVALID_ARGS
aEnhAckFlags एक मान्य मान नहीं है या aLinkMetricsFlags सही नहीं है.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination, लिंक-लोकल नहीं है या पड़ोसी नहीं मिला.
OT_ERROR_NOT_CAPABLE
पड़ोसी, Thread 1.2 डिवाइस नहीं है और लिंक मेट्रिक के साथ काम नहीं करता है.

otLinkMetricsConfigForwardTrackingSeries

otError otLinkMetricsConfigForwardTrackingSeries(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  otLinkMetricsSeriesFlags aSeriesFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext
)

फ़ॉरवर्ड ट्रैकिंग सीरीज़ को कॉन्फ़िगर करने या मिटाने के लिए, एमएलई लिंक वाली मेट्रिक के मैनेजमेंट का अनुरोध भेजता है.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aDestination
डेस्टिनेशन पते की ओर एक पॉइंटर.
[in] aSeriesId
वह सीरीज़ आईडी जिसके साथ काम करना है.
[in] aSeriesFlags
सीरीज़ फ़्लैग से पता चलता है कि किन फ़्रेम को शामिल किया जाना है.
[in] aLinkMetricsFlags
क्वेरी की जाने वाली मेट्रिक के बारे में बताने के लिए पॉइंटर. aSeriesFlags के 0 होने पर, NULL होना चाहिए.
[in] aCallback
लिंक मेट्रिक मैनेजमेंट रिस्पॉन्स मिलने पर कॉल किए जाने वाले फ़ंक्शन का पॉइंटर.
[in] aCallbackContext
ऐप्लिकेशन के हिसाब से संदर्भ के लिए पॉइंटर.
रिटर्न वैल्यू
OT_ERROR_NONE
लिंक मेट्रिक मैनेजमेंट के अनुरोध का मैसेज भेजा गया.
OT_ERROR_NO_BUFS
एमएलई लिंक मेट्रिक मैनेजमेंट के अनुरोध का मैसेज जनरेट करने के लिए, बफ़र की संख्या काफ़ी नहीं है.
OT_ERROR_INVALID_ARGS
aSeriesId मान्य श्रेणी में नहीं है.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination, लिंक-लोकल नहीं है या पड़ोसी नहीं मिला.
OT_ERROR_NOT_CAPABLE
पड़ोसी, Thread 1.2 डिवाइस नहीं है और लिंक मेट्रिक के साथ काम नहीं करता है.

otLinkMetricsManagerGetMetricsValueByExtAddr

otError otLinkMetricsManagerGetMetricsValueByExtAddr(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  otLinkMetricsValues *aLinkMetricsValues
)

पड़ोसी के बड़े पते के आधार पर लिंक मेट्रिक का डेटा पाएं.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aExtAddress
प्रोबिंग विषय के Mac एक्सटेंडेड पते की जानकारी देने वाला पॉइंटर.
[out] aLinkMetricsValues
विषय की लिंक मेट्रिक की वैल्यू का पॉइंटर.
रिटर्न वैल्यू
OT_ERROR_NONE
लिंक मेट्रिक का डेटा मिल गया.
OT_ERROR_INVALID_ARGS
तर्क गलत हैं.
OT_ERROR_NOT_FOUND
दिए गए विस्तृत पते वाला कोई पड़ोसी नहीं मिला.

otLinkMetricsManagerSetEnabled

void otLinkMetricsManagerSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

लिंक मेट्रिक मैनेजर को चालू या बंद करें.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aEnable
चालू या बंद करने वाला बूलियन.

otLinkMetricsQuery

otError otLinkMetricsQuery(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsReportCallback aCallback,
  void *aCallbackContext
)

लिंक मेट्रिक की क्वेरी करने के लिए, MLE डेटा अनुरोध भेजता है.

यह सिंगल प्रोब या फ़ॉरवर्ड ट्रैकिंग सीरीज़ हो सकती है.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aDestination
डेस्टिनेशन पते की ओर एक पॉइंटर.
[in] aSeriesId
क्वेरी का सीरीज़ आईडी, यानी कि सिंगल प्रोब के लिए 0.
[in] aLinkMetricsFlags
क्वेरी की जाने वाली मेट्रिक के बारे में बताने के लिए पॉइंटर.
[in] aCallback
लिंक मेट्रिक रिपोर्ट मिलने पर कॉल किया जाने वाला फ़ंक्शन का पॉइंटर.
[in] aCallbackContext
ऐप्लिकेशन के हिसाब से संदर्भ के लिए पॉइंटर.
रिटर्न वैल्यू
OT_ERROR_NONE
लिंक मेट्रिक क्वेरी मैसेज भेजा गया.
OT_ERROR_NO_BUFS
MLE डेटा अनुरोध मैसेज जनरेट करने के लिए, बफ़र की संख्या काफ़ी नहीं है.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination, लिंक-लोकल नहीं है या पड़ोसी नहीं मिला.
OT_ERROR_NOT_CAPABLE
पड़ोसी, Thread 1.2 डिवाइस नहीं है और लिंक मेट्रिक के साथ काम नहीं करता है.

otLinkMetricsSendLinkProbe

otError otLinkMetricsSendLinkProbe(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  uint8_t aLength
)

एमएलई लिंक प्रोब मैसेज भेजता है.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aDestination
डेस्टिनेशन पते की ओर एक पॉइंटर.
[in] aSeriesId
सीरीज़ आईडी [1, 254] जिस पर जांच मैसेज का लक्ष्य होता है.
[in] aLength
लिंक प्रोब टीएलवी, 0, 64 में डेटा पेलोड की लंबाई.
रिटर्न वैल्यू
OT_ERROR_NONE
लिंक प्रोब मैसेज भेजा गया.
OT_ERROR_NO_BUFS
एमएलई लिंक प्रोब मैसेज जनरेट करने के लिए ज़रूरत के मुताबिक बफ़र नहीं हैं.
OT_ERROR_INVALID_ARGS
aSeriesId या aLength मान्य श्रेणी में नहीं है.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination, लिंक-लोकल नहीं है या पड़ोसी नहीं मिला.
OT_ERROR_NOT_CAPABLE
पड़ोसी, Thread 1.2 डिवाइस नहीं है और लिंक मेट्रिक के साथ काम नहीं करता है.

संसाधन

OpenThread API के रेफ़रंस के विषय, सोर्स कोड से मिलते हैं. यह सोर्स GitHub पर उपलब्ध है. ज़्यादा जानकारी या हमारे दस्तावेज़ में योगदान देने के लिए, संसाधन देखें.