Bootburn Usage

Bootburn

Bootburn is a shell script that:

• Boots the device in recovery mode with RAMDisk. Recovery Mode is where BootROM waits on recovery USB to receive data. All boot images are received from the host by NVIDIA Orin over USB and stored in RAM. The system is booted using the data stored in RAM.
• Signs or generates the images on the host.
• Transfers the images to target using ADB.
• Flashes the boards.

Bootburn automatically resizes the rootfs image on the target to optimize the available storage on the partition dedicated to it, either on eMMC or NOR.

Bootburn supports a host NFS share as the mount point for the target rootfs. This feature provides a convenient way for developers to copy files between the target and host for rapid development. In this case, the uncompressed target rootfs directory on the host is leveraged directly by the target.

Bootburn relies on the Foundation services to provide the flashing and boot loader functionality. You configure it with the CFG file rather than with Bootburn command-line parameters; Bootburn supports limited command line options.

Bootburn Command Usage

./tools/flashtools/bootburn/bootburn.py <options>

"AES" : {
"SBK" :
{
"IV" : OEM_FUSE_IV,
"Manifest" : "10860000",
"Offset" : "0d01",
#"Plain" : "63979cd900154cfaedc539cd17572387296058fe988013c055be99bfd8db41f9",
"Plain" : "753aafbeab213322ef0f8cecc805d1b086e252953dfb3cac215a778f68cb5a72",
#"Plain" : "0000000000000000000000000000000000000000000000000000000000000000",

Kernel Parameter Combinations

Possible combinations of kernel parameters nfsdev, ip, and nfsroot are as follows. An error indicates that the initramfs shell is started.

Passing Additional Kernel Parameters

drive-<TBD_platform_ver>-foundation/platform-config/hardware/nvidia/platform/t23x/automotive/pct/drive_av/<pct>/qnx_gos0_storage.cfg

Dialout Group

Add yourself to the dialout group since it is not possible to open the serial ports to the AURIX via sudo.

sudo adduser <user name> dialout

You must log out and log back in for the command to take effect.

Bootburn Configuration File

The following is the list of keys that can be added to a JSON file and their meanings.

Example Board Configuration File

The following is an example of a JSON file. You can either use built-in path substitution or full paths names.

The built-in string substitutions are for PDK.

p3663-a01

{
    "p3663-a01":
    {
        "f_BootromCfg":"<p_PlatformBCT>/p3663/reset/tegra234-mb1-bct-p3663-a01-reset.dts",
        "f_BrBctDevParam":"<p_PlatformBCT>/common/bootrom/tegra234-br-bct-auto-<l_BootDevice>.dts",
        "f_NvQbDtbImage":"t23x-refs.dtb",
        "f_MB1Pad":"<p_PlatformBCT>/p3663/padvoltage/tegra23x-mb1-bct-p3663-a01-padvoltage-default.dts",
        "f_MB1Pinmux":"<p_PlatformBCT>/p3663/pinmux/tegra23x-mb1-bct-p3663-a01-pinmux.dts",
        "f_MB1Prod":"<p_PlatformBCT>/p3663/prod/tegra234-mb1-bct-p3663-a01-prod.dts",
        "f_MB1Pmic":"<p_PlatformBCT>/p3663/pmic/tegra234-mb1-bct-p3663-a01-pmic.dts",
        "f_MB1Misc":"<p_PlatformBCT>/p3663/misc/tegra234-mb1-bct-p3663-a01-misc.dts",
        "f_MB1Misc_Carveout":"<p_BCT>/misc/tegrabl_carveout_id.h",
        "f_MB2Bct":"<p_PlatformBCT>/p3663/misc/tegra234-mb2-bct-p3663-a01-auto.dts",
        "f_MB1VDK":"<NV_OUTDIR>/nvidia/bootloader/mb1-private/soc/t234/build/standard-boot/mb1_t234.bin",
        "f_FlashingMB1SdRamParam":"<p_PlatformBCT>/p3663/sdram/t234-p3663-a01-sdram.dts",
        "f_MB1SdRamParam":"<p_PlatformBCT>/p3663/sdram/t234-p3663-a01-sdram.dts",
        "f_MB1wb0SdRamParam":"<p_PlatformBCT>/p3663/sdram/t234-p3663-a01-sdram.dts",
        "f_MB1GpioInt":"<p_PlatformBCT>/p3663/gpioint/tegra234-mb1-bct-p3663-a01-gpioint.dts",
        "f_MB1BootDevice":"<p_PlatformBCT>/p3663/device/tegra234-mb1-bct-p3663-a01-device.dts",
        "f_MB2Scr":"<p_PlatformBCT>/p3663/firewall/tegra234-mb2-bct-p3663-a01-firewall.dts",
        "s_Kernel_Dtb_Variant":"p3663-0001-a01",
        "f_DtbImg":"tegra234-p3663-0001-a01-linux-native<s_DtbImgSuffix>.dtb",
        "f_FlashingDtbImg":"tegra234-p3663-0001-a01-flashing_base.dtb",
        "f_BpmpFwDtb":"tegra234-bpmp-3663-0001-a01.dtb",
        "s_BPMP_Dtb_Variant":"bpmp-3663-0001-a01",
        "f_FlashingBpmpFwDtb":"tegra234-bpmp-3663-0001-a01.dtb",
        "f_UFSPhyLaneFile":"<p_PlatformBCT>/p3663/uphy-lanes/tegra234-mb1-bct-p3663-a01-uphylane.dts",
        "s_FuseBypass":"fuse_bypass_t234.bin",
        "s_GrCsvString":"P3663",
        "s_ChipFamily":"t23x",
        "s_Soc":"t234",
        "s_chipID":"0x23",
        "s_Int":"F0",
        "f_SignedCustomerData":"p3663_signed_customer_data.json"
        "n_DramOverride":"True"
    }
}

Example of Successful Flash

Bootburn completed successfully!
 
Bootburn Time 505.16470408439636 seconds
 
returning to directory /media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py
Cleaning up ...
    Cleaning temp dir

Example of Unsuccessful Flash

------------ Stack Trace ------------
stack frame 0 : PrintStackTrace(234) in /media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py/flashtools_nverror.py
 
stack frame 1 : AbnormalTermination(250) in /media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py/flashtools_nverror.py
 
stack frame 2 : GenerateImage(1791) in /media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py/bootburn_lib.py
 
stack frame 3 : CreateFlashImages(1926) in /media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py/bootburn_lib.py
 
stack frame 4 : bootburn_active(94) in ./bootburn.py
 
stack frame 5 : run(93) in /usr/lib/python3.4/multiprocessing/process.py
 
stack frame 6 : _bootstrap(254) in /usr/lib/python3.4/multiprocessing/process.py
 
stack frame 7 : _launch(77) in /usr/lib/python3.4/multiprocessing/popen_fork.py
 
stack frame 8 : __init__(21) in /usr/lib/python3.4/multiprocessing/popen_fork.py
 
stack frame 9 : _Popen(267) in /usr/lib/python3.4/multiprocessing/context.py
 
stack frame 10 : _Popen(212) in /usr/lib/python3.4/multiprocessing/context.py
 
stack frame 11 : start(105) in /usr/lib/python3.4/multiprocessing/process.py
 
stack frame 12 : bootburn(280) in ./bootburn.py
 
stack frame 13 : bootburnCommandLine(355) in ./bootburn.py
 
stack frame 14 : <module>(359) in ./bootburn.py
 
-------------------------------------
 
s_ERROR_TOOL_NVIMAGEGEN
 
ERROR CODE = 53
 s_ERROR_TOOL_NVIMAGEGEN
Exception raised in bootburn_active
Traceback (most recent call last):
  File "./bootburn.py", line 94, in bootburn_active
    bootburnLib.CreateFlashImages(targetConfig.f_FlashCfg)
  File "/media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py/bootburn_lib.py", line 1926, in CreateFlashImages
    self.GenerateImage(configFiles, l_Operation, p_TempDumpPath)
  File "/media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py/bootburn_lib.py", line 1791, in GenerateImage
    AbnormalTermination("s_ERROR_TOOL_NVIMAGEGEN", nverror.NvError_NvImagegen)
  File "/media/home/t186-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py/flashtools_nverror.py", line 258, in AbnormalTermination
    raise OSError(errorCode)
OSError: 53
 
returning to directory /media/home/t234-dev-main-1201/foundation/embedded/tools-t23x/scripts/t234_bootburn_py
Cleaning up ...
    Cleaning temp dir

Decoding Errors

Additional information is needed to fully determine the cause of some errors. That information can be found in the log files. The command executed determines the name of the log file (bootburn.txt, bootburnTegra-A.txt, BootburnTegra-B.txt, create_bsp.txt, or flash_bsp.txt). in the _t194_bootburn_py folder.

USB Bus Access without sudo

sudo access is required to enable USB bus access. Edit or create 90-nvidia.rules located at /etc/udev/rules.d. Add the line:

SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="0955", MODE:="0666"

To reload the udev rules, run:

udevadm control --reload