Changeset 355f7c2 in mainline for uspace/srv/hw/bus/usb/hcd/virtual/hubintern.h

Timestamp:

2010-10-25T07:44:02Z (13 years ago)

Author:

Vojtech Horky <vojtechhorky@…>

Branches:

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

Children:

ca07cd3

Parents:

7a7bfeb3

Message:

Better debugging support in VHCD

Also, added some missing comments.

File:

• uspace/srv/hw/bus/usb/hcd/virtual/hubintern.h (modified) (5 diffs)

uspace/srv/hw/bus/usb/hcd/virtual/hubintern.h

@@ -38 +38 @@
 #include "hub.h"
 
+/** Endpoint number for status change pipe. */
 #define HUB_STATUS_CHANGE_PIPE 1
+/** Configuration value for hub configuration. */
 #define HUB_CONFIGURATION_ID 1
 
@@ -66 +68 @@
 } __attribute__ ((packed)) hub_descriptor_t;
 
+/** Hub port internal state.
+ * Some states (e.g. port over current) are not covered as they are not
+ * simulated at all.
+ */
 typedef enum {
         HUB_PORT_STATE_NOT_CONFIGURED,
@@ -78 +84 @@
 } hub_port_state_t;
 
+/** Convert hub port state to a char. */
+static inline char hub_port_state_as_char(hub_port_state_t state) {
+        switch (state) {
+                case HUB_PORT_STATE_NOT_CONFIGURED:
+                        return '-';
+                case HUB_PORT_STATE_POWERED_OFF:
+                        return 'O';
+                case HUB_PORT_STATE_DISCONNECTED:
+                        return 'X';
+                case HUB_PORT_STATE_DISABLED:
+                        return 'D';
+                case HUB_PORT_STATE_RESETTING:
+                        return 'R';
+                case HUB_PORT_STATE_ENABLED:
+                        return 'E';
+                case HUB_PORT_STATE_SUSPENDED:
+                        return 'S';
+                case HUB_PORT_STATE_RESUMING:
+                        return 'F';
+                default:
+                        return '?';
+        }
+}
+
+/** Hub status change mask bits. */
 typedef enum {
         HUB_STATUS_C_PORT_CONNECTION = (1 << 0),
@@ -87 +118 @@
 } hub_status_change_t;
 
+/** Hub port information. */
 typedef struct {
         virtdev_connection_t *device;
@@ -93 +125 @@
 } hub_port_t;
 
+/** Hub device type. */
 typedef struct {
         hub_port_t ports[HUB_PORT_COUNT];