NAME

       rpiboot - Boot a Raspberry Pi in device mode

SYNOPSIS

       rpiboot [-d directory] [-l] [-o] [-m delay] [-v] [-s] [-0|1|2|3|4|5|6]

       rpiboot -h

DESCRIPTION

       rpiboot  is a command line utility for booting a Raspberry Pi in USB device mode.  Firmwares are provided
       to boot a Pi directly as a mass storage device (particularly useful for flashing Compute  Module  devices
       with  on-board  eMMC  storage), or you may provide a set of boot files in a directory from which to boot.
       This can contain an initramfs to boot with a Linux kernel.

       For more information about the bootloader EEPROM please see [EEPROM].

OPTIONS

       -d directory
              Boot the device using the boot files in directory.  Without this option, boot the device into mass
              storage device (MSD) mode.

       -l     Loop  forever.  Without  this  option,  the  application  will  exit once the boot files have been
              successfully transferred, and the device re-appears on  the  USB  bus  (e.g.  as  a  mass  storage
              device).

       -o     Used  in  conjunction  with  -d  to specify that files from the “overlay” sub-directory (under the
              directory specified with -d) should be used, if they exist.

       -m delay
              The number of micro-seconds delay between checking for new devices. Defaults to 500µs.

       -v     Produce more verbose output.

       -s     Sign boot files using bootsig.bin

       -0|1|2|3|4|5|6
              Only look for Compute Modules attached to USB port number 0 through 6.

       -h     Display a brief help page.

EXAMPLES

       rpiboot
              Boot an attached Compute Module as a mass storage device (MSD).

       rpiboot -v -1
              Boot a Compute Module on USB port 1 (only) as a mass storage device, with verbose reporting.

       rpiboot -d recovery
              Flash the default bootloader EEPROM image onto a Compute Module 4

SEE ALSO

       rpi-eeprom-update(1), rpi-eeprom-config(1)

REFERENCES

       [EEPROM]
              ⟨https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#raspberry-pi-4-boot-eeprom⟩

                                                   2022-01-31                                         RPIBOOT(1)