Bağlantı Metrikleri

Bu modül, Bağlantı Metrikleri protokolünü kontrol eden işlevler içerir.

Özet

Sıralamalar
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		enum
Geliştirilmiş AcK İşaretleri.
otLinkMetricsStatus enum
Bağlantı Metrikleri Durum değerleri.

Türdefler
otLinkMetricsEnhAckFlags typedef
Geliştirilmiş AcK İşaretleri.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
İşaretçi, Enh-ACK Probing IE alındığında çağrılır.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
Bağlantı Metrikleri Yönetim Yanıtı alındığında işaretçi çağrılır.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
Bağlantı Metrikleri raporu alındığında işaretçi çağrılır.
otLinkMetricsSeriesFlags typedef
İleriye dönük izleme serilerinde hangi karelerin hesaba katıldığını gösterir.
otLinkMetricsStatus typedef
Bağlantı Metrikleri Durum değerleri.
otLinkMetricsValues typedef
Bir Bağlantı Metrikleri sorgusunun sonucunu (değeri) temsil eder.

İşlevler
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
Gelişmiş AK Tabanlı Prob işlemi yapılandırmak veya temizlemek için MLE Bağlantı Metrikleri Yönetim İsteği gönderir.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
İleriye dönük izleme serilerini yapılandırmak veya temizlemek için MLE Bağlantı Metrikleri Yönetim İsteği gönderir.
otLinkMetricsManagerGetMetricsValueByExtAddr(otInstance *aInstance, const otExtAddress *aExtAddress, otLinkMetricsValues *aLinkMetricsValues)
Genişletilmiş adresine göre bir komşunun Bağlantı Metrikleri verilerini alma.
otLinkMetricsManagerSetEnabled(otInstance *aInstance, bool aEnable)
void
Bağlantı Metrikleri Yöneticisi'ni etkinleştirin veya devre dışı bırakın.
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
Bağlantı Metriklerini sorgulamak için bir MLE Veri İsteği gönderir.
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
MLE Bağlantı Probe mesajı gönderir.

Yapılar
otLinkMetricsSeriesFlags

İleriye dönük izleme serilerinde hangi karelerin hesaba katıldığını gösterir.

otLinkMetricsValues

Bir Bağlantı Metrikleri sorgusunun sonucunu (değeri) temsil eder.

Sıralamalar

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

Geliştirilmiş AcK İşaretleri.

Bunlar, gelişmiş ACK Tabanlı Probing teknolojisinde, kontrol işleminin kaydedilip temizlenmeyeceğini belirtmek için kullanılır.

Özellikler
OT_LINK_METRICS_ENH_ACK_CLEAR

Net.

OT_LINK_METRICS_ENH_ACK_REGISTER

Kaydolun.

otLinkMetricsStatus

 otLinkMetricsStatus

Bağlantı Metrikleri Durum değerleri.

Türdefler

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

Geliştirilmiş AcK İşaretleri.

Bunlar, gelişmiş ACK Tabanlı Probing teknolojisinde, kontrol işleminin kaydedilip temizlenmeyeceğini belirtmek için kullanılır.

otLinkMetricsEnhAckProbingIeReportCallback

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

İşaretçi, Enh-ACK Probing IE alındığında çağrılır.

Ayrıntılar
Parametreler
[in] aShortAddress
Araştırma Konusunun Mac kısa adresi.
[in] aExtAddress
Araştırma Konusunun Mac genişletilmiş adresine işaretçi.
[in] aMetricsValues
IE'den alınan Bağlantı Metrikleri değerlerine yönelik işaretçi.
[in] aContext
Uygulamaya özel bağlama işaret eden bir işaretçi.

otLinkMetricsMgmtResponseCallback

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

Bağlantı Metrikleri Yönetim Yanıtı alındığında işaretçi çağrılır.

Ayrıntılar
Parametreler
[in] aSource
Kaynak adresin işaretçisi.
[in] aStatus
Yanıttaki durum kodu.
[in] aContext
Uygulamaya özel bağlama işaret eden bir işaretçi.

otLinkMetricsReportCallback

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

Bağlantı Metrikleri raporu alındığında işaretçi çağrılır.

Ayrıntılar
Parametreler
[in] aSource
Kaynak adresin işaretçisi.
[in] aMetricsValues
Bağlantı Metrikleri değerlerine (sorgu sonucu) işaret eden bir işaretçi.
[in] aStatus
Rapordaki durum kodu (yalnızca aMetricsValues NULL olduğunda yararlıdır).
[in] aContext
Uygulamaya özel bağlama işaret eden bir işaretçi.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

İleriye dönük izleme serilerinde hangi karelerin hesaba katıldığını gösterir.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

Bağlantı Metrikleri Durum değerleri.

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

Bir Bağlantı Metrikleri sorgusunun sonucunu (değeri) temsil eder.

İşlevler

otLinkMetricsConfigEnhAckProbing

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

Gelişmiş AK Tabanlı Prob işlemi yapılandırmak veya temizlemek için MLE Bağlantı Metrikleri Yönetim İsteği gönderir.

