X-Git-Url: https://git.openpandora.org/cgi-bin/gitweb.cgi?p=pandora-kernel.git;a=blobdiff_plain;f=Documentation%2FDocBook%2Fgadget.tmpl;h=ea3bc9565e6a7e7ae48a168841c222e07bfd0154;hp=5a8ffa761e09991bfc59dc97fa01a4deef94e9f7;hb=eda3d8f5604860aae1bb9996bb5efc4213778369;hpb=c4ec20717313daafba59225f812db89595952b83
diff --git a/Documentation/DocBook/gadget.tmpl b/Documentation/DocBook/gadget.tmpl
index 5a8ffa761e09..ea3bc9565e6a 100644
--- a/Documentation/DocBook/gadget.tmpl
+++ b/Documentation/DocBook/gadget.tmpl
@@ -524,6 +524,44 @@ These utilities include endpoint autoconfiguration.
+Composite Device Framework
+
+The core API is sufficient for writing drivers for composite
+USB devices (with more than one function in a given configuration),
+and also multi-configuration devices (also more than one function,
+but not necessarily sharing a given configuration).
+There is however an optional framework which makes it easier to
+reuse and combine functions.
+
+
+Devices using this framework provide a struct
+usb_composite_driver, which in turn provides one or
+more struct usb_configuration instances.
+Each such configuration includes at least one
+struct usb_function, which packages a user
+visible role such as "network link" or "mass storage device".
+Management functions may also exist, such as "Device Firmware
+Upgrade".
+
+
+!Iinclude/linux/usb/composite.h
+!Edrivers/usb/gadget/composite.c
+
+
+
+Composite Device Functions
+
+At this writing, a few of the current gadget drivers have
+been converted to this framework.
+Near-term plans include converting all of them, except for "gadgetfs".
+
+
+!Edrivers/usb/gadget/f_acm.c
+!Edrivers/usb/gadget/f_serial.c
+
+
+
+
Peripheral Controller Drivers