From 044ad7c3987460ede48ff27afd6bdb0ca05a0432 Mon Sep 17 00:00:00 2001 From: Harald Welte Date: Mon, 4 Jul 2011 20:52:54 +0200 Subject: import at91lib from at91lib_20100901_softpack_1_9_v_1_0_svn_v15011 it's sad to see that atmel doesn't publish their svn repo or has a centralized location or even puts proper version/release info into the library itself --- peripherals/irq/aic.c | 91 ++++++++++++++++++++++++++++++ peripherals/irq/irq.dir | 38 +++++++++++++ peripherals/irq/irq.h | 84 ++++++++++++++++++++++++++++ peripherals/irq/nvic.c | 144 ++++++++++++++++++++++++++++++++++++++++++++++++ peripherals/irq/nvic.h | 55 ++++++++++++++++++ 5 files changed, 412 insertions(+) create mode 100644 peripherals/irq/aic.c create mode 100644 peripherals/irq/irq.dir create mode 100644 peripherals/irq/irq.h create mode 100644 peripherals/irq/nvic.c create mode 100644 peripherals/irq/nvic.h (limited to 'peripherals/irq') diff --git a/peripherals/irq/aic.c b/peripherals/irq/aic.c new file mode 100644 index 0000000..d2353f5 --- /dev/null +++ b/peripherals/irq/aic.c @@ -0,0 +1,91 @@ +/* ---------------------------------------------------------------------------- + * ATMEL Microcontroller Software Support + * ---------------------------------------------------------------------------- + * Copyright (c) 2008, Atmel Corporation + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * - Redistributions of source code must retain the above copyright notice, + * this list of conditions and the disclaimer below. + * + * Atmel's name may not be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE + * DISCLAIMED. IN NO EVENT SHALL ATMEL 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. + * ---------------------------------------------------------------------------- + */ + +//------------------------------------------------------------------------------ +// Headers +//------------------------------------------------------------------------------ + +#include +#include "irq.h" + +#ifndef AT91C_AIC_SRCTYPE_INT_HIGH_LEVEL + /// Interrupt is internal and uses a logical 1 level. + #define AT91C_AIC_SRCTYPE_INT_HIGH_LEVEL AT91C_AIC_SRCTYPE_INT_LEVEL_SENSITIVE +#endif + +//------------------------------------------------------------------------------ +// Global functions +//------------------------------------------------------------------------------ + +//------------------------------------------------------------------------------ +/// Configures an interrupt in the AIC. The interrupt is identified by its +/// source (AT91C_ID_xxx) and is configured to use the specified mode and +/// interrupt handler function. Mode is the value that will be put in AIC_SMRx +/// and the function address will be set in AIC_SVRx. +/// The interrupt is disabled before configuration, so it is useless +/// to do it before calling this function. When AIC_ConfigureIT returns, the +/// interrupt will always be disabled and cleared; it must be enabled by a +/// call to AIC_EnableIT(). +/// \param source Interrupt source to configure. +/// \param mode Triggering mode and priority of the interrupt. +/// \param handler Interrupt handler function. +//------------------------------------------------------------------------------ +void IRQ_ConfigureIT(unsigned int source, + unsigned int mode, + void( *handler )( void )) +{ + // Disable the interrupt first + AT91C_BASE_AIC->AIC_IDCR = 1 << source; + + // Configure mode and handler + AT91C_BASE_AIC->AIC_SMR[source] = mode; + AT91C_BASE_AIC->AIC_SVR[source] = (unsigned int) handler; + + // Clear interrupt + AT91C_BASE_AIC->AIC_ICCR = 1 << source; +} + +//------------------------------------------------------------------------------ +/// Enables interrupts coming from the given (unique) source (AT91C_ID_xxx). +/// \param source Interrupt source to enable. +//------------------------------------------------------------------------------ +void IRQ_EnableIT(unsigned int source) +{ + AT91C_BASE_AIC->AIC_IECR = 1 << source; +} + +//------------------------------------------------------------------------------ +/// Disables interrupts coming from the given (unique) source (AT91C_ID_xxx). +/// \param source Interrupt source to enable. +//------------------------------------------------------------------------------ +void IRQ_DisableIT(unsigned int source) +{ + AT91C_BASE_AIC->AIC_IDCR = 1 << source; +} + diff --git a/peripherals/irq/irq.dir b/peripherals/irq/irq.dir new file mode 100644 index 0000000..06e017a --- /dev/null +++ b/peripherals/irq/irq.dir @@ -0,0 +1,38 @@ +/* ---------------------------------------------------------------------------- + * ATMEL Microcontroller Software Support + * ---------------------------------------------------------------------------- + * Copyright (c) 2008, Atmel Corporation + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * - Redistributions of source code must retain the above copyright notice, + * this list of conditions and the disclaimer below. + * + * Atmel's name may not be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE + * DISCLAIMED. IN NO EVENT SHALL ATMEL 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. + * ---------------------------------------------------------------------------- + */ + +//------------------------------------------------------------------------------ +/// \dir +/// +/// !!!Purpose +/// +/// This directory contains an API for Configure the Interrupt controller. +/// The interrupt controller for SAM7 and SAM9 is AIC, and the interrupt controller +/// for SAM3 is NVIC. +//------------------------------------------------------------------------------ \ No newline at end of file diff --git a/peripherals/irq/irq.h b/peripherals/irq/irq.h new file mode 100644 index 0000000..5f0e203 --- /dev/null +++ b/peripherals/irq/irq.h @@ -0,0 +1,84 @@ +/* ---------------------------------------------------------------------------- + * ATMEL Microcontroller Software Support + * ---------------------------------------------------------------------------- + * Copyright (c) 2008, Atmel Corporation + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * - Redistributions of source code must retain the above copyright notice, + * this list of conditions and the disclaimer below. + * + * Atmel's name may not be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE + * DISCLAIMED. IN NO EVENT SHALL ATMEL 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. + * ---------------------------------------------------------------------------- + */ + +//------------------------------------------------------------------------------ +/// \unit +/// +/// !Purpose +/// +/// Methods and definitions for configuring interrupts. +/// +/// !Usage +/// +/// -# Configure an interrupt source using IRQ_ConfigureIT +/// -# Enable or disable interrupt generation of a particular source with +/// IRQ_EnableIT and IRQ_DisableIT. +/// +/// \note Most of the time, peripheral interrupts must be also configured +/// inside the peripheral itself. +//------------------------------------------------------------------------------ + +#ifndef IRQ_H +#define IRQ_H + +//------------------------------------------------------------------------------ +// Headers +//------------------------------------------------------------------------------ + +#include +#if defined(cortexm3) +#include +#endif + +//------------------------------------------------------------------------------ +// Definitions +//------------------------------------------------------------------------------ +#if 0 +#if defined(cortexm3) +#ifdef __NVIC_PRIO_BITS +#undef __NVIC_PRIO_BITS +#define __NVIC_PRIO_BITS ((SCB->AIRCR & 0x700) >> 8) +#endif +#endif +#endif + +//------------------------------------------------------------------------------ +// Global functions +//------------------------------------------------------------------------------ + +extern void IRQ_ConfigureIT(unsigned int source, + unsigned int mode, // mode for AIC, priority for NVIC + void( *handler )( void )); // ISR + +extern void IRQ_EnableIT(unsigned int source); + +extern void IRQ_DisableIT(unsigned int source); + +#endif //#ifndef IRQ_H + diff --git a/peripherals/irq/nvic.c b/peripherals/irq/nvic.c new file mode 100644 index 0000000..b7d40b2 --- /dev/null +++ b/peripherals/irq/nvic.c @@ -0,0 +1,144 @@ +/* ---------------------------------------------------------------------------- + * ATMEL Microcontroller Software Support + * ---------------------------------------------------------------------------- + * Copyright (c) 2008, Atmel Corporation + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * - Redistributions of source code must retain the above copyright notice, + * this list of conditions and the disclaimer below. + * + * Atmel's name may not be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE + * DISCLAIMED. IN NO EVENT SHALL ATMEL 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. + * ---------------------------------------------------------------------------- + */ + +//------------------------------------------------------------------------------ +// Headers +//------------------------------------------------------------------------------ + +#include "board.h" +#include "irq.h" +#include "exceptions.h" +#include + +/// The index of IRQ handler in the exception table +#define NVIC_IRQ_HANDLER_INDEX 16 + +//------------------------------------------------------------------------------ +// Global functions +//------------------------------------------------------------------------------ + +//------------------------------------------------------------------------------ +/// Configures an interrupt in the NVIC. The interrupt is identified by its +/// source (AT91C_ID_xxx) and is configured to a specified priority and +/// interrupt handler function. priority is the value that will be put in NVIC_IPRx +/// and the function address will be set in "ExceptionTable". The parameter priority +/// will include the preemptionPriority and the subPriority, where the subPriority +/// defined in the B[7:0] of the parameter "priority", and the preemptionPriority defined +/// in the B[15:8] of the parameter "priority". +/// The interrupt is disabled before configuration, so it is useless +/// to do it before calling this function. When NVIC_ConfigureIT returns, the +/// interrupt will always be disabled and cleared; it must be enabled by a +/// call to NVIC_EnableIT(). +/// \param source Interrupt source to configure. +/// \param priority Pre-emption priority (B[15:8] )+ subPriority (B[7:0]) +/// \param handler Interrupt handler function. +//------------------------------------------------------------------------------ +void IRQ_ConfigureIT( + unsigned int source, + //unsigned int preemptionPriority, + //unsigned int subPriority, + unsigned int priority, + IntFunc handler) +{ + unsigned int priGroup = __NVIC_PRIO_BITS; + unsigned int nPre = 8 - priGroup; + unsigned int nSub = priGroup; + unsigned int preemptionPriority; + unsigned int subPriority; + unsigned int IRQpriority; + + preemptionPriority = (priority & 0xff00) >> 8; + subPriority = (priority & 0xff); + + // Disable the interrupt first + NVIC_DisableIRQ((IRQn_Type)source); + + // Clear any pending status + NVIC_ClearPendingIRQ((IRQn_Type)source); + + // Configure interrupt handler + //if (handler == 0) handler = IrqHandlerNotUsed; + // GetExceptionTable()[NVIC_IRQ_HANDLER_INDEX + source] = handler; + + if (subPriority >= (0x01 << nSub)) + subPriority = (0x01 << nSub) - 1; + if (preemptionPriority >= (0x01 << nPre)) + preemptionPriority = (0x01 << nPre) - 1; + + IRQpriority = (subPriority | (preemptionPriority << nSub)); + NVIC_SetPriority((IRQn_Type)source, IRQpriority); +} + +//------------------------------------------------------------------------------ +/// Enables interrupt coming from the given (unique) source (AT91C_ID_xxx). +/// \param source Interrupt source to enable. +//------------------------------------------------------------------------------ +void IRQ_EnableIT(unsigned int source) +{ + NVIC_EnableIRQ((IRQn_Type)source); +} + +//------------------------------------------------------------------------------ +/// Disables interrupt coming from the given (unique) source (AT91C_ID_xxx). +/// \param source Interrupt source to disable. +//------------------------------------------------------------------------------ +void IRQ_DisableIT(unsigned int source) +{ + NVIC_DisableIRQ((IRQn_Type)source); +} + +//------------------------------------------------------------------------------ +/// Set interrupt pending bit from the given (unique) source (AT91C_ID_xxx). +/// \param source Interrupt source to set. +//------------------------------------------------------------------------------ +void NVIC_SetPending(unsigned int source) +{ + NVIC_SetPendingIRQ((IRQn_Type)source); +} + +//------------------------------------------------------------------------------ +/// Clear interrupt pending bit from the given (unique) source (AT91C_ID_xxx). +/// \param source Interrupt source to clear. +//------------------------------------------------------------------------------ +void NVIC_ClrPending(unsigned int source) +{ + NVIC_ClearPendingIRQ((IRQn_Type)source); +} + +#if !defined(USE_CMSIS_on) +//------------------------------------------------------------------------------ +/// Use the Software Trigger Interrupt Register to pend an interrupt. +/// \param source Interrupt source to trigger. +//------------------------------------------------------------------------------ +void NVIC_Swi(unsigned int source) +{ + AT91C_BASE_NVIC->NVIC_STIR = source; +} +#endif + diff --git a/peripherals/irq/nvic.h b/peripherals/irq/nvic.h new file mode 100644 index 0000000..ff33ab0 --- /dev/null +++ b/peripherals/irq/nvic.h @@ -0,0 +1,55 @@ +/* ---------------------------------------------------------------------------- + * ATMEL Microcontroller Software Support + * ---------------------------------------------------------------------------- + * Copyright (c) 2008, Atmel Corporation + * + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * - Redistributions of source code must retain the above copyright notice, + * this list of conditions and the disclaimer below. + * + * Atmel's name may not be used to endorse or promote products derived from + * this software without specific prior written permission. + * + * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE + * DISCLAIMED. IN NO EVENT SHALL ATMEL 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. + * ---------------------------------------------------------------------------- + */ + +//------------------------------------------------------------------------------ +/// \unit +/// +/// !Purpose +/// +/// Methods and definitions for configuring interrupts using the Nested +/// Vectored Interrupt Controller (NVIC). +/// +/// !Usage +/// +/// -# Configure interrupt source by implementing specific functions and define +/// ... +/// -# Configure the interrupt settings using NVIC_ConfigureIT +/// -# Enable or disable interrupt generation of a particular source with +/// NVIC_EnableIT and NVIC_DisableIT. +/// +/// \note Most of the time, peripheral interrupts must be also configured +/// inside the peripheral itself. +//------------------------------------------------------------------------------ + +#ifndef NVIC_H +#define NVIC_H + + +#endif //#ifndef NVIC_H + -- cgit v1.2.3