Changes in uspace/drv/bus/usb/usbhid/multimedia/multimedia.c [a0c05e7:5da7199] in mainline

File:

• uspace/drv/bus/usb/usbhid/multimedia/multimedia.c (modified) (7 diffs)

uspace/drv/bus/usb/usbhid/multimedia/multimedia.c

@@ -64 +64 @@
         //int32_t *keys;
         /** Count of stored keys (i.e. number of keys in the report). */
-        //size_t key_count;
+        //size_t key_count;     
         /** IPC session to the console device (for sending key events). */
         async_sess_t *console_sess;
@@ -71 +71 @@
 
 /*----------------------------------------------------------------------------*/
-/**
+/** 
  * Default handler for IPC methods not handled by DDF.
  *
@@ -86 +86 @@
 {
         usb_log_debug(NAME " default_connection_handler()\n");
-        if (fun == NULL || fun->driver_data == NULL) {
+        
+        usb_multimedia_t *multim_dev = (usb_multimedia_t *)fun->driver_data;
+        
+        if (multim_dev == NULL) {
                 async_answer_0(icallid, EINVAL);
                 return;
         }
-
-        usb_multimedia_t *multim_dev = fun->driver_data;
-
+        
         async_sess_t *sess =
             async_callback_receive_start(EXCHANGE_SERIALIZE, icall);
@@ -106 +107 @@
                 async_answer_0(icallid, EINVAL);
 }
-/*----------------------------------------------------------------------------*/
+
+/*----------------------------------------------------------------------------*/
+
 static ddf_dev_ops_t multimedia_ops = {
         .default_handler = default_connection_handler
 };
+
 /*----------------------------------------------------------------------------*/
 /**
@@ -121 +125 @@
  *       sends also these keys to application (otherwise it cannot use those
  *       keys at all).
- *
- * @param hid_dev
- * @param multim_dev
- * @param type Type of the event (press / release). Recognized values:
+ * 
+ * @param hid_dev 
+ * @param lgtch_dev 
+ * @param type Type of the event (press / release). Recognized values: 
  *             KEY_PRESS, KEY_RELEASE
  * @param key Key code of the key according to HID Usage Tables.
  */
