blob: eefa34779c4391f853a079e048728c4e317b0b8d [file] [log] [blame]
Alex Kiernan65de9552018-05-29 15:30:39 +00001menu "Fastboot support"
Steve Rae437689f2016-08-15 17:26:26 -07002
Alex Kiernan65de9552018-05-29 15:30:39 +00003config FASTBOOT
4 bool
5 imply ANDROID_BOOT_IMAGE
6 imply CMD_FASTBOOT
Steve Rae437689f2016-08-15 17:26:26 -07007
8config USB_FUNCTION_FASTBOOT
9 bool "Enable USB fastboot gadget"
Alex Kiernan65de9552018-05-29 15:30:39 +000010 depends on USB_GADGET
11 default y if ARCH_SUNXI && USB_MUSB_GADGET
12 select FASTBOOT
Maxime Ripard6d7dfe22017-09-07 10:29:51 +020013 select USB_GADGET_DOWNLOAD
Steve Rae437689f2016-08-15 17:26:26 -070014 help
15 This enables the USB part of the fastboot gadget.
16
Alex Kiernand5aa57c2018-05-29 15:30:53 +000017config UDP_FUNCTION_FASTBOOT
18 depends on NET
19 select FASTBOOT
20 bool "Enable fastboot protocol over UDP"
21 help
22 This enables the fastboot protocol over UDP.
23
Christian Gmeiner7fd97aa2022-01-13 08:40:06 +010024config UDP_FUNCTION_FASTBOOT_PORT
25 depends on UDP_FUNCTION_FASTBOOT
26 int "Define FASTBOOT UDP port"
27 default 5554
28 help
29 The fastboot protocol requires a UDP port number.
30
Alex Kiernan65de9552018-05-29 15:30:39 +000031if FASTBOOT
Steve Rae437689f2016-08-15 17:26:26 -070032
33config FASTBOOT_BUF_ADDR
34 hex "Define FASTBOOT buffer address"
Tom Rinib5bf5622017-08-25 17:50:27 -040035 default 0x82000000 if MX6SX || MX6SL || MX6UL || MX6SLL
36 default 0x81000000 if ARCH_OMAP2PLUS
37 default 0x42000000 if ARCH_SUNXI && !MACH_SUN9I
38 default 0x22000000 if ARCH_SUNXI && MACH_SUN9I
39 default 0x60800800 if ROCKCHIP_RK3036 || ROCKCHIP_RK3188 || \
40 ROCKCHIP_RK322X
41 default 0x800800 if ROCKCHIP_RK3288 || ROCKCHIP_RK3329 || \
42 ROCKCHIP_RK3399
43 default 0x280000 if ROCKCHIP_RK3368
44 default 0x100000 if ARCH_ZYNQMP
Jens Wiklanderf1edae92018-09-25 16:40:23 +020045 default 0 if SANDBOX
Steve Rae437689f2016-08-15 17:26:26 -070046 help
47 The fastboot protocol requires a large memory buffer for
48 downloads. Define this to the starting RAM address to use for
49 downloaded images.
50
51config FASTBOOT_BUF_SIZE
52 hex "Define FASTBOOT buffer size"
Tom Rinib5bf5622017-08-25 17:50:27 -040053 default 0x8000000 if ARCH_ROCKCHIP
54 default 0x6000000 if ARCH_ZYNQMP
55 default 0x2000000 if ARCH_SUNXI
Jens Wiklanderf1edae92018-09-25 16:40:23 +020056 default 0x8192 if SANDBOX
Tom Rinib5bf5622017-08-25 17:50:27 -040057 default 0x7000000
Steve Rae437689f2016-08-15 17:26:26 -070058 help
59 The fastboot protocol requires a large memory buffer for
60 downloads. This buffer should be as large as possible for a
61 platform. Define this to the size available RAM for fastboot.
62
Semen Protsenko97bb3f82016-10-24 18:41:10 +030063config FASTBOOT_USB_DEV
64 int "USB controller number"
Alex Kiernan65de9552018-05-29 15:30:39 +000065 depends on USB_FUNCTION_FASTBOOT
Semen Protsenko97bb3f82016-10-24 18:41:10 +030066 default 0
67 help
68 Some boards have USB OTG controller other than 0. Define this
69 option so it can be used in compiled environment (e.g. in
70 CONFIG_BOOTCOMMAND).
71
Steve Rae437689f2016-08-15 17:26:26 -070072config FASTBOOT_FLASH
73 bool "Enable FASTBOOT FLASH command"
Jagan Teki04aae032019-11-19 13:56:18 +053074 default y if ARCH_SUNXI || ARCH_ROCKCHIP
Miquel Raynald0935362019-10-03 19:50:03 +020075 depends on MMC || (MTD_RAW_NAND && CMD_MTDPARTS)
Alex Kiernanc568bcb2018-05-29 15:30:52 +000076 select IMAGE_SPARSE
Steve Rae437689f2016-08-15 17:26:26 -070077 help
78 The fastboot protocol includes a "flash" command for writing
79 the downloaded image to a non-volatile storage device. Define
80 this to enable the "fastboot flash" command.
81
Heiko Schocher3a994482021-02-10 09:29:03 +010082config FASTBOOT_UUU_SUPPORT
Sean Anderson421bec02022-12-16 13:20:16 -050083 bool "Enable UUU support"
Heiko Schocher3a994482021-02-10 09:29:03 +010084 help
Sean Anderson421bec02022-12-16 13:20:16 -050085 This extends the fastboot protocol with the "UCmd" and "ACmd"
86 commands, which are used by NXP's "universal update utility" (UUU).
87 These commands allow running any shell command. Do not enable this
88 feature if you are using verified boot, as it will allow an attacker
89 to bypass any restrictions you have in place.
Heiko Schocher3a994482021-02-10 09:29:03 +010090
Patrick Delaunay99a8e032017-12-07 18:26:17 +010091choice
92 prompt "Flash provider for FASTBOOT"
93 depends on FASTBOOT_FLASH
94
95config FASTBOOT_FLASH_MMC
96 bool "FASTBOOT on MMC"
97 depends on MMC
98
99config FASTBOOT_FLASH_NAND
100 bool "FASTBOOT on NAND"
Miquel Raynald0935362019-10-03 19:50:03 +0200101 depends on MTD_RAW_NAND && CMD_MTDPARTS
Patrick Delaunay99a8e032017-12-07 18:26:17 +0100102
103endchoice
104
Steve Rae437689f2016-08-15 17:26:26 -0700105config FASTBOOT_FLASH_MMC_DEV
106 int "Define FASTBOOT MMC FLASH default device"
Patrick Delaunay99a8e032017-12-07 18:26:17 +0100107 depends on FASTBOOT_FLASH_MMC
Jagan Teki04aae032019-11-19 13:56:18 +0530108 default 0 if ARCH_ROCKCHIP
Maxime Ripard65cefba2017-08-23 10:12:22 +0200109 default 0 if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA = -1
110 default 1 if ARCH_SUNXI && MMC_SUNXI_SLOT_EXTRA != -1
Steve Rae437689f2016-08-15 17:26:26 -0700111 help
112 The fastboot "flash" command requires additional information
113 regarding the non-volatile storage device. Define this to
114 the eMMC device that fastboot should use to store the image.
115
Alex Kiernandc405852018-05-29 15:30:51 +0000116config FASTBOOT_FLASH_NAND_TRIMFFS
117 bool "Skip empty pages when flashing NAND"
118 depends on FASTBOOT_FLASH_NAND
119 help
120 When flashing NAND enable the DROP_FFS flag to drop trailing all-0xff
121 pages.
122
Patrick Delaunay2579b0e2021-01-27 14:46:47 +0100123config FASTBOOT_MMC_BOOT_SUPPORT
124 bool "Enable EMMC_BOOT flash/erase"
125 depends on FASTBOOT_FLASH_MMC
developer6a105562020-01-16 16:11:42 +0800126 help
127 The fastboot "flash" and "erase" commands normally does operations
Patrick Delaunay2579b0e2021-01-27 14:46:47 +0100128 on eMMC userdata. Define this to enable the special commands to
129 flash/erase eMMC boot partition.
130 The default target name for updating eMMC boot partition 1/2 is
131 CONFIG_FASTBOOT_MMC_BOOT1_NAME/CONFIG_FASTBOOT_MMC_BOOT2_NAME.
developer6a105562020-01-16 16:11:42 +0800132
133config FASTBOOT_MMC_BOOT1_NAME
134 string "Target name for updating EMMC_BOOT1"
Patrick Delaunay2579b0e2021-01-27 14:46:47 +0100135 depends on FASTBOOT_MMC_BOOT_SUPPORT
developer6a105562020-01-16 16:11:42 +0800136 default "mmc0boot0"
137 help
138 The fastboot "flash" and "erase" commands support operations on
139 EMMC_BOOT1. This occurs when the specified "EMMC_BOOT1 name" on
140 the "fastboot flash" and "fastboot erase" commands match the value
141 defined here.
142 The default target name for updating EMMC_BOOT1 is "mmc0boot0".
143
Patrick Delaunay2579b0e2021-01-27 14:46:47 +0100144config FASTBOOT_MMC_BOOT2_NAME
145 string "Target name for updating EMMC_BOOT2"
146 depends on FASTBOOT_MMC_BOOT_SUPPORT
147 default "mmc0boot1"
148 help
149 The fastboot "flash" and "erase" commands support operations on
150 EMMC_BOOT2. This occurs when the specified "EMMC_BOOT2 name" on
151 the "fastboot flash" and "fastboot erase" commands match the value
152 defined here.
153 The default target name for updating EMMC_BOOT2 is "mmc0boot1".
154
Patrick Delaunay8b0a29a2021-01-27 14:46:46 +0100155config FASTBOOT_MMC_USER_SUPPORT
156 bool "Enable eMMC userdata partition flash/erase"
157 depends on FASTBOOT_FLASH_MMC
158 help
159 Define this to enable the support "flash" and "erase" command on
160 eMMC userdata. The "flash" command only update the MBR and GPT
161 header when CONFIG_EFI_PARTITION is supported.
162 The "erase" command erase all the userdata.
163 This occurs when the specified "partition name" on the
164 fastboot command line matches the value CONFIG_FASTBOOT_MMC_USER_NAME.
165
developer6a105562020-01-16 16:11:42 +0800166config FASTBOOT_MMC_USER_NAME
Patrick Delaunay8b0a29a2021-01-27 14:46:46 +0100167 string "Target name for updating EMMC_USER"
168 depends on FASTBOOT_MMC_USER_SUPPORT
developer6a105562020-01-16 16:11:42 +0800169 default "mmc0"
170 help
Patrick Delaunay8b0a29a2021-01-27 14:46:46 +0100171 The fastboot "flash" and "erase" command supports EMMC_USER.
172 This occurs when the specified "EMMC_USER name" on the
173 "fastboot flash" and the "fastboot erase" commands match the value
174 defined here.
developer6a105562020-01-16 16:11:42 +0800175 The default target name for erasing EMMC_USER is "mmc0".
176
Petr Kulhavy4ed1eca2016-09-09 10:27:18 +0200177config FASTBOOT_GPT_NAME
178 string "Target name for updating GPT"
Alex Kiernan8cb1eab2018-05-29 15:30:42 +0000179 depends on FASTBOOT_FLASH_MMC && EFI_PARTITION
Petr Kulhavy4ed1eca2016-09-09 10:27:18 +0200180 default "gpt"
181 help
182 The fastboot "flash" command supports writing the downloaded
183 image to the Protective MBR and the Primary GUID Partition
184 Table. (Additionally, this downloaded image is post-processed
185 to generate and write the Backup GUID Partition Table.)
186 This occurs when the specified "partition name" on the
187 "fastboot flash" command line matches the value defined here.
188 The default target name for updating GPT is "gpt".
189
190config FASTBOOT_MBR_NAME
191 string "Target name for updating MBR"
Alex Kiernan8cb1eab2018-05-29 15:30:42 +0000192 depends on FASTBOOT_FLASH_MMC && DOS_PARTITION
Petr Kulhavy4ed1eca2016-09-09 10:27:18 +0200193 default "mbr"
194 help
195 The fastboot "flash" command allows to write the downloaded image
196 to the Master Boot Record. This occurs when the "partition name"
197 specified on the "fastboot flash" command line matches the value
198 defined here. The default target name for updating MBR is "mbr".
199
Alex Kiernanc86cde92018-05-29 15:30:54 +0000200config FASTBOOT_CMD_OEM_FORMAT
201 bool "Enable the 'oem format' command"
202 depends on FASTBOOT_FLASH_MMC && CMD_GPT
203 help
204 Add support for the "oem format" command from a client. This
205 relies on the env variable partitions to contain the list of
206 partitions as required by the gpt command.
207
Patrick Delaunay61687702021-01-27 14:46:48 +0100208config FASTBOOT_CMD_OEM_PARTCONF
209 bool "Enable the 'oem partconf' command"
210 depends on FASTBOOT_FLASH_MMC && SUPPORT_EMMC_BOOT
211 help
212 Add support for the "oem partconf" command from a client. This set
213 the mmc boot-partition for the selecting eMMC device.
214
Patrick Delaunay67af29a2021-01-27 14:46:49 +0100215config FASTBOOT_CMD_OEM_BOOTBUS
216 bool "Enable the 'oem bootbus' command"
217 depends on FASTBOOT_FLASH_MMC && SUPPORT_EMMC_BOOT
218 help
219 Add support for the "oem bootbus" command from a client. This set
220 the mmc boot configuration for the selecting eMMC device.
221
Sean Anderson421bec02022-12-16 13:20:16 -0500222config FASTBOOT_OEM_RUN
223 bool "Enable the 'oem run' command"
224 help
225 This extends the fastboot protocol with an "oem run" command. This
226 command allows running arbitrary U-Boot shell commands. Do not enable
227 this feature if you are using verified boot, as it will allow an
228 attacker to bypass any restrictions you have in place.
229
Yann E. MORIN3d2561f2016-11-13 22:26:13 +0100230endif # FASTBOOT
Alex Kiernan65de9552018-05-29 15:30:39 +0000231
232endmenu