blob: eefa34779c4391f853a079e048728c4e317b0b8d [file] [log] [blame]
Alex Kiernan312a10f2018-05-29 15:30:39 +00001menu "Fastboot support"
Steve Raee016f0b2016-08-15 17:26:26 -07002
Alex Kiernan312a10f2018-05-29 15:30:39 +00003config FASTBOOT
4 bool
5 imply ANDROID_BOOT_IMAGE
6 imply CMD_FASTBOOT
Steve Raee016f0b2016-08-15 17:26:26 -07007
8config USB_FUNCTION_FASTBOOT
9 bool "Enable USB fastboot gadget"
Alex Kiernan312a10f2018-05-29 15:30:39 +000010 depends on USB_GADGET
11 default y if ARCH_SUNXI && USB_MUSB_GADGET
12 select FASTBOOT
Maxime Ripardcfa34992017-09-07 10:29:51 +020013 select USB_GADGET_DOWNLOAD
Steve Raee016f0b2016-08-15 17:26:26 -070014 help
15 This enables the USB part of the fastboot gadget.
16
Alex Kiernanf73a7df2018-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 Gmeiner046bf8d2022-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 Kiernan312a10f2018-05-29 15:30:39 +000031if FASTBOOT
Steve Raee016f0b2016-08-15 17:26:26 -070032
33config FASTBOOT_BUF_ADDR
34 hex "Define FASTBOOT buffer address"
Tom Rini48f62322017-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 Wiklander0a60a812018-09-25 16:40:23 +020045 default 0 if SANDBOX
Steve Raee016f0b2016-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 Rini48f62322017-08-25 17:50:27 -040053 default 0x8000000 if ARCH_ROCKCHIP
54 default 0x6000000 if ARCH_ZYNQMP
55 default 0x2000000 if ARCH_SUNXI
Jens Wiklander0a60a812018-09-25 16:40:23 +020056 default 0x8192 if SANDBOX
Tom Rini48f62322017-08-25 17:50:27 -040057 default 0x7000000
Steve Raee016f0b2016-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 Protsenko9af5ba82016-10-24 18:41:10 +030063config FASTBOOT_USB_DEV
64 int "USB controller number"
Alex Kiernan312a10f2018-05-29 15:30:39 +000065 depends on USB_FUNCTION_FASTBOOT
Semen Protsenko9af5ba82016-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 Raee016f0b2016-08-15 17:26:26 -070072config FASTBOOT_FLASH
73 bool "Enable FASTBOOT FLASH command"
Jagan Tekia9af59a2019-11-19 13:56:18 +053074 default y if ARCH_SUNXI || ARCH_ROCKCHIP
Miquel Raynal88718be2019-10-03 19:50:03 +020075 depends on MMC || (MTD_RAW_NAND && CMD_MTDPARTS)
Alex Kiernanc232d142018-05-29 15:30:52 +000076 select IMAGE_SPARSE
Steve Raee016f0b2016-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 Schocherbc820d52021-02-10 09:29:03 +010082config FASTBOOT_UUU_SUPPORT
Sean Andersonf3d914c2022-12-16 13:20:16 -050083 bool "Enable UUU support"
Heiko Schocherbc820d52021-02-10 09:29:03 +010084 help
Sean Andersonf3d914c2022-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 Schocherbc820d52021-02-10 09:29:03 +010090
Patrick Delaunayb0cce3f2017-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 Raynal88718be2019-10-03 19:50:03 +0200101 depends on MTD_RAW_NAND && CMD_MTDPARTS
Patrick Delaunayb0cce3f2017-12-07 18:26:17 +0100102
103endchoice
104
Steve Raee016f0b2016-08-15 17:26:26 -0700105config FASTBOOT_FLASH_MMC_DEV
106 int "Define FASTBOOT MMC FLASH default device"
Patrick Delaunayb0cce3f2017-12-07 18:26:17 +0100107 depends on FASTBOOT_FLASH_MMC
Jagan Tekia9af59a2019-11-19 13:56:18 +0530108 default 0 if ARCH_ROCKCHIP
Maxime Ripardde86fc32017-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 Raee016f0b2016-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 Kiernan4085b902018-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 Delaunay3acbc7b2021-01-27 14:46:47 +0100123config FASTBOOT_MMC_BOOT_SUPPORT
124 bool "Enable EMMC_BOOT flash/erase"
125 depends on FASTBOOT_FLASH_MMC
mingming lee1fdbad02020-01-16 16:11:42 +0800126 help
127 The fastboot "flash" and "erase" commands normally does operations
Patrick Delaunay3acbc7b2021-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.
mingming lee1fdbad02020-01-16 16:11:42 +0800132
133config FASTBOOT_MMC_BOOT1_NAME
134 string "Target name for updating EMMC_BOOT1"
Patrick Delaunay3acbc7b2021-01-27 14:46:47 +0100135 depends on FASTBOOT_MMC_BOOT_SUPPORT
mingming lee1fdbad02020-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 Delaunay3acbc7b2021-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 Delaunay75966962021-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
mingming lee1fdbad02020-01-16 16:11:42 +0800166config FASTBOOT_MMC_USER_NAME
Patrick Delaunay75966962021-01-27 14:46:46 +0100167 string "Target name for updating EMMC_USER"
168 depends on FASTBOOT_MMC_USER_SUPPORT
mingming lee1fdbad02020-01-16 16:11:42 +0800169 default "mmc0"
170 help
Patrick Delaunay75966962021-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.
mingming lee1fdbad02020-01-16 16:11:42 +0800175 The default target name for erasing EMMC_USER is "mmc0".
176
Petr Kulhavy6f6c8632016-09-09 10:27:18 +0200177config FASTBOOT_GPT_NAME
178 string "Target name for updating GPT"
Alex Kiernan42d8dd42018-05-29 15:30:42 +0000179 depends on FASTBOOT_FLASH_MMC && EFI_PARTITION
Petr Kulhavy6f6c8632016-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 Kiernan42d8dd42018-05-29 15:30:42 +0000192 depends on FASTBOOT_FLASH_MMC && DOS_PARTITION
Petr Kulhavy6f6c8632016-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 Kiernan3845b902018-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 Delaunayb2f6b972021-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 Delaunay0c0394b2021-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 Andersonf3d914c2022-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. MORINc2948732016-11-13 22:26:13 +0100230endif # FASTBOOT
Alex Kiernan312a10f2018-05-29 15:30:39 +0000231
232endmenu