diff --git a/arch/sim/src/sim/up_head.c b/arch/sim/src/sim/up_head.c index 8d9d0acc7b..050ae21c5b 100644 --- a/arch/sim/src/sim/up_head.c +++ b/arch/sim/src/sim/up_head.c @@ -1,7 +1,8 @@ /**************************************************************************** * arch/sim/src/sim/up_head.c * - * Copyright (C) 2007-2009, 2011-2013, 2016 Gregory Nutt. All rights reserved. + * Copyright (C) 2007-2009, 2011-2013, 2016 Gregory Nutt. All rights + * reserved. * Author: Gregory Nutt * * Redistribution and use in source and binary forms, with or without diff --git a/drivers/power/pm_activity.c b/drivers/power/pm_activity.c index 9e2f2a0512..64be1f597b 100644 --- a/drivers/power/pm_activity.c +++ b/drivers/power/pm_activity.c @@ -117,10 +117,10 @@ void pm_activity(int domain, int priority) /* Check the elapsed time. In periods of low activity, time slicing is * controlled by IDLE loop polling; in periods of higher activity, time - * slicing is controlled by driver activity. In either case, the duration - * of the time slice is only approximate; during times of heavy activity, - * time slices may be become longer and the activity level may be over- - * estimated. + * slicing is controlled by driver activity. In either case, the + * duration of the time slice is only approximate; during times of + * heavy activity, time slices may be become longer and the activity + * level may be over-estimated. */ now = clock_systimer(); diff --git a/drivers/serial/serial_io.c b/drivers/serial/serial_io.c index 99d4629669..4aded08a5e 100644 --- a/drivers/serial/serial_io.c +++ b/drivers/serial/serial_io.c @@ -1,7 +1,8 @@ -/************************************************************************************ +/**************************************************************************** * drivers/serial/serial_io.c * - * Copyright (C) 2007-2009, 2011, 2015, 2018 Gregory Nutt. All rights reserved. + * Copyright (C) 2007-2009, 2011, 2015, 2018 Gregory Nutt. All rights + * reserved. * Author: Gregory Nutt * * Redistribution and use in source and binary forms, with or without @@ -31,11 +32,11 @@ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Included Files - ************************************************************************************/ + ****************************************************************************/ #include @@ -51,20 +52,21 @@ #include -/************************************************************************************ +/**************************************************************************** * Public Functions - ************************************************************************************/ + ****************************************************************************/ -/************************************************************************************ +/**************************************************************************** * Name: uart_xmitchars * * Description: - * This function is called from the UART interrupt handler when an interrupt - * is received indicating that there is more space in the transmit FIFO. This - * function will send characters from the tail of the xmit buffer while the driver - * write() logic adds data to the head of the xmit buffer. + * This function is called from the UART interrupt handler when an + * interrupt is received indicating that there is more space in the + * transmit FIFO. This function will send characters from the tail of + * the xmit buffer while the driver write() logic adds data to the head + * of the xmit buffer. * - ************************************************************************************/ + ****************************************************************************/ void uart_xmitchars(FAR uart_dev_t *dev) { @@ -105,8 +107,8 @@ void uart_xmitchars(FAR uart_dev_t *dev) uart_disabletxint(dev); } - /* If any bytes were removed from the buffer, inform any waiters there there is - * space available. + /* If any bytes were removed from the buffer, inform any waiters that + * there is space available. */ if (nbytes) @@ -119,16 +121,16 @@ void uart_xmitchars(FAR uart_dev_t *dev) #endif } -/************************************************************************************ +/**************************************************************************** * Name: uart_receivechars * * Description: - * This function is called from the UART interrupt handler when an interrupt - * is received indicating that are bytes available in the receive fifo. This - * function will add chars to head of receive buffer. Driver read() logic will - * take characters from the tail of the buffer. + * This function is called from the UART interrupt handler when an + * interrupt is received indicating that are bytes available in the + * receive fifo. This function will add chars to head of receive buffer. + * Driver read() logic will take characters from the tail of the buffer. * - ************************************************************************************/ + ****************************************************************************/ void uart_recvchars(FAR uart_dev_t *dev) { @@ -151,11 +153,12 @@ void uart_recvchars(FAR uart_dev_t *dev) #ifdef CONFIG_SERIAL_IFLOWCONTROL_WATERMARKS /* Pre-calculate the watermark level that we will need to test against. */ - watermark = (CONFIG_SERIAL_IFLOWCONTROL_UPPER_WATERMARK * rxbuf->size) / 100; + watermark = (CONFIG_SERIAL_IFLOWCONTROL_UPPER_WATERMARK * rxbuf->size) / + 100; #endif - /* Loop putting characters into the receive buffer until there are no further - * characters to available. + /* Loop putting characters into the receive buffer until there are no + * further characters to available. */ while (uart_rxavailable(dev)) @@ -248,12 +251,13 @@ void uart_recvchars(FAR uart_dev_t *dev) else #endif - /* If the RX buffer becomes full, then the serial data is discarded. This is - * necessary because on most serial hardware, you must read the data in order - * to clear the RX interrupt. An option on some hardware might be to simply - * disable RX interrupts until the RX buffer becomes non-FULL. However, that - * would probably just cause the overrun to occur in hardware (unless it has - * some large internal buffering). + /* If the RX buffer becomes full, then the serial data is discarded. + * This is necessary because on most serial hardware, you must read + * the data in order to clear the RX interrupt. An option on some + * hardware might be to simply disable RX interrupts until the RX + * buffer becomes non-FULL. However, that would probably just cause + * the overrun to occur in hardware (unless it has some large internal + * buffering). */ if (!is_full) diff --git a/include/nuttx/power/pm.h b/include/nuttx/power/pm.h index dc670d7f04..16b6390fb2 100644 --- a/include/nuttx/power/pm.h +++ b/include/nuttx/power/pm.h @@ -33,6 +33,7 @@ * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ + /* Definition of terms. Various "sleep" and low power consumption states * have various names and are sometimes used in conflicting ways. In the * PM logic, we will use the following terminology: @@ -77,7 +78,9 @@ /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ + /* Configuration ************************************************************/ + /* CONFIG_PM_NDOMAINS. Defines the number of "domains" that activity may be * monitored on. For example, you may want to separately manage the power * from the Network domain, shutting down the network when it is not be used, @@ -238,7 +241,8 @@ enum pm_state_e { PM_RESTORE = -1, /* PM_RESTORE is not a low power state. * - * PM_RESTORE is used to notify for restore from low power state. + * PM_RESTORE is used to notify for restore from low power + * state. */ PM_NORMAL = 0, /* Normal full power operating mode. If the driver is in * a reduced power usage mode, it should immediately re- @@ -248,9 +252,9 @@ enum pm_state_e */ PM_IDLE, /* Drivers will receive this state change if it is * appropriate to enter a simple IDLE power state. This - * would include simple things such as reducing display back- - * lighting. The driver should be ready to resume normal - * activity instantly. + * would include simple things such as reducing display + * back-lighting. The driver should be ready to resume + * normal activity instantly. * * PM_IDLE may be followed by PM_STANDBY or PM_NORMAL. */ @@ -263,11 +267,11 @@ enum pm_state_e * * PM_STANDBY may be followed PM_SLEEP or by PM_NORMAL */ - PM_SLEEP, /* The system is entering deep sleep mode. The most drastic - * power reduction measures possible should be taken in this - * state. It may require some time to get back to normal - * operation from SLEEP (some MCUs may even require going - * through reset). + PM_SLEEP, /* The system is entering deep sleep mode. The most + * drastic power reduction measures possible should be + * taken in this state. It may require some time to get + * back to normal operation from SLEEP (some MCUs may + * even require going through reset). * * PM_SLEEP may be following by PM_NORMAL */ diff --git a/include/sys/boardctl.h b/include/sys/boardctl.h index 37af1f4bb0..24827c0ee3 100644 --- a/include/sys/boardctl.h +++ b/include/sys/boardctl.h @@ -398,8 +398,8 @@ struct boardioc_nxterm_create_s struct boardioc_nxterm_ioctl_s { - int cmd; /* IOCTL command */ - uintptr_t arg; /* IOCTL argument */ + int cmd; /* IOCTL command */ + uintptr_t arg; /* IOCTL argument */ }; #endif /* CONFIG_NXTERM */