/*      $NetBSD: intr.h,v 1.26 2026/03/18 04:08:38 thorpej Exp $        */

/*-
 * Copyright (c) 1996, 1997, 2007 The NetBSD Foundation, Inc.
 * All rights reserved.
 *
 * This code is derived from software contributed to The NetBSD Foundation
 * by Leo Weppelman.
 *
 * 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.
 *
 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 * ``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 FOUNDATION OR CONTRIBUTORS
 * 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.
 */

#ifndef _ATARI_INTR_H_
#define _ATARI_INTR_H_

#define IPL_NONE        0                   /* disable no interrupts        */
#define IPL_SOFTCLOCK   1
#define IPL_SOFTBIO     2
#define IPL_SOFTNET     3
#define IPL_SOFTSERIAL  4
#define IPL_VM          5
#define IPL_SCHED       6
#define IPL_HIGH        7
#define NIPL            8

#define IST_UNUSABLE    -1      /* interrupt cannot be used     */
#define IST_NONE        0       /* none (dummy)                 */
#define IST_PULSE       1       /* pulsed                       */
#define IST_EDGE        2       /* edge-triggered               */
#define IST_LEVEL       3       /* level-triggered              */

#if defined(_KERNEL) || defined(_KMEMUSER)
typedef struct {
        uint16_t _psl;
} ipl_cookie_t;
#endif

/*
 * spl functions; all but spl0 are done in-line
 */
#include <machine/psl.h>

#define splsoftclock()          splraise1()
#define splsoftbio()            splraise1()
#define splsoftnet()            splraise1()
#define splsoftserial()         splraise1()
#define splvm()                 splraise4()
#define splsched()              splraise6()
#define splhigh()               spl7()
#define spl0()                  _spl0()
#define splx(s)                 _splx(s)

#ifdef _KERNEL
extern const uint16_t ipl2psl_table[NIPL];
extern volatile unsigned int intr_depth;

typedef int ipl_t;

static inline ipl_cookie_t
makeiplcookie(ipl_t ipl)
{

        return (ipl_cookie_t){._psl = ipl2psl_table[ipl]};
}

static inline int
splraiseipl(ipl_cookie_t icookie)
{

        return _splraise(icookie._psl);
}

#include <sys/queue.h>
#include <machine/cpu.h>        /* XXX: for clockframe */

struct clockframe;

#define AUTO_VEC        0x0001  /* We're dealing with an auto-vector    */
#define USER_VEC        0x0002  /* We're dealing with an user-vector    */

#define FAST_VEC        0x0010  /* Fast, stash right into vector-table  */
#define ARG_CLOCKFRAME  0x0020  /* Supply clockframe as an argument     */

/*
 * Interrupt handler chains.  intr_establish() inserts a handler into
 * the list.  The handler is called with its (single) argument or with a
 * 'standard' clockframe. This depends on 'ih_type'.
 */
typedef int     (*hw_ifun_t)(void *, int);

struct intrhand {
        LIST_ENTRY(intrhand)    ih_link;
        hw_ifun_t               ih_fun;
        void                    *ih_arg;
        int                     ih_type;
        int                     ih_pri;
        int                     ih_vector;
        u_int                   *ih_intrcnt;
};

void            intr_init(void);
struct intrhand *intr_establish(int, int, int, hw_ifun_t, void *);
int             intr_disestablish(struct intrhand *);
void            intr_dispatch(struct clockframe);
void            intr_glue(void);

/*
 * Exported by intrcnt.h
 */
extern u_long   autovects[];
extern u_int    intrcnt_auto[];
extern u_long   uservects[];
extern u_int    intrcnt_user[];

#endif /* _KERNEL */

#endif /* _ATARI_INTR_H_ */