classe Timer – timer virtual periódico / de disparo único#

A classe Timer implementa um timer virtual gerenciado por software que agenda um callback Python uma vez (disparo único) ou repetidamente (periódico) em um dado período. Use-a quando você quiser uma maneira leve e portável entre portas de executar um callback de forma agendada – para recursos de nível de hardware (canais PWM, captura de entrada, modo de encoder, tempo morto, entrada de break, etc.) use pyb.Timer em seu lugar.

Disponível em todas as portas OpenMV.

Exemplo – callback periódico de 10 Hz:

from machine import Timer

def tick(t):
    print("tick")

tim = Timer(-1)
tim.init(period=100, callback=tick)   # 100 ms = 10 Hz

Exemplo – executar um callback uma vez após 2 segundos:

from machine import Timer

def fire(t):
    print("once")

Timer(-1).init(mode=Timer.ONE_SHOT, period=2000, callback=fire)

Construtores#

class machine.Timer(id: int = -1, /, *, mode: int = PERIODIC, period: int = -1, callback: Callable[[Timer], None] | None = None)#

Constrói um Timer virtual. id deve ser -1 (o único valor suportado). Quaisquer argumentos nomeados são encaminhados para init() para que o timer possa ser configurado em uma única chamada.

Métodos#

init(*, mode: int = PERIODIC, period: int = -1, callback: Callable[[Timer], None] | None = None) → None#

Inicializa / reinicializa o timer.

  • mode seleciona ONE_SHOT (dispara uma vez e para) ou PERIODIC (dispara repetidamente).

  • period é o período em milissegundos.

  • callback é invocado quando o timer dispara. Ele recebe a instância Timer como seu único argumento.

deinit() → None#

Para o timer e cancela qualquer callback pendente.

Constantes#

ONE_SHOT: int#

Passe para mode para que o timer dispare uma vez e então pare.

PERIODIC: int#

Passe para mode para que o timer dispare repetidamente em intervalos de period.