aboutsummaryrefslogtreecommitdiff
path: root/include/button.h
diff options
context:
space:
mode:
authorCaleb Connolly <caleb.connolly@linaro.org>2024-01-09 11:51:09 +0000
committerTom Rini <trini@konsulko.com>2024-02-13 15:38:49 -0500
commite761035b64235db8930eb15d2703dc3f43e99224 (patch)
tree55a006d2199d296ed551840a84eaeab7ab64158f /include/button.h
parent348ea878508de90fdcc5a051cabe05d190e40e35 (diff)
downloadu-boot-e761035b64235db8930eb15d2703dc3f43e99224.zip
u-boot-e761035b64235db8930eb15d2703dc3f43e99224.tar.gz
u-boot-e761035b64235db8930eb15d2703dc3f43e99224.tar.bz2
boot: add support for button commands
With the relatively new button API in U-Boot, it's now much easier to model the common usecase of mapping arbitrary actions to different buttons during boot - for example entering fastboot mode, setting some additional kernel cmdline arguments, or booting with a custom recovery ramdisk, to name a few. Historically, this functionality has been implemented in board code, making it fixed for a given U-Boot binary and requiring the code be duplicated and modified for every board. Implement a generic abstraction to run an arbitrary command during boot when a specific button is pressed. The button -> command mapping is configured via environment variables with the following format: button_cmd_N_name=<button label> button_cmd_N=<command to run> Where N is the mapping number starting from 0. For example: button_cmd_0_name=vol_down button_cmd_0=fastboot usb 0 This will cause the device to enter fastboot mode if volume down is held during boot. After we enter the cli loop the button commands are no longer valid, this allows the buttons to additionally be used for navigating a boot menu. Tested-by: Svyatoslav Ryhel <clamor95@gmail.com> # Tegra30 Signed-off-by: Caleb Connolly <caleb.connolly@linaro.org>
Diffstat (limited to 'include/button.h')
-rw-r--r--include/button.h9
1 files changed, 9 insertions, 0 deletions
diff --git a/include/button.h b/include/button.h
index 207f4a0..8d38e52 100644
--- a/include/button.h
+++ b/include/button.h
@@ -74,4 +74,13 @@ enum button_state_t button_get_state(struct udevice *dev);
*/
int button_get_code(struct udevice *dev);
+#if IS_ENABLED(CONFIG_BUTTON_CMD)
+/* Process button command mappings specified in the environment,
+ * running the commands for buttons which are pressed
+ */
+void process_button_cmds(void);
+#else
+static inline void process_button_cmds(void) {}
+#endif /* CONFIG_BUTTON_CMD */
+
#endif