class RTC -- ساعة الوقت الحقيقي

تتحكم الفئة RTC في طرفية ساعة الوقت الحقيقي المدمجة في وحدة المعالجة الدقيقة، والتي تحفظ وقت الساعة الجدارية عبر عمليات إعادة الضبط.

على كاميرات OpenMV Cam المعتمدة على STM32، تشير machine.RTC وpyb.RTC إلى الكائن الأساسي نفسه.

مثال على الاستخدام:

import machine

rtc = machine.RTC()
rtc.datetime((2026, 1, 21, 2, 10, 32, 36, 0))
print(rtc.datetime())

البانيات (Constructors)

class machine.RTC(id: int = 0)

تُرجع نسخة RTC المفردة. يُقبل id للتوافق بين المنافذ لكن 0 فقط صالح على المنافذ التي يدعمها OpenMV (كل كاميرا لها RTC واحد).

الدوال أدناه مجمّعة حسب منافذ OpenMV التي تكشف عنها.

الدوال المتوفرة في جميع منافذ OpenMV

datetime(datetimetuple: tuple | None = None, /) → tuple | None

الحصول على التاريخ والوقت الحاليين أو ضبطهما.

بدون وسيطة، تُرجع القيمة الحالية كصف من 8 عناصر (year, month, day, weekday, hour, minute, second, subseconds).

مع وسيطة واحدة من صف ذي 8 عناصر، تضبط RTC على تلك القيمة.

weekday هو 1 = الاثنين حتى 7 = الأحد على STM32، و0 = الاثنين حتى 6 = الأحد على mimxrt. subseconds هو الجزء الكسري من الثانية بوحدات 1/256 من الثانية على STM32؛ على mimxrt وalif يكون دائماً 0.

STM32 + mimxrt فقط

init(datetime: tuple) → None

تهيئة RTC.

على منفذ mimxrt (OpenMV Cam RT1062) يكون datetime مطلوباً ويستخدم الصف ذا 8 عناصر (year, month, day, weekday, hour, minute, second, subseconds).

على كاميرات OpenMV Cam المعتمدة على STM32 لا تأخذ init() أي وسيطة: فهي تعيد تشغيل طرفية RTC، تاركةً التاريخ / الوقت الحالي دون مساس.

calibration(value: int | None = None, /) → int | None

الحصول على إزاحة معايرة RTC أو ضبطها (تُستخدم للتعويض عن خطأ تردد البلورة).

النطاق المقبول ووحدات value خاصة بالعتاد -- تُكتب القيمة مباشرة في سجل ضبط RTC في وحدة المعالجة الدقيقة. راجع دليل مرجع STM32 / i.MX RT ذي الصلة لمعرفة الترميز الدقيق.

STM32 فقط

info() → int

تُرجع حالة بدء تشغيل RTC المعبّأة كعدد صحيح من 32 بت.

تعطي الـ 16 بت المنخفضة عدد المللي ثانية التي استغرقتها RTC للبدء عند آخر إقلاع. تُضبط البتة 0x10000 عندما يفشل مذبذب LSE (الخارجي منخفض السرعة) وترتد RTC إلى LSI (الـ RC الداخلي). تُضبط البتة 0x20000 عندما تُهيأ RTC حديثاً عند الإقلاع (بدلاً من الاستمرار من التشغيل السابق).

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

جدولة مقاطعة إيقاظ دورية.

timeout_ms هو الفترة بالمللي ثانية. تنطلق RTC كل timeout_ms ويمكنها إيقاظ وحدة المعالجة الدقيقة من machine.lightsleep() / machine.deepsleep(). مرّر None لتعطيل مؤقت الإيقاظ.

يُستدعى callback من مقاطعة الإيقاظ؛ مرّر None لعدم تثبيت أي دالة رد نداء (سينطلق الإيقاظ ويوقظ وحدة المعالجة الدقيقة مع ذلك).

mimxrt + alif فقط

alarm(id: int, time: int | tuple, *, repeat: bool = False) → None

تسليح منبه RTC. يختار id قناة المنبه (استخدم ALARM0). time هو إما عدد صحيح من المللي ثانية في المستقبل، أو صف datetime. مرّر repeat=True لإعادة التسليح تلقائياً بعد كل انطلاق (صالح فقط عندما يكون time عدداً من المللي ثانية).

على alif يُدعم فقط شكل عدد المللي ثانية.

mimxrt فقط

alarm_left(alarm_id: int = 0, /) → int

تُرجع عدد المللي ثانية المتبقية قبل انطلاق المنبه المحدد بـ alarm_id.

alarm_cancel(alarm_id: int = 0, /) → None

إلغاء منبه مُسلّح سابقاً.

cancel(alarm_id: int = 0, /) → None

اسم بديل مهمل لـ alarm_cancel()، محفوظ للتوافق مع الإصدارات السابقة. مقرر إزالته في MicroPython 2.0.

irq(*, trigger: int = ALARM0, handler: Callable[[RTC], None] | None = None, wake: int = 0, hard: bool = False) → None

تسجيل دالة رد نداء لمنبه RTC.

يجب أن يكون trigger هو ALARM0 -- مصدر المقاطعة الوحيد المدعوم. يُستدعى handler مع نسخة RTC عند انطلاق المنبه. hard=True يسجّل معالج مقاطعة عتادية (دون تخصيص ذاكرة في الكومة داخل دالة رد النداء). يُقبل wake للتوافق بين المنافذ لكن ليس له تأثير.

الثوابت

ALARM0: int

معرّف قناة المنبه الوحيدة لـ RTC. مرّره إلى alarm() وalarm_left() وalarm_cancel() ووسيطة trigger في irq(). منفذ mimxrt فقط.