SNTP

Dieses Modul enthält Funktionen zur Steuerung der SNTP-Kommunikation.

Zusammenfassung

Typedefs
otSntpQuery typedef
struct otSntpQuery
Implementiert SNTP-Abfrageparameter.
otSntpResponseHandler)(void *aContext, uint64_t aTime, otError aResult) typedef
void(*
Pointer wird aufgerufen, wenn eine SNTP-Antwort eingeht.

Funktionen
otSntpClientQuery(otInstance *aInstance, const otSntpQuery *aQuery, otSntpResponseHandler aHandler, void *aContext)
Sendet eine SNTP-Anfrage.
otSntpClientSetUnixEra(otInstance *aInstance, uint32_t aUnixEra)
void
Legt die Unix-Äranummer fest.

Strukturen
otSntpQuery

Implementiert SNTP-Abfrageparameter.

Typedefs

otSntpQuery

struct otSntpQuery otSntpQuery

Implementiert SNTP-Abfrageparameter.

otSntpResponseHandler

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

Pointer wird aufgerufen, wenn eine SNTP-Antwort eingeht.

Details
Parameter
[in] aContext
Ein Zeiger auf einen anwendungsspezifischen Kontext.
[in] aTime
Gibt die Zeit auf dem Server in UNIX-Zeit an, zu der die Antwort den Client verlassen hat.
[in] aResult
Ergebnis der SNTP-Transaktion
Rückgabewerte
OT_ERROR_NONE
Wir haben eine Antwort erhalten und die Zeit ist in aTime angegeben.
OT_ERROR_ABORT
Eine SNTP-Transaktion wurde vom Stack 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
Die Antwort ist eingegangen, enthält aber falsche Daten.

Funktionen

otSntpClientQuery

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

Sendet eine SNTP-Anfrage.

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 zum Angeben von SNTP-Abfrageparametern.
[in] aHandler
Ein Funktionszeiger, der beim Empfang einer Antwort oder bei einer Zeitüberschreitung aufgerufen wird.
[in] aContext
Ein Zeiger auf beliebige Kontextinformationen.

otSntpClientSetUnixEra

void otSntpClientSetUnixEra(
  otInstance *aInstance,
  uint32_t aUnixEra
)

Legt die Unix-Äranummer fest.

Der Standardwert für das Unix-Zeitalter ist 0. Die folgenden Epochen beginnen nach dem 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 Standardport des SNTP-Servers.

Ressourcen

OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen finden Sie unter Ressourcen. Dort können Sie auch einen Beitrag zu unserer Dokumentation leisten.