Bu işlev için OT_LINK_METRICS_INITIATOR özelliğinin etkinleştirilmesi gerekir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aDestination
Hedef adresin işaretçisi.
[in] aEnhAckFlags
Enh-ACK İşaretleri. Temizlemek için 0, kaydettirmek için 1. Diğer değerler ayrılmıştır.
[in] aLinkMetricsFlags
Sorgulanacak metrikleri belirten işaret işaretçisi. aEnhAckFlags 0 olduğunda NULL olmalıdır.
[in] aCallback
Bağlantı Metriklerine sahip Geliştirilmiş Onay alındığında çağrılan bir işlevin işaretçisi.
[in] aCallbackContext
Uygulamaya özel bağlama işaret eden bir işaretçi.
Döndürülen Değerler
OT_ERROR_NONE
Bağlantı Metrikleri Yönetim İsteği mesajı başarıyla gönderildi.
OT_ERROR_NO_BUFS
Çok Dilli Ses Bağlantı Metrikleri Yönetim İsteği mesajı oluşturmak için yeterli arabellek yok.
OT_ERROR_INVALID_ARGS
aEnhAckFlags geçerli bir değer değil veya aLinkMetricsFlags doğru değil.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination bağlantı yerel değil veya komşu bulunamadı.
OT_ERROR_NOT_CAPABLE
Komşu bir Thread 1.2 cihazı değil ve Bağlantı Metriklerini desteklemiyor.

otLinkMetricsConfigForwardTrackingSeries

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

İleriye dönük izleme serilerini yapılandırmak veya temizlemek için MLE Bağlantı Metrikleri Yönetim İsteği gönderir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aDestination
Hedef adresin işaretçisi.
[in] aSeriesId
Birlikte çalışılacak seri kimliğidir.
[in] aSeriesFlags
Hangi karelerin hesaba katılması gerektiğini belirten seri işaretleri.
[in] aLinkMetricsFlags
Sorgulanacak metrikleri belirten işaret işaretçisi. aSeriesFlags 0 olduğunda NULL olmalıdır.
[in] aCallback
Bağlantı Metrikleri Yönetim Yanıtı alındığında çağrılan bir işlevin işaretçisi.
[in] aCallbackContext
Uygulamaya özel bağlama işaret eden bir işaretçi.
Döndürülen Değerler
OT_ERROR_NONE
Bağlantı Metrikleri Yönetim İsteği mesajı başarıyla gönderildi.
OT_ERROR_NO_BUFS
Çok Dilli Ses Bağlantı Metrikleri Yönetim İsteği mesajı oluşturmak için yeterli arabellek yok.
OT_ERROR_INVALID_ARGS
aSeriesId, geçerli aralıkta değil.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination bağlantı yerel değil veya komşu bulunamadı.
OT_ERROR_NOT_CAPABLE
Komşu bir Thread 1.2 cihazı değil ve Bağlantı Metriklerini desteklemiyor.

otLinkMetricsManagerGetMetricsValueByExtAddr

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

Genişletilmiş adresine göre bir komşunun Bağlantı Metrikleri verilerini alma.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aExtAddress
Araştırma Konusunun Mac genişletilmiş adresine işaretçi.
[out] aLinkMetricsValues
Konunun Bağlantı Metrikleri değerlerine işaret eden bir işaretçi.
Döndürülen Değerler
OT_ERROR_NONE
Bağlantı Metrikleri verileri başarıyla alındı.
OT_ERROR_INVALID_ARGS
Bağımsız değişkenler geçersiz.
OT_ERROR_NOT_FOUND
Belirtilen genişletilmiş adrese sahip komşu bulunamadı.

otLinkMetricsManagerSetEnabled

void otLinkMetricsManagerSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

Bağlantı Metrikleri Yöneticisi'ni etkinleştirin veya devre dışı bırakın.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aEnable
Etkinleştirme veya devre dışı bırakmayı belirten bir boole.

otLinkMetricsQuery

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

Bağlantı Metriklerini sorgulamak için bir MLE Veri İsteği gönderir.

Tek Prob veya İleri İzleme Serisi olabilir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aDestination
Hedef adresin işaretçisi.
[in] aSeriesId
Sorgulanacak seri kimliği, tek durum için 0.
[in] aLinkMetricsFlags
Sorgulanacak metrikleri belirten işaret işaretçisi.
[in] aCallback
Bağlantı Metrikleri raporu alındığında çağrılan bir işlevin işaretçisi.
[in] aCallbackContext
Uygulamaya özel bağlama işaret eden bir işaretçi.
Döndürülen Değerler
OT_ERROR_NONE
Bağlantı Metrikleri sorgu mesajı başarıyla gönderildi.
OT_ERROR_NO_BUFS
Çok Dilli Ses Veri İsteği mesajını oluşturmak için yetersiz arabellekler.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination bağlantı yerel değil veya komşu bulunamadı.
OT_ERROR_NOT_CAPABLE
Komşu bir Thread 1.2 cihazı değil ve Bağlantı Metriklerini desteklemiyor.

otLinkMetricsSendLinkProbe

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

MLE Bağlantı Probe mesajı gönderir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aDestination
Hedef adresin işaretçisi.
[in] aSeriesId
Yoklama mesajının hedeflediği seri kimliği [1, 254].
[in] aLength
Link Probe TLV'de veri yükünün uzunluğu, 0, 64.
Döndürülen Değerler
OT_ERROR_NONE
Bağlantı Yoklama mesajı başarıyla gönderildi.
OT_ERROR_NO_BUFS
MLE Bağlantı Prob mesajı oluşturmak için yetersiz arabellekler.
OT_ERROR_INVALID_ARGS
aSeriesId veya aLength, geçerli aralıkta değil.
OT_ERROR_UNKNOWN_NEIGHBOR
aDestination bağlantı yerel değil veya komşu bulunamadı.
OT_ERROR_NOT_CAPABLE
Komşu bir Thread 1.2 cihazı değil ve Bağlantı Metriklerini desteklemiyor.

Kaynaklar

OpenThread API Referans konuları, GitHub'da bulunan kaynak koddan gelir. Daha fazla bilgi edinmek veya dokümanlarımıza katkıda bulunmak için Kaynaklar bölümüne bakın.