root/sys/arch/arm/ofw/ofw_irqhandler.c
/*      $NetBSD: ofw_irqhandler.c,v 1.23 2020/11/20 18:26:26 thorpej Exp $      */

/*
 * Copyright (c) 1994-1998 Mark Brinicombe.
 * Copyright (c) 1994 Brini.
 * All rights reserved.
 *
 * This code is derived from software written for Brini by Mark Brinicombe
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *      This product includes software developed by Mark Brinicombe
 *      for the NetBSD Project.
 * 4. The name of the company nor the name of the author may be used to
 *    endorse or promote products derived from this software without specific
 *    prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *      from: irqhandler.c
 *
 * IRQ/FIQ initialisation, claim, release and handler routines
 *
 * Created      : 30/09/94
 */

#include <sys/cdefs.h>
__KERNEL_RCSID(0, "$NetBSD: ofw_irqhandler.c,v 1.23 2020/11/20 18:26:26 thorpej Exp $");

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/syslog.h>
#include <sys/kmem.h>

#include <sys/intr.h>
#include <machine/irqhandler.h>
#include <machine/cpu.h>

irqhandler_t *irqhandlers[NIRQS];

u_int current_mask;
u_int actual_mask;
u_int disabled_mask;
u_int irqmasks[NIPL];

/* Prototypes */

int podule_irqhandler(void);
extern void set_spl_masks(void);

/*
 * void irq_init(void)
 *
 * Initialise the IRQ/FIQ sub system
 */

void
irq_init(void)
{
        int loop;

        /* Clear all the IRQ handlers and the irq block masks */
        for (loop = 0; loop < NIRQS; ++loop) {
                irqhandlers[loop] = NULL;
        }

        /*
         * Setup the irqmasks for the different Interrupt Priority Levels
         * We will start with no bits set and these will be updated as handlers
         * are installed at different IPL's.
         */
        for (loop = 0; loop < NIPL; ++loop)
                irqmasks[loop] = 0;

        current_mask = 0x00000000;
        disabled_mask = 0x00000000;
        actual_mask = 0x00000000;

        set_spl_masks();

        /* Enable IRQ's and FIQ's */
        enable_interrupts(I32_bit | F32_bit); 
}


/*
 * int irq_claim(int irq, irqhandler_t *handler)
 *
 * Enable an IRQ and install a handler for it.
 */

int
irq_claim(int irq, irqhandler_t *handler, const char *group, const char *name)
{
        int level;

#ifdef DIAGNOSTIC
        /* Sanity check */
        if (handler == NULL)
                panic("NULL interrupt handler");
        if (handler->ih_func == NULL)
                panic("Interrupt handler does not have a function");
#endif  /* DIAGNOSTIC */

        /*
         * IRQ_INSTRUCT indicates that we should get the irq number
         * from the irq structure
         */
        if (irq == IRQ_INSTRUCT)
                irq = handler->ih_num;
    
        /* Make sure the irq number is valid */
        if (irq < 0 || irq >= NIRQS)
                return(-1);

        /* Make sure the level is valid */
        if (handler->ih_level < 0 || handler->ih_level >= NIPL)
                return(-1);

        evcnt_attach_dynamic(&handler->ih_ev, EVCNT_TYPE_INTR, NULL,
            group, name);

        /* Attach handler at top of chain */
        handler->ih_next = irqhandlers[irq];
        irqhandlers[irq] = handler;

        /*
         * Reset the flags for this handler.
         * As the handler is now in the chain mark it as active.
         */
        handler->ih_flags = 0 | IRQ_FLAG_ACTIVE;

        /*
         * Record the interrupt number for accounting.
         * Done here as the accounting number may not be the same as the
         * IRQ number though for the moment they are
         */
        handler->ih_num = irq;

        /*
         * Update the irq masks.
         * Find the lowest interrupt priority on the irq chain.
         * Interrupt is allowable at priorities lower than this.
         * If ih_level is out of range then don't bother to update
         * the masks.
         */
        if (handler->ih_level >= 0 && handler->ih_level < NIPL) {
                irqhandler_t *ptr;

                /*
                 * Find the lowest interrupt priority on the irq chain.
                 * Interrupt is allowable at priorities lower than this.
                 */
                ptr = irqhandlers[irq];
                if (ptr) {
                        level = ptr->ih_level - 1;
                        while (ptr) {
                                if (ptr->ih_level - 1 < level)
                                        level = ptr->ih_level - 1;
                                ptr = ptr->ih_next;
                        }
                        while (level >= 0) {
                                irqmasks[level] |= (1 << irq);
                                --level;
                        }
                }

#include "sl.h"
#include "ppp.h"
#if NSL > 0 || NPPP > 0
                /* In the presence of SLIP or PPP, splimp > spltty. */
                irqmasks[IPL_NET] &= irqmasks[IPL_TTY];
#endif
        }

        enable_irq(irq);
        set_spl_masks();

        return(0);
}


