ntptime — egyszerű NTP-kliens

Ez a modul egy kis klienst biztosít a Network Time Protocolhoz (NTP), amely hasznos az aktuális UTC-idő lekéréséhez egy internetes időszerverről, és opcionálisan a beépített valós idejű óra beállításához. Egyetlen UDP-kérést hajt végre egy NTP-szerver felé, és dekódolja a visszaadott 64 bites időbélyeget.

Ez a modul működő hálózati kapcsolatot igényel. A 32 bites, vezetéken továbbított időbélyeget automatikusan korrigálja a 2036-os NTP-túlcsordulásra, lehetővé téve, hogy az implementáció 2160 februárjáig érvényes maradjon.

Függvények

ntptime.time() → int

Lekérdezi a beállított NTP-szervert (host), és visszaadja az aktuális UTC-időt egész másodpercek számaként a MicroPython-korszak (epoch) óta.

A MicroPython-korszakot futásidőben a time.gmtime() segítségével ismeri fel. Mind az 1970-es (Unix), mind a 2000-es korszak támogatott; bármely más korszak Exception kivételt vált ki.

A hálózati hibák a hívóhoz propagálódnak; a mögöttes socket visszatérés előtt mindig lezáródik.

ntptime.settime() → None

Lekéri az aktuális időt a time() segítségével, és ennek megfelelően beállítja a beépített RTC-t a machine.RTC révén.

Vegye figyelembe, hogy a MicroPython nem támogatja az időzónákat: az RTC mindig UTC-ben kerül beállításra.

Konstansok

ntptime.host: str

A lekérdezendő NTP-szerver gazdaneve. Alapértelmezett értéke "pool.ntp.org". Futásidőben újra hozzárendelve felülírható, pl. ntptime.host = "time.google.com".

ntptime.timeout: int

Az NTP UDP-kérésre alkalmazott socket-időtúllépés másodpercben. Alapértelmezett értéke 1. Lassú vagy nagy késleltetésű hálózatokon növelje meg.