34. Lektion: NTP/RTC

Aus Attraktor Wiki

Wechseln zu: Navigation, Suche

Vorbereitung

Für diese Lektion muss die Funktion "Synchronisiere die Echtzeituhr des Gerätes" abgeschaltet werden.
Dieses geschieht unter Werkzeuge/Optionen/Interpreter:
Echtzeituhr ausschalten

Unix-Zeit

Micropython verwendet das Zeitkonzept von UNIX/LINUX. Es zählt die Sekunden, die seit dem Beginn der Epoche vergangen sind. Bei UNIX/LINUX ist das der 1.1.1970. In Micropython wird häufig der 1.1.2000 als Epochenbeginn genommen. Beim Pico entspricht die Epoche der von UNIX/LINUX.
ACHTUNG ESP32 und Pico arbeiten mit unterschiedlichen Epochen:

MicroPython v1.20.0 on 2023-04-26; Raspberry Pi Pico W with RP2040
>>> import time
>>> time.gmtime(0)
(1970, 1, 1, 0, 0, 0, 3, 1)
>>> 
MicroPython v1.20.0 on 2023-04-26; ESP32 module with ESP32
>>> import time
>>> time.gmtime(0)
(2000, 1, 1, 0, 0, 0, 5, 1)
>>> 

NTP/RTC

Mit Micropython auf unserem Pico haben wir zwei Zeitsysteme zur Verfügung. Das Eine ist die Netzzeit, die wir uns aus dem Internet herunterladen können. Das Andere ist die interne RealTimeClock (RTC) aus der wir das aktuelle Datum und die aktuelle Uhrzeit beziehen können.

NTP

Da der Pico keine Backup-Batterie an Board hat, so wie der PC, muss die RTC beim Programmstart gestellt werden. Wenn der Pico Kontakt zum Internet hat geht das ganz einfach:

# automatisches Stellen der RTC in Thonny wurde abgeschaltet.
# Thonny und der Pico wurden neu gestartet.

>>> import time

>>> import wlantools as wl
    connecting to network...
    network config: ('192.168.5.120', '255.255.255.0', '192.168.5.1', '192.168.5.1')

>>> time.localtime()
    (2021, 1, 1, 0, 0, 36, 4, 1)    # Hier sind Datum und Uhrzeit falsch.

>>> import ntptime
>>> ntptime.settime()
>>> time.localtime()
    (2024, 1, 10, 13, 33, 1, 2, 10)    # Hier sind Datum und Uhrzeit richtig.
>>> 

Mit ntptime.settime() wird die RTC mit der Netzzeit sychronisiert.
Das Modul ntptime bietet noch eine weitere Möglichkeiten: Mit der Methode time() bekommen wir die aktuelle Sekundenanzahl, den Timestamp.

>>> ntptime.time()
    1704895875

Wenn wir das Ergebnis in einer für uns lesbaren Form darstellen wollen, so geht das so:

>>> time.localtime(ntptime.time())
    (2024, 1, 10, 14, 24, 47, 2, 10)

Das Modul ntptime bietet uns also in erster Line eine einfache Möglichkeit die interne RTC zu stellen.

NTP-Server einstellen

Ob so der NTP-Server eingestellt werden kann muss noch getestet werden:

>>> ntptime.host = 'ntp.rz.tu-harburg.de'
>>> ntptime.host
'ntp.rz.tu-harburg.de'
>>> 

RTC

Die Klasse machine.RTC bietet uns nur eine Methode:

>>> dir(machine.RTC)
    ['__class__', '__name__', '__bases__', '__dict__', 'datetime']

Die Methode datetime()gibt die aktuelle Zeit/Datum aus, oder stellt die RTC wenn die Daten übergeben werden.

>>> import machine

>>> rtc = machine.RTC()

>>> rtc.datetime()
(2024, 2, 4, 6, 17, 10, 3, 0)

Die Daten werden in einem Tuple übergeben:
(Jahr, Monat, Tag, Wochentag, Stunden, Minuten, Sekunden, subseconds)
Wochentag ist eine Zahl von 0 bis 6. Die Woche beginnt am Montag.
Subseconds ist Hardwareabhängig.

Den Wochentag als Namen ausgeben

Mit einer Liste lassen sich die Namen der Wochentage ausgeben:
Übung

Das Module time

Das Modul time bietet 3 Methoden zum Umgang mit Datum und Uhrzeit:

gmtime()/localtime()

Geben ein Tupel mit den Datums- und Zeitdaten zurück. Das Tuple entspricht nicht ganz dem von rtc.datetime().
(Jahr, Monat, Tag, Stunden, Minuten, Sekunden, Wochentag, subseconds)

>>> import time

>>> time.gmtime()
    (2021, 1, 1, 0, 0, 16, 4, 1)

>>> time.localtime()
    (2021, 1, 1, 0, 0, 41, 4, 1)

mktime

Die Methode mktime() ist das Gegenteil zu gmtime()/localtime(). Sie erzeugt aus einem Tupel mit den Datums- und Zeitangaben einen Timestamp:

>>> import time

>>> time.mktime(time.localtime())
    1609459860

Beispiele

Hier folgen 2 Beispiele für die Anwendung der Datums- und Zeitfunktionen in Micropython.
Das erste Beispiel ist eine Funktion die das Datum als menschemlesbaren String erzeugt:

def get_date():
    import time
    date_time = time.localtime()
    return '-'.join((str(date_time[2]), str(date_time[1]), str(date_time[0])))

Das zweite Beispiel ist eine Funktion die die Uhrzeit als menschemlesbaren String erzeugt:

def get_time():
    import time
    date_time = time.localtime()
    return ':'.join((str(date_time[3]), str(date_time[4]), str(date_time[5])))

Wenn man diese beiden Funktionen in das Modul wlantools.py integriert hat man sie immer zur Hand.
So kann man die Werte in einem Rutsch in die entsprechenden Variablen laden:

>>> (year, month, mday, name_of_weekday, hour, minute, second, milisecond) = rtc.datetime()
>>> year
2024

Links

Hier ein paar Links zum Thema:

Navigation

Zurück zur "Micropython Kurs 2023 Teil 2" Startseite
Zurück zur "Micropython Kurs 2023" Startseite
Zurück zur Programmieren Startseite
Zurück zur Wiki Startseite

Diese Seite wurde zuletzt am 5. Februar 2024 um 23:00 Uhr geändert. Diese Seite wurde bisher 2.683 mal abgerufen.