interrupt.h

Go to the documentation of this file.

/*
 *  CMSIS2000
 *  CMSIS-like sources for LPC2xxx series MCUs
 *
 *  (C) Copyright 2011-2012, Dmitriy Cherepanov, All Rights Reserved
 *
 *  Version: 0.0.7
 *  Date of the Last Update:  2013-03-04
 *  
 *  Permission is hereby granted, free of charge, to any person obtaining a copy
 *  of this software and associated documentation files (the "Software"), to
 *  deal in the Software without restriction, including without limitation the
 *  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 *  sell copies of the Software, and to permit persons to whom the Software is
 *  furnished to do so, subject to the following conditions:
 *
 *  The above copyright notice and this permission notice shall be included in
 *  all copies or substantial portions of the Software.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 *  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
 *  IN THE SOFTWARE.
 *
 *  Do not be lasy! For the latest version see http://irtos.sourceforge.net .
 *
 *  
#*/
/** \file
 *\if russian_lng
 *      Файл определяющий макросы прерываний и исключений
 *\else
 *      This file is used to define exeptions and interrupt subroutines macroses
 *\endif
 *      \note need to insert iConfig.h or FreeRTOSConfig.h before for ISR_IRQ_OS_PROTO macroses
 */
#ifndef _iARCH_INTERRUPT_H_
#define _iARCH_INTERRUPT_H_ 1

#include "iArch.h"
/*-----------Документация Doxygen  --  Doxygen documentation -----------------*/

#if defined(DOXYGEN_SHOULD_SKIP_THIS)
/**\ingroup xgc_port

*\if russian_lng
 *      \defgroup arch_interrupts Макросы для прерываний
 *      \brief Платфоромнезависимое создание и объявление обработчиков прерываний и исключений
 *
 *
 *      \note для правильной работы ISR_IRQ_OS_PROTO надо вставить iConfig.h или  FreeRTOSConfig.h перед макросом
 *\else
 *      \defgroup arch_interrupts Interrupt macroses
 *      \brief Arch independent interrupt and exceptions handlers declaration and creation
 *
 *      \note need to insert iConfig.h or FreeRTOSConfig.h before for ISR_IRQ_OS_PROTO macroses
 *\endif
 */

/* the base is ISR_HANDLER
dot {
        ISR_HANDLER -> ISR_EXCEPTION ;
//      ISR_EXCEPTION -> ISR_EXCEPTION_OS;
        ISR_HANDLER -> ISR_IRQ -> ISR_IRQ_OS;
}
*/


/**     \def  ISR_EXCEPTION_PROTO(name)
        \ingroup arch_interrupts
        \code #include "arch/interrupt.h" \endcode
        \~russian       Макрос объявляющий функции-обработчика исключений
        \~english  Exception SubRoutine function macros

        \~
        \param name  The name of exeption (restart IRQ FIQ and etc.)
*/
#define ISR_EXCEPTION_PROTO(name)
/**     \def  ISR_EXCEPTION(name)
        \ingroup arch_interrupts
        \code #include "arch/interrupt.h" \endcode
        \~russian       Макрос функции-обработчика исключений
        \~english  Exception SubRoutine function macros

        \~
        \param name  The name of exeption (restart IRQ FIQ and etc.)
*/
#define ISR_EXCEPTION(name)
/**     \def  ISR_IRQ_PROTO(name)
        \ingroup arch_interrupts
        \code #include "arch/interrupt.h" \endcode
        \~russian Макрос объявляющий функцию-обработчика прерываний
        \~english  Interrupt SubRoutine function macros

        \~
        \param name  The name of device or interrupt vector (ex. UART0 SPI1 I2C2 and etc)
        \note in arm DO function name##_IRQHandler accoding to CMSIS SPECIFICATION
*/
#define ISR_IRQ(name)
/**     \def  ISR_IRQ(name)
        \ingroup arch_interrupts
        \code #include "arch/interrupt.h" \endcode
        \~russian Макрос функции-обработчика прерываний
        \~english  Interrupt SubRoutine function macros

        \~
        \param name  The name of device or interrupt vector (ex. UART0 SPI1 I2C2 and etc)
        \note in arm  DO function name##_IRQHandler accoding to CMSIS SPECIFICATION
*/
#define ISR_IRQ_OS_PROTO(name)
/**     \def  ISR_IRQ_OS_PROTO(name)
        \ingroup arch_interrupts
        \code #include "arch/interrupt.h" \endcode
        \~russian Макрос объявляющий функцию-обработчика прерываний c поддержкой ОС
        \~english  Interrupt SubRoutine function macros with OS support

        \~
        \param name  The name of device or interrupt vector (ex. UART0 SPI1 I2C2 and etc)
        \note in arm  DO function name##_IRQHandler accoding to CMSIS SPECIFICATION
*/
#define ISR_IRQ_OS(name)
/**     \def  ISR_IRQ_OS(name)
        \ingroup arch_interrupts
        \code #include "arch/interrupt.h" \endcode
        \~russian Макрос функции-обработчика прерываний  c поддержкой ОС
        \~english  Interrupt SubRoutine function macros  with OS support

        \~
        \param name  The name of device or interrupt vector (ex. UART0 SPI1 I2C2 and etc)
        \note in arm DO function name##_IRQHandler according to CMSIS SPECIFICATION
*/
#else
/*----------------------------------------------------------------------------*/
#ifndef i_ARCH
        #error Wrong definition:  i_ARCH should be defined \
                usally it definded in bsp_board_def.h. or mcu_id.h