-static void usb_multimedia_push_ev(
+static void usb_multimedia_push_ev(usb_hid_dev_t *hid_dev, 
     usb_multimedia_t *multim_dev, int type, unsigned int key)
 {
+        assert(hid_dev != NULL);
         assert(multim_dev != NULL);
-
-        const kbd_event_t ev = {
-                .type = type,
-                .key = key,
-                .mods = 0,
-                .c = 0,
-        };
+        
+        kbd_event_t ev;
+        
+        ev.type = type;
+        ev.key = key;
+        ev.mods = 0;
+        ev.c = 0;
 
         usb_log_debug2(NAME " Sending key %d to the console\n", ev.key);
@@ -146 +151 @@
                 return;
         }
-
+        
         async_exch_t *exch = async_exchange_begin(multim_dev->console_sess);
-        if (exch != NULL) {
-                async_msg_4(exch, KBDEV_EVENT, ev.type, ev.key, ev.mods, ev.c);
-                async_exchange_end(exch);
-        } else {
-                usb_log_warning("Failed to send multimedia key.\n");
-        }
-}
-/*----------------------------------------------------------------------------*/
-int usb_multimedia_init(struct usb_hid_dev *hid_dev, void **data)
-{
-        if (hid_dev == NULL || hid_dev->usb_dev == NULL) {
-                return EINVAL;
-        }
-
-        usb_log_debug(NAME " Initializing HID/multimedia structure...\n");
-
+        async_msg_4(exch, KBDEV_EVENT, ev.type, ev.key, ev.mods, ev.c);
+        async_exchange_end(exch);
+}
+
+/*----------------------------------------------------------------------------*/
+
+static int usb_multimedia_create_function(usb_hid_dev_t *hid_dev, 
+    usb_multimedia_t *multim_dev)
+{
         /* Create the exposed function. */
-        ddf_fun_t *fun = ddf_fun_create(
-            hid_dev->usb_dev->ddf_dev, fun_exposed, NAME);
+        ddf_fun_t *fun = ddf_fun_create(hid_dev->usb_dev->ddf_dev, fun_exposed, 
+            NAME);
         if (fun == NULL) {
                 usb_log_error("Could not create DDF function node.\n");
                 return ENOMEM;
         }
-
+        
         fun->ops = &multimedia_ops;
-
-        usb_multimedia_t *multim_dev =
-            ddf_fun_data_alloc(fun, sizeof(usb_multimedia_t));
-        if (multim_dev == NULL) {
-                ddf_fun_destroy(fun);
-                return ENOMEM;
-        }
-
-        multim_dev->console_sess = NULL;
-
-        //todo Autorepeat?
-
+        fun->driver_data = multim_dev;   // TODO: maybe change to hid_dev->data
+        
         int rc = ddf_fun_bind(fun);
         if (rc != EOK) {
                 usb_log_error("Could not bind DDF function: %s.\n",
                     str_error(rc));
+                // TODO: Can / should I destroy the DDF function?
                 ddf_fun_destroy(fun);
                 return rc;
         }
-
-        usb_log_debug(NAME " function created (handle: %" PRIun ").\n",
-            fun->handle);
-
+        
+        usb_log_debug("%s function created (handle: %" PRIun ").\n",
+            NAME, fun->handle);
+        
         rc = ddf_fun_add_to_category(fun, "keyboard");
         if (rc != EOK) {
@@ -201 +190 @@
                     "Could not add DDF function to category 'keyboard': %s.\n",
                     str_error(rc));
-                if (ddf_fun_unbind(fun) != EOK) {
-                        usb_log_error("Failed to unbind %s, won't destroy.\n",
-                            fun->name);
-                } else {
-                        ddf_fun_destroy(fun);
-                }
+                // TODO: Can / should I destroy the DDF function?
+                ddf_fun_destroy(fun);
                 return rc;
         }
-
-        /* Save the KBD device structure into the HID device structure. */
-        *data = fun;
-
+        
+        return EOK;
+}
+
+/*----------------------------------------------------------------------------*/
+
+int usb_multimedia_init(struct usb_hid_dev *hid_dev, void **data)
+{
+        if (hid_dev == NULL || hid_dev->usb_dev == NULL) {
+                return EINVAL; /*! @todo Other return code? */
+        }
+        
+        usb_log_debug(NAME " Initializing HID/multimedia structure...\n");
+        
+        usb_multimedia_t *multim_dev = (usb_multimedia_t *)malloc(
+            sizeof(usb_multimedia_t));
+        if (multim_dev == NULL) {
+                return ENOMEM;
+        }
+        
+        multim_dev->console_sess = NULL;
+        
+        /*! @todo Autorepeat */
+        
+        // save the KBD device structure into the HID device structure
+        *data = multim_dev;
+        
+        usb_log_debug(NAME " HID/multimedia device structure initialized.\n");
+        
+        int rc = usb_multimedia_create_function(hid_dev, multim_dev);
+        if (rc != EOK)
+                return rc;
+        
         usb_log_debug(NAME " HID/multimedia structure initialized.\n");
+        
         return EOK;
 }
