SNTP

Dieses Modul enthält Funktionen, die die SNTP-Kommunikation steuern.

Zusammenfassung

Typdefekt

otSntpQuery typedef
struct otSntpQuery
In dieser Struktur werden SNTP-Abfrageparameter implementiert.
otSntpResponseHandler)(void *aContext, uint64_t aTime, otError aResult) typedef
void(*
Dieser Funktionszeiger wird aufgerufen, wenn eine SNTP-Antwort eingeht.

Funktionen

otSntpClientQuery(otInstance *aInstance, const otSntpQuery *aQuery, otSntpResponseHandler aHandler, void *aContext)
Diese Funktion sendet eine SNTP-Abfrage.
otSntpClientSetUnixEra(otInstance *aInstance, uint32_t aUnixEra)
void
Mit dieser Funktion wird die Unix-Ära-Nummer festgelegt.

Bauwerke

otSntpQuery

In dieser Struktur werden SNTP-Abfrageparameter implementiert.

Typdefekt

otSntpQuery

struct otSntpQuery otSntpQuery

In dieser Struktur werden SNTP-Abfrageparameter implementiert.

otSntpResponseHandler

void(* otSntpResponseHandler)(void *aContext, uint64_t aTime, otError aResult)

Dieser Funktionszeiger wird aufgerufen, wenn eine SNTP-Antwort eingeht.

Details
Parameter
[in] aContext
Ein Zeiger auf anwendungsspezifischen Kontext.
[in] aTime
Gibt die Zeit auf dem Server an, zu der die Antwort für den Client zurückgegeben wurde, in UNIX-Zeit.
[in] aResult
Ergebnis der SNTP-Transaktion
Rückgabewerte
OT_ERROR_NONE
Eine Antwort wurde empfangen und die Zeit ist in aTime angegeben.
OT_ERROR_ABORT
Eine SNTP-Transaktion wurde durch den Stapel abgebrochen.
OT_ERROR_BUSY
Das Kiss-o-Tod-Paket wurde empfangen.
OT_ERROR_RESPONSE_TIMEOUT
Innerhalb des Zeitlimits wurde keine SNTP-Antwort empfangen.
OT_ERROR_FAILED
Es wurde eine Antwort empfangen, die falsche Daten enthält.

Funktionen

otSntpClientQuery

otError otSntpClientQuery(
  otInstance *aInstance,
  const otSntpQuery *aQuery,
  otSntpResponseHandler aHandler,
  void *aContext
)

Diese Funktion sendet eine SNTP-Abfrage.

Diese Funktion ist nur verfügbar, wenn die Funktion OPENTHREAD_CONFIG_SNTP_CLIENT_ENABLE aktiviert ist.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aQuery
Ein Zeiger zur Angabe von SNTP-Suchparametern.
[in] aHandler
Funktionszeiger, der beim Empfang oder bei einer Zeitüberschreitung der Antwort aufgerufen wird
[in] aContext
Ein Zeiger auf beliebige Kontextinformationen.

otSntpClientSetUnixEra

void otSntpClientSetUnixEra(
  otInstance *aInstance,
  uint32_t aUnixEra
)

Mit dieser Funktion wird die Unix-Ära-Nummer festgelegt.

Der Standardwert von Unix-Zeitalter ist 0. Die nachfolgenden Epochen beginnen nach Jahr 2106.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aUnixEra
Unix-Äranummer

Makros

OT_SNTP_DEFAULT_SERVER_IP

 OT_SNTP_DEFAULT_SERVER_IP "2001:4860:4806:8::"

Definiert die Standard-SNTP-Serveradresse – Google NTP-Server.

OT_SNTP_DEFAULT_SERVER_PORT

 OT_SNTP_DEFAULT_SERVER_PORT 123

Definiert den Standard-SNTP-Server-Port.

Ressourcen

Die OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen und einen Beitrag zu unserer Dokumentation finden Sie unter Ressourcen.