aplaudio(4), apldma(4), aplmca(4) and aplnco(4)

diff --git a/share/man/man4/man4.arm64/Makefile b/share/man/man4/man4.arm64/Makefile
index b1c1497..121f014 100644 (file)
--- a/share/man/man4/man4.arm64/Makefile
+++ b/share/man/man4/man4.arm64/Makefile
@@ -1,8 +1,9 @@
-#      $OpenBSD: Makefile,v 1.25 2022/06/12 16:02:33 kettenis Exp $
+#      $OpenBSD: Makefile,v 1.26 2022/08/06 09:40:55 kettenis Exp $
 
-MAN=   agtimer.4 ampintc.4 aplcpu.4 apldart.4 apldog.4 aplhidev.4 apliic.4 \
-       aplintc.4 aplmbox.4 aplns.4 aplpcie.4 aplpinctrl.4 aplpmgr.4 \
-       aplpmu.4 aplsart.4 aplsmc.4 aplspi.4 aplspmi.4 apm.4 \
+MAN=   agtimer.4 ampintc.4 aplaudio.4 aplcpu.4 apldart.4 apldma.4 apldog.4 \
+       aplhidev.4 apliic.4 aplintc.4 aplmbox.4 aplmca.4 aplnco.4 aplns.4 \
+       aplpcie.4 aplpinctrl.4 aplpmgr.4 aplpmu.4 aplsart.4 aplsmc.4 aplspi.4 \
+       aplspmi.4 apm.4 \
        efi.4 intro.4 smbios.4
 
 MANSUBDIR=arm64

diff --git a/share/man/man4/man4.arm64/aplaudio.4 b/share/man/man4/man4.arm64/aplaudio.4
new file mode 100644 (file)
index 0000000..c8ae9f5
--- /dev/null
+++ b/share/man/man4/man4.arm64/aplaudio.4
@@ -0,0 +1,48 @@
+.\"    $OpenBSD: aplaudio.4,v 1.1 2022/08/06 09:40:55 kettenis Exp $
+.\"
+.\" Copyright (c) 2020 Patrick Wildt <patrick@openbsd.org>
+.\" Copyright (c) 2022 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: August 6 2022 $
+.Dt APLAUDIO 4
+.Os
+.Sh NAME
+.Nm aplaudio
+.Nd Apple audio subsystem
+.Sh SYNOPSIS
+.Cd "aplaudio* at fdt?"
+.Cd "audio* at aplaudio?"
+.Sh DESCRIPTION
+.Nm
+is a driver for the audio subsystem on Apple Silicon Macs.
+It represents the logical connection of the DMA controller,
+the MCA controller and various codecs.
+.Sh SEE ALSO
+.Xr apldma 4 ,
+.Xr aplmca 4 ,
+.Xr audio 4 ,
+.Xr intro 4 ,
+.Xr simplaudio 4 ,
+.Xr tascodec 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 7.2 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Mark Kettenis Aq Mt kettenis@openbsd.org .

diff --git a/share/man/man4/man4.arm64/apldma.4 b/share/man/man4/man4.arm64/apldma.4
new file mode 100644 (file)
index 0000000..3ba504b
--- /dev/null
+++ b/share/man/man4/man4.arm64/apldma.4
@@ -0,0 +1,47 @@
+.\"    $OpenBSD: apldma.4,v 1.1 2022/08/06 09:40:55 kettenis Exp $
+.\"
+.\" Copyright (c) 2022 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: August 6 2022 $
+.Dt APLDMA 4
+.Os
+.Sh NAME
+.Nm apldma
+.Nd Apple DMA controller
+.Sh SYNOPSIS
+.Cd "apldma* at fdt?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the DMA controller integrated on various
+Apple SoCs.
+.Pp
+The controller is used to support DMA for the audio interfaces
+integrated on the SoC.
+.Sh SEE ALSO
+.Xr aplmca 4 ,
+.Xr intro 4
+.Sh HISTORY
+.Ox
+support for
+.Nm
+first appeared in
+.Ox 7.1 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Mark Kettenis Aq Mt kettenis@openbsd.org .

diff --git a/share/man/man4/man4.arm64/aplmca.4 b/share/man/man4/man4.arm64/aplmca.4
new file mode 100644 (file)
index 0000000..9eb40bc
--- /dev/null
+++ b/share/man/man4/man4.arm64/aplmca.4
@@ -0,0 +1,47 @@
+.\"    $OpenBSD: aplmca.4,v 1.1 2022/08/06 09:40:55 kettenis Exp $
+.\"
+.\" Copyright (c) 2022 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: August 6 2022 $
+.Dt APLMCA 4
+.Os
+.Sh NAME
+.Nm aplmca
+.Nd Apple MCA controller
+.Sh SYNOPSIS
+.Cd "aplmca* at fdt?"
+.Sh DESCRIPTION
+.Nm
+is a driver for the MCA controller integrated on
+various Apple SoCs.
+This controller serializes audio data streams received from the
+.Xr apldma 4
+DMA controller and sends these out as I2S/TDM streams on the audio
+interfaces of the SoCs.
+.Sh SEE ALSO
+.Xr aplaudio 4 ,
+.Xr apldma 4 ,
+.Xr aplnco 4 ,
+.Xr intro 4 ,
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 7.2 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Mark Kettenis Aq Mt kettenis@openbsd.org .

diff --git a/share/man/man4/man4.arm64/aplnco.4 b/share/man/man4/man4.arm64/aplnco.4
new file mode 100644 (file)
index 0000000..765f20d
--- /dev/null
+++ b/share/man/man4/man4.arm64/aplnco.4
@@ -0,0 +1,43 @@
+.\"    $OpenBSD: aplnco.4,v 1.1 2022/08/06 09:40:55 kettenis Exp $
+.\"
+.\" Copyright (c) 2022 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: August 6 2022 $
+.Dt APLNCO 4
+.Os
+.Sh NAME
+.Nm aplnco
+.Nd Apple NCO clock controller
+.Sh SYNOPSIS
+.Cd "aplnco* at fdt?"
+.Sh DESCRIPTION
+The
+.Nm
+driver controls the numerically-controlled oscillators that are used
+to derive the audio clock signals for Apple SoCs.
+.Sh SEE ALSO
+.Xr aplmca 4 ,
+.Xr intro 4
+.Sh HISTORY
+The
+.Nm
+device driver first appeared in
+.Ox 7.1 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Mark Kettenis Aq Mt kettenis@openbsd.org .