Re: [PATCH 3/3] Documentation: usb: Add docs for configfs control requests
On Mon, Jul 02, 2018 at 03:01:03PM -0700, Jerry Zhang wrote: > Signed-off-by: Jerry Zhang > --- > Documentation/usb/gadget_configfs.txt | 34 +++ > 1 file changed, 34 insertions(+) I can't take patches without any changelog text at all, sorry. greg k-h -- To unsubscribe from this list: send the line "unsubscribe linux-usb" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
[PATCH 3/3] Documentation: usb: Add docs for configfs control requests
Signed-off-by: Jerry Zhang --- Documentation/usb/gadget_configfs.txt | 34 +++ 1 file changed, 34 insertions(+) diff --git a/Documentation/usb/gadget_configfs.txt b/Documentation/usb/gadget_configfs.txt index b8cb38a98c19..64f69dd3f123 100644 --- a/Documentation/usb/gadget_configfs.txt +++ b/Documentation/usb/gadget_configfs.txt @@ -285,6 +285,40 @@ e.g.: $ rmdir g1 +8. Handling control requests +-- + +A composite gadget with changing configurations may still want to handle +vendor control requests in a centralized location. In particular, functionfs +instances can pass control requests to user-space, but there is no +guarantee that a functionfs is in the current config. + +To handle this there is a special config in the root of the gadget +called control_config. Functions linked here do not appear in the +configuration, but will receive control requests. To use it: + +Create a special instance of functionfs. + +$ mkdir functions/ffs.ctrl + +Mount the functionfs instance and write descriptors. + +mount functionfs ctrl /dev/ffs-ctrl +# Write functionfs descriptors to /dev/ffs-ctrl/ep0 +# Descriptor header must include ALL_CTRL_RECIP AND CONTROL_ONLY +# and must *not* include any speed descriptors. + +Link the function into control config. + +$ ln -s functions/ffs.ctrl control_config/f1 + +Link normal functions into the appropriate config, and enable the gadget. + +$ echo > UDC + +Handle control requests in /dev/ffs-ctrl/ep0. +See functionfs documentation on how to do this. + -- 2.18.0.399.gad0ab374a1-goog -- To unsubscribe from this list: send the line "unsubscribe linux-usb" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
[PATCH 3/3] Documentation: usb: Add docs for configfs control requests
Signed-off-by: Jerry Zhang --- Documentation/usb/gadget_configfs.txt | 32 +++ 1 file changed, 32 insertions(+) diff --git a/Documentation/usb/gadget_configfs.txt b/Documentation/usb/gadget_configfs.txt index 635e57493709..a50f16c8a4bb 100644 --- a/Documentation/usb/gadget_configfs.txt +++ b/Documentation/usb/gadget_configfs.txt @@ -285,6 +285,38 @@ e.g.: $ rmdir g1 +8. Handling control requests +-- + +A composite gadget with changing configurations may still want to handle +vendor control requests in a centralized location. In particular, functionfs +instances can pass control requests to user-space, but there is no +guarantee that a functionfs is in the current config. + +To handle this there is a special config in the root of the gadget +called control_config. Functions linked here do not appear in the +configuration, but will receive control requests. To use it: + +Create a special instance of functionfs. + +$ mkdir functions/ffs.ctrl + +Mount the functionfs instance and write descriptors. + +mount functionfs ctrl /dev/ffs-ctrl +# Write dummy functionfs descriptors to /dev/ffs-ctrl/ep0 +# Descriptors should include flag FUNCTIONFS_ALL_CTRL_RECIP + +Link the function into control config. + +$ ln -s functions/ffs.ctrl control_config/f1 + +Link normal functions into the appropriate config, and enable the gadget. + +$ echo > UDC + +Handle control requests in /dev/ffs-ctrl/ep0. See functionfs documentation on how to do this. + -- 2.17.0.484.g0c8726318c-goog -- To unsubscribe from this list: send the line "unsubscribe linux-usb" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