/*
 * int irq_release(int irq, irqhandler_t *handler)
 *
 * Disable an IRQ and remove a handler for it.
 */

int
irq_release(int irq, irqhandler_t *handler)
{
        int level;
        irqhandler_t *irqhand;
        irqhandler_t **prehand;

        /*
         * IRQ_INSTRUCT indicates that we should get the irq number
         * from the irq structure
         */
        if (irq == IRQ_INSTRUCT)
                irq = handler->ih_num;

        /* Make sure the irq number is valid */
        if (irq < 0 || irq >= NIRQS)
                return(-1);

        /* Locate the handler */
        irqhand = irqhandlers[irq];
        prehand = &irqhandlers[irq];
    
        while (irqhand && handler != irqhand) {
                prehand = &irqhand;
                irqhand = irqhand->ih_next;
        }

        /* Remove the handler if located */
        if (irqhand)
                *prehand = irqhand->ih_next;
        else
                return(-1);

        /* Now the handler has been removed from the chain mark is as inactive */
        irqhand->ih_flags &= ~IRQ_FLAG_ACTIVE;

        /* Make sure the head of the handler list is active */
        if (irqhandlers[irq])
                irqhandlers[irq]->ih_flags |= IRQ_FLAG_ACTIVE;

        /*
         * Update the irq masks.
         * If ih_level is out of range then don't bother to update
         * the masks.
         */
        if (handler->ih_level >= 0 && handler->ih_level < NIPL) {
                irqhandler_t *ptr;

                /* Clean the bit from all the masks */
                for (level = 0; level < NIPL; ++level)
                        irqmasks[level] &= ~(1 << irq);

                /*
                 * Find the lowest interrupt priority on the irq chain.
                 * Interrupt is allowable at priorities lower than this.
                 */
                ptr = irqhandlers[irq];
                if (ptr) {
                        level = ptr->ih_level - 1;
                        while (ptr) {
                                if (ptr->ih_level - 1 < level)
                                        level = ptr->ih_level - 1;
                                ptr = ptr->ih_next;
                        }
                        while (level >= 0) {
                                irqmasks[level] |= (1 << irq);
                                --level;
                        }
                }
        }

        /*
         * Disable the appropriate mask bit if there are no handlers left for
         * this IRQ.
         */
        if (irqhandlers[irq] == NULL)
                disable_irq(irq);

        set_spl_masks();
      
        return(0);
}


void *
intr_claim(int irq, int level, int (*ih_func)(void *), void *ih_arg, const char *group, const char *name)
{
        irqhandler_t *ih;

        ih = kmem_zalloc(sizeof(*ih), KM_SLEEP);
        ih->ih_level = level;
        ih->ih_func = ih_func;
        ih->ih_arg = ih_arg;
        ih->ih_flags = 0;

        if (irq_claim(irq, ih, group, name) != 0) {
                kmem_free(ih, sizeof(*ih));
                return(NULL);
        }
        return(ih);
}


int
intr_release(void *arg)
{
        irqhandler_t *ih = (irqhandler_t *)arg;

        if (irq_release(ih->ih_num, ih) == 0) {
                kmem_free(ih, sizeof(*ih));
                return(0);
        }
        return(1);
}


/*
 * void disable_irq(int irq)
 *
 * Disables a specific irq. The irq is removed from the master irq mask
 */

void
disable_irq(int irq)
{
        register int oldirqstate; 

        oldirqstate = disable_interrupts(I32_bit);
        current_mask &= ~(1 << irq);
        irq_setmasks();
        restore_interrupts(oldirqstate);
}  


/*
 * void enable_irq(int irq)
 *
 * Enables a specific irq. The irq is added to the master irq mask
 * This routine should be used with caution. A handler should already
 * be installed.
 */

void
enable_irq(int irq)
{
        register u_int oldirqstate; 

        oldirqstate = disable_interrupts(I32_bit);
        current_mask |= (1 << irq);
        irq_setmasks();
        restore_interrupts(oldirqstate);
}  


/*
 * void stray_irqhandler(u_int mask)
 *
 * Handler for stray interrupts. This gets called if a handler cannot be
 * found for an interrupt.
 */

void    stray_irqhandler(u_int);        /* called from assembly */

void
stray_irqhandler(u_int mask)
{
        static u_int stray_irqs = 0;

        if (++stray_irqs <= 8)
                log(LOG_ERR, "Stray interrupt %08x%s\n", mask,
                    stray_irqs >= 8 ? ": stopped logging" : "");
}