Add mpfgpio(4), a driver for the PolarFire SoC MSS GPIO controller.

Feedback and OK kettenis@

3 files changed, 60 insertions, 4 deletions

diff --git a/share/man/man4/gpio.4 b/share/man/man4/gpio.4
index 4379457357e..8dfbdbeff6d 100644
--- a/share/man/man4/gpio.4
+++ b/share/man/man4/gpio.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: gpio.4,v 1.27 2020/05/16 16:37:49 martin Exp $
+.\"	$OpenBSD: gpio.4,v 1.28 2022/02/18 10:51:43 visa Exp $
 .\"
 .\" Copyright (c) 2004 Alexander Yurchenko <grange@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: May 16 2020 $
+.Dd $Mdocdate: February 18 2022 $
 .Dt GPIO 4
 .Os
 .Sh NAME
@@ -27,6 +27,7 @@
 .Cd "gpio* at glxpcib?" Pq i386
 .Cd "gpio* at gscpcib?" Pq i386
 .Cd "gpio* at isagpio?"
+.Cd "gpio* at mpfgpio?" Pq riscv64
 .Cd "gpio* at nsclpcsio?"
 .Cd "gpio* at omgpio?" Pq armv7
 .Cd "gpio* at pcagpio?"
diff --git a/share/man/man4/man4.riscv64/Makefile b/share/man/man4/man4.riscv64/Makefile
index 4b5e28d66d0..c6d30a2f9a7 100644
--- a/share/man/man4/man4.riscv64/Makefile
+++ b/share/man/man4/man4.riscv64/Makefile
@@ -1,6 +1,6 @@
-#	$OpenBSD: Makefile,v 1.5 2022/02/16 13:07:36 visa Exp $
+#	$OpenBSD: Makefile,v 1.6 2022/02/18 10:51:43 visa Exp $
 
-MAN=	intro.4 mpfclock.4 mpfiic.4 plic.4 sfcc.4 sfclock.4 sfuart.4
+MAN=	intro.4 mpfclock.4 mpfgpio.4 mpfiic.4 plic.4 sfcc.4 sfclock.4 sfuart.4
 
 MANSUBDIR=riscv64
 
diff --git a/share/man/man4/man4.riscv64/mpfgpio.4 b/share/man/man4/man4.riscv64/mpfgpio.4
new file mode 100644
index 00000000000..b367357457d
--- /dev/null
+++ b/share/man/man4/man4.riscv64/mpfgpio.4
@@ -0,0 +1,55 @@
+.\"	$OpenBSD: mpfgpio.4,v 1.1 2022/02/18 10:51:43 visa Exp $
+.\"
+.\" Copyright (c) 2022 Visa Hankala
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: February 18 2022 $
+.Dt MPFGPIO 4 riscv64
+.Os
+.Sh NAME
+.Nm mpfgpio
+.Nd Microchip PolarFire SoC MSS GPIO controller
+.Sh SYNOPSIS
+.Cd "mpfgpio* at fdt?"
+.Cd "gpio* at mpfgpio?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the Microchip PolarFire SoC MSS GPIO controller.
+.Pp
+The PolarFire SoC MSS has three GPIO units:
+.Dv GPIO_0 ,
+.Dv GPIO_1
+and
+.Dv GPIO_2 .
+.Dv GPIO_0
+and
+.Dv GPIO_1
+control up to 14 and 24 IOs, respectively.
+These IOs are routed through IOMUXes.
+.Dv GPIO_2
+controls up to 32 IOs through the FPGA fabric.
+.Pp
+The IOs can be configured as either inputs or outputs,
+and accessed using
+.Xr gpioctl 8 .
+.Sh SEE ALSO
+.Xr gpio 4 ,
+.Xr intro 4 ,
+.Xr gpioctl 8
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 7.1 .