6.57.8 Встроенные функции AVR

Для каждой встроенной функции AVR определён одноимённый, заглавный встроенный макрос. Таким образом, пользователи могут легко проверить, реализована ли конкретная встроенная функция или нет. Например, если __builtin_avr_nop доступна, макрос __BUILTIN_AVR_NOP определён как 1, в противном случае он не определён.

Следующие встроенные функции отображаются на соответствующие машинные инструкции, т.е. nop, sei, cli, sleep, wdr, swap, fmul, fmuls соответственно fmulsu. Три встроенные функции fmul* реализованы как вызовы библиотеки, если нет аппаратного умножителя.

void __builtin_avr_nop (void)
void __builtin_avr_sei (void)
void __builtin_avr_cli (void)
void __builtin_avr_sleep (void)
void __builtin_avr_wdr (void)
unsigned char __builtin_avr_swap (unsigned char)
unsigned int __builtin_avr_fmul (unsigned char, unsigned char)
int __builtin_avr_fmuls (char, char)
int __builtin_avr_fmulsu (char, unsigned char)

Для задержки выполнения на определённое количество циклов GCC реализует

void __builtin_avr_delay_cycles (unsigned long ticks)

ticks — количество тактов для задержки выполнения. Обратите внимание, что эта встроенная функция не учитывает влияние прерываний, которые могут увеличить время задержки. ticks должно быть целочисленной константой времени компиляции; задержки с переменным количеством циклов не поддерживаются.

char __builtin_avr_flash_segment (const __memx void*)

Эта встроенная функция принимает байтовый адрес 24-битного адресного пространства __memx и возвращает номер флеш-сегмента (блока размером 64 КБ), к которому указывает адрес. Счёт начинается с 0. Если адрес не указывает на флеш-память, возвращается -1.

unsigned char __builtin_avr_insert_bits (unsigned long map, unsigned char bits, unsigned char val)

Вставить биты из bits в val и вернуть полученное значение. Ниблы из map определяют, как выполняется вставка: пусть X — n-ый нибл map

1. Если X равно 0xf, то n-ый бит val возвращается без изменений.
2. Если X находится в диапазоне 0...7, то n-ый результирующий бит устанавливается в X-ый бит bits
3. Если X находится в диапазоне 8...0xe, то n-ый результирующий бит не определён.

Типичное применение этой встроенной функции — настройка входных и выходных значений для несмежных схем портов. Некоторые примеры:

// same as val, bits is unused
__builtin_avr_insert_bits (0xffffffff, bits, val)

// same as bits, val is unused
__builtin_avr_insert_bits (0x76543210, bits, val)

// same as rotating bits by 4
__builtin_avr_insert_bits (0x32107654, bits, 0)

// high nibble of result is the high nibble of val
// low nibble of result is the low nibble of bits
__builtin_avr_insert_bits (0xffff3210, bits, val)

// reverse the bit order of bits
__builtin_avr_insert_bits (0x01234567, bits, 0)