table of contents
- bookworm 1.6.3-1+b3
- bookworm-backports 2.1.3-1~bpo12+1
- testing 2.2.1-2
- unstable 2.2.1-2
GPIOSET(1) | gpioset | GPIOSET(1) |
NAME¶
gpioset - libgpiod command-line utility
SYNOPSIS¶
gpioset [OPTIONS] <line=value>...
DESCRIPTION¶
Set values of GPIO lines.
Lines are specified by name, or optionally by offset if the chip option is provided. Values may be '1' or '0', or equivalently 'active'/'inactive' or 'on'/'off'.
The line output state is maintained until the process exits, but after that is not guaranteed.
OPTIONS¶
- display a banner on successful startup
- -b, --bias <bias>
- specify the line bias Possible values: 'pull-down', 'pull-up', 'disabled'. (default is to leave bias unchanged)
- --by-name
- treat lines as names even if they would parse as an offset
- -c, --chip <chip>
- restrict scope to a particular chip
-C, --consumer <name> consumer name applied to requested lines (default is 'gpioset')
- -d, --drive <drive>
- specify the line drive mode Possible values: 'push-pull', 'open-drain', 'open-source'. (default is 'push-pull')
- -h, --help
- display this help and exit
- -l, --active-low
- treat the line as active low
- -p, --hold-period <period>
- the minimum time period to hold lines at the requested values
- -s, --strict
- abort if requested line names are not unique
- -t, --toggle <period>[,period]...
- toggle the line(s) after the specified period(s) If the last period is 0 then gpioset exits else the sequence repeats.
- --unquoted
- don't quote line names
- -v, --version
- output version information and exit
- -z, --daemonize
- set values then detach from the controlling terminal
Chips:¶
- A GPIO chip may be identified by number, name, or path. e.g. '0', 'gpiochip0', and '/dev/gpiochip0' all refer to the same chip.
Periods:¶
- Periods are taken as milliseconds unless units are specified. e.g. 10us. Supported units are 'm', 's', 'ms', and 'us' for minutes, seconds, milliseconds and microseconds respectively.
NOTE¶
- It should not be assumed that a line will retain its state after gpioset exits. When a process exits, any GPIO lines it has requested are automatically released. Once released, the state of a line may be modified by the kernel or another process. To guarantee the requested value, by default gpioset does not exit.
AUTHOR¶
Bartosz Golaszewski <brgl@bgdev.pl>
REPORTING BUGS¶
Report bugs to:
Bartosz Golaszewski <brgl@bgdev.pl>
linux-gpio <linux-gpio@vger.kernel.org>
COPYRIGHT¶
Copyright © 2017-2023 Bartosz Golaszewski License:
GPL-2.0-or-later
This is free software: you are free to change and redistribute it. There is NO
WARRANTY, to the extent permitted by law.
February 2025 | libgpiod v2.2.1 |