Bu sayfa, Cloud Translation API ile çevrilmiştir.

Örnek

Bu modül OpenThread örneğini kontrol eden işlevler içerir.

Özet

Sıralamalar
anonymous enum{ OT_CHANGED_IP6_ADDRESS_ADDED = 1 << 0, OT_CHANGED_IP6_ADDRESS_REMOVED = 1 << 1, OT_CHANGED_THREAD_ROLE = 1 << 2, OT_CHANGED_THREAD_LL_ADDR = 1 << 3, OT_CHANGED_THREAD_ML_ADDR = 1 << 4, OT_CHANGED_THREAD_RLOC_ADDED = 1 << 5, OT_CHANGED_THREAD_RLOC_REMOVED = 1 << 6, OT_CHANGED_THREAD_PARTITION_ID = 1 << 7, OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER = 1 << 8, OT_CHANGED_THREAD_NETDATA = 1 << 9, OT_CHANGED_THREAD_CHILD_ADDED = 1 << 10, OT_CHANGED_THREAD_CHILD_REMOVED = 1 << 11, OT_CHANGED_IP6_MULTICAST_SUBSCRIBED = 1 << 12, OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED = 1 << 13, OT_CHANGED_THREAD_CHANNEL = 1 << 14, OT_CHANGED_THREAD_PANID = 1 << 15, OT_CHANGED_THREAD_NETWORK_NAME = 1 << 16, OT_CHANGED_THREAD_EXT_PANID = 1 << 17, OT_CHANGED_NETWORK_KEY = 1 << 18, OT_CHANGED_PSKC = 1 << 19, OT_CHANGED_SECURITY_POLICY = 1 << 20, OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL = 1 << 21, OT_CHANGED_SUPPORTED_CHANNEL_MASK = 1 << 22, OT_CHANGED_COMMISSIONER_STATE = 1 << 23, OT_CHANGED_THREAD_NETIF_STATE = 1 << 24, OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE = 1 << 25, OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL = 1 << 26, OT_CHANGED_JOINER_STATE = 1 << 27, OT_CHANGED_ACTIVE_DATASET = 1 << 28, OT_CHANGED_PENDING_DATASET = 1 << 29, OT_CHANGED_NAT64_TRANSLATOR_STATE = 1 << 30 }	enum `otStateChangedCallback` kapsamında iletilen işaretleri tanımlar.

Sıralamalar

anonymous enum{
  OT_CHANGED_IP6_ADDRESS_ADDED = 1 << 0,
  OT_CHANGED_IP6_ADDRESS_REMOVED = 1 << 1,
  OT_CHANGED_THREAD_ROLE = 1 << 2,
  OT_CHANGED_THREAD_LL_ADDR = 1 << 3,
  OT_CHANGED_THREAD_ML_ADDR = 1 << 4,
  OT_CHANGED_THREAD_RLOC_ADDED = 1 << 5,
  OT_CHANGED_THREAD_RLOC_REMOVED = 1 << 6,
  OT_CHANGED_THREAD_PARTITION_ID = 1 << 7,
  OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER = 1 << 8,
  OT_CHANGED_THREAD_NETDATA = 1 << 9,
  OT_CHANGED_THREAD_CHILD_ADDED = 1 << 10,
  OT_CHANGED_THREAD_CHILD_REMOVED = 1 << 11,
  OT_CHANGED_IP6_MULTICAST_SUBSCRIBED = 1 << 12,
  OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED = 1 << 13,
  OT_CHANGED_THREAD_CHANNEL = 1 << 14,
  OT_CHANGED_THREAD_PANID = 1 << 15,
  OT_CHANGED_THREAD_NETWORK_NAME = 1 << 16,
  OT_CHANGED_THREAD_EXT_PANID = 1 << 17,
  OT_CHANGED_NETWORK_KEY = 1 << 18,
  OT_CHANGED_PSKC = 1 << 19,
  OT_CHANGED_SECURITY_POLICY = 1 << 20,
  OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL = 1 << 21,
  OT_CHANGED_SUPPORTED_CHANNEL_MASK = 1 << 22,
  OT_CHANGED_COMMISSIONER_STATE = 1 << 23,
  OT_CHANGED_THREAD_NETIF_STATE = 1 << 24,
  OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE = 1 << 25,
  OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL = 1 << 26,
  OT_CHANGED_JOINER_STATE = 1 << 27,
  OT_CHANGED_ACTIVE_DATASET = 1 << 28,
  OT_CHANGED_PENDING_DATASET = 1 << 29,
  OT_CHANGED_NAT64_TRANSLATOR_STATE = 1 << 30
}

enum

otStateChangedCallback kapsamında iletilen işaretleri tanımlar.

Typedefs
`otChangedFlags`	Typedef `uint32_t` Değişen belirli durumu/yapılandırmayı belirten bir bit alanını temsil eder.
`otInstance`	Typedef `struct otInstance` OpenThread örnek yapısını temsil eder.
`otStateChangedCallback)(otChangedFlags aFlags, void *aContext)`	Typedef `void(*` İşaretçi, OpenThread içindeki belirli yapılandırma veya durum değişikliklerini bildirmek için çağrılır.

İşlevler
`otGetRadioVersionString(otInstance *aInstance)`	`const char *` OpenThread radyo sürümü dizesini alır.
`otGetVersionString(void)`	`const char *` OpenThread sürüm dizesini alır.
`otInstanceErasePersistentInfo(otInstance *aInstance)`	`otError` Kalıcı olmayan bellekte depolanan tüm OpenThread kalıcı bilgilerini (ağ ayarları) siler.
`otInstanceFactoryReset(otInstance *aInstance)`	`void` Değişmeyen bellekte depolanan tüm ayarları siler ve bir platformun sıfırlanmasını tetikler.
`otInstanceFinalize(otInstance *aInstance)`	`void` OpenThread kitaplığını devre dışı bırakır.
`otInstanceGetId(otInstance *aInstance)`	`uint32_t` Örnek tanımlayıcısını alır.
`otInstanceGetUptime(otInstance *aInstance)`	`uint64_t` Geçerli örneğin çalışma süresini (milisaniye cinsinden) döndürür.
`otInstanceGetUptimeAsString(otInstance aInstance, char aBuffer, uint16_t aSize)`	`void` Geçerli örnek çalışma süresini, okunabilir bir dize olarak döndürür.
`otInstanceInit(void aInstanceBuffer, size_t aInstanceBufferSize)`	`otInstance *` OpenThread kitaplığını başlatır.
`otInstanceInitSingle(void)`	`otInstance *` OpenThread kitaplığının statik tek örneğini başlatır.
`otInstanceIsInitialized(otInstance *aInstance)`	`bool` Örneğin geçerli olduğunu veya başlatıldığını gösterir.
`otInstanceReset(otInstance *aInstance)`	`void` Platformun sıfırlanmasını tetikler.
`otInstanceResetRadioStack(otInstance *aInstance)`	`void` OpenThread radyo yığınının dahili durumlarını sıfırlar.
`otRemoveStateChangeCallback(otInstance aInstance, otStateChangedCallback aCallback, void aContext)`	`void` OpenThread içinde belirli yapılandırma veya durum değiştiğinde gösterilecek bir geri çağırmayı kaldırır.
`otSetStateChangedCallback(otInstance aInstance, otStateChangedCallback aCallback, void aContext)`	`otError` OpenThread içinde belirli yapılandırma veya durum değişikliklerinin belirtildiği bir geri çağırma kaydeder.

Sıralamalar

anonim enum

 anonymous enum

otStateChangedCallback kapsamında iletilen işaretleri tanımlar.

Özellikler
`OT_CHANGED_ACTIVE_DATASET`	Etkin Operasyonel Veri Kümesi değişti.
`OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL`	Kanal Yöneticisi'nin yeni bekleyen mesaj dizisi kanalı değiştirildi.
`OT_CHANGED_COMMISSIONER_STATE`	Komisyoncu durumu değişti.
`OT_CHANGED_IP6_ADDRESS_ADDED`	IPv6 adresi eklendi.
`OT_CHANGED_IP6_ADDRESS_REMOVED`	IPv6 adresi kaldırıldı.
`OT_CHANGED_IP6_MULTICAST_SUBSCRIBED`	IPv6 çoklu yayın adresine abone olundu.
`OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED`	IPv6 çoklu yayın adresinin aboneliğinden çıkıldı.
`OT_CHANGED_JOINER_STATE`	Düzenleyen durumu değiştirildi.
`OT_CHANGED_NAT64_TRANSLATOR_STATE`	NAT64 çevirmeninin durumu değişti.
`OT_CHANGED_NETWORK_KEY`	Ağ anahtarı değişti.
`OT_CHANGED_PENDING_DATASET`	Beklemedeki Operasyonel Veri Kümesi değişti.
`OT_CHANGED_PSKC`	PSKc değiştirildi.
`OT_CHANGED_SECURITY_POLICY`	Güvenlik Politikası değişti.
`OT_CHANGED_SUPPORTED_CHANNEL_MASK`	Desteklenen kanal maskesi değiştirildi.
`OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL`	Yerel Omurga Yönlendirici yapılandırması değişti.
`OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE`	Omurga Yönlendirici durumu değişti.
`OT_CHANGED_THREAD_CHANNEL`	Mesaj dizisi ağ kanalı değişti.
`OT_CHANGED_THREAD_CHILD_ADDED`	Çocuk eklendi.
`OT_CHANGED_THREAD_CHILD_REMOVED`	Çocuk kaldırıldı.
`OT_CHANGED_THREAD_EXT_PANID`	Mesaj dizisi ağı genişletilmiş PAN Kimliği değişti.
`OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER`	Mesaj Dizisi Anahtar Dizisi değişti.
`OT_CHANGED_THREAD_LL_ADDR`	Bağlantının yerel adresi değişti.
`OT_CHANGED_THREAD_ML_ADDR`	Örgü yerel adresi değişti.
`OT_CHANGED_THREAD_NETDATA`	Thread Ağ Verileri değişti.
`OT_CHANGED_THREAD_NETIF_STATE`	Mesaj dizisi ağ arayüzü durumu değişti.
`OT_CHANGED_THREAD_NETWORK_NAME`	Mesaj dizisi ağ adı değiştirildi.
`OT_CHANGED_THREAD_PANID`	Mesaj dizisi ağı PAN Kimliği değişti.
`OT_CHANGED_THREAD_PARTITION_ID`	Bölüm kimliği değişti.
`OT_CHANGED_THREAD_RLOC_ADDED`	RLOC eklendi.
`OT_CHANGED_THREAD_RLOC_REMOVED`	RLOC kaldırıldı.
`OT_CHANGED_THREAD_ROLE`	Rol (devre dışı bırakıldı, ayrıldı, alt, yönlendirici, lider) değiştirildi.

Typedefs

otChangedFlag'ler

uint32_t otChangedFlags

Değişen belirli durumu/yapılandırmayı belirten bir bit alanını temsil eder.

OT_CHANGED_* tanımını görün.

OtÖrnek

struct otInstance otInstance

OpenThread örnek yapısını temsil eder.

otStateChangedGeri Arama

void(* otStateChangedCallback)(otChangedFlags aFlags, void *aContext)

İşaretçi, OpenThread içindeki belirli yapılandırma veya durum değişikliklerini bildirmek için çağrılır.

Ayrıntılar

Parametreler

`[in] aFlags`	Değişen belirli bir durumu gösteren bit alanı. `OT_CHANGED_*` tanımını görün.
`[in] aContext`	Uygulamaya özel bağlama işaretçisi.

İşlevler

otGetRadioVersionDizesi

const char * otGetRadioVersionString(
  otInstance *aInstance
)

OpenThread radyo sürümü dizesini alır.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

İadeler

OpenThread radyo sürümünün işaretçisi.

otGetVersionStringi

const char * otGetVersionString(
  void
)

OpenThread sürüm dizesini alır.

Ayrıntılar
İadeler	OpenThread sürümünün işaretçisi.

otInstanceSilKalıcıBilgi

otError otInstanceErasePersistentInfo(
  otInstance *aInstance
)

Kalıcı olmayan bellekte depolanan tüm OpenThread kalıcı bilgilerini (ağ ayarları) siler.

Silme işlemi yalnızca cihaz disabled durumundaysa.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

Döndürülen Değerler

`OT_ERROR_NONE`	Kalıcı bilgiler/durumlar başarıyla silindi.
`OT_ERROR_INVALID_STATE`	Cihaz `disabled` durumunda/rolde değil.

otInstanceFabrika Sıfırlama

void otInstanceFactoryReset(
  otInstance *aInstance
)

Değişmeyen bellekte depolanan tüm ayarları siler ve bir platformun sıfırlanmasını tetikler.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

otInstanceFinalize

void otInstanceFinalize(
  otInstance *aInstance
)

OpenThread kitaplığını devre dışı bırakır.

OpenThread artık kullanımda değilken bu işlevi çağırın.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

otInstanceGetId

uint32_t otInstanceGetId(
  otInstance *aInstance
)

Örnek tanımlayıcısını alır.

Örnek oluşturulduğunda örnek tanımlayıcısı rastgele bir değere ayarlanır ve ilk kullanıma hazırlama sonrasında değeri değişmez.

Ayrıntılar
İadeler	Örnek tanımlayıcısı.

otInstanceGetUp

uint64_t otInstanceGetUptime(
  otInstance *aInstance
)

Geçerli örneğin çalışma süresini (milisaniye cinsinden) döndürür.

OPENTHREAD_CONFIG_UPTIME_ENABLE uygulamasının etkinleştirilmesi gerekiyor.

OpenThread örneği başlatıldıktan sonra çalışma süresi milisaniye cinsinden verilir.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

İadeler

Çalışma süresi (milisaniye cinsinden).

otInstanceGetUptimeAsString

void otInstanceGetUptimeAsString(
  otInstance *aInstance,
  char *aBuffer,
  uint16_t aSize
)

Geçerli örnek çalışma süresini, okunabilir bir dize olarak döndürür.

OPENTHREAD_CONFIG_UPTIME_ENABLE uygulamasının etkinleştirilmesi gerekiyor.

Dize; saat, dakika, saniye ve milisaniye (çalışma süresi bir günden kısaysa) veya " için"::." biçimini izler.

g.::." (bir günden uzunsa).

Sonuç olarak ortaya çıkan dize aBuffer (aSize karakter içinde) uygun değilse dize kısaltılır ancak elde edilen dize her zaman boş olarak sonlandırılır.

Ayrıntılar

Parametreler

`[in] aInstance`	OpenThread örneğini işaret eder.
`[out] aBuffer`	Dizeyi oluşturmak için bir karakter dizisinin işaretçisi.
`[in] aSize`	`aBuffer` boyutu (bayt cinsinden). `OT_UPTIME_STRING_SIZE` kullanılması önerilir.

OtInstanceInit

otInstance * otInstanceInit(
  void *aInstanceBuffer,
  size_t *aInstanceBufferSize
)

OpenThread kitaplığını başlatır.

OpenThread'i başlatır ve sonraki OpenThread API çağrıları için hazırlar. Bu işlev, diğer tüm OpenThread çağrılarından önce çağrılmalıdır.

Yalnızca birden fazla OpenThread örneği desteği etkinken kullanılabilir ve kullanılabilir.

Ayrıntılar

Parametreler

`[in] aInstanceBuffer`	otInstance yapısını ayırmak için kullanılacak OpenThread arabelleği.
`[in,out] aInstanceBufferSize`	Girişte AInstanceBuffer boyutu. Çıkışta otInstance için yeterli alan yoksa otInstance için gereken bayt sayısı.

İadeler

Yeni OpenThread örneğinin işaretçisi.

Şu makaleyi de inceleyebilirsiniz:
otInstanceFinalize

otInstanceInitTek

otInstance * otInstanceInitSingle(
  void
)

OpenThread kitaplığının statik tek örneğini başlatır.

OpenThread'i başlatır ve sonraki OpenThread API çağrıları için hazırlar. Bu işlev, diğer tüm OpenThread çağrılarından önce çağrılmalıdır.

Mevcut ve yalnızca birden fazla OpenThread örneği desteği devre dışı bırakıldığında kullanılabilir.

Ayrıntılar
İadeler	Tek OpenThread örneğini işaret eder.

otInstanceIsBaşlatıldı

bool otInstanceIsInitialized(
  otInstance *aInstance
)

Örneğin geçerli olduğunu veya başlatıldığını gösterir.

Örnek (otInstanceInitSingle() tek kullanımlık durumlarda) veya otInstanceInit() (çoklu örnek örneğinde) kullanılarak kazanılıp başlatılırsa geçerli olarak kabul edilir. otInstanceFinalize() ile ilgili sonraki çağrı, örneğin ilk kullanıma başlanmamış olarak kabul edilmesine neden olur.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

İadeler

Belirtilen örnek geçerli/başlatılmışsa DOĞRU, aksi takdirde YANLIŞ.

OTInstance Sıfırlama

void otInstanceReset(
  otInstance *aInstance
)

Platformun sıfırlanmasını tetikler.

Sıfırlama işlemi, tüm OpenThread durumunun/bilgilerinin (değişken bellekte depolanan) silinmesini sağlar. otPlatformReset işlevinin, kalıcı olmayan bellekte kayıtlı kalıcı durumları/bilgileri silmediğini unutmayın.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

otInstanceSıfırla

void otInstanceResetRadioStack(
  otInstance *aInstance
)

OpenThread radyo yığınının dahili durumlarını sıfırlar.

Geri çağırmalar ve yapılandırmalar korunur.

Bu API yalnızca radyo derlemeleri (OPENTHREAD_RADIO = 1) altında kullanılabilir.

Ayrıntılar

Parametreler

[in] aInstance

OpenThread örneğini işaret eder.

otRemoveStateChangeÇağrısı

void otRemoveStateChangeCallback(
  otInstance *aInstance,
  otStateChangedCallback aCallback,
  void *aContext
)

OpenThread içinde belirli yapılandırma veya durum değiştiğinde gösterilecek bir geri çağırmayı kaldırır.

Ayrıntılar

Parametreler

`[in] aInstance`	OpenThread örneğini işaret eder.
`[in] aCallback`	Belirli yapılandırma veya durum değişiklikleriyle çağrılan bir işlevin işaretçisi.
`[in] aContext`	Uygulamaya özel bağlama işaretçisi.

otSetStateChangedCallback

otError otSetStateChangedCallback(
  otInstance *aInstance,
  otStateChangedCallback aCallback,
  void *aContext
)

OpenThread içinde belirli yapılandırma veya durum değişikliklerinin belirtildiği bir geri çağırma kaydeder.

Ayrıntılar

Parametreler

`[in] aInstance`	OpenThread örneğini işaret eder.
`[in] aCallback`	Belirli yapılandırma veya durum değişiklikleriyle çağrılan bir işlevin işaretçisi.
`[in] aContext`	Uygulamaya özel bağlama işaretçisi.

Döndürülen Değerler

`OT_ERROR_NONE`	Geri çağırma, geri çağırmalar listesine eklendi.
`OT_ERROR_ALREADY`	Geri çağırma zaten kaydedildi.
`OT_ERROR_NO_BUFS`	Kaynak kısıtlamaları nedeniyle geri çağırma eklenemedi.

Makrolar

OT_UPTIME_STRING_SIZE

 OT_UPTIME_STRING_SIZE 24

Çalışma zamanının dize gösterimi için önerilen boyut.

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 sayfasına göz atın.