From: Roland Hieber <rhi@pengutronix.de>
To: barebox@lists.infradead.org
Cc: Roland Hieber <rhi@pengutronix.de>
Subject: [PATCH 3/3] doc: user: net: document Fastboot over UDP usage
Date: Wed, 25 Jun 2025 12:51:45 +0200 [thread overview]
Message-ID: <20250625105145.3626715-3-rhi@pengutronix.de> (raw)
In-Reply-To: <20250625105145.3626715-1-rhi@pengutronix.de>
Signed-off-by: Roland Hieber <rhi@pengutronix.de>
---
Documentation/user/networking.rst | 16 ++++++++++++++++
Documentation/user/usb.rst | 4 ++++
2 files changed, 20 insertions(+)
diff --git a/Documentation/user/networking.rst b/Documentation/user/networking.rst
index 6997da10dbea..605936c6a895 100644
--- a/Documentation/user/networking.rst
+++ b/Documentation/user/networking.rst
@@ -203,6 +203,22 @@ The netconsole can be used just like any other console. Note, however, that the
simple console protocol is UDP based, so there is no guarantee about packet
loss.
+Fastboot over UDP
+-----------------
+
+When built with ``CONFIG_NET_FASTBOOT=y`` and the environment variable
+``fastboot.net.autostart`` is set to any non-empty value, barebox will
+listen for fastboot commands on UDP port 5554.
+You might need to configure a IP address first in order to use fastboot (e.g.
+via DHCP or statically; see above).
+
+Additionally, you have to configure at least the ``fastboot.partitions``
+variable, see :ref:`usbgadget_variables`.
+
+On your development host, use fastboot with the ``-s udp:<IP-address>``
+parameter, specifying the IP address of your board.
+See :ref:`fastboot` for more information about Fastboot usage.
+
DSA (Distributed Switch Architecture) Support in Barebox
--------------------------------------------------------
diff --git a/Documentation/user/usb.rst b/Documentation/user/usb.rst
index 43072be53db7..f233927656bc 100644
--- a/Documentation/user/usb.rst
+++ b/Documentation/user/usb.rst
@@ -153,6 +153,8 @@ barebox can provide a serial console over USB. This can be initialized with the
:ref:`command_usbserial` command. Once the host is plugged in it should show a
new serial device, on Linux for example ``/dev/ttyACM0``.
+.. _fastboot:
+
Android Fastboot support
^^^^^^^^^^^^^^^^^^^^^^^^
@@ -307,6 +309,8 @@ 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.
+.. _usbgadget_variables:
+
USB Gadget autostart Options
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
--
2.39.5
next prev parent reply other threads:[~2025-06-25 12:32 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-06-25 10:51 [PATCH 1/3] doc: user: rename appendix section and keep it as last entry Roland Hieber
2025-06-25 10:51 ` [PATCH 2/3] doc: user: usb: link to syntax when explaining the partition variables Roland Hieber
2025-06-25 10:51 ` Roland Hieber [this message]
2025-06-25 12:48 ` [PATCH 3/3] doc: user: net: document Fastboot over UDP usage Ahmad Fatoum
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250625105145.3626715-3-rhi@pengutronix.de \
--to=rhi@pengutronix.de \
--cc=barebox@lists.infradead.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox