class RTC – horloge temps réel

Le RTC est une horloge indépendante qui assure le suivi de la date et de l’heure.

Exemple d’utilisation

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

Constructeurs

class pyb.RTC

Crée un objet RTC.

Méthodes

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

Obtient ou définit la date et l’heure du RTC.

Sans argument, cette méthode retourne un 8-uplet contenant la date et l’heure actuelles. Avec 1 argument (un 8-uplet), elle définit la date et l’heure (et subseconds est réinitialisé à 255).

Le 8-uplet a le format suivant :

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

weekday va de 1 à 7 pour les jours du lundi au dimanche.

subseconds décompte de 255 à 0.

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

Configure le minuteur de réveil du RTC pour qu’il se déclenche de façon répétée toutes les timeout millisecondes. Ce déclenchement peut réveiller la carte de ses deux états de veille : pyb.stop() et pyb.standby().

Si timeout vaut None, alors le minuteur de réveil est désactivé.

Si callback est fourni, alors elle est exécutée à chaque déclenchement du minuteur de réveil. callback doit prendre exactement un argument – l’instance RTC qui a déclenché le réveil.

info() → int

Obtient des informations sur le temps de démarrage et la source de réinitialisation. L’entier 32 bits retourné est une valeur dont les bits sont compactés :

Bits	Signification
0x0000FFFF	Nombre de millisecondes qu’a mis le RTC à démarrer.
0x00010000	Défini si une réinitialisation à la mise sous tension s’est produite.
0x00020000	Défini si une réinitialisation externe s’est produite.

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

Obtient ou définit la valeur de calibration douce du RTC.

Sans argument, calibration() retourne la valeur de calibration actuelle, un entier dans la plage [-511, 512]. Avec un argument, elle définit la calibration.

Le mécanisme de calibration douce ajuste la fréquence d’horloge du RTC en ajoutant ou en soustrayant le nombre donné de tics à l’horloge de 32768 Hz sur une période de 32 secondes (2^20 tics d’horloge). Chaque tic positif accélère l’horloge de 1 partie sur 2^20 (≈0,954 ppm) ; les valeurs négatives ralentissent l’horloge de la même quantité par tic. La plage de calibration utilisable est donc d’environ -487.5 ppm à +488.5 ppm.