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>

tegrarcm-1.6                                    29 November 2012                                     tegrarcm(1)