From eed360c0ada64259cfddbcb5e617064093998612 Mon Sep 17 00:00:00 2001 From: simbit18 <101105604+simbit18@users.noreply.github.com> Date: Fri, 28 Apr 2023 17:05:02 +0200 Subject: [PATCH] arch: Fix nxstyle errors error: Long line found --- arch/avr/src/at32uc3/at32uc3_abdac.h | 30 +-- arch/avr/src/at32uc3/at32uc3_flashc.h | 34 +-- arch/avr/src/at32uc3/at32uc3_intc.h | 30 +-- arch/avr/src/at32uc3/at32uc3_memorymap.h | 24 +- arch/avr/src/at32uc3/at32uc3_pinmux.h | 24 +- arch/avr/src/at90usb/at90usb_memorymap.h | 24 +- arch/avr/src/at90usb/chip.h | 28 +- arch/avr/src/atmega/atmega_memorymap.h | 24 +- arch/hc/include/hcs12/irq.h | 36 +-- arch/mips/src/pic32mx/pic32mx.h | 251 +++++++++--------- arch/mips/src/pic32mx/pic32mx_config.h | 42 +-- .../src/pic32mz/hardware/pic32mz_features.h | 8 +- arch/mips/src/pic32mz/hardware/pic32mz_i2c.h | 34 +-- .../src/pic32mz/hardware/pic32mz_memorymap.h | 8 +- arch/mips/src/pic32mz/pic32mz_lowinit.h | 36 +-- arch/mips/src/pic32mz/pic32mz_usbdev.h | 58 ++-- 16 files changed, 350 insertions(+), 341 deletions(-) diff --git a/arch/avr/src/at32uc3/at32uc3_abdac.h b/arch/avr/src/at32uc3/at32uc3_abdac.h index e0f60e15254..b1b7e8e2a67 100644 --- a/arch/avr/src/at32uc3/at32uc3_abdac.h +++ b/arch/avr/src/at32uc3/at32uc3_abdac.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/at32uc3/at32uc3_abdac.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. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_AVR_SRC_AT32UC3_AT32UC3_ABDAC_H #define __ARCH_AVR_SRC_AT32UC3_AT32UC3_ABDAC_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/* Register offsets *****************************************************************/ +/* Register offsets *********************************************************/ #define AVR32_ABDAC_SDR_OFFSET 0x00 /* Sample Data Register */ #define AVR32_ABDAC_CR_OFFSET 0x08 /* Control Register */ @@ -41,7 +41,7 @@ #define AVR32_ABDAC_ICR_OFFSET 0x18 /* Interrupt Clear Register */ #define AVR32_ABDAC_ISR_OFFSET 0x1c /* Interrupt Status Register */ -/* Register Addresses ***************************************************************/ +/* Register Addresses *******************************************************/ #define AVR32_ABDAC_SDR (AVR32_ABDAC_BASE+AVR32_ABDAC_SDR_OFFSET) #define AVR32_ABDAC_CR (AVR32_ABDAC_BASE+AVR32_ABDAC_CR_OFFSET) @@ -51,7 +51,7 @@ #define AVR32_ABDAC_ICR (AVR32_ABDAC_BASE+AVR32_ABDAC_ICR_OFFSET) #define AVR32_ABDAC_ISR (AVR32_ABDAC_BASE+AVR32_ABDAC_ISR_OFFSET) -/* Register Bit-field Definitions ***************************************************/ +/* Register Bit-field Definitions *******************************************/ /* Sample Data Register Bit-field Definitions */ @@ -75,16 +75,16 @@ #define ABDAC_INT_UNDERRUN (1 << 28) /* Bit 28: Underrun Interrupt Status */ #define ABDAC_INT_TXREADY (1 << 29) /* Bit 29 TX Ready Interrupt Status */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_AT32UC3_AT32UC3_ABDAC_H */ diff --git a/arch/avr/src/at32uc3/at32uc3_flashc.h b/arch/avr/src/at32uc3/at32uc3_flashc.h index ec15095fe92..ae9f4b00702 100644 --- a/arch/avr/src/at32uc3/at32uc3_flashc.h +++ b/arch/avr/src/at32uc3/at32uc3_flashc.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/at32uc3/at32uc3_flashc.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. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_AVR_SRC_AT32UC3_AT32UC3_FLASHC_H #define __ARCH_AVR_SRC_AT32UC3_AT32UC3_FLASHC_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/* Register offsets *****************************************************************/ +/* Register offsets *********************************************************/ #define AVR32_FLASHC_FCR_OFFSET 0x00 /* Flash Control Register */ #define AVR32_FLASHC_FCMD_OFFSET 0x04 /* Flash Command Register */ @@ -39,7 +39,7 @@ #define AVR32_FLASHC_FGPFRHI_OFFSET 0x0c /* Flash General Purpose Fuse Register Hi */ #define AVR32_FLASHC_FGPFRLO_OFFSET 0x10 /* Flash General Purpose Fuse Register Lo */ -/* Register Addresses ***************************************************************/ +/* Register Addresses *******************************************************/ #define AVR32_FLASHC_FCR (AVR32_HFLASHC_BASE+AVR32_FLASHC_FCR_OFFSET) #define AVR32_FLASHC_FCMD (AVR32_HFLASHC_BASE+AVR32_FLASHC_FCMD_OFFSET) @@ -47,7 +47,7 @@ #define AVR32_FLASHC_FGPFRHI (AVR32_HFLASHC_BASE+AVR32_FLASHC_FGPFRHI_OFFSET) #define AVR32_FLASHC_FGPFRLO (AVR32_HFLASHC_BASE+AVR32_FLASHC_FGPFRLO_OFFSET) -/* Register Bit-field Definitions ***************************************************/ +/* Register Bit-field Definitions *******************************************/ /* Flash Control Register */ @@ -172,7 +172,7 @@ #define FLASHC_FGPFRLO30 (1 << 30) /* Bit 30: General Purpose Fuse 30 */ #define FLASHC_FGPFRLO31 (1 << 31) /* Bit 31: General Purpose Fuse 31 */ -/* Flash Command Set ****************************************************************/ +/* Flash Command Set ********************************************************/ #define FLASH_CMD_NOP 0 /* No operation */ #define FLASH_CMD_WP 1 /* Write Page */ @@ -191,23 +191,23 @@ #define FLASH_CMD_EUP 14 /* Erase User Page */ #define FLASH_CMD_QPRUP 15 /* Quick Page Read User Page */ -/* Other constants ******************************************************************/ +/* Other constants **********************************************************/ /* Maximum CPU frequency for 0 and 1 FLASH wait states */ #define AVR32_FLASHC_FWS0_MAXFREQ 33000000 #define AVR32_FLASHC_FWS1_MAXFREQ 66000000 -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_AT32UC3_AT32UC3_FLASHC_H */ diff --git a/arch/avr/src/at32uc3/at32uc3_intc.h b/arch/avr/src/at32uc3/at32uc3_intc.h index dfb2251c906..93ffa7896c5 100644 --- a/arch/avr/src/at32uc3/at32uc3_intc.h +++ b/arch/avr/src/at32uc3/at32uc3_intc.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/at32uc3/at32uc3_intc.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,34 +16,34 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_AVR_SRC_AT32UC3_AT32UC3_INTC_H #define __ARCH_AVR_SRC_AT32UC3_AT32UC3_INTC_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/* Register offsets *****************************************************************/ +/* Register offsets *********************************************************/ #define AVR32_INTC_IPR_OFFSET(n) ((n) << 2) /* Interrupt priority registers */ #define AVR32_INTC_IRR_OFFSET(n) (0x100 + ((n) << 2)) /* Interrupt request registers */ #define AVR32_INTC_ICR_OFFSET(n) (0x20c - ((n) << 2)) /* Interrupt cause registers */ -/* Register Addresses ***************************************************************/ +/* Register Addresses *******************************************************/ #define AVR32_INTC_IPR(n) (AVR32_INTC_BASE+AVR32_INTC_IPR_OFFSET(n)) #define AVR32_INTC_IRR(n) (AVR32_INTC_BASE+AVR32_INTC_IRR_OFFSET(n)) #define AVR32_INTC_ICR(n) (AVR32_INTC_BASE+AVR32_INTC_ICR_OFFSET(n)) -/* Register Bit-field Definitions ***************************************************/ +/* Register Bit-field Definitions *******************************************/ /* Interrupt priority register bit-field definitions */ @@ -67,16 +67,16 @@ #define INTC_ICR_CAUSE_SHIFT (0) /* Bits 0-5: Interrupt Group Causing Interrupt of Priority n */ #define INTC_ICR_CAUSE_MASK (0x3f << INTC_ICR_CAUSE_SHIFT) -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_AT32UC3_AT32UC3_INTC_H */ diff --git a/arch/avr/src/at32uc3/at32uc3_memorymap.h b/arch/avr/src/at32uc3/at32uc3_memorymap.h index 0b9dd7a2cc9..17327c89926 100644 --- a/arch/avr/src/at32uc3/at32uc3_memorymap.h +++ b/arch/avr/src/at32uc3/at32uc3_memorymap.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/at32uc3/at32uc3_memorymap.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_AVR_SRC_AT32UC3_AT32UC3_MEMORYMAP_H #define __ARCH_AVR_SRC_AT32UC3_AT32UC3_MEMORYMAP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ /* Physical memory map */ @@ -83,16 +83,16 @@ #define AVR32_ADC_BASE 0xffff3c00 /* Analog to Digital Converter */ #define AVR32_ABDAC_BASE 0xffff4000 /* Audio Bitstream DAC */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_AT32UC3_AT32UC3_MEMORYMAP_H */ diff --git a/arch/avr/src/at32uc3/at32uc3_pinmux.h b/arch/avr/src/at32uc3/at32uc3_pinmux.h index c7a04500eb8..836807cc9b0 100644 --- a/arch/avr/src/at32uc3/at32uc3_pinmux.h +++ b/arch/avr/src/at32uc3/at32uc3_pinmux.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/at32uc3/at32uc3_pinmux.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_AVR_SRC_AT32UC3_AT32UC3_PINMUX_H #define __ARCH_AVR_SRC_AT32UC3_AT32UC3_PINMUX_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include "chip.h" @@ -36,20 +36,20 @@ # error "Unknown AVR32 chip" #endif -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_AT32UC3_AT32UC3_PINMUX_H */ diff --git a/arch/avr/src/at90usb/at90usb_memorymap.h b/arch/avr/src/at90usb/at90usb_memorymap.h index 127b885628f..4871955888c 100644 --- a/arch/avr/src/at90usb/at90usb_memorymap.h +++ b/arch/avr/src/at90usb/at90usb_memorymap.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/at90usb/at90usb_memorymap.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,31 +16,31 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_AVR_SRC_AT90USB_AT90USB_MEMORYMAP_H #define __ARCH_AVR_SRC_AT90USB_AT90USB_MEMORYMAP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_AT90USB_AT90USB_MEMORYMAP_H */ diff --git a/arch/avr/src/at90usb/chip.h b/arch/avr/src/at90usb/chip.h index 0ac80a86ea6..b2fe25c05a3 100644 --- a/arch/avr/src/at90usb/chip.h +++ b/arch/avr/src/at90usb/chip.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/at90usb/chip.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,26 +16,26 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_AVR_SRC_AT90USB_CHIP_H #define __ARCH_AVR_SRC_AT90USB_CHIP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/* Include only the memory map. Other chip hardware files should then include this - * file for the proper setup +/* Include only the memory map. Other chip hardware files should then + * include this file for the proper setup */ #include "at90usb_memorymap.h" -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ /* Define features for supported chip in the ATMEGA family */ @@ -71,16 +71,16 @@ # error "Unsupported AVR chip" #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_AT90USB_CHIP_H */ diff --git a/arch/avr/src/atmega/atmega_memorymap.h b/arch/avr/src/atmega/atmega_memorymap.h index 90d20fca2a0..a8d663765a0 100644 --- a/arch/avr/src/atmega/atmega_memorymap.h +++ b/arch/avr/src/atmega/atmega_memorymap.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/avr/src/atmega/atmega_memorymap.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,31 +16,31 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_AVR_SRC_ATMEGA_ATMEGA_MEMORYMAP_H #define __ARCH_AVR_SRC_ATMEGA_ATMEGA_MEMORYMAP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_AVR_SRC_ATMEGA_ATMEGA_MEMORYMAP_H */ diff --git a/arch/hc/include/hcs12/irq.h b/arch/hc/include/hcs12/irq.h index 007108411ac..bf74aae9d20 100644 --- a/arch/hc/include/hcs12/irq.h +++ b/arch/hc/include/hcs12/irq.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/hc/include/hcs12/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_HC_INCLUDE_HCS12_IRQ_H #define __ARCH_HC_INCLUDE_HCS12_IRQ_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ /* CCR bit definitions */ @@ -47,7 +47,7 @@ #define HCS12_CCR_X (1 << 6) /* Bit 6: Non-maskable interrupt control bit */ #define HCS12_CCR_S (1 << 7) /* Bit 7: STOP instruction control bit */ -/************************************************************************************ +/**************************************************************************** * Register state save strucure * Low Address <-- SP after state save * [PPAGE] @@ -71,7 +71,7 @@ * PCH * High Address PCL <-- SP before interrupt * - ************************************************************************************/ + ****************************************************************************/ /* Byte offsets */ @@ -116,8 +116,8 @@ # define REG_SPH (REG_FIRST_HARDREG+8) # define REG_SPL (REG_FIRST_HARDREG+9) -/* On entry into an I- or X-interrupt, into an SWI, or into an undefined instruction - * interrupt, the stack frame created by hardware looks like: +/* On entry into an I- or X-interrupt, into an SWI, or into an undefined + * instruction interrupt, the stack frame created by hardware looks like: * * Low Address <-- SP after interrupt * CCR @@ -149,9 +149,9 @@ #define INTFRAME_SIZE 9 #define XCPTCONTEXT_REGS TOTALFRAME_SIZE -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ /* This structure defines the way the registers are stored. */ @@ -161,9 +161,9 @@ struct xcptcontext uint8_t regs[XCPTCONTEXT_REGS]; }; -/************************************************************************************ +/**************************************************************************** * Inline functions - ************************************************************************************/ + ****************************************************************************/ /* Name: up_irq_save, up_irq_restore, and friends. * @@ -234,9 +234,9 @@ static inline void system_call3(unsigned int nbr, uintptr_t parm1, /* __asm("swi") */ } -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" @@ -246,9 +246,9 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #undef EXTERN #ifdef __cplusplus diff --git a/arch/mips/src/pic32mx/pic32mx.h b/arch/mips/src/pic32mx/pic32mx.h index 34b977fb4fc..b28e987ef2a 100644 --- a/arch/mips/src/pic32mx/pic32mx.h +++ b/arch/mips/src/pic32mx/pic32mx.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/mips/src/pic32mx/pic32mx.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_MIPS_SRC_PIC32MX_PIC32MX_H #define __ARCH_MIPS_SRC_PIC32MX_PIC32MX_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include @@ -38,9 +38,9 @@ #include "chip.h" #include "pic32mx_config.h" -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ /* GPIO settings used in the configport, readport, writeport, etc. * @@ -107,9 +107,9 @@ #define GPIO_PIN14 (14 << GPIO_PIN_SHIFT) #define GPIO_PIN15 (15 << GPIO_PIN_SHIFT) -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ typedef void *DMA_HANDLE; typedef void (*dma_callback_t)(DMA_HANDLE handle, void *arg, int result); @@ -143,15 +143,15 @@ struct pic32mx_dmaregs_s }; #endif -/************************************************************************************ +/**************************************************************************** * Inline Functions - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #undef EXTERN #if defined(__cplusplus) @@ -162,29 +162,29 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_lowinit * * Description: * This performs basic low-level initialization of the system. * - ************************************************************************************/ + ****************************************************************************/ void pic32mx_lowinit(void); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_consoleinit * * Description: - * Performs low level initialization of the console UART. This UART done early so - * that the serial console is available for debugging very early in the boot - * sequence. + * Performs low level initialization of the console UART. + * This UART done early so that the serial console is available for + * debugging very early in the boot sequence. * - ************************************************************************************/ + ****************************************************************************/ #ifdef HAVE_SERIAL_CONSOLE void pic32mx_consoleinit(void); @@ -192,106 +192,107 @@ void pic32mx_consoleinit(void); # define pic32mx_consoleinit() #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_uartreset * * Description: * Reset a UART. * - ************************************************************************************/ + ****************************************************************************/ #ifdef HAVE_UART_DEVICE void pic32mx_uartreset(uintptr_t uart_base); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_uartconfigure * * Description: * Configure a UART as a RS-232 UART. * - ************************************************************************************/ + ****************************************************************************/ #ifdef HAVE_UART_DEVICE void pic32mx_uartconfigure(uintptr_t uart_base, uint32_t baudrate, - unsigned int parity, unsigned int nbits, bool stop2); + unsigned int parity, unsigned int nbits, + bool stop2); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_boardinitialize * * Description: - * This function must be provided by the board-specific logic in the directory - * boards/mips/pic32mx//src/pic32mx_boot.c. + * This function must be provided by the board-specific logic in the + * directory boards/mips/pic32mx//src/pic32mx_boot.c. * - ************************************************************************************/ + ****************************************************************************/ void pic32mx_boardinitialize(void); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_decodeirq * * Description: - * Called from assembly language logic when an interrupt exception occurs. This - * function decodes and dispatches the interrupt. + * Called from assembly language logic when an interrupt exception occurs. + * This function decodes and dispatches the interrupt. * - ************************************************************************************/ + ****************************************************************************/ uint32_t *pic32mx_decodeirq(uint32_t *regs); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_exception * * Description: * Called from assembly language logic on all other exceptions. * - ************************************************************************************/ + ****************************************************************************/ uint32_t *pic32mx_exception(uint32_t *regs); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_configgpio * * Description: - * Configure a GPIO pin based on bit-encoded description of the pin (the interrupt - * will be configured when pic32mx_attach() is called). + * Configure a GPIO pin based on bit-encoded description of the pin + * (the interrupt will be configured when pic32mx_attach() is called). * * Returned Value: * OK on success; negated errno on failure. * - ************************************************************************************/ + ****************************************************************************/ int pic32mx_configgpio(uint16_t cfgset); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_gpiowrite * * Description: * Write one or zero to the selected GPIO pin * - ************************************************************************************/ + ****************************************************************************/ void pic32mx_gpiowrite(uint16_t pinset, bool value); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_gpioread * * Description: * Read one or zero from the selected GPIO pin * - ************************************************************************************/ + ****************************************************************************/ bool pic32mx_gpioread(uint16_t pinset); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_gpioirqinitialize * * Description: - * Initialize logic to support a GPIO change notification interrupts. This - * function is called internally by the system on power up and should not be - * called again. + * Initialize logic to support a GPIO change notification interrupts. + * This function is called internally by the system on power up and + * should not be called again. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_GPIOIRQ void pic32mx_gpioirqinitialize(void); @@ -299,18 +300,19 @@ void pic32mx_gpioirqinitialize(void); # define pic32mx_gpioirqinitialize() #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_gpioattach * * Description: - * Attach an interrupt service routine to a GPIO interrupt. This will also - * reconfigure the pin as an interrupting input. The change notification number is - * associated with all interrupt-capable GPIO pins. The association could, - * however, differ from part to part and must be provided by the caller. + * Attach an interrupt service routine to a GPIO interrupt. + * This will also reconfigure the pin as an interrupting input. + * The change notification number is associated with all + * interrupt-capable GPIO pins. The association could, however, differ + * from part to part and must be provided by the caller. * - * When an interrupt occurs, it is due to a change on the GPIO input pin. In that - * case, all attached handlers will be called. Each handler must maintain state - * and determine if the underlying GPIO input value changed. + * When an interrupt occurs, it is due to a change on the GPIO input pin. + * In that case, all attached handlers will be called. Each handler must + * maintain stateand determine if the underlying GPIO input value changed. * * Input Parameters: * pinset - GPIO pin configuration @@ -322,7 +324,7 @@ void pic32mx_gpioirqinitialize(void); * Zero (OK) is returned on success. A negated error value is returned on * any failure to indicate the nature of the failure. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_GPIOIRQ int pic32mx_gpioattach(uint32_t pinset, unsigned int cn, xcpt_t handler, @@ -331,13 +333,13 @@ int pic32mx_gpioattach(uint32_t pinset, unsigned int cn, xcpt_t handler, # define pic32mx_gpioattach(p,c,h,a) (0) #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_gpioirqenable * * Description: * Enable the interrupt for specified GPIO IRQ * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_GPIOIRQ void pic32mx_gpioirqenable(unsigned int cn); @@ -345,13 +347,13 @@ void pic32mx_gpioirqenable(unsigned int cn); # define pic32mx_gpioirqenable(irq) #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_gpioirqdisable * * Description: * Disable the interrupt for specified GPIO IRQ * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_GPIOIRQ void pic32mx_gpioirqdisable(unsigned int cn); @@ -359,13 +361,13 @@ void pic32mx_gpioirqdisable(unsigned int cn); # define pic32mx_gpioirqdisable(irq) #endif -/************************************************************************************ +/**************************************************************************** * Function: pic32mx_dumpgpio * * Description: * Dump all GPIO registers associated with the provided base address * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_DEBUG_GPIO_INFO void pic32mx_dumpgpio(uint32_t pinset, const char *msg); @@ -373,7 +375,7 @@ void pic32mx_dumpgpio(uint32_t pinset, const char *msg); # define pic32mx_dumpgpio(p,m) #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_spibus_initialize * * Description: @@ -385,38 +387,40 @@ void pic32mx_dumpgpio(uint32_t pinset, const char *msg); * Returned Value: * Valid SPI device structure reference on success; a NULL on failure * - ************************************************************************************/ + ****************************************************************************/ struct spi_dev_s; /* Forward reference */ struct spi_dev_s *pic32mx_spibus_initialize(int port); -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_spiNselect, pic32mx_spiNstatus, and pic32mx_spiNcmddata * * Description: - * These external functions must be provided by board-specific logic. They are - * implementations of the select, status, and cmddata methods of the SPI interface - * defined by struct spi_ops_s (see include/nuttx/spi/spi.h). All other methods - * including pic32mx_spibus_initialize()) are provided by common PIC32MX logic. + * These external functions must be provided by board-specific logic. + * They are implementations of the select, status and cmddata methods + * of the SPI interface defined by struct spi_ops_s + * (see include/nuttx/spi/spi.h). All other methods including + * pic32mx_spibus_initialize()) are provided by common PIC32MX logic. * To use this common SPI logic on your board: * - * 1. Provide logic in pic32mx_boardinitialize() to configure SPI/SSP chip select - * pins. + * 1. Provide logic in pic32mx_boardinitialize() to configure SPI/SSP chip + * select pins. * 2. Provide pic32mx_spiNselect() and pic32mx_spiNstatus() functions - * in your board-specific logic. These functions will perform chip selection - * and status operations using GPIOs in the way your board is configured. + * in your board-specific logic. These functions will perform + * chip selection and status operations using GPIOs in the way + * your board is configured. * 2. If CONFIG_SPI_CMDDATA is defined in the NuttX configuration, provide * pic32mx_spiNcmddata() functions in your board-specific logic. These - * functions will perform cmd/data selection operations using GPIOs in the way - * your board is configured. - * 3. Add a call to pic32mx_spibus_initialize() in your low level application - * initialization logic - * 4. The handle returned by pic32mx_spibus_initialize() may then be used to bind - * the SPI driver to higher level logic (e.g., calling + * functions will perform cmd/data selection operations using + * GPIOs in the way your board is configured. + * 3. Add a call to pic32mx_spibus_initialize() in your low level + * application initialization logic. + * 4. The handle returned by pic32mx_spibus_initialize() may then be used + * to bind the SPI driver to higher level logic (e.g., calling * mmcsd_spislotinitialize(), for example, will bind the SPI driver to * the SPI MMC/SD driver). * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_SPI1 void pic32mx_spi1select(struct spi_dev_s *dev, uint32_t devid, @@ -454,7 +458,7 @@ int pic32mx_spi3cmddata(struct spi_dev_s *dev, uint32_t devid, bool cmd); #endif #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmainitialize * * Description: @@ -463,92 +467,94 @@ int pic32mx_spi3cmddata(struct spi_dev_s *dev, uint32_t devid, bool cmd); * Returned Value: * None * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA void pic32mx_dmainitilaize(void); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmachannel * * Description: - * Allocate a DMA channel. This function sets aside a DMA channel and gives the - * caller exclusive access to the DMA channel. + * Allocate a DMA channel. This function sets aside a DMA channel and + * gives the caller exclusive access to the DMA channel. * * Returned Value: * On success, this function returns a non-NULL, void* DMA channel handle. * NULL is returned on any failure. This function can fail only if no DMA * channel is available. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA DMA_HANDLE pic32mx_dmachannel(void); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmafree * * Description: - * Release a DMA channel. NOTE: The 'handle' used in this argument must NEVER be - * used again until pic32mx_dmachannel() is called again to re-gain a valid handle. + * Release a DMA channel. + * NOTE: + * The 'handle' used in this argument must NEVER beused again until + * pic32mx_dmachannel() is called again to re-gain a valid handle. * * Returned Value: * None * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA void pic32mx_dmafree(DMA_HANDLE handle); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmasetup * * Description: * Configure DMA for one transfer. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA int pic32mx_dmarxsetup(DMA_HANDLE handle, uint32_t control, uint32_t config, uint32_t srcaddr, uint32_t destaddr, size_t nbytes); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmastart * * Description: * Start the DMA transfer * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA int pic32mx_dmastart(DMA_HANDLE handle, dma_callback_t callback, void *arg); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmastop * * Description: - * Cancel the DMA. After pic32mx_dmastop() is called, the DMA channel is reset - * and pic32mx_dmasetup() must be called before pic32mx_dmastart() can be called - * again + * Cancel the DMA. After pic32mx_dmastop() is called, the DMA channel + * is reset and pic32mx_dmasetup() must be called before pic32mx_dmastart() + * can be called again * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA void pic32mx_dmastop(DMA_HANDLE handle); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmasample * * Description: * Sample DMA register contents * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA #ifdef CONFIG_DEBUG_DMA @@ -558,13 +564,13 @@ void pic32mx_dmasample(DMA_HANDLE handle, struct pic32mx_dmaregs_s *regs); #endif #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_dmadump * * Description: * Dump previously sampled DMA register contents * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_DMA #ifdef CONFIG_DEBUG_DMA @@ -575,47 +581,48 @@ void pic32mx_dmadump(DMA_HANDLE handle, const struct pic32mx_dmaregs_s *regs, #endif #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_usbpullup * * Description: - * If USB is supported and the board supports a pullup via GPIO (for USB software - * connect and disconnect), then the board software must provide pic32mx_usbpullup. - * See include/nuttx/usb/usbdev.h for additional description of this method. - * Alternatively, if no pull-up GPIO the following can be redefined to be - * NULL. + * If USB is supported and the board supports a pullup via GPIO + * (for USB softwareconnect and disconnect), + * then the board software must provide pic32mx_usbpullup. + * See include/nuttx/usb/usbdev.h for additional description of this + * method. Alternatively, if no pull-up GPIO the following can be + * redefined to be NULL. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_USBDEV struct usbdev_s; int pic32mx_usbpullup(struct usbdev_s *dev, bool enable); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_usbsuspend * * Description: - * Board logic must provide the pic32mx_usbsuspend logic if the USBDEV driver is - * used. This function is called whenever the USB enters or leaves suspend mode. - * This is an opportunity for the board logic to shutdown clocks, power, etc. while - * the USB is suspended. + * Board logic must provide the pic32mx_usbsuspend logic if the + * USBDEV driver is used. This function is called whenever the USB enters + * or leaves suspend mode. This is an opportunity for the board logic + * to shutdown clocks, power, etc. while the USB is suspended. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_USBDEV void pic32mx_usbsuspend(struct usbdev_s *dev, bool resume); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mx_usbattach and pic32mx_usbdetach * * Description: - * The USB stack must be notified when the device is attached or detached by - * calling one of these functions. + * The USB stack must be notified when the device is attached or + * detached by calling one of these functions. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MX_USBDEV void pic32mx_usbattach(void); diff --git a/arch/mips/src/pic32mx/pic32mx_config.h b/arch/mips/src/pic32mx/pic32mx_config.h index 13985138ac1..f8829cacd98 100644 --- a/arch/mips/src/pic32mx/pic32mx_config.h +++ b/arch/mips/src/pic32mx/pic32mx_config.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/mips/src/pic32mx/pic32mx_config.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_MIPS_SRC_PIC32MX_PIC32MX_CONFIG_H #define __ARCH_MIPS_SRC_PIC32MX_PIC32MX_CONFIG_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include @@ -34,11 +34,11 @@ #include "pic32mx_int.h" #include "pic32mx_devcfg.h" -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/* Interrupt Priorities *************************************************************/ +/* Interrupt Priorities *****************************************************/ #ifndef CONFIG_PIC32MX_CTPRIO /* Core Timer Interrupt */ # define CONFIG_PIC32MX_CTPRIO (INT_IPC_MID_PRIORITY << 2) @@ -470,7 +470,7 @@ # error "CONFIG_PIC32MX_USBPRIO is too large" #endif -/* UARTs ****************************************************************************/ +/* UARTs ********************************************************************/ /* Don't enable UARTs not supported by the chip. */ @@ -512,8 +512,8 @@ # define HAVE_UART_DEVICE 1 #endif -/* Is there a serial console? There should be no more than one defined. It - * could be on any UARTn, n=1,.. CHIP_NUARTS +/* Is there a serial console? There should be no more than one defined. + * It could be on any UARTn, n=1,.. CHIP_NUARTS */ #if defined(CONFIG_UART1_SERIAL_CONSOLE) && defined(CONFIG_PIC32MX_UART1) @@ -568,7 +568,7 @@ # undef HAVE_SERIAL_CONSOLE #endif -/* Device Configuration *************************************************************/ +/* Device Configuration *****************************************************/ /* DEVCFG3 */ @@ -588,7 +588,9 @@ # define CONFIG_PIC32MX_SRSSEL INT_IPC_MIN_PRIORITY #endif -/* Unless overridden in the .config file, all pins are in the default setting */ +/* Unless overridden in the .config file, + * all pins are in the default setting. + */ #ifndef CONFIG_PIC32MX_FMIIEN /* Ethernet MII enable: 0=RMII 1=MII */ # define CONFIG_PIC32MX_FMIIEN 1 /* MII enabled */ @@ -876,20 +878,20 @@ # define CONFIG_PIC32MX_CODEWP 1 /* Disabled */ #endif -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Inline Functions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Functions Prototypes - ************************************************************************************/ + ****************************************************************************/ #endif /* __ARCH_MIPS_SRC_PIC32MX_PIC32MX_CONFIG_H */ diff --git a/arch/mips/src/pic32mz/hardware/pic32mz_features.h b/arch/mips/src/pic32mz/hardware/pic32mz_features.h index a04f1273ced..e836eabfd7b 100644 --- a/arch/mips/src/pic32mz/hardware/pic32mz_features.h +++ b/arch/mips/src/pic32mz/hardware/pic32mz_features.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/mips/src/pic32mz/hardware/pic32mz_features.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_MIPS_SRC_PIC32MZ_HARDWARE_PIC32MZ_FEATURES_H #define __ARCH_MIPS_SRC_PIC32MZ_HARDWARE_PIC32MZ_FEATURES_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include diff --git a/arch/mips/src/pic32mz/hardware/pic32mz_i2c.h b/arch/mips/src/pic32mz/hardware/pic32mz_i2c.h index 96eabcd2238..f99bf0e4963 100644 --- a/arch/mips/src/pic32mz/hardware/pic32mz_i2c.h +++ b/arch/mips/src/pic32mz/hardware/pic32mz_i2c.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/mips/src/pic32mz/hardware/pic32mz_i2c.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_MIPS_SRC_PIC32MZ_HARDWARE_PIC32MZ_I2C_H #define __ARCH_MIPS_SRC_PIC32MZ_HARDWARE_PIC32MZ_I2C_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include @@ -32,11 +32,11 @@ #if CHIP_NI2C > 0 -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/* I2C Peripheral Offsets ***********************************************************/ +/* I2C Peripheral Offsets ***************************************************/ #define PIC32MZ_I2Cn_OFFSET(n) ((n) << 9) # define PIC32MZ_I2C1_OFFSET 0x0000 @@ -45,7 +45,7 @@ # define PIC32MZ_I2C4_OFFSET 0x0600 # define PIC32MZ_I2C5_OFFSET 0x0800 -/* I2C Register Offsets *************************************************************/ +/* I2C Register Offsets *****************************************************/ #define PIC32MZ_I2C_CON_OFFSET 0x0000 /* I2C control register */ #define PIC32MZ_I2C_CONCLR_OFFSET 0x0004 /* I2C control clear register */ @@ -79,7 +79,7 @@ #define PIC32MZ_I2C_RCV_OFFSET 0x0060 /* I2C receive buffer register */ -/* I2C Peripheral Addresses *********************************************************/ +/* I2C Peripheral Addresses *************************************************/ #define PIC32MZ_I2Cn_K1BASE(n) (PIC32MZ_I2C_K1BASE+PIC32MZ_I2Cn_OFFSET(n)) # define PIC32MZ_I2C1_K1BASE (PIC32MZ_I2C_K1BASE+PIC32MZ_I2C1_OFFSET) @@ -88,7 +88,7 @@ # define PIC32MZ_I2C4_K1BASE (PIC32MZ_I2C_K1BASE+PIC32MZ_I2C4_OFFSET) # define PIC32MZ_I2C5_K1BASE (PIC32MZ_I2C_K1BASE+PIC32MZ_I2C5_OFFSET) -/* I2C Register Addresses ***********************************************************/ +/* I2C Register Addresses ***************************************************/ # define PIC32MZ_I2C1_CON (PIC32MZ_I2C1_K1BASE+PIC32MZ_I2C_CON_OFFSET) # define PIC32MZ_I2C1_CONCLR (PIC32MZ_I2C1_K1BASE+PIC32MZ_I2C_CONCLR_OFFSET) @@ -259,7 +259,7 @@ # define PIC32MZ_I2C5_RCV (PIC32MZ_I2C5_K1BASE+PIC32MZ_I2C_RCV_OFFSET) #endif -/* Register Bit-Field Definitions ***************************************************/ +/* Register Bit-Field Definitions *******************************************/ /* I2C control register */ @@ -328,19 +328,19 @@ #define I2C_RCV_MASK 0x000000ff /* 8-bit receive data */ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/************************************************************************************ +/**************************************************************************** * Inline Functions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ #ifdef __cplusplus #define EXTERN extern "C" diff --git a/arch/mips/src/pic32mz/hardware/pic32mz_memorymap.h b/arch/mips/src/pic32mz/hardware/pic32mz_memorymap.h index 8570bf4d034..a235a38cabd 100644 --- a/arch/mips/src/pic32mz/hardware/pic32mz_memorymap.h +++ b/arch/mips/src/pic32mz/hardware/pic32mz_memorymap.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/mips/src/pic32mz/hardware/pic32mz_memorymap.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_MIPS_SRC_PIC32MZ_HARDWARE_PIC32MZ_MEMORYMAP_H #define __ARCH_MIPS_SRC_PIC32MZ_HARDWARE_PIC32MZ_MEMORYMAP_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include diff --git a/arch/mips/src/pic32mz/pic32mz_lowinit.h b/arch/mips/src/pic32mz/pic32mz_lowinit.h index f9ea0e45a92..58cdaa662fc 100644 --- a/arch/mips/src/pic32mz/pic32mz_lowinit.h +++ b/arch/mips/src/pic32mz/pic32mz_lowinit.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/mips/src/pic32mz/pic32mz_lowinit.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,33 +16,33 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_MIPS_SRC_PIC32MZ_PIC32MZ_LOWINIT_H #define __ARCH_MIPS_SRC_PIC32MZ_PIC32MZ_LOWINIT_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #undef EXTERN #if defined(__cplusplus) @@ -53,28 +53,28 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Name: pic32mz_lowinit * * Description: * This performs basic low-level initialization of the system. * - ************************************************************************************/ + ****************************************************************************/ void pic32mz_lowinit(void); -/************************************************************************************ +/**************************************************************************** * Name: pic32mz_boardinitialize * * Description: - * This function must be provided by the board-specific logic in the directory - * boards/mips/pic32mz//src/pic32mz_boot.c. + * This function must be provided by the board-specific logic in the + * directory boards/mips/pic32mz//src/pic32mz_boot.c. * - ************************************************************************************/ + ****************************************************************************/ void pic32mz_boardinitialize(void); diff --git a/arch/mips/src/pic32mz/pic32mz_usbdev.h b/arch/mips/src/pic32mz/pic32mz_usbdev.h index 4e42b90b6e9..75b1ce792d9 100644 --- a/arch/mips/src/pic32mz/pic32mz_usbdev.h +++ b/arch/mips/src/pic32mz/pic32mz_usbdev.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/mips/src/pic32mz/pic32mz_usbdev.h * * Licensed to the Apache Software Foundation (ASF) under one or more @@ -16,33 +16,33 @@ * License for the specific language governing permissions and limitations * under the License. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_MIPS_SRC_PIC32MZ_PIC32MZ_USBDEV_H #define __ARCH_MIPS_SRC_PIC32MZ_PIC32MZ_USBDEV_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include #include #include -/************************************************************************************ +/**************************************************************************** * Pre-processor Definitions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Public Types - ************************************************************************************/ + ****************************************************************************/ #ifndef __ASSEMBLY__ -/************************************************************************************ +/**************************************************************************** * Public Data - ************************************************************************************/ + ****************************************************************************/ #undef EXTERN #if defined(__cplusplus) @@ -53,51 +53,51 @@ extern "C" #define EXTERN extern #endif -/************************************************************************************ +/**************************************************************************** * Public Function Prototypes - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Name: pic32mz_usbpullup * * Description: - * If USB is supported and the board supports a pullup via GPIO (for USB software - * connect and disconnect), then the board software must provide pic32mz_usbpullup. - * See include/nuttx/usb/usbdev.h for additional description of this method. - * Alternatively, if no pull-up GPIO the following can be redefined to be - * NULL. + * If USB is supported and the board supports a pullup via GPIO + * (for USB software connect and disconnect), then the board software must + * provide pic32mz_usbpullup. See include/nuttx/usb/usbdev.h for + * additional description of this method. Alternatively, + * if no pull-up GPIO the following can be redefined to be NULL. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MZ_USBDEV struct usbdev_s; int pic32mz_usbpullup(struct usbdev_s *dev, bool enable); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mz_usbsuspend * * Description: - * Board logic must provide the pic32mz_usbsuspend logic if the USBDEV driver is - * used. This function is called whenever the USB enters or leaves suspend mode. - * This is an opportunity for the board logic to shutdown clocks, power, etc. while - * the USB is suspended. + * Board logic must provide the pic32mz_usbsuspend logic if the USBDEV + * driver is used. This function is called whenever the USB enters or + * leaves suspend mode. This is an opportunity for the board logic to + * shutdown clocks, power, etc. while the USB is suspended. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MZ_USBDEV void pic32mz_usbsuspend(struct usbdev_s *dev, bool resume); #endif -/************************************************************************************ +/**************************************************************************** * Name: pic32mz_usbattach and pic32mz_usbdetach * * Description: - * The USB stack must be notified when the device is attached or detached by - * calling one of these functions. + * The USB stack must be notified when the device is attached or + * detached by calling one of these functions. * - ************************************************************************************/ + ****************************************************************************/ #ifdef CONFIG_PIC32MZ_USBDEV void pic32mz_usbattach(void);