[PATCH v2 1/2] Documentation: usbgadget: provide autostart notes

[PATCH v2 1/2] Documentation: usbgadget: provide autostart notes

[Oleksij Rempel]

The usbgadget autostart functionality is already added. It's
time to reflect it in the documentation.

Signed-off-by: Oleksij Rempel <o.rempel@pengutronix.de>
---
 Documentation/user/usb.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/Documentation/user/usb.rst b/Documentation/user/usb.rst
index bbcb045cee..ec219cfbe4 100644
--- a/Documentation/user/usb.rst
+++ b/Documentation/user/usb.rst
@@ -216,3 +216,24 @@ mode. Once a specific mode has been selected it can't be changed later anymore.
   musb-hdrc: setup fifo_mode 4
   musb-hdrc: 28/31 max ep, 16384/16384 memory
   barebox:/
+
+USB Gadget autostart Support
+----------------------------
+
+Barebox can be configured to start usbgadget automatically by using global variables,
+instead of creating boot script. This can be useful if autostart policy should be
+chosen at boot time from other driver or script.
+To get usbgadget autostart support barebox has to be compiled with
+CONFIG_USB_GADGET_AUTOSTART enabled.
+
+USB Gadget autostart Options
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+``global.usbgadget.autostart``
+  Boolean flag. If set to 1, usbgadget will be started automatically on boot and
+  enable USB OTG mode. (Default 0).
+``global.usbgadget.acm``
+  Boolean flag. If set to 1, CDC ACM function will be created.
+  See :ref:`command_usbgadget` -a. (Default 0).
+``global.usbgadget.fastboot_function``
+  Function description for fastboot. See :ref:`command_usbgadget` -A [desc].
-- 
2.11.0


_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

[PATCH v2 2/2] commands: usbgadget: update fastboot help text

[Oleksij Rempel]

cmd_usbgadget can use now the fallback to
global.usbgadget.fastboot_function. Update help text to reflect this
behavior.

Signed-off-by: Oleksij Rempel <o.rempel@pengutronix.de>
---
 commands/usbgadget.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/commands/usbgadget.c b/commands/usbgadget.c
index 02c2c96b02..ba09f97847 100644
--- a/commands/usbgadget.c
+++ b/commands/usbgadget.c
@@ -106,7 +106,8 @@ BAREBOX_CMD_HELP_TEXT("")
 BAREBOX_CMD_HELP_TEXT("Options:")
 BAREBOX_CMD_HELP_OPT ("-a",   "Create CDC ACM function")
 BAREBOX_CMD_HELP_OPT ("-s",   "Create Generic Serial function")
-BAREBOX_CMD_HELP_OPT ("-A <desc>",   "Create Android Fastboot function")
+BAREBOX_CMD_HELP_OPT ("-A [desc]",	"Create Android Fastboot function. If 'desc' is not provided,")
+BAREBOX_CMD_HELP_OPT ("",		"trying to use 'global.usbgadget.fastboot_function' variable.")
 BAREBOX_CMD_HELP_OPT ("-D <desc>",   "Create DFU function")
 BAREBOX_CMD_HELP_OPT ("-d",   "Disable the currently running gadget")
 BAREBOX_CMD_HELP_END
-- 
2.11.0


_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox

Re: [PATCH v2 1/2] Documentation: usbgadget: provide autostart notes

[Sascha Hauer]

On Sat, May 06, 2017 at 04:02:32PM +0200, Oleksij Rempel wrote:
> The usbgadget autostart functionality is already added. It's
> time to reflect it in the documentation.
> 
> Signed-off-by: Oleksij Rempel <o.rempel@pengutronix.de>
> ---
>  Documentation/user/usb.rst | 21 +++++++++++++++++++++
>  1 file changed, 21 insertions(+)

Applied, thanks

Sascha

> 
> diff --git a/Documentation/user/usb.rst b/Documentation/user/usb.rst
> index bbcb045cee..ec219cfbe4 100644
> --- a/Documentation/user/usb.rst
> +++ b/Documentation/user/usb.rst
> @@ -216,3 +216,24 @@ mode. Once a specific mode has been selected it can't be changed later anymore.
>    musb-hdrc: setup fifo_mode 4
>    musb-hdrc: 28/31 max ep, 16384/16384 memory
>    barebox:/
> +
> +USB Gadget autostart Support
> +----------------------------
> +
> +Barebox can be configured to start usbgadget automatically by using global variables,
> +instead of creating boot script. This can be useful if autostart policy should be
> +chosen at boot time from other driver or script.
> +To get usbgadget autostart support barebox has to be compiled with
> +CONFIG_USB_GADGET_AUTOSTART enabled.
> +
> +USB Gadget autostart Options
> +^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> +
> +``global.usbgadget.autostart``
> +  Boolean flag. If set to 1, usbgadget will be started automatically on boot and
> +  enable USB OTG mode. (Default 0).
> +``global.usbgadget.acm``
> +  Boolean flag. If set to 1, CDC ACM function will be created.
> +  See :ref:`command_usbgadget` -a. (Default 0).
> +``global.usbgadget.fastboot_function``
> +  Function description for fastboot. See :ref:`command_usbgadget` -A [desc].
> -- 
> 2.11.0
> 
> 
> _______________________________________________
> barebox mailing list
> barebox@lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/barebox
> 

-- 
Pengutronix e.K.                           |                             |
Industrial Linux Solutions                 | http://www.pengutronix.de/  |
Peiner Str. 6-8, 31137 Hildesheim, Germany | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox