2.3-InternetRadio/nutos/nut/include/dev/irqreg.h

#ifndef _DEV_IRQREG_H_
#define _DEV_IRQREG_H_

/*
 * Copyright (C) 2001-2005 by egnite Software GmbH. All rights reserved.
 *
 * 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. Neither the name of the copyright holders nor the names of
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 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
 * COPYRIGHT OWNER 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.
 *
 * For additional information see http://www.ethernut.de/
 */

/*
 * $Log$
 * Revision 1.16  2009/03/05 22:16:57  freckle
 * use __NUT_EMULATION instead of __APPLE__, __linux__, or __CYGWIN__
 *
 * Revision 1.15  2008/08/11 06:59:59  haraldkipp
 * BSD types replaced by stdint types (feature request #1282721).
 *
 * Revision 1.14  2008/07/26 09:38:02  haraldkipp
 * Added support for NUT_IRQMODE_NONE and NUT_IRQMODE_LEVEL.
 *
 * Revision 1.13  2006/01/05 16:53:56  haraldkipp
 * New function NutIrqSetMode() allows to modify the interrupt mode.
 *
 * Revision 1.12  2005/10/24 10:50:49  haraldkipp
 * New API functions added.
 * Interrupt counting requires NUT_PERFMON to be defined.
 *
 * Revision 1.11  2005/07/26 16:05:24  haraldkipp
 * Several files were moved from subdir dev to subdir arch.
 *
 * Revision 1.10  2005/04/07 12:31:37  freckle
 * most unix emulation specific stuff now in irqreg_unix.h.
 * corrected #warning "MCU not defined"
 *
 * Revision 1.9  2005/04/05 17:52:40  haraldkipp
 * Much better implementation of GBA interrupt registration.
 *
 * Revision 1.8  2005/02/10 07:06:51  hwmaier
 * Changes to incorporate support for AT90CAN128 CPU
 *
 * Revision 1.7  2004/08/05 12:13:56  freckle
 * Added unix emulation hook in NutThreadYield to safely process
 * NutPostEventAsync calls occuring in non Nut/OS threads.
 * Rewrote the unix read function again using the new unix NutThreadYield hook
 * to call the NutPostEventAsync function safely (fast & correct).
 * _write(nf, 0, 0) aka fflush is ignored on unix emulation.
 *
 * Revision 1.6  2004/04/07 12:13:57  haraldkipp
 * Matthias Ringwald's *nix emulation added
 *
 * Revision 1.5  2004/03/18 15:48:13  haraldkipp
 * ICCAVR failed to compile
 *
 * Revision 1.4  2004/03/16 16:48:28  haraldkipp
 * Added Jan Dubiec's H8/300 port.
 *
 * Revision 1.3  2004/01/30 17:00:46  drsung
 * Separate interrupt stack for avr-gcc only added.
 *
 * Revision 1.2  2003/11/23 16:42:13  drsung
 * NutRegisterInterrupt removed, because it's incompatible to the new interrupt handling
 *
 * Revision 1.1.1.1  2003/05/09 14:41:06  haraldkipp
 * Initial using 3.2.1
 *
 * Revision 1.10  2003/05/06 18:42:55  harald
 * Cleanup
 *
 * Revision 1.9  2003/02/04 18:00:37  harald
 * Version 3 released
 *
 * Revision 1.8  2002/07/03 16:45:40  harald
 * Using GCC 3.2
 *
 * Revision 1.7  2002/06/26 17:29:15  harald
 * First pre-release with 2.4 stack
 *
 */

#include <cfg/arch.h>

#include <stdint.h>

#include <sys/device.h>
#include <dev/irqstack.h>

/*!
 * \file dev/irqreg.h
 * \brief Interrupt management definitions.
 */

/*!
 * \addtogroup xgIrqReg
 */
/*@{*/

#define NUT_IRQCTL_INIT         0
#define NUT_IRQCTL_CLEAR        1
#define NUT_IRQCTL_STATUS       16
#define NUT_IRQCTL_ENABLE       17
#define NUT_IRQCTL_DISABLE      18
#define NUT_IRQCTL_GETMODE      24
#define NUT_IRQCTL_SETMODE      25
#define NUT_IRQCTL_GETPRIO      32
#define NUT_IRQCTL_SETPRIO      33
#define NUT_IRQCTL_GETCOUNT     96
#define NUT_IRQCTL_SETCOUNT     97

#define NUT_IRQMODE_NONE        0
#define NUT_IRQMODE_LOWLEVEL    1
#define NUT_IRQMODE_HIGHLEVEL   2
#define NUT_IRQMODE_FALLINGEDGE 5
#define NUT_IRQMODE_RISINGEDGE  6
#define NUT_IRQMODE_EDGE        7
#define NUT_IRQMODE_LEVEL       8
#define NUT_IRQMODE_BOTHEDGE    9

/*
 * Registered interrupt handler information structure.
 */
typedef struct {
#ifdef NUT_PERFMON
    uint32_t ir_count;                      /* Counter for statistics and performance analysis */
#endif
    void *ir_arg;                           /* Argument passed to interrupt handler function */
    void (*ir_handler) (void *);            /* Interrupt handler function */
    int (*ir_ctl) (int cmd, void *param);   /* Interrupt control function */
} IRQ_HANDLER;

#ifdef __NUT_EMULATION__
#include <arch/unix/irqreg.h>
#elif defined(__AVR__)
#include <arch/avr/irqreg.h>
#elif defined(__arm__) && !defined(__CORTEX__)
#include <arch/arm/irqreg.h>
#elif defined(__arm__) && defined(__CORTEX__)
#include <arch/cm3/irqreg.h>
#elif defined(__AVR32__)
#include <arch/avr32/irqreg.h>
#elif defined(__H8300H__) || defined(__H8300S__)
#include <arch/h8300h/irqreg.h>
#elif defined(__m68k__)
#include <arch/m68k/irqreg.h>
#else
#warning "MCU not defined"
#endif

/*@}*/

/* NutRegisterInterrupt is obsolete, use NutRegisterIrqHandler instead */
//extern int NutRegisterInterrupt(int irq, void (*handler)(void *), void *arg) __attribute__ ((obsolete)) ;
extern void CallHandler(IRQ_HANDLER * irh);

#ifdef __NUT_EMULATION__
extern int NutRegisterIrqHandler(uint8_t irq_nr, void (*handler) (void *), void *arg);
#else
extern int NutRegisterIrqHandler(IRQ_HANDLER * irh, void (*handler) (void *), void *arg);
extern int NutIrqStatus(IRQ_HANDLER * irq);
extern int NutIrqEnable(IRQ_HANDLER * irq);
extern int NutIrqDisable(IRQ_HANDLER * irq);
extern int NutIrqSetPriority(IRQ_HANDLER * irq, int level);
extern int NutIrqGetPriority(IRQ_HANDLER * irq);
extern int NutIrqSetMode(IRQ_HANDLER * irq, int mode);
#endif

#if defined(__CORTEX__)
int CM3_IrqCtl(int cmd, void *param, IRQn_Type interrupt,
               void (*pfnHandler)(void*),
               IRQ_HANDLER* sig, int def_priority);
#endif

#endif