From c39339a7a89e7a6738dcee96b2ce2e72010273e7 Mon Sep 17 00:00:00 2001 From: Alin Jerpelea Date: Sun, 21 Mar 2021 11:37:01 +0100 Subject: [PATCH] arch: arm: include: nxstyle fixes nxstyle fixes to pass CI Signed-off-by: Alin Jerpelea --- arch/arm/include/a1x/a10_irq.h | 34 +-- arch/arm/include/a1x/chip.h | 26 +- arch/arm/include/a1x/irq.h | 30 +-- arch/arm/include/am335x/am335x_irq.h | 35 +-- arch/arm/include/am335x/chip.h | 28 +-- arch/arm/include/am335x/irq.h | 32 +-- arch/arm/include/arch.h | 2 +- arch/arm/include/arm/irq.h | 4 +- arch/arm/include/arm/syscall.h | 2 +- arch/arm/include/armv6-m/irq.h | 8 +- arch/arm/include/armv6-m/syscall.h | 2 +- arch/arm/include/armv7-a/irq.h | 2 +- arch/arm/include/armv7-a/syscall.h | 2 +- arch/arm/include/armv7-m/irq.h | 2 +- arch/arm/include/armv7-m/irq_cmnvector.h | 2 +- arch/arm/include/armv7-m/irq_lazyfpu.h | 2 +- arch/arm/include/armv7-m/nvicpri.h | 14 +- arch/arm/include/armv7-m/syscall.h | 2 +- arch/arm/include/armv7-r/irq.h | 2 +- arch/arm/include/armv7-r/syscall.h | 2 +- arch/arm/include/armv8-m/irq.h | 2 +- arch/arm/include/armv8-m/irq_cmnvector.h | 2 +- arch/arm/include/armv8-m/irq_lazyfpu.h | 2 +- arch/arm/include/armv8-m/nvicpri.h | 14 +- arch/arm/include/armv8-m/syscall.h | 2 +- arch/arm/include/c5471/irq.h | 2 +- arch/arm/include/cxd56xx/adc.h | 2 +- arch/arm/include/cxd56xx/audio.h | 2 +- arch/arm/include/cxd56xx/battery_ioctl.h | 2 +- arch/arm/include/cxd56xx/chip.h | 2 +- arch/arm/include/cxd56xx/crashdump.h | 2 +- arch/arm/include/cxd56xx/irq.h | 2 +- arch/arm/include/cxd56xx/pin.h | 4 +- arch/arm/include/cxd56xx/pm.h | 4 +- arch/arm/include/cxd56xx/scu.h | 2 +- arch/arm/include/cxd56xx/timer.h | 2 +- arch/arm/include/cxd56xx/usbdev.h | 2 +- arch/arm/include/dm320/irq.h | 2 +- arch/arm/include/efm32/chip.h | 22 +- arch/arm/include/efm32/efm32g_irq.h | 7 +- arch/arm/include/efm32/efm32gg_irq.h | 4 +- arch/arm/include/efm32/efm32tg_irq.h | 4 +- arch/arm/include/efm32/irq.h | 70 +++--- arch/arm/include/elf.h | 12 +- arch/arm/include/eoss3/chip.h | 2 +- arch/arm/include/eoss3/irq.h | 2 +- arch/arm/include/imx1/irq.h | 2 +- arch/arm/include/imx6/chip.h | 5 +- arch/arm/include/imx6/irq.h | 7 +- arch/arm/include/imxrt/chip.h | 31 +-- arch/arm/include/imxrt/imxrt102x_irq.h | 82 ++++-- arch/arm/include/imxrt/imxrt105x_irq.h | 43 ++-- arch/arm/include/imxrt/imxrt106x_irq.h | 45 ++-- arch/arm/include/imxrt/irq.h | 40 +-- arch/arm/include/inttypes.h | 2 +- arch/arm/include/kinetis/chip.h | 38 +-- arch/arm/include/kinetis/irq.h | 47 ++-- arch/arm/include/kinetis/kinetis_dma.h | 43 ++-- arch/arm/include/kinetis/kinetis_dmamux.h | 37 +-- arch/arm/include/kinetis/kinetis_k20irq.h | 33 +-- arch/arm/include/kinetis/kinetis_k28irq.h | 37 +-- arch/arm/include/kinetis/kinetis_k40irq.h | 37 +-- arch/arm/include/kinetis/kinetis_k60irq.h | 37 +-- arch/arm/include/kinetis/kinetis_k64irq.h | 37 +-- arch/arm/include/kinetis/kinetis_k66irq.h | 38 +-- arch/arm/include/kinetis/kinetis_lpuart.h | 46 ++-- arch/arm/include/kinetis/kinetis_mcg.h | 85 ++++--- arch/arm/include/kinetis/kinetis_pmc.h | 38 +-- arch/arm/include/kinetis/kinetis_sim.h | 59 +++-- arch/arm/include/kl/chip.h | 38 +-- arch/arm/include/kl/irq.h | 92 +++---- arch/arm/include/lc823450/chip.h | 2 +- arch/arm/include/lc823450/clk.h | 2 +- arch/arm/include/lc823450/irq.h | 2 +- arch/arm/include/limits.h | 2 +- arch/arm/include/lpc17xx_40xx/chip.h | 52 ++-- arch/arm/include/lpc17xx_40xx/irq.h | 3 +- arch/arm/include/lpc17xx_40xx/lpc176x_irq.h | 19 +- .../include/lpc17xx_40xx/lpc178x_40xx_irq.h | 15 +- arch/arm/include/lpc214x/irq.h | 2 +- arch/arm/include/lpc2378/irq.h | 6 +- arch/arm/include/lpc31xx/irq.h | 2 +- arch/arm/include/lpc43xx/chip.h | 80 +++--- arch/arm/include/lpc43xx/irq.h | 45 ++-- arch/arm/include/lpc54xx/chip.h | 41 +-- arch/arm/include/lpc54xx/irq.h | 29 +-- arch/arm/include/lpc54xx/lpc546x_irq.h | 14 +- arch/arm/include/max326xx/chip.h | 48 ++-- arch/arm/include/max326xx/irq.h | 37 +-- arch/arm/include/max326xx/max32620_30_irq.h | 38 +-- arch/arm/include/max326xx/max32660_irq.h | 42 ++-- arch/arm/include/moxart/irq.h | 2 +- arch/arm/include/nrf52/chip.h | 34 +-- arch/arm/include/nrf52/irq.h | 33 +-- arch/arm/include/nrf52/nrf52_irq.h | 14 +- arch/arm/include/nuc1xx/chip.h | 43 ++-- arch/arm/include/nuc1xx/irq.h | 43 ++-- arch/arm/include/nuc1xx/nuc120_irq.h | 32 +-- arch/arm/include/rp2040/irq.h | 2 +- arch/arm/include/s32k1xx/chip.h | 32 +-- arch/arm/include/s32k1xx/s32k11x_irq.h | 29 ++- arch/arm/include/s32k1xx/s32k14x_irq.h | 29 ++- arch/arm/include/sam34/chip.h | 103 +++++--- arch/arm/include/sam34/irq.h | 37 +-- arch/arm/include/sam34/sam3u_irq.h | 34 +-- arch/arm/include/sam34/sam3x_irq.h | 34 +-- arch/arm/include/sam34/sam4cm_irq.h | 34 +-- arch/arm/include/sam34/sam4e_irq.h | 36 +-- arch/arm/include/sam34/sam4l_irq.h | 42 ++-- arch/arm/include/sam34/sam4s_irq.h | 34 +-- arch/arm/include/sama5/chip.h | 238 ++++++++++++------ arch/arm/include/sama5/irq.h | 30 +-- arch/arm/include/sama5/sama5d2_irq.h | 54 ++-- arch/arm/include/sama5/sama5d3_irq.h | 34 +-- arch/arm/include/sama5/sama5d4_irq.h | 34 +-- arch/arm/include/samd2l2/chip.h | 69 ++--- arch/arm/include/samd2l2/irq.h | 41 +-- arch/arm/include/samd2l2/sam_adc.h | 6 +- arch/arm/include/samd2l2/samd20_irq.h | 34 +-- arch/arm/include/samd2l2/samd21_irq.h | 34 +-- arch/arm/include/samd2l2/saml21_irq.h | 34 +-- arch/arm/include/samd5e5/chip.h | 43 ++-- arch/arm/include/samd5e5/irq.h | 37 +-- arch/arm/include/samd5e5/samd5e5_irq.h | 35 +-- arch/arm/include/samv7/chip.h | 38 +-- arch/arm/include/samv7/irq.h | 37 +-- arch/arm/include/samv7/same70_irq.h | 38 +-- arch/arm/include/samv7/samv71_irq.h | 38 +-- arch/arm/include/spinlock.h | 2 +- arch/arm/include/stdarg.h | 3 +- arch/arm/include/stm32/chip.h | 68 ++--- arch/arm/include/stm32/irq.h | 41 +-- arch/arm/include/stm32/stm32f10xxx_irq.h | 2 +- arch/arm/include/stm32/stm32f20xxx_irq.h | 2 +- arch/arm/include/stm32/stm32f30xxx_irq.h | 2 +- arch/arm/include/stm32/stm32f33xxx_irq.h | 2 +- arch/arm/include/stm32/stm32f37xxx_irq.h | 2 +- arch/arm/include/stm32/stm32f40xxx_irq.h | 36 +-- arch/arm/include/stm32/stm32g4xxxx_irq.h | 26 +- arch/arm/include/stm32/stm32l15xxx_irq.h | 2 +- arch/arm/include/stm32f0l0g0/chip.h | 2 +- arch/arm/include/stm32f0l0g0/irq.h | 2 +- arch/arm/include/stm32f0l0g0/stm32f0_irq.h | 2 +- arch/arm/include/stm32f0l0g0/stm32g0_irq.h | 2 +- arch/arm/include/stm32f0l0g0/stm32l0_irq.h | 41 +-- arch/arm/include/stm32f7/chip.h | 200 ++++++++++----- arch/arm/include/stm32f7/irq.h | 2 +- arch/arm/include/stm32f7/stm32f72xx73xx_irq.h | 2 +- arch/arm/include/stm32f7/stm32f74xx75xx_irq.h | 2 +- arch/arm/include/stm32f7/stm32f76xx77xx_irq.h | 2 +- arch/arm/include/stm32h7/chip.h | 20 +- arch/arm/include/stm32h7/irq.h | 2 +- arch/arm/include/stm32h7/stm32h7x3xx_irq.h | 30 ++- arch/arm/include/stm32h7/stm32h7x7xx_irq.h | 2 +- arch/arm/include/stm32l4/chip.h | 2 +- arch/arm/include/stm32l4/irq.h | 2 +- arch/arm/include/stm32l4/stm32l4x3xx_irq.h | 2 +- arch/arm/include/stm32l4/stm32l4x5xx_irq.h | 2 +- arch/arm/include/stm32l4/stm32l4x6xx_irq.h | 2 +- arch/arm/include/stm32l4/stm32l4xrxx_irq.h | 2 +- arch/arm/include/stm32l5/chip.h | 16 +- arch/arm/include/stm32l5/irq.h | 8 +- arch/arm/include/stm32l5/stm32l562xx_irq.h | 20 +- arch/arm/include/stm32l5/stm32l5_irq.h | 42 ++-- arch/arm/include/str71x/irq.h | 28 +-- arch/arm/include/syscall.h | 2 +- arch/arm/include/tiva/cc13x0_irq.h | 2 +- arch/arm/include/tiva/cc13x2_cc26x2_irq.h | 2 +- arch/arm/include/tiva/chip.h | 2 +- arch/arm/include/tiva/irq.h | 30 +-- arch/arm/include/tiva/lm3s_irq.h | 33 +-- arch/arm/include/tiva/lm4f_irq.h | 33 +-- arch/arm/include/tiva/tm4c_irq.h | 33 +-- arch/arm/include/tms570/chip.h | 84 ++++--- arch/arm/include/tms570/irq.h | 41 +-- arch/arm/include/tms570/tms570ls04x03x_irq.h | 37 +-- arch/arm/include/types.h | 2 +- arch/arm/include/xmc4/chip.h | 38 +-- arch/arm/include/xmc4/irq.h | 36 +-- arch/arm/include/xmc4/xmc4500_irq.h | 16 +- arch/arm/include/xmc4/xmc4700_irq.h | 16 +- arch/arm/include/xmc4/xmc4800_irq.h | 16 +- 182 files changed, 2444 insertions(+), 2013 deletions(-) diff --git a/arch/arm/include/a1x/a10_irq.h b/arch/arm/include/a1x/a10_irq.h index 85691e67b2b..3ec3b1078e6 100644 --- a/arch/arm/include/a1x/a10_irq.h +++ b/arch/arm/include/a1x/a10_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/a1x/a10_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_A1X_A10_IRQ_H #define __ARCH_ARM_INCLUDE_A1X_A10_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts numbers */ @@ -173,21 +173,21 @@ #define NR_IRQS (A1X_IRQ_NINT + A1X_PIO_NINT) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/a1x/chip.h b/arch/arm/include/a1x/chip.h index 521d1b156f3..f7c15e76a14 100644 --- a/arch/arm/include/a1x/chip.h +++ b/arch/arm/include/a1x/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/a1x/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_A1X_CHIP_H #define __ARCH_ARM_INCLUDE_A1X_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* A1X Family */ @@ -39,16 +39,16 @@ # error Unrecognized A1X chip #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_A1X_CHIP_H */ diff --git a/arch/arm/include/a1x/irq.h b/arch/arm/include/a1x/irq.h index e5cb970992c..04be0dafac4 100644 --- a/arch/arm/include/a1x/irq.h +++ b/arch/arm/include/a1x/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/a1x/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,18 +16,18 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_A1X_IRQ_H #define __ARCH_ARM_INCLUDE_A1X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include @@ -40,19 +40,19 @@ # error Unrecognized A1X chip #endif -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -62,9 +62,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/am335x/am335x_irq.h b/arch/arm/include/am335x/am335x_irq.h index 178afadd918..aa6c3d419df 100644 --- a/arch/arm/include/am335x/am335x_irq.h +++ b/arch/arm/include/am335x/am335x_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/am335x/am335x_irq.h * * Copyright (C) 2019 Petro Karashchenko. All rights reserved. @@ -31,24 +31,25 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_AM335X_AM335X_IRQ_H #define __ARCH_ARM_INCLUDE_AM335X_AM335X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts numbers */ + /* Interrupt number list */ #define AM335X_IRQ_EMU (0) /* Emulation interrupt */ @@ -320,21 +321,21 @@ AM335X_NGPIO0IRQS + AM335X_NGPIO1IRQS + \ AM335X_NGPIO2IRQS + AM335X_NGPIO3IRQS ) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/am335x/chip.h b/arch/arm/include/am335x/chip.h index b919124869c..3f3d49f9fd2 100644 --- a/arch/arm/include/am335x/chip.h +++ b/arch/arm/include/am335x/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/am335x/chip.h * * Copyright (C) 2018 Petro Karashchenko. All rights reserved. @@ -31,20 +31,20 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_AM335X_CHIP_H #define __ARCH_ARM_INCLUDE_AM335X_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* AM335X Family */ @@ -54,16 +54,16 @@ # error Unrecognized AM335X chip #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_AM335X_CHIP_H */ diff --git a/arch/arm/include/am335x/irq.h b/arch/arm/include/am335x/irq.h index 72b65e9f2cf..8c78c479c50 100644 --- a/arch/arm/include/am335x/irq.h +++ b/arch/arm/include/am335x/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/am335x/irq.h * * Copyright (C) 2019 Petro Karashchenko. All rights reserved. @@ -31,26 +31,22 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_AM335X_IRQ_H #define __ARCH_ARM_INCLUDE_AM335X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ - /* Chip-Specific External interrupts */ #if defined(CONFIG_ARCH_CHIP_AM335X) @@ -59,15 +55,19 @@ # error Unrecognized AM335X chip #endif -/**************************************************************************************** +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -77,9 +77,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/arch.h b/arch/arm/include/arch.h index 46d47b89a1e..4ddbb53f014 100644 --- a/arch/arm/include/arch.h +++ b/arch/arm/include/arch.h @@ -37,7 +37,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #ifdef CONFIG_PIC diff --git a/arch/arm/include/arm/irq.h b/arch/arm/include/arm/irq.h index 5a7982168ab..6c7f3aecc07 100644 --- a/arch/arm/include/arm/irq.h +++ b/arch/arm/include/arm/irq.h @@ -35,7 +35,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ Stack Frame Format: @@ -172,7 +172,7 @@ struct xcptcontext * leave_critical section(), are probably what you really want. */ - /* Save the current interrupt enable state & disable IRQs. */ +/* Save the current interrupt enable state & disable IRQs. */ static inline irqstate_t up_irq_save(void) { diff --git a/arch/arm/include/arm/syscall.h b/arch/arm/include/arm/syscall.h index bd5d86c51e2..f7be3c13070 100644 --- a/arch/arm/include/arm/syscall.h +++ b/arch/arm/include/arm/syscall.h @@ -36,7 +36,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define SYS_syscall 0x00 diff --git a/arch/arm/include/armv6-m/irq.h b/arch/arm/include/armv6-m/irq.h index 21ac8ea74b0..45ce521fcdb 100644 --- a/arch/arm/include/armv6-m/irq.h +++ b/arch/arm/include/armv6-m/irq.h @@ -40,10 +40,14 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ + /* Configuration ************************************************************/ -/* If this is a kernel build, how many nested system calls should we support? */ + +/* If this is a kernel build, + * how many nested system calls should we support? + */ #ifndef CONFIG_SYS_NNEST # define CONFIG_SYS_NNEST 2 diff --git a/arch/arm/include/armv6-m/syscall.h b/arch/arm/include/armv6-m/syscall.h index cf5a1e9c55d..da96e1f2e4a 100644 --- a/arch/arm/include/armv6-m/syscall.h +++ b/arch/arm/include/armv6-m/syscall.h @@ -36,7 +36,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* This is the value used as the argument to the SVC instruction. It is not diff --git a/arch/arm/include/armv7-a/irq.h b/arch/arm/include/armv7-a/irq.h index c9247c418f8..fc4075002ab 100644 --- a/arch/arm/include/armv7-a/irq.h +++ b/arch/arm/include/armv7-a/irq.h @@ -38,7 +38,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ Stack Frame Format: diff --git a/arch/arm/include/armv7-a/syscall.h b/arch/arm/include/armv7-a/syscall.h index 6ea02ae200f..a235a044493 100644 --- a/arch/arm/include/armv7-a/syscall.h +++ b/arch/arm/include/armv7-a/syscall.h @@ -36,7 +36,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define SYS_syscall 0x00 diff --git a/arch/arm/include/armv7-m/irq.h b/arch/arm/include/armv7-m/irq.h index 9520e6d5e1c..7cca75bb3e3 100644 --- a/arch/arm/include/armv7-m/irq.h +++ b/arch/arm/include/armv7-m/irq.h @@ -47,7 +47,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Configuration ************************************************************/ diff --git a/arch/arm/include/armv7-m/irq_cmnvector.h b/arch/arm/include/armv7-m/irq_cmnvector.h index 5117d8b759d..93b38357396 100644 --- a/arch/arm/include/armv7-m/irq_cmnvector.h +++ b/arch/arm/include/armv7-m/irq_cmnvector.h @@ -26,7 +26,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ Stack Frame Format: */ diff --git a/arch/arm/include/armv7-m/irq_lazyfpu.h b/arch/arm/include/armv7-m/irq_lazyfpu.h index 0837e7ca8ee..d632d4c8a26 100644 --- a/arch/arm/include/armv7-m/irq_lazyfpu.h +++ b/arch/arm/include/armv7-m/irq_lazyfpu.h @@ -26,7 +26,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ Stack Frame Format: */ diff --git a/arch/arm/include/armv7-m/nvicpri.h b/arch/arm/include/armv7-m/nvicpri.h index 59c34fae355..e081aaf5975 100644 --- a/arch/arm/include/armv7-m/nvicpri.h +++ b/arch/arm/include/armv7-m/nvicpri.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/armv7-m/nvicpri.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_ARM7_M_NVICPRI_H #define __ARCH_ARM_INCLUDE_ARM7_M_NVICPRI_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* If CONFIG_ARMV7M_USEBASEPRI is selected, then interrupts will be disabled * by setting the BASEPRI register to NVIC_SYSH_DISABLE_PRIORITY so that most diff --git a/arch/arm/include/armv7-m/syscall.h b/arch/arm/include/armv7-m/syscall.h index 6e9f57d2236..83e809f7d5a 100644 --- a/arch/arm/include/armv7-m/syscall.h +++ b/arch/arm/include/armv7-m/syscall.h @@ -36,7 +36,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* This is the value used as the argument to the SVC instruction. It is not diff --git a/arch/arm/include/armv7-r/irq.h b/arch/arm/include/armv7-r/irq.h index 771a3f06ed1..ebb5fddd736 100644 --- a/arch/arm/include/armv7-r/irq.h +++ b/arch/arm/include/armv7-r/irq.h @@ -38,7 +38,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ Stack Frame Format: diff --git a/arch/arm/include/armv7-r/syscall.h b/arch/arm/include/armv7-r/syscall.h index 7381ce67ec7..e86170f3479 100644 --- a/arch/arm/include/armv7-r/syscall.h +++ b/arch/arm/include/armv7-r/syscall.h @@ -36,7 +36,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define SYS_syscall 0x00 diff --git a/arch/arm/include/armv8-m/irq.h b/arch/arm/include/armv8-m/irq.h index 20eaff315c7..df03f7a1de4 100644 --- a/arch/arm/include/armv8-m/irq.h +++ b/arch/arm/include/armv8-m/irq.h @@ -47,7 +47,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Configuration ************************************************************/ diff --git a/arch/arm/include/armv8-m/irq_cmnvector.h b/arch/arm/include/armv8-m/irq_cmnvector.h index 4c784e70e0c..9956374d43d 100644 --- a/arch/arm/include/armv8-m/irq_cmnvector.h +++ b/arch/arm/include/armv8-m/irq_cmnvector.h @@ -26,7 +26,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ Stack Frame Format: */ diff --git a/arch/arm/include/armv8-m/irq_lazyfpu.h b/arch/arm/include/armv8-m/irq_lazyfpu.h index 33af6d81e06..1f3f0c77747 100644 --- a/arch/arm/include/armv8-m/irq_lazyfpu.h +++ b/arch/arm/include/armv8-m/irq_lazyfpu.h @@ -26,7 +26,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ Stack Frame Format: */ diff --git a/arch/arm/include/armv8-m/nvicpri.h b/arch/arm/include/armv8-m/nvicpri.h index 56aafb1efbf..c2b2d91948b 100644 --- a/arch/arm/include/armv8-m/nvicpri.h +++ b/arch/arm/include/armv8-m/nvicpri.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/armv8-m/nvicpri.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_ARM8_M_NVICPRI_H #define __ARCH_ARM_INCLUDE_ARM8_M_NVICPRI_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* If CONFIG_ARMV8M_USEBASEPRI is selected, then interrupts will be disabled * by setting the BASEPRI register to NVIC_SYSH_DISABLE_PRIORITY so that most diff --git a/arch/arm/include/armv8-m/syscall.h b/arch/arm/include/armv8-m/syscall.h index 03ad475950b..458c33a1ca2 100644 --- a/arch/arm/include/armv8-m/syscall.h +++ b/arch/arm/include/armv8-m/syscall.h @@ -36,7 +36,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* This is the value used as the argument to the SVC instruction. It is not diff --git a/arch/arm/include/c5471/irq.h b/arch/arm/include/c5471/irq.h index 7c06f41c224..d378321dea1 100644 --- a/arch/arm/include/c5471/irq.h +++ b/arch/arm/include/c5471/irq.h @@ -30,7 +30,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* C5471 Interrupts */ diff --git a/arch/arm/include/cxd56xx/adc.h b/arch/arm/include/cxd56xx/adc.h index 6817f0ab101..a4dba22be3e 100644 --- a/arch/arm/include/cxd56xx/adc.h +++ b/arch/arm/include/cxd56xx/adc.h @@ -45,7 +45,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define ANIOC_USER (AN_FIRST + AN_NCMDS) diff --git a/arch/arm/include/cxd56xx/audio.h b/arch/arm/include/cxd56xx/audio.h index a6c95cd1a34..df0a869a8d4 100644 --- a/arch/arm/include/cxd56xx/audio.h +++ b/arch/arm/include/cxd56xx/audio.h @@ -57,7 +57,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Mic channel max. */ diff --git a/arch/arm/include/cxd56xx/battery_ioctl.h b/arch/arm/include/cxd56xx/battery_ioctl.h index 971d45c8941..9b811f4a3cc 100644 --- a/arch/arm/include/cxd56xx/battery_ioctl.h +++ b/arch/arm/include/cxd56xx/battery_ioctl.h @@ -43,7 +43,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* ioctl commands */ diff --git a/arch/arm/include/cxd56xx/chip.h b/arch/arm/include/cxd56xx/chip.h index c9cc33b537d..c1afb4dfe0f 100644 --- a/arch/arm/include/cxd56xx/chip.h +++ b/arch/arm/include/cxd56xx/chip.h @@ -22,7 +22,7 @@ #define __ARCH_ARM_INCLUDE_CXD56XX_CHIP_H /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define CXD56M4_SYSH_PRIORITY_MIN 0xe0 /* All bits[7:5] set is minimum priority */ diff --git a/arch/arm/include/cxd56xx/crashdump.h b/arch/arm/include/cxd56xx/crashdump.h index 2f2e8c98f7f..58351cea5cf 100644 --- a/arch/arm/include/cxd56xx/crashdump.h +++ b/arch/arm/include/cxd56xx/crashdump.h @@ -47,7 +47,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Configuration ************************************************************/ diff --git a/arch/arm/include/cxd56xx/irq.h b/arch/arm/include/cxd56xx/irq.h index e48a727dafb..325d2f0e6ad 100644 --- a/arch/arm/include/cxd56xx/irq.h +++ b/arch/arm/include/cxd56xx/irq.h @@ -34,7 +34,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/cxd56xx/pin.h b/arch/arm/include/cxd56xx/pin.h index 8cfc36ad260..2785d9404d8 100644 --- a/arch/arm/include/cxd56xx/pin.h +++ b/arch/arm/include/cxd56xx/pin.h @@ -28,10 +28,10 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ -/* Pin number Definitions */ +/* Pin number Prototypes */ #define PIN_RTC_CLK_IN (0) diff --git a/arch/arm/include/cxd56xx/pm.h b/arch/arm/include/cxd56xx/pm.h index 430a99174d2..e542e404706 100644 --- a/arch/arm/include/cxd56xx/pm.h +++ b/arch/arm/include/cxd56xx/pm.h @@ -43,7 +43,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Boot Cause definitions */ @@ -138,7 +138,7 @@ struct pm_cpu_wakelock_s uint32_t info; }; -/* Definitions for pmic notify */ +/* Prototypes for pmic notify */ enum pmic_notify_e { diff --git a/arch/arm/include/cxd56xx/scu.h b/arch/arm/include/cxd56xx/scu.h index d1615920cc8..c9b352e3f00 100644 --- a/arch/arm/include/cxd56xx/scu.h +++ b/arch/arm/include/cxd56xx/scu.h @@ -45,7 +45,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define _SCUIOCBASE (0xa000) diff --git a/arch/arm/include/cxd56xx/timer.h b/arch/arm/include/cxd56xx/timer.h index c294212f74f..7534500b979 100644 --- a/arch/arm/include/cxd56xx/timer.h +++ b/arch/arm/include/cxd56xx/timer.h @@ -43,7 +43,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Set callback handler diff --git a/arch/arm/include/cxd56xx/usbdev.h b/arch/arm/include/cxd56xx/usbdev.h index 916be8775e3..650dcdaed97 100644 --- a/arch/arm/include/cxd56xx/usbdev.h +++ b/arch/arm/include/cxd56xx/usbdev.h @@ -41,7 +41,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* BOARDIOC_USBDEV_SETNOTIFYSIG signal value ********************************/ diff --git a/arch/arm/include/dm320/irq.h b/arch/arm/include/dm320/irq.h index 4e80b6270ad..3b9f7f8795e 100644 --- a/arch/arm/include/dm320/irq.h +++ b/arch/arm/include/dm320/irq.h @@ -30,7 +30,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* DM320 Interrupts */ diff --git a/arch/arm/include/efm32/chip.h b/arch/arm/include/efm32/chip.h index 8eb60e8b5b5..f6bdf29a700 100644 --- a/arch/arm/include/efm32/chip.h +++ b/arch/arm/include/efm32/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/efm32/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,29 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_EFM32_CHIP_H #define __ARCH_ARM_INCLUDE_EFM32_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* EFM32 EnergyMicro ****************************************************************/ +/* EFM32 EnergyMicro ********************************************************/ /* Tiny Gecko with 32KiB FLASH and 4KiB RAM in a QFN64 package */ #if defined(CONFIG_ARCH_CHIP_EFM32TG840F32) -/* Gecko with 128KiB FLASH and 16KiB SRAM in LQFP100 (EFM32G880F128) or BGA112 - * (EFM32G890F128) package +/* Gecko with 128KiB FLASH and 16KiB SRAM in LQFP100 (EFM32G880F128) or + * BGA112 (EFM32G890F128) package */ #elif defined(CONFIG_ARCH_CHIP_EFM32G880F128) || \ @@ -55,7 +55,7 @@ # error "Unsupported EFM32 chip" #endif -/* NVIC priority levels *************************************************************/ +/* NVIC priority levels *****************************************************/ #define NVIC_SYSH_PRIORITY_MIN 0xe0 /* Bits [7:5] set in minimum priority */ #define NVIC_SYSH_PRIORITY_DEFAULT 0x80 /* Midpoint is the default */ diff --git a/arch/arm/include/efm32/efm32g_irq.h b/arch/arm/include/efm32/efm32g_irq.h index 089109f275e..57cdd6398c0 100644 --- a/arch/arm/include/efm32/efm32g_irq.h +++ b/arch/arm/include/efm32/efm32g_irq.h @@ -30,7 +30,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map @@ -42,7 +42,8 @@ * * External interrupts (vectors >= 16) */ - /* IRQ# Source */ + + /* IRQ# Source */ #define EFM32_IRQ_DMA (EFM32_IRQ_INTERRUPTS + 0) /* 0 DMA */ #define EFM32_IRQ_GPIO_EVEN (EFM32_IRQ_INTERRUPTS + 1) /* 1 GPIO_EVEN */ #define EFM32_IRQ_TIMER0 (EFM32_IRQ_INTERRUPTS + 2) /* 2 TIMER0 */ @@ -95,7 +96,7 @@ extern "C" #endif /**************************************************************************** - * Public Functions + * Public Functions Prototypes ****************************************************************************/ #undef EXTERN diff --git a/arch/arm/include/efm32/efm32gg_irq.h b/arch/arm/include/efm32/efm32gg_irq.h index f8b856062af..8cea3c3cc6e 100644 --- a/arch/arm/include/efm32/efm32gg_irq.h +++ b/arch/arm/include/efm32/efm32gg_irq.h @@ -45,7 +45,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map @@ -119,7 +119,7 @@ extern "C" #endif /**************************************************************************** - * Public Functions + * Public Functions Prototypes ****************************************************************************/ #undef EXTERN diff --git a/arch/arm/include/efm32/efm32tg_irq.h b/arch/arm/include/efm32/efm32tg_irq.h index 039f56c408e..265a64be881 100644 --- a/arch/arm/include/efm32/efm32tg_irq.h +++ b/arch/arm/include/efm32/efm32tg_irq.h @@ -45,7 +45,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map @@ -103,7 +103,7 @@ extern "C" #endif /**************************************************************************** - * Public Functions + * Public Functions Prototypes ****************************************************************************/ #undef EXTERN diff --git a/arch/arm/include/efm32/irq.h b/arch/arm/include/efm32/irq.h index ae768a8f933..809a15723e7 100644 --- a/arch/arm/include/efm32/irq.h +++ b/arch/arm/include/efm32/irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/efm32/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,30 +16,41 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_EFM32_IRQ_H #define __ARCH_ARM_INCLUDE_EFM32_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +#if defined(CONFIG_EFM32_EFM32TG) +# include +#elif defined(CONFIG_EFM32_EFM32G) +# include +#elif defined(CONFIG_EFM32_EFM32GG) +# include +#else +# error "Unsupported EFM32 chip" +#endif -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to bits in + * the NVIC. This does, however, waste several words of memory in the IRQ * to handle mapping tables. */ @@ -59,25 +70,18 @@ #define EFM32_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define EFM32_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define EFM32_IRQ_INTERRUPTS (16) /* Vector number of the first external interrupt */ -#if defined(CONFIG_EFM32_EFM32TG) -# include -#elif defined(CONFIG_EFM32_EFM32G) -# include -#elif defined(CONFIG_EFM32_EFM32GG) -# include -#else -# error "Unsupported EFM32 chip" -#endif - #ifdef CONFIG_EFM32_GPIO_IRQ -/* If GPIO interrupt support is enabled then up to 16 additional GPIO interrupt - * sources are available. There are actually only two physical interrupt lines: - * GPIO_EVEN and GPIO_ODD. However, from the software point of view, there are - * 16-additional interrupts generated from a second level of decoding. +/* If GPIO interrupt support is enabled then up to 16 additional GPIO + * interrupt sources are available. There are actually only two physical + * interrupt lines: GPIO_EVEN and GPIO_ODD. However, from the software point + * of view, there are 16-additional interrupts generated from a second level + * of decoding. */ # define EFM32_IRQ_EXTI0 (EFM32_IRQ_NVECTORS + 0) /* Port[n], pin0 external interrupt */ @@ -102,13 +106,13 @@ # define NR_IRQS EFM32_IRQ_NVECTORS /* Total number of interrupts */ #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -119,9 +123,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/elf.h b/arch/arm/include/elf.h index f6207b73638..fb87e2cb74a 100644 --- a/arch/arm/include/elf.h +++ b/arch/arm/include/elf.h @@ -26,14 +26,15 @@ #define __ARCH_ARM_INCLUDE_ELF_H /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* 4.3.1 ELF Identification. Should have: * * e_machine = EM_ARM * e_ident[EI_CLASS] = ELFCLASS32 - * e_ident[EI_DATA] = ELFDATA2LSB (little endian) or ELFDATA2MSB (big endian) + * e_ident[EI_DATA] = ELFDATA2LSB (little endian) or + * ELFDATA2MSB (big endian) */ #if 0 /* Defined in include/elf32.h */ @@ -65,9 +66,10 @@ * S (when used on its own) is the address of the symbol. * A is the addend for the relocation. * P is the address of the place being relocated (derived from r_offset). - * Pa is the adjusted address of the place being relocated, defined as (P & 0xFFFFFFFC). - * T is 1 if the target symbol S has type STT_FUNC and the symbol addresses a Thumb instruction; - * it is 0 otherwise. + * Pa is the adjusted address of the place being relocated, defined as + * (P & 0xFFFFFFFC). + * T is 1 if the target symbol S has type STT_FUNC and the symbol addresses + * a Thumb instruction; it is 0 otherwise. * B(S) is the addressing origin of the output segment defining the symbol S. * GOT_ORG is the addressing origin of the Global Offset Table * GOT(S) is the address of the GOT entry for the symbol S. diff --git a/arch/arm/include/eoss3/chip.h b/arch/arm/include/eoss3/chip.h index 1fee037cf82..4c80933745c 100644 --- a/arch/arm/include/eoss3/chip.h +++ b/arch/arm/include/eoss3/chip.h @@ -28,7 +28,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* EOS S3 Support 8 Levels of priority. diff --git a/arch/arm/include/eoss3/irq.h b/arch/arm/include/eoss3/irq.h index 133ab48835a..d4c7afc6244 100644 --- a/arch/arm/include/eoss3/irq.h +++ b/arch/arm/include/eoss3/irq.h @@ -28,7 +28,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Common Processor Exceptions (vectors 0-15) */ diff --git a/arch/arm/include/imx1/irq.h b/arch/arm/include/imx1/irq.h index 0935a09ff37..125e13e1890 100644 --- a/arch/arm/include/imx1/irq.h +++ b/arch/arm/include/imx1/irq.h @@ -30,7 +30,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* i.MX1 Interrupts */ diff --git a/arch/arm/include/imx6/chip.h b/arch/arm/include/imx6/chip.h index 88a3178d521..a5fd39f5542 100644 --- a/arch/arm/include/imx6/chip.h +++ b/arch/arm/include/imx6/chip.h @@ -28,8 +28,9 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ + /* The i.MX6 6Quad and 6Dual/DualLite are the only support i.MX6 family * members. Individual differences between members of the families are not * accounted for. @@ -108,7 +109,7 @@ ****************************************************************************/ /**************************************************************************** - * Public Functions + * Public Functions Prototypes ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_IMX6_CHIP_H */ diff --git a/arch/arm/include/imx6/irq.h b/arch/arm/include/imx6/irq.h index 93bee0280bd..be6c8d35a50 100644 --- a/arch/arm/include/imx6/irq.h +++ b/arch/arm/include/imx6/irq.h @@ -18,8 +18,8 @@ * ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - & through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_IMX6_IRQ_H @@ -30,7 +30,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* The Global Interrupt Controller (GIC) collects up to 128 interrupt @@ -47,6 +47,7 @@ */ /* Private Peripheral Interrupts (PPI) **************************************/ + /* Each Cortex-A9 processor has private interrupts, ID0-ID15, that can only * be triggered by software. These interrupts are aliased so that there is * no requirement for a requesting Cortex-A9 processor to determine its own diff --git a/arch/arm/include/imxrt/chip.h b/arch/arm/include/imxrt/chip.h index 0843f832e07..6c3422d333b 100644 --- a/arch/arm/include/imxrt/chip.h +++ b/arch/arm/include/imxrt/chip.h @@ -1,4 +1,4 @@ -/***************************************************************************** +/**************************************************************************** * arch/arm/include/imxrt/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - *****************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_IMXRT_CHIP_H #define __ARCH_ARM_INCLUDE_IMXRT_CHIP_H -/***************************************************************************** +/**************************************************************************** * Included Files - *****************************************************************************/ + ****************************************************************************/ #include -/***************************************************************************** - * Pre-processor Definitions - *****************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ @@ -77,7 +77,8 @@ # error "Unknown i.MX RT chip type" #endif -/* NVIC priority levels ****************************************************** +/* NVIC priority levels *****************************************************/ + /* Each priority field holds an 8-bit priority value, 0-15. The lower the * value, the greater the priority of the corresponding interrupt. The i.MX * RT processor implements only bits[7:4] of each field, bits[3:0] read as @@ -89,16 +90,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x40 /* Two bits of interrupt pri used */ -/***************************************************************************** +/**************************************************************************** * Public Types - *****************************************************************************/ + ****************************************************************************/ -/***************************************************************************** +/**************************************************************************** * Public Data - *****************************************************************************/ + ****************************************************************************/ -/***************************************************************************** - * Public Functions - *****************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_IMXRT_CHIP_H */ diff --git a/arch/arm/include/imxrt/imxrt102x_irq.h b/arch/arm/include/imxrt/imxrt102x_irq.h index ceca8a33687..2918b578972 100644 --- a/arch/arm/include/imxrt/imxrt102x_irq.h +++ b/arch/arm/include/imxrt/imxrt102x_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/imxrt/imxrt102x_irq.h * * Copyright (C) 2018 Gregory Nutt. All rights reserved. @@ -32,24 +32,24 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_IMXRT_IMXRT102X_IRQ_H #define __ARCH_ARM_INCLUDE_IMXRT_IMXRT102X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* External interrupts (priority levels >= 256) *****************************************/ +/* External interrupts (priority levels >= 256) *****************************/ #define IMXRT_IRQ_EDMA0_16 (IMXRT_IRQ_EXTINT + 0) /* eDMA Channel 0/16 Transfer Complete */ #define IMXRT_IRQ_EDMA1_17 (IMXRT_IRQ_EXTINT + 1) /* eDMA Channel 1/17 Transfer Complete */ @@ -91,10 +91,14 @@ #define IMXRT_IRQ_CAN2 (IMXRT_IRQ_EXTINT + 37) /* CAN2 interrupt */ #define IMXRT_IRQ_CM7FR (IMXRT_IRQ_EXTINT + 38) /* FlexRAM address fault */ #define IMXRT_IRQ_KPP (IMXRT_IRQ_EXTINT + 39) /* Keypad Interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 40) RESERVED */ #define IMXRT_IRQ_GPRIRQ (IMXRT_IRQ_EXTINT + 41) /* Notify cores on exception while boot */ + /* RESERVED (IMXRT_IRQ_EXTINT + 42) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 43) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 44) RESERVED */ #define IMXRT_IRQ_WDOG2 (IMXRT_IRQ_EXTINT + 45) /* Watchdog Timer reset */ #define IMXRT_IRQ_SNVS (IMXRT_IRQ_EXTINT + 46) /* SNVS Functional Interrupt */ @@ -103,8 +107,10 @@ #define IMXRT_IRQ_CSU (IMXRT_IRQ_EXTINT + 49) /* CSU Interrupt Request 1 */ #define IMXRT_IRQ_DCP (IMXRT_IRQ_EXTINT + 50) /* DCP channel/CRC interrupts (channel != 0) */ #define IMXRT_IRQ_DCP0 (IMXRT_IRQ_EXTINT + 51) /* DCP channel 0 interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 52) RESERVED */ #define IMXRT_IRQ_TRNG (IMXRT_IRQ_EXTINT + 53) /* TRNG Interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 54) RESERVED */ #define IMXRT_IRQ_BEE (IMXRT_IRQ_EXTINT + 55) /* BEE IRQ */ #define IMXRT_IRQ_SAI1 (IMXRT_IRQ_EXTINT + 56) /* SAI1 interrupt (RX/TX) */ @@ -113,15 +119,19 @@ #define IMXRT_IRQ_SAI3TX (IMXRT_IRQ_EXTINT + 59) /* SAI3 TX interrupt (RX/TX) */ #define IMXRT_IRQ_SPDIF (IMXRT_IRQ_EXTINT + 60) /* SPDIF interrupt */ #define IMXRT_IRQ_PMU (IMXRT_IRQ_EXTINT + 61) /* Brown-out event 1.1, 2.5 or 3.0 regulators */ + /* RESERVED (IMXRT_IRQ_EXTINT + 62) RESERVED */ #define IMXRT_IRQ_TEMP (IMXRT_IRQ_EXTINT + 63) /* Temperature Monitor */ #define IMXRT_IRQ_TEMPPANIC (IMXRT_IRQ_EXTINT + 64) /* TempSensor panic */ #define IMXRT_IRQ_USBPHY0 (IMXRT_IRQ_EXTINT + 65) /* USBPHY (UTMI0) interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 66) RESERVED */ #define IMXRT_IRQ_ADC1 (IMXRT_IRQ_EXTINT + 67) /* ADC1 interrupt */ #define IMXRT_IRQ_ADC2 (IMXRT_IRQ_EXTINT + 68) /* ADC2 interrupt */ #define IMXRT_IRQ_DCDC (IMXRT_IRQ_EXTINT + 69) /* DCDC interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 70) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 71) RESERVED */ #define IMXRT_IRQ_GPIO1_0 (IMXRT_IRQ_EXTINT + 72) /* GPIO1 INT0 interrupt */ #define IMXRT_IRQ_GPIO1_1 (IMXRT_IRQ_EXTINT + 73) /* GPIO1 INT1 interrupt */ @@ -137,11 +147,14 @@ #define IMXRT_IRQ_GPIO2_16_31 (IMXRT_IRQ_EXTINT + 83) /* GPIO2 INT16-31 interrupt */ #define IMXRT_IRQ_GPIO3_0_15 (IMXRT_IRQ_EXTINT + 84) /* GPIO3 INT0-15 interrupt */ #define IMXRT_IRQ_GPIO3_16_31 (IMXRT_IRQ_EXTINT + 85) /* GPIO3 INT16-31 interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 86) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 87) RESERVED */ #define IMXRT_IRQ_GPIO5_0_15 (IMXRT_IRQ_EXTINT + 88) /* GPIO5 INT0-15 interrupt */ #define IMXRT_IRQ_GPIO5_16_31 (IMXRT_IRQ_EXTINT + 89) /* GPIO5 INT16-31 interrupt */ #define IMXRT_IRQ_FLEXIO1 (IMXRT_IRQ_EXTINT + 90) /* FlexIO Interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 91) RESERVED */ #define IMXRT_IRQ_WDOG1 (IMXRT_IRQ_EXTINT + 92) /* Watchdog Timer reset */ #define IMXRT_IRQ_RTWDOG (IMXRT_IRQ_EXTINT + 93) /* Watchdog Timer reset */ @@ -150,6 +163,7 @@ #define IMXRT_IRQ_CCM_2 (IMXRT_IRQ_EXTINT + 96) /* CCM interrupt 2 */ #define IMXRT_IRQ_GPC (IMXRT_IRQ_EXTINT + 97) /* GPC interrupt 1 */ #define IMXRT_IRQ_SRC (IMXRT_IRQ_EXTINT + 98) /* SRC interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 99) RESERVED */ #define IMXRT_IRQ_GPT1 (IMXRT_IRQ_EXTINT + 100) /* GPT1 interrupt */ #define IMXRT_IRQ_GPT2 (IMXRT_IRQ_EXTINT + 101) /* GPT2 interrupt */ @@ -158,11 +172,13 @@ #define IMXRT_IRQ_FLEXPWM1_2 (IMXRT_IRQ_EXTINT + 104) /* FLEXPWM1 capture/compare/reload 2 interrupt */ #define IMXRT_IRQ_FLEXPWM1_3 (IMXRT_IRQ_EXTINT + 105) /* FLEXPWM1 capture/compare/reload 3 interrupt */ #define IMXRT_IRQ_FLEXPWM1_F (IMXRT_IRQ_EXTINT + 106) /* FLEXPWM1 fault interrupt OR reload error */ + /* RESERVED (IMXRT_IRQ_EXTINT + 107) RESERVED */ #define IMXRT_IRQ_FLEXSPI (IMXRT_IRQ_EXTINT + 108) /* FlexSPI interrupt */ #define IMXRT_IRQ_SEMC (IMXRT_IRQ_EXTINT + 109) /* SEMC interrupt */ #define IMXRT_IRQ_USDHC1 (IMXRT_IRQ_EXTINT + 110) /* USDHC1 interrupt */ #define IMXRT_IRQ_USDHC2 (IMXRT_IRQ_EXTINT + 111) /* USDHC2 interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 112) RESERVED */ #define IMXRT_IRQ_USBOTG1 (IMXRT_IRQ_EXTINT + 113) /* USBO2 USB OTG1 interrupt */ #define IMXRT_IRQ_ENET (IMXRT_IRQ_EXTINT + 114) /* ENET MAC 0 interrupt */ @@ -178,49 +194,73 @@ #define IMXRT_IRQ_ACMP2 (IMXRT_IRQ_EXTINT + 124) /* ACMP2 interrupt */ #define IMXRT_IRQ_ACMP3 (IMXRT_IRQ_EXTINT + 125) /* ACMP3 interrupt */ #define IMXRT_IRQ_ACMP4 (IMXRT_IRQ_EXTINT + 126) /* ACMP4 interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 127) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 128) RESERVED */ #define IMXRT_IRQ_ENC1 (IMXRT_IRQ_EXTINT + 129) /* ENC1 interrupt */ #define IMXRT_IRQ_ENC2 (IMXRT_IRQ_EXTINT + 130) /* ENC2 interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 131) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 132) RESERVED */ #define IMXRT_IRQ_QTIMER1 (IMXRT_IRQ_EXTINT + 133) /* QTIMER1 timer 0-3 interrupt */ #define IMXRT_IRQ_QTIMER2 (IMXRT_IRQ_EXTINT + 134) /* QTIMER2 timer 0-3 interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 135) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 136) RESERVED */ #define IMXRT_IRQ_FLEXPWM2_0 (IMXRT_IRQ_EXTINT + 137) /* FLEXPWM2 capture/compare/reload 0 interrupt */ #define IMXRT_IRQ_FLEXPWM2_1 (IMXRT_IRQ_EXTINT + 138) /* FLEXPWM2 capture/compare/reload 1 interrupt */ #define IMXRT_IRQ_FLEXPWM2_2 (IMXRT_IRQ_EXTINT + 139) /* FLEXPWM2 capture/compare/reload 1 interrupt */ #define IMXRT_IRQ_FLEXPWM2_3 (IMXRT_IRQ_EXTINT + 140) /* FLEXPWM2 capture/compare/reload 3 interrupt */ #define IMXRT_IRQ_FLEXPWM2_F (IMXRT_IRQ_EXTINT + 141) /* FLEXPWM2 fault interrupt */ + /* RESERVED (IMXRT_IRQ_EXTINT + 142) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 143) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 144) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 146) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 147) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 148) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 149) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 150) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 151) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 152) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 153) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 154) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 155) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 156) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 157) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 158) RESERVED */ + /* RESERVED (IMXRT_IRQ_EXTINT + 159) RESERVED */ #define IMXRT_IRQ_NEXTINT 160 -/* GPIO second level interrupt **********************************************************/ +/* GPIO second level interrupt **********************************************/ #define IMXRT_GPIO_IRQ_FIRST (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT) #define _IMXRT_GPIO1_0_15_BASE IMXRT_GPIO_IRQ_FIRST #ifdef CONFIG_IMXRT_GPIO1_0_15_IRQ /* GPIO1 has dedicated interrupts for pins 0-7 - * REVISIT: I am assuming that you really cannot use the dedicated and the multiplex + * REVISIT: + * I am assuming that you really cannot use the dedicated and the multiplex * interrupts concurrently. */ @@ -431,25 +471,25 @@ IMXRT_GPIO3_NIRQS + IMXRT_GPIO5_NIRQS) #define IMXRT_GPIO_IRQ_LAST (_IMXRT_GPIO1_0_15_BASE + IMXRT_GPIO_NIRQS) -/* Total number of IRQ numbers **********************************************************/ +/* Total number of IRQ numbers **********************************************/ #define NR_IRQS (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT + IMXRT_GPIO_NIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/imxrt/imxrt105x_irq.h b/arch/arm/include/imxrt/imxrt105x_irq.h index b6a5c18b5a6..8f9a134ea13 100644 --- a/arch/arm/include/imxrt/imxrt105x_irq.h +++ b/arch/arm/include/imxrt/imxrt105x_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/imxrt/imxrt105x_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,24 +16,24 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_IMXRT_IMXRT105X_IRQ_H #define __ARCH_ARM_INCLUDE_IMXRT_IMXRT105X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* External interrupts (priority levels >= 256) *****************************************/ +/* External interrupts (priority levels >= 256) *****************************/ #define IMXRT_IRQ_EDMA0_16 (IMXRT_IRQ_EXTINT + 0) /* eDMA Channel 0/16 Transfer Complete */ #define IMXRT_IRQ_EDMA1_17 (IMXRT_IRQ_EXTINT + 1) /* eDMA Channel 1/17 Transfer Complete */ @@ -197,14 +197,15 @@ #define IMXRT_IRQ_NEXTINT 160 -/* GPIO second level interrupt **********************************************************/ +/* GPIO second level interrupt **********************************************/ #define IMXRT_GPIO_IRQ_FIRST (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT) #define _IMXRT_GPIO1_0_15_BASE IMXRT_GPIO_IRQ_FIRST #ifdef CONFIG_IMXRT_GPIO1_0_15_IRQ /* GPIO1 has dedicated interrupts for pins 0-7 - * REVISIT: I am assuming that you really cannot use the dedicated and the multiplex + * REVISIT: + * I am assuming that you really cannot use the dedicated and the multiplex * interrupts concurrently. */ @@ -465,25 +466,25 @@ IMXRT_GPIO5_NIRQS) #define IMXRT_GPIO_IRQ_LAST (_IMXRT_GPIO1_0_15_BASE + IMXRT_GPIO_NIRQS) -/* Total number of IRQ numbers **********************************************************/ +/* Total number of IRQ numbers **********************************************/ #define NR_IRQS (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT + IMXRT_GPIO_NIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/imxrt/imxrt106x_irq.h b/arch/arm/include/imxrt/imxrt106x_irq.h index 183ceb35339..00d443ca9a4 100644 --- a/arch/arm/include/imxrt/imxrt106x_irq.h +++ b/arch/arm/include/imxrt/imxrt106x_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/imxrt/imxrt106x_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,24 +16,24 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_IMXRT_IMXRT106X_IRQ_H #define __ARCH_ARM_INCLUDE_IMXRT_IMXRT106X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* External interrupts (priority levels >= 256) *****************************************/ +/* External interrupts (priority levels >= 256) *****************************/ #define IMXRT_IRQ_EDMA0_16 (IMXRT_IRQ_EXTINT + 0) /* eDMA Channel 0/16 Transfer Complete */ #define IMXRT_IRQ_EDMA1_17 (IMXRT_IRQ_EXTINT + 1) /* eDMA Channel 1/17 Transfer Complete */ @@ -190,21 +190,22 @@ #define IMXRT_IRQ_ENET2_1588 (IMXRT_IRQ_EXTINT + 153) /* ENET2 MAC 0 1588 Timer Interrupt */ #define IMXRT_IRQ_CAN3 (IMXRT_IRQ_EXTINT + 154) /* CAN3 interrupt */ #define IMXRT_IRQ_RESERVED155 (IMXRT_IRQ_EXTINT + 155) /* Reserved */ -#define IMXRT_IRQ_FLEXIO3 (IMXRT_IRQ_EXTINT + 156) /* IPI compare interrupt */ +#define IMXRT_IRQ_FLEXIO3 (IMXRT_IRQ_EXTINT + 156) /* IPI compare interrupt */ #define IMXRT_IRQ_GPIO_6789 (IMXRT_IRQ_EXTINT + 157) /* GPIO {6789} or'ed Interrupt */ #define IMXRT_IRQ_RESERVED158 (IMXRT_IRQ_EXTINT + 158) /* Reserved */ #define IMXRT_IRQ_RESERVED159 (IMXRT_IRQ_EXTINT + 159) /* Reserved */ #define IMXRT_IRQ_NEXTINT 160 -/* GPIO second level interrupt **********************************************************/ +/* GPIO second level interrupt **********************************************/ #define IMXRT_GPIO_IRQ_FIRST (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT) #define _IMXRT_GPIO1_0_15_BASE IMXRT_GPIO_IRQ_FIRST #ifdef CONFIG_IMXRT_GPIO1_0_15_IRQ /* GPIO1 has dedicated interrupts for pins 0-7 - * REVISIT: I am assuming that you really cannot use the dedicated and the multiplex + * REVISIT: + * I am assuming that you really cannot use the dedicated and the multiplex * interrupts concurrently. */ @@ -671,25 +672,25 @@ IMXRT_GPIO9_NIRQS ) #define IMXRT_GPIO_IRQ_LAST (_IMXRT_GPIO1_0_15_BASE + IMXRT_GPIO_NIRQS) -/* Total number of IRQ numbers **********************************************************/ +/* Total number of IRQ numbers **********************************************/ #define NR_IRQS (IMXRT_IRQ_EXTINT + IMXRT_IRQ_NEXTINT + IMXRT_GPIO_NIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/imxrt/irq.h b/arch/arm/include/imxrt/irq.h index 6c4affa5b59..98353ae3694 100644 --- a/arch/arm/include/imxrt/irq.h +++ b/arch/arm/include/imxrt/irq.h @@ -18,23 +18,33 @@ * ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_IMXRT_IRQ_H #define __ARCH_ARM_INCLUDE_IMXRT_IRQ_H -/***************************************************************************** +/**************************************************************************** * Included Files - *****************************************************************************/ + ****************************************************************************/ #include #include -/***************************************************************************** - * Pre-processor Definitions - *****************************************************************************/ +#if defined(CONFIG_ARCH_FAMILY_IMXRT102x) +# include +#elif defined(CONFIG_ARCH_FAMILY_IMXRT105x) +# include +#elif defined(CONFIG_ARCH_FAMILY_IMXRT106x) +# include +#else +# error Unrecognized i.MX RT architecture +#endif + +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words @@ -44,11 +54,11 @@ /* Common Processor Exceptions (vectors 0-15) */ #define IMXRT_IRQ_RESERVED (0) /* Reserved vector .. only used with - CONFIG_DEBUG_FEATURES */ + * CONFIG_DEBUG_FEATURES */ - /* Vector 0: Reset stack pointer value */ + /* Vector 0: Reset stack pointer value */ - /* Vector 1: Reset (not handled by IRQ) */ + /* Vector 1: Reset(not handled by IRQ) */ #define IMXRT_IRQ_NMI (2) /* Vector 2: Non-Maskable Int (NMI) */ #define IMXRT_IRQ_HARDFAULT (3) /* Vector 3: Hard fault */ @@ -68,16 +78,6 @@ #define IMXRT_IRQ_EXTINT (16) /* Vector number of the first ext int */ -#if defined(CONFIG_ARCH_FAMILY_IMXRT102x) -# include -#elif defined(CONFIG_ARCH_FAMILY_IMXRT105x) -# include -#elif defined(CONFIG_ARCH_FAMILY_IMXRT106x) -# include -#else -# error Unrecognized i.MX RT architecture -#endif - /**************************************************************************** * Public Types ****************************************************************************/ diff --git a/arch/arm/include/inttypes.h b/arch/arm/include/inttypes.h index f47ac324958..b06561d1ff2 100644 --- a/arch/arm/include/inttypes.h +++ b/arch/arm/include/inttypes.h @@ -41,7 +41,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define PRId8 "d" diff --git a/arch/arm/include/kinetis/chip.h b/arch/arm/include/kinetis/chip.h index 887cdf5b548..435ec2a3e64 100644 --- a/arch/arm/include/kinetis/chip.h +++ b/arch/arm/include/kinetis/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,14 +16,14 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KINETIS_CHIP_H #define __ARCH_ARM_INCLUDE_KINETIS_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include @@ -33,9 +33,9 @@ #include #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ @@ -1581,10 +1581,12 @@ # error "Unsupported Kinetis chip" #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0-15. The lower the value, the greater - * the priority of the corresponding interrupt. The processor implements only - * bits[7:4] of each field, bits[3:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0-15. The lower the value, + * the greater the priority of the corresponding interrupt. The processor + * implements only bits[7:4] of each field, bits[3:0] read as zero and ignore + * writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xf0 /* All bits[7:4] set is minimum priority */ @@ -1592,16 +1594,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x10 /* Steps between supported priority values */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_KINETIS_CHIP_H */ diff --git a/arch/arm/include/kinetis/irq.h b/arch/arm/include/kinetis/irq.h index a956211c04c..b57389a357b 100644 --- a/arch/arm/include/kinetis/irq.h +++ b/arch/arm/include/kinetis/irq.h @@ -18,26 +18,27 @@ * ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, only + * indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_KINETIS_IRQ_H #define __ARCH_ARM_INCLUDE_KINETIS_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to bits in + * the NVIC. This does, however, waste several words of memory in the IRQ * to handle mapping tables. */ @@ -58,7 +59,9 @@ #define KINETIS_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define KINETIS_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define KINETIS_IRQ_FIRST (16) /* Vector number of the first external interrupt */ @@ -75,22 +78,22 @@ #elif defined(CONFIG_ARCH_FAMILY_K66) # include #else - /* The interrupt vectors for other parts are defined in other documents and may or - * may not be the same as above (the family members are all very similar) This - * error just means that you have to look at the document and determine for yourself - * if the vectors are the same. - */ +/* The interrupt vectors for other parts are defined in other documents and + * may or may not be the same as above (the family members are all very + * similar) This error just means that you have to look at the document and + * determine for yourself if the vectors are the same. + */ # error "No IRQ numbers for this Kinetis K part" #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -101,9 +104,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/kinetis/kinetis_dma.h b/arch/arm/include/kinetis/kinetis_dma.h index f3d14180b8c..b4da0773318 100644 --- a/arch/arm/include/kinetis/kinetis_dma.h +++ b/arch/arm/include/kinetis/kinetis_dma.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_dma.h * * Copyright (C) 2018 Gregory Nutt. All rights reserved. @@ -31,26 +31,27 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMA_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMA_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Note: It is envisioned that in the long term as a chip is added. The author of - * the new chip definitions will either find the exact configuration in an existing - * chip define and add the new chip to it Or add the DMA feature configuration - * #defines to the chip ifdef list below. In either case the author should mark - * it as "Verified to Document Number:" taken from the reference manual. +/* Note: It is envisioned that in the long term as a chip is added. The + * author of the new chip definitions will either find the exact + * configuration in an existing chip define and add the new chip to it Or add + * the DMA feature configuration #defines to the chip ifdef list below. In + * either case the author should mark it as "Verified to Document Number:" + * taken from the reference manual. */ /* DMA Register Configuration @@ -72,9 +73,12 @@ * KINETIS_DMA_HAS_DCHPRI_CHPRI_BITS - DMA has 4 bit DCHPRI[DCHPRI] * KINETIS_DMA_HAS_DCHPRI_GRPPRI - DMA has DCHPRI[GRPPRI] * KINETIS_DMA_HAS_EARS - DMA has EARS Register - * KINETIS_DMA_HAS_TCD_CITER1_LINKCH_BITS - DMA has 4 bit TCD_CITER[LINKCH] - * KINETIS_DMA_HAS_TCD_CSR_MAJORLINKCH_BITS - DMA has 4 bit TCD_CSR[MAJORLINKCH] - * KINETIS_DMA_HAS_TCD_BITER1_LINKCH_BITS - DMA has 4 bit TCD_BITER[LINKCH] + * KINETIS_DMA_HAS_TCD_CITER1_LINKCH_BITS - DMA has 4 bit + * TCD_CITER[LINKCH] + * KINETIS_DMA_HAS_TCD_CSR_MAJORLINKCH_BITS - DMA has 4 bit + * TCD_CSR[MAJORLINKCH] + * KINETIS_DMA_HAS_TCD_BITER1_LINKCH_BITS - DMA has 4 bit + * TCD_BITER[LINKCH] */ /* Describe the version of the DMA @@ -119,7 +123,6 @@ # define KINETIS_DMA_VERSION KINETIS_DMA_VERSION_01 - /* MK66F N/X 1M0/2M0 V MD/LQ 18 * * --------------- ------- --- ------- ------- ------ ------ ------ ----- @@ -135,15 +138,17 @@ #elif defined(CONFIG_ARCH_CHIP_MK66FN2M0VMD18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VMD18) || \ defined(CONFIG_ARCH_CHIP_MK66FN2M0VLQ18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VLQ18) -/* Verified to Document Number: Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 */ +/* Verified to Document Number: + * Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 + */ # define KINETIS_DMA_VERSION KINETIS_DMA_VERSION_02 #else # define KINETIS_DMA_VERSION KINETIS_DMA_VERSION_UKN #endif -/* Use the catch all configuration for the DMA based on the implementations in nuttx - * prior 8/10/2018 +/* Use the catch all configuration for the DMA based on + * the implementations in nuttx prior 8/10/2018 */ #if KINETIS_DMA_VERSION == KINETIS_DMA_VERSION_UKN diff --git a/arch/arm/include/kinetis/kinetis_dmamux.h b/arch/arm/include/kinetis/kinetis_dmamux.h index 5777b328bd6..113064bfcc9 100644 --- a/arch/arm/include/kinetis/kinetis_dmamux.h +++ b/arch/arm/include/kinetis/kinetis_dmamux.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_dmamux.h * * Copyright (C) 2018 Gregory Nutt. All rights reserved. @@ -31,31 +31,34 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMAMUX_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_DMAMUX_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Note: It is envisioned that in the long term as a chip is added. The author of - * the new chip definitions will either find the exact configuration in an existing - * chip define and add the new chip to it Or add the DMAMUX feature configuration - * #defines to the chip ifdef list below. In either case the author should mark - * it as "Verified to Document Number:" taken from the reference manual. +/* Note: + * It is envisioned that in the long term as a chip is added. The author of + * the new chip definitions will either find the exact configuration in an + * existing chip define and add the new chip to it Or add the DMAMUX feature + * configuration #defines to the chip ifdef list below. In either case the + * author should mark it as "Verified to Document Number:" taken from the + * reference manual. */ /* DMAMUX Register Configuration * - * KINETIS_DMAMUX_HAS_MONOTONIC_CHCFG 0|1 - SoC has reg in 0,1,2..KINETIS_NDMACH + * KINETIS_DMAMUX_HAS_MONOTONIC_CHCFG 0|1 + * - SoC has reg in 0,1,2..KINETIS_NDMACH */ /* Describe the version of the DMA @@ -115,7 +118,9 @@ #elif defined(CONFIG_ARCH_CHIP_MK66FN2M0VMD18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VMD18) || \ defined(CONFIG_ARCH_CHIP_MK66FN2M0VLQ18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VLQ18) -/* Verified to Document Number: Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 */ +/* Verified to Document Number: + * Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 + */ # define KINETIS_DMAMUX_VERSION KINETIS_DMAMUX_VERSION_02 @@ -123,8 +128,8 @@ # define KINETIS_DMAMUX_VERSION KINETIS_DMAMUX_VERSION_UKN #endif -/* Use the catch all configuration for the DMAMUX based on the implementations in - * nuttx prior 8/10/2018 +/* Use the catch all configuration for the DMAMUX based on the + * implementations in nuttx prior 8/10/2018 */ #if KINETIS_DMA_VERSION == KINETIS_DMAMUX_VERSION_01 diff --git a/arch/arm/include/kinetis/kinetis_k20irq.h b/arch/arm/include/kinetis/kinetis_k20irq.h index 384b0b27991..e46bcad71da 100644 --- a/arch/arm/include/kinetis/kinetis_k20irq.h +++ b/arch/arm/include/kinetis/kinetis_k20irq.h @@ -1,4 +1,4 @@ -/************************************************************************************** +/**************************************************************************** * arch/arm/include/kinetis/kinetis_k20irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - *************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, only indirectly * through nuttx/irq.h @@ -25,26 +25,26 @@ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K20IRQ_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K20IRQ_H -/************************************************************************************** +/**************************************************************************** * Included Files - *************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************** - * Pre-processor Definitions - *************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) * - * K20 Family ************************************************************************* + * K20 Family *************************************************************** * * The interrupt vectors for the following parts is defined in Freescale * document K20P64M72SF1RM @@ -148,19 +148,20 @@ #define KINETIS_IRQ_SWI (KINETIS_IRQ_FIRST + 94) /* 94: Software interrupt */ #define KINETIS_IRQ_NEXTINTS 95 /* 95 Non core IRQs */ + #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 111 vectors */ /* EXTI interrupts (Do not use IRQ numbers) */ #define NR_IRQS KINETIS_IRQ_NVECTORS -/************************************************************************************** +/**************************************************************************** * Public Types - *************************************************************************************/ + ****************************************************************************/ -/************************************************************************************** +/**************************************************************************** * Public Data - *************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -171,9 +172,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************** - * Public Functions - *************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/kinetis/kinetis_k28irq.h b/arch/arm/include/kinetis/kinetis_k28irq.h index c0c474943ee..0c8bbdd98e1 100644 --- a/arch/arm/include/kinetis/kinetis_k28irq.h +++ b/arch/arm/include/kinetis/kinetis_k28irq.h @@ -1,4 +1,4 @@ -/********************************************************************************************* +/**************************************************************************** * arch/arm/include/kinetis/kinetis_k28irq.h * * Copyright (C) 2018 Gregory Nutt. All rights reserved. @@ -31,35 +31,35 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ********************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K28IRQ_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K28IRQ_H -/********************************************************************************************* +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #include -/********************************************************************************************* - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) * - * K28 Family ******************************************************************************** + * K28 Family *************************************************************** * * The interrupt vectors for the following parts is defined in Freescale * document K28P210M150SF5RM @@ -186,19 +186,20 @@ #define KINETIS_IRQ_RESVD106 (KINETIS_IRQ_FIRST + 106) /* 106: Reserved */ #define KINETIS_IRQ_NEXTINTS 107 /* 107 Non core IRQs */ + #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 123 vectors */ /* EXTI interrupts (Do not use IRQ numbers) */ #define NR_IRQS KINETIS_IRQ_NVECTORS -/********************************************************************************************* +/**************************************************************************** * Public Types - ********************************************************************************************/ + ****************************************************************************/ -/********************************************************************************************* +/**************************************************************************** * Public Data - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -209,9 +210,9 @@ extern "C" #define EXTERN extern #endif -/********************************************************************************************* - * Public Functions - ********************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/kinetis/kinetis_k40irq.h b/arch/arm/include/kinetis/kinetis_k40irq.h index fa6938e07c9..b33a844ac4a 100644 --- a/arch/arm/include/kinetis/kinetis_k40irq.h +++ b/arch/arm/include/kinetis/kinetis_k40irq.h @@ -1,4 +1,4 @@ -/************************************************************************************* +/**************************************************************************** * arch/arm/include/kinetis/kinetis_k40irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,35 +16,35 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_40KIRQ_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_40KIRQ_H -/************************************************************************************* +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************* - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) * - * K40 Family ************************************************************************ + * K40 Family *************************************************************** * * The interrupt vectors for the following parts is defined in Freescale * document K40P144M100SF2RM @@ -148,19 +148,20 @@ #define KINETIS_IRQ_SWI (KINETIS_IRQ_FIRST + 94) /* 94: Software interrupt */ #define KINETIS_IRQ_NEXTINTS 95 /* 95 Non core IRQs */ + #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 111 vectors */ /* EXTI interrupts (Do not use IRQ numbers) */ #define NR_IRQS KINETIS_IRQ_NVECTORS -/************************************************************************************* +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************* +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -171,9 +172,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************* - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/kinetis/kinetis_k60irq.h b/arch/arm/include/kinetis/kinetis_k60irq.h index 7ba22a15f68..6b134a52f46 100644 --- a/arch/arm/include/kinetis/kinetis_k60irq.h +++ b/arch/arm/include/kinetis/kinetis_k60irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_k60irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,35 +16,35 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_60KIRQ_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_60KIRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) * - * K60 Family ************************************************************************ + * K60 Family *************************************************************** * * The interrupt vectors for the following parts is defined in Freescale * document K60P144M100SF2RM @@ -148,19 +148,20 @@ #define KINETIS_IRQ_SWI (KINETIS_IRQ_FIRST + 94) /* 94: Software interrupt */ #define KINETIS_IRQ_NEXTINTS 95 /* 95 Non core IRQs */ + #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 111 vectors */ /* EXTI interrupts (Do not use IRQ numbers) */ #define NR_IRQS KINETIS_IRQ_NVECTORS -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -171,9 +172,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/kinetis/kinetis_k64irq.h b/arch/arm/include/kinetis/kinetis_k64irq.h index 898fa5dc697..e72ec122f24 100644 --- a/arch/arm/include/kinetis/kinetis_k64irq.h +++ b/arch/arm/include/kinetis/kinetis_k64irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_k64irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,35 +16,35 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_64KIRQ_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_64KIRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) * - * K60 Family ************************************************************************ + * K60 Family *************************************************************** * * The interrupt vectors for the following parts is defined in Freescale * document K64P144M120SF5RM.pdf @@ -138,19 +138,20 @@ #define KINETIS_IRQ_EMACMISC (KINETIS_IRQ_FIRST + 85) /* 85: Ethernet MAC error and misc interrupt */ #define KINETIS_IRQ_NEXTINTS 86 /* 86 Non core IRQs */ + #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 102 vectors */ /* EXTI interrupts (Do not use IRQ numbers) */ #define NR_IRQS KINETIS_IRQ_NVECTORS -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -161,9 +162,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/kinetis/kinetis_k66irq.h b/arch/arm/include/kinetis/kinetis_k66irq.h index 957e9de6b06..d20e523dfa2 100644 --- a/arch/arm/include/kinetis/kinetis_k66irq.h +++ b/arch/arm/include/kinetis/kinetis_k66irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_k66irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,35 +16,35 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K66IRQ_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_K66IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) * - * K66 Family ************************************************************************ + * K66 Family *************************************************************** * * The interrupt vectors for the following parts is defined in Freescale * document K66P144M180SF5RMV2 @@ -152,21 +152,21 @@ #define KINETIS_IRQ_CAN1RW (KINETIS_IRQ_FIRST + 98) /* 98: CAN1 Receive Warning */ #define KINETIS_IRQ_CAN1WU (KINETIS_IRQ_FIRST + 99) /* 99: CAN1 Wake UP */ - #define KINETIS_IRQ_NEXTINTS 100 /* 100 Non core IRQs*/ + #define KINETIS_IRQ_NVECTORS (KINETIS_IRQ_FIRST + KINETIS_IRQ_NEXTINTS) /* 116 vectors */ /* EXTI interrupts (Do not use IRQ numbers) */ #define NR_IRQS KINETIS_IRQ_NVECTORS -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -177,9 +177,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/kinetis/kinetis_lpuart.h b/arch/arm/include/kinetis/kinetis_lpuart.h index 9c9ff70ac7b..c856fdcab99 100644 --- a/arch/arm/include/kinetis/kinetis_lpuart.h +++ b/arch/arm/include/kinetis/kinetis_lpuart.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_lpuart.h * * Copyright (C) 2018 Gregory Nutt. All rights reserved. @@ -31,36 +31,38 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_LPUART_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_LPUART_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include "chip.h" -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Note: It is envisioned that in the long term as a chip is added. The author of - * the new chip definitions will either find the exact configuration in an existing - * chip define and add the new chip to it Or add the LPUART feature configuration - * #defines to the chip ifdef list below. In either case the author should mark - * it as "Verified to Document Number:" taken from the reference manual. +/* Note: + * It is envisioned that in the long term as a chip is added. The author of + * the new chip definitions will either find the exact configuration in an + * existing chip define and add the new chip to it Or add the LPUART feature + * configuration #defines to the chip ifdef list below. In either case the + * author should mark it as "Verified to Document Number:" taken from the + * reference manual. * * To maintain backward compatibility to the version of NuttX prior to - * 2/22/2017, the catch all KINETIS_LPUART_VERSION_UKN configuration is assigned - * to all the chips that did not have any conditional compilation based on - * KINETIS_K64 or KINETIS_K66. This is a "No worse" than the original code solution. - * N.B. Each original chip "if"definitions have been left intact so that the - * complete legacy definitions prior to 2/22/2017 may be filled in completely when - * vetted. + * 2/22/2017, the catch all KINETIS_LPUART_VERSION_UKN configuration is + * assigned to all the chips that did not have any conditional compilation + * based on KINETIS_K64 or KINETIS_K66. This is a "No worse" than the + * original code solution. N.B. Each original chip "if"definitions have been + * left intact so that the complete legacy definitions prior to 2/22/2017 may + * be filled in completely when vetted. */ /* LPUART Register Configuration @@ -138,7 +140,9 @@ #elif defined(CONFIG_ARCH_CHIP_MK28FN2M0VMI15) || \ defined(CONFIG_ARCH_CHIP_MK28FN2M0CAU15R) -/* Verified to Document Number: Verified to Document Number: K28P210M150SF5RM Rev. 4, August 2017 */ +/* Verified to Document Number: + * Verified to Document Number: K28P210M150SF5RM Rev. 4, August 2017 + */ # define KINETIS_LPUART_VERSION KINETIS_LPUART_VERSION_01 @@ -256,7 +260,9 @@ # error "Unsupported Kinetis chip" #endif -/* Use the catch all configuration for the LPUART based on the implementations in nuttx prior 2/3/2017 */ +/* Use the catch all configuration for the LPUART based on the + * implementations in nuttx prior 2/3/2017 + */ #if KINETIS_LPUART_VERSION == KINETIS_LPUART_VERSION_UKN diff --git a/arch/arm/include/kinetis/kinetis_mcg.h b/arch/arm/include/kinetis/kinetis_mcg.h index a5caf4904f3..05979d25375 100644 --- a/arch/arm/include/kinetis/kinetis_mcg.h +++ b/arch/arm/include/kinetis/kinetis_mcg.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_mcg.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,47 +16,53 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_MCG_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_MCG_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Note: It is envisioned that in the long term as a chip is added. The author of - * the new chip definitions will either find the exact configuration in an existing - * chip define and add the new chip to it Or add the MCG feature configuration - * #defines to the chip ifdef list below. In either case the author should mark - * it as "Verified to Document Number:" taken from the reference manual. +/* Note: + * It is envisioned that in the long term as a chip is added. The author of + * the new chip definitions will either find the exact configuration in an + * existing chip define and add the new chip to it Or add the MCG feature + * configuration #defines to the chip ifdef list below. In either case the + * author should mark it as "Verified to Document Number:" taken from the + * reference manual. * * To maintain backward compatibility to the version of NuttX prior to * 2/5/2017, the catch all KINETIS_MCG_VERSION_UKN configuration is assigned * to all the chips that did not have any conditional compilation based on - * NEW_MCG or KINETIS_K64. This is a "No worse" than the original code solution. - * N.B. Each original chip "if"definitions have been left intact so that the - * complete legacy definitions prior to 2/5/2017 may be filled in completely when - * vetted. + * NEW_MCG or KINETIS_K64. This is a "No worse" than the original code + * solution. N.B. Each original chip "if"definitions have been left intact so + * that the complete legacy definitions prior to 2/5/2017 may be filled in + * completely when vetted. */ /* MCG Configuration Parameters * * KINETIS_MCG_PLL_REF_MIN - OSCCLK/PLL_R minimum * KINETIS_MCG_PLL_REF_MAX - OSCCLK/PLL_R maximum - * KINETIS_MCG_PLL_INTERNAL_DIVBY - The PLL clock is divided by n before VCO divider - * KINETIS_MCG_HAS_PLL_EXTRA_DIVBY - Is PLL clock divided by n before MCG PLL/FLL + * KINETIS_MCG_PLL_INTERNAL_DIVBY - The PLL clock is divided by n + * before VCO divider + * KINETIS_MCG_HAS_PLL_EXTRA_DIVBY - Is PLL clock divided by n + * before MCG PLL/FLL * clock selection in the SIM module * KINETIS_MCG_FFCLK_DIVBY - MCGFFCLK divided by n - * KINETIS_MCG_HAS_IRC_48M - Has 48MHz internal oscillator - * KINETIS_MCG_HAS_LOW_FREQ_IRC - Has LTRIMRNG, LFRIM, LSTRIM and bit MC[LIRC_DIV2] - * KINETIS_MCG_HAS_HIGH_FREQ_IRC - Has HCTRIM, HTTRIM, HFTRIM and bit MC[HIRCEN] + * KINETIS_MCG_HAS_IRC_48M - Has 48MHz internal oscillator + * KINETIS_MCG_HAS_LOW_FREQ_IRC - Has LTRIMRNG, LFRIM, + * LSTRIM and bit MC[LIRC_DIV2] + * KINETIS_MCG_HAS_HIGH_FREQ_IRC - Has HCTRIM, HTTRIM, + * HFTRIM and bit MC[HIRCEN] * KINETIS_MCG_HAS_PLL_INTERNAL_MODE - Has PEI mode or PBI mode * KINETIS_MCG_HAS_RESET_IS_BLPI - Has Reset clock mode is BLPI * @@ -65,7 +71,8 @@ * KINETIS_MCG_HAS_C1 - SoC has C1 Register * KINETIS_MCG_HAS_C1_IREFS - SoC has C1[IREFS] * KINETIS_MCG_HAS_C1_FRDIV - SoC has C1[FRDIV] - * KINETIS_MCG_C1_FRDIV_MAX - C1[FRDIV] maximum value 5=1024, 6=1280 7=1536 + * KINETIS_MCG_C1_FRDIV_MAX - C1[FRDIV] maximum value + * 5=1024, 6=1280 7=1536 * KINETIS_MCG_HAS_C2 - SoC has C2 Register * KINETIS_MCG_HAS_C2_HGO - SoC has C2[HGO] * KINETIS_MCG_HAS_C2_RANGE - SoC has C2[RANG] @@ -75,13 +82,16 @@ * KINETIS_MCG_HAS_C4 - SoC has C4 Register * KINETIS_MCG_HAS_C5 - SoC has C5 Register * KINETIS_MCG_HAS_C5_PRDIV - SoC has C5[PRDIV] - * KINETIS_MCG_C5_PRDIV_BASE - PRDIV base value corresponding to 0 in C5[PRDIV] + * KINETIS_MCG_C5_PRDIV_BASE - PRDIV base value + * corresponding to 0 in C5[PRDIV] * KINETIS_MCG_C5_PRDIV_MAX - The Maximum value of C5[PRVDIV]) - * KINETIS_MCG_C5_PRDIV_BITS - Has n bits of phase-locked loop (PLL) PRDIV (register C5[PRDIV] + * KINETIS_MCG_C5_PRDIV_BITS - Has n bits of phase-locked loop + * (PLL) PRDIV (register C5[PRDIV] * KINETIS_MCG_HAS_C5_PLLREFSEL0 - SoC has C5[PLLREFSEL0] * KINETIS_MCG_HAS_C6 - SoC has C6 Register * KINETIS_MCG_HAS_C6_VDIV - SoC has C6[VDIV] - * KINETIS_MCG_C6_VDIV_BASE - VDIV base value corresponding to 0 in C6[VDIV] + * KINETIS_MCG_C6_VDIV_BASE - VDIV base value + * corresponding to 0 in C6[VDIV] * KINETIS_MCG_C6_VDIV_MAX - The Maximum value of C6[VDIV] * KINETIS_MCG_HAS_C6_CME - SoC has C6[CME] * KINETIS_MCG_HAS_C6_PLLS - SoC has C6[PLLS] @@ -112,12 +122,14 @@ * KINETIS_MCG_HAS_C10 - SoC has C10 Register * KINETIS_MCG_HAS_C10_LOCS1 - SoC has C10[LOCS1] * KINETIS_MCG_HAS_C11 - SoC has C11 Register - * KINETIS_MCG_HAS_C11_PLL1OSC1 - SoC has C1[PRDIV1], C11[PLLSTEN1], C11[PLLCLKEN1], C11[PLLREFSEL1], + * KINETIS_MCG_HAS_C11_PLL1OSC1 - SoC has C1[PRDIV1], C11[PLLSTEN1], + * C11[PLLCLKEN1], C11[PLLREFSEL1], * KINETIS_MCG_HAS_C11_PLLCS - SoC has C11[PLLCS] * KINETIS_MCG_HAS_C11_PLLREFSEL1 - SoC has C11[PLLREFSEL1] * KINETIS_MCG_HAS_C12 - SoC has C12 Register * KINETIS_MCG_HAS_S2 - SoC has S2 Register - * KINETIS_MCG_HAS_S2_PLL1OSC1 - SoC has S2[LOCS2], S2[OSCINIT1], S2[LOCK1], S2[LOLS1] + * KINETIS_MCG_HAS_S2_PLL1OSC1 - SoC has S2[LOCS2], + * S2[OSCINIT1], S2[LOCK1], S2[LOLS1] * KINETIS_MCG_HAS_S2_PLLCST - SoC has S2[PLLCST] */ @@ -192,7 +204,9 @@ #elif defined(CONFIG_ARCH_CHIP_MK28FN2M0VMI15) || defined(CONFIG_ARCH_CHIP_MK28FN2M0CAU15R) -/* Verified to Document Number: K28P210M150SF5RM Rev. 4, August 2017 */ +/* Verified to Document Number: + * K28P210M150SF5RM Rev. 4, August 2017 + */ # define KINETIS_MCG_VERSION KINETIS_MCG_VERSION_06 @@ -201,9 +215,10 @@ # define KINETIS_MCG_PLL_REF_MIN 8000000 /* OSCCLK/PLL_R minimum */ # define KINETIS_MCG_PLL_REF_MAX 16000000 /* OSCCLK/PLL_R maximum */ -/* TODO: The following configuration parameters have not been verified. They were - * taken wholesale from the K66F. The K66F is very similar and, most likely, the - * settings are corred. +/* TODO: + * The following configuration parameters have not been verified. They were + * taken wholesale from the K66F. The K66F is very similar and, most likely, + * the settings are corred. */ # define KINETIS_MCG_PLL_INTERNAL_DIVBY 2 /* The PLL clock is divided by 2 before VCO divider */ @@ -546,7 +561,9 @@ #elif defined(CONFIG_ARCH_CHIP_MK66FN2M0VMD18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VMD18) || \ defined(CONFIG_ARCH_CHIP_MK66FN2M0VLQ18) || defined(CONFIG_ARCH_CHIP_MK66FX1M0VLQ18) -/* Verified to Document Number: Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 */ +/* Verified to Document Number: + * Document Number: K66P144M180SF5RMV2 Rev. 2, May 2015 + */ # define KINETIS_MCG_VERSION KINETIS_MCG_VERSION_06 @@ -646,7 +663,9 @@ # error "Unsupported Kinetis chip" #endif -/* Use the catch all configuration for the MCG based on the implementations in nuttx prior 2/3/2017 */ +/* Use the catch all configuration for the MCG based on + * the implementations in nuttx prior 2/3/2017 + */ #if KINETIS_MCG_VERSION == KINETIS_MCG_VERSION_UKN diff --git a/arch/arm/include/kinetis/kinetis_pmc.h b/arch/arm/include/kinetis/kinetis_pmc.h index 37b77c6e2fd..7a03c13b2b5 100644 --- a/arch/arm/include/kinetis/kinetis_pmc.h +++ b/arch/arm/include/kinetis/kinetis_pmc.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_pmc.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,34 +16,36 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_PMC_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_PMC_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Note: It is envisioned that in the long term as a chip is added. The author of - * the new chip definitions will either find the exact configuration in an existing - * chip define and add the new chip to it Or add the PMC feature configuration - * #defines to the chip ifdef list below. In either case the author should mark - * it as "Verified to Document Number:" taken from the reference manual. +/* Note: + * It is envisioned that in the long term as a chip is added. The author of + * the new chip definitions will either find the exact configuration in an + * existing chip define and add the new chip to it Or add the PMC feature + * configuration #defines to the chip ifdef list below. In either case the + * author should mark it as "Verified to Document Number:" taken from the + * reference manual. * * To maintain backward compatibility to the version of NuttX prior to * 2/22/2017, the catch all KINETIS_PMC_VERSION_UKN configuration is assigned * to all the chips that did not have any conditional compilation based on - * KINETIS_K64 or KINETIS_K66. This is a "No worse" than the original code solution. - * N.B. Each original chip "if"definitions have been left intact so that the - * complete legacy definitions prior to 2/22/2017 may be filled in completely when - * vetted. + * KINETIS_K64 or KINETIS_K66. This is a "No worse" than the original code + * solution. N.B. Each original chip "if"definitions have been left intact so + * that the complete legacy definitions prior to 2/22/2017 may be filled in + * completely when vetted. */ /* PMC Register Configuration @@ -323,8 +325,8 @@ # error "Unsupported Kinetis chip" #endif -/* Use the catch all configuration for the PMC based on the implementations in - * NuttX prior to 2/3/2017 +/* Use the catch all configuration for the PMC based on + * the implementations in NuttX prior to 2/3/2017 */ #if KINETIS_PMC_VERSION == KINETIS_PMC_VERSION_UKN diff --git a/arch/arm/include/kinetis/kinetis_sim.h b/arch/arm/include/kinetis/kinetis_sim.h index 2960f5029d2..a665d5961cb 100644 --- a/arch/arm/include/kinetis/kinetis_sim.h +++ b/arch/arm/include/kinetis/kinetis_sim.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kinetis/kinetis_sim.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,34 +16,36 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KINETIS_KINETIS_SIM_H #define __ARCH_ARM_INCLUDE_KINETIS_KINETIS_SIM_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Note: It is envisioned that in the long term as a chip is added. The author of - * the new chip definitions will either find the exact configuration in an existing - * chip define and add the new chip to it Or add the SIM feature configuration - * #defines to the chip ifdef list below. In either case the author should mark - * it as "Verified to Document Number:" taken from the reference manual. +/* Note: + * It is envisioned that in the long term as a chip is added. The author of + * the new chip definitions will either find the exact configuration in an + * existing chip define and add the new chip to it Or add the SIM feature + * configuration #defines to the chip ifdef list below. In either case the + * author should mark it as "Verified to Document Number:" taken from the + * reference manual. * * To maintain backward compatibility to the version of NuttX prior to - * 2/16/2017, the catch all KINETIS_SIM_VERSION_UKN configuration is assigned - * to all the chips that did not have any conditional compilation based on - * KINETIS_K64 or KINETIS_K66. This is a "No worse" than the original code solution. - * N.B. Each original chip "if"definitions have been left intact so that the - * complete legacy definitions prior to 2/16/2017 may be filled in completely when - * vetted. + * 2/16/2017, the catch all KINETIS_SIM_VERSION_UKN configuration is + * assigned to all the chips that did not have any conditional compilation + * based on KINETIS_K64 or KINETIS_K66. This is a "No worse" than the + * original code solution. N.B. Each original chip "if"definitions have been + * left intact so that the complete legacy definitions prior to 2/16/2017 may + * be filled in completely when vetted. */ /* SIM Register Configuration @@ -95,7 +97,8 @@ * KINETIS_SIM_HAS_SOPT4_FTM0FLT3 - SoC has SOPT4[FTM0FLT3] * KINETIS_SIM_HAS_SOPT4_FTM0TRG0SRC - SoC has SOPT4[FTM0TRG0SRC] * KINETIS_SIM_HAS_SOPT4_FTM0TRG1SRC - SoC has SOPT4[FTM0TRG1SRC] - * KINETIS_SIM_HAS_SOPT4_FTM1CH0SRC - SoC has SOPT4[FTM1CH0SRC] 1, 3 if SOF + * KINETIS_SIM_HAS_SOPT4_FTM1CH0SRC - SoC has SOPT4[FTM1CH0SRC] + * 1, 3 if SOF * KINETIS_SIM_HAS_SOPT4_FTM1FLT0 - SoC has SOPT4[FTM1FLT0] * KINETIS_SIM_HAS_SOPT4_FTM1FLT1 - SoC has SOPT4[FTM1FLT1] * KINETIS_SIM_HAS_SOPT4_FTM1FLT2 - SoC has SOPT4[FTM1FLT2] @@ -143,10 +146,14 @@ * KINETIS_SIM_HAS_SOPT7_ADC1TRGSEL - SoC has n SOPT7[ADC1TRGSEL] * KINETIS_SIM_HAS_SOPT7_ADC2TRGSEL - SoC has n SOPT7[ADC2TRGSEL] * KINETIS_SIM_HAS_SOPT7_ADC3TRGSEL - SoC has n SOPT7[ADC3TRGSEL] - * KINETIS_SIM_SOPT7_ADC0ALTTRGEN - SoC has ADC0 alternate trigger enable - * KINETIS_SIM_SOPT7_ADC1ALTTRGEN - SoC has ADC1 alternate trigger enable - * KINETIS_SIM_SOPT7_ADC2ALTTRGEN - SoC has ADC2 alternate trigger enable - * KINETIS_SIM_SOPT7_ADC3ALTTRGEN - SoC has ADC3 alternate trigger enable + * KINETIS_SIM_SOPT7_ADC0ALTTRGEN - SoC has ADC0 + * alternate trigger enable + * KINETIS_SIM_SOPT7_ADC1ALTTRGEN - SoC has ADC1 + * alternate trigger enable + * KINETIS_SIM_SOPT7_ADC2ALTTRGEN - SoC has ADC2 + * alternate trigger enable + * KINETIS_SIM_SOPT7_ADC3ALTTRGEN - SoC has ADC3 + * alternate trigger enable * KINETIS_SIM_HAS_SOPT8 - SoC has SOPT8 Register * KINETIS_SIM_HAS_SOPT8_FTM0SYNCBIT - SoC has SOPT8[FTM0SYNCBIT] * KINETIS_SIM_HAS_SOPT8_FTM1SYNCBIT - SoC has SOPT8[FTM1SYNCBIT] @@ -260,8 +267,10 @@ * KINETIS_SIM_HAS_FCFG1_FTFDIS - SoC has FCFG1[FTFDIS] * KINETIS_SIM_HAS_FCFG1_NVMSIZE - SoC has FCFG1[NVMSIZE] * KINETIS_SIM_HAS_FCFG2 - SoC has FCFG2 Register - * KINETIS_SIM_HAS_FCFG2_MAXADDR0 - SoC has n bit of FCFG2[MAXADDR0] - * KINETIS_SIM_HAS_FCFG2_MAXADDR1 - SoC has n bit of FCFG2[MAXADDR1] + * KINETIS_SIM_HAS_FCFG2_MAXADDR0 - SoC has n bit of + * FCFG2[MAXADDR0] + * KINETIS_SIM_HAS_FCFG2_MAXADDR1 - SoC has n bit of + * FCFG2[MAXADDR1] * KINETIS_SIM_HAS_FCFG2_PFLSH - SoC has FCFG2[PFLSH] * KINETIS_SIM_HAS_FCFG2_SWAPPFLSH - SoC has FCFG2[SWAPPFLSH] * KINETIS_SIM_HAS_UIDH - SoC has UIDH Register diff --git a/arch/arm/include/kl/chip.h b/arch/arm/include/kl/chip.h index ac9c5f45e65..18a7421d602 100644 --- a/arch/arm/include/kl/chip.h +++ b/arch/arm/include/kl/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kl/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_KL_CHIP_H #define __ARCH_ARM_INCLUDE_KL_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ @@ -153,10 +153,12 @@ # error "Unsupported Kinetis chip" #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0-15. The lower the value, the greater - * the priority of the corresponding interrupt. The processor implements only - * bits[7:6] of each field, bits[5:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0-15. The lower the value, the + * greater the priority of the corresponding interrupt. The processor + * implements only bits[7:6] of each field, bits[5:0] read as zero and ignore + * writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xc0 /* All bits[7:6] set is minimum priority */ @@ -164,15 +166,15 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x40 /* Steps between supported priority values */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_KL_CHIP_H */ diff --git a/arch/arm/include/kl/irq.h b/arch/arm/include/kl/irq.h index 819496605c7..e544e02f46c 100644 --- a/arch/arm/include/kl/irq.h +++ b/arch/arm/include/kl/irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/kl/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,41 +16,43 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_KL_IRQ_H #define __ARCH_ARM_INCLUDE_KL_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ -/* IRQ numbers **********************************************************************/ -/* The IRQ numbers corresponds directly to vector numbers and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + +/* IRQ numbers **************************************************************/ + +/* The IRQ numbers corresponds directly to vector numbers and hence map + * directly to bits in the NVIC. This does, however, waste several words of + * memory in the IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ #define KL_IRQ_RESERVED (0) /* Reserved vector (only used with CONFIG_DEBUG_FEATURES) */ - /* Vector 0: Reset stack pointer value */ - /* Vector 1: Reset (not handler as an IRQ) */ + /* Vector 0: Reset stack pointer value */ + /* Vector 1: Reset (not handler as an IRQ) */ #define KL_IRQ_NMI (2) /* Vector 2: Non-Maskable Interrupt (NMI) */ #define KL_IRQ_HARDFAULT (3) /* Vector 3: Hard fault */ - /* Vectors 4-10: Reserved */ + /* Vectors 4-10: Reserved */ #define KL_IRQ_SVCALL (11) /* Vector 11: SVC call */ - /* Vector 12-13: Reserved */ + /* Vector 12-13: Reserved */ #define KL_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define KL_IRQ_SYSTICK (15) /* Vector 15: System tick */ @@ -58,10 +60,10 @@ #define KL_IRQ_EXTINT (16) -/* K40 Family *********************************************************************** +/* K40 Family *************************************************************** * - * The interrupt vectors for the following parts is defined in Freescale document - * K40P144M100SF2RM + * The interrupt vectors for the following parts is defined in Freescale + * document K40P144M100SF2RM */ #if defined(CONFIG_ARCH_CHIP_MKL25Z128) || defined(CONFIG_ARCH_CHIP_MKL25Z64) @@ -99,12 +101,13 @@ # define KL_IRQ_PORTA (46) /* Vector 46: GPIO Port A */ # define KL_IRQ_PORTD (47) /* Vector 47: GPIO Port D */ -/* Note that the total number of IRQ numbers supported is equal to the number of - * valid interrupt vectors. This is wasteful in that certain tables are sized by - * this value. There are only 94 valid interrupts so, potentially the number of - * IRQs to could be reduced to 94. However, equating IRQ numbers with vector numbers - * also simplifies operations on NVIC registers and (at least in my state of mind - * now) seems to justify the waste. +/* Note that the total number of IRQ numbers supported is equal to the + * number of valid interrupt vectors. This is wasteful in that certain + * tables are sized by this value. There are only 94 valid interrupts so, + * potentially the number of IRQs to could be reduced to 94. However, + * equating IRQ numbers with vector numbers also simplifies operations on + * NVIC registers and (at least in my state of mind now) seems to justify + * the waste. */ # define NR_IRQS (48) /* 64 interrupts but 48 IRQ numbers */ @@ -144,33 +147,34 @@ # define KL_IRQ_PORTA (46) /* Vector 46: GPIO Port A */ # define KL_IRQ_PORTD (47) /* Vector 47: GPIO Port D */ -/* Note that the total number of IRQ numbers supported is equal to the number of - * valid interrupt vectors. This is wasteful in that certain tables are sized by - * this value. There are only 94 valid interrupts so, potentially the number of - * IRQs to could be reduced to 94. However, equating IRQ numbers with vector numbers - * also simplifies operations on NVIC registers and (at least in my state of mind - * now) seems to justify the waste. +/* Note that the total number of IRQ numbers supported is equal to the + * number of valid interrupt vectors. This is wasteful in that certain + * tables are sized by this value. There are only 94 valid interrupts so, + * potentially the number of IRQs to could be reduced to 94. However, + * equating IRQ numbers with vector numbers also simplifies operations on + * NVIC registers and (at least in my state of mind now) seems to justify + * the waste. */ # define NR_IRQS (48) /* 64 interrupts but 48 IRQ numbers */ #else - /* The interrupt vectors for other parts are defined in other documents and may or - * may not be the same as above (the family members are all very similar) This - * error just means that you have to look at the document and determine for yourself - * if the vectors are the same. - */ +/* The interrupt vectors for other parts are defined in other documents and + * may or may not be the same as above (the family members are all very + * similar) This error just means that you have to look at the document and + * determine for yourself if the vectors are the same. + */ # error "No IRQ numbers for this Kinetis L part" #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -181,9 +185,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/lc823450/chip.h b/arch/arm/include/lc823450/chip.h index f8e80500ba1..d6423d8158f 100644 --- a/arch/arm/include/lc823450/chip.h +++ b/arch/arm/include/lc823450/chip.h @@ -28,7 +28,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* NVIC priority levels *****************************************************/ diff --git a/arch/arm/include/lc823450/clk.h b/arch/arm/include/lc823450/clk.h index 2c7ccc58811..5e90a613ee8 100644 --- a/arch/arm/include/lc823450/clk.h +++ b/arch/arm/include/lc823450/clk.h @@ -26,7 +26,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define LC823450_CLOCKS \ diff --git a/arch/arm/include/lc823450/irq.h b/arch/arm/include/lc823450/irq.h index dd5b22e46e9..72d8115aa6d 100644 --- a/arch/arm/include/lc823450/irq.h +++ b/arch/arm/include/lc823450/irq.h @@ -33,7 +33,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Processor Exceptions (vectors 0-15) */ diff --git a/arch/arm/include/limits.h b/arch/arm/include/limits.h index 55ad8c53fcc..64dacedfc87 100644 --- a/arch/arm/include/limits.h +++ b/arch/arm/include/limits.h @@ -26,7 +26,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ #define CHAR_BIT 8 diff --git a/arch/arm/include/lpc17xx_40xx/chip.h b/arch/arm/include/lpc17xx_40xx/chip.h index faa36ac8a34..bece30c9f7e 100644 --- a/arch/arm/include/lpc17xx_40xx/chip.h +++ b/arch/arm/include/lpc17xx_40xx/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/lpc17xx_40xx/chip.h * * Copyright (C) 2010-2011, 2013 Gregory Nutt. All rights reserved. @@ -32,20 +32,20 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_LPC17XX_40XX_CHIP_H #define __ARCH_ARM_INCLUDE_LPC17XX_40XX_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ @@ -217,6 +217,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1773) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (128*1024) /* 128Kb */ # define LPC17_40_SRAM_SIZE (40*1024) /* 40Kb */ # define LPC17_40_CPUSRAM_SIZE (32*1024) @@ -233,6 +234,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1774) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (128*1024) /* 128Kb */ # define LPC17_40_SRAM_SIZE (40*1024) /* 40Kb */ # define LPC17_40_CPUSRAM_SIZE (32*1024) @@ -249,6 +251,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1776) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (256*1024) /* 256Kb */ # define LPC17_40_SRAM_SIZE (80*1024) /* 80Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -265,6 +268,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1777) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (512*1024) /* 512Kb */ # define LPC17_40_SRAM_SIZE (96*1024) /* 96Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -281,6 +285,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1778) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (512*1024) /* 512Kb */ # define LPC17_40_SRAM_SIZE (96*1024) /* 64Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -297,6 +302,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1785) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (256*1024) /* 256Kb */ # define LPC17_40_SRAM_SIZE (80*1024) /* 80Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -313,6 +319,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1786) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (256*1024) /* 256Kb */ # define LPC17_40_SRAM_SIZE (80*1024) /* 80Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -329,6 +336,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1787) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (512*1024) /* 512Kb */ # define LPC17_40_SRAM_SIZE (96*1024) /* 96Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -345,6 +353,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC1788) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (512*1024) /* 512Kb */ # define LPC17_40_SRAM_SIZE (96*1024) /* 96Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -361,6 +370,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC4072) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (64*1024) /* 64Kb */ # define LPC17_40_SRAM_SIZE (24*1024) /* 24Kb */ # define LPC17_40_CPUSRAM_SIZE (16*1024) @@ -377,6 +387,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC4074) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (128*1024) /* 128Kb */ # define LPC17_40_SRAM_SIZE (40*1024) /* 40Kb */ # define LPC17_40_CPUSRAM_SIZE (32*1024) @@ -393,6 +404,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC4076) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (256*1024) /* 256Kb */ # define LPC17_40_SRAM_SIZE (80*1024) /* 80Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -409,6 +421,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC4078) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (512*1024) /* 512Kb */ # define LPC17_40_SRAM_SIZE (96*1024) /* 96Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -425,6 +438,7 @@ #elif defined(CONFIG_ARCH_CHIP_LPC4088) # undef LPC176x /* Not LPC175/6 family */ # define LPC178x_40xx 1 /* LPC177/8 or LPC40xx family */ + # define LPC17_40_FLASH_SIZE (512*1024) /* 512Kb */ # define LPC17_40_SRAM_SIZE (96*1024) /* 64Kb */ # define LPC17_40_CPUSRAM_SIZE (64*1024) @@ -442,10 +456,12 @@ # error "Unsupported LPC17xx/LPC40xx chip" #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0-31. The lower the value, the greater - * the priority of the corresponding interrupt. The processor implements only - * bits[7:3] of each field, bits[2:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0-31. The lower the value, the + * greater the priority of the corresponding interrupt. The processor + * implements only bits[7:3] of each field, bits[2:0] read as zero and ignore + * writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xf8 /* All bits[7:3] set is minimum priority */ @@ -453,16 +469,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x08 /* Five bits of interrupt priority used */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_LPC17XX_40XX_CHIP_H */ diff --git a/arch/arm/include/lpc17xx_40xx/irq.h b/arch/arm/include/lpc17xx_40xx/irq.h index 77de3b82d5f..bb4e60837e7 100644 --- a/arch/arm/include/lpc17xx_40xx/irq.h +++ b/arch/arm/include/lpc17xx_40xx/irq.h @@ -35,8 +35,9 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ + /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. diff --git a/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h b/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h index d5c04f41f76..6da827df2c2 100644 --- a/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h +++ b/arch/arm/include/lpc17xx_40xx/lpc176x_irq.h @@ -18,8 +18,8 @@ * ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly - * through nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_LPC17XX_40XX_LPC176X_IRQ_H @@ -30,8 +30,9 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ + /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. @@ -122,9 +123,9 @@ #define LPC17_40_IRQ_NEXTINT (35) #define LPC17_40_IRQ_NIRQS (LPC17_40_IRQ_EXTINT+LPC17_40_IRQ_NEXTINT) -/* GPIO interrupts. The LPC17xx/LPC40xx supports several interrupts on ports 0 and - * 2 (only). We go through some special efforts to keep the number of IRQs - * to a minimum in this sparse interrupt case. +/* GPIO interrupts. The LPC17xx/LPC40xx supports several interrupts on ports + * 0 and 2 (only). We go through some special efforts to keep the number of + * IRQs to a minimum in this sparse interrupt case. * * 28 interrupts on Port 0: p0.0 - p0.11, p0.15-p0.30 * 14 interrupts on Port 2: p2.0 - p2.13 @@ -136,7 +137,7 @@ # define LPC17_40_VALID_GPIOINT0 (0x7fff8ffful) /* GPIO port 0 interrupt set */ # define LPC17_40_VALID_GPIOINT2 (0x00003ffful) /* GPIO port 2 interrupt set */ - /* Set 1: 12 interrupts p0.0-p0.11 */ +/* Set 1: 12 interrupts p0.0-p0.11 */ # define LPC17_40_VALID_GPIOINT0L (0x00000ffful) # define LPC17_40_VALID_SHIFT0L (0) @@ -156,7 +157,7 @@ # define LPC17_40_IRQ_P0p11 (LPC17_40_VALID_FIRST0L+11) # define LPC17_40_VALID_NIRQS0L (12) - /* Set 2: 16 interrupts p0.15-p0.30 */ +/* Set 2: 16 interrupts p0.15-p0.30 */ # define LPC17_40_VALID_GPIOINT0H (0x7fff8000ull) # define LPC17_40_VALID_SHIFT0H (15) @@ -180,7 +181,7 @@ # define LPC17_40_IRQ_P0p30 (LPC17_40_VALID_FIRST0H+15) # define LPC17_40_VALID_NIRQS0H (16) - /* Set 3: 14 interrupts p2.0-p2.13 */ +/* Set 3: 14 interrupts p2.0-p2.13 */ # define LPC17_40_VALID_GPIOINT2 (0x00003ffful) # define LPC17_40_VALID_SHIFT2 (0) diff --git a/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h b/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h index 4a627a5ed57..4c55268cf26 100644 --- a/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h +++ b/arch/arm/include/lpc17xx_40xx/lpc178x_40xx_irq.h @@ -46,7 +46,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map @@ -156,8 +156,9 @@ #define LPC17_40_IRQ_NEXTINT (41) #define LPC17_40_IRQ_NIRQS (LPC17_40_IRQ_EXTINT+LPC17_40_IRQ_NEXTINT) -/* GPIO interrupts. The LPC177x_8x supports several interrupts on ports 0 and - * 2 (only). We go through some special efforts to keep the number of IRQs +/* GPIO interrupts. + * The LPC177x_8x supports several interrupts on ports 0 and 2 (only). + * We go through some special efforts to keep the number of IRQs * to a minimum in this sparse interrupt case. * * 31 interrupts on Port 0: p0.0 - p0.30 @@ -170,7 +171,7 @@ # define LPC17_40_VALID_GPIOINT0 (0xfffffffful) /* GPIO port 0 interrupt set */ # define LPC17_40_VALID_GPIOINT2 (0xfffffffful) /* GPIO port 2 interrupt set */ - /* Set 1: 16 interrupts p0.0-p0.15 */ +/* Set 1: 16 interrupts p0.0-p0.15 */ # define LPC17_40_VALID_SHIFT0L (0) # define LPC17_40_VALID_FIRST0L (LPC17_40_IRQ_EXTINT+LPC17_40_IRQ_NEXTINT) @@ -193,7 +194,7 @@ # define LPC17_40_IRQ_P0p15 (LPC17_40_VALID_FIRST0L+15) # define LPC17_40_VALID_NIRQS0L (16) - /* Set 2: 16 interrupts p0.16-p0.31 */ +/* Set 2: 16 interrupts p0.16-p0.31 */ # define LPC17_40_VALID_SHIFT0H (16) # define LPC17_40_VALID_FIRST0H (LPC17_40_VALID_FIRST0L+LPC17_40_VALID_NIRQS0L) @@ -216,7 +217,7 @@ # define LPC17_40_IRQ_P0p31 (LPC17_40_VALID_FIRST0H+15) # define LPC17_40_VALID_NIRQS0H (16) - /* Set 3: 16 interrupts p2.0-p2.15 */ +/* Set 3: 16 interrupts p2.0-p2.15 */ # define LPC17_40_VALID_SHIFT2L (0) # define LPC17_40_VALID_FIRST2L (LPC17_40_VALID_FIRST0H+LPC17_40_VALID_NIRQS0H) @@ -239,7 +240,7 @@ # define LPC17_40_IRQ_P2p15 (LPC17_40_VALID_FIRST2L+15) # define LPC17_40_VALID_NIRQS2L (16) - /* Set 4: 16 interrupts p2.16 - p2.31 */ +/* Set 4: 16 interrupts p2.16 - p2.31 */ # define LPC17_40_VALID_SHIFT2H (16) # define LPC17_40_VALID_FIRST2H (LPC17_40_VALID_FIRST2L+LPC17_40_VALID_NIRQS2L) diff --git a/arch/arm/include/lpc214x/irq.h b/arch/arm/include/lpc214x/irq.h index 493b433ec10..b14f82f60e1 100644 --- a/arch/arm/include/lpc214x/irq.h +++ b/arch/arm/include/lpc214x/irq.h @@ -34,7 +34,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* LPC214X Interrupts */ diff --git a/arch/arm/include/lpc2378/irq.h b/arch/arm/include/lpc2378/irq.h index 4b324dae410..05b75ada61b 100644 --- a/arch/arm/include/lpc2378/irq.h +++ b/arch/arm/include/lpc2378/irq.h @@ -55,7 +55,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* LPC2378 Interrupts */ @@ -94,12 +94,12 @@ #define I2C2_IRQ 30 /* I2C 2 */ #define I2S_IRQ 31 /* I2S */ - #define IRQ_SYSTIMER TIMER0_IRQ #define NR_IRQS 32 -/* There are 32 vectored interrupts. If vectored interrupts are enabled, the +/* There are 32 vectored interrupts. + * If vectored interrupts are enabled, the * following will be used by the system. */ #define SYSTIMER_VEC 0 /* System timer */ diff --git a/arch/arm/include/lpc31xx/irq.h b/arch/arm/include/lpc31xx/irq.h index 4ac8b1a972a..482bc2836e3 100644 --- a/arch/arm/include/lpc31xx/irq.h +++ b/arch/arm/include/lpc31xx/irq.h @@ -30,7 +30,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* LPC31XX Interrupts */ diff --git a/arch/arm/include/lpc43xx/chip.h b/arch/arm/include/lpc43xx/chip.h index b923a9d6445..a5a9ce34a4f 100644 --- a/arch/arm/include/lpc43xx/chip.h +++ b/arch/arm/include/lpc43xx/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/lpc43xx/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_LPC43XX_CHIP_H #define __ARCH_ARM_INCLUDE_LPC43XX_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Per the data sheet: LPC4350/30/20/10 Rev. 3.2 — 4 June 2012 */ @@ -65,33 +65,41 @@ /* Get customizations for each supported chip. * * SRAM Resources - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * Local SRAM LPC4310 LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337 - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * BANK 0 (0x1000 0000) 96Kb 96Kb 128Kb 128Kb 32Kb 32Kb 32Kb - * BANK 1 (0x1008 0000) 40Kb 40Kb 72Kb 72Kb 40Kb 40Kb 40Kb - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * SUBTOTAL 136Kb 136Kb 200Kb 200Kb 72Kb 72Kb 72Kb - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * AHB SRAM LPC4310 LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337 - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * BANK 0 (0x2000 0000) 16Kb 48Kb 48Kb 48Kb 48Kb 48Kb 48Kb - * BANK 1 (0x2000 8000) NOTE 1 NOTE 1 NOTE 1 NOTE 1 NOTE 1 NOTE 1 - * BANK 2 (0x2000 c000) 16Kb 16Kb 16Kb 16Kb 16Kb 16Kb 16Kb - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * SUBTOTAL 32Kb 64Kb 64Kb 64Kb 64Kb 64Kb 64Kb - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * TOTAL 168Kb 200Kb 264Kb 264Kb 136Kb 136Kb 136Kb - * --------------------- -------- ------- ------- ------- ------- ------- ------- + * --------------- -------- ------- ------- ------- ------- ------- ------- + * Local SRAM LPC4310 LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337 + * --------------- -------- ------- ------- ------- ------- ------- ------- + * BANK 0 96Kb 96Kb 128Kb 128Kb 32Kb 32Kb 32Kb + * (0x1000 0000) + * BANK 1 40Kb 40Kb 72Kb 72Kb 40Kb 40Kb 40Kb + * (0x1008 0000) + * -------------- -------- ------- ------- ------- ------- ------- ------- + * SUBTOTAL 136Kb 136Kb 200Kb 200Kb 72Kb 72Kb 72Kb + * -------------- -------- ------- ------- ------- ------- ------- ------- + * AHB SRAM LPC4310 LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337 + * -------------- -------- ------- ------- ------- ------- ------- ------- + * BANK 0 16Kb 48Kb 48Kb 48Kb 48Kb 48Kb 48Kb + * (0x2000 0000) + * BANK 1 NOTE 1 NOTE 1 NOTE 1 NOTE 1 NOTE 1 NOTE 1 + * (0x2000 8000) + * BANK 2 16Kb 16Kb 16Kb 16Kb 16Kb 16Kb 16Kb + * (0x2000 c000) + * -------------- -------- ------- ------- ------- ------- ------- ------- + * SUBTOTAL 32Kb 64Kb 64Kb 64Kb 64Kb 64Kb 64Kb + * -------------- -------- ------- ------- ------- ------- ------- ------- + * TOTAL 168Kb 200Kb 264Kb 264Kb 136Kb 136Kb 136Kb + * -------------- -------- ------- ------- ------- ------- ------- ------- * - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * FLASH LPC4310 LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337 - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * BANK A (0x1a00 0000) 256Kb 512Kb 512Kb - * BANK B (0x1b00 8000) 256Kb 512Kb 512Kb - * --------------------- -------- ------- ------- ------- ------- ------- ------- - * TOTAL None None None None 512Kb 1024Kb 1024Kb - * --------------------- -------- ------- ------- ------- ------- ------- ------- + * -------------- -------- ------- ------- ------- ------- ------- ------- + * FLASH LPC4310 LPC4320 LPC4330 LPC4350 LPC4353 LPC4357 LPC4337 + * -------------- -------- ------- ------- ------- ------- ------- ------- + * BANK A 256Kb 512Kb 512Kb + * (0x1a00 0000) + * BANK B 256Kb 512Kb 512Kb + * (0x1b00 8000) + * -------------- -------- ------- ------- ------- ------- ------- ------- + * TOTAL None None None None 512Kb 1024Kb 1024Kb + * -------------- -------- ------- ------- ------- ------- ------- ------- + * * NOTE 1: The 64Kb of AHB of SRAM on the LPC4350/30/20 span all AHB SRAM * banks but are treated as two banks of 48 an 16Kb by the NuttX memory @@ -674,10 +682,10 @@ # error "Unsupported LPC43xx chip" #endif -/* NVIC priority levels *************************************************************/ +/* NVIC priority levels *****************************************************/ -/* Each priority field holds a priority value, 0-31. The lower the value, the greater - * the priority of the corresponding interrupt. +/* Each priority field holds a priority value, 0-31. The lower the value, the + * greater the priority of the corresponding interrupt. * * The Cortex-M4 core supports up to 53 interrupts an 8 prgrammable interrupt * priority levels; The Cortex-M0 core supports up to 32 interrupts with 4 diff --git a/arch/arm/include/lpc43xx/irq.h b/arch/arm/include/lpc43xx/irq.h index dd3f3e12e40..46e4b69406c 100644 --- a/arch/arm/include/lpc43xx/irq.h +++ b/arch/arm/include/lpc43xx/irq.h @@ -1,4 +1,4 @@ -/******************************************************************************************** +/**************************************************************************** * arch/arm/include/lpc43xx/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ********************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, * only indirectly through nuttx/irq.h @@ -25,21 +25,22 @@ #ifndef __ARCH_ARM_INCLUDE_LPC43XX_IRQ_H #define __ARCH_ARM_INCLUDE_LPC43XX_IRQ_H -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ # include #endif -/******************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to bits in - * the NVIC. This does, however, waste several words of memory in the IRQ to handle mapping - * tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to bits in + * the NVIC. This does, however, waste several words of memory in the IRQ to + * handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -114,8 +115,8 @@ #define LPC43M4_IRQ_NEXTINT (53) #define LPC43M4_IRQ_NIRQS (LPC43_IRQ_EXTINT+LPC43M4_IRQ_NEXTINT) -/* Total number of IRQ numbers (This will need to be revisited if/when the Cortex-M0 is - * supported) +/* Total number of IRQ numbers (This will need to be revisited + * if/when the Cortex-M0 is supported) */ #define NR_IRQS LPC43M4_IRQ_NIRQS @@ -163,33 +164,33 @@ #define LPC43M0_IRQ_NEXTINT (30) #define LPC43M0_IRQ_NIRQS (LPC43_IRQ_EXTINT+LPC43M0_IRQ_NEXTINT) -/* Total number of IRQ numbers (This will need to be revisited if/when the Cortex-M0 is - * supported) +/* Total number of IRQ numbers + * (This will need to be revisited if/when the Cortex-M0 is supported) */ #if 0 #define NR_IRQS LPC43M0_IRQ_NIRQS #endif -/******************************************************************************************** +/**************************************************************************** * Public Types - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ typedef void (*vic_vector_t)(uint32_t *regs); #endif -/******************************************************************************************** +/**************************************************************************** * Inline functions - ********************************************************************************************/ + ****************************************************************************/ -/******************************************************************************************** +/**************************************************************************** * Public Data - ********************************************************************************************/ + ****************************************************************************/ -/******************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/lpc54xx/chip.h b/arch/arm/include/lpc54xx/chip.h index 2b4546b74ba..87c6f7693e1 100644 --- a/arch/arm/include/lpc54xx/chip.h +++ b/arch/arm/include/lpc54xx/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/lpc54xx/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,37 +16,40 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_LPC54XX_CHIP_H #define __ARCH_ARM_INCLUDE_LPC54XX_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - *********************************************************************************** +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + /* LPC546xx Family Options. * * Family CPU Flash SRAM FS HS Ether- CAN CAN LCD Package * MHz (Kb) (Kb) USB USB net 2.0 FD * LPC54628 220 512 200 X X X X X X BGA180 * LPC54618 180 <=512 <=200 X X X X X X BGA180, LQFP208 - * LPC54616 180 <=512 <=200 X X X X X BGA100, BGA180, LQFP100, LQFP208 + * LPC54616 180 <=512 <=200 X X X X X BGA100, BGA180, + * LQFP100, LQFP208 * LPC54608 180 512 200 X X X X X BGA180, LQFP208 * LPC54607 180 <=512 <=200 X X X BGA180, LQFP208 - * LPC54606 180 <=512 <=200 X X X X BGA100, BGA180, LQFP100, LQFP208 + * LPC54606 180 <=512 <=200 X X X X BGA100, BGA180, + * LQFP100, LQFP208 * LPC54605 180 <=512 <=200 X X BGA180 */ -/* NVIC priority levels *************************************************************/ +/* NVIC priority levels *****************************************************/ -/* Each priority field holds a priority value, 0-31. The lower the value, the greater - * the priority of the corresponding interrupt. +/* Each priority field holds a priority value, 0-31. The lower the value, the + * greater the priority of the corresponding interrupt. * * The Cortex-M4 core supports 8 programmable interrupt priority levels. */ @@ -56,16 +59,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x20 /* Steps between priorities */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_LPC43XX_CHIP_H */ diff --git a/arch/arm/include/lpc54xx/irq.h b/arch/arm/include/lpc54xx/irq.h index 43399836066..fbf566fc061 100644 --- a/arch/arm/include/lpc54xx/irq.h +++ b/arch/arm/include/lpc54xx/irq.h @@ -1,4 +1,4 @@ -/******************************************************************************************** +/**************************************************************************** * arch/arm/include/lpc54xx/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ********************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, * only indirectly through nuttx/irq.h @@ -25,21 +25,22 @@ #ifndef __ARCH_ARM_INCLUDE_LPC54XX_IRQ_H #define __ARCH_ARM_INCLUDE_LPC54XX_IRQ_H -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ # include #endif -/******************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to bits in - * the NVIC. This does, however, waste several words of memory in the IRQ to handle mapping - * tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to bits in + * the NVIC. This does, however, waste several words of memory in the IRQ to + * handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -68,16 +69,16 @@ # error "Unsupported LPC54 MCU" #endif -/******************************************************************************************** +/**************************************************************************** * Public Types - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ typedef void (*vic_vector_t)(uint32_t *regs); -/******************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ********************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" diff --git a/arch/arm/include/lpc54xx/lpc546x_irq.h b/arch/arm/include/lpc54xx/lpc546x_irq.h index e7a7a2da584..2cd6f32bd5c 100644 --- a/arch/arm/include/lpc54xx/lpc546x_irq.h +++ b/arch/arm/include/lpc54xx/lpc546x_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/lpc54xx/lpc546x_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,18 +16,18 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_LPC54XX_LPC543X_IRQ_H #define __ARCH_ARM_INCLUDE_LPC54XX_LPC543X_IRQ_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Cortex-M4 External interrupts (vectors >= 16) */ diff --git a/arch/arm/include/max326xx/chip.h b/arch/arm/include/max326xx/chip.h index c270e78ff8f..9a3a13d46ac 100644 --- a/arch/arm/include/max326xx/chip.h +++ b/arch/arm/include/max326xx/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/max326xx/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,27 +16,27 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_MAX326XX_CHIP_H #define __ARCH_ARM_INCLUDE_MAX326XX_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Get customizations for each supported MAX326xx family. Only sizes and numbers of - * things are provided here. See arch/arm/src/max326xx/Kconfig for other, boolean - * configuration settings. +/* Get customizations for each supported MAX326xx family. Only sizes and + * numbers of things are provided here. See arch/arm/src/max326xx/Kconfig + * for other, boolean configuration settings. * - * MAX326xx Families are determined by sharing a common User Guide for the chip - * specification: + * MAX326xx Families are determined by sharing a common User Guide for the + * chip specification: * * MAX32620/32621 Family: MAX32620 Rev C, User Guide, AN6242, Rev 2, 2/17 * MAX32630/32632 Family: MAX32630 Rev B, User Guide, AN6349, Rev 0, 10/16 @@ -174,10 +174,12 @@ # error Unrecognized MAX326XX chip #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0x00-0xe0. The lower the value, the - * greater the priority of the corresponding interrupt. The processor implements only - * bits[7:4] of each field, bits[6:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0x00-0xe0. The lower the + * value, the greater the priority of the corresponding interrupt. The + * processor implements only bits[7:4] of each field, bits[6:0] read as zero + * and ignore writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xe0 /* All bits[7:5] set is minimum priority */ @@ -185,16 +187,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x20 /* Eight priority levels in steps 0x20 */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_MAX326XX_CHIP_H */ diff --git a/arch/arm/include/max326xx/irq.h b/arch/arm/include/max326xx/irq.h index db08258cd40..91b7e28f4ad 100644 --- a/arch/arm/include/max326xx/irq.h +++ b/arch/arm/include/max326xx/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/max326xx/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_MAX326_IRQ_H #define __ARCH_ARM_INCLUDE_MAX326_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Common Processor Exceptions (vectors 0-15) */ @@ -70,15 +71,15 @@ # error "Unsupported MAX326XX family" #endif -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -88,9 +89,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/max326xx/max32620_30_irq.h b/arch/arm/include/max326xx/max32620_30_irq.h index 27fdddda2d6..4dd04bf9f2a 100644 --- a/arch/arm/include/max326xx/max32620_30_irq.h +++ b/arch/arm/include/max326xx/max32620_30_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************************ +/**************************************************************************** * arch/arm/include/max326xx/max32620_30_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_MAX326XX_MAX32610_30_IRQ_H #define __ARCH_ARM_INCLUDE_MAX326XX_MAX32610_30_IRQ_H -/************************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ - * Pre-processor Definitions - ************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts (vectors >= 16) */ @@ -92,7 +92,9 @@ #define MAX326_IRQ_NVECTORS (MAX326_IRQ_EXTINT + MAX326_IRQ_NEXTINT) -/* If GPIO pin interrupts are used then there is a second level of interrupt decode */ +/* If GPIO pin interrupts are used then there is a second level of interrupt + * decode + */ #ifdef CONFIG_MAX326XX_GPIOIRQ #warning Missing logic @@ -104,21 +106,21 @@ #define NR_IRQS (MAX326_IRQ_NVECTORS + MAX326_IRQ_NPININT) -/************************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Inline functions - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/max326xx/max32660_irq.h b/arch/arm/include/max326xx/max32660_irq.h index 9288fdfb8e6..03493b62612 100644 --- a/arch/arm/include/max326xx/max32660_irq.h +++ b/arch/arm/include/max326xx/max32660_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************************ +/**************************************************************************** * arch/arm/include/max326xx/max32660_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_MAX326XX_MAX32660_IRQ_H #define __ARCH_ARM_INCLUDE_MAX326XX_MAX32660_IRQ_H -/************************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ - * Pre-processor Definitions - ************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts (vectors >= 16) */ @@ -67,10 +67,14 @@ #define MAX326_IRQ_NEXTINT 55 #define MAX326_IRQ_NVECTORS (MAX326_IRQ_EXTINT + MAX326_IRQ_NEXTINT) -/* If GPIO pin interrupts are used then there is a second level of interrupt decode */ +/* If GPIO pin interrupts are used then there is a second level of + * interrupt decode + */ #ifdef CONFIG_MAX326XX_GPIOIRQ -/* Up to 14 pins are available as interrupt sources, depending on the MAX32660 package */ +/* Up to 14 pins are available as interrupt sources, + * depending on the MAX32660 package + */ # define MAX326_IRQ_P0_0 (MAX326_IRQ_NEXTINT + 0) # define MAX326_IRQ_P0_1 (MAX326_IRQ_NEXTINT + 1) @@ -98,21 +102,21 @@ #define NR_IRQS (MAX326_IRQ_NVECTORS + MAX326_IRQ_NPININT) -/************************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Inline functions - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/moxart/irq.h b/arch/arm/include/moxart/irq.h index 4796641d576..31d289c8bd4 100644 --- a/arch/arm/include/moxart/irq.h +++ b/arch/arm/include/moxart/irq.h @@ -30,7 +30,7 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /**************************************************************************** diff --git a/arch/arm/include/nrf52/chip.h b/arch/arm/include/nrf52/chip.h index d0f055f39bd..a02df826443 100644 --- a/arch/arm/include/nrf52/chip.h +++ b/arch/arm/include/nrf52/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/nrf52/chip.h * * Copyright (C) 2018 Gregory Nutt. All rights reserved. @@ -31,25 +31,25 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_NRF52_CHIP_H #define __ARCH_ARM_INCLUDE_NRF52_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - *********************************************************************************** +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* NVIC priority levels *************************************************************/ +/* NVIC priority levels *****************************************************/ -/* Each priority field holds a priority value, 0-31. The lower the value, the greater - * the priority of the corresponding interrupt. +/* Each priority field holds a priority value, 0-31. The lower the value, + * the greater the priority of the corresponding interrupt. * * The Cortex-M4 core supports 8 programmable interrupt priority levels. */ @@ -59,16 +59,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x20 /* Steps between priorities */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_NRF52_CHIP_H */ diff --git a/arch/arm/include/nrf52/irq.h b/arch/arm/include/nrf52/irq.h index 31c0dc4cd8c..7cce4dd0af3 100644 --- a/arch/arm/include/nrf52/irq.h +++ b/arch/arm/include/nrf52/irq.h @@ -1,4 +1,4 @@ -/******************************************************************************************** +/**************************************************************************** * arch/arm/include/nrf52/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ********************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, * only indirectly through nuttx/irq.h @@ -25,21 +25,22 @@ #ifndef __ARCH_ARM_INCLUDE_NRF52_IRQ_H #define __ARCH_ARM_INCLUDE_NRF52_IRQ_H -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ # include #endif -/******************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to bits in - * the NVIC. This does, however, waste several words of memory in the IRQ to handle mapping - * tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to bits in + * the NVIC. This does, however, waste several words of memory in the IRQ to + * handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -62,9 +63,9 @@ /* Cortex-M4 External interrupts (vectors >= 16) */ -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #if defined(CONFIG_ARCH_FAMILY_NRF52) # include @@ -72,16 +73,16 @@ # error "Unsupported NRF52XX MCU" #endif -/******************************************************************************************** +/**************************************************************************** * Public Types - ********************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ typedef void (*vic_vector_t)(uint32_t *regs); -/******************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ********************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" diff --git a/arch/arm/include/nrf52/nrf52_irq.h b/arch/arm/include/nrf52/nrf52_irq.h index b337fa5442e..5e723aef739 100644 --- a/arch/arm/include/nrf52/nrf52_irq.h +++ b/arch/arm/include/nrf52/nrf52_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/nrf52/nrf52_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,18 +16,18 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_NRF52_NRF52_IRQ_H #define __ARCH_ARM_INCLUDE_NRF52_NRF52_IRQ_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Cortex-M4 External interrupts (vectors >= 16) */ diff --git a/arch/arm/include/nuc1xx/chip.h b/arch/arm/include/nuc1xx/chip.h index b054e74bcbc..258e841f1d0 100644 --- a/arch/arm/include/nuc1xx/chip.h +++ b/arch/arm/include/nuc1xx/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/nuc1xx/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,23 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ - + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_NUC1XX_CHIP_H #define __ARCH_ARM_INCLUDE_NUC1XX_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ -/* Chip capabilities ****************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + +/* Chip capabilities ********************************************************/ + /* NUC100 Advanced Line (Low Density) */ #if defined(CONFIG_ARCH_CHIP_NUC100LC1BN) /* Flash 32K SRAM 4K, LQFP48 package */ @@ -620,10 +621,12 @@ # error "Unrecognized NUC1XX chip" #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0-3. The lower the value, the greater - * the priority of the corresponding interrupt. The processor implements only - * bits[7:6] of each field, bits[5:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0-3. The lower the value, the + * greater the priority of the corresponding interrupt. The processor + * implements only bits[7:6] of each field, bits[5:0] read as zero and + * ignore writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xc0 /* All bits[7:6] set is minimum priority */ @@ -631,13 +634,13 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x40 /* Five bits of interrupt priority used */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -648,9 +651,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/nuc1xx/irq.h b/arch/arm/include/nuc1xx/irq.h index 963e532489c..54e1d039ca4 100644 --- a/arch/arm/include/nuc1xx/irq.h +++ b/arch/arm/include/nuc1xx/irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/nuc1xx/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_NUC1XX_IRQ_H #define __ARCH_ARM_INCLUDE_NUC1XX_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -54,7 +55,9 @@ #define NUC_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define NUC_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define NUC_IRQ_INTERRUPT (16) @@ -64,13 +67,13 @@ # error "Unrecognized/unsupported NUC chip" #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -81,9 +84,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/nuc1xx/nuc120_irq.h b/arch/arm/include/nuc1xx/nuc120_irq.h index a6e54448ba8..ddcb5d0c8d8 100644 --- a/arch/arm/include/nuc1xx/nuc120_irq.h +++ b/arch/arm/include/nuc1xx/nuc120_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/nuc1xx/nuc120_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_NUC1XX_NUC120_IRQ_H #define __ARCH_ARM_INCLUDE_NUC1XX_NUC120_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* NUC120 IRQ numbers */ @@ -70,13 +70,13 @@ #define NR_IRQS (48) -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -87,9 +87,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/rp2040/irq.h b/arch/arm/include/rp2040/irq.h index 37600f14a94..a8b776f8c6b 100644 --- a/arch/arm/include/rp2040/irq.h +++ b/arch/arm/include/rp2040/irq.h @@ -34,7 +34,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/s32k1xx/chip.h b/arch/arm/include/s32k1xx/chip.h index c21009d83ee..1af309de5c4 100644 --- a/arch/arm/include/s32k1xx/chip.h +++ b/arch/arm/include/s32k1xx/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/s32k1xx/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,25 +16,25 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_S32K1XX_CHIP_H #define __ARCH_ARM_INCLUDE_S32K1XX_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* NVIC priority levels *************************************************************/ +/* NVIC priority levels *****************************************************/ -/* Each priority field holds a priority value. The lower the value, the greater the - * priority of the corresponding interrupt. +/* Each priority field holds a priority value. The lower the value, the + * greater the priority of the corresponding interrupt. */ #if defined(CONFIG_ARCH_CORTEXM4) @@ -55,16 +55,16 @@ #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_S32K1XX_CHIP_H */ diff --git a/arch/arm/include/s32k1xx/s32k11x_irq.h b/arch/arm/include/s32k1xx/s32k11x_irq.h index d5cfc643dba..f6ed467d7e1 100644 --- a/arch/arm/include/s32k1xx/s32k11x_irq.h +++ b/arch/arm/include/s32k1xx/s32k11x_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/s32k1xx/s32k11x_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,28 +16,29 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_S32K1XX_S32K11XX_IRQ_H #define __ARCH_ARM_INCLUDE_S32K1XX_S32K11XX_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -53,7 +54,9 @@ #define S32K1XX_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define S32K1XX_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define S32K1XX_IRQ_INTERRUPT (16) diff --git a/arch/arm/include/s32k1xx/s32k14x_irq.h b/arch/arm/include/s32k1xx/s32k14x_irq.h index bd7fe3ceb9e..bbc8f9a566f 100644 --- a/arch/arm/include/s32k1xx/s32k14x_irq.h +++ b/arch/arm/include/s32k1xx/s32k14x_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/s32k1xx/s32k14x_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,28 +16,29 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_S32K1XX_S32K14XX_IRQ_H #define __ARCH_ARM_INCLUDE_S32K1XX_S32K14XX_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -56,7 +57,9 @@ #define S32K1XX_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define S32K1XX_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define S32K1XX_IRQ_INTERRUPT (16) /* Vector number of the first external interrupt */ diff --git a/arch/arm/include/sam34/chip.h b/arch/arm/include/sam34/chip.h index 8586f88adbf..5fb4af6c165 100644 --- a/arch/arm/include/sam34/chip.h +++ b/arch/arm/include/sam34/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/sam34/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,24 +16,25 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_SAM34_CHIP_H #define __ARCH_ARM_INCLUDE_SAM34_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ -/* AT91SAM3U Family *****************************************************************/ +/* AT91SAM3U Family *********************************************************/ + /* FEATURE SAM3U4E SAM3U2E SAM3U1E SAM3U4C SAM3U2C SAM3U1C * ----------- -------- -------- -------- -------- -------- -------- * Flash 2x128KB 128KB 64KB 2x128KB 128KB 64KB @@ -189,7 +190,8 @@ # define SAM34_NUDPFS 0 /* No USB full speed device */ # define SAM34_NUHPFS 0 /* No USB full speed embedded host */ -/* AT91SAM3X/3A Families ************************************************************/ +/* AT91SAM3X/3A Families ****************************************************/ + /* FEATURE SAM3X8E SAM3X8C SAM3X4E SAM3X4C SAM3A8C SAM3A4C * ------------ -------- -------- -------- -------- -------- -------- * Flash 2x256KB 2x256KB 2x128KB 2x128KB 2x256KB 2x128KB @@ -340,7 +342,8 @@ # define SAM34_NUDPFS 0 /* No USB full speed device */ # define SAM34_NUHPFS 0 /* No USB full speed embedded host */ -/* AT91SAM4C Family *****************************************************************/ +/* AT91SAM4C Family *********************************************************/ + /* FEATURE SAM4CMP16B * ----------- --------- * Flash 1024KB @@ -389,7 +392,8 @@ # define SAM32_NUDPFS 0 /* No USB full speed device */ # define SAM32_NUHPFS 0 /* No USB full speed embedded host */ -/* AT91SAM4L Family *****************************************************************/ +/* AT91SAM4L Family *********************************************************/ + /* Sub-family differences: * * FEATURE ATSAM4LCxx ATSAM4LSxx @@ -526,23 +530,39 @@ # define SAM34_NUDPFS 1 /* 1 USB full speed device */ # define SAM34_NUHPFS 0 /* No USB full speed embedded host */ -/* AT91SAM4S Family *****************************************************************/ -/* - * FEATURE SAM4SD32C SAM4SD32B SAM4SD16C SAM4SD16B SAM4SA16C SAM4SA16B SAM4S16C SAM4S16B SAM4S8C SAM4S8B SAM4S4C - * ------------- --------- --------- --------- --------- --------- --------- -------- -------- ------- ------- ------- - * Flash 2x1MB 2x1MB 2x512KB 1x1MB 1x1MB 1x1MB 1x1MB 1x1MB 1x512KB 1x512KB 1x256KB - * SRAM 160KB 160KB 160KB 160KB 160KB 160KB 128KB 128KB 128KB 128KB 64KB - * HCACHE 2KB 2KB 2KB 2KB 2KB 2KB - - - - - - * Pins 100 64 100 64 100 64 100 64 100 64 100 - * No. PIOs 79 47 79 47 79 47 79 47 79 47 79 - * Ext. BUS Yes No Yes No Yes No Yes No Yes No Yes - * 12-bit ADC 16 ch 11 ch 16 ch 11 ch 16 ch 11 ch 16 ch 11 ch 16 ch 11 ch 16 ch - * 12-bit DAC 2 ch 2 ch 2 ch 2 ch 2 ch 2 ch 2 ch 2 ch 2 ch 2 ch 2 ch - * Timer Counter 6 ch 3 ch 6 ch 3 ch 6 ch 3 ch 6 ch 3 ch 6 ch 3 ch 6 ch - * PDC 22 ch 22 ch 22 ch 22 ch 22 ch 22 ch 22 ch 22 ch 22 ch 22 ch 22 ch - * USART 2 2 2 2 2 2 2 2 2 2 2 - * UART 2 2 2 2 2 2 2 2 2 2 2 - * HSMCI Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes +/* AT91SAM4S Family *********************************************************/ + +/* FEATURE SAM4SD32C SAM4SD32B SAM4SD16C SAM4SD16B SAM4SA16C SAM4SA16B + * ------------- --------- --------- --------- --------- --------- --------- + * Flash 2x1MB 2x1MB 2x512KB 1x1MB 1x1MB 1x1MB + * SRAM 160KB 160KB 160KB 160KB 160KB 160KB + * HCACHE 2KB 2KB 2KB 2KB 2KB 2KB + * Pins 100 64 100 64 100 64 + * No. PIOs 79 47 79 47 79 47 + * Ext. BUS Yes No Yes No Yes No + * 12-bit ADC 16 ch 11 ch 16 ch 11 ch 16 ch 11 ch + * 12-bit DAC 2 ch 2 ch 2 ch 2 ch 2 ch 2 ch + * Timer Counter 6 ch 3 ch 6 ch 3 ch 6 ch 3 ch + * PDC 22 ch 22 ch 22 ch 22 ch 22 ch 22 ch + * USART 2 2 2 2 2 2 + * UART 2 2 2 2 2 2 + * HSMCI Yes Yes Yes Yes Yes Yes + * + * FEATURE SAM4S16C SAM4S16B SAM4S8C SAM4S8B SAM4S4C + * ------------- -------- -------- ------- ------- ------- + * Flash 1x1MB 1x1MB 1x512KB 1x512KB 1x256KB + * SRAM 128KB 128KB 128KB 128KB 64KB + * HCACHE - - - - - + * Pins 100 64 100 64 100 + * No. PIOs 79 47 79 47 79 + * Ext. BUS Yes No Yes No Yes + * 12-bit ADC 16 ch 11 ch 16 ch 11 ch 16 ch + * 12-bit DAC 2 ch 2 ch 2 ch 2 ch 2 ch + * Timer Counter 6 ch 3 ch 6 ch 3 ch 6 ch + * PDC 22 ch 22 ch 22 ch 22 ch 22 ch + * USART 2 2 2 2 2 + * UART 2 2 2 2 2 + * HSMCI Yes Yes Yes Yes Yes */ #elif defined(CONFIG_ARCH_CHIP_ATSAM4SD32C) @@ -765,7 +785,8 @@ # define SAM34_NUDPFS 1 /* 1 USB full speed device */ # define SAM34_NUHPFS 0 /* No USB full speed embedded host */ -/* AT91SAM4E Family *****************************************************************/ +/* AT91SAM4E Family *********************************************************/ + /* FEATURE SAM4E16E SAM4E8E SAM4E16C SAM4E8C * ----------- --------- -------- -------- -------- * Flash 1024KB 512KB 1024KB 512KB @@ -879,10 +900,12 @@ # error "Unknown SAM3/4 chip type" #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0-15. The lower the value, the greater - * the priority of the corresponding interrupt. The processor implements only - * bits[7:4] of each field, bits[3:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0-15. The lower the value, the + * greater the priority of the corresponding interrupt. The processor + * implements only bits[7:4] of each field, bits[3:0] read as zero and ignore + * writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xf0 /* All bits[7:4] set is minimum priority */ @@ -890,16 +913,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x10 /* Four bits of interrupt priority used */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_SAM34_CHIP_H */ diff --git a/arch/arm/include/sam34/irq.h b/arch/arm/include/sam34/irq.h index 10ff9c07cea..da33129a827 100644 --- a/arch/arm/include/sam34/irq.h +++ b/arch/arm/include/sam34/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sam34/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAM34_IRQ_H #define __ARCH_ARM_INCLUDE_SAM34_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Common Processor Exceptions (vectors 0-15) */ @@ -77,15 +78,15 @@ # error Unrecognized SAM architecture #endif -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -95,9 +96,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/sam34/sam3u_irq.h b/arch/arm/include/sam34/sam3u_irq.h index 8a6577365a9..9e537f96321 100644 --- a/arch/arm/include/sam34/sam3u_irq.h +++ b/arch/arm/include/sam34/sam3u_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sam34/sam3u_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM3U_IRQ_H #define __ARCH_ARM_INCLUDE_SAM34_SAM3U_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAM3U Peripheral Identifiers */ @@ -226,21 +226,21 @@ #define NR_IRQS (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/sam34/sam3x_irq.h b/arch/arm/include/sam34/sam3x_irq.h index cc94a8656ad..18b290715fb 100644 --- a/arch/arm/include/sam34/sam3x_irq.h +++ b/arch/arm/include/sam34/sam3x_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sam34/sam3x_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM3X_IRQ_H #define __ARCH_ARM_INCLUDE_SAM34_SAM3X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAM3X Peripheral Identifiers */ @@ -381,21 +381,21 @@ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \ SAM_NGPIODIRQS + SAM_NGPIOEIRQS + SAM_NGPIOFIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/sam34/sam4cm_irq.h b/arch/arm/include/sam34/sam4cm_irq.h index 9dda0f1e40b..959ef7d8b78 100644 --- a/arch/arm/include/sam34/sam4cm_irq.h +++ b/arch/arm/include/sam34/sam4cm_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sam34/sam4cm_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4CM_IRQ_H #define __ARCH_ARM_INCLUDE_SAM34_SAM4CM_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAM4CM Peripheral Identifiers */ @@ -255,17 +255,17 @@ #define NR_IRQS (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -276,9 +276,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/sam34/sam4e_irq.h b/arch/arm/include/sam34/sam4e_irq.h index 6dad711bf50..fda375c47ad 100644 --- a/arch/arm/include/sam34/sam4e_irq.h +++ b/arch/arm/include/sam34/sam4e_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sam34/sam4e_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4E_IRQ_H #define __ARCH_ARM_INCLUDE_SAM34_SAM4E_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAM4E Peripheral Identifiers */ @@ -81,7 +81,7 @@ /* 46: Reserved */ #define NR_PIDS (47) /* Number of peripheral identifiers */ -/* External interrupts (priority levels >= 256*/ +/* External interrupts (priority levels >= 256 */ #define SAM_IRQ_SUPC (SAM_IRQ_EXTINT+SAM_PID_SUPC) /* Supply Controller */ #define SAM_IRQ_RSTC (SAM_IRQ_EXTINT+SAM_PID_RSTC) /* Reset Controller */ @@ -289,21 +289,21 @@ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \ SAM_NGPIODIRQS + SAM_NGPIOEIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/sam34/sam4l_irq.h b/arch/arm/include/sam34/sam4l_irq.h index 812723149a8..c4390f1cafd 100644 --- a/arch/arm/include/sam34/sam4l_irq.h +++ b/arch/arm/include/sam34/sam4l_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sam34/sam4l_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,26 +16,28 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4L_IRQ_H #define __ARCH_ARM_INCLUDE_SAM34_SAM4L_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* SAM4L Peripheral Identifiers. NOTE: Interrupts are not tied to the DMA peripheral - * identifiers in the SAM4L as they were with the SAM3U. However, for consistency, those - * peripheral identifiers are defined in this file as well. +/* SAM4L Peripheral Identifiers. + * NOTE: + * Interrupts are not tied to the DMA peripheral identifiers in the SAM4L as + * they were with the SAM3U. However, for consistency, those peripheral + * identifiers are defined in this file as well. */ #define SAM_PID_USART0_RHR (0) /* DIR=RX REGISTER: USART0 RHR */ @@ -287,21 +289,21 @@ #define NR_IRQS (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/sam34/sam4s_irq.h b/arch/arm/include/sam34/sam4s_irq.h index e8b9d60a1bb..5ed484fc7cd 100644 --- a/arch/arm/include/sam34/sam4s_irq.h +++ b/arch/arm/include/sam34/sam4s_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sam34/sam4s_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAM34_SAM4S_IRQ_H #define __ARCH_ARM_INCLUDE_SAM34_SAM4S_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAM4S Peripheral Identifiers */ @@ -237,21 +237,21 @@ #define NR_IRQS (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT + \ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/sama5/chip.h b/arch/arm/include/sama5/chip.h index 136a1b35c59..68b377042f8 100644 --- a/arch/arm/include/sama5/chip.h +++ b/arch/arm/include/sama5/chip.h @@ -1,4 +1,4 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/sama5/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,49 +16,78 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_SAMA5_CHIP_H #define __ARCH_ARM_INCLUDE_SAMA5_CHIP_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ #include -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + /* SAMA5D2 Family * - * SAMA5D21 SAMA5D22 SAMA5D23 SAMA5D24 SAMA5D26 SAMA5D27 SAMA5D28 - * ------------------------- --------- --------- --------- --------- --------- --------- --------- - * Pin Count 196 196 196 256 289 289 289 - * Max. Operating Frequency 500 MHz 500 MHz 500 MHz 500 MHz 500 MHz 500 MHz 500 MHz - * CPU Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 - * Max I/O Pins 72 72 72 105 128 128 128 - * USB Transceiver 1 1 1 1 1 1 1 - * USB Speed Hi-Speed Hi-Speed Hi-Speed Hi-Speed Hi-Speed Hi-Speed Hi-Speed - * USB Interface 2 2 2 3 3 3 3 - * SPI 6 6 6 7 7 7 7 - * QuadSPI 2 2 2 2 2 2 2 - * TWIHS (I2C) 6 6 6 7 7 7 7 - * UART 9 9 9 10 10 10 10 - * CAN - 1 1 - - 2 2 - * SDIO/SD/MMC 1 1 1 2 2 2 2 - * I2SC 2 2 2 2 2 2 2 - * SSC 2 2 2 2 2 2 2 - * Class D 1 1 1 2 2 2 2 - * PDMIC 1 1 1 2 2 2 2 - * Camera Interface 1 1 1 1 1 1 1 - * ADC Inputs 5 5 5 12 12 12 12 - * AESB - 1 1 1 - 1 1 - * SRAM (Kbytes) 128 128 128 128 128 128 128 - * DDR Bus 16-bit 16-bit 16-bit 16/32-bit 16/32-bit 16/32-bit 16/32-bit - * Timers 6 6 6 6 6 6 6 - * Tamper pins 6 6 6 2 8 8 8 - * Packages BGA196 BGA196 BGA196 BGA256 BGA289 BGA289 BGA289 + * SAMA5D21 SAMA5D22 SAMA5D23 SAMA5D24 + * ------------------------- --------- --------- --------- --------- + * Pin Count 196 196 196 256 + * Max. Operating Frequency 500 MHz 500 MHz 500 MHz 500 MHz + * CPU Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 + * Max I/O Pins 72 72 72 105 + * USB Transceiver 1 1 1 1 + * USB Speed Hi-Speed Hi-Speed Hi-Speed Hi-Speed + * USB Interface 2 2 2 3 + * SPI 6 6 6 7 + * QuadSPI 2 2 2 2 + * TWIHS (I2C) 6 6 6 7 + * UART 9 9 9 10 + * CAN - 1 1 - + * SDIO/SD/MMC 1 1 1 2 + * I2SC 2 2 2 2 + * SSC 2 2 2 2 + * Class D 1 1 1 2 + * PDMIC 1 1 1 2 + * Camera Interface 1 1 1 1 + * ADC Inputs 5 5 5 1 + * AESB - 1 1 1 + * SRAM (Kbytes) 128 128 128 128 + * DDR Bus 16-bit 16-bit 16-bit 16/32-bit + * Timers 6 6 6 6 + * Tamper pins 6 6 6 2 + * Packages BGA196 BGA196 BGA196 BGA256 + * + * SAMA5D26 SAMA5D27 SAMA5D28 + * ------------------------- --------- --------- --------- + * Pin Count 289 289 289 + * Max. Operating Frequency 500 MHz 500 MHz 500 MHz + * CPU Cortex-A5 Cortex-A5 Cortex-A5 + * Max I/O Pins 128 128 128 + * USB Transceiver 1 1 1 + * USB Speed Hi-Speed Hi-Speed Hi-Speed + * USB Interface 3 3 3 + * SPI 7 7 7 + * QuadSPI 2 2 2 + * TWIHS (I2C) 7 7 7 + * UART 10 10 10 + * CAN - 2 2 + * SDIO/SD/MMC 2 2 2 + * I2SC 2 2 2 + * SSC 2 2 2 + * Class D 2 2 2 + * PDMIC 2 2 2 + * Camera Interface 1 1 1 + * ADC Inputs 12 12 12 + * AESB - 1 1 + * SRAM (Kbytes) 128 128 128 + * DDR Bus 16/32-bit 16/32-bit 16/32-bit + * Timers 6 6 6 + * Tamper pins 8 8 8 + * Packages BGA289 BGA289 BGA289 */ #if defined(CONFIG_ARCH_CHIP_ATSAMA5D21) || defined(CONFIG_ARCH_CHIP_ATSAMA5D22) || \ @@ -79,48 +108,91 @@ /* SAMA5D3 Family * - * ATSAMA5D31 ATSAMA5D33 ATSAMA5D34 ATSAMA5D35 ATSAMA5D36 - * ------------------------- ------------- ------------- ------------- ------------- ------------- - * Pin Count 324 324 324 324 324 - * Max. Operating Frequency 536 MHz 536 MHz 536 MHz 536 MHz 536 MHz - * CPU Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 Cortex-A5 - * Max I/O Pins 160 160 160 160 160 - * Ext Interrupts 160 160 160 160 160 - * USB Transceiver 3 3 3 3 3 - * USB Speed Hi-Speed Hi-Speed Hi-Speed Hi-Speed Hi-Speed - * USB Interface Host, Device Host, Device Host, Device Host, Device Host, Device - * SPI 6 6 6 6 6 - * TWI (I2C) 3 3 3 3 3 - * UART 7 5 5 7 7 - * CAN - - 2 2 2 - * LIN 4 4 4 4 4 - * SSC 2 2 2 2 2 - * Ethernet 1 1 1 2 2 - * SD / eMMC 3 2 3 2 3 - * Graphic LCD Yes Yes Yes - Yes - * Camera Interface Yes Yes Yes Yes Yes - * ADC channels 12 12 12 12 12 - * ADC Resolution (bits) 12 12 12 12 12 - * ADC Speed (ksps) 440 440 440 440 1000 - * Resistive Touch Screen Yes Yes Yes Yes Yes - * Crypto Engine AES/DES/ AES/DES/ AES/DES/ AES/DES/ AES/DES/ - * SHA/TRNG SHA/TRNG SHA/TRNG SHA/TRNG SHA/TRNG - * SRAM (Kbytes) 128 128 128 128 128 - * External Bus Interface 1 1 1 1 1 - * DRAM Memory DDR2/LPDDR, DDR2/LPDDR, DDR2/LPDDR, DDR2/LPDDR, DDR2/LPDDR, - * SDRAM/LPSDR SDRAM/LPSDR DDR2/LPDDR, DDR2/LPDDR, DDR2/LPDDR, - * NAND Interface Yes Yes Yes Yes Yes - * Temp. Range (deg C) -40 to 85 -40 to 85 -40 to 85 -40 to 85 -40 to 105 - * I/O Supply Class 1.8/3.3 1.8/3.3 1.8/3.3 1.8/3.3 1.8/3.3 - * Operating Voltage (Vcc) 1.08 to 1.32 1.08 to 1.32 1.08 to 1.32 1.08 to 1.322 1.08 to 1.32 - * FPU Yes Yes Yes Yes Yes - * MPU / MMU No/Yes No/Yes No/Yes No/Yes No/Yes - * Timers 5 5 5 6 6 - * Output Compare channels 6 6 6 6 6 - * Input Capture Channels 6 6 6 6 6 - * PWM Channels 4 4 4 4 4 - * 32kHz RTC Yes Yes Yes Yes Yes - * Packages LFBGA324_A LFBGA324_A LFBGA324_A LFBGA324_A LFBGA324_A + * ATSAMA5D31 ATSAMA5D33 ATSAMA5D34 + * ------------------------- ------------- ------------- ------------- + * Pin Count 324 324 324 + * Max. Operating Frequency 536 MHz 536 MHz 536 MHz + * CPU Cortex-A5 Cortex-A5 Cortex-A5 + * Max I/O Pins 160 160 160 + * Ext Interrupts 160 160 160 + * USB Transceiver 3 3 3 + * USB Speed Hi-Speed Hi-Speed Hi-Speed + * USB Interface Host, Device Host, Device Host, Device + * SPI 6 6 6 + * TWI (I2C) 3 3 3 + * UART 7 5 5 + * CAN - - 2 + * LIN 4 4 4 + * SSC 2 2 2 + * Ethernet 1 1 1 + * SD / eMMC 3 2 3 + * Graphic LCD Yes Yes Yes + * Camera Interface Yes Yes Yes + * ADC channels 12 12 12 + * ADC Resolution (bits) 12 12 12 + * ADC Speed (ksps) 440 440 440 + * Resistive Touch Screen Yes Yes Yes + * Crypto Engine AES/DES/ AES/DES/ AES/DES/ + * SHA/TRNG SHA/TRNG SHA/TRNG + * SRAM (Kbytes) 128 128 128 + * External Bus Interface 1 1 1 + * DRAM Memory DDR2/LPDDR, DDR2/LPDDR, DDR2/LPDDR, + * SDRAM/LPSDR SDRAM/LPSDR DDR2/LPDDR, + * NAND Interface Yes Yes Yes + * Temp. Range (deg C) -40 to 85 -40 to 85 -40 to 85 + * I/O Supply Class 1.8/3.3 1.8/3.3 1.8/3.3 + * Operating Voltage (Vcc) 1.08 to 1.32 1.08 to 1.32 1.08 to 1.32 + * FPU Yes Yes Yes + * MPU / MMU No/Yes No/Yes No/Yes + * Timers 5 5 5 + * Output Compare channels 6 6 6 + * Input Capture Channels 6 6 6 + * PWM Channels 4 4 4 + * 32kHz RTC Yes Yes Yes + * Packages LFBGA324_A LFBGA324_A LFBGA324_A + * + * ATSAMA5D35 ATSAMA5D36 + * ------------------------- ------------- ------------- + * Pin Count 324 324 + * Max. Operating Frequency 536 MHz 536 MHz + * CPU Cortex-A5 Cortex-A5 + * Max I/O Pins 160 160 + * Ext Interrupts 160 160 + * USB Transceiver 3 3 + * USB Speed Hi-Speed Hi-Speed + * USB Interface Host, Device Host, Device + * SPI 6 6 + * TWI (I2C) 3 3 + * UART 7 7 + * CAN 2 2 + * LIN 4 4 + * SSC 2 2 + * Ethernet 2 2 + * SD / eMMC 2 3 + * Graphic LCD - Yes + * Camera Interface Yes Yes + * ADC channels 12 12 + * ADC Resolution (bits) 12 12 + * ADC Speed (ksps) 440 1000 + * Resistive Touch Screen Yes Yes + * Crypto Engine AES/DES/ AES/DES/ + * SHA/TRNG SHA/TRNG + * SRAM (Kbytes) 128 128 + * External Bus Interface 1 1 + * DRAM Memory DDR2/LPDDR, DDR2/LPDDR, + * DDR2/LPDDR, DDR2/LPDDR, + * NAND Interface Yes Yes + * Temp. Range (deg C) -40 to 85 -40 to 105 + * I/O Supply Class 1.8/3.3 1.8/3.3 + * Operating Voltage (Vcc) 1.08 to 1.322 1.08 to 1.32 + * FPU Yes Yes + * MPU / MMU No/Yes No/Yes + * Timers 6 6 + * Output Compare channels 6 6 + * Input Capture Channels 6 6 + * PWM Channels 4 4 + * 32kHz RTC Yes Yes + * Packages LFBGA324_A LFBGA324_A */ #elif defined(CONFIG_ARCH_CHIP_ATSAMA5D31) @@ -189,16 +261,16 @@ # error Unrecognized SAMAD5 chip #endif -/**************************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************************** - * Public Functions - ****************************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_SAMA5_CHIP_H */ diff --git a/arch/arm/include/sama5/irq.h b/arch/arm/include/sama5/irq.h index bf27161c057..acb42afdeed 100644 --- a/arch/arm/include/sama5/irq.h +++ b/arch/arm/include/sama5/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sama5/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,25 +16,25 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMA5_IRQ_H #define __ARCH_ARM_INCLUDE_SAMA5_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Chip-Specific External interrupts */ @@ -48,15 +48,15 @@ # error Unrecognized SAMA5 family #endif -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -66,9 +66,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/sama5/sama5d2_irq.h b/arch/arm/include/sama5/sama5d2_irq.h index 37f9d64ac4a..610f47a3c5c 100644 --- a/arch/arm/include/sama5/sama5d2_irq.h +++ b/arch/arm/include/sama5/sama5d2_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sama5/sama5d2_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMA5_SAMA5D2_IRQ_H #define __ARCH_ARM_INCLUDE_SAMA5_SAMA5D2_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAMA5D2 Peripheral Identifiers */ @@ -188,13 +188,14 @@ #define SAM_IRQ_MCAN00 SAM_PID_MCAN00 /* MCAN controller 0, Interrupt 0 */ #define SAM_IRQ_MCAN10 SAM_PID_MCAN10 /* MCAN controller 1, Interrupt 0 */ #define SAM_IRQ_CLASSD SAM_PID_CLASSD /* Audio Class D Amplifier */ - - /* Special Function Register (no interrupt) */ - - /* Secured Advanced Interrupt Controller (no interrupt) */ - - /* Advanced Interrupt Controller (no interrupt) */ - + /* Special Function Register + * (no interrupt) */ + /* Secured Advanced Interrupt + * Controller + * (no interrupt) */ + /* Advanced Interrupt + * Controller + * (no interrupt) */ #define SAM_IRQ_L2CC SAM_PID_L2CC /* L2 Cache Controller */ #define SAM_IRQ_MCAN01 SAM_PID_MCAN01 /* MCAN controller 0, Interrupt 1 */ #define SAM_IRQ_MCAN11 SAM_PID_MCAN11 /* MCAN controller 1, Interrupt 1 */ @@ -209,9 +210,8 @@ #define SAM_IRQ_SYS SAM_PID_SYS /* System Controller Interrupt PMC, RTC, RSTC */ #define SAM_IRQ_ACC SAM_PID_ACC /* Analog Comparator */ #define SAM_IRQ_RXLP SAM_PID_RXLP /* UART Low-Power */ - - /* Special Function Register BackUp (no interrupt) */ - + /* Special Function + * Register BackUp (no interrupt) */ /* Chip ID (no interrupt) */ #define SAM_IRQ_NINT (SAM_PID_RXLP + 1) @@ -381,21 +381,21 @@ SAM_NPIOAIRQS + SAM_NPIOBIRQS + SAM_NPIOCIRQS + \ SAM_NPIODIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/sama5/sama5d3_irq.h b/arch/arm/include/sama5/sama5d3_irq.h index d08eba68ef3..b952902ab47 100644 --- a/arch/arm/include/sama5/sama5d3_irq.h +++ b/arch/arm/include/sama5/sama5d3_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sama5/sama5d3_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMA5_SAMA5D3_IRQ_H #define __ARCH_ARM_INCLUDE_SAMA5_SAMA5D3_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAMA5D3 Peripheral Identifiers */ @@ -347,21 +347,21 @@ SAM_NPIOAIRQS + SAM_NPIOBIRQS + SAM_NPIOCIRQS + \ SAM_NPIODIRQS + SAM_NPIOEIRQS ) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/sama5/sama5d4_irq.h b/arch/arm/include/sama5/sama5d4_irq.h index dedbb62c03e..8799c366493 100644 --- a/arch/arm/include/sama5/sama5d4_irq.h +++ b/arch/arm/include/sama5/sama5d4_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/sama5/sama5d4_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMA5_SAMA5D4_IRQ_H #define __ARCH_ARM_INCLUDE_SAMA5_SAMA5D4_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAMA5D3 Peripheral Identifiers */ @@ -390,21 +390,21 @@ SAM_NPIOAIRQS + SAM_NPIOBIRQS + SAM_NPIOCIRQS + \ SAM_NPIODIRQS + SAM_NPIOEIRQS ) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/samd2l2/chip.h b/arch/arm/include/samd2l2/chip.h index 251331452e5..22f4b55a2e8 100644 --- a/arch/arm/include/samd2l2/chip.h +++ b/arch/arm/include/samd2l2/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/samd2l2/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,28 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_CHIP_H #define __ARCH_ARM_INCLUDE_SAMD2L2_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ -/* SAMD20 Family ********************************************************************/ +/* SAMD20 Family ************************************************************/ + /* FEATURE SAM D20J SAM D20G SAM D20E * ------------------- ------------------ ------------------ -------- * No. of pins 64 48 32 - * Flash 256/128/64/32/16KB 256/128/64/32/16KB 256/128/64/32/16KB + * Flash 256/128/64/ 256/128/64/ 256/128/64/ + * 32/16KB 32/16KB 32/16KB * SRAM 32/16/8/4/2KB 32/16/8/4/2KB 32/16/8/4/2KB * Max. Freq. 48MHz 48MHz 48MHz * Event channels 8 8 8 @@ -49,7 +51,8 @@ * DAC channels 1 1 1 * RTC Yes Yes Yes * RTC alarms 1 1 1 - * RTC compare 1 32-bit/2 16-bit 1 32-bit/2 16-bit 1 32-bit/2 16-bit + * RTC compare 1 32-bit/ 1 32-bit/ 1 32-bit/ + * 2 16-bit 2 16-bit 2 16-bit * External interrupts 16 16 16 * PTC X an Y 16x16 12x10 10x6 * Packages QFN/TQFP QFN/TQFP QFN/TQFP @@ -328,7 +331,7 @@ # define SAMD2L2_NADC 20 /* 20 ADC channels */ # define SAMD2L2_NCMP 2 /* 2 Comparators */ # define SAMD2L2_NDAC 1 /* 1 DAC channel */ -# define SAMD2L2_NOPAMP 0 /* No OpAmps */ +# define SAMD2L2_NOPAMP 0 /* No OpAmps */ # define SAMD2L2_RTC 1 /* Have RTC */ # define SAMD2L2_NALARMS 1 /* 1 RTC alarm */ # define SAMD2L2_NRTCMP 1 /* RTC compare: 1 32-bit/2 16-bit */ @@ -338,7 +341,8 @@ # define SAMD2L2_WDT 1 /* Have watchdog timer */ #endif -/* SAMD21 Family ********************************************************************/ +/* SAMD21 Family ************************************************************/ + /* FEATURE SAM D21J SAM D21G SAM D21E * ------------------- ------------------ ------------------ -------- * No. of pins 64 48 32 @@ -360,11 +364,13 @@ * DAC channels 1 1 1 * RTC Yes Yes Yes * RTC alarms 1 1 1 - * RTC compare 1 32-bit/2 16-bit 1 32-bit/2 16-bit 1 32-bit/2 16-bit + * RTC compare 1 32-bit/ 1 32-bit/ 1 32-bit/ + * 2 16-bit 2 16-bit 2 16-bit * External interrupts 16 16 16 * PTC X an Y 16x16 12x10 10x6 * Packages QFN/TQFP QFN/TQFP/WLCSP QFN/TQFP/UFBGA - * Oscillators XOSC32, XOSC, OSC32K, OSCULP32K, OSC8M, DFLL48M, and FDPLL96M + * Oscillators XOSC32, XOSC, OSC32K, OSCULP32K, OSC8M, + * DFLL48M, and FDPLL96M * SW Debug interface Yes Yes Yes * Watchdog timer Yes Yes Yes */ @@ -643,7 +649,7 @@ # define SAMD2L2_NADC 20 /* 20 ADC channels */ # define SAMD2L2_NCMP 2 /* 2 Comparators */ # define SAMD2L2_NDAC 1 /* 1 DAC channel */ -# define SAMD2L2_NOPAMP 3 /* 3 OpAmps */ +# define SAMD2L2_NOPAMP 3 /* 3 OpAmps */ # define SAMD2L2_RTC 1 /* Have RTC */ # define SAMD2L2_NALARMS 1 /* 1 RTC alarm */ # define SAMD2L2_NRTCMP 1 /* RTC compare: 1 32-bit/2 16-bit */ @@ -653,7 +659,8 @@ # define SAMD2L2_WDT 1 /* Have watchdog timer */ #endif -/* SAML21 Family ********************************************************************/ +/* SAML21 Family ************************************************************/ + /* FEATURE SAM L21J SAM L21G SAM L21E * ------------------- ------------------ ------------------ -------- * No. of pins 64 48 32 @@ -679,12 +686,14 @@ * OPAMP 3 3 3 * RTC Yes Yes Yes * RTC alarms 1 1 1 - * RTC compare 1 32-bit/2 16-bit 1 32-bit/2 16-bit 1 32-bit/2 16-bit + * RTC compare 1 32-bit/ 1 32-bit/ 1 32-bit/ + * 2 16-bit 2 16-bit 2 16-bit * External interrupts 16 16 16 * PTC X an Y 12x16 8x12 6x10 * 16x12 12x8 10x6 * Packages QFN/TQFP QFN/TQFP QFN/TQFP - * Oscillators XOSC32, XOSC, OSC32K, OSCULP32K, OSC16M, DFLL48M, and FDPLL96M + * Oscillators XOSC32, XOSC, OSC32K, OSCULP32K, + * OSC16M, DFLL48M, and FDPLL96M * SW Debug interface Yes Yes Yes * Watchdog timer Yes Yes Yes */ @@ -952,10 +961,12 @@ # define SAMD2L2_WDT 1 /* Have watchdog timer */ #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0-3. The lower the value, the greater - * the priority of the corresponding interrupt. The processor implements only - * bits[7:6] of each field, bits[5:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0-3. The lower the value, the + * greater the priority of the corresponding interrupt. The processor + * implements only bits[7:6] of each field, bits[5:0] read as zero and ignore + * writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xc0 /* All bits[7:6] set is minimum priority */ @@ -963,16 +974,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x40 /* Five bits of interrupt priority used */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_SAMD2L2_CHIP_H */ diff --git a/arch/arm/include/samd2l2/irq.h b/arch/arm/include/samd2l2/irq.h index f866ad09e4c..683ffb0ab67 100644 --- a/arch/arm/include/samd2l2/irq.h +++ b/arch/arm/include/samd2l2/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samd2l2/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_IRQ_H #define __ARCH_ARM_INCLUDE_SAMD2L2_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -54,7 +55,9 @@ #define SAM_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define SAM_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define SAM_IRQ_INTERRUPT (16) /* Vector number of the first external interrupt */ @@ -70,15 +73,15 @@ # error Unrecognized SAMD/L architecture #endif -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -88,9 +91,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/samd2l2/sam_adc.h b/arch/arm/include/samd2l2/sam_adc.h index 83a4112214e..b547593d4a3 100644 --- a/arch/arm/include/samd2l2/sam_adc.h +++ b/arch/arm/include/samd2l2/sam_adc.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/samd2l2/sam_adc.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,13 +16,13 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_SRC_SAMD2L2_SAM_ADC_H #define __ARCH_ARM_SRC_SAMD2L2_SAM_ADC_H /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IOCTL definitions */ diff --git a/arch/arm/include/samd2l2/samd20_irq.h b/arch/arm/include/samd2l2/samd20_irq.h index 976d5bbcc32..ad3c0dd4b5b 100644 --- a/arch/arm/include/samd2l2/samd20_irq.h +++ b/arch/arm/include/samd2l2/samd20_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samd2l2/samd20_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_SAMD20_IRQ_H #define __ARCH_ARM_INCLUDE_SAMD2L2_SAMD20_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts */ @@ -92,21 +92,21 @@ #define NR_IRQS (SAM_IRQ_INTERRUPT + SAM_IRQ_NINTS + SAM_IRQ_NEXTINTS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/samd2l2/samd21_irq.h b/arch/arm/include/samd2l2/samd21_irq.h index e08753a6b90..716211b45d1 100644 --- a/arch/arm/include/samd2l2/samd21_irq.h +++ b/arch/arm/include/samd2l2/samd21_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samd2l2/samd21_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,27 +16,27 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ /* References: * "Atmel SAM D21E / SAM D21G / SAM D21J SMART ARM-Based Microcontroller * Datasheet", Atmel-42181E–SAM-D21_Datasheet–02/2015 */ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_SAMD21_IRQ_H #define __ARCH_ARM_INCLUDE_SAMD2L2_SAMD21_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts */ @@ -100,17 +100,17 @@ #define NR_IRQS (SAM_IRQ_INTERRUPT + SAM_IRQ_NINTS + SAM_IRQ_NEXTINTS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline Functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -121,9 +121,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/samd2l2/saml21_irq.h b/arch/arm/include/samd2l2/saml21_irq.h index b11fba1a61b..dbca21ad060 100644 --- a/arch/arm/include/samd2l2/saml21_irq.h +++ b/arch/arm/include/samd2l2/saml21_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samd2l2/saml21_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMD2L2_SAML21_IRQ_H #define __ARCH_ARM_INCLUDE_SAMD2L2_SAML21_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts */ @@ -100,17 +100,17 @@ #define NR_IRQS (SAM_IRQ_INTERRUPT + SAM_IRQ_NINTS + SAM_IRQ_NEXTINTS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline Functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -121,9 +121,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/samd5e5/chip.h b/arch/arm/include/samd5e5/chip.h index 2cae6961b80..8bc06a93a41 100644 --- a/arch/arm/include/samd5e5/chip.h +++ b/arch/arm/include/samd5e5/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/samd5e5/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,23 +16,24 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_SAMD5E5_CHIP_H #define __ARCH_ARM_INCLUDE_SAMD5E5_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* Get customizations for each supported chip. Only sizes and numbers of things are - * provided here. See arch/arm/src/samd5e5/Kconfig for other, boolean configuration +/* Get customizations for each supported chip. + * Only sizes and numbers of things are provided here. + * See arch/arm/src/samd5e5/Kconfig for other, boolean configuration * settings. */ @@ -612,10 +613,12 @@ # error Unrecognized SAMD5x/Ex chip #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0x00-0xe0. The lower the value, the - * greater the priority of the corresponding interrupt. The processor implements only - * bits[7:4] of each field, bits[6:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0x00-0xe0. The lower the + * value, the greater the priority of the corresponding interrupt. + * The processor implements only bits[7:4] of each field, bits[6:0] read as + * zero and ignore writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xe0 /* All bits[7:5] set is minimum priority */ @@ -623,16 +626,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x20 /* Eight priority levels in steps 0x20 */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_SAMD5E5_CHIP_H */ diff --git a/arch/arm/include/samd5e5/irq.h b/arch/arm/include/samd5e5/irq.h index a37065726e1..95324f96b75 100644 --- a/arch/arm/include/samd5e5/irq.h +++ b/arch/arm/include/samd5e5/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samd5e5/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMD5E5_IRQ_H #define __ARCH_ARM_INCLUDE_SAMD5E5_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Common Processor Exceptions (vectors 0-15) */ @@ -67,15 +68,15 @@ # error "Unsupported SAMD5/E5 family" #endif -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -85,9 +86,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/samd5e5/samd5e5_irq.h b/arch/arm/include/samd5e5/samd5e5_irq.h index 4fe3a24fc5e..37e38290cb0 100644 --- a/arch/arm/include/samd5e5/samd5e5_irq.h +++ b/arch/arm/include/samd5e5/samd5e5_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************************ +/**************************************************************************** * arch/arm/include/samd5e5/samd5e5_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMD5E5_SAM4L_IRQ_H #define __ARCH_ARM_INCLUDE_SAMD5E5_SAM4L_IRQ_H -/************************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ - * Pre-processor Definitions - ************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* External interrupts (vectors >= 16) */ @@ -195,23 +195,24 @@ #define SAM_IRQ_SDHC1 (SAM_IRQ_EXTINT + 136) /* 136 SDHC1: SDHC1, TIMER */ #define SAM_IRQ_NEXTINT 137 /* Total number of external interrupt numbers */ + #define NR_IRQS (SAM_IRQ_EXTINT + SAM_IRQ_NEXTINT) /* The number of vectors */ -/************************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Inline functions - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************************/ + ****************************************************************************/ -/************************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/samv7/chip.h b/arch/arm/include/samv7/chip.h index 04eea7b3f54..086b9c24ee9 100644 --- a/arch/arm/include/samv7/chip.h +++ b/arch/arm/include/samv7/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/samv7/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_SAMV7_CHIP_H #define __ARCH_ARM_INCLUDE_SAMV7_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ @@ -371,10 +371,12 @@ # error "Unknown SAMV7 chip type" #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value, 0-15. The lower the value, the greater - * the priority of the corresponding interrupt. The processor implements only - * bits[7:6] of each field, bits[5:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value, 0-15. The lower the value, the + * greater the priority of the corresponding interrupt. The processor + * implements only bits[7:6] of each field, bits[5:0] read as zero and ignore + * writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xc0 /* All bits[7:6] set is minimum priority */ @@ -382,16 +384,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x40 /* Two bits of interrupt priority used */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_SAMV7_CHIP_H */ diff --git a/arch/arm/include/samv7/irq.h b/arch/arm/include/samv7/irq.h index 02d117951e6..94bbef1959f 100644 --- a/arch/arm/include/samv7/irq.h +++ b/arch/arm/include/samv7/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samv7/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMV7_IRQ_H #define __ARCH_ARM_INCLUDE_SAMV7_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Common Processor Exceptions (vectors 0-15) */ @@ -70,15 +71,15 @@ # error Unrecognized SAMV7 architecture #endif -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -88,9 +89,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/samv7/same70_irq.h b/arch/arm/include/samv7/same70_irq.h index 2f6bf121a4c..d74022599cd 100644 --- a/arch/arm/include/samv7/same70_irq.h +++ b/arch/arm/include/samv7/same70_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samv7/same70_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMV7_SAME70_IRQ_H #define __ARCH_ARM_INCLUDE_SAMV7_SAME70_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAMV71 Peripheral Identifiers */ @@ -107,7 +107,7 @@ #define NR_PIDS (69) /* Number of peripheral identifiers */ -/* External interrupts (priority levels >= 256*/ +/* External interrupts (priority levels >= 256 */ #define SAM_IRQ_SUPC (SAM_IRQ_EXTINT+SAM_PID_SUPC) /* Supply Controller */ #define SAM_IRQ_RSTC (SAM_IRQ_EXTINT+SAM_PID_RSTC) /* Reset Controller */ @@ -162,9 +162,11 @@ #define SAM_IRQ_TC9 (SAM_IRQ_EXTINT+SAM_PID_TC9) /* Timer Counter 9 */ #define SAM_IRQ_TC10 (SAM_IRQ_EXTINT+SAM_PID_TC10) /* Timer Counter 10 */ #define SAM_IRQ_TC11 (SAM_IRQ_EXTINT+SAM_PID_TC11) /* Timer Counter 11 */ + #define SAM_IRQ_RESERVED53 (SAM_IRQ_EXTINT+SAM_PID_RESERVED53) /* Reserved */ #define SAM_IRQ_RESERVED54 (SAM_IRQ_EXTINT+SAM_PID_RESERVED54) /* Reserved */ #define SAM_IRQ_RESERVED55 (SAM_IRQ_EXTINT+SAM_PID_RESERVED55) /* Reserved */ + #define SAM_IRQ_AES (SAM_IRQ_EXTINT+SAM_PID_AES) /* AES */ #define SAM_IRQ_TRNG (SAM_IRQ_EXTINT+SAM_PID_TRNG) /* True Random Number Generator */ #define SAM_IRQ_XDMAC (SAM_IRQ_EXTINT+SAM_PID_XDMAC) /* Central DMA Controller */ @@ -388,21 +390,21 @@ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \ SAM_NGPIODIRQS + SAM_NGPIOEIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/samv7/samv71_irq.h b/arch/arm/include/samv7/samv71_irq.h index a6694057b30..3ce9317d6fc 100644 --- a/arch/arm/include/samv7/samv71_irq.h +++ b/arch/arm/include/samv7/samv71_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/samv7/samv71_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,22 +16,22 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_SAMV7_SAMV71_IRQ_H #define __ARCH_ARM_INCLUDE_SAMV7_SAMV71_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* SAMV71 Peripheral Identifiers */ @@ -107,7 +107,7 @@ #define NR_PIDS (69) /* Number of peripheral identifiers */ -/* External interrupts (priority levels >= 256*/ +/* External interrupts (priority levels >= 256 */ #define SAM_IRQ_SUPC (SAM_IRQ_EXTINT+SAM_PID_SUPC) /* Supply Controller */ #define SAM_IRQ_RSTC (SAM_IRQ_EXTINT+SAM_PID_RSTC) /* Reset Controller */ @@ -164,7 +164,9 @@ #define SAM_IRQ_TC11 (SAM_IRQ_EXTINT+SAM_PID_TC11) /* Timer Counter 11 */ #define SAM_IRQ_MLB0 (SAM_IRQ_EXTINT+SAM_PID_MLB0) /* MediaLB IRQ 0 */ #define SAM_IRQ_MLB1 (SAM_IRQ_EXTINT+SAM_PID_MLB1) /* MediaLB IRQ 1 */ + #define SAM_IRQ_RESERVED55 (SAM_IRQ_EXTINT+SAM_PID_RESERVED55) /* Reserved */ + #define SAM_IRQ_AES (SAM_IRQ_EXTINT+SAM_PID_AES) /* AES */ #define SAM_IRQ_TRNG (SAM_IRQ_EXTINT+SAM_PID_TRNG) /* True Random Number Generator */ #define SAM_IRQ_XDMAC (SAM_IRQ_EXTINT+SAM_PID_XDMAC) /* Central DMA Controller */ @@ -388,21 +390,21 @@ SAM_NGPIOAIRQS + SAM_NGPIOBIRQS + SAM_NGPIOCIRQS + \ SAM_NGPIODIRQS + SAM_NGPIOEIRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Inline functions - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/spinlock.h b/arch/arm/include/spinlock.h index 5072e905487..55c12c8792f 100644 --- a/arch/arm/include/spinlock.h +++ b/arch/arm/include/spinlock.h @@ -48,7 +48,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Spinlock states */ diff --git a/arch/arm/include/stdarg.h b/arch/arm/include/stdarg.h index 6cf07bcb93b..26b9088f8ee 100644 --- a/arch/arm/include/stdarg.h +++ b/arch/arm/include/stdarg.h @@ -26,8 +26,9 @@ ****************************************************************************/ /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ + /* This should work with any modern gcc (newer than 3.4 or so) */ #define va_start(v,l) __builtin_va_start(v,l) diff --git a/arch/arm/include/stm32/chip.h b/arch/arm/include/stm32/chip.h index d798ad26595..f155df64d23 100644 --- a/arch/arm/include/stm32/chip.h +++ b/arch/arm/include/stm32/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************************** +/**************************************************************************** * arch/arm/include/stm32/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - **************************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_STM32_CHIP_H #define __ARCH_ARM_INCLUDE_STM32_CHIP_H -/************************************************************************************************** +/**************************************************************************** * Included Files - **************************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************************** - * Pre-processor Definitions - **************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Check the STM32 family configuration. * It must be done in arch/arm/src/stm32/Kconfig ! @@ -117,7 +117,7 @@ * The chip-specific pin-mapping is defined in the chip datasheet. */ -/* STM32L EnergyLite Line *************************************************************************/ +/* STM32L EnergyLite Line ***************************************************/ /* STM32L151XX -- No LCD * STM32L152XX -- With LCD @@ -521,7 +521,7 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F100 Value Line **************************************************************************/ +/* STM32 F100 Value Line ****************************************************/ #elif defined(CONFIG_ARCH_CHIP_STM32F100C8) || defined(CONFIG_ARCH_CHIP_STM32F100CB) \ || defined(CONFIG_ARCH_CHIP_STM32F100R8) || defined(CONFIG_ARCH_CHIP_STM32F100RB) @@ -531,7 +531,9 @@ # define STM32_NGTIMNDMA 0 /* No 16-bit general timers without DMA */ # define STM32_NBTIM 2 /* 2 basic timers: TIM6, TIM7 */ -/* TODO: there are also 3 additional timers (15-17) that don't fit any existing category */ +/* TODO: there are also 3 additional timers (15-17) + * that don't fit any existing category + */ # define STM32_NDMA 1 /* DMA1 */ # define STM32_NSPI 2 /* SPI1-2 */ @@ -558,7 +560,9 @@ # define STM32_NGTIMNDMA 0 /* No 16-bit general timers without DMA */ # define STM32_NBTIM 2 /* 2 basic timers: TIM6, TIM7 */ -/* TODO: there are also 3 additional timers (15-17) that don't fit any existing category */ +/* TODO: there are also 3 additional timers (15-17) + * that don't fit any existing category + */ # define STM32_NDMA 1 /* DMA1 */ # define STM32_NSPI 2 /* SPI1-2 */ @@ -578,7 +582,7 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F100 High-density value Line *************************************************************/ +/* STM32 F100 High-density value Line ***************************************/ #elif defined(CONFIG_ARCH_CHIP_STM32F100RC) || defined(CONFIG_ARCH_CHIP_STM32F100RD) \ || defined(CONFIG_ARCH_CHIP_STM32F100RE) @@ -588,7 +592,9 @@ # define STM32_NGTIMNDMA 0 /* No 16-bit general timers without DMA */ # define STM32_NBTIM 2 /* 2 basic timers: TIM6, TIM7 */ -/* TODO: there are also 6 additional timers (12-17) that don't fit any existing category */ +/* TODO: there are also 6 additional timers (12-17) + * that don't fit any existing category + */ # define STM32_NDMA 2 /* DMA1-2 */ # define STM32_NSPI 3 /* SPI1-3 */ @@ -616,7 +622,9 @@ # define STM32_NGTIMNDMA 0 /* No 16-bit general timers without DMA */ # define STM32_NBTIM 2 /* 2 basic timers: TIM6, TIM7 */ -/* TODO: there are also 6 additional timers (12-17) that don't fit any existing category */ +/* TODO: there are also 6 additional timers (12-17) + * that don't fit any existing category + */ # define STM32_NDMA 2 /* DMA1-2 */ # define STM32_NSPI 3 /* SPI1-3 */ @@ -636,7 +644,7 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F102x8/102xB Medium Density USB Access Family ********************************************/ +/* STM32 F102x8/102xB Medium Density USB Access Family **********************/ #elif defined(CONFIG_ARCH_CHIP_STM32F102CB) # define STM32_NFSMC 1 /* FSMC */ @@ -662,7 +670,7 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F103 Low Density Family ******************************************************************/ +/* STM32 F103 Low Density Family ********************************************/ /* STM32F103C4 & STM32F103C6 */ @@ -688,7 +696,7 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F103 Medium Density Performance Line *****************************************************/ +/* STM32 F103 Medium Density Performance Line *******************************/ #elif defined(CONFIG_ARCH_CHIP_STM32F103T8) || defined(CONFIG_ARCH_CHIP_STM32F103TB) # define STM32_NFSMC 0 /* No FSMC */ @@ -762,10 +770,10 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F103 High Density Family *****************************************************************/ +/* STM32 F103 High Density Family *******************************************/ -/* STM32F103RC, STM32F103RD, and STM32F103RE are all provided in 64 pin packages and - * differ only in the available FLASH and SRAM. +/* STM32F103RC, STM32F103RD, and STM32F103RE are all provided in 64 pin + * packages and differ only in the available FLASH and SRAM. */ #elif defined(CONFIG_ARCH_CHIP_STM32F103RC) || defined(CONFIG_ARCH_CHIP_STM32F103RD) || \ @@ -793,8 +801,8 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32F103VC, STM32F103VD, and STM32F103VE are all provided in 100 pin packages and differ - * only in the available FLASH and SRAM. +/* STM32F103VC, STM32F103VD, and STM32F103VE are all provided in 100 pin + * packages and differ only in the available FLASH and SRAM. */ #elif defined(CONFIG_ARCH_CHIP_STM32F103VC) || defined(CONFIG_ARCH_CHIP_STM32F103VE) @@ -821,8 +829,8 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32F103ZC, STM32F103ZD, and STM32F103ZE are all provided in 144 pin packages and differ - * only in the available FLASH and SRAM. +/* STM32F103ZC, STM32F103ZD, and STM32F103ZE are all provided in 144 pin + * packages and differ only in the available FLASH and SRAM. */ #elif defined(CONFIG_ARCH_CHIP_STM32F103ZE) @@ -849,7 +857,7 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F105/F107 Connectivity Line **************************************************************/ +/* STM32 F105/F107 Connectivity Line ****************************************/ #elif defined(CONFIG_ARCH_CHIP_STM32F105VB) # define STM32_NFSMC 1 /* FSMC */ @@ -923,7 +931,7 @@ # define STM32_NRNG 0 /* No random number generator (RNG) */ # define STM32_NDCMI 0 /* No digital camera interface (DCMI) */ -/* STM32 F2 Family ********************************************************************************/ +/* STM32 F2 Family **********************************************************/ #elif defined(CONFIG_ARCH_CHIP_STM32F205RG) /* UFBGA-176 1024Kb FLASH 128Kb SRAM */ # define STM32_NFSMC 0 /* No FSMC */ @@ -1028,7 +1036,7 @@ # define STM32_NRNG 1 /* Random number generator (RNG) */ # define STM32_NDCMI 1 /* Digital camera interface (DCMI) */ -/* STM23 F3 Family ********************************************************************************/ +/* STM23 F3 Family **********************************************************/ /* Part Numbering: STM32Fssscfxxx * @@ -1553,7 +1561,7 @@ # define STM32_NRNG 0 /* (0) No random number generator (RNG) */ # define STM32_NDCMI 0 /* (0) No digital camera interface (DCMI) */ -/* STM23 F4 Family ********************************************************************************/ +/* STM23 F4 Family **********************************************************/ /* STM32F01xB/C Family Differences: * @@ -2606,7 +2614,7 @@ # error "Unsupported STM32 chip" #endif -/* Peripheral IP versions *************************************************************************/ +/* Peripheral IP versions ***************************************************/ /* Peripheral IP versions are invariant and should be decided here, not in * Kconfig. @@ -2644,7 +2652,7 @@ # error "Did not resolve peripheral IP versions!" #endif -/* NVIC priority levels ***************************************************************************/ +/* NVIC priority levels *****************************************************/ #define NVIC_SYSH_PRIORITY_MIN 0xf0 /* All bits set in minimum priority */ #define NVIC_SYSH_PRIORITY_DEFAULT 0x80 /* Midpoint is the default */ diff --git a/arch/arm/include/stm32/irq.h b/arch/arm/include/stm32/irq.h index 240cd302303..3f29c71e3bd 100644 --- a/arch/arm/include/stm32/irq.h +++ b/arch/arm/include/stm32/irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/stm32/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, * only indirectly through nuttx/irq.h @@ -25,21 +25,22 @@ #ifndef __ARCH_ARM_INCLUDE_STM32_IRQ_H #define __ARCH_ARM_INCLUDE_STM32_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -58,13 +59,15 @@ #define STM32_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define STM32_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define STM32_IRQ_FIRST (16) /* Vector number of the first external interrupt */ -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #if defined(CONFIG_STM32_STM32L15XX) # include @@ -86,13 +89,13 @@ # error "Unsupported STM32 chip" #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -103,9 +106,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/stm32/stm32f10xxx_irq.h b/arch/arm/include/stm32/stm32f10xxx_irq.h index 22bfbe4ec03..22c623bf009 100644 --- a/arch/arm/include/stm32/stm32f10xxx_irq.h +++ b/arch/arm/include/stm32/stm32f10xxx_irq.h @@ -33,7 +33,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32/stm32f20xxx_irq.h b/arch/arm/include/stm32/stm32f20xxx_irq.h index aa83433b8f3..26160b1d4d0 100644 --- a/arch/arm/include/stm32/stm32f20xxx_irq.h +++ b/arch/arm/include/stm32/stm32f20xxx_irq.h @@ -33,7 +33,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32/stm32f30xxx_irq.h b/arch/arm/include/stm32/stm32f30xxx_irq.h index ed176038a70..e8acfd93baa 100644 --- a/arch/arm/include/stm32/stm32f30xxx_irq.h +++ b/arch/arm/include/stm32/stm32f30xxx_irq.h @@ -33,7 +33,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32/stm32f33xxx_irq.h b/arch/arm/include/stm32/stm32f33xxx_irq.h index 7b91fd4aad0..892b6aacb31 100644 --- a/arch/arm/include/stm32/stm32f33xxx_irq.h +++ b/arch/arm/include/stm32/stm32f33xxx_irq.h @@ -49,7 +49,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32/stm32f37xxx_irq.h b/arch/arm/include/stm32/stm32f37xxx_irq.h index ee57857daef..6c00b24ec9b 100644 --- a/arch/arm/include/stm32/stm32f37xxx_irq.h +++ b/arch/arm/include/stm32/stm32f37xxx_irq.h @@ -49,7 +49,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32/stm32f40xxx_irq.h b/arch/arm/include/stm32/stm32f40xxx_irq.h index 3fb77643d96..c2ac5e9524a 100644 --- a/arch/arm/include/stm32/stm32f40xxx_irq.h +++ b/arch/arm/include/stm32/stm32f40xxx_irq.h @@ -1,7 +1,8 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/stm32/stm32f40xxx_irq.h * - * Copyright (C) 2009, 2014-2015, 2017-2018 Gregory Nutt. All rights reserved. + * Copyright (C) 2009, 2014-2015, 2017-2018 Gregory Nutt. + * All rights reserved. * Copyright (C) 2016 Omni Hoverboards Inc. All rights reserved. * Author: Gregory Nutt * David Sidrane @@ -34,7 +35,7 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ****************************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, * only indirectly through nuttx/irq.h @@ -43,23 +44,24 @@ #ifndef __ARCH_ARM_INCLUDE_STM32_STM32F40XXX_IRQ_H #define __ARCH_ARM_INCLUDE_STM32_STM32F40XXX_IRQ_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found - * in nuttx/arch/arm/include/stm32/irq.h + * Processor Exceptions (vectors 0-15). These common definitions can + * be found in nuttx/arch/arm/include/stm32/irq.h * * External interrupts (vectors >= 16) */ @@ -340,13 +342,13 @@ # define NR_IRQS (STM32_IRQ_FIRST+93) #endif -/**************************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus diff --git a/arch/arm/include/stm32/stm32g4xxxx_irq.h b/arch/arm/include/stm32/stm32g4xxxx_irq.h index 5f224848079..adf4f80f4a7 100644 --- a/arch/arm/include/stm32/stm32g4xxxx_irq.h +++ b/arch/arm/include/stm32/stm32g4xxxx_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/stm32/stm32g4xxxx_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, only indirectly * through nuttx/irq.h @@ -25,16 +25,16 @@ #ifndef __ARCH_ARM_INCLUDE_STM32_STM32G4XXXX_IRQ_H #define __ARCH_ARM_INCLUDE_STM32_STM32G4XXXX_IRQ_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ numbers correspond to the vector numbers and hence * map directly to bits in the NVIC. This does, however, waste several words @@ -170,13 +170,13 @@ #define STM32_IRQ_NEXTINT (102) #define NR_IRQS (STM32_IRQ_FIRST + 102) -/**************************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -187,9 +187,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/stm32/stm32l15xxx_irq.h b/arch/arm/include/stm32/stm32l15xxx_irq.h index 26d006ec5e4..e1450528c64 100644 --- a/arch/arm/include/stm32/stm32l15xxx_irq.h +++ b/arch/arm/include/stm32/stm32l15xxx_irq.h @@ -33,7 +33,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32f0l0g0/chip.h b/arch/arm/include/stm32f0l0g0/chip.h index 2ee739c72c0..ff5d0c9f33f 100644 --- a/arch/arm/include/stm32f0l0g0/chip.h +++ b/arch/arm/include/stm32f0l0g0/chip.h @@ -45,7 +45,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Get customizations for each supported chip */ diff --git a/arch/arm/include/stm32f0l0g0/irq.h b/arch/arm/include/stm32f0l0g0/irq.h index 5c594836ffb..401e683600e 100644 --- a/arch/arm/include/stm32f0l0g0/irq.h +++ b/arch/arm/include/stm32f0l0g0/irq.h @@ -35,7 +35,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32f0l0g0/stm32f0_irq.h b/arch/arm/include/stm32f0l0g0/stm32f0_irq.h index 2d0e348b0ea..d02cee01585 100644 --- a/arch/arm/include/stm32f0l0g0/stm32f0_irq.h +++ b/arch/arm/include/stm32f0l0g0/stm32f0_irq.h @@ -34,7 +34,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32f0l0g0/stm32g0_irq.h b/arch/arm/include/stm32f0l0g0/stm32g0_irq.h index f42361dbf55..1a496a9292b 100644 --- a/arch/arm/include/stm32f0l0g0/stm32g0_irq.h +++ b/arch/arm/include/stm32f0l0g0/stm32g0_irq.h @@ -50,7 +50,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32f0l0g0/stm32l0_irq.h b/arch/arm/include/stm32f0l0g0/stm32l0_irq.h index fba285034cc..48083f1b33f 100644 --- a/arch/arm/include/stm32f0l0g0/stm32l0_irq.h +++ b/arch/arm/include/stm32f0l0g0/stm32l0_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/stm32f0l0g0/stm32l0_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,31 +16,34 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through nuttx/irq.h */ +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h + */ #ifndef __ARCH_ARM_INCLUDE_STM32F0L0G0_STM32L0_IRQ_H #define __ARCH_ARM_INCLUDE_STM32F0L0G0_STM32L0_IRQ_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ #include #include #include -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found - * in nuttx/arch/arm/include/stm32f0l0g0/irq.h + * Processor Exceptions (vectors 0-15). These common definitions + * can be found in nuttx/arch/arm/include/stm32f0l0g0/irq.h */ #define STM32_IRQ_WWDG (STM32_IRQ_EXTINT + 0) /* 0: Window Watchdog interrupt */ @@ -87,13 +90,13 @@ #define STM32_IRQ_NEXTINT (32) -/**************************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************************/ + ****************************************************************************/ -/**************************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -104,9 +107,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************************** +/**************************************************************************** * Public Functions Prototypes - ****************************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/stm32f7/chip.h b/arch/arm/include/stm32f7/chip.h index a77dae3c37a..b24e68edb1d 100644 --- a/arch/arm/include/stm32f7/chip.h +++ b/arch/arm/include/stm32f7/chip.h @@ -1,4 +1,4 @@ -/******************************************************************************************************************** +/**************************************************************************** * arch/arm/include/stm32f7/chip.h * * Copyright (C) 2015-2017 Gregory Nutt. All rights reserved. @@ -33,101 +33,171 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ********************************************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_STM32F7_CHIP_H #define __ARCH_ARM_INCLUDE_STM32F7_CHIP_H -/******************************************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************************************/ + ****************************************************************************/ #include -/******************************************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* STM32F722xx, STM32F723xx, - * STM32F745xx, STM32F746xx, STM32F756xx, STM32F765xx, STM32F767xx, STM32F768xx, - * STM32F769xx, STM32F777xx and STM32F779xx Differences between family members: + * STM32F745xx, STM32F746xx, STM32F756xx, STM32F765xx, STM32F767xx, + * STM32F768xx, STM32F769xx, STM32F777xx and STM32F779xx + * Differences between family members: * - * ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- ---- ----- ----- ---- ------------ ------ + * ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- * SPI ADC LCD - * PART PACKAGE GPIOs I2S CHAN TFT MIPI JPEG CAN ETH DFSDM CRYPTO FPU RAM L1 - * ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- ---- ----- ----- ---- ------------ ------ - * STM32F722Rx LQFP64 50 3/3 16 No No No 1 No No No SFPU (176+16+64) 8+8 - * STM32F722Vx LQFP100 82 4/3 16 No No No 1 No No No SFPU (176+16+64) 8+8 - * STM32F722Zx LQFP144 114 5/3 24 No No No 1 No No No SFPU (176+16+64) 8+8 - * STM32F722Ix UFBGA176/LQFP176 140 5/3 24 No No No 1 No No No SFPU (176+16+64) 8+8 + * PART PACKAGE GPIOs I2S CHAN TFT MIPI JPEG CAN + * ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- + * STM32F722Rx LQFP64 50 3/3 16 No No No 1 + * STM32F722Vx LQFP100 82 4/3 16 No No No 1 + * STM32F722Zx LQFP144 114 5/3 24 No No No 1 + * STM32F722Ix UFBGA176/LQFP176 140 5/3 24 No No No 1 * - * STM32F723Vx WLCSP100 79 4/3 16 No No No 1 No No No SFPU (176+16+64) 8+8 - * STM32F723Zx UFBGA144/LQFP144 112 5/3 24 No No No 1 No No No SFPU (176+16+64) 8+8 - * STM32F723Ix UFBGA176/LQFP176 138 5/3 24 No No No 1 No No No SFPU (176+16+64) 8+8 + * STM32F723Vx WLCSP100 79 4/3 16 No No No 1 + * STM32F723Zx UFBGA144/LQFP144 112 5/3 24 No No No 1 + * STM32F723Ix UFBGA176/LQFP176 138 5/3 24 No No No 1 * - * STM32F745Vx LQFP100 82 4/3 16 No No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F745Zx WLCSP143/LQFP144 114 6/3 24 No No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F745Ix UFBGA176/LQFP176 140 6/3 24 No No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F745Bx LQFP208 168 6/3 24 No No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F745Nx TFBGA216 68 6/3 24 No No No 2 Yes No No SFPU (240+16+64) 4+4 + * STM32F745Vx LQFP100 82 4/3 16 No No No 2 + * STM32F745Zx WLCSP143/LQFP144 114 6/3 24 No No No 2 + * STM32F745Ix UFBGA176/LQFP176 140 6/3 24 No No No 2 + * STM32F745Bx LQFP208 168 6/3 24 No No No 2 + * STM32F745Nx TFBGA216 68 6/3 24 No No No 2 * - * STM32F746Vx LQFP100 82 4/3 16 Yes No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F746Zx WLCSP143/LQFP144 114 6/3 24 Yes No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F746Ix UFBGA176/LQFP176 140 6/3 24 Yes No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F746Bx LQFP208 168 6/3 24 Yes No No 2 Yes No No SFPU (240+16+64) 4+4 - * STM32F746Nx TFBGA216 168 6/3 24 Yes No No 2 Yes No No SFPU + * STM32F746Vx LQFP100 82 4/3 16 Yes No No 2 + * STM32F746Zx WLCSP143/LQFP144 114 6/3 24 Yes No No 2 + * STM32F746Ix UFBGA176/LQFP176 140 6/3 24 Yes No No 2 + * STM32F746Bx LQFP208 168 6/3 24 Yes No No 2 + * STM32F746Nx TFBGA216 168 6/3 24 Yes No No 2 * - * STM32F756Vx LQFP100 82 4/3 16 Yes No No 2 Yes No Yes SFPU (240+16+64) 4+4 - * STM32F756Zx WLCSP143/LQFP144 114 6/3 24 Yes No No 2 Yes No Yes SFPU (240+16+64) 4+4 - * STM32F756Ix UFBGA176/LQFP176 140 6/3 24 Yes No No 2 Yes No Yes SFPU (240+16+64) 4+4 - * STM32F756Bx LQFP208 168 6/3 24 Yes No No 2 Yes No Yes SFPU (240+16+64) 4+4 - * STM32F756Nx TFBGA216 168 6/3 24 Yes No No 2 Yes No Yes SFPU (240+16+64) 4+4 + * STM32F756Vx LQFP100 82 4/3 16 Yes No No 2 + * STM32F756Zx WLCSP143/LQFP144 114 6/3 24 Yes No No 2 + * STM32F756Ix UFBGA176/LQFP176 140 6/3 24 Yes No No 2 + * STM32F756Bx LQFP208 168 6/3 24 Yes No No 2 + * STM32F756Nx TFBGA216 168 6/3 24 Yes No No 2 * - * STM32F765Vx LQFP100 82 4/3 16 No No No 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F765Zx WLCSP143/LQFP144 114 6/3 24 No No No 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F765Ix UFBGA176/LQFP176 140 6/3 24 No No No 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F765Bx LQFP208 168 6/3 24 No No No 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F765Nx TFBGA216 168 6/3 24 No No No 3 Yes Yes No DFPU (368+16+128) 16+16 + * STM32F765Vx LQFP100 82 4/3 16 No No No 3 + * STM32F765Zx WLCSP143/LQFP144 114 6/3 24 No No No 3 + * STM32F765Ix UFBGA176/LQFP176 140 6/3 24 No No No 3 + * STM32F765Bx LQFP208 168 6/3 24 No No No 3 + * STM32F765Nx TFBGA216 168 6/3 24 No No No 3 * - * STM32F767Vx LQFP100 82 4/3 16 Yes No Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F767Zx WLCSP143/LQFP144 114 6/3 24 Yes No Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F767Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F767Bx LQFP208 168 6/3 24 Yes Yes Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F767Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 Yes Yes No DFPU (368+16+128) 16+16 + * STM32F767Vx LQFP100 82 4/3 16 Yes No Yes 3 + * STM32F767Zx WLCSP143/LQFP144 114 6/3 24 Yes No Yes 3 + * STM32F767Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 + * STM32F767Bx LQFP208 168 6/3 24 Yes Yes Yes 3 + * STM32F767Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 * - * STM32F768Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 No Yes No DFPU (368+16+128) 16+16 + * STM32F768Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 * - * STM32F769Vx LQFP100 82 4/3 16 Yes No Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F769Zx LQFP144 114 6/3 24 Yes No Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F769Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F769Bx LQFP208 168 6/3 24 Yes Yes Yes 3 Yes Yes No DFPU (368+16+128) 16+16 - * STM32F769Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 Yes Yes No DFPU (368+16+128) 16+16 + * STM32F769Vx LQFP100 82 4/3 16 Yes No Yes 3 + * STM32F769Zx LQFP144 114 6/3 24 Yes No Yes 3 + * STM32F769Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 + * STM32F769Bx LQFP208 168 6/3 24 Yes Yes Yes 3 + * STM32F769Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 * - * STM32F769Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 No Yes No DFPU (368+16+128) 16+16 + * STM32F769Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 * - * STM32F777Vx LQFP100 82 4/3 16 Yes No Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 - * STM32F777Zx LQFP144 114 6/3 24 Yes No Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 - * STM32F777Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 - * STM32F777Bx LQFP208 159 6/3 24 Yes Yes Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 - * STM32F777Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F777Vx LQFP100 82 4/3 16 Yes No Yes 3 + * STM32F777Zx LQFP144 114 6/3 24 Yes No Yes 3 + * STM32F777Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 + * STM32F777Bx LQFP208 159 6/3 24 Yes Yes Yes 3 + * STM32F777Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 * - * STM32F778Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 No Yes Yes DFPU (368+16+128) 16+16 + * STM32F778Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 * - * STM32F779Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 - * STM32F779Bx LQFP208 159 6/3 24 Yes Yes Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 - * STM32F779Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F779Ix UFBGA176/LQFP176 132 6/3 24 Yes Yes Yes 3 + * STM32F779Bx LQFP208 159 6/3 24 Yes Yes Yes 3 + * STM32F779Nx TFBGA216 159 6/3 24 Yes Yes Yes 3 - * STM32F779Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 No Yes Yes DFPU (368+16+128) 16+16 - * ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- ---- ----- ----- ---- ------------ ------ + * STM32F779Ax WLCSP180 129 6/3 24 Yes Yes Yes 3 + * ----------- ---------------- ----- ---- ----- ---- ---- ---- ---- * + * + * ----------- ---- ----- ----- ---- ------------ ------ + * + * PART ETH DFSDM CRYPTO FPU RAM L1 + * ----------- ---- ----- ----- ---- ------------ ------ + * STM32F722Rx No No No SFPU (176+16+64) 8+8 + * STM32F722Vx No No No SFPU (176+16+64) 8+8 + * STM32F722Zx No No No SFPU (176+16+64) 8+8 + * STM32F722Ix No No No SFPU (176+16+64) 8+8 + * + * STM32F723Vx No No No SFPU (176+16+64) 8+8 + * STM32F723Zx No No No SFPU (176+16+64) 8+8 + * STM32F723Ix No No No SFPU (176+16+64) 8+8 + * + * STM32F745Vx Yes No No SFPU (240+16+64) 4+4 + * STM32F745Zx Yes No No SFPU (240+16+64) 4+4 + * STM32F745Ix Yes No No SFPU (240+16+64) 4+4 + * STM32F745Bx Yes No No SFPU (240+16+64) 4+4 + * STM32F745Nx Yes No No SFPU (240+16+64) 4+4 + * + * STM32F746Vx Yes No No SFPU (240+16+64) 4+4 + * STM32F746Zx Yes No No SFPU (240+16+64) 4+4 + * STM32F746Ix Yes No No SFPU (240+16+64) 4+4 + * STM32F746Bx Yes No No SFPU (240+16+64) 4+4 + * STM32F746Nx Yes No No SFPU + * + * STM32F756Vx Yes No Yes SFPU (240+16+64) 4+4 + * STM32F756Zx Yes No Yes SFPU (240+16+64) 4+4 + * STM32F756Ix Yes No Yes SFPU (240+16+64) 4+4 + * STM32F756Bx Yes No Yes SFPU (240+16+64) 4+4 + * STM32F756Nx Yes No Yes SFPU (240+16+64) 4+4 + * + * STM32F765Vx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F765Zx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F765Ix Yes Yes No DFPU (368+16+128) 16+16 + * STM32F765Bx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F765Nx Yes Yes No DFPU (368+16+128) 16+16 + * + * STM32F767Vx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F767Zx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F767Ix Yes Yes No DFPU (368+16+128) 16+16 + * STM32F767Bx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F767Nx Yes Yes No DFPU (368+16+128) 16+16 + * + * STM32F768Ax No Yes No DFPU (368+16+128) 16+16 + * + * STM32F769Vx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F769Zx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F769Ix Yes Yes No DFPU (368+16+128) 16+16 + * STM32F769Bx Yes Yes No DFPU (368+16+128) 16+16 + * STM32F769Nx Yes Yes No DFPU (368+16+128) 16+16 + * + * STM32F769Ax No Yes No DFPU (368+16+128) 16+16 + * + * STM32F777Vx Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F777Zx Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F777Ix Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F777Bx Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F777Nx Yes Yes Yes DFPU (368+16+128) 16+16 + * + * STM32F778Ax No Yes Yes DFPU (368+16+128) 16+16 + * + * STM32F779Ix Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F779Bx Yes Yes Yes DFPU (368+16+128) 16+16 + * STM32F779Nx Yes Yes Yes DFPU (368+16+128) 16+16 + + * STM32F779Ax No Yes Yes DFPU (368+16+128) 16+16 + * ----------- ---- ----- ---- ----- ------------ ------ + * Parts STM32F72xxC & STM32F73xxC have 256Kb of FLASH * Parts STM32F72xxE & STM32F73xxE have 512Kb of FLASH * Parts STM32F74xxE have 512Kb of FLASH * Parts STM32F74xxG have 1024Kb of FLASH * Parts STM32F74xxI have 2048Kb of FLASH * - * The correct FLASH size will be set CONFIG_STM32F7_FLASH_CONFIG_x or overridden - * with CONFIG_STM32F7_FLASH_OVERRIDE_x + * The correct FLASH size will be set CONFIG_STM32F7_FLASH_CONFIG_x + * or overridden with CONFIG_STM32F7_FLASH_OVERRIDE_x * */ #if defined(CONFIG_ARCH_CHIP_STM32F722RC) || \ @@ -374,7 +444,7 @@ #define STM32F7_NDFSDM 0 /* No Digital filters */ #endif -/* NVIC priority levels *********************************************************************************************/ +/* NVIC priority levels *****************************************************/ /* 16 Programmable interrupt levels */ diff --git a/arch/arm/include/stm32f7/irq.h b/arch/arm/include/stm32f7/irq.h index 2147d54d092..0b6624b1f80 100644 --- a/arch/arm/include/stm32f7/irq.h +++ b/arch/arm/include/stm32f7/irq.h @@ -48,7 +48,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h b/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h index 4ffc3c6ee34..611c2a29e5e 100644 --- a/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h +++ b/arch/arm/include/stm32f7/stm32f72xx73xx_irq.h @@ -52,7 +52,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h b/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h index d481351957c..4502fc59f3c 100644 --- a/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h +++ b/arch/arm/include/stm32f7/stm32f74xx75xx_irq.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h b/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h index e3dd548f9c2..1e9cca956c4 100644 --- a/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h +++ b/arch/arm/include/stm32f7/stm32f76xx77xx_irq.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32h7/chip.h b/arch/arm/include/stm32h7/chip.h index eed4ab88797..3c16e21ebe9 100644 --- a/arch/arm/include/stm32h7/chip.h +++ b/arch/arm/include/stm32h7/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/stm32h7/chip.h * * Copyright (C) 2018 Gregory Nutt. All rights reserved. @@ -32,20 +32,20 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_STM32H7_CHIP_H #define __ARCH_ARM_INCLUDE_STM32H7_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* STM32H7x3xx Differences between family members: * @@ -65,8 +65,8 @@ * * Parts STM32H7xxxI have 2048Kb of FLASH * - * The correct FLASH size will be set CONFIG_STM32H7_FLASH_CONFIG_x or overridden - * with CONFIG_STM32H7_FLASH_OVERRIDE_x + * The correct FLASH size will be set CONFIG_STM32H7_FLASH_CONFIG_x or + * overridden with CONFIG_STM32H7_FLASH_OVERRIDE_x */ #if defined (CONFIG_ARCH_CHIP_STM32H743AG) || \ @@ -211,7 +211,7 @@ # define STM32H7_NFMC 0 /* No FMC memory controller */ #endif -/* NVIC priority levels *************************************************************/ +/* NVIC priority levels *****************************************************/ /* 16 Programmable interrupt levels */ diff --git a/arch/arm/include/stm32h7/irq.h b/arch/arm/include/stm32h7/irq.h index 894f59d5e3f..54ec535af19 100644 --- a/arch/arm/include/stm32h7/irq.h +++ b/arch/arm/include/stm32h7/irq.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32h7/stm32h7x3xx_irq.h b/arch/arm/include/stm32h7/stm32h7x3xx_irq.h index 88ca875039a..5cb54960327 100644 --- a/arch/arm/include/stm32h7/stm32h7x3xx_irq.h +++ b/arch/arm/include/stm32h7/stm32h7x3xx_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/stm32h7/stm32h7x3xx_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,27 +16,33 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through arch/irq.h */ +/* This file should never be included directly but, rather, + * only indirectly through arch/irq.h + */ #ifndef __ARCH_ARM_INCLUDE_STM32H7_STM32H7X3XX_IRQ_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ #include -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to bits in the - * NVIC. This does, however, waste several words of memory in the IRQ to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to bits + * in the NVIC. + * This does, however, waste several words of memory in the IRQ to handle + * mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found in the file - * nuttx/arch/arm/include/stm32h7/irq.h which includes this file + * Processor Exceptions (vectors 0-15). These common definitions can be + * found in the file nuttx/arch/arm/include/stm32h7/irq.h which includes + * this file * * External interrupts (vectors >= 16) */ diff --git a/arch/arm/include/stm32h7/stm32h7x7xx_irq.h b/arch/arm/include/stm32h7/stm32h7x7xx_irq.h index d52fb87c72f..eee68506f85 100644 --- a/arch/arm/include/stm32h7/stm32h7x7xx_irq.h +++ b/arch/arm/include/stm32h7/stm32h7x7xx_irq.h @@ -31,7 +31,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32l4/chip.h b/arch/arm/include/stm32l4/chip.h index 0d74e62f99d..4ba5cfec49c 100644 --- a/arch/arm/include/stm32l4/chip.h +++ b/arch/arm/include/stm32l4/chip.h @@ -28,7 +28,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* STM32L475, STM32L476, STM32L486, STM32L496, STM32L4A6 diff --git a/arch/arm/include/stm32l4/irq.h b/arch/arm/include/stm32l4/irq.h index 76bc1f01364..dc259c75155 100644 --- a/arch/arm/include/stm32l4/irq.h +++ b/arch/arm/include/stm32l4/irq.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32l4/stm32l4x3xx_irq.h b/arch/arm/include/stm32l4/stm32l4x3xx_irq.h index 69759bb315b..43360ee19fd 100644 --- a/arch/arm/include/stm32l4/stm32l4x3xx_irq.h +++ b/arch/arm/include/stm32l4/stm32l4x3xx_irq.h @@ -49,7 +49,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32l4/stm32l4x5xx_irq.h b/arch/arm/include/stm32l4/stm32l4x5xx_irq.h index 55baf3f3bac..b1e7e921274 100644 --- a/arch/arm/include/stm32l4/stm32l4x5xx_irq.h +++ b/arch/arm/include/stm32l4/stm32l4x5xx_irq.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32l4/stm32l4x6xx_irq.h b/arch/arm/include/stm32l4/stm32l4x6xx_irq.h index 003d6c994c3..b8f628cb0c6 100644 --- a/arch/arm/include/stm32l4/stm32l4x6xx_irq.h +++ b/arch/arm/include/stm32l4/stm32l4x6xx_irq.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32l4/stm32l4xrxx_irq.h b/arch/arm/include/stm32l4/stm32l4xrxx_irq.h index 54db53fd06a..18a8b1493f0 100644 --- a/arch/arm/include/stm32l4/stm32l4xrxx_irq.h +++ b/arch/arm/include/stm32l4/stm32l4xrxx_irq.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/stm32l5/chip.h b/arch/arm/include/stm32l5/chip.h index 9d3c8921764..7bb1472eb8e 100644 --- a/arch/arm/include/stm32l5/chip.h +++ b/arch/arm/include/stm32l5/chip.h @@ -1,4 +1,4 @@ -/***************************************************************************** +/**************************************************************************** * arch/arm/include/stm32l5/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - *****************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_STM32L5_CHIP_H #define __ARCH_ARM_INCLUDE_STM32L5_CHIP_H -/***************************************************************************** +/**************************************************************************** * Included Files - *****************************************************************************/ + ****************************************************************************/ #include -/***************************************************************************** - * Pre-processor Definitions - *****************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ #if defined(CONFIG_STM32L5_STM32L562XX) # define STM32L5_SRAM1_SIZE (192*1024) /* 192Kb SRAM1 on AHB bus Matrix */ @@ -69,7 +69,7 @@ # define STM32L5_NOPAMP 2 /* Operational Amplifiers */ #endif /* CONFIG_STM32L5_STM32L562XX */ -/* NVIC priority levels ******************************************************/ +/* NVIC priority levels *****************************************************/ /* 16 Programmable interrupt levels */ diff --git a/arch/arm/include/stm32l5/irq.h b/arch/arm/include/stm32l5/irq.h index 2c2a3346e44..8e03edea2c2 100644 --- a/arch/arm/include/stm32l5/irq.h +++ b/arch/arm/include/stm32l5/irq.h @@ -1,4 +1,4 @@ -/***************************************************************************** +/**************************************************************************** * arch/arm/include/stm32l5/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - *****************************************************************************/ + ****************************************************************************/ /* This file should never be included directed but, rather, * only indirectly through nuttx/irq.h @@ -25,9 +25,9 @@ #ifndef __ARCH_ARM_INCLUDE_STM32L5_IRQ_H #define __ARCH_ARM_INCLUDE_STM32L5_IRQ_H -/***************************************************************************** +/**************************************************************************** * Included Files - *****************************************************************************/ + ****************************************************************************/ #include diff --git a/arch/arm/include/stm32l5/stm32l562xx_irq.h b/arch/arm/include/stm32l5/stm32l562xx_irq.h index 6ec29334e7a..97bf29756e3 100644 --- a/arch/arm/include/stm32l5/stm32l562xx_irq.h +++ b/arch/arm/include/stm32l5/stm32l562xx_irq.h @@ -1,4 +1,4 @@ -/***************************************************************************** +/**************************************************************************** * arch/arm/include/stm32l5/stm32l562xx_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,29 +16,29 @@ * License for the specific language governing permissions and limitations * under the License. * - *****************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_STM32L5_STM32L562XX_IRQ_H #define __ARCH_ARM_INCLUDE_STM32L5_STM32L562XX_IRQ_H -/***************************************************************************** +/**************************************************************************** * Included Files - *****************************************************************************/ + ****************************************************************************/ #include #include -/***************************************************************************** - * Pre-processor Definitions - *****************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found - * in the file nuttx/arch/arm/include/stm32l5/stm32l5_irq.h, which is included - * above. + * Processor Exceptions (vectors 0-15). These common definitions can be found + * in the file nuttx/arch/arm/include/stm32l5/stm32l5_irq.h, which is + * included above. * * External interrupts (vectors >= 16) * diff --git a/arch/arm/include/stm32l5/stm32l5_irq.h b/arch/arm/include/stm32l5/stm32l5_irq.h index d57ab3964ac..be3f9fe743c 100644 --- a/arch/arm/include/stm32l5/stm32l5_irq.h +++ b/arch/arm/include/stm32l5/stm32l5_irq.h @@ -1,4 +1,4 @@ -/***************************************************************************** +/**************************************************************************** * arch/arm/include/stm32l5/stm32l5_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,28 +16,30 @@ * License for the specific language governing permissions and limitations * under the License. * - *****************************************************************************/ + ****************************************************************************/ -/* This file should never be included directed but, rather, only indirectly by - * the chip type specific header files (e.g. stm32l562xx_irq.h) +/* This file should never be included directed but, rather, + * only indirectly by the chip type specific header files + * (e.g. stm32l562xx_irq.h) */ #ifndef __ARCH_ARM_INCLUDE_STM32L5_STM32L5_IRQ_H #define __ARCH_ARM_INCLUDE_STM32L5_STM32L5_IRQ_H -/***************************************************************************** +/**************************************************************************** * Included Files - *****************************************************************************/ + ****************************************************************************/ #include -/***************************************************************************** - * Pre-processor Definitions - *****************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map - * directly to bits in the NVIC. This does, however, waste several words of - * memory in the IRQ to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to bits + * in the NVIC. This does, however, waste several words of memory in the + * IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -57,17 +59,19 @@ #define STM32L5_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define STM32L5_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define STM32L5_IRQ_FIRST (16) /* Vector number of the first external interrupt */ -/***************************************************************************** +/**************************************************************************** * Public Types - *****************************************************************************/ + ****************************************************************************/ -/***************************************************************************** +/**************************************************************************** * Public Data - *****************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -78,9 +82,9 @@ extern "C" #define EXTERN extern #endif -/***************************************************************************** +/**************************************************************************** * Public Function Prototypes - *****************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/str71x/irq.h b/arch/arm/include/str71x/irq.h index 998409c6d06..3c0e9f2a8d0 100644 --- a/arch/arm/include/str71x/irq.h +++ b/arch/arm/include/str71x/irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/str71x/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, * only indirectly through nuttx/irq.h @@ -25,15 +25,15 @@ #ifndef __ARCH_ARM_INCLUDE_STR71X_IRQ_H #define __ARCH_ARM_INCLUDE_STR71X_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ channels */ @@ -106,13 +106,13 @@ #define STR71X_FIQ_WDG (0X00000002) #define STR71X_FIQ_WDGT0TIMIS (0X00000003) -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -123,9 +123,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/syscall.h b/arch/arm/include/syscall.h index 7651c213db8..ea1ee2e1919 100644 --- a/arch/arm/include/syscall.h +++ b/arch/arm/include/syscall.h @@ -46,7 +46,7 @@ #endif /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /**************************************************************************** diff --git a/arch/arm/include/tiva/cc13x0_irq.h b/arch/arm/include/tiva/cc13x0_irq.h index 95ac7d64b2b..2a1a0b20f77 100644 --- a/arch/arm/include/tiva/cc13x0_irq.h +++ b/arch/arm/include/tiva/cc13x0_irq.h @@ -28,7 +28,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/tiva/cc13x2_cc26x2_irq.h b/arch/arm/include/tiva/cc13x2_cc26x2_irq.h index 4cecf15b994..1ad68e922e0 100644 --- a/arch/arm/include/tiva/cc13x2_cc26x2_irq.h +++ b/arch/arm/include/tiva/cc13x2_cc26x2_irq.h @@ -28,7 +28,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map diff --git a/arch/arm/include/tiva/chip.h b/arch/arm/include/tiva/chip.h index f0813a1b922..0899ac34c91 100644 --- a/arch/arm/include/tiva/chip.h +++ b/arch/arm/include/tiva/chip.h @@ -45,7 +45,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /* Get customizations for each supported chip */ diff --git a/arch/arm/include/tiva/irq.h b/arch/arm/include/tiva/irq.h index 68727b980cc..b77d7f51593 100644 --- a/arch/arm/include/tiva/irq.h +++ b/arch/arm/include/tiva/irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/tiva/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,21 +16,21 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_TIVA_IRQ_H #define __ARCH_ARM_INCLUDE_TIVA_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Mark GPIO interrupts as disabled for non-existent GPIO ports. */ @@ -109,9 +109,9 @@ #define TIVA_IRQ_INTERRUPTS (16) /* Vector number of the first external interrupt */ -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #if defined(CONFIG_ARCH_CHIP_LM3S) # include @@ -127,16 +127,16 @@ # error "Unsupported Stellaris IRQ file" #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_TIVA_IRQ_H */ diff --git a/arch/arm/include/tiva/lm3s_irq.h b/arch/arm/include/tiva/lm3s_irq.h index 6d395905cc8..1cf8c11ecfb 100644 --- a/arch/arm/include/tiva/lm3s_irq.h +++ b/arch/arm/include/tiva/lm3s_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/tiva/lm3s_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,24 +16,25 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_TIVA_LM3S_IRQ_H #define __ARCH_ARM_INCLUDE_TIVA_LM3S_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* External interrupts (vectors >= 16) */ @@ -503,13 +504,13 @@ #define NR_GPIO_IRQS (_NGPIOTIRQS - NR_IRQS) -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -517,9 +518,9 @@ extern "C" { #endif -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus } diff --git a/arch/arm/include/tiva/lm4f_irq.h b/arch/arm/include/tiva/lm4f_irq.h index ba81f6de177..f7a287d806d 100644 --- a/arch/arm/include/tiva/lm4f_irq.h +++ b/arch/arm/include/tiva/lm4f_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/tiva/lm4f_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,24 +16,25 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_TIVA_LM4F_IRQ_H #define __ARCH_ARM_INCLUDE_TIVA_LM4F_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* External interrupts (vectors >= 16) */ @@ -334,13 +335,13 @@ #define NR_GPIO_IRQS (_NGPIOTIRQS - NR_IRQS) -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -348,9 +349,9 @@ extern "C" { #endif -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus } diff --git a/arch/arm/include/tiva/tm4c_irq.h b/arch/arm/include/tiva/tm4c_irq.h index df02a17e6de..500cf0994c9 100644 --- a/arch/arm/include/tiva/tm4c_irq.h +++ b/arch/arm/include/tiva/tm4c_irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/tiva/tm4c_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_TIVA_TM4C_IRQ_H #define __ARCH_ARM_INCLUDE_TIVA_TM4C_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* All of the TM4C123* part numbers in the following list basically have the * same set of interrupt vectors. However, each part number varies in @@ -59,9 +59,10 @@ * TM4C129ENCPDT, TM4C129ENCZAD, TM4C129LNCZAD, TM4C129XKCZAD, TM4C129XNCZAD. */ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* External interrupts (vectors >= 16) */ @@ -1487,13 +1488,13 @@ #define NR_GPIO_IRQS (_NGPIOQIRQS - NR_IRQS) -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ #ifdef __cplusplus @@ -1501,9 +1502,9 @@ extern "C" { #endif -/************************************************************************************ +/**************************************************************************** * Public Function Prototypess - ************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus } diff --git a/arch/arm/include/tms570/chip.h b/arch/arm/include/tms570/chip.h index bf2edcf058b..cd1a334c826 100644 --- a/arch/arm/include/tms570/chip.h +++ b/arch/arm/include/tms570/chip.h @@ -1,4 +1,4 @@ -/**************************************************************************************************** +/**************************************************************************** * arch/arm/include/tms570/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_TMS570_CHIP_H #define __ARCH_ARM_INCLUDE_TMS570_CHIP_H -/**************************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************************/ + ****************************************************************************/ #include -/**************************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* TMS570LS0432PZ TMS570LS0332PZ TMS570LS0232PZ * Package 100 QFP 100 QFP 100 QFP @@ -167,29 +167,53 @@ # undef TMS570_RTP /* No RAM trace port (RTP) */ # undef TMS570_DMM /* No DMM */ -/* TMS570LS1227ZWT TMS570LS0714ZWT TMS570LS0714PGE TMS570LS0714PZ - * Package 337 BGA 337 BGA 144 QFP 100 QFP - * CPU ARM Cortex-R4F ARM Cortex-R4F ARM Cortex-R4F ARM Cortex-R4F - * Frequency (MHz) 180 180 160 100 - * Flash (KB) 1280 768 768 768 - * RAM (KB) 192 128 128 128 - * Data Flash (KB) 64 64 64 64 - * EMAC 10/100 – – – - * FlexRay 2-ch – – – - * CAN 3 3 3 2 - * MibADC (CH) 2 (24) 2 (24) 2 (24) 2 (16) - * N2HET (Ch) 2 (44) 2 (44) 2 (40) 2 (21) - * ePWM Channels 14 14 14 8 - * eCAP Channels 6 6 6 4 - * eQEP Channels 2 2 2 1 - * MibSPI (CS) 3 (6+6+4) 3 (6+6+4) 3 (5+6+4) 2 (5+1) - * SPI (CS) 2 (2+1) 2 (2+1) 1 (1) 1 (1) - * SCI (LIN) 2 (1) 2 (1) 2 (1) 1 (1) - * I2C 1 1 1 – - * GPIO (INT) 101 (16) 101 (16) 64 (10) 45 (9) - * EMIF 16-bit data – – – - * ETM (Trace) – – – – - * RTP/DMM – – – – +/* TMS570LS1227ZWT TMS570LS0714ZWT + * Package 337 BGA 337 BGA + * CPU ARM Cortex-R4F ARM Cortex-R4F + * Frequency (MHz) 180 180 + * Flash (KB) 1280 768 + * RAM (KB) 192 128 + * Data Flash (KB) 64 64 + * EMAC 10/100 – + * FlexRay 2-ch – + * CAN 3 3 + * MibADC (CH) 2 (24) 2 (24) + * N2HET (Ch) 2 (44) 2 (44) + * ePWM Channels 14 14 + * eCAP Channels 6 6 + * eQEP Channels 2 2 + * MibSPI (CS) 3 (6+6+4) 3 (6+6+4) + * SPI (CS) 2 (2+1) 2 (2+1) + * SCI (LIN) 2 (1) 2 (1) + * I2C 1 1 + * GPIO (INT) 101 (16) 101 (16) + * EMIF 16-bit data – + * ETM (Trace) – – + * RTP/DMM – – + * + * TMS570LS0714PGE TMS570LS0714PZ + * Package 144 QFP 100 QFP + * CPU ARM Cortex-R4F ARM Cortex-R4F + * Frequency (MHz) 160 100 + * Flash (KB) 768 768 + * RAM (KB) 128 128 + * Data Flash (KB) 64 64 + * EMAC – – + * FlexRay – – + * CAN 3 2 + * MibADC (CH) 2 (24) 2 (16) + * N2HET (Ch) 2 (40) 2 (21) + * ePWM Channels 14 8 + * eCAP Channels 6 4 + * eQEP Channels 2 1 + * MibSPI (CS) 3 (5+6+4) 2 (5+1) + * SPI (CS) 1 (1) 1 (1) + * SCI (LIN) 2 (1) 1 (1) + * I2C 1 – + * GPIO (INT) 64 (10) 45 (9) + * EMIF – – + * ETM (Trace) – – + * RTP/DMM – – */ #elif defined(CONFIG_ARCH_CHIP_TMS570LS0714PZ) diff --git a/arch/arm/include/tms570/irq.h b/arch/arm/include/tms570/irq.h index 4179bfbd10c..f7a6275abf2 100644 --- a/arch/arm/include/tms570/irq.h +++ b/arch/arm/include/tms570/irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/tms570/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,27 +16,29 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_TMS570_IRQ_H #define __ARCH_ARM_INCLUDE_TMS570_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ -/* The interrupt vector table only has 96 entries, one phantom vector and 95 interrupt - * channels. Channel 95 does not have a dedicated vector and shall not be used. +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + +/* The interrupt vector table only has 96 entries, one phantom vector and 95 + * interrupt channels. + * Channel 95 does not have a dedicated vector and shall not be used. */ #define TMS570_VECT_PHANTOM 0 /* The first is the "phantom" interrupt */ @@ -63,21 +65,22 @@ # error "Unrecognized Hercules chip" #endif -/* Total number of IRQ numbers. Includes all channels plus GIO second-level interrupts - * (if enabled). Excluds the phantom vector. Zero corresponds to channel 0, vector 1. +/* Total number of IRQ numbers. + * Includes all channels plus GIO second-level interrupts (if enabled). + *Excluds the phantom vector. Zero corresponds to channel 0, vector 1. */ #define NR_IRQS (TMS570_IRQ_NCHANNELS + TMS570_NGIO_IRQS) -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -87,9 +90,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/tms570/tms570ls04x03x_irq.h b/arch/arm/include/tms570/tms570ls04x03x_irq.h index fff9d295498..febb75f3e46 100644 --- a/arch/arm/include/tms570/tms570ls04x03x_irq.h +++ b/arch/arm/include/tms570/tms570ls04x03x_irq.h @@ -1,4 +1,4 @@ -/**************************************************************************************** +/**************************************************************************** * arch/arm/include/tms570/tms570ls04x03x_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,26 +16,28 @@ * License for the specific language governing permissions and limitations * under the License. * - ****************************************************************************************/ + ****************************************************************************/ -/* This file should never be included directly but, rather, only indirectly through - * nuttx/irq.h +/* This file should never be included directly but, rather, + * only indirectly through nuttx/irq.h */ #ifndef __ARCH_ARM_INCLUDE_TMS570_TMS570LS04X03X_IRQ_H #define __ARCH_ARM_INCLUDE_TMS570_TMS570LS04X03X_IRQ_H -/**************************************************************************************** +/**************************************************************************** * Included Files - ****************************************************************************************/ + ****************************************************************************/ #include -/**************************************************************************************** - * Pre-processor Definitions - ****************************************************************************************/ -/* The interrupt vector table only has 96 entries, one phantom vector and 95 interrupt - * channels. Channel 95 does not have a dedicated vector and shall not be used. +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ + +/* The interrupt vector table only has 96 entries, one phantom vector and 95 + * interrupt channels. + * Channel 95 does not have a dedicated vector and shall not be used. */ #define TMS570_IRQ_NCHANNELS 95 /* The "phantom" vector is followed by 95 real @@ -124,16 +126,15 @@ # define TMS570_NGIO_IRQS 0 #endif - -/**************************************************************************************** +/**************************************************************************** * Public Types - ****************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/**************************************************************************************** +/**************************************************************************** * Public Data - ****************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -143,9 +144,9 @@ extern "C" #define EXTERN extern #endif -/**************************************************************************************** +/**************************************************************************** * Public Function Prototypes - ****************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/arm/include/types.h b/arch/arm/include/types.h index f651da4e7cc..32052c88961 100644 --- a/arch/arm/include/types.h +++ b/arch/arm/include/types.h @@ -32,7 +32,7 @@ #include /**************************************************************************** - * Pre-processor Definitions + * Pre-processor Prototypes ****************************************************************************/ /**************************************************************************** diff --git a/arch/arm/include/xmc4/chip.h b/arch/arm/include/xmc4/chip.h index 398f9884074..b3856042ece 100644 --- a/arch/arm/include/xmc4/chip.h +++ b/arch/arm/include/xmc4/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/include/xmc4/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,20 +16,20 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_INCLUDE_XMC4_CHIP_H #define __ARCH_ARM_INCLUDE_XMC4_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ - * Pre-processor Definitions - ************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* Get customizations for each supported chip */ @@ -49,10 +49,12 @@ # error "Unsupported XMC4xxx chip" #endif -/* NVIC priority levels *************************************************************/ -/* Each priority field holds a priority value. The lower the value, the greater the - * priority of the corresponding interrupt. The XMC4500 implements only bits[7:2] - * of this field, bits[1:0] read as zero and ignore writes. +/* NVIC priority levels *****************************************************/ + +/* Each priority field holds a priority value. The lower the value, the + * greater the priority of the corresponding interrupt. + * The XMC4500 implements only bits[7:2] of this field, bits[1:0] + * read as zero and ignore writes. */ #define NVIC_SYSH_PRIORITY_MIN 0xfc /* All bits[7:2] set is minimum priority */ @@ -60,16 +62,16 @@ #define NVIC_SYSH_PRIORITY_MAX 0x00 /* Zero is maximum priority */ #define NVIC_SYSH_PRIORITY_STEP 0x04 /* Steps between supported priority values */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Functions Prototypes + ****************************************************************************/ #endif /* __ARCH_ARM_INCLUDE_XMC4_CHIP_H */ diff --git a/arch/arm/include/xmc4/irq.h b/arch/arm/include/xmc4/irq.h index 4211ede0dd0..3c59fbd5757 100644 --- a/arch/arm/include/xmc4/irq.h +++ b/arch/arm/include/xmc4/irq.h @@ -1,4 +1,4 @@ -/******************************************************************************************** +/**************************************************************************** * arch/arm/include/xmc4/irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ********************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, only indirectly * through nuttx/irq.h @@ -25,20 +25,21 @@ #ifndef __ARCH_ARM_INCLUDE_XMC4_IRQ_H #define __ARCH_ARM_INCLUDE_XMC4_IRQ_H -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #include #include -/******************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ -/* IRQ numbers. The IRQ number corresponds vector number and hence map directly to - * bits in the NVIC. This does, however, waste several words of memory in the IRQ - * to handle mapping tables. +/* IRQ numbers. + * The IRQ number corresponds vector number and hence map directly to + * bits in the NVIC. This does, however, waste several words of memory in + * the IRQ to handle mapping tables. */ /* Processor Exceptions (vectors 0-15) */ @@ -58,7 +59,9 @@ #define XMC4_IRQ_PENDSV (14) /* Vector 14: Pendable system service request */ #define XMC4_IRQ_SYSTICK (15) /* Vector 15: System tick */ -/* External interrupts (vectors >= 16). These definitions are chip-specific */ +/* External interrupts (vectors >= 16). + * These definitions are chip-specific + */ #define XMC4_IRQ_FIRST (16) /* Vector number of the first external interrupt */ @@ -69,11 +72,12 @@ #elif defined(CONFIG_ARCH_CHIP_XMC4800) # include #else - /* The interrupt vectors for other parts are defined in other documents and may or - * may not be the same as above (the family members are all very similar) This - * error just means that you have to look at the document and determine for yourself - * if the vectors are the same. - */ +/* The interrupt vectors for other parts are defined in other documents and + * may or may not be the same as above (the family members are all very + * similar). + * This error just means that you have to look at the document and determine + * for yourself if the vectors are the same. + */ # error "No IRQ numbers for this XMC4xxx part" #endif diff --git a/arch/arm/include/xmc4/xmc4500_irq.h b/arch/arm/include/xmc4/xmc4500_irq.h index 70b95128fc1..4419938a778 100644 --- a/arch/arm/include/xmc4/xmc4500_irq.h +++ b/arch/arm/include/xmc4/xmc4500_irq.h @@ -1,4 +1,4 @@ -/******************************************************************************************** +/**************************************************************************** * arch/arm/include/xmc4/xmc4500_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ********************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, only indirectly * through nuttx/irq.h @@ -25,21 +25,21 @@ #ifndef xmc4__ARCH_ARM_INCLUDE_XMC4_XM4500_IRQ_H #define xmc4__ARCH_ARM_INCLUDE_XMC4_XM4500_IRQ_H -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #include -/******************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) diff --git a/arch/arm/include/xmc4/xmc4700_irq.h b/arch/arm/include/xmc4/xmc4700_irq.h index 6ba7e9d6d2d..b4a2054e418 100644 --- a/arch/arm/include/xmc4/xmc4700_irq.h +++ b/arch/arm/include/xmc4/xmc4700_irq.h @@ -1,4 +1,4 @@ -/******************************************************************************************** +/**************************************************************************** * arch/arm/include/xmc4/xmc4700_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ********************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, only indirectly * through nuttx/irq.h @@ -25,21 +25,21 @@ #ifndef xmc4__ARCH_ARM_INCLUDE_XMC4_XM4700_IRQ_H #define xmc4__ARCH_ARM_INCLUDE_XMC4_XM4700_IRQ_H -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #include -/******************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16) diff --git a/arch/arm/include/xmc4/xmc4800_irq.h b/arch/arm/include/xmc4/xmc4800_irq.h index 19d11213026..05c8937e34c 100644 --- a/arch/arm/include/xmc4/xmc4800_irq.h +++ b/arch/arm/include/xmc4/xmc4800_irq.h @@ -1,4 +1,4 @@ -/******************************************************************************************** +/**************************************************************************** * arch/arm/include/xmc4/xmc4800_irq.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,7 +16,7 @@ * License for the specific language governing permissions and limitations * under the License. * - ********************************************************************************************/ + ****************************************************************************/ /* This file should never be included directly but, rather, only indirectly * through nuttx/irq.h @@ -25,21 +25,21 @@ #ifndef xmc4__ARCH_ARM_INCLUDE_XMC4_XM4800_IRQ_H #define xmc4__ARCH_ARM_INCLUDE_XMC4_XM4800_IRQ_H -/******************************************************************************************** +/**************************************************************************** * Included Files - ********************************************************************************************/ + ****************************************************************************/ #include -/******************************************************************************************** - * Pre-processor Definitions - ********************************************************************************************/ +/**************************************************************************** + * Pre-processor Prototypes + ****************************************************************************/ /* IRQ numbers. The IRQ number corresponds vector number and hence map * directly to bits in the NVIC. This does, however, waste several words of * memory in the IRQ to handle mapping tables. * - * Processor Exceptions (vectors 0-15). These common definitions can be found + * Processor Exceptions (vectors 0-15). These common definitions can be found * in the file nuttx/arch/arm/include/kinets/irq.h which includes this file * * External interrupts (vectors >= 16)