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 <[email protected]> --- 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
