class RTC – valós idejű óra

Az RTC egy független óra, amely nyilvántartja a dátumot és az időt.

Példa a használatra:

rtc = pyb.RTC()
rtc.datetime((2014, 5, 1, 4, 13, 0, 0, 0))
print(rtc.datetime())

Konstruktorok

class pyb.RTC

RTC objektum létrehozása.

Metódusok

datetime(datetimetuple: Tuple[int, int, int, int, int, int, int, int] | None = None) → Tuple[int, int, int, int, int, int, int, int] | None

Az RTC dátumának és idejének lekérdezése vagy beállítása.

Argumentumok nélkül ez a metódus egy 8 elemű rekordot (tuple) ad vissza az aktuális dátummal és idővel. 1 argumentummal (amely egy 8 elemű rekord) beállítja a dátumot és az időt (a subseconds pedig 255-re áll vissza).

A 8 elemű rekord formátuma a következő:

(year, month, day, weekday, hours, minutes, seconds, subseconds)

A weekday 1-7 értékű, hétfőtől vasárnapig.

A subseconds 255-től 0-ig számol vissza.

wakeup(timeout: int | None, callback: Callable[[RTC], None] | None = None) → None

Az RTC ébresztő-időzítőjének beállítása, hogy ismételten, minden timeout ezredmásodpercenként aktiválódjon. Ez az aktiválás mindkét alvási állapotból felébresztheti a kártyát: pyb.stop() és pyb.standby().

Ha a timeout None, akkor az ébresztő-időzítő le van tiltva.

Ha a callback meg van adva, akkor az az ébresztő-időzítő minden aktiválásakor végrehajtódik. A callback pontosan egy argumentumot kell, hogy fogadjon – az RTC példányt, amely az ébresztést kiváltotta.

info() → int

Információ lekérése az indítási időről és a visszaállítás forrásáról. A visszaadott 32 bites egész szám egy bitcsomagolt érték:

Bitek	Jelentés
0x0000FFFF	Az ezredmásodpercek száma, amennyi idő alatt az RTC elindult.
0x00010000	Beállítva, ha bekapcsolási visszaállítás (power-on reset) történt.
0x00020000	Beállítva, ha külső visszaállítás történt.

calibration(cal: int | None = None) → int | None

Az RTC simított kalibrációs értékének lekérdezése vagy beállítása.

Argumentumok nélkül a calibration() az aktuális kalibrációs értéket adja vissza, egy egész számot a [-511, 512] tartományban. Egy argumentummal beállítja a kalibrációt.

A simított kalibrációs mechanizmus úgy állítja be az RTC órajelét, hogy a megadott számú ütemet (tick) hozzáadja vagy kivonja a 32768 Hz-es órajelből egy 32 másodperces időszak (2^20 órajelütem) alatt. Minden pozitív ütem 1/2^20 arányban (≈0,954 ppm) gyorsítja az órát; a negatív értékek ütemenként ugyanennyivel lassítják az órát. A használható kalibrációs tartomány tehát megközelítőleg -487.5 ppm és +488.5 ppm között van.