diff --git a/arch/arm/src/stm32/stm32_otghs.h b/arch/arm/src/stm32/stm32_otghs.h index b0ecae8420..c18847debb 100644 --- a/arch/arm/src/stm32/stm32_otghs.h +++ b/arch/arm/src/stm32/stm32_otghs.h @@ -1,4 +1,4 @@ -/************************************************************************************ +/**************************************************************************** * arch/arm/src/stm32/stm32_otghs.h * * Copyright (C) 2012-2013 Gregory Nutt. All rights reserved. @@ -31,14 +31,14 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ #ifndef __ARCH_ARM_SRC_STM32_STM32_OTGHS_H #define __ARCH_ARM_SRC_STM32_STM32_OTGHS_H -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include @@ -49,9 +49,9 @@ #if defined(CONFIG_STM32_OTGHS) -/************************************************************************************ - * Public Functions - ************************************************************************************/ +/**************************************************************************** + * Public Function Prototypes + ****************************************************************************/ #ifndef __ASSEMBLY__ @@ -71,9 +71,9 @@ extern "C" * Initialize USB host device controller hardware. * * Input Parameters: - * controller -- If the device supports more than USB host controller, then - * this identifies which controller is being initializeed. Normally, this - * is just zero. + * controller -- If the device supports more than USB host controller, + * then this identifies which controller is being initializeed. + * Normally, this is just zero. * * Returned Value: * And instance of the USB host interface. The controlling task should @@ -82,10 +82,11 @@ extern "C" * to a class driver. * * Assumptions: - * - This function should called in the initialization sequence in order - * to initialize the USB device functionality. + * - This function should called in the initialization sequence in order to + * initialize the USB device functionality. * - Class drivers should be initialized prior to calling this function. - * Otherwise, there is a race condition if the device is already connected. + * Otherwise, there is a race condition if the device is already + * connected. * ****************************************************************************/ @@ -94,16 +95,16 @@ struct usbhost_connection_s; FAR struct usbhost_connection_s *stm32_otghshost_initialize(int controller); #endif -/************************************************************************************ +/**************************************************************************** * Name: stm32_usbsuspend * * Description: - * Board logic must provide the stm32_usbsuspend logic if the OTG FS device 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 stm32_usbsuspend logic if the OTG FS + * device 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. * - ************************************************************************************/ + ****************************************************************************/ void stm32_usbsuspend(FAR struct usbdev_s *dev, bool resume);