LCOV - code coverage report
Current view: top level - zephyr/arch/arc/v2 - irq.h Coverage Total Hit
Test: new.info Lines: 20.0 % 15 3
Test Date: 2025-09-05 20:47:19

            Line data    Source code
       1            1 : /*
       2              :  * Copyright (c) 2014 Wind River Systems, Inc.
       3              :  *
       4              :  * SPDX-License-Identifier: Apache-2.0
       5              :  */
       6              : 
       7              : /**
       8              :  * @file
       9              :  * @brief ARCv2 public interrupt handling
      10              :  *
      11              :  * ARCv2 kernel interrupt handling interface. Included by arc/arch.h.
      12              :  */
      13              : 
      14              : #ifndef ZEPHYR_INCLUDE_ARCH_ARC_V2_IRQ_H_
      15              : #define ZEPHYR_INCLUDE_ARCH_ARC_V2_IRQ_H_
      16              : 
      17              : #include <zephyr/arch/arc/v2/aux_regs.h>
      18              : #include <zephyr/toolchain/common.h>
      19              : #include <zephyr/irq.h>
      20              : #include <zephyr/sys/util.h>
      21              : #include <zephyr/sw_isr_table.h>
      22              : 
      23              : #ifdef __cplusplus
      24              : extern "C" {
      25              : #endif
      26              : 
      27            0 : #define ARC_MP_PRIMARY_CPU_ID 0
      28              : 
      29              : #ifndef _ASMLANGUAGE
      30              : 
      31              : extern void z_arc_firq_stack_set(void);
      32            0 : extern void arch_irq_enable(unsigned int irq);
      33            0 : extern void arch_irq_disable(unsigned int irq);
      34            0 : extern int arch_irq_is_enabled(unsigned int irq);
      35              : #ifdef CONFIG_TRACING_ISR
      36              : extern void sys_trace_isr_enter(void);
      37              : extern void sys_trace_isr_exit(void);
      38              : #endif
      39              : 
      40              : extern void z_irq_priority_set(unsigned int irq, unsigned int prio,
      41              :                               uint32_t flags);
      42              : 
      43              : /* Z_ISR_DECLARE will populate the .intList section with the interrupt's
      44              :  * parameters, which will then be used by gen_irq_tables.py to create
      45              :  * the vector table and the software ISR table. This is all done at
      46              :  * build-time.
      47              :  *
      48              :  * We additionally set the priority in the interrupt controller at
      49              :  * runtime.
      50              :  */
      51            0 : #define ARCH_IRQ_CONNECT(irq_p, priority_p, isr_p, isr_param_p, flags_p) \
      52              : { \
      53              :         Z_ISR_DECLARE(irq_p, 0, isr_p, isr_param_p); \
      54              :         z_irq_priority_set(irq_p, priority_p, flags_p); \
      55              : }
      56              : 
      57              : /**
      58              :  * Configure a 'direct' static interrupt.
      59              :  *
      60              :  * When firq has no separate stack(CONFIG_ARC_FIRQ_STACK=N), it's not safe
      61              :  * to call C ISR handlers because sp will be switched to bank1's sp which
      62              :  * is undefined value.
      63              :  * So for this case, the priority cannot be set to 0 but next level 1
      64              :  *
      65              :  * When firq has separate stack (CONFIG_ARC_FIRQ_STACK=y) but at the same
      66              :  * time stack checking is enabled (CONFIG_ARC_STACK_CHECKING=y)
      67              :  * the stack checking can raise stack check exception as sp is switched to
      68              :  * firq's stack (bank1's sp). So for this case, the priority cannot be set
      69              :  * to 0 but next level 1.
      70              :  *
      71              :  * Note that for the above cases, if application still wants to use firq by
      72              :  * setting priority to 0. Application can call z_irq_priority_set again.
      73              :  * Then it's left to application to handle the details of firq
      74              :  *
      75              :  * See include/irq.h for details.
      76              :  * All arguments must be computable at build time.
      77              :  */
      78            1 : #define ARCH_IRQ_DIRECT_CONNECT(irq_p, priority_p, isr_p, flags_p) \
      79              : { \
      80              :         Z_ISR_DECLARE_DIRECT(irq_p, ISR_FLAG_DIRECT, isr_p); \
      81              :         BUILD_ASSERT(priority_p || !IS_ENABLED(CONFIG_ARC_FIRQ) || \
      82              :         (IS_ENABLED(CONFIG_ARC_FIRQ_STACK) && \
      83              :         !IS_ENABLED(CONFIG_ARC_STACK_CHECKING)), \
      84              :         "irq priority cannot be set to 0 when CONFIG_ARC_FIRQ_STACK" \
      85              :         "is not configured or CONFIG_ARC_FIRQ_STACK " \
      86              :         "and CONFIG_ARC_STACK_CHECKING are configured together"); \
      87              :         z_irq_priority_set(irq_p, priority_p, flags_p); \
      88              : }
      89              : 
      90              : 
      91            0 : static inline void arch_isr_direct_header(void)
      92              : {
      93              : #ifdef CONFIG_TRACING_ISR
      94              :         sys_trace_isr_enter();
      95              : #endif
      96              : }
      97              : 
      98            0 : static inline void arch_isr_direct_footer(int maybe_swap)
      99              : {
     100              :         /* clear SW generated interrupt */
     101              :         if (z_arc_v2_aux_reg_read(_ARC_V2_ICAUSE) ==
     102              :             z_arc_v2_aux_reg_read(_ARC_V2_AUX_IRQ_HINT)) {
     103              :                 z_arc_v2_aux_reg_write(_ARC_V2_AUX_IRQ_HINT, 0);
     104              :         }
     105              : #ifdef CONFIG_TRACING_ISR
     106              :         sys_trace_isr_exit();
     107              : #endif
     108              : }
     109              : 
     110            0 : #define ARCH_ISR_DIRECT_HEADER() arch_isr_direct_header()
     111              : extern void arch_isr_direct_header(void);
     112              : 
     113            0 : #define ARCH_ISR_DIRECT_FOOTER(swap) arch_isr_direct_footer(swap)
     114              : 
     115              : #if defined(__CCAC__)
     116              : #define _ARC_DIRECT_ISR_FUNC_ATTRIBUTE          __interrupt__
     117              : #else
     118              : #define _ARC_DIRECT_ISR_FUNC_ATTRIBUTE          interrupt("ilink")
     119              : #endif
     120              : 
     121              : /*
     122              :  * Scheduling can not be done in direct isr. If required, please use kernel
     123              :  * aware interrupt handling
     124              :  */
     125            0 : #define ARCH_ISR_DIRECT_DECLARE(name) \
     126              :         static inline int name##_body(void); \
     127              :         __attribute__ ((_ARC_DIRECT_ISR_FUNC_ATTRIBUTE))void name(void) \
     128              :         { \
     129              :                 ISR_DIRECT_HEADER(); \
     130              :                 name##_body(); \
     131              :                 ISR_DIRECT_FOOTER(0); \
     132              :         } \
     133              :         static inline int name##_body(void)
     134              : 
     135              : 
     136              : /**
     137              :  *
     138              :  * @brief Disable all interrupts on the local CPU
     139              :  *
     140              :  * This routine disables interrupts.  It can be called from either interrupt or
     141              :  * thread level.  This routine returns an architecture-dependent
     142              :  * lock-out key representing the "interrupt disable state" prior to the call;
     143              :  * this key can be passed to irq_unlock() to re-enable interrupts.
     144              :  *
     145              :  * The lock-out key should only be used as the argument to the
     146              :  * irq_unlock() API.  It should never be used to manually re-enable
     147              :  * interrupts or to inspect or manipulate the contents of the source register.
     148              :  *
     149              :  * This function can be called recursively: it will return a key to return the
     150              :  * state of interrupt locking to the previous level.
     151              :  *
     152              :  * WARNINGS
     153              :  * Invoking a kernel routine with interrupts locked may result in
     154              :  * interrupts being re-enabled for an unspecified period of time.  If the
     155              :  * called routine blocks, interrupts will be re-enabled while another
     156              :  * thread executes, or while the system is idle.
     157              :  *
     158              :  * The "interrupt disable state" is an attribute of a thread.  Thus, if a
     159              :  * thread disables interrupts and subsequently invokes a kernel
     160              :  * routine that causes the calling thread to block, the interrupt
     161              :  * disable state will be restored when the thread is later rescheduled
     162              :  * for execution.
     163              :  *
     164              :  * @return An architecture-dependent lock-out key representing the
     165              :  * "interrupt disable state" prior to the call.
     166              :  */
     167              : 
     168            1 : static ALWAYS_INLINE unsigned int arch_irq_lock(void)
     169              : {
     170              :         unsigned int key;
     171              : 
     172              :         __asm__ volatile("clri %0" : "=r"(key):: "memory");
     173              :         return key;
     174              : }
     175              : 
     176            0 : static ALWAYS_INLINE void arch_irq_unlock(unsigned int key)
     177              : {
     178              :         __asm__ volatile("seti %0" : : "ir"(key) : "memory");
     179              : }
     180              : 
     181            0 : static ALWAYS_INLINE bool arch_irq_unlocked(unsigned int key)
     182              : {
     183              :         /* ARC irq lock uses instruction "clri r0",
     184              :          * r0 ==  {26’d0, 1’b1, STATUS32.IE, STATUS32.E[3:0] }
     185              :          * bit4 is used to record IE (Interrupt Enable) bit
     186              :          */
     187              :         return (key & 0x10)  ==  0x10;
     188              : }
     189              : 
     190              : #endif /* _ASMLANGUAGE */
     191              : 
     192              : #ifdef __cplusplus
     193              : }
     194              : #endif
     195              : 
     196              : #endif /* ZEPHYR_INCLUDE_ARCH_ARC_V2_IRQ_H_ */
        

Generated by: LCOV version 2.0-1