COMMON - Common Utilities#

SL_CTZ#

uint32_t SL_CTZ (uint32_t value)

Count trailing number of zeros.

Use CLZ instruction if available.

Returns

• A number of trailing zeros in value.

SL_RBIT#

uint32_t SL_RBIT (uint32_t value)

Reverse the bits.

Use the RBIT instruction if available, else process.

Returns

• A reversed value.

SL_RBIT16#

uint16_t SL_RBIT16 (uint16_t value)

Reverse the bits.

Use the RBIT instruction if available, else process.

Returns

• A 16-bit reversed value.

SL_RBIT8#

uint8_t SL_RBIT8 (uint8_t value)

Reverse the bits.

Use the RBIT instruction if available, else process.

Returns

• A 8-bit reversed value.

SL_Log2ToDiv#

uint32_t SL_Log2ToDiv (uint32_t log2)

Convert logarithm of 2 to division factor.

Returns

• Dividend.

SL_POPCOUNT32#

uint32_t SL_POPCOUNT32 (uint32_t bitfield)

Count the number of bits that are set to 1 in a 32-bit bitfield.

Returns

• The number of bits that are set to 1 in the bitfield.

_CONCAT_2#

#define _CONCAT_2

(first, second)

Macros to concatenate.

SL_CONCAT_PASTER_2#

#define SL_CONCAT_PASTER_2

(first, second)

sl concat paster 2.

_CONCAT_3#

#define _CONCAT_3

(first, second, third)

SL_CONCAT_PASTER_3#

#define SL_CONCAT_PASTER_3

(first, second, third)

sl concat paster 3.

_CONCAT_4#

#define _CONCAT_4

(first, second, third, fourth)

SL_CONCAT_PASTER_4#

#define SL_CONCAT_PASTER_4

(first, second, third, fourth)

sl concat paster 4.

SL_CEILING#

#define SL_CEILING

(n, i)

Round n up to closest interval of i.

SL_FLOOR#

#define SL_FLOOR

(n, i)

Round n down to closest interval of i.

STRINGIZE#

#define STRINGIZE

(X)

Stringify X.

SL_BRANCH_LIKELY#

#define SL_BRANCH_LIKELY

(x)

Macros for giving the compiler hints about the likelihood of a branch.

SL_BRANCH_UNLIKELY#

#define SL_BRANCH_UNLIKELY

(x)

SL_MIN#

#define SL_MIN

(a, b)

A macro for getting the minimum value.

No side-effects, a and b are evaluated one time only.

SL_MAX#

#define SL_MAX

(a, b)

A macro for getting the maximum value.

No side-effects, a and b are evaluated one time only.

SL_ATTRIBUTE_PACKED#

#define SL_ATTRIBUTE_PACKED

__attribute__ ((packed))

A GCC style macro for handling packed structures.

SL_PACK_START#

#define SL_PACK_START

A macro for handling packed structures.

Use this macro before the structure definition.
X denotes the maximum alignment of structure members. X is not supported with GCC. GCC always uses 1 byte maximum alignment.

SL_PACK_END#

#define SL_PACK_END

A macro for handling packed structures.

Use this macro after the structure definition.
With GCC, add SL_ATTRIBUTE_PACKED after the closing curly braces of the structure definition.

SL_ATTRIBUTE_ALIGN#

#define SL_ATTRIBUTE_ALIGN

(X)

GCC style macro for aligning a variable.

SL_ALIGN#

#define SL_ALIGN

A macro for aligning a variable.

Use this macro before the variable definition.
X denotes the storage alignment value in bytes.
To be GCC-compatible, use SL_ATTRIBUTE_ALIGN(X) before the semicolon on normal variables. Use SL_ATTRIBUTE_ALIGN(X) before the opening curly brace on structure variables.

SL_WEAK#

#define SL_WEAK

__attribute__ ((weak))

A macro for defining a weak symbol.

SL_NORETURN#

#define SL_NORETURN

__attribute__ ((noreturn))

A macro for handling non-returning functions.

SL_ATTRIBUTE_SECTION#

#define SL_ATTRIBUTE_SECTION

(X)

A macro for placing a variable in a section.

Use this macro after the variable definition, before the equal sign or a semicolon.
X denotes the section to place the variable in.

SL_FALLTHROUGH#

#define SL_FALLTHROUGH

A macro for notifying the compiler of an intended switch case fallthrough.

SL_IGNORE_TYPE_LIMIT_BEGIN#

#define SL_IGNORE_TYPE_LIMIT_BEGIN

A macro for notifying the compiler to ignore type limit check.

SL_IGNORE_TYPE_LIMIT_END#

#define SL_IGNORE_TYPE_LIMIT_END

A MACRO to notify the compiler, limit END.