1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Standard pin control state definitions 4 */ 5 6 #ifndef __LINUX_PINCTRL_PINCTRL_STATE_H 7 #define __LINUX_PINCTRL_PINCTRL_STATE_H 8 9 /** 10 * @PINCTRL_STATE_DEFAULT: the state the pinctrl handle shall be put 11 * into as default, usually this means the pins are up and ready to 12 * be used by the device driver. This state is commonly used by 13 * hogs to configure muxing and pins at boot, and also as a state 14 * to go into when returning from sleep and idle in 15 * .pm_runtime_resume() or ordinary .resume() for example. 16 * @PINCTRL_STATE_INIT: normally the pinctrl will be set to "default" 17 * before the driver's probe() function is called. There are some 18 * drivers where that is not appropriate becausing doing so would 19 * glitch the pins. In those cases you can add an "init" pinctrl 20 * which is the state of the pins before drive probe. After probe 21 * if the pins are still in "init" state they'll be moved to 22 * "default". 23 * @PINCTRL_STATE_IDLE: the state the pinctrl handle shall be put into 24 * when the pins are idle. This is a state where the system is relaxed 25 * but not fully sleeping - some power may be on but clocks gated for 26 * example. Could typically be set from a pm_runtime_suspend() or 27 * pm_runtime_idle() operation. 28 * @PINCTRL_STATE_SLEEP: the state the pinctrl handle shall be put into 29 * when the pins are sleeping. This is a state where the system is in 30 * its lowest sleep state. Could typically be set from an 31 * ordinary .suspend() function. 32 */ 33 #define PINCTRL_STATE_DEFAULT "default" 34 #define PINCTRL_STATE_INIT "init" 35 #define PINCTRL_STATE_IDLE "idle" 36 #define PINCTRL_STATE_SLEEP "sleep" 37 38 #endif /* __LINUX_PINCTRL_PINCTRL_STATE_H */