#endif
/*----------------------------------------------------------------------------*/

#if i_ARCH_CHECK(POSIX_GENERIC)
        #include "posix/interrupt.h"
#endif
#if i_ARCH_CHECK(AVR_MEGA)
        #include "avr/interrupt.h"
#endif
#if i_ARCH_CHECK(ARM7)
        #include "arm/interrupt.h"
#endif
#if (i_ARCH_CHECK(CM0) || i_ARCH_CHECK(CM3) || i_ARCH_CHECK(CM4) )
        #include "arm/interrupt_cortex.h"
#endif

#if i_ARCH_CHECK(WIN_NT)
        #include "winnt/iArch.h"
#endif
/*----------- THE DEFAULT PROTOTYPING OF THIS HANDLERS -----------------------*/
#ifndef ISR_HANDLER
        #define ISR_HANDLER(name)       void name(void)
#endif

#ifndef ISR_HANDLER_PROTO
        #define ISR_HANDLER_PROTO(name) ISR_HANDLER(name)
#endif

/*----------------ISR_EXCEPTION ----------------------------------------------*/
#ifndef ISR_EXCEPTION_PROTO
        #define ISR_EXCEPTION_PROTO(name) ISR_HANDLER_PROTO(name)
#endif
#ifndef ISR_EXCEPTION
        #define ISR_EXCEPTION(name) ISR_HANDLER(name)
#endif
/*----------------ISR_IRQ ----------------------------------------------------*/
#ifndef ISR_IRQ_PROTO
        #define ISR_IRQ_PROTO(name) ISR_HANDLER_PROTO(name)
#endif
#ifndef ISR_IRQ
        #define ISR_IRQ(name) ISR_HANDLER(name)
#endif
/*----------------ISR_IRQ_OS -------------------------------------------------*/
#ifndef ISR_IRQ_OS_PROTO
        #define ISR_IRQ_OS_PROTO(name) ISR_IRQ_PROTO(name)
#endif
#ifndef ISR_IRQ_OS
        #define ISR_IRQ_OS(name) ISR_IRQ(name)
#endif

#endif /*defined(__DOXYGEN__) */
/*----------------------------------------------------------------------------*/
/**\brief ISR_ptr_type is the type of pointer to ISR HANDLER
 * \ingroup arch_interrupts
 */
typedef ISR_HANDLER((*ISR_ptr_type));/*typedef void * (*ISR_ptr_type)(void);*/
//typedef void (*ISR_ptr_type) (void);/*typedef void * (*ISR_ptr_type)(void);*/


#endif  /* _iARCH_INTERRUPT_H_ */