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)