Doğramacı

Bu modül, İleti Dizisi Birleştirici rolüne ilişkin işlevler içerir.

Özet

Sıralamalar
otJoinerState enum
Bu numaralandırma, Birleştirme Durumunu tanımlar.

Typedef
otJoinerCallback)(otError aError, void *aContext) typedef
void(*
Bu işlev işaretçisi, bir birleştirme işleminin tamamlandığını bildirmek için çağrılır.
otJoinerDiscerner typedef
Bu yapı, Birleştirici Diski temsil eder.
otJoinerState typedef
Bu numaralandırma, Birleştirme Durumunu tanımlar.

İşlevler
otJoinerGetDiscerner(otInstance *aInstance)
Bu işlev, Birleştirme Aracını alır.
otJoinerGetId(otInstance *aInstance)
const otExtAddress *
Bu işlev, Birleştirici kimliğini alır.
otJoinerGetState(otInstance *aInstance)
Bu işlev, Birleştirici Durumunu döndürür.
otJoinerSetDiscerner(otInstance *aInstance, otJoinerDiscerner *aDiscerner)
Bu işlev, Birleştirici Aracı'nı ayarlar.
otJoinerStart(otInstance *aInstance, const char *aPskd, const char *aProvisioningUrl, const char *aVendorName, const char *aVendorModel, const char *aVendorSwVersion, const char *aVendorData, otJoinerCallback aCallback, void *aContext)
Bu işlev, İleti Dizisi Birleştirici rolünü etkinleştirir.
otJoinerStateToString(otJoinerState aState)
const char *
Bu işlev, belirli bir birleştirici durumu numaralandırma değerini insan tarafından okunabilir bir dizeye dönüştürür.
otJoinerStop(otInstance *aInstance)
void
Bu işlev, İleti Dizisi Birleştirici rolünü devre dışı bırakır.

Strucs
otJoinerDiskerner

Bu yapı, Birleştirici Diski temsil eder.

Sıralamalar

otJoinerState

 otJoinerState

Bu numaralandırma, Birleştirme Durumunu tanımlar.

Typedef

otJoinerCallback

void(* otJoinerCallback)(otError aError, void *aContext)

Bu işlev işaretçisi, bir birleştirme işleminin tamamlandığını bildirmek için çağrılır.

Ayrıntılar
Parametreler
[in] aError
Katılma işlemi başarılı olduysa OT_ERROR_NONE. Katılma işlemi güvenlik kimlik bilgileri nedeniyle başarısız olduysa OT_ERROR_Safety. Katlanabilir bir ağ bulunmazsa OT_ERROR_NOT_FOUND. Yanıt zaman aşımına uğradıysa OT_ERROR_RESPONSE_TIMEOUT.
[in] aContext
Uygulamaya özel bağlama yönelik bir işaretçi.

otJoiner Disker

struct otJoinerDiscerner otJoinerDiscerner

Bu yapı, Birleştirici Diski temsil eder.

otJoinerState

enum otJoinerState otJoinerState

Bu numaralandırma, Birleştirme Durumunu tanımlar.

İşlevler

otJoinerGetDisker

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

Bu işlev, Birleştirme Aracını alır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
İadeler
Herhangi bir değer ayarlanmamışsa Birleştirici Disk veya BOŞ değerine işaret eder.

otJoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

Bu işlev, Birleştirici kimliğini alır.

Bir Birleştirici Diski ayarlanmamışsa, Birleştirici Kimliği fabrika tarafından atanan IEEE EUI-64'e göre SHA-256 bilgi işlemenin ilk 64 bitidir. Aksi takdirde, Birleştirici Kimliği Birleştirici Disk değerinden hesaplanır.

Birleştirme Kimliği, cihazın etkinleştirme işlemi sırasında cihazın IEEE 802.15.4 Genişletilmiş Adresi olarak da kullanılır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
İadeler
Birleştirici Kimliğinin işaretçisi.

otJoinerState

otJoinerState otJoinerGetState(
  otInstance *aInstance
)

Bu işlev, Birleştirici Durumunu döndürür.

Ayrıntılar
Parametreler
[in] aInstance
Bir OpenThread örneğinin işaretçisi.
Değerleri Döndür
OT_JOINER_STATE_IDLE
OT_JOINER_STATE_DISCOVER
OT_JOINER_STATE_CONNECT
OT_JOINER_STATE_CONNECTED
OT_JOINER_STATE_ENTRUST
OT_JOINER_STATE_JOINED

Disk Birleştirici

otError otJoinerSetDiscerner(
  otInstance *aInstance,
  otJoinerDiscerner *aDiscerner
)

Bu işlev, Birleştirici Aracı'nı ayarlar.

Birleştirme Aracı, birleştirme/katılım işlemi sırasında kullanılan Birleştirme Kimliğini hesaplamak için kullanılır.

Varsayılan olarak (bir disk sağlanmadığında veya NULL değerine ayarlandığında), Birleştirme Kimliği, fabrika tarafından atanmış IEEE EUI-64'e göre SHA-256 hesaplandığında, ilk 64 bit olarak türetilir. Bunun, İş Ortağı spesifikasyonunun beklediği ana davranış olduğunu unutmayın.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneği için bir işaretçi.
[in] aDiscerner
Birleştirici İşaretçiye işaret eden bir işaret. NULL önceden ayarlanan diskleri temizlerse.
Değerleri Döndür
OT_ERROR_NONE
Joiner Disk Oluşturucu başarıyla güncellendi.
OT_ERROR_INVALID_ARGS
aDiscerner geçerli değil (belirtilen uzunluk geçerli bir aralıkta değil).
OT_ERROR_INVALID_STATE
Devam eden bir Katılma işlemi olduğundan Birleştirme Aracı değiştirilemedi.

otJoinerBaşlangıç

otError otJoinerStart(
  otInstance *aInstance,
  const char *aPskd,
  const char *aProvisioningUrl,
  const char *aVendorName,
  const char *aVendorModel,
  const char *aVendorSwVersion,
  const char *aVendorData,
  otJoinerCallback aCallback,
  void *aContext
)

Bu işlev, İleti Dizisi Birleştirici rolünü etkinleştirir.

Ayrıntılar
Parametreler
[in] aInstance
Bir OpenThread örneğinin işaretçisi.
[in] aPskd
PSKd'ye işaret eder.
[in] aProvisioningUrl
Temel Hazırlık URL'sine işaret eden bir işarettir (BOŞ olabilir).
[in] aVendorName
Tedarikçi Adına işaret eden bir öğedir (BOŞ olabilir).
[in] aVendorModel
Tedarikçi Modeli için bir işaretçi (NULL olabilir).
[in] aVendorSwVersion
Tedarikçi Yazılım Yazılımı Sürümüne işaret eden bir işaret (NULL olabilir).
[in] aVendorData
Tedarikçi Verileri için bir işaretçi (BOŞ olabilir).
[in] aCallback
Birleştirme işlemi tamamlandığında çağrılan işlevin işaretçisi.
[in] aContext
Uygulamaya özel bağlama yönelik bir işaretçi.
Değerleri Döndür
OT_ERROR_NONE
Birleştirici rolü başarıyla başlatıldı.
OT_ERROR_BUSY
Önceki deneme hâlâ devam ediyor.
OT_ERROR_INVALID_ARGS
aPskd veya aProvisioningUrl geçersiz.
OT_ERROR_INVALID_STATE
IPv6 yığını etkin değil veya İş parçacığı yığını tamamen etkin.

otJoinerStateToString

const char * otJoinerStateToString(
  otJoinerState aState
)

Bu işlev, belirli bir birleştirici durumu numaralandırma değerini insan tarafından okunabilir bir dizeye dönüştürür.

Ayrıntılar
Parametreler
[in] aState
Birleştirme durumu.
İadeler
aState öğesinin kullanıcılar tarafından okunabilir dize temsili.

otJoinerStop

void otJoinerStop(
  otInstance *aInstance
)

Bu işlev, İleti Dizisi Birleştirici rolünü devre dışı bırakır.

Ayrıntılar
Parametreler
[in] aInstance
Bir OpenThread örneğinin işaretçisi.

Makrolar

UD_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

Derin Bağlantı Oluşturucunun bit cinsinden maksimum uzunluğu.

Kaynaklar

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