-/*----------------------------------------------------------------------------*/
+
+/*----------------------------------------------------------------------------*/
+
 void usb_multimedia_deinit(struct usb_hid_dev *hid_dev, void *data)
 {
-        ddf_fun_t *fun = data;
-        if (fun != NULL && fun->driver_data != NULL) {
-                usb_multimedia_t *multim_dev = fun->driver_data;
-                /* Hangup session to the console */
-                if (multim_dev->console_sess)
-                        async_hangup(multim_dev->console_sess);
-                if (ddf_fun_unbind(fun) != EOK) {
-                        usb_log_error("Failed to unbind %s, won't destroy.\n",
-                            fun->name);
-                } else {
-                        usb_log_debug2("%s unbound.\n", fun->name);
-                        /* This frees multim_dev too as it was stored in
-                         * fun->data */
-                        ddf_fun_destroy(fun);
-                }
-        } else {
-                usb_log_error(
-                    "Failed to deinit multimedia subdriver, data missing.\n");
-        }
-}
-/*----------------------------------------------------------------------------*/
+        if (hid_dev == NULL) {
+                return;
+        }
+        
+        if (data != NULL) {
+                usb_multimedia_t *multim_dev = (usb_multimedia_t *)data;
+                // hangup session to the console
+                async_hangup(multim_dev->console_sess);
+        }
+}
+
+/*----------------------------------------------------------------------------*/
+
 bool usb_multimedia_polling_callback(struct usb_hid_dev *hid_dev, void *data)
 {
         // TODO: checks
-        ddf_fun_t *fun = data;
-        if (hid_dev == NULL || fun == NULL || fun->driver_data == NULL) {
+        if (hid_dev == NULL || data == NULL) {
                 return false;
         }
 
-        usb_multimedia_t *multim_dev = fun->driver_data;
-
+        usb_multimedia_t *multim_dev = (usb_multimedia_t *)data;
+        
         usb_hid_report_path_t *path = usb_hid_report_path();
-        if (path == NULL)
-                return true; /* This might be a temporary failure. */
-
-        int ret =
-            usb_hid_report_path_append_item(path, USB_HIDUT_PAGE_CONSUMER, 0);
-        if (ret != EOK) {
-                usb_hid_report_path_free(path);
-                return true; /* This might be a temporary failure. */
-        }
+        usb_hid_report_path_append_item(path, USB_HIDUT_PAGE_CONSUMER, 0);
 
         usb_hid_report_path_set_report_id(path, hid_dev->report_id);
 
         usb_hid_report_field_t *field = usb_hid_report_get_sibling(
-            &hid_dev->report, NULL, path, USB_HID_PATH_COMPARE_END
-            | USB_HID_PATH_COMPARE_USAGE_PAGE_ONLY,
+            hid_dev->report, NULL, path, USB_HID_PATH_COMPARE_END 
+            | USB_HID_PATH_COMPARE_USAGE_PAGE_ONLY, 
             USB_HID_REPORT_TYPE_INPUT);
 
-        //FIXME Is this iterating OK if done multiple times?
-        //FIXME The parsing is not OK. (what's wrong?)
+        /*! @todo Is this iterating OK if done multiple times? 
+         *  @todo The parsing is not OK
+         */
         while (field != NULL) {
-                if (field->value != 0) {
-                        usb_log_debug(NAME " KEY VALUE(%X) USAGE(%X)\n",
+                if(field->value != 0) {
+                        usb_log_debug(NAME " KEY VALUE(%X) USAGE(%X)\n", 
                             field->value, field->usage);
-                        const unsigned key =
+                        unsigned int key = 
                             usb_multimedia_map_usage(field->usage);
-                        const char *key_str =
+                        const char *key_str = 
                             usbhid_multimedia_usage_to_str(field->usage);
                         usb_log_info("Pressed key: %s\n", key_str);
-                        usb_multimedia_push_ev(multim_dev, KEY_PRESS, key);
+                        usb_multimedia_push_ev(hid_dev, multim_dev, KEY_PRESS, 
+                                               key);
                 }
-
+                
                 field = usb_hid_report_get_sibling(
-                    &hid_dev->report, field, path, USB_HID_PATH_COMPARE_END
-                    | USB_HID_PATH_COMPARE_USAGE_PAGE_ONLY,
+                    hid_dev->report, field, path, USB_HID_PATH_COMPARE_END
+                    | USB_HID_PATH_COMPARE_USAGE_PAGE_ONLY, 
                     USB_HID_REPORT_TYPE_INPUT);
-        }
+        }       
 
         usb_hid_report_path_free(path);
-
+        
         return true;
 }
+
 /**
  * @}