u-boot/doc/usage/cmd/ebtupdate.rst
Tom Rini 11da3403e9 doc: usage: Add general rule for $?
For nearly all commands in U-Boot the '?' variable is handled the same
way with 0 meaning success, 1 meaning any failure.  Explain this in the
general rules section of the cmdline documentation (with a link to a
counter example) and then remove the redundant wording from most
commands. We retain a section about the return value in a number of
places where we are doing something such as always returning a specific
value or we have useful additional information to go along with the
normal return codes.

Signed-off-by: Tom Rini <trini@konsulko.com>
Reviewed-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
2025-10-26 09:03:35 -06:00

67 lines
1.7 KiB
ReStructuredText

.. SPDX-License-Identifier: GPL-2.0+:
.. index::
single: ebtupdate (command)
ebtupdate command
=================
Synopsis
--------
::
ebtupdate [<bct> [<ebt>] [<size>]]
Description
-----------
The "ebtupdate" command is used to self-update bootloader on Tegra 2 and Tegra 3
production devices which were processed using re-cryption.
The "ebtupdate" performs encryption of new bootloader and decryption, patching
and re-encryption of BCT "in situ". After BCT and bootloader can be written in
their respective places.
bct
address of BCT block pre-loaded into RAM.
ebt
address of the bootloader pre-loaded into RAM.
size
size of the pre-loaded bootloader.
Example
-------
This is the boot log of a LG Optimus Vu:
::
=> mmc dev 0 1
switch to partitions #1, OK
mmc0(part 1) is current device
=> mmc read $kernel_addr_r 0 $boot_block_size
MMC read: dev # 0, block # 0, count 4096 ... 4096 blocks read: OK
=> load mmc 0:1 $ramdisk_addr_r $bootloader_file
684783 bytes read in 44 ms (14.8 MiB/s)
=> size mmc 0:1 $bootloader_file
=> ebtupdate $kernel_addr_r $ramdisk_addr_r $filesize
=> mmc dev 0 1
switch to partitions #1, OK
mmc0(part 1) is current device
=> mmc write $kernel_addr_r 0 $boot_block_size
MMC write: dev # 0, block # 0, count 4096 ... 4096 blocks written: OK
=> mmc dev 0 2
switch to partitions #2, OK
mmc0(part 2) is current device
=> mmc write $ramdisk_addr_r 0 $boot_block_size
MMC write: dev # 0, block # 0, count 4096 ... 4096 blocks written: OK
Configuration
-------------
The ebtupdate command is only available if CONFIG_CMD_EBTUPDATE=y and
only on Tegra 2 and Tegra 3 configurations.