tegrarcm(1)

NAME
tegrarcm - tegra firmware download utility

SYNOPSIS
tegrarcm [ options ]

DESCRIPTION
This program is used to send code to a Tegra device in recovery mode. It does not supported locked devices with an encrypted boot key, only open devices such as the ventana or cardhu reference boards. It is not capable of flashing firmware to a device, but can be used to download firmware that is then capable of flashing. For example in ChromeOS tegrarcm is used to download a special build of u-boot to the target Tegra device with a payload that it then flashes to the boot device.

  Platforms supported

•   Tegra20

•   Tegra30

•   Tegra114

•   Tegra124

  How to use

—   Connect a USB cable from your development system to your Tegra device. You will either need a USB A to A cable or A to micro B depending on the target board.

—   Find the appropriate BCT file for your board. For reference boards, BCT files can be found in the L4T distribution from NVIDIA.

—   Build some firmware for your device (such as u-boot)

—   Run tegrarcm to download the firmware

COMMANDS

readbct
    Read the BCT from the target device and write it to bctfile.

OPTIONS

--bct bctfile
    Specify the BCT file to download to the Tegra device. This file contains memory configuation information for the board. BCT files can be obtained through the NVIDIA L4T distribution or generated with cbootimage and a proper configuration file.

--bootloader blfile
    Specify the bootloader file to download to the Tegra device. This is the firmware file that will be downloaded and executed.

--loadaddr loadaddr
    Specify the address the bootloader will be loaded at. This should be specified in hex and is typically 0x108000 for a Tegra20 device or 0x80108000 for a Tegra30, Tegra114, or Tegra124 device.

--entryaddr entryaddr
    Specify the entry address that control will be passed to after the firmware is loaded. This should be specified in hex. If this option is omitted it is assumed to be the same as the load address.

--version
    Print the version number and exit.

--help
    Print help text and exit.

--miniloader mlfile
    Read the miniloader from the specified file instead of using the built-in one.

--miniloader_entry mlentry
    Specify the entry address of the miniloader.

EXAMPLES
To download u-boot firmware to a Tegra20 seaboard:
$ sudo tegrarcm --bct seaboard.bct --bootloader u-boot.bin --loadaddr 0x108000
bct file: seaboard.bct
booloader file: u-boot.bin
load addr 0x108000
entry addr 0x108000
device id: 0x7820
uid:  0x33c20c0413fb217
RCM version: 2.1
downloading miniloader to target...
miniloader downloaded successfully
Chip UID:                0x33c20c0413fb217
Chip ID:                 0x20
Chip ID Major Version:   0x1
Chip ID Minor Version:   0x4
Chip SKU:                0x18 (t25)
Boot ROM Version:        0x1
Boot Device:             0x3 (SPI)
Operating Mode:          0x3 (developer mode)
Device Config Strap:     0x0
Device Config Fuse:      0x0
SDRAM Config Strap:      0x0
sending file: seaboard.bct
- 4080/4080 bytes sent
seaboard.bct sent successfully
sending file: u-boot.bin
- 268314/268314 bytes sent
u-boot.bin sent successfully
To read the BCT from a system:
$ sudo tegrarcm --bct ventana.bct readbct
bct file: ventana.bct
device id: 0x7820
reading BCT from system, writing to ventana.bct...done!

RETURN VALUE
If any error occurs a non zero exit status is returned.

SEE ALSO
cbootimage(1),

AUTHOR
Allen Martin, <amartin@nvidia.com>