OS20 User Manual 16.2 OS20 function descriptions
interrupt_status
Report the status of an interrupt level
Synopsis
#include <interrup.h> int interrupt_status( int Level, interrupt_status_t* Status, interrupt_status_flags_t flags );
Arguments int Level interrupt_status_t* Status
Interrupt level
Pointer to a structure that the current status can be written to interrupt_status_flags_t flags What information to return
Results
Returns 0 for success, -1 if an error occurs.
Errors
Returns -1 if the interrupt level is illegal.
Description
This function returns useful information about an interrupt level. This information can be of benefit when debugging an application.
Structure member interrupt_numbers interrupt_stack_base interrupt_stack_size interrupt_stack_used interrupt_time interrupt_count
Meaning
Number of interrupt handlers attached to this level
Pointer to the base of the stack space for this level
Size of the stack for this level, in bytes
Peak stack usage in bytes
Ti level a
Number of times an interrupt at this level has been serviced
a
Table 48: The interrupt_status_t structure a.
interrupt_time and interrupt_count should not be used on the standard OS20 deployment kernel, which does not record this data as it decreases interrupt performance. Refer to
Section 15.3.4
for details of kernels which support these fields.
176
ADCS 7473749D
16.2 OS20 function descriptions 16 Alphabetical list of functions
The Flags parameter is used to indicate which values should be returned. Values which can be determined immediately (all except interrupt_stack_used ) are always returned. If only these fields are required then Flags should be set to 0 . However, calculating peak stack usage may take a while, and so is only returned when Flags is set to interrupt_status_flags_stack_used .
Applies to
ILC-None, ILC-1, ILC-2, ILC-3.
Callable from
Tasks only
See also
interrupt_status_number
177
ADCS 7473749D
