Zephyr Project Requirements
Interrupts

Interrupts

STATEMENT:

SPDX-License-Identifier: Apache-2.0
ZEP-SRS-7-1
1. Installing static IRQ service routines (ISR).
UID: ZEP-SRS-7-1
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to initialize a static IRQ service routine (ISR), providing all parameters needed to configure the hardware and software.
ZEP-SRS-7-2
2. Static IRQ initial status.
UID: ZEP-SRS-7-2
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

The static IRQ shall be initially disabled.
ZEP-SRS-7-3
3. Installing direct IRQ service routines (ISR).
UID: ZEP-SRS-7-3
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to initialize a direct IRQ handler, providing all parameters needed to configure the hardware and software.
USER_STORY:

As the developer of low-power and low-latency applications, I need to implement ISRs that avoid the normal interrupt and power management overhead.
ZEP-SRS-7-4
4. Direct IRQ initial status.
UID: ZEP-SRS-7-4
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

The direct IRQ shall be initially disabled.
ZEP-SRS-7-5
5. Installing dynamic IRQ service routines (ISR).
UID: ZEP-SRS-7-5
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to initialize a dynamic IRQ service routine, providing all parameters needed to configure the hardware and software.
ZEP-SRS-7-6
6. Dynamic IRQ initial status.
UID: ZEP-SRS-7-6
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

The dynamic IRQ shall be initially disabled.
ZEP-SRS-7-7
7. Uninstalling dynamic IRQ service routines (ISR).
UID: ZEP-SRS-7-7
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to uninstall a dynamic ISR.
ZEP-SRS-7-8
8. Global IRQ disable
UID: ZEP-SRS-7-8
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to disable all IRQs on a CPU and return the state of the IRQ hardware prior to being disabled.
ZEP-SRS-7-9
9. Global IRQ enable
UID: ZEP-SRS-7-9
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to enable all IRQs on a CPU and return them to their previous state.
ZEP-SRS-7-10
10. Specific IRQ disable
UID: ZEP-SRS-7-10
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to disable a specified IRQ.
ZEP-SRS-7-11
11. Specific IRQ enable
UID: ZEP-SRS-7-11
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism to enable a specified IRQ.
ZEP-SRS-7-12
12. IRQ Enabled status
UID: ZEP-SRS-7-12
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism that returns the enabled status of a specified IRQ, where the status is enabled or disabled.
ZEP-SRS-7-13
13. ISR Context status
UID: ZEP-SRS-7-13
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

Zephyr RTOS shall provide a mechanism that returns the execution context, where the context is In-ISR or Not In-ISR.
USER_STORY:

As the developer of functions that may run in either ISR or THREAD context, I need to know the current context to enable conditional behavior.
ZEP-SRS-7-14
14. Multi-level interrupts
UID: ZEP-SRS-7-14
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

The Zephyr RTOS shall support multi-level preemptive interrupt priorities, when supported by hardware.
ZEP-SRS-7-15
15. Interrupt service routine invocation
UID: ZEP-SRS-7-15
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

When an enabled IRQ that has a connected interrupt service routine is asserted, the Zephyr RTOS shall invoke the associated interrupt service routine.
ZEP-SRS-7-16
16. Interrupt service routine parameter
UID: ZEP-SRS-7-16
STATUS: Draft
TYPE: Functional
COMPONENT: Interrupts
RELATIONS (Parent): STATEMENT:

When the Zephyr RTOS invokes a static or dynamic interrupt service routine, it shall pass to the routine the parameter that was registered with it.