Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Link Mentah

Modul ini mencakup fungsi yang mengontrol konfigurasi lapisan link mentah.

Ringkasan

Typedef
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
Pointer fungsi ini saat menerima frame IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
Pointer fungsi ini saat menerima frame IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
Pointer fungsi ini saat menerima frame IEEE 802.15.4.

Fungsi
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Metode ini memulai urutan pemindaian energi pada radio.
otLinkRawGetCaps(otInstance *aInstance)
Dapatkan kemampuan radio.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Fungsi ini mendapatkan status mode gagal.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Mendapatkan waktu platform saat ini (lebar 64 bit) dari chip radio.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Dapatkan pengukuran RSSI terbaru.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
Radio akan beralih dari Transmisi ke Terima.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Fungsi ini menunjukkan apakah lapisan link mentah diaktifkan atau tidak.
otLinkRawReceive(otInstance *aInstance)
Mentransisi radio dari Tidur ke Menerima.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Menetapkan nilai penghitung frame MAC saat ini.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
Perbarui kunci MAC dan indeks kunci.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
Fungsi ini mengaktifkan atau menonaktifkan mode promiscuous.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Fungsi ini mengaktifkan/menonaktifkan lapisan tautan mentah.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Tetapkan Alamat Singkat untuk pemfilteran alamat.
otLinkRawSleep(otInstance *aInstance)
Transisikan radio dari Terima ke Tidur.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Menambahkan alamat yang diperluas ke tabel pencocokan sumber.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Menambahkan alamat singkat ke tabel pencocokan sumber.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Menghapus semua alamat yang diperluas dari tabel pencocokan sumber.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Menghapus alamat yang diperluas ke tabel pencocokan sumber radio.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Menghapus semua alamat singkat dari tabel pencocokan sumber.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Menghapus alamat singkat ke tabel pencocokan sumber.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Mengaktifkan/Menonaktifkan pencocokan sumber untuk frame yang tertunda.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Metode ini memulai urutan transmisi di radio.

Typedef

otLinkRawEnergyScanDone

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

Pointer fungsi ini saat menerima frame IEEE 802.15.4.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aEnergyScanMaxRssi
RSSI maksimum yang ditemukan pada saluran yang dipindai.

otLinkRawReceiveDone

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

Pointer fungsi ini saat menerima frame IEEE 802.15.4.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aFrame
Pointer ke frame yang diterima atau NULL jika operasi penerimaan dibatalkan.
[in] aError
OT_ERROR_NONE jika berhasil menerima frame. OT_ERROR_ABORT saat penerimaan dibatalkan dan frame tidak diterima.

otLinkRawTransmitDone

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

Pointer fungsi ini saat menerima frame IEEE 802.15.4.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aFrame
Pointer ke frame yang ditransmisikan.
[in] aAckFrame
Pointer ke frame ACK.
[in] aError
OT_ERROR_NONE saat frame ditransmisikan. OT_ERROR_NO_ACK saat frame dikirim, tetapi tidak ada ACK yang diterima OT_ERROR_CHANNEL_ACCESS_FAILURE saat transmisi tidak dapat terjadi karena aktivitas pada channel. OT_ERROR_ABORT saat transmisi dibatalkan karena alasan lain.

Fungsi

otLinkRawEnergyScan

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

Metode ini memulai urutan pemindaian energi pada radio.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aScanChannel
Saluran untuk menjalankan pemindaian energi.
[in] aScanDuration
Durasi, dalam milidetik, untuk pemindaian saluran.
[in] aCallback
Pointer ke fungsi yang dipanggil saat saluran yang dipindai selesai.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil memulai pemindaian saluran.
OT_ERROR_BUSY
Radio melakukan pemindaian yang sangat antusias.
OT_ERROR_NOT_IMPLEMENTED
Radio tidak mendukung pemindaian energi.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Dapatkan kemampuan radio.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Menampilkan
Vektor bit kemampuan radio. Tumpukan mengaktifkan atau menonaktifkan beberapa fungsi berdasarkan nilai ini.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Fungsi ini mendapatkan status mode gagal.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Nilai yang Ditampilkan
true
Mode promiscuous diaktifkan.
false
Mode promiscuous dinonaktifkan.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Mendapatkan waktu platform saat ini (lebar 64 bit) dari chip radio.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Menampilkan
Waktu radio saat ini dalam mikrodetik.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Dapatkan pengukuran RSSI terbaru.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Menampilkan
RSSI dalam dBm jika valid. 127 saat RSSI tidak valid.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

Radio akan beralih dari Transmisi ke Terima.

Metode ini menampilkan pointer ke buffer transmisi.

Pemanggil membentuk frame IEEE 802.15.4 dalam buffer ini, lalu memanggil otLinkRawTransmit() untuk meminta transmisi.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Menampilkan
Pointer ke buffer transmisi atau NULL jika lapisan link mentah tidak diaktifkan.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Fungsi ini menunjukkan apakah lapisan link mentah diaktifkan atau tidak.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Nilai yang Ditampilkan
true
Lapisan link mentah diaktifkan.
false
Lapisan link mentah dinonaktifkan.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Mentransisi radio dari Tidur ke Menerima.

Nyalakan radio.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil ditransisikan ke Terima.
OT_ERROR_INVALID_STATE
Radio dinonaktifkan atau ditransmisikan.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Menetapkan nilai penghitung frame MAC saat ini.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aMacFrameCounter
Nilai penghitung frame MAC.
Nilai yang Ditampilkan
OT_ERROR_NONE
Jika berhasil.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSetMacKey

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

Perbarui kunci MAC dan indeks kunci.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aKeyIdMode
Mode ID kunci.
[in] aKeyId
Indeks kunci.
[in] aPrevKey
Kunci MAC sebelumnya.
[in] aCurrKey
Kunci MAC saat ini.
[in] aNextKey
Kunci MAC berikutnya.
Nilai yang Ditampilkan
OT_ERROR_NONE
Jika berhasil.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Fungsi ini mengaktifkan atau menonaktifkan mode promiscuous.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aEnable
Nilai untuk mengaktifkan atau menonaktifkan mode promiscuous.
Nilai yang Ditampilkan
OT_ERROR_NONE
Jika berhasil.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Fungsi ini mengaktifkan/menonaktifkan lapisan tautan mentah.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aCallback
Pointer ke fungsi yang dipanggil saat menerima frame IEEE 802.15.4. NULL untuk menonaktifkan lapisan link mentah.
Nilai yang Ditampilkan
OT_ERROR_FAILED
Radio tidak dapat diaktifkan/dinonaktifkan.
OT_ERROR_INVALID_STATE
Jika antarmuka OpenThread IPv6 sudah diaktifkan.
OT_ERROR_NONE
Jika status pengaktifan berhasil ditetapkan.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Tetapkan Alamat Singkat untuk pemfilteran alamat.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aShortAddress
Alamat Pendek IEEE 802.15.4.
Nilai yang Ditampilkan
OT_ERROR_NONE
Jika berhasil.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Transisikan radio dari Terima ke Tidur.

Matikan radio.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil ditransisikan ke Tidur.
OT_ERROR_BUSY
Radio sedang ditransmisikan
OT_ERROR_INVALID_STATE
Radio dinonaktifkan

otLinkRawSrcMatchAddAddExtEntry

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

Menambahkan alamat yang diperluas ke tabel pencocokan sumber.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aExtAddress
Alamat yang diperluas untuk ditambahkan.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil menambahkan alamat yang diperluas ke tabel pencocokan sumber.
OT_ERROR_NO_BUFS
Tidak ada entri yang tersedia di tabel pencocokan sumber.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Menambahkan alamat singkat ke tabel pencocokan sumber.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aShortAddress
Alamat pendek yang akan ditambahkan.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil menambahkan alamat singkat ke tabel pencocokan sumber.
OT_ERROR_NO_BUFS
Tidak ada entri yang tersedia di tabel pencocokan sumber.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Menghapus semua alamat yang diperluas dari tabel pencocokan sumber.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Nilai yang Ditampilkan
OT_ERROR_NONE
Jika berhasil.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSrcMatchClearExtEntry

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

Menghapus alamat yang diperluas ke tabel pencocokan sumber radio.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aExtAddress
Alamat yang diperluas untuk dihapus.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil menghapus alamat yang diperluas dari tabel pencocokan sumber.
OT_ERROR_NO_ADDRESS
Alamat yang diperluas tidak berada dalam tabel pencocokan sumber.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Menghapus semua alamat singkat dari tabel pencocokan sumber.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Nilai yang Ditampilkan
OT_ERROR_NONE
Jika berhasil.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Menghapus alamat singkat ke tabel pencocokan sumber.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aShortAddress
Alamat yang akan dihapus.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil menghapus alamat singkat dari tabel pencocokan sumber.
OT_ERROR_NO_ADDRESS
Alamat pendek tidak ada dalam tabel pencocokan sumber.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Mengaktifkan/Menonaktifkan pencocokan sumber untuk frame yang tertunda.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aEnable
Mengaktifkan/menonaktifkan pencocokan sumber untuk frame yang tertunda.
Nilai yang Ditampilkan
OT_ERROR_NONE
Jika berhasil.
OT_ERROR_INVALID_STATE
Jika lapisan link mentah tidak diaktifkan.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Metode ini memulai urutan transmisi di radio.

Pemanggil harus membentuk bingkai IEEE 802.15.4 dalam buffer yang disediakan oleh otLinkRawGetTransmitBuffer() sebelum meminta transmisi. Saluran dan daya transmisi juga disertakan dalam struktur otRadioFrame.

Urutan transmisi terdiri dari:

  1. Mentransisi radio untuk Mengirim dari Terima.
  2. Mengirimkan PSDU di saluran yang diberikan dan pada daya transmisi yang diberikan.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aCallback
Pointer ke fungsi yang dipanggil saat transmisi selesai.
Nilai yang Ditampilkan
OT_ERROR_NONE
Berhasil ditransisikan ke Transmisi.
OT_ERROR_INVALID_STATE
Radio tidak dalam status Terima.

Resource

Topik Referensi OpenThread API berasal dari kode sumber, yang tersedia di GitHub. Untuk mengetahui informasi selengkapnya, atau untuk berkontribusi ke dokumentasi kami, lihat Referensi.