ntptime — yksinkertainen NTP-asiakas

Tämä moduuli tarjoaa pienen asiakkaan Network Time Protocol -protokollalle (NTP), joka on hyödyllinen nykyisen UTC-ajan hakemiseen internetin aikapalvelimelta ja valinnaisesti sisäänrakennetun reaaliaikakellon asettamiseen. Se suorittaa yhden UDP-pyynnön NTP-palvelimelle ja purkaa palautetun 64-bittisen aikaleiman.

Tämä moduuli edellyttää toimivaa verkkoyhteyttä. Sen 32-bittinen siirtotien aikaleima korjataan automaattisesti vuoden 2036 NTP-ylivuodon varalta, jolloin toteutus pysyy pätevänä helmikuuhun 2160 asti.

Funktiot

ntptime.time() → int

Kysele määritetyltä NTP-palvelimelta (host) ja palauta nykyinen UTC-aika kokonaislukuna sekunteina MicroPythonin epookista lähtien.

MicroPythonin epookki tunnistetaan ajonaikaisesti funktiolla time.gmtime(). Sekä vuoden 1970 (Unix) että vuoden 2000 epookit ovat tuettuja; mikä tahansa muu epookki nostaa poikkeuksen Exception.

Verkkovirheet välittyvät kutsujalle; alla oleva soketti suljetaan aina ennen paluuta.

ntptime.settime() → None

Hae nykyinen aika funktiolla time() ja aseta sisäänrakennettu RTC sen mukaisesti luokan machine.RTC kautta.

Huomaa, että MicroPythonissa ei ole aikavyöhyketukea: RTC asetetaan aina UTC-ajassa.

Vakiot

ntptime.host: str

Kyseltävän NTP-palvelimen isäntänimi. Oletusarvo on "pool.ntp.org". Aseta uudelleen ajonaikaisesti ohittaaksesi sen, esim. ntptime.host = "time.google.com".

ntptime.timeout: int

Soketin aikakatkaisu sekunteina, jota sovelletaan NTP-UDP-pyyntöön. Oletusarvo on 1. Kasvata hitailla tai suuriviiveisillä verkoilla.