From 7c6e41c5204ef06986ad6127120a009dc855e4ec Mon Sep 17 00:00:00 2001 From: Vanessa Maegima Date: Wed, 18 Oct 2023 18:28:50 -0300 Subject: [PATCH] ug: troubleshooting: add instructions on changing boot delay Signed-off-by: Vanessa Maegima --- .../troubleshooting/troubleshooting.rst | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/source/user-guide/troubleshooting/troubleshooting.rst b/source/user-guide/troubleshooting/troubleshooting.rst index 4725f26fa..938f8fba4 100644 --- a/source/user-guide/troubleshooting/troubleshooting.rst +++ b/source/user-guide/troubleshooting/troubleshooting.rst @@ -480,6 +480,51 @@ Secure storage also can be leveraged to store custom device information, like MA You may wish to retrieve these values from the application. Please refer to the `fiovb-container `_ example, which brings a simple application to run ``fiovb_printenv`` from inside a container. +.. _ref-ts-bootdelay: + +Enable U-Boot Boot Delay +^^^^^^^^^^^^^^^^^^^^^^^^ + +By default, LmP disables U-Boot's boot delay feature for security purposes. However, this is a powerful ally during the development phase, as it provides direct access to U-Boot's environment for debugging. + +* **Secured/Closed Boards** + +This requires changing the ``lmp.cfg`` U-Boot config fragment in order to override ``CONFIG_BOOTDELAY=-2`` set by default in LmP. + +1. Create ``bootdelay.cfg`` configuration fragment: + +**meta-subscriber-overrides/recipes-bsp/u-boot/u-boot-fio//bootdelay.cfg:** + +.. code-block:: + + CONFIG_BOOTDELAY=3 + +2. Append it to the U-Boot source: + +**meta-subscriber-overrides/recipes-bsp/u-boot/u-boot-fio_%.bbappend** + +.. code-block:: + + FILESEXTRAPATHS:prepend := "${THISDIR}/${PN}:" + + SRC_URI:append = " \ + file://bootdelay.cfg \ + " + +After pushing to the Factory, it is necessary to trigger :ref:`ref-boot-software-updates` for the devices to take the update, or re-flash the device entirely to include this change. + +* **Open Boards** + +Open/non-secured boards also benefit from the procedure detailed for secured boards, however as they rely on U-Boot env support, there is a handier way on enabling boot delay during runtime: + +.. prompt:: + + $ sudo su + # fw_setenv bootdelay 3 + # reboot + +After reboot, the device shows the U-Boot bootdelay prompt. + .. _ref-ts-tips: Tips and Abouts