8.1. Introduction

Any real-time executive must provide a mechanism for quick response to externally generated interrupts to satisfy the critical time constraints of the application. The Interrupt Manager provides this mechanism for RTEMS. This manager permits quick interrupt response times by providing the critical ability to alter task execution which allows a task to be preempted upon exit from an ISR. The directives provided by the Interrupt Manager are:

• rtems_interrupt_catch() - Establishes an interrupt service routine.

• rtems_interrupt_disable() - Disables the maskable interrupts on the current processor.

• rtems_interrupt_enable() - Restores the previous interrupt level on the current processor.

• rtems_interrupt_flash() - Flashes interrupts on the current processor.

• rtems_interrupt_local_disable() - Disables the maskable interrupts on the current processor.

• rtems_interrupt_local_enable() - Restores the previous interrupt level on the current processor.

• rtems_interrupt_is_in_progress() - Checks if an ISR is in progress on the current processor.

• rtems_interrupt_lock_initialize() - Initializes the ISR lock.

• rtems_interrupt_lock_destroy() - Destroys the ISR lock.

• rtems_interrupt_lock_acquire() - Acquires the ISR lock.

• rtems_interrupt_lock_release() - Releases the ISR lock.

• rtems_interrupt_lock_acquire_isr() - Acquires the ISR lock from within an ISR.

• rtems_interrupt_lock_release_isr() - Releases the ISR lock from within an ISR.

• rtems_interrupt_lock_interrupt_disable() - Disables maskable interrupts on the current processor.

• RTEMS_INTERRUPT_LOCK_DECLARE() - Declares an ISR lock object.

• RTEMS_INTERRUPT_LOCK_DEFINE() - Defines an ISR lock object.

• RTEMS_INTERRUPT_LOCK_INITIALIZER() - Statically initializes an ISR lock object.

• RTEMS_INTERRUPT_LOCK_MEMBER() - Defines an ISR lock member.

• RTEMS_INTERRUPT_LOCK_REFERENCE() - Defines an ISR lock object reference.

• RTEMS_INTERRUPT_ENTRY_INITIALIZER() - Statically initializes an interrupt entry object.

• rtems_interrupt_entry_initialize() - Initializes the interrupt entry.

• rtems_interrupt_entry_install() - Installs the interrupt entry at the interrupt vector.

• rtems_interrupt_entry_remove() - Removes the interrupt entry from the interrupt vector.

• rtems_interrupt_handler_install() - Installs the interrupt handler routine and argument at the interrupt vector.

• rtems_interrupt_handler_remove() - Removes the interrupt handler routine and argument from the interrupt vector.

• rtems_interrupt_vector_is_enabled() - Checks if the interrupt vector is enabled.

• rtems_interrupt_vector_enable() - Enables the interrupt vector.

• rtems_interrupt_vector_disable() - Disables the interrupt vector.

• rtems_interrupt_is_pending() - Checks if the interrupt is pending.

• rtems_interrupt_raise() - Raises the interrupt vector.

• rtems_interrupt_raise_on() - Raises the interrupt vector on the processor.

• rtems_interrupt_clear() - Clears the interrupt vector.

• rtems_interrupt_get_priority() - Gets the priority of the interrupt vector.

• rtems_interrupt_set_priority() - Sets the priority of the interrupt vector.

• rtems_interrupt_get_affinity() - Gets the processor affinity set of the interrupt vector.

• rtems_interrupt_set_affinity() - Sets the processor affinity set of the interrupt vector.

• rtems_interrupt_get_attributes() - Gets the attributes of the interrupt vector.

• rtems_interrupt_handler_iterate() - Iterates over all interrupt handler installed at the interrupt vector.

• rtems_interrupt_server_initialize() - Initializes the interrupt server tasks.

• rtems_interrupt_server_create() - Creates an interrupt server.

• rtems_interrupt_server_handler_install() - Installs the interrupt handler routine and argument at the interrupt vector on the interrupt server.

• rtems_interrupt_server_handler_remove() - Removes the interrupt handler routine and argument from the interrupt vector and the interrupt server.

• rtems_interrupt_server_set_affinity() - Sets the processor affinity of the interrupt server.

• rtems_interrupt_server_delete() - Deletes the interrupt server.

• rtems_interrupt_server_suspend() - Suspends the interrupt server.

• rtems_interrupt_server_resume() - Resumes the interrupt server.

• rtems_interrupt_server_move() - Moves the interrupt handlers installed at the interrupt vector and the source interrupt server to the destination interrupt server.

• rtems_interrupt_server_handler_iterate() - Iterates over all interrupt handler installed at the interrupt vector and interrupt server.

• rtems_interrupt_server_entry_initialize() - Initializes the interrupt server entry.

• rtems_interrupt_server_action_prepend() - Prepends the interrupt server action to the list of actions of the interrupt server entry.

• rtems_interrupt_server_entry_destroy() - Destroys the interrupt server entry.

• rtems_interrupt_server_entry_submit() - Submits the interrupt server entry to be serviced by the interrupt server.

• rtems_interrupt_server_entry_move() - Moves the interrupt server entry to the interrupt server.

• rtems_interrupt_server_request_initialize() - Initializes the interrupt server request.

• rtems_interrupt_server_request_set_vector() - Sets the interrupt vector in the interrupt server request.

• rtems_interrupt_server_request_destroy() - Destroys the interrupt server request.

• rtems_interrupt_server_request_submit() - Submits the interrupt server request to be serviced by the interrupt server.