include/dm/pinctrl.h

4  * SPDX-License-Identifier:	GPL-2.0+
11  * struct pinconf_param - pin config parameters
25  * struct pinctrl_ops - pin control operations, to be implemented by
45  *	in this driver.  (necessary for pin-muxing)
46  * @get_function_name: return the function name of the muxing selector,
48  *	certain device to.  (necessary for pin-muxing)
49  * @pinmux_set: enable a certain muxing function with a certain pin.
50  *	The @func_selector selects a certain function whereas @pin_selector
52  *	may be ignored.  (necessary for pin-muxing against a single pin)
53  * @pinmux_group_set: enable a certain muxing function with a certain pin
54  *	group.  The @func_selector selects a certain function whereas
57  *	(necessary for pin-muxing against a pin group)
58  * @pinconf_num_params: number of driver-specific parameters to be parsed
59  *	from device trees  (necessary for pin-configuration)
61  *	device trees  (necessary for pin-configuration)
63  *	(necessary for pin-configuration against a single pin)
65  *	(necessary for pin-configuration against a pin group)
91 	/* for pinctrl-simple */
94 	 * request() - Request a particular pinctrl function
96 	 * This activates the selected function.
99 	 * @func:	Function number (driver-specific)
100 	 * @return 0 if OK, -ve on error
105 	* get_periph_id() - get the peripheral ID for a device
114 	* @return peripheral ID of @periph, or -ENOENT on error
119 	 * get_gpio_mux() - get the mux value for a particular GPIO
122 	 * useful for displaying the function being used by that GPIO, such
123 	 * as with the 'gpio' command. This function is internal to the GPIO
130 	* @return mux value (SoC-specific, e.g. 0 for input, 1 for output)
135 #define pinctrl_get_ops(dev)	((struct pinctrl_ops *)(dev)->driver->ops)
141  *	transition from say pull-up to pull-down implies that you disable
142  *	pull-up in the process, this setting disables all biasing.
144  *	mode, also know as "third-state" (tristate) or "high-Z" or "floating".
155  *	impedance to VDD). If the argument is != 0 pull-up is enabled,
156  *	if it is 0, pull-up is total, i.e. the pin is connected to VDD.
158  *	impedance to GROUND). If the argument is != 0 pull-down is enabled,
159  *	if it is 0, pull-down is total, i.e. the pin is connected to GROUND.
162  *	function. The pull direction and possibly strength too will normally
171  *	push-pull mode, the argument is ignored.
184  * @PIN_CONFIG_INPUT_SCHMITT_ENABLE: control schmitt-trigger mode on the pin.
185  *      If the argument != 0, schmitt-trigger mode is enabled. If it's 0,
186  *      schmitt-trigger mode is disabled.
188  *	schmitt-trigger mode. If the schmitt-trigger has adjustable hysteresis,
209  * @PIN_CONFIG_END: this is the last enumerator for pin configurations, if
235  * pinctrl_generic_set_state() - generic set_state operation
248 	return -EINVAL;  in pinctrl_generic_set_state()
254  * pinctrl_select_state() - set a device to a given state
263  * pinctrl_request() - Request a particular pinctrl function
266  * @func:	Function number (driver-specific)
267  * @flags:	Flags (driver-specific)
268  * @return 0 if OK, -ve on error
273  * pinctrl_request_noflags() - Request a particular pinctrl function
278  * @func:	Function number (driver-specific)
279  * @return 0 if OK, -ve on error
284  * pinctrl_get_periph_id() - get the peripheral ID for a device
292  * @return peripheral ID of @periph, or -ENOENT on error
297  * pinctrl_decode_pin_config() - decode pin configuration flags
305  * @return decoded flag value, or -ve on error
310  * pinctrl_get_gpio_mux() - get the mux value for a particular GPIO
313  * useful for displaying the function being used by that GPIO, such
314  * as with the 'gpio' command. This function is internal to the GPIO
321  * @return mux value (SoC-specific, e.g. 0 for input, 1 for output)
326  * pinctrl_get_pins_count() - get the total pins count for all GPIOs
338 	return -EINVAL;  in pinctrl_select_state()
343 	return -EINVAL;  in pinctrl_request()
348 	return -EINVAL;  in pinctrl_request_noflags()
353 	return -EINVAL;  in pinctrl_get_periph_id()
358 	return -EINVAL;  in pinctrl_decode_pin_config()
363 	return -EINVAL;  in pinctrl_get_gpio_mux()
368 	return -EINVAL;  in pinctrl_get_pins_count()