classe RTC – relógio de tempo real

A classe RTC controla o periférico de relógio de tempo real on-chip do MCU, que mantém a hora de relógio de parede entre reinicializações.

Nas OpenMV Cams STM32, machine.RTC e pyb.RTC referem-se ao mesmo objeto subjacente.

Exemplo de uso:

import machine

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

Construtores

class machine.RTC(id: int = 0)

Retorna o singleton RTC. id é aceito para compatibilidade entre portas, mas apenas 0 é válido nas portas suportadas pela OpenMV (cada câmera tem um RTC).

Os métodos abaixo estão agrupados de acordo com quais portas OpenMV os expõem.

Métodos disponíveis em todas as portas OpenMV

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

Obtém ou define a data e a hora atuais.

Sem argumento, retorna o valor atual como uma tupla de 8 elementos (year, month, day, weekday, hour, minute, second, subseconds).

Com um único argumento de tupla de 8 elementos, define o RTC para esse valor.

weekday vai de 1 = segunda-feira até 7 = domingo no STM32, e de 0 = segunda-feira até 6 = domingo no mimxrt. subseconds é a parte fracionária do segundo em unidades de 1/256 de segundo no STM32; no mimxrt e no alif é sempre 0.

apenas STM32 + mimxrt

init(datetime: tuple) → None

Inicializa o RTC.

Na porta mimxrt (OpenMV Cam RT1062), datetime é obrigatório e usa a tupla de 8 elementos (year, month, day, weekday, hour, minute, second, subseconds).

Nas OpenMV cams STM32, init() não recebe argumento: ele (re)inicia o periférico RTC, deixando a data / hora atual intacta.

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

Obtém ou define o offset de calibração do RTC (usado para compensar o erro de frequência do cristal).

A faixa aceita e as unidades de value são específicas do hardware – o valor é escrito diretamente no registrador de trim do RTC do MCU. Consulte o manual de referência relevante do STM32 / i.MX RT para a codificação exata.

apenas STM32

info() → int

Retorna o status compactado de inicialização do RTC como um inteiro de 32 bits.

Os 16 bits inferiores indicam o número de milissegundos que o RTC levou para inicializar no boot mais recente. O bit 0x10000 é definido quando o oscilador LSE (externo de baixa velocidade) falhou e o RTC recorreu ao LSI (RC interno). O bit 0x20000 é definido quando o RTC foi recém-inicializado no boot (em vez de continuar a partir da ligação anterior).

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

Agenda uma interrupção periódica de despertar.

timeout_ms é o período em milissegundos. O RTC dispara a cada timeout_ms e pode acordar o MCU de machine.lightsleep() / machine.deepsleep(). Passe None para desabilitar o timer de despertar.

callback é invocado a partir da IRQ de despertar; passe None para não instalar nenhum callback (o despertar ainda será disparado e acordará o MCU).

apenas mimxrt + alif

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

Arma o alarme do RTC. id seleciona o canal de alarme (use ALARM0). time é um número inteiro de milissegundos no futuro ou uma tupla de datetime. Passe repeat=True para rearmar automaticamente após cada disparo (válido apenas quando time é uma contagem de milissegundos).

No alif, apenas a forma de contagem de milissegundos é suportada.

apenas mimxrt

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

Retorna o número de milissegundos restantes antes de o alarme identificado por alarm_id disparar.

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

Cancela um alarme previamente armado.

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

Alias obsoleto para alarm_cancel(), mantido para compatibilidade retroativa. Programado para remoção no MicroPython 2.0.

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

Registra um callback para o alarme do RTC.

trigger deve ser ALARM0 – a única fonte de IRQ suportada. handler é invocado com a instância de RTC quando o alarme dispara. hard=True registra um manipulador de interrupção de hardware (sem alocação de heap no callback). wake é aceito para compatibilidade entre portas, mas não tem efeito.

Constantes

ALARM0: int

Identificador para o único canal de alarme do RTC. Passe para alarm(), alarm_left(), alarm_cancel() e o argumento trigger de irq(). Apenas na porta mimxrt.