RTDX_interrupt_mask

What is RTDX_interrupt_mask ?
Most RTDX function calls can be made from multiple threads, even inside interrupt handlers.However, the global data structures modified by these functions must be protected so that only one function at a time can modicy them.

For this purpose, the symbol _RTDX_interrupt_mask is defined at link time to identify clients of RTDX and protect RTDX critical sections. _RTDX_interrupt_mask specifies the interrupts to be temporarily disabled inside RTDX critical sections. This also temporarily disables the other clients of RTDX and prevents another RTDX function call.

Only those interrupts that may call an RTDX function need to be masked. With this design, you can carefully select the interrupts to be disabled. Other non-masked interrupts will still occur even inside RTDX critical sections.

For TMS320C54x applications, the mask is applied to the IMR register just befor entering the critical section, disabling only those interrupts specified. Upon exiting the critical section, the IMR is restored to its prior value.

The symbol _RTDX_interrupt_mask must be specified in the linker command file. The interrupts to be masked are indicated by a zero at the appropriate bit position. In the example below, the ones complementer operator (~) is used to define the symbol.


_RTDX_interrupt_mask = ~0x0008;
/* interrupts masked by RTDX */


This definition of _RTDX_interrupt_mask disables the timer interrupt when entering an RTDX critical section