1 .. SPDX-License-Identifier: GPL-2.0 1 .. SPDX-License-Identifier: GPL-2.0
2 2
3 .. _GPIO_HANDLE_SET_LINE_VALUES_IOCTL: 3 .. _GPIO_HANDLE_SET_LINE_VALUES_IOCTL:
4 4
5 ********************************* 5 *********************************
6 GPIO_HANDLE_SET_LINE_VALUES_IOCTL 6 GPIO_HANDLE_SET_LINE_VALUES_IOCTL
7 ********************************* 7 *********************************
8 .. warning:: 8 .. warning::
9 This ioctl is part of chardev_v1.rst and i 9 This ioctl is part of chardev_v1.rst and is obsoleted by
10 gpio-v2-line-set-values-ioctl.rst. 10 gpio-v2-line-set-values-ioctl.rst.
11 11
12 Name 12 Name
13 ==== 13 ====
14 14
15 GPIO_HANDLE_SET_LINE_VALUES_IOCTL - Set the va 15 GPIO_HANDLE_SET_LINE_VALUES_IOCTL - Set the values of all requested output lines.
16 16
17 Synopsis 17 Synopsis
18 ======== 18 ========
19 19
20 .. c:macro:: GPIO_HANDLE_SET_LINE_VALUES_IOCTL 20 .. c:macro:: GPIO_HANDLE_SET_LINE_VALUES_IOCTL
21 21
22 ``int ioctl(int handle_fd, GPIO_HANDLE_SET_LIN 22 ``int ioctl(int handle_fd, GPIO_HANDLE_SET_LINE_VALUES_IOCTL, struct gpiohandle_data *values)``
23 23
24 Arguments 24 Arguments
25 ========= 25 =========
26 26
27 ``handle_fd`` 27 ``handle_fd``
28 The file descriptor of the GPIO character 28 The file descriptor of the GPIO character device, as returned in the
29 :c:type:`request.fd<gpiohandle_request>` b 29 :c:type:`request.fd<gpiohandle_request>` by gpio-get-linehandle-ioctl.rst.
30 30
31 ``values`` 31 ``values``
32 The :c:type:`line_values<gpiohandle_data>` 32 The :c:type:`line_values<gpiohandle_data>` to set.
33 33
34 Description 34 Description
35 =========== 35 ===========
36 36
37 Set the values of all requested output lines. 37 Set the values of all requested output lines.
38 38
39 The values set are logical, indicating if the 39 The values set are logical, indicating if the line is to be active or inactive.
40 The ``GPIOHANDLE_REQUEST_ACTIVE_LOW`` flag con 40 The ``GPIOHANDLE_REQUEST_ACTIVE_LOW`` flag controls the mapping between logical
41 values (active/inactive) and physical values ( 41 values (active/inactive) and physical values (high/low).
42 If ``GPIOHANDLE_REQUEST_ACTIVE_LOW`` is not s 42 If ``GPIOHANDLE_REQUEST_ACTIVE_LOW`` is not set then active is high and
43 inactive is low. If ``GPIOHANDLE_REQUEST_ACTIV 43 inactive is low. If ``GPIOHANDLE_REQUEST_ACTIVE_LOW`` is set then active is low
44 and inactive is high. 44 and inactive is high.
45 45
46 Only the values of output lines may be set. 46 Only the values of output lines may be set.
47 Attempting to set the value of input lines is 47 Attempting to set the value of input lines is an error (**EPERM**).
48 48
49 Return Value 49 Return Value
50 ============ 50 ============
51 51
52 On success 0. 52 On success 0.
53 53
54 On error -1 and the ``errno`` variable is set 54 On error -1 and the ``errno`` variable is set appropriately.
55 Common error codes are described in error-code 55 Common error codes are described in error-codes.rst.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.