Commit 38beaec6 authored by John Youn's avatar John Youn Committed by Felipe Balbi

usb: dwc2: Fix comment alignment and format

Fix misaligned and over 80-character comments.
Signed-off-by: default avatarJohn Youn <johnyoun@synopsys.com>
Signed-off-by: default avatarFelipe Balbi <felipe.balbi@linux.intel.com>
parent 3b1920e7
...@@ -603,8 +603,8 @@ struct dwc2_hw_params { ...@@ -603,8 +603,8 @@ struct dwc2_hw_params {
#define DWC2_CTRL_BUFF_SIZE 8 #define DWC2_CTRL_BUFF_SIZE 8
/** /**
* struct dwc2_gregs_backup - Holds global registers state before entering partial * struct dwc2_gregs_backup - Holds global registers state before
* power down * entering partial power down
* @gotgctl: Backup of GOTGCTL register * @gotgctl: Backup of GOTGCTL register
* @gintmsk: Backup of GINTMSK register * @gintmsk: Backup of GINTMSK register
* @gahbcfg: Backup of GAHBCFG register * @gahbcfg: Backup of GAHBCFG register
...@@ -634,8 +634,8 @@ struct dwc2_gregs_backup { ...@@ -634,8 +634,8 @@ struct dwc2_gregs_backup {
}; };
/** /**
* struct dwc2_dregs_backup - Holds device registers state before entering partial * struct dwc2_dregs_backup - Holds device registers state before
* power down * entering partial power down
* @dcfg: Backup of DCFG register * @dcfg: Backup of DCFG register
* @dctl: Backup of DCTL register * @dctl: Backup of DCTL register
* @daintmsk: Backup of DAINTMSK register * @daintmsk: Backup of DAINTMSK register
...@@ -664,8 +664,8 @@ struct dwc2_dregs_backup { ...@@ -664,8 +664,8 @@ struct dwc2_dregs_backup {
}; };
/** /**
* struct dwc2_hregs_backup - Holds host registers state before entering partial * struct dwc2_hregs_backup - Holds host registers state before
* power down * entering partial power down
* @hcfg: Backup of HCFG register * @hcfg: Backup of HCFG register
* @haintmsk: Backup of HAINTMSK register * @haintmsk: Backup of HAINTMSK register
* @hcintmsk: Backup of HCINTMSK register * @hcintmsk: Backup of HCINTMSK register
...@@ -782,9 +782,10 @@ struct dwc2_hregs_backup { ...@@ -782,9 +782,10 @@ struct dwc2_hregs_backup {
* @gadget_enabled Peripheral mode sub-driver initialization indicator. * @gadget_enabled Peripheral mode sub-driver initialization indicator.
* @ll_hw_enabled Status of low-level hardware resources. * @ll_hw_enabled Status of low-level hardware resources.
* @phy: The otg phy transceiver structure for phy control. * @phy: The otg phy transceiver structure for phy control.
* @uphy: The otg phy transceiver structure for old USB phy control. * @uphy: The otg phy transceiver structure for old USB phy
* @plat: The platform specific configuration data. This can be removed once * control.
* all SoCs support usb transceiver. * @plat: The platform specific configuration data. This can be
* removed once all SoCs support usb transceiver.
* @supplies: Definition of USB power supplies * @supplies: Definition of USB power supplies
* @phyif: PHY interface width * @phyif: PHY interface width
* @lock: Spinlock that protects all the driver data structures * @lock: Spinlock that protects all the driver data structures
......
...@@ -581,11 +581,11 @@ static unsigned int get_ep_limit(struct dwc2_hsotg_ep *hs_ep) ...@@ -581,11 +581,11 @@ static unsigned int get_ep_limit(struct dwc2_hsotg_ep *hs_ep)
} }
/** /**
* dwc2_hsotg_read_frameno - read current frame number * dwc2_hsotg_read_frameno - read current frame number
* @hsotg: The device instance * @hsotg: The device instance
* *
* Return the current frame number * Return the current frame number
*/ */
static u32 dwc2_hsotg_read_frameno(struct dwc2_hsotg *hsotg) static u32 dwc2_hsotg_read_frameno(struct dwc2_hsotg *hsotg)
{ {
u32 dsts; u32 dsts;
...@@ -1467,8 +1467,11 @@ static int dwc2_hsotg_process_req_status(struct dwc2_hsotg *hsotg, ...@@ -1467,8 +1467,11 @@ static int dwc2_hsotg_process_req_status(struct dwc2_hsotg *hsotg,
switch (ctrl->bRequestType & USB_RECIP_MASK) { switch (ctrl->bRequestType & USB_RECIP_MASK) {
case USB_RECIP_DEVICE: case USB_RECIP_DEVICE:
reply = cpu_to_le16(0); /* bit 0 => self powered, /*
* bit 1 => remote wakeup */ * bit 0 => self powered
* bit 1 => remote wakeup
*/
reply = cpu_to_le16(0);
break; break;
case USB_RECIP_INTERFACE: case USB_RECIP_INTERFACE:
...@@ -2750,19 +2753,19 @@ static void dwc2_gadget_handle_out_token_ep_disabled(struct dwc2_hsotg_ep *ep) ...@@ -2750,19 +2753,19 @@ static void dwc2_gadget_handle_out_token_ep_disabled(struct dwc2_hsotg_ep *ep)
} }
/** /**
* dwc2_gadget_handle_nak - handle NAK interrupt * dwc2_gadget_handle_nak - handle NAK interrupt
* @hs_ep: The endpoint on which interrupt is asserted. * @hs_ep: The endpoint on which interrupt is asserted.
* *
* This is starting point for ISOC-IN transfer, synchronization done with * This is starting point for ISOC-IN transfer, synchronization done with
* first IN token received from host while corresponding EP is disabled. * first IN token received from host while corresponding EP is disabled.
* *
* Device does not know when first one token will arrive from host. On first * Device does not know when first one token will arrive from host. On first
* token arrival HW generates 2 interrupts: 'in token received while FIFO empty' * token arrival HW generates 2 interrupts: 'in token received while FIFO empty'
* and 'NAK'. NAK interrupt for ISOC-IN means that token has arrived and ZLP was * and 'NAK'. NAK interrupt for ISOC-IN means that token has arrived and ZLP was
* sent in response to that as there was no data in FIFO. SW is basing on this * sent in response to that as there was no data in FIFO. SW is basing on this
* interrupt to obtain frame in which token has come and then based on the * interrupt to obtain frame in which token has come and then based on the
* interval calculates next frame for transfer. * interval calculates next frame for transfer.
*/ */
static void dwc2_gadget_handle_nak(struct dwc2_hsotg_ep *hs_ep) static void dwc2_gadget_handle_nak(struct dwc2_hsotg_ep *hs_ep)
{ {
struct dwc2_hsotg *hsotg = hs_ep->parent; struct dwc2_hsotg *hsotg = hs_ep->parent;
......
...@@ -1389,21 +1389,26 @@ static void dwc2_hc_nyet_intr(struct dwc2_hsotg *hsotg, ...@@ -1389,21 +1389,26 @@ static void dwc2_hc_nyet_intr(struct dwc2_hsotg *hsotg,
int end_frnum; int end_frnum;
/* /*
* Figure out the end frame based on schedule. * Figure out the end frame based on
* schedule.
* *
* We don't want to go on trying again and again * We don't want to go on trying again
* forever. Let's stop when we've done all the * and again forever. Let's stop when
* transfers that were scheduled. * we've done all the transfers that
* were scheduled.
* *
* We're going to be comparing start_active_frame * We're going to be comparing
* and next_active_frame, both of which are 1 * start_active_frame and
* before the time the packet goes on the wire, * next_active_frame, both of which
* so that cancels out. Basically if had 1 * are 1 before the time the packet
* transfer and we saw 1 NYET then we're done. * goes on the wire, so that cancels
* We're getting a NYET here so if next >= * out. Basically if had 1 transfer
* (start + num_transfers) we're done. The * and we saw 1 NYET then we're done.
* complexity is that for all but ISOC_OUT we * We're getting a NYET here so if
* skip one slot. * next >= (start + num_transfers)
* we're done. The complexity is that
* for all but ISOC_OUT we skip one
* slot.
*/ */
end_frnum = dwc2_frame_num_inc( end_frnum = dwc2_frame_num_inc(
qh->start_active_frame, qh->start_active_frame,
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment