Link: https://lore.kernel.org/r/20260217200002.683975158@linuxfoundation.org Tested-by: Florian Fainelli <florian.fainelli@broadcom.com> Tested-by: Takeshi Ogasawara <takeshi.ogasawara@futuring-girl.com> Tested-by: Peter Schneider <pschneider1968@googlemail.com> Tested-by: Jon Hunter <jonathanh@nvidia.com> Tested-by: Salvatore Bonaccorso <carnil@debian.org> Tested-by: Brett A C Sheffield <bacs@librecast.net> Tested-by: Mark Brown <broonie@kernel.org> Tested-by: Luna Jernberg <droidbittin@gmail.com> Tested-by: Ronald Warsow <rwarsow@gmx.de> Tested-by: Justin M. Forbes <jforbes@fedoraproject.org> Tested-by: Ron Economos <re@w6rz.net> Tested-by: Miguel Ojeda <ojeda@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
59 lines
1.7 KiB
ReStructuredText
59 lines
1.7 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
.. _GPIO_V2_LINE_GET_VALUES_IOCTL:
|
|
|
|
*****************************
|
|
GPIO_V2_LINE_GET_VALUES_IOCTL
|
|
*****************************
|
|
|
|
Name
|
|
====
|
|
|
|
GPIO_V2_LINE_GET_VALUES_IOCTL - Get the values of requested lines.
|
|
|
|
Synopsis
|
|
========
|
|
|
|
.. c:macro:: GPIO_V2_LINE_GET_VALUES_IOCTL
|
|
|
|
``int ioctl(int req_fd, GPIO_V2_LINE_GET_VALUES_IOCTL, struct gpio_v2_line_values *values)``
|
|
|
|
Arguments
|
|
=========
|
|
|
|
``req_fd``
|
|
The file descriptor of the GPIO character device, as returned in the
|
|
:c:type:`request.fd<gpio_v2_line_request>` by gpio-v2-get-line-ioctl.rst.
|
|
|
|
``values``
|
|
The :c:type:`line_values<gpio_v2_line_values>` to get with the ``mask`` set
|
|
to indicate the subset of requested lines to get.
|
|
|
|
Description
|
|
===========
|
|
|
|
Get the values of requested lines.
|
|
|
|
The values returned are logical, indicating if the line is active or inactive.
|
|
The ``GPIO_V2_LINE_FLAG_ACTIVE_LOW`` flag controls the mapping between physical
|
|
values (high/low) and logical values (active/inactive).
|
|
If ``GPIO_V2_LINE_FLAG_ACTIVE_LOW`` is not set then high is active and low is
|
|
inactive. If ``GPIO_V2_LINE_FLAG_ACTIVE_LOW`` is set then low is active and
|
|
high is inactive.
|
|
|
|
The values of both input and output lines may be read.
|
|
|
|
For output lines, the value returned is driver and configuration dependent and
|
|
may be either the output buffer (the last requested value set) or the input
|
|
buffer (the actual level of the line), and depending on the hardware and
|
|
configuration these may differ.
|
|
|
|
Return Value
|
|
============
|
|
|
|
On success 0 and the corresponding :c:type:`values.bits<gpio_v2_line_values>`
|
|
contain the value read.
|
|
|
|
On error -1 and the ``errno`` variable is set appropriately.
|
|
Common error codes are described in error-codes.rst.
|