मेट्रिक लिंक करें

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

खास जानकारी

नंबर
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum
बेहतर-असर वाले झंडे.
otLinkMetricsStatus enum
मेट्रिक की स्थिति के मान लिंक करें.

टाइपडेफ़
otLinkMetricsEnhAckFlags typedef
बेहतर-असर वाले झंडे.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
यह फ़ंक्शन पॉइंटर तभी काम करता है, जब Enh-ACK प्रोबिंग IE मिलता है.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext) typedef
void(*
लिंक मेट्रिक मैनेजमेंट रिस्पॉन्स मिलने पर इस फ़ंक्शन पॉइंटर को कॉल किया जाता है.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t 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)
यह फ़ंक्शन, बेहतर-ACK आधारित जांच को कॉन्फ़िगर/साफ़ करने के लिए MLE लिंक मेट्रिक प्रबंधन अनुरोध भेजता है.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
यह फ़ंक्शन, फ़ॉरवर्ड ट्रैकिंग सीरीज़ को कॉन्फ़िगर/साफ़ करने के लिए, MLE लिंक मेट्रिक मैनेजमेंट अनुरोध भेजता है.
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)
यह फ़ंक्शन एक MLE Link Probe मैसेज भेजता है.

स्ट्रक्चर
otLinkMetricsSeries फ़्लैग

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

otLinkMetricsValues

यह स्ट्रक्चर, लिंक मेट्रिक क्वेरी के लिए नतीजे (मान) को दिखाता है.

नंबर

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

बेहतर-असर वाले झंडे.

इनका इस्तेमाल बेहतर-ACK आधारित जांच में किया जाता है. इससे पता चलता है कि जांच को रजिस्टर करना है या जांच को साफ़ करना है.

प्रॉपर्टी
OT_LINK_METRICS_ENH_ACK_CLEAR

साफ़ करें पर टैप करें.

OT_LINK_METRICS_ENH_ACK_REGISTER

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

otLinkMetricsस्थिति

 otLinkMetricsStatus

मेट्रिक की स्थिति के मान लिंक करें.

टाइपडेफ़

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

बेहतर-असर वाले झंडे.

इनका इस्तेमाल बेहतर-ACK आधारित जांच में किया जाता है. इससे पता चलता है कि जांच को रजिस्टर करना है या जांच को साफ़ करना है.

otLinkMetricsEnhAckProbingIeReportCallback

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

यह फ़ंक्शन पॉइंटर तभी काम करता है, जब Enh-ACK प्रोबिंग IE मिलता है.

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

otLinkMetricsMgmtResponseCallback

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

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

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

otLinkMetricsReportCallback

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

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

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

otLinkMetricsSeries फ़्लैग

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

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

otLinkMetricsस्थिति

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
)

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

इस फ़ंक्शन के लिए OT_LINK_METRICS_INITIATOR सुविधा को चालू करना ज़रूरी है.

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

otLinkMetricsConfigForwardTrackingSeries

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

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

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

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
पड़ोसी, 1.2 थ्रेड नहीं है और लिंक मेट्रिक का समर्थन नहीं करता है.

otLinkMetricsSendLinkProbe

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

यह फ़ंक्शन एक MLE Link Probe मैसेज भेजता है.

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

संसाधन

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