[src/trunk]: src/share/man/man4 Add documentatiion for Intel GPIO driver igpi...

[manu <manu%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c6709123efd6
branches:  trunk
changeset: 364435:c6709123efd6
user:      manu <manu%NetBSD.org@localhost>
date:      Thu Mar 24 14:00:19 2022 +0000

description:
Add documentatiion for Intel GPIO driver igpio(4)

diffstat:

 share/man/man4/Makefile |   4 +-
 share/man/man4/igpio.4  |  91 +++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 93 insertions(+), 2 deletions(-)

diffs (113 lines):

diff -r e38d55c10bce -r c6709123efd6 share/man/man4/Makefile
--- a/share/man/man4/Makefile   Thu Mar 24 12:59:56 2022 +0000
+++ b/share/man/man4/Makefile   Thu Mar 24 14:00:19 2022 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.722 2022/01/17 16:31:23 thorpej Exp $
+#      $NetBSD: Makefile,v 1.723 2022/03/24 14:00:19 manu Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
@@ -30,7 +30,7 @@
        gpiosim.4 gre.4 gphyter.4 gsip.4 \
        hdaudio.4 hifn.4 hme.4 hpacel.4 hpqlb.4 hptide.4 hvn.4 hythygtemp.4 \
        iavf.4 ibmcd.4 ibmhawk.4 ichsmb.4 icmp.4 icp.4 icsphy.4 iee.4 \
-       ieee80211.4 ifmedia.4 igmafb.4 igphy.4 igsfb.4 iha.4 ihidev.4 \
+       ieee80211.4 ifmedia.4 igmafb.4 igphy.4 igpio.4 igsfb.4 iha.4 ihidev.4 \
        ihphy.4 iic.4 ims.4 inet.4 ikphy.4 inphy.4 intersil7170.4 intro.4 \
        ioasic.4 ioat.4 iop.4 iophy.4 iopsp.4 ip.4 ipgphy.4 ipmi.4 ipw.4 \
        irmce.4 isp.4 ismt.4 isv.4 itesio.4 iteide.4 iwi.4 iwm.4 iwn.4 ixg.4 \
diff -r e38d55c10bce -r c6709123efd6 share/man/man4/igpio.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/igpio.4    Thu Mar 24 14:00:19 2022 +0000
@@ -0,0 +1,91 @@
+.\" $NetBSD: igpio.4,v 1.1 2022/03/24 14:00:19 manu Exp $
+.\"
+.\" Copyright (c) 2022 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Emmanuel Dreyfus.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd Mars 24, 2022
+.Dt IGPIO 4
+.Os
+.Sh NAME
+.Nm igpio
+.Nd Intel GPIO Controller
+.Sh SYNOPSIS
+.Cd "igpio* at acpi?"
+.Cd "gpio* at gpiobus?"
+.Sh DESCRIPTION
+.Nm
+provides a
+.Xr gpio 4
+interface for the following Intel chipsets:
+.Bl -tag -width autoselect -compact
+.It Alderlake
+.It Baytrail
+.It Cannonlake-H
+.It Cannonlake-LP
+.It Cedarfork
+.It Denverton
+.It Emmitsburg
+.It Geminilake
+.It Icelake
+.It Jasperlake
+.It Lakefield
+.It Lewisburg
+.It Lynxpoint
+.It Sunrisepoint-H
+.It Sunrisepoint-LP
+.It Tigerlake-H
+.It Tigerlake-LP
+.El
+Support for Broxton and Cherryview is not enabled yet.
+.Pp
+The driver supports
+.Dv GPIO_PIN_INPUT ,
+.Dv GPIO_PIN_OUTPUT ,
+.Dv GPIO_PIN_INOUT ,
+.Dv GPIO_PIN_ININ ,
+.Dv GPIO_PIN_PULLUP ,
+.Dv GPIO_PIN_PULLDOWN ,
+and interrupt capabilies
+.Dv GPIO_INTR_POS_EDGE ,
+.Dv GPIO_INTR_NEG_EDGE ,
+.Dv GPIO_INTR_DOUBLE_EDGE ,
+.Dv GPIO_INTR_HIGH_LEVEL ,
+.Dv GPIO_INTR_LOW_LEVEL .
+.Sh SEE ALSO
+.Xr gpio 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Nx 10.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver and man page was written by
+.An Emmanuel Dreyfus
+.Aq Mt manu%NetBSD.org@localhost .