类 Timer – 控制硬件定时器

硬件定时器处理周期和事件的时间。定时器可能是MCU和SoC中最灵活和异构的硬件类型,从一个模型到另一个模型的差别很大。 MicroPython的Timer类定义了在给定时间段内(或在一段延迟后执行一次回调)执行回调的基线操作,并允许特定的板定义更多的非标准行为(因此不能移植到其他板)。

请参阅有关Timer回调的 重要约束

Note

内存不能在irq处理程序(中断)中分配,因此处理程序中引发的异常不会提供太多信息。 了解 micropython.alloc_emergency_exception_buf() 如何解决此限制。

构建对象

class machine.Timer(id, ...)

构造给定id的新计时器对象。

  • id - 任意正整数

方法

Timer.init(\*, mode=Timer.PERIODIC, period=-1, callback=None)
  • mode - 定时器模式,可以是以下之一:

    • Timer.ONE_SHOT - 计时器运行一次,直到配置完毕通道的期限到期。

    • Timer.PERIODIC - 定时器以通道的配置频率定期运行。

  • period - 定时器执行的周期,单位是ms, 隔period ms 执行一次。 period取值范围: 0 < period <= 3435973836

  • callback - 定时器的回调函数

初始化计时器,示例:

tim.init(period=100)                         # periodic with 100ms period
tim.init(mode=Timer.ONE_SHOT, period=1000)   # one shot firing after 1000ms
Timer.value()

获取并返回计时器当前计数值。

value = tim.value()
print(value)
Timer.deinit()

取消定时器的初始化。停止计时器,并禁用计时器外围设备。

常数

Timer.ONE_SHOT
Timer.PERIODIC