InterruptAttachEvent(), InterruptAttachEvent_r()

Подключить событие для прерывания

Прототип:

#include <sys/neutrino.h>
                                       
int InterruptAttachEvent( int intr,
                          const struct sigevent *event,
                          unsigned flags );
                                       
int InterruptAttachEvent_r( int intr,
                            const struct sigevent *event,
                            unsigned flags );

Аргументы:

intr: Номер прерывания для которого необходимо подключить получение события; см. Номера векторов прерывания.
event: Указатель на событие struct sigevent, которое будет получено при возникновении прерывания.
flags: Флаги, указывающие каким образом требуется подключить обработчик прерывания. См. “Флаги”.

Системные вызовы InterruptAttachEvent() и InterruptAttachEvent_r() подключают получение события при возникновении аппаратного прерывания intr. Прерывание при этом автоматически включается (размаскируется).

Функции идентичны за исключением способа возврата ошибок.

Перед вызовом любой из этих функций поток должен запросить привилегии ввода-вывода, вызвав:

ThreadCtl( _NTO_TCTL_IO, 0 );

Если поток этого не сделает, он может получить SIGSEGV при вызове InterruptAttachEvent() или InterruptAttachEvent_r().

Для предотвращения бесконечной рекурсии прерываний, ядро автоматически маскирует прерывание intr с помощью InterruptMask() при доставке события. После того, как поток обработки прерывания обработает событие, он должен вызвать InterruptUnmask(), чтобы размаскировать прерывание.

При выборе типа события учитывайте следующее:

В процессах, блокирующихся в цикле с приёмом сообщений MsgReceivev(), следует использовать SIGEV_PULSE для срабатывания отправки через канал.
В потоках, блокирующихся в определенных точках своего кода и не возвращающихся к общей точке приема сообщений, следует использовать SIGEV_INTR в качестве типа события и InterruptWait() в качестве блокирующего вызова.

Поток, вызывающий InterruptWait(), должен быть тем же, что вызвал InterruptAttachEvent().
Использование SIGEV_SIGNAL, SIGEV_SIGNAL_CODE или SIGEV_SIGNAL_THREAD не рекомендуется. Это менее эффективно, чем другие механизмы доставки событий.

В многоядерной системе поток, получающий событие, подключенное InterruptAttachEvent(), выполняется на любом ядре, ограничения накладываются только планировщиком и маской выполнения (см. ThreadCtl() и команду _NTO_TCTL_RUNMASK).

Флаги

Аргумент flags представляет собой либо 0, либо побитовое ИЛИ следующих значений:

_NTO_INTR_FLAGS_END

_NTO_INTR_FLAGS_PROCESS

_NTO_INTR_FLAGS_TRK_MSK

_NTO_INTR_FLAGS_END

Поместить новое событие в конец списка существующих событий вместо начала.

Аппаратное прерывание может быть разделяемым (один номер прерывания для нескольких устройств). Например, если два процесса вызывают InterruptAttachEvent() для одного и того же физического прерывания, оба события отправляются последовательно. Когда подключается новое событие, оно помещается перед любыми существующими событиями для этого прерывания и доставляется первым. Можно изменить это поведение, установив флаг _NTO_INTR_FLAGS_END в аргументе flags. Это добавит событие в конец списка любых существующих событий.

_NTO_INTR_FLAGS_PROCESS

Связать событие с процессом, а не потоком.

Добавление _NTO_INTR_FLAGS_PROCESS к флагам flags связывает получение события с процессом, а не потоком. Отключение события происходит при выходе из процесса, вместо потока.

Ядро пытается автоматически установить флаг _NTO_INTR_FLAGS_PROCESS, если событие предназначено процессу (для событий SIGEV_SIGNAL, SIGEV_SIGNAL_CODE и SIGEV_PULSE).

_NTO_INTR_FLAGS_TRK_MSK

Отслеживать количество вызовов InterruptMask() и InterruptUnmask(), чтобы сделать отключение обработчика прерываний более безопасным.

Флаг _NTO_INTR_FLAGS_TRK_MSK и аргумент id для InterruptMask() и InterruptUnmask() указывают ядру отслеживать, сколько раз было замаскировано конкретное прерывание. Затем, когда происходит отключение от прерывания, ядро выполняет необходимое количество размаскирований, чтобы гарантировать нормальную работу прерывания. Это важно для разделяемых прерываний.

Следует всегда устанавливать _NTO_INTR_FLAGS_TRK_MSK.

Преимущества и недостатки

InterruptAttachEvent() имеет несколько преимуществ по сравнению с InterruptAttach():

При возникновении прерывания выполняется меньше действий (не происходит переключения контекста, необходимого для переключения на обработчик прерывания).
Код обработки прерывания выполняется с приоритетом потока, что позволяет задавать приоритет обработки прерывания.
Можно использовать отладку на уровне процесса для кода обработчика прерываний.
Использование операций с плавающей точкой в обработчике прерывания (InterruptAttach()) небезопасно.

Недостатки:

Может возникнуть задержка перед запуском кода обработки прерывания (пока поток не будет запланирован для выполнения).
Увеличивается время маскирования прерывания при совместном использовании события для нескольких устройств.

Можно смешивать вызовы InterruptAttach() и InterruptAttachEvent() для конкретного прерывания.

Состояния блокировки:

Данный вызов неблокирующий.

Возвращаемое значение:

InterruptAttachEvent(): Идентификатор обработчика прерываний. Если возникла ошибка, функция возвращает -1, код ошибки записывается в errno.
InterruptAttachEvent_r(): Идентификатор обработчика прерываний. Функция НЕ устанавливает errno. При возникновении ошибки функция возвращает один из перечисленных ниже кодов.

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