6.33.10 Атрибуты функций Epiphany

Эти атрибуты функций поддерживаются бэкендом Epiphany:

disinterrupt

Этот атрибут заставляет компилятор генерировать инструкции для отключения прерываний на время выполнения данной функции.

forwarder_section

Этот атрибут изменяет поведение обработчика прерываний. Обработчик прерываний может находиться во внешней памяти, недоступной для инструкции ветвления, поэтому генерируется локальный трамплин для передачи управления. Единственный параметр идентифицирует раздел, в котором размещается трамплин.

interrupt

Используйте этот атрибут, чтобы указать, что указанная функция является обработчиком прерываний. При наличии этого атрибута компилятор генерирует последовательности входа и выхода из функции, подходящие для использования в обработчике прерываний. Он также может сгенерировать специальный раздел с кодом для инициализации таблицы векторов прерываний.

На целевых устройствах Epiphany можно добавить один или несколько необязательных параметров, например:

void __attribute__ ((interrupt ("dma0, dma1"))) universal_dma_handler ();

Допустимые значения для этих параметров: reset, software_exception, page_miss, timer0, timer1, message, dma0, dma1, wand и swi. Несколько параметров указывают на то, что должны быть инициализированы несколько записей в таблице векторов прерываний для этой функции, то есть для каждого параметра name генерируется переход к функции в разделе ivt_entry_name. Параметр(ы) могут быть опущены полностью, в этом случае запись в таблице векторов прерываний не предоставляется.

Обратите внимание, что прерывания разрешены внутри функции, если не указан также атрибут disinterrupt.

Ниже приведены примеры допустимого использования этих атрибутов на целевых устройствах Epiphany:

void __attribute__ ((interrupt)) universal_handler ();
void __attribute__ ((interrupt ("dma1"))) dma1_handler ();
void __attribute__ ((interrupt ("dma0, dma1"))) 
  universal_dma_handler ();
void __attribute__ ((interrupt ("timer0"), disinterrupt))
  fast_timer_handler ();
void __attribute__ ((interrupt ("dma0, dma1"), 
                     forwarder_section ("tramp")))
  external_dma_handler ();

long_call

short_call

Эти атрибуты определяют, как вызывается конкретная функция. Эти атрибуты переопределяют переключатель командной строки -mlong-calls (см. Параметры Adapteva Epiphany) и настройки #pragma long_calls.