Lain-lain

Modul ini mencakup abstraksi platform untuk berbagai perilaku.

Ringkasan

Enumerasi

otPlatMcuPowerState{
  OT_PLAT_MCU_POWER_STATE_ON = 0,
  OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
  OT_PLAT_MCU_POWER_STATE_OFF = 2
}
enum
Enumerasi status daya pengontrol mikro.
otPlatResetReason enum
Enumerasi kemungkinan kode alasan reset.

Fungsi

otPlatAssertFail(const char *aFilename, int aLineNumber)
void
Menyediakan implementasi khusus platform untuk pernyataan.
otPlatGetMcuPowerState(otInstance *aInstance)
Mendapatkan status daya MCU yang diinginkan saat ini.
otPlatGetResetReason(otInstance *aInstance)
Menampilkan alasan reset platform terakhir.
otPlatReset(otInstance *aInstance)
void
Melakukan reset software di platform, jika didukung.
otPlatResetToBootloader(otInstance *aInstance)
Melakukan reset hardware pada platform untuk meluncurkan mode bootloader, jika didukung.
otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)
Menyetel status daya MCU yang diinginkan.
otPlatWakeHost(void)
void
Melakukan operasi khusus platform untuk mengaktifkan MCU host.

Enumerasi

otPlatMcuPowerState

 otPlatMcuPowerState

Enumerasi status daya pengontrol mikro.

Nilai ini digunakan untuk konfigurasi NCP saat OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL diaktifkan.

Status daya menentukan status daya yang diinginkan untuk mikro-pengontrol (MCU) NCP saat sistem operasi platform yang mendasarinya memasuki mode tidak ada aktivitas (yaitu, semua tugas/peristiwa aktif diproses dan MCU berpotensi memasuki status daya hemat energi).

Status daya terutama menentukan cara host berinteraksi dengan NCP dan apakah host memerlukan pemicu eksternal ("poke") ke NCP sebelum dapat berkomunikasi dengan NCP atau tidak.

Setelah direset, status daya MCU HARUS OT_PLAT_POWER_STATE_ON.

Properti
OT_PLAT_MCU_POWER_STATE_LOW_POWER

MCU NCP dapat memasuki status daya rendah (hemat energi).

Jika status daya yang diinginkan NCP disetel ke LOW_POWER, host diharapkan untuk "mencolok" NCP (mis., pemicu eksternal seperti interupsi) sebelum dapat berkomunikasi dengan NCP (mengirim pesan ke NCP). Mekanisme "poke" ditentukan oleh kode platform (berdasarkan antarmuka NCP ke host).

Saat status daya disetel ke LOW_POWER, NCP tetap dapat (kapan saja) mengirim pesan ke host. Perhatikan bahwa menerima pesan dari NCP TIDAK menunjukkan bahwa status daya NCP telah berubah, yaitu, host diharapkan terus "poke" ketika ingin berbicara dengan NCP hingga status daya diubah secara eksplisit (dengan panggilan yang berhasil ke otPlatSetMcuPowerState() mengubah status menjadi ON).

OT_PLAT_MCU_POWER_STATE_OFF

NCP sepenuhnya nonaktif.

Reset hardware NCP (melalui pin RESET) diperlukan untuk mengembalikan NCP ke SPINEL_MCU_POWER_STATE_ON. RAM tidak dipertahankan setelah direset.

OT_PLAT_MCU_POWER_STATE_ON

MCU NCP tetap aktif dan aktif sepanjang waktu.

Jika status daya yang diinginkan NCP disetel ke ON, host dapat mengirim pesan ke NCP tanpa memerlukan "poke" atau pemicu eksternal.

otPlatResetReason

 otPlatResetReason

Enumerasi kemungkinan kode alasan reset.

Ini memiliki urutan yang sama dengan kode alasan {i>reset<i} Spinel.

Fungsi

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

Menyediakan implementasi khusus platform untuk pernyataan.

Detail
Parameter
[in] aFilename
Nama file tempat pernyataan terjadi.
[in] aLineNumber
Nomor baris dalam file tempat pernyataan terjadi.

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

Mendapatkan status daya MCU yang diinginkan saat ini.

Hal ini hanya berlaku dan digunakan untuk konfigurasi NCP saat OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL diaktifkan.

Setelah direset, status daya HARUS menampilkan OT_PLAT_POWER_STATE_ON. Selama operasi, status daya HARUS berubah hanya melalui panggilan eksplisit yang berhasil ke otPlatSetMcuPowerState().

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Hasil
Status daya saat ini.

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

Menampilkan alasan reset platform terakhir.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.

otPlatReset

void otPlatReset(
  otInstance *aInstance
)

Melakukan reset software di platform, jika didukung.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.

otPlatResetToBootloader

otError otPlatResetToBootloader(
  otInstance *aInstance
)

Melakukan reset hardware pada platform untuk meluncurkan mode bootloader, jika didukung.

Digunakan saat OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE diaktifkan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
Nilai Pengembalian
OT_ERROR_NONE
Berhasil direset ke bootloader.
OT_ERROR_BUSY
Gagal karena operasi lain sedang berlangsung.
OT_ERROR_NOT_CAPABLE
Tidak dapat mereset ke bootloader.

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

Menyetel status daya MCU yang diinginkan.

Hal ini hanya berlaku dan digunakan untuk konfigurasi NCP saat OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL diaktifkan.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aState
Status daya MCU baru.
Nilai Pengembalian
OT_ERROR_NONE
Status daya berhasil diperbarui.
OT_ERROR_FAILED
Status daya MCU yang diberikan tidak didukung oleh platform.

otPlatWakeHost

void otPlatWakeHost(
  void
)

Melakukan operasi khusus platform untuk mengaktifkan MCU host.

Ini hanya digunakan untuk konfigurasi NCP.

Referensi

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