Changeset 019cff6 in mainline

Timestamp:

2011-03-04T20:11:22Z (13 years ago)

Author:

Vojtech Horky <vojtechhorky@…>

Branches:

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

Children:

ff4185e6

Parents:

3faf416c

Message:

Add buffer dumping function usb_debug_str_buffer

Example usage in USB mouse driver.

Checking etc. will be added in later revisions.

Location:

uspace

Files:

• drv/usbmouse/main.c (modified) (1 diff)
• drv/usbmouse/mouse.c (modified) (1 diff)
• lib/usb/include/usb/debug.h (modified) (1 diff)
• lib/usb/src/debug.c (modified) (1 diff)

uspace/drv/usbmouse/main.c

@@ -74 +74 @@
 int main(int argc, char *argv[])
 {
-        usb_log_enable(USB_LOG_LEVEL_DEBUG, NAME);
+        usb_log_enable(USB_LOG_LEVEL_DEBUG2, NAME);
 
         return ddf_driver_main(&mouse_driver);

uspace/drv/usbmouse/mouse.c

@@ -94 +94 @@
                 }
 
+                usb_log_debug2("got buffer: %s.\n",
+                    usb_debug_str_buffer(buffer, buffer_size, 0));
+
                 uint8_t butt = buffer[0];
                 char str_buttons[4] = {

uspace/lib/usb/include/usb/debug.h

@@ -79 +79 @@
         usb_log_printf(USB_LOG_LEVEL_DEBUG2, format, ##__VA_ARGS__)
 
+const char *usb_debug_str_buffer(uint8_t *, size_t, size_t);
 
 

uspace/lib/usb/src/debug.c

@@ -252 +252 @@
 }
 
+
+#define BUFFER_DUMP_LEN 512
+static fibril_local char buffer_dump[BUFFER_DUMP_LEN];
+
+/** Dump buffer into string.
+ *
+ * The function dumps given buffer into hexadecimal format and stores it
+ * in a static fibril local string.
+ * That means that you do not have to deallocate the string (actually, you
+ * can not do that) and you do not have to save it agains concurrent
+ * calls to it.
+ * The only limitation is that each call rewrites the buffer again.
+ * Thus, it is necessary to copy the buffer elsewhere (that includes printing
+ * to screen or writing to file).
+ * Since this function is expected to be used for debugging prints only,
+ * that is not a big limitation.
+ *
+ * @warning You cannot use this function twice in the same printf
+ * (see detailed explanation).
+ *
+ * @param buffer Buffer to be printed (can be NULL).
+ * @param size Size of the buffer in bytes (can be zero).
+ * @param dumped_size How many bytes to actually dump (zero means all).
+ * @return Dumped buffer as a static (but fibril local) string.
+ */
+const char *usb_debug_str_buffer(uint8_t *buffer, size_t size,
+    size_t dumped_size)
+{
+        if (buffer == NULL) {
+                return "(null)";
+        }
+        if (size == 0) {
+                return "(empty)";
+        }
+        if ((dumped_size == 0) || (dumped_size > size)) {
+                dumped_size = size;
+        }
+
+        char *it = buffer_dump;
+
+        size_t index = 0;
+
+        while (1) {
+                /* FIXME: add range checking of the buffer size. */
+                snprintf(it, 4, "%02X ", (int) buffer[index]);
+                it += 3;
+                index++;
+                if (index >= dumped_size) {
+                        break;
+                }
+        }
+
+        /* Remove the last space */
+        it--;
+        *it = 0;
+
+        return buffer_dump;
+}
+
+
 /**
  * @}