ntptime — eenvoudige NTP-client

Deze module biedt een kleine client voor het Network Time Protocol (NTP), handig voor het ophalen van de huidige UTC-tijd van een internettijdserver en eventueel het instellen van de ingebouwde real-time clock. Het voert een enkel UDP-verzoek uit naar een NTP-server en decodeert de geretourneerde 64-bits tijdstempel.

Deze module is afhankelijk van een werkende netwerkverbinding. De 32-bits tijdstempel op de leiding wordt automatisch gecorrigeerd voor de NTP-overloop van 2036, waardoor de implementatie geldig blijft tot februari 2160.

Functies

ntptime.time() → int

Bevraag de geconfigureerde NTP-server (host) en retourneer de huidige UTC-tijd als een geheel aantal seconden sinds het MicroPython-epoch.

Het MicroPython-epoch wordt tijdens runtime gedetecteerd met time.gmtime(). Zowel het epoch van 1970 (Unix) als dat van 2000 wordt ondersteund; elk ander epoch genereert Exception.

Netwerkfouten worden doorgegeven aan de aanroeper; de onderliggende socket wordt altijd gesloten voordat de functie terugkeert.

ntptime.settime() → None

Haal de huidige tijd op met time() en stel de ingebouwde RTC dienovereenkomstig in via machine.RTC.

Merk op dat MicroPython geen ondersteuning voor tijdzones heeft: de RTC wordt altijd in UTC ingesteld.

Constanten

ntptime.host: str

De hostnaam van de te bevragen NTP-server. Standaard "pool.ntp.org". Wijs tijdens runtime opnieuw toe om te overschrijven, bijv. ntptime.host = "time.google.com".

ntptime.timeout: int

Socket-time-out in seconden die wordt toegepast op het NTP-UDP-verzoek. Standaard 1. Verhoog deze waarde op trage netwerken of netwerken met hoge latentie.