RTEMS 4.5.0 On-Line Library

Ada95 Interrupt Support Mapping Interrupts to POSIX Signals

BSP and Device Driver Development Guide

6.2: Mapping Interrupts to POSIX Signals

In Ada95, interrupts can be attached with the interrupt_attach pragma. For most systems, the gnat run-time will use POSIX signal to implement the interrupt handling, mapping one signal per interrupt. For interrupts to be propagated to the attached Ada handler, the corresponding signal must be raised when the interrupt occurs.

The same mechanism is used to generate Ada error exceptions. Three error exceptions are defined: program, constraint and storage error. These are generated by raising the predefined signals: SIGILL, SIGFPE and SIGSEGV. These signals should be raised when a spurious or erroneous trap occurs.

To enable gnat interrupt and error exception support for a particular bsp, the following has to be done:

Write an interrupt/trap handler that will raise the corresponding signal depending on the interrupt/trap number.
Install the interrupt handler for all interrupts/traps that will be handled by gnat (including spurious).
At startup, gnat calls __gnat_install_handler(). The bsp must provide this function which installs the interrupt/trap handlers.

Which cpu-interrupt will generate which signal is implementation defined. There are 32 POSIX signals (1 - 32), and all except the three error signals (SIGILL, SIGFPE and SIGSEGV) can be used. I would suggest to use the upper 16 (17 - 32) which do not have an assigned POSIX name.

Note that the pragma interrupt_attach will only bind a signal to a particular Ada handler - it will not unmask the interrupt or do any other things to enable it. This have to be done separately, typically by writing various device register.

BSP and Device Driver Development Guide