<libmaple/util.h>

Miscellaneous utility macros and procedures.

Bit Manipulation

The following macros are useful for bit manipulation.

BIT(shift)

1UL shifted left by ‘shift’

BIT_MASK_SHIFT(mask, shift)

‘Mask’ shifted left by ‘shift’

GET_BITS(x, m, n)

Bits m to n of x.

IS_POWER_OF_TWO(v)

True iff v is a power of two (1, 2, 4, 8, ...)

Failure Routines

throb() is called by various routines to throb a built-in LED. Usually, you shouldn’t call it yourself; use something like ASSERT(0) (or the libc abort() function) instead.

void throb(void)

Fades the error LED on and off.

Side Effects:

Sets output push-pull on ERROR_LED_PIN.

Asserts and Debug Levels

The level of libmaple’s assertion support is determined by DEBUG_LEVEL, as follows:

DEBUG_LEVEL

Controls the level of assertion checking.

The higher the debug level, the more assertions will be compiled in. This increases the amount of debugging information, but slows down (and increases the size of) the binary.

The debug levels, from lowest to highest, are DEBUG_NONE, DEBUG_FAULT, and DEBUG_ALL. The default level is DEBUG_ALL.

The current assert macros are ASSERT() and ASSERT_FAULT(). ASSERT() is checked when DEBUG_LEVEL >= DEBUG_ALL. ASSERT_FAULT() is checked whenever DEBUG_LEVEL >= DEBUG_FAULT.

As explained above, an assert macro is checked when the current DEBUG_LEVEL is high enough. If the debug level is too low, the macro expands into a no-op that gets compiled away.

If an assertion fails, execution is halted at the point of the failed assertion. When libmaple has been configured properly (Wirish performs this configuration by default), the built-in LED throbs in a smooth pattern to signal the failed assertion (using throb()), and the file and line where the assert failed are transmitted to the user as detailed in ASSERT(...).