bcmdmac(4) and bcmsdhost(4)

3 files changed, 121 insertions, 3 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 827f842acbb..7a0ccd33a0c 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.766 2020/04/19 16:15:46 tobhe Exp $
+#	$OpenBSD: Makefile,v 1.767 2020/04/22 10:10:41 kettenis Exp $
 
 MAN=	aac.4 abcrtc.4 ac97.4 acphy.4 acrtc.4 \
 	acpi.4 acpiac.4 acpials.4 acpiasus.4 acpibat.4 \
@@ -17,8 +17,8 @@ MAN=	aac.4 abcrtc.4 ac97.4 acphy.4 acrtc.4 \
 	asbtm.4 asmc.4 ast.4 atapiscsi.4 atphy.4 ath.4 athn.4 atu.4 atw.4 \
 	auacer.4 audio.4 aue.4 auglx.4 auich.4 auixp.4 autri.4 auvia.4 \
 	axe.4 axen.4 axppmic.4 azalia.4 \
-	bce.4 bcmaux.4 bcmclock.4 \
-	bcmdog.4 bcmirng.4 bcmmbox.4 bcmpcie.4 bcmrng.4 bcmtemp.4 bdpmic.4 \
+	bce.4 bcmaux.4 bcmclock.4 bcmdmac.4 bcmdog.4 bcmirng.4 bcmmbox.4 \
+	bcmpcie.4 bcmrng.4 bcmsdhost.4 bcmtemp.4 bdpmic.4 \
 	berkwdt.4 bge.4 bgw.4 bio.4 bpe.4 bktr.4 bmtphy.4 bnx.4 bnxt.4 \
 	boca.4 bpf.4 brgphy.4 bridge.4 brswphy.4 bse.4 bwfm.4 bwi.4 bytgpio.4 \
 	cac.4 cas.4 cardbus.4 carp.4 ccp.4 ccpmic.4 cd.4 cdce.4 cfxga.4 \
diff --git a/share/man/man4/bcmdmac.4 b/share/man/man4/bcmdmac.4
new file mode 100644
index 00000000000..3b3d3e74ddf
--- /dev/null
+++ b/share/man/man4/bcmdmac.4
@@ -0,0 +1,55 @@
+.\"	$OpenBSD: bcmdmac.4,v 1.1 2020/04/22 10:10:41 kettenis Exp $
+.\"
+.\" Copyright (c) 2020 Mark Kettenis <kettenis@openbsd.org>
+.\"
+.\" 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: April 22 2020 $
+.Dt BCMDMAC 4
+.Os
+.Sh NAME
+.Nm bcmdmac
+.Nd Broadcom BCM238x DMA controller
+.Sh SYNOPSIS
+.Cd "bcmdmac* at fdt?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the DMA controller integrated on Broadcom
+BCM283x and BCM2711 SoCs.
+.Pp
+The controller is used to support DMA for devices that don't provide a
+DMA controller of their own.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr bcmsdhost 4 ,
+.Sh HISTORY
+.Ox
+support for
+.Nm
+first appeared in
+.Ox 6.7 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Jared D. McNeill
+for
+.Nx
+and ported to
+.Ox
+by
+.An Neil Ashford Aq Mt ashfordneil0@gmail.com
+and
+.An Tobias Heider Aq Mt tobhe@openbsd.org .
diff --git a/share/man/man4/bcmsdhost.4 b/share/man/man4/bcmsdhost.4
new file mode 100644
index 00000000000..7a7a30fba1b
--- /dev/null
+++ b/share/man/man4/bcmsdhost.4
@@ -0,0 +1,63 @@
+.\"	$OpenBSD: bcmsdhost.4,v 1.1 2020/04/22 10:10:41 kettenis Exp $
+.\"
+.\" Copyright (c) 2020 Mark Kettenis <kettenis@openbsd.org>
+.\"
+.\" 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: April 22 2020 $
+.Dt BCMSDHOST 4
+.Os
+.Sh NAME
+.Nm bcmsdhost
+.Nd Broadcom BCM238x SD controller
+.Sh SYNOPSIS
+.Cd "bcmsdhost* at fdt?"
+.Cd "sdmmc* at bcmsdhost?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the SD controllers integrated on Broadcom
+BCM283x and BCM2711 SoCs.
+The driver uses the
+.Xr bcmdmac 4
+DMA controller to provide DMA support.
+.Pp
+The
+.Xr sdmmc 4
+subsystem performs SD/MMC transactions to communicate with whatever SD
+devices are inserted into the card slot or directly connected to the
+controller.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr bcmdmac 4 ,
+.Xr sdmmc 4
+.Sh HISTORY
+.Ox
+support for
+.Nm
+first appeared in
+.Ox 6.7 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Jared D. McNeill
+for
+.Nx
+and ported to
+.Ox
+by
+.An Neil Ashford Aq Mt ashfordneil0@gmail.com
+and
+.An Tobias Heider Aq Mt tobhe@openbsd.org .