[PATCH 1/6] Documentation: user: introduction: update with lore/matrix/libera info

[PATCH 1/6] Documentation: user: introduction: update with lore/matrix/libera info

[Ahmad Fatoum]

The Website already points at Libera instead of Freenode. Update the
intro section, so the docs are correct as well.

While at it, mention lore and matrix.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/user/introduction.rst | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/Documentation/user/introduction.rst b/Documentation/user/introduction.rst
index 8a980a70abc7..523fe288f9fe 100644
--- a/Documentation/user/introduction.rst
+++ b/Documentation/user/introduction.rst
@@ -24,6 +24,15 @@ discussion of barebox takes place here:
 
 http://lists.infradead.org/mailman/listinfo/barebox/
 
-There's also an IRC channel:
+Mails sent to the barebox mailing list are archived on
+`lore.barebox.org <https://lore.barebox.org/barebox/>`_.
 
-IRC: #barebox (Freenode)
+Patch series sent there can be fetched with `b4 <https://pypi.org/project/b4/>`_ ::
+
+   git config b4.midmask https://lore.barebox.org/%s
+   git config b4.linkmask https://lore.barebox.org/%s
+   b4 am https://lore.barebox.org/$messageid # replace with link
+
+There's also an IRC channel, which is
+`bridged to Matrix  <https://app.element.io/#/room/#barebox:matrix.org>`_:
+#barebox on Libera Chat
-- 
2.30.2


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

[PATCH 2/6] Documentation: add chapter on Talks about barebox

[Ahmad Fatoum]

There's been a number of talks about barebox. Collect them in a new
chapter for those, who prefer something less dry than wading through the
docs. A top-level chapter is chosen, so it's more visible to visitors.

The ordering is reverse chronological, except for the first entry: The
newest talk is German about running DOOM in barebox, which is a bit
detached to how barebox is normally used.

Instead, let's keep the first entry as a pointer to the latest overview
talk and then use reverse chronological order for the rest.

Signed-off-by: Johannes Schneider <JSchneider@jetter.de>
Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/index.rst |   1 +
 Documentation/talks.rst | 130 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 131 insertions(+)
 create mode 100644 Documentation/talks.rst

diff --git a/Documentation/index.rst b/Documentation/index.rst
index 836dc41af2a3..a3e019e9f0a2 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -20,6 +20,7 @@ Contents:
    glossary
    devicetree/*
    devel/devel.rst
+   talks
 
 * :ref:`search`
 * :ref:`genindex`
diff --git a/Documentation/talks.rst b/Documentation/talks.rst
new file mode 100644
index 000000000000..5f1af599316b
--- /dev/null
+++ b/Documentation/talks.rst
@@ -0,0 +1,130 @@
+Talks and Lectures
+==================
+
+This is a collection of talks held about barebox use and development
+at different technical conferences. The most recent overview talk
+is from 2020:
+
+Beyond 'Just' Booting: Barebox Bells and Whistles
+-------------------------------------------------
+
+Ahmad Fatoum, Embedded Linux Conference - Europe 2020
+`[slides] <https://elinux.org/images/9/9d/Barebox-bells-n-whistles.pdf>`__
+`[video] <https://www.youtube.com/watch?v=fru1n54s2W4>`__
+
+   Porting barebox to a new STM32MP1 board and a general discussion
+   of design choices like multi-image, VFS, POSIX/Linux API,
+   fail-safe updates, boot fall-back mechanisms, etc.
+
+Besides older overview talks, there's a number of talks held
+about different aspects of barebox use.
+These are listed here in reverse chronological order.
+
+DOOM portieren für Einsteiger - Heavy Metal auf Bare Metal (German)
+-------------------------------------------------------------------
+
+Ahmad Fatoum, FrOSCon 2021
+`[slides] <https://programm.froscon.de/2021/system/event_attachments/attachments/000/000/622/original/heavy-metal-on-bare-metal.pdf>`__
+`[video] <https://media.ccc.de/v/froscon2021-2687-doom_portieren_fur_einsteiger>`__
+
+  "DOOM as a boot splash. How, why and how to get it on your nearest
+  home appliance". A (German) walkthrough on how to leverage barebox
+  APIs to run DOOM on any hardware supported by barebox.
+
+Initializing RISC-V: A Guided Tour for ARM Developers
+-----------------------------------------------------
+
+Rouven Czerwinski & Ahmad Fatoum, Embedded Linux Conference 2021
+`[slides] <https://elinux.org/images/8/80/Initializing-riscv.pdf>`__
+`[video] <https://www.youtube.com/watch?v=70oYYuflFLs>`__
+
+  A guide through the RISC-V architecture and some of its ISA extensions
+  and a walkthrough of the barebox port to the Beagle-V Starlight.
+
+From Reset Vector to Kernel - Navigating the ARM Matryoshka
+-----------------------------------------------------------
+
+Ahmad Fatoum, FOSDEM 2021
+`[slides & video] <https://archive.fosdem.org/2021/schedule/event/from_reset_vector_to_kernel/>`__
+
+  A walkthrough of NXP i.MX8M bootstrap. From Boot ROM through barebox to Linux.
+
+Booting your i.MX processor secure and implementing i.MX8 secure boot in barebox
+--------------------------------------------------------------------------------
+
+Rouven Czerwinski, `Stratum 0 Talk 2019 <https://stratum0.org/wiki/Vortr%C3%A4ge/Vorbei#2019>`__
+`[video] <https://www.youtube.com/watch?v=ZUGLEulZLWM>`__
+
+  A walkthrough of NXP i.MX8MQ high assurance boot with barebox.
+
+Porting Barebox to the Digi CC-MX6UL SBC Pro (German)
+-----------------------------------------------------
+
+Rouven Czerwinski, `Stratum 0 Live-Hacking 2019 <https://stratum0.org/wiki/Vortr%C3%A4ge/Vorbei#2019>`__
+`[video] <https://www.youtube.com/watch?v=FIwF6GfmsWM>`__
+
+  Live-coding a barebox port to a new i.MX6UL board while
+  explaining the details (in German).
+
+Remote update adventures with RAUC, Yocto and Barebox
+-----------------------------------------------------
+
+Patrick Boettcher, `Embedded Recipes 2019 <https://embedded-recipes.org/2019/remote-update-adventures-with-rauc-yocto-and-barebox/>`__
+`[video] <https://www.youtube.com/watch?v=hS3Fjf7fuHM>`__
+
+  Remote update and redundant boot of Embedded Linux devices
+  in the field with RAUC and barebox bootchooser.
+
+Verified Boot: From ROM to Userspace
+------------------------------------
+
+Marc Kleine-Budde, Embedded Linux Conference - Europe 2016
+`[slides] <https://elinux.org/images/f/f8/Verified_Boot.pdf>`__
+`[video] <https://www.youtube.com/watch?v=lkFKtCh2SaU>`__
+
+  Using FOSS components, including barebox, for a cryptographically
+  secured boot chain on NXP i.MX6 SoCs.
+
+Booting Linux Made Easy: A Barebox Update
+-----------------------------------------
+
+Robert Schwebel, `FOSDEM 2014 <https://archive.fosdem.org/2014/schedule/event/_booting_linux_made_easy:_a_barebox_update/>`__
+`[video] <https://www.youtube.com/watch?v=p-mHAQaJQcM>`__
+
+  An overview talk on barebox use in embedded Linux systems.
+
+Barebox and Bootloader Specification
+------------------------------------
+
+Sascha Hauer, Embedded Linux Conference - Europe 2013
+`[slides] <https://elinux.org/images/9/90/Barebox-elce2013-bootloaderspec.pdf>`__
+`[video] <https://www.youtube.com/watch?v=Z8FcIGXox_Y>`__
+
+  The freedesktop.org bootloader specification and its support in barebox.
+
+Barebox Bootloader
+------------------
+
+Sascha Hauer, Embedded Linux Conference - Europe 2012
+`[slides] <https://elinux.org/images/6/6b/PRE-20121108-1-Barebox.pdf>`__
+`[video] <https://www.youtube.com/watch?v=oY8BjCEt_p8>`__
+
+  An update on barebox development progress with a discussion of newly
+  implemented features in the preceding three years.
+
+Barebox: Booting Linux Fast and Fancy
+-------------------------------------
+
+Robert Schwebel & Sascha Hauer, Embedded Linux Conference - Europe 2010
+`[slides] <https://elinux.org/images/8/89/ELCE-2010-Barebox-Booting-Linux-Fast-and-Fancy.pdf>`__
+
+  Boot time optimization while using barebox.
+
+U-Boot-v2
+---------
+
+Sascha Hauer & Marc Kleine-Budde, Embedded Linux Conference 2009
+`[slides] <https://elinux.org/images/9/90/Hauer-U_BootV2.pdf>`__
+
+  Early barebox (still named U-Boot v2 back then) presentation on
+  the motivation for the fork and the niceties made possible by it.
-- 
2.30.2


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

Re: [PATCH 2/6] Documentation: add chapter on Talks about barebox

[Ahmad Fatoum]

On 24.01.22 16:18, Ahmad Fatoum wrote:

Argh, botched authorship on rebase. @Sascha, could you fix up
Johannes as git author on apply if there's no v2? Thanks.

> There's been a number of talks about barebox. Collect them in a new
> chapter for those, who prefer something less dry than wading through the
> docs. A top-level chapter is chosen, so it's more visible to visitors.
> 
> The ordering is reverse chronological, except for the first entry: The
> newest talk is German about running DOOM in barebox, which is a bit
> detached to how barebox is normally used.
> 
> Instead, let's keep the first entry as a pointer to the latest overview
> talk and then use reverse chronological order for the rest.
> 
> Signed-off-by: Johannes Schneider <JSchneider@jetter.de>
> Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
> ---
>  Documentation/index.rst |   1 +
>  Documentation/talks.rst | 130 ++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 131 insertions(+)
>  create mode 100644 Documentation/talks.rst
> 
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index 836dc41af2a3..a3e019e9f0a2 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -20,6 +20,7 @@ Contents:
>     glossary
>     devicetree/*
>     devel/devel.rst
> +   talks
>  
>  * :ref:`search`
>  * :ref:`genindex`
> diff --git a/Documentation/talks.rst b/Documentation/talks.rst
> new file mode 100644
> index 000000000000..5f1af599316b
> --- /dev/null
> +++ b/Documentation/talks.rst
> @@ -0,0 +1,130 @@
> +Talks and Lectures
> +==================
> +
> +This is a collection of talks held about barebox use and development
> +at different technical conferences. The most recent overview talk
> +is from 2020:
> +
> +Beyond 'Just' Booting: Barebox Bells and Whistles
> +-------------------------------------------------
> +
> +Ahmad Fatoum, Embedded Linux Conference - Europe 2020
> +`[slides] <https://elinux.org/images/9/9d/Barebox-bells-n-whistles.pdf>`__
> +`[video] <https://www.youtube.com/watch?v=fru1n54s2W4>`__
> +
> +   Porting barebox to a new STM32MP1 board and a general discussion
> +   of design choices like multi-image, VFS, POSIX/Linux API,
> +   fail-safe updates, boot fall-back mechanisms, etc.
> +
> +Besides older overview talks, there's a number of talks held
> +about different aspects of barebox use.
> +These are listed here in reverse chronological order.
> +
> +DOOM portieren für Einsteiger - Heavy Metal auf Bare Metal (German)
> +-------------------------------------------------------------------
> +
> +Ahmad Fatoum, FrOSCon 2021
> +`[slides] <https://programm.froscon.de/2021/system/event_attachments/attachments/000/000/622/original/heavy-metal-on-bare-metal.pdf>`__
> +`[video] <https://media.ccc.de/v/froscon2021-2687-doom_portieren_fur_einsteiger>`__
> +
> +  "DOOM as a boot splash. How, why and how to get it on your nearest
> +  home appliance". A (German) walkthrough on how to leverage barebox
> +  APIs to run DOOM on any hardware supported by barebox.
> +
> +Initializing RISC-V: A Guided Tour for ARM Developers
> +-----------------------------------------------------
> +
> +Rouven Czerwinski & Ahmad Fatoum, Embedded Linux Conference 2021
> +`[slides] <https://elinux.org/images/8/80/Initializing-riscv.pdf>`__
> +`[video] <https://www.youtube.com/watch?v=70oYYuflFLs>`__
> +
> +  A guide through the RISC-V architecture and some of its ISA extensions
> +  and a walkthrough of the barebox port to the Beagle-V Starlight.
> +
> +From Reset Vector to Kernel - Navigating the ARM Matryoshka
> +-----------------------------------------------------------
> +
> +Ahmad Fatoum, FOSDEM 2021
> +`[slides & video] <https://archive.fosdem.org/2021/schedule/event/from_reset_vector_to_kernel/>`__
> +
> +  A walkthrough of NXP i.MX8M bootstrap. From Boot ROM through barebox to Linux.
> +
> +Booting your i.MX processor secure and implementing i.MX8 secure boot in barebox
> +--------------------------------------------------------------------------------
> +
> +Rouven Czerwinski, `Stratum 0 Talk 2019 <https://stratum0.org/wiki/Vortr%C3%A4ge/Vorbei#2019>`__
> +`[video] <https://www.youtube.com/watch?v=ZUGLEulZLWM>`__
> +
> +  A walkthrough of NXP i.MX8MQ high assurance boot with barebox.
> +
> +Porting Barebox to the Digi CC-MX6UL SBC Pro (German)
> +-----------------------------------------------------
> +
> +Rouven Czerwinski, `Stratum 0 Live-Hacking 2019 <https://stratum0.org/wiki/Vortr%C3%A4ge/Vorbei#2019>`__
> +`[video] <https://www.youtube.com/watch?v=FIwF6GfmsWM>`__
> +
> +  Live-coding a barebox port to a new i.MX6UL board while
> +  explaining the details (in German).
> +
> +Remote update adventures with RAUC, Yocto and Barebox
> +-----------------------------------------------------
> +
> +Patrick Boettcher, `Embedded Recipes 2019 <https://embedded-recipes.org/2019/remote-update-adventures-with-rauc-yocto-and-barebox/>`__
> +`[video] <https://www.youtube.com/watch?v=hS3Fjf7fuHM>`__
> +
> +  Remote update and redundant boot of Embedded Linux devices
> +  in the field with RAUC and barebox bootchooser.
> +
> +Verified Boot: From ROM to Userspace
> +------------------------------------
> +
> +Marc Kleine-Budde, Embedded Linux Conference - Europe 2016
> +`[slides] <https://elinux.org/images/f/f8/Verified_Boot.pdf>`__
> +`[video] <https://www.youtube.com/watch?v=lkFKtCh2SaU>`__
> +
> +  Using FOSS components, including barebox, for a cryptographically
> +  secured boot chain on NXP i.MX6 SoCs.
> +
> +Booting Linux Made Easy: A Barebox Update
> +-----------------------------------------
> +
> +Robert Schwebel, `FOSDEM 2014 <https://archive.fosdem.org/2014/schedule/event/_booting_linux_made_easy:_a_barebox_update/>`__
> +`[video] <https://www.youtube.com/watch?v=p-mHAQaJQcM>`__
> +
> +  An overview talk on barebox use in embedded Linux systems.
> +
> +Barebox and Bootloader Specification
> +------------------------------------
> +
> +Sascha Hauer, Embedded Linux Conference - Europe 2013
> +`[slides] <https://elinux.org/images/9/90/Barebox-elce2013-bootloaderspec.pdf>`__
> +`[video] <https://www.youtube.com/watch?v=Z8FcIGXox_Y>`__
> +
> +  The freedesktop.org bootloader specification and its support in barebox.
> +
> +Barebox Bootloader
> +------------------
> +
> +Sascha Hauer, Embedded Linux Conference - Europe 2012
> +`[slides] <https://elinux.org/images/6/6b/PRE-20121108-1-Barebox.pdf>`__
> +`[video] <https://www.youtube.com/watch?v=oY8BjCEt_p8>`__
> +
> +  An update on barebox development progress with a discussion of newly
> +  implemented features in the preceding three years.
> +
> +Barebox: Booting Linux Fast and Fancy
> +-------------------------------------
> +
> +Robert Schwebel & Sascha Hauer, Embedded Linux Conference - Europe 2010
> +`[slides] <https://elinux.org/images/8/89/ELCE-2010-Barebox-Booting-Linux-Fast-and-Fancy.pdf>`__
> +
> +  Boot time optimization while using barebox.
> +
> +U-Boot-v2
> +---------
> +
> +Sascha Hauer & Marc Kleine-Budde, Embedded Linux Conference 2009
> +`[slides] <https://elinux.org/images/9/90/Hauer-U_BootV2.pdf>`__
> +
> +  Early barebox (still named U-Boot v2 back then) presentation on
> +  the motivation for the fork and the niceties made possible by it.
> 


-- 
Pengutronix e.K.                           |                             |
Steuerwalder Str. 21                       | http://www.pengutronix.de/  |
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

Re: [PATCH 2/6] Documentation: add chapter on Talks about barebox

[Sascha Hauer]

On Mon, Jan 24, 2022 at 04:21:00PM +0100, Ahmad Fatoum wrote:
> On 24.01.22 16:18, Ahmad Fatoum wrote:
> 
> Argh, botched authorship on rebase. @Sascha, could you fix up
> Johannes as git author on apply if there's no v2? Thanks.

Did that while applying, thanks

Sascha

-- 
Pengutronix e.K.                           |                             |
Steuerwalder Str. 21                       | http://www.pengutronix.de/  |
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

[PATCH 3/6] commands: add missing command groups

[Ahmad Fatoum]

CMD_GRP_MISC is assumed in absence of an explicit group. Let's be
explicit instead to silence the warnings during documentation build.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 commands/mmc.c         | 1 +
 fs/fs.c                | 2 ++
 lib/kasan/test_kasan.c | 1 +
 3 files changed, 4 insertions(+)

diff --git a/commands/mmc.c b/commands/mmc.c
index cbbb9d615145..1e62b71850e0 100644
--- a/commands/mmc.c
+++ b/commands/mmc.c
@@ -194,5 +194,6 @@ BAREBOX_CMD_HELP_END
 BAREBOX_CMD_START(mmc)
 	.cmd = do_mmc,
 	BAREBOX_CMD_OPTS("enh_area [-c] /dev/mmcX")
+	BAREBOX_CMD_GROUP(CMD_GRP_HWMANIP)
 	BAREBOX_CMD_HELP(cmd_mmc_help)
 BAREBOX_CMD_END
diff --git a/fs/fs.c b/fs/fs.c
index 60fdb29078d6..02ced6d6dfbd 100644
--- a/fs/fs.c
+++ b/fs/fs.c
@@ -3255,6 +3255,7 @@ static int do_lookup_dentry(int argc, char *argv[])
 
 BAREBOX_CMD_START(lookup_dentry)
         .cmd            = do_lookup_dentry,
+	BAREBOX_CMD_GROUP(CMD_GRP_MISC)
 BAREBOX_CMD_END
 
 static struct dentry *debug_follow_mount(struct dentry *dentry)
@@ -3309,5 +3310,6 @@ static int do_debug_fs_dump(int argc, char *argv[])
 
 BAREBOX_CMD_START(debug_fs_dump)
         .cmd            = do_debug_fs_dump,
+	BAREBOX_CMD_GROUP(CMD_GRP_MISC)
 BAREBOX_CMD_END
 #endif
diff --git a/lib/kasan/test_kasan.c b/lib/kasan/test_kasan.c
index e472bb34993b..d0ea91547711 100644
--- a/lib/kasan/test_kasan.c
+++ b/lib/kasan/test_kasan.c
@@ -474,5 +474,6 @@ static int do_kasan_test(int argc, char *argv[])
 BAREBOX_CMD_START(kasan_tests)
         .cmd            = do_kasan_test,
         BAREBOX_CMD_DESC("Run KAsan tests")
+        BAREBOX_CMD_GROUP(CMD_GRP_MISC)
         BAREBOX_CMD_COMPLETE(empty_complete)
 BAREBOX_CMD_END
-- 
2.30.2


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

[PATCH 4/6] Documentation: regulator: reference new directory from index

[Ahmad Fatoum]

The binding was recently added, but unreferenced. Fix this.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/devicetree/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Documentation/devicetree/index.rst b/Documentation/devicetree/index.rst
index 198c4893ff51..d03db3cf8263 100644
--- a/Documentation/devicetree/index.rst
+++ b/Documentation/devicetree/index.rst
@@ -114,4 +114,5 @@ Contents:
    bindings/leds/*
    bindings/misc/*
    bindings/mtd/*
+   bindings/regulator/*
    bindings/rtc/*
-- 
2.30.2


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

[PATCH 5/6] Documentation: boards: openrisc: fix wrong header format

[Ahmad Fatoum]

Build warns that line is too short. Fix it.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/boards/openrisc.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/boards/openrisc.rst b/Documentation/boards/openrisc.rst
index 34586b4a76b3..17b0aef4a6ad 100644
--- a/Documentation/boards/openrisc.rst
+++ b/Documentation/boards/openrisc.rst
@@ -22,7 +22,7 @@ Example of downloading and installing a toolchain::
   $ export PATH=$PATH:$PWD/or1k-elf/bin
 
 Running OpenRISC barebox on qemu
-------------------------------
+--------------------------------
 
 Running barebox on qemu is similar to running linux on qemu see more details on
 the qemu wiki site at https://wiki.qemu.org/Documentation/Platforms/OpenRISC
-- 
2.30.2


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

[PATCH 6/6] Documentation: user: watchdog: note new wd -x option

[Ahmad Fatoum]

wd command documentation is generated automatically and will list the
new -x option. It's still a good idea to reference this in the
watchdog user doc as well. Do so.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/user/watchdog.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Documentation/user/watchdog.rst b/Documentation/user/watchdog.rst
index ff400317a0bc..0220965598ed 100644
--- a/Documentation/user/watchdog.rst
+++ b/Documentation/user/watchdog.rst
@@ -10,6 +10,15 @@ the bootloader. For these scenarios barebox provides the watchdog framework
 with the following functionality and at least ``CONFIG_WATCHDOG`` should be
 enabled.
 
+Disabling for development
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The shorthand command ``wd -x`` will disable all watchdogs.
+If hardware (or driver) doesn't support turning off the watchdog,
+an autpoller will be registered to periodically feed watchdogs.
+This should only be needed for development.
+See :ref:`boot-watchdog-timeout` for how to use the watchdog in the field.
+
 Polling
 ~~~~~~~
 
@@ -98,6 +107,8 @@ device tree or via the ``priority`` device parameter. Normally, watchdogs
 that have a wider effect should be given the higher priority (e.g.
 PMIC watchdog resetting the board vs. SoC's watchdog resetting only itself).
 
+.. _boot-watchdog-timeout:
+
 Boot Watchdog Timeout
 ~~~~~~~~~~~~~~~~~~~~~
 
-- 
2.30.2


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