Ham Bağlantı

Bu modül, ham bağlantı katmanı yapılandırmasını kontrol eden işlevler içerir.

Özet

Türdefler
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
IEEE 802.15.4 çerçevesi alınan bir işaretçi.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
IEEE 802.15.4 çerçevesi alınan bir işaretçi.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
IEEE 802.15.4 çerçevesi alınan bir işaretçi.

İşlevler
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Radyoda enerji tarama sırasını başlatır.
otLinkRawGetCaps(otInstance *aInstance)
Radyo özelliklerini edinin.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
rastgele modun durumunu alır.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Radyo çipinin mevcut platform saatini (64 bit genişlik) alın.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
En güncel RSSI ölçümünü edinin.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
Radyo, İletim'den Alma'ya geçer.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Ham bağlantı katmanının etkin olup olmadığını belirtir.
otLinkRawReceive(otInstance *aInstance)
Radyo, Uyku modundan Alma moduna geçiriliyor.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Geçerli MAC çerçeve sayacı değerini ayarlar.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
Geçerli MAC çerçeve sayacı değerini yalnızca yeni değer geçerli değerden büyükse ayarlar.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
MAC anahtarlarını ve anahtar dizinini güncelleyin.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
Rastgele modunu etkinleştirir veya devre dışı bırakır.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Ham bağlantı katmanını etkinleştirir/devre dışı bırakır.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Adres filtreleme için Kısa Adres'i ayarlayın.
otLinkRawSleep(otInstance *aInstance)
Radyoyu Al durumundan Uyku moduna geçirin.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Genişletilmiş adres kaynak eşleşme tablosuna ekleniyor.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Kaynak eşleşme tablosuna kısa adres ekleme.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Genişletilmiş tüm adresler kaynak eşleşme tablosundan kaldırılıyor.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Genişletilmiş adres, radyonun kaynak eşleşme tablosunda kaldırılıyor.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Kaynak eşleşme tablosundan tüm kısa adresler kaldırılıyor.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Kaynak eşleşme tablosundaki kısa adres kaldırılıyor.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Bekleyen çerçeve için kaynak eşleşmesini etkinleştir/devre dışı bırak.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Radyoda aktarma sırasını başlatır.

Türdefler

otLinkRawEnergyScanDone

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

IEEE 802.15.4 çerçevesi alınan bir işaretçi.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aEnergyScanMaxRssi
Taranan kanalda karşılaşılan maksimum RSSI.

otLinkRawReceiveDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

IEEE 802.15.4 çerçevesi alınan bir işaretçi.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aFrame
Alma işlemi iptal edildiyse alınan çerçeveye veya NULL değerine işaret eder.
[in] aError
Bir kare başarıyla alındığında OT_ERROR_NONE. Alma işlemi iptal edildiğinde ve bir kare alınmadığında OT_ERROR_ABORT.

otLinkRawTransmitDone

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

IEEE 802.15.4 çerçevesi alınan bir işaretçi.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aFrame
İletilen çerçevenin işaretçisi.
[in] aAckFrame
ACK çerçevesine işaret eden bir işaretçi.
[in] aError
Kare iletilirken OT_ERROR_NONE. Kare iletildiğinde ancak kanaldaki etkinlik nedeniyle iletim gerçekleştirilemediğinde OT_ERROR_CHANNEL_ACCESS_FAILURE tarihinde OT_ERROR_NO_ACK hatası alındı. İletim başka nedenlerden dolayı iptal edildiğinde OT_ERROR_ABORT.

İşlevler

otLinkRawEnergyScan

otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

Radyoda enerji tarama sırasını başlatır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aScanChannel
Enerji taraması yapılacak kanal.
[in] aScanDuration
Kanalın taranacak süresi (milisaniye cinsinden).
[in] aCallback
Taranan kanal tamamlandığında çağrılan işlevin işaretçisi.
Döndürülen Değerler
OT_ERROR_NONE
Kanal taraması başarıyla başlatıldı.
OT_ERROR_BUSY
Radyo, enerji taraması gerçekleştiriyor.
OT_ERROR_NOT_IMPLEMENTED
Radyo, enerji taramasını desteklemiyor.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Radyo özelliklerini edinin.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
İadeler
Radyo özellikli bit vektörü. Yığın, bu değere bağlı olarak bazı işlevleri etkinleştirir veya devre dışı bırakır.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

rastgele modun durumunu alır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
Döndürülen Değerler
true
Promiscuous modu etkin.
false
Sıralı modu devre dışı bırakıldı.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Radyo çipinin mevcut platform saatini (64 bit genişlik) alın.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
İadeler
Mikrosaniye cinsinden geçerli radyo zamanı.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

En güncel RSSI ölçümünü edinin.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
İadeler
Geçerli olduğunda dBm cinsinden RSSI. RSSI geçersiz olduğunda 127.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Radyo, İletim'den Alma'ya geçer.

İletim arabelleğine bir işaretçi döndürür.

Arayan kişi, bu arabellekte IEEE 802.15.4 çerçevesini oluşturur ve ardından iletim isteğinde bulunmak için otLinkRawTransmit() işlevini çağırır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
İadeler
Ham bağlantı katmanı etkinleştirilmemişse aktarım arabelleğine veya NULL değerine işaret eder.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Ham bağlantı katmanının etkin olup olmadığını belirtir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
Döndürülen Değerler
true
Ham bağlantı katmanı etkinleştirildi.
false
Ham bağlantı katmanı devre dışı.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Radyo, Uyku modundan Alma moduna geçiriliyor.

Radyoyu aç.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
Döndürülen Değerler
OT_ERROR_NONE
Alma durumuna başarıyla geçirildi.
OT_ERROR_INVALID_STATE
Radyo devre dışı bırakılmış veya veri iletimi yapıyor.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Geçerli MAC çerçeve sayacı değerini ayarlar.

MAC sayacını her zaman geçerli değerden bağımsız olarak, verilen yeni aMacFrameCounter değerine ayarlar.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aMacFrameCounter
MAC çerçeve sayacı değeri.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Geçerli MAC çerçeve sayacı değerini yalnızca yeni değer geçerli değerden büyükse ayarlar.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aMacFrameCounter
MAC çerçeve sayacı değeri.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

MAC anahtarlarını ve anahtar dizinini güncelleyin.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aKeyIdMode
Anahtar kimliği modu.
[in] aKeyId
Anahtar dizini.
[in] aPrevKey
Önceki MAC anahtarı.
[in] aCurrKey
Geçerli MAC anahtarı.
[in] aNextKey
Sonraki MAC anahtarı.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Rastgele modunu etkinleştirir veya devre dışı bırakır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aEnable
Rastgele modu etkinleştirmek veya devre dışı bırakmak için kullanılan bir değer.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Ham bağlantı katmanını etkinleştirir/devre dışı bırakır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aCallback
IEEE 802.15.4 çerçevesi alındığında çağrılan bir işlevin işaretçisi. Ham bağlantı katmanını devre dışı bırakmak için NULL değerine ayarlayın.
Döndürülen Değerler
OT_ERROR_FAILED
Radyo etkinleştirilemedi/devre dışı bırakılamadı.
OT_ERROR_INVALID_STATE
OpenThread IPv6 arayüzü zaten etkinleştirilmişse
OT_ERROR_NONE
Etkinleştirme durumunun başarıyla ayarlanıp ayarlanmadığı.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Adres filtreleme için Kısa Adres'i ayarlayın.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aShortAddress
IEEE 802.15.4 Kısa Adres.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Radyoyu Al durumundan Uyku moduna geçirin.

Radyoyu kapat.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
Döndürülen Değerler
OT_ERROR_NONE
Uyku moduna başarıyla geçildi.
OT_ERROR_BUSY
Radyo iletiyordu
OT_ERROR_INVALID_STATE
Radyo devre dışı bırakıldı

otLinkRawSrcMatchAddExtEntry

otError otLinkRawSrcMatchAddExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Genişletilmiş adres kaynak eşleşme tablosuna ekleniyor.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aExtAddress
Eklenecek genişletilmiş adres.
Döndürülen Değerler
OT_ERROR_NONE
Genişletilmiş adres, kaynak eşleşme tablosuna başarıyla eklendi.
OT_ERROR_NO_BUFS
Kaynak eşleşme tablosunda kullanılabilir giriş yok.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Kaynak eşleşme tablosuna kısa adres ekleme.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aShortAddress
Eklenecek kısa adres.
Döndürülen Değerler
OT_ERROR_NONE
Kısa adres, kaynak eşleşme tablosuna başarıyla eklendi.
OT_ERROR_NO_BUFS
Kaynak eşleşme tablosunda kullanılabilir giriş yok.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Genişletilmiş tüm adresler kaynak eşleşme tablosundan kaldırılıyor.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSrcMatchClearExtEntry

otError otLinkRawSrcMatchClearExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Genişletilmiş adres, radyonun kaynak eşleşme tablosunda kaldırılıyor.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aExtAddress
Kaldırılacak genişletilmiş adres.
Döndürülen Değerler
OT_ERROR_NONE
Genişletilmiş adres, kaynak eşleşme tablosundan başarıyla kaldırıldı.
OT_ERROR_NO_ADDRESS
Genişletilmiş adres, kaynak eşleşme tablosunda yer almıyor.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Kaynak eşleşme tablosundan tüm kısa adresler kaldırılıyor.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Kaynak eşleşme tablosundaki kısa adres kaldırılıyor.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aShortAddress
Kaldırılacak kısa adres.
Döndürülen Değerler
OT_ERROR_NONE
Kısa adres, kaynak eşleşme tablosundan başarıyla kaldırıldı.
OT_ERROR_NO_ADDRESS
Kısa adres, kaynak eşleşme tablosunda yer almaz.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Bekleyen çerçeve için kaynak eşleşmesini etkinleştir/devre dışı bırak.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aEnable
Bekleyen çerçeve için kaynak eşleşmesini etkinleştir/devre dışı bırak.
Döndürülen Değerler
OT_ERROR_NONE
İşlem başarılı olursa.
OT_ERROR_INVALID_STATE
Ham bağlantı katmanı etkin değilse.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Radyoda aktarma sırasını başlatır.

Çağrıyı yapan kullanıcının iletim isteğinde bulunmadan önce otLinkRawGetTransmitBuffer() tarafından sağlanan arabellekte IEEE 802.15.4 çerçevesini oluşturması gerekir. Kanal ve iletim gücü de otRadioFrame yapısına dahil edilir.

İletim sırası aşağıdakileri içerir:

  1. Radyo, Alma özelliğinden İletim'e geçiriliyor.
  2. PSDU'yu verilen kanal üzerinde ve verilen iletim gücünde iletir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örneğinin işaretçisi.
[in] aCallback
İletim tamamlandığında çağrılan bir işlevin işaretçisi.
Döndürülen Değerler
OT_ERROR_NONE
İletim moduna başarıyla geçildi.
OT_ERROR_INVALID_STATE
Radyo, Alma durumunda değil.

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.