Changeset 8b71f3e in mainline for uspace/drv/bus/usb/usbhub/usbhub.h

Timestamp:

2018-01-14T21:16:03Z (6 years ago)

Author:

Petr Manek <petr.manek@…>

Branches:

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

Children:

17c1d9db

Parents:

edc51615

git-author:

Petr Manek <petr.manek@…> (2018-01-14 21:16:00)

git-committer:

Petr Manek <petr.manek@…> (2018-01-14 21:16:03)

Message:

usbdev: refactor polling more

For clarity, the opaque usb_device_polling_t and its complementary
configuration data structure usb_device_polling_config_t have been
merged into usb_polling_t. All related methods have dropped the
"device" from their prefix as well.

The usage semantics have transitioned to malloc-free model, where the
user is entirely responsible for (de)allocation of the polling structure
and its data buffer, and (de)initialization happens in designated
functions during its lifetime in the system.

In addition, the distinction between mandatory / optional / internal
parameters has been documented. Optional parameters now have default
values, which are set to sensible constants in order to allow dropping
some lines in USB driver implementations.

The drivers usbhid and usbhub were refactored to match the API
changes.

File:

• uspace/drv/bus/usb/usbhub/usbhub.h (modified) (1 diff)

uspace/drv/bus/usb/usbhub/usbhub.h

@@ -60 +60 @@
         usb_device_t *usb_device;
         /** Data polling handle. */
-        usb_device_polling_t *polling;
+        usb_polling_t polling;
         /** Number of pending operations on the mutex to prevent shooting
          * ourselves in the foot.