Changeset 7c3fb9b in mainline for uspace/lib/usbhost

Timestamp:

2018-05-17T08:29:01Z (7 years ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

6ff23ff

Parents:

fac0ac7

git-author:

Jiri Svoboda <jiri@…> (2018-05-16 17:28:17)

git-committer:

Jiri Svoboda <jiri@…> (2018-05-17 08:29:01)

Message:

Fix block comment formatting (ccheck).

Location:

uspace/lib/usbhost

Files:

• include/usb/host/hcd.h (modified) (2 diffs)
• include/usb/host/usb_transfer_batch.h (modified) (1 diff)
• include/usb/host/utils/malloc32.h (modified) (2 diffs)
• src/bandwidth.c (modified) (1 diff)
• src/hcd.c (modified) (1 diff)

uspace/lib/usbhost/include/usb/host/hcd.h

@@ -45 +45 @@
 typedef struct device device_t;
 
-/* Treat this header as read-only in driver code.
+/*
+ * Treat this header as read-only in driver code.
  * It could be opaque, but why to complicate matters.
  */
@@ -71 +72 @@
 
         /** Size of the device data to be allocated, and passed as the
-         * hc_device_t. */
+         * hc_device_t.
+         */
         size_t hc_device_size;
 

uspace/lib/usbhost/include/usb/host/usb_transfer_batch.h

@@ -97 +97 @@
  * Printf formatting string for dumping usb_transfer_batch_t.
  *  [address:endpoint speed transfer_type-direction buffer_sizeB/max_packet_size]
- * */
+ */
 #define USB_TRANSFER_BATCH_FMT "[%d:%d %s %s-%s %zuB/%zu]"
 

uspace/lib/usbhost/include/usb/host/utils/malloc32.h

@@ -43 +43 @@
 #include <stdint.h>
 
-/* Generic TDs and EDs require 16byte alignment,
+/*
+ * Generic TDs and EDs require 16byte alignment,
  * Isochronous TD require 32byte alignment,
  * buffers do not have to be aligned.
@@ -83 +84 @@
 
         if (ret == EOK) {
-                /* Poison, accessing it should be enough to make sure
-                 * the location is mapped, but poison works better */
+                /*
+                 * Poison, accessing it should be enough to make sure
+                 * the location is mapped, but poison works better
+                 */
                 memset(address, 0x5, real_size);
                 return address;

uspace/lib/usbhost/src/bandwidth.c

@@ -70 +70 @@
         const size_t packet_count = ep->packets_per_uframe;
 
-        /* TODO: It may be that ISO and INT transfers use only one packet per
-         * transaction, but I did not find text in USB spec to confirm this */
+        /*
+         * TODO: It may be that ISO and INT transfers use only one packet per
+         * transaction, but I did not find text in USB spec to confirm this
+         */
         /* NOTE: All data packets will be considered to be max_packet_size */
         switch (ep->device->speed) {
         case USB_SPEED_LOW:
                 assert(type == USB_TRANSFER_INTERRUPT);
-                /* Protocol overhead 13B
+                /*
+                 * Protocol overhead 13B
                  * (3 SYNC bytes, 3 PID bytes, 2 Endpoint + CRC bytes, 2
                  * CRC bytes, and a 3-byte interpacket delay)
-                 * see USB spec page 45-46. */
+                 * see USB spec page 45-46.
+                 */
                 /* Speed penalty 8: low speed is 8-times slower*/
                 return packet_count * (13 + max_packet_size) * 8;
         case USB_SPEED_FULL:
-                /* Interrupt transfer overhead see above
-                 * or page 45 of USB spec */
+                /*
+                 * Interrupt transfer overhead see above
+                 * or page 45 of USB spec
+                 */
                 if (type == USB_TRANSFER_INTERRUPT)
                         return packet_count * (13 + max_packet_size);
 
                 assert(type == USB_TRANSFER_ISOCHRONOUS);
-                /* Protocol overhead 9B
+                /*
+                 * Protocol overhead 9B
                  * (2 SYNC bytes, 2 PID bytes, 2 Endpoint + CRC bytes, 2 CRC
                  * bytes, and a 1-byte interpacket delay)
-                 * see USB spec page 42 */
+                 * see USB spec page 42
+                 */
                 return packet_count * (9 + max_packet_size);
         default:

uspace/lib/usbhost/src/hcd.c

@@ -120 +120 @@
                 bus->ops->interrupt(bus, status);
                 status = 0;
-                /* We should wait 1 frame - 1ms here, but this polling is a
+                /*
+                 * We should wait 1 frame - 1ms here, but this polling is a
                  * lame crutch anyway so don't hog the system. 10ms is still
-                 * good enough for emergency mode */
+                 * good enough for emergency mode
+                 */
                 async_usleep(10000);
         }