[PATCH 1/2] Documentation: troubleshooting: mention bootrom command
Ahmad Fatoum
a.fatoum at pengutronix.de
Thu Sep 24 07:53:28 PDT 2026
The bootrom command is easily overlooked, but it's useful when debugging
BootROM refusing to boot on i.MX8M, so mention it.
Signed-off-by: Ahmad Fatoum <a.fatoum at pengutronix.de>
---
Documentation/devel/troubleshooting.rst | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/Documentation/devel/troubleshooting.rst b/Documentation/devel/troubleshooting.rst
index f96b4d2b15ff..796f5eef4f13 100644
--- a/Documentation/devel/troubleshooting.rst
+++ b/Documentation/devel/troubleshooting.rst
@@ -142,6 +142,17 @@ System-on-Chip.
functions that can be used to toggle a GPIO. These can be used for
debugging early hangs by toggling an LED for example.
+- Inspect via fallback boot method
+
+ On some systems, a failure to boot from one boot medium causes the
+ BootROM to try a fallback. If the fallback can actually boot barebox,
+ you may be able to get more information once the shell is reached.
+ For example, if the BootROM refuses eMMC boot, is eMMC at least usable
+ from within barebox?
+ barebox can also decode BootROM logs on some SoCs via
+ :ref:`command_bootrom`, which can answer questions as whether the
+ BootROM even attempted access to the desired boot medium.
+
- Trace BootROM activity
If you have no indication that the barebox prebootloader is being started,
--
2.47.3
More information about the barebox
mailing list