1GPIOMON(1)                       User Commands                      GPIOMON(1)
2
3
4

NAME

6       gpiomon - manual page for gpiomon v2.0.2
7

SYNOPSIS

9       gpiomon [OPTIONS] <line>...
10

DESCRIPTION

12       Wait for events on GPIO lines and print them to standard output.
13
14       Lines are specified by name, or optionally by offset if the chip option
15       is provided.
16

OPTIONS

18       --banner
19              display a banner on successful startup
20
21       -b, --bias <bias>
22              specify the line bias Possible values:  'pull-down',  'pull-up',
23              'disabled'.  (default is to leave bias unchanged)
24
25       --by-name
26              treat lines as names even if they would parse as an offset
27
28       -c, --chip <chip>
29              restrict scope to a particular chip
30
31       -C, --consumer <name> consumer name applied to requested lines (default
32              is 'gpiomon')
33
34       -e, --edges <edges>
35              specify the edges to monitor Possible values:  'falling',  'ris‐
36              ing', 'both'.  (default is 'both')
37
38       -E, --event-clock <clock>
39              specify  the  source clock for event timestamps Possible values:
40              'monotonic', 'realtime', 'hte'.  (default is 'monotonic') By de‐
41              fault 'realtime' is formatted as UTC, others as raw u64.
42
43       -h, --help
44              display this help and exit
45
46       -F, --format <fmt>
47              specify a custom output format
48
49       -l, --active-low
50              treat  the  line as active low, flipping the sense of rising and
51              falling edges
52
53       --localtime
54              format event timestamps as local time
55
56       -n, --num-events <num>
57              exit after processing num events
58
59       -p, --debounce-period <period>
60              debounce the line(s) with the specified period
61
62       -q, --quiet
63              don't generate any output
64
65       -s, --strict
66              abort if requested line names are not unique
67
68       --unquoted
69              don't quote line or consumer names
70
71       --utc  format event timestamps as UTC (default for 'realtime')
72
73       -v, --version
74              output version information and exit
75
76   Chips:
77              A GPIO chip may be identified by number, name,  or  path.   e.g.
78              '0',  'gpiochip0',  and  '/dev/gpiochip0'  all refer to the same
79              chip.
80
81   Periods:
82              Periods are taken as milliseconds unless  units  are  specified.
83              e.g. 10us.  Supported units are 's', 'ms', and 'us'.
84
85   Format specifiers:
86       %o     GPIO line offset
87
88       %l     GPIO line name
89
90       %c     GPIO chip name
91
92       %e     numeric edge event type ('1' - rising or '2' - falling)
93
94       %E     edge event type ('rising' or 'falling')
95
96       %S     event timestamp as seconds
97
98       %U     event timestamp as UTC
99
100       %L     event timestamp as local time
101

AUTHOR

103       Bartosz Golaszewski <bartekgola@gmail.com>
104

REPORTING BUGS

106       Report bugs to:
107           Bartosz Golaszewski <bartekgola@gmail.com>
108           linux-gpio <linux-gpio@vger.kernel.org>
109

111       Copyright © 2017-2023 Bartosz Golaszewski License: GPL-2.0-or-later
112       This  is  free  software:  you  are free to change and redistribute it.
113       There is NO WARRANTY, to the extent permitted by law.
114
115
116
117libgpiod v2.0.2                   August 2023                       GPIOMON(1)
Impressum