xref: /freebsd/sys/contrib/device-tree/Bindings/power/reset/reboot-mode.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotGeneric reboot mode core map driver
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotThis driver get reboot mode arguments and call the write
4*c66ec88fSEmmanuel Vadotinterface to store the magic value in special register
5*c66ec88fSEmmanuel Vadotor ram. Then the bootloader can read it and take different
6*c66ec88fSEmmanuel Vadotaction according to the argument stored.
7*c66ec88fSEmmanuel Vadot
8*c66ec88fSEmmanuel VadotAll mode properties are vendor specific, it is a indication to tell
9*c66ec88fSEmmanuel Vadotthe bootloader what to do when the system reboots, and should be named
10*c66ec88fSEmmanuel Vadotas mode-xxx = <magic> (xxx is mode name, magic should be a none-zero value).
11*c66ec88fSEmmanuel Vadot
12*c66ec88fSEmmanuel VadotFor example modes common on Android platform:
13*c66ec88fSEmmanuel Vadot- mode-normal: Normal reboot mode, system reboot with command "reboot".
14*c66ec88fSEmmanuel Vadot- mode-recovery: Android Recovery mode, it is a mode to format the device or update a new image.
15*c66ec88fSEmmanuel Vadot- mode-bootloader: Android fastboot mode, it's a mode to re-flash partitions on the Android based device.
16*c66ec88fSEmmanuel Vadot- mode-loader: A bootloader mode, it's a mode used to download image on Rockchip platform,
17*c66ec88fSEmmanuel Vadot	       usually used in development.
18*c66ec88fSEmmanuel Vadot
19*c66ec88fSEmmanuel VadotExample:
20*c66ec88fSEmmanuel Vadot	reboot-mode {
21*c66ec88fSEmmanuel Vadot		mode-normal = <BOOT_NORMAL>;
22*c66ec88fSEmmanuel Vadot		mode-recovery = <BOOT_RECOVERY>;
23*c66ec88fSEmmanuel Vadot		mode-bootloader = <BOOT_FASTBOOT>;
24*c66ec88fSEmmanuel Vadot		mode-loader = <BOOT_BL_DOWNLOAD>;
25*c66ec88fSEmmanuel Vadot	}
26