Skip to content

Blocking Delays

lbuild module: modm:architecture:delay

These functions allow you to spin for a short time using only the CPU.

You should always prefer Software Timers (see modm:processing:timer) over these blocking delay functions. However, when modm::Clock is not set up yet, or when you need very small delays (for example to bit-bang a protocol), you need to use these delay functions.

The only guarantee given to you is to delay for at least the specified time. Note that invocation of interrupts during spinning may add delay too.

No real-time guarantees!

You must not rely on delay functions for ANY time-keeping!

Delay functions work at any CPU clock speed, even if changed dynamically and are available very early in the startup process at hardware-init time.

Use the largest time unit possible!

Correct behavior is not guaranteed for delays over 1000ns, us or ms!