xref: /illumos-gate/usr/src/man/man4d/amdzen.4d (revision ddb365bfc9e868ad24ccdcb0dc91af18b10df082)
1.\"
2.\" This file and its contents are supplied under the terms of the
3.\" Common Development and Distribution License ("CDDL"), version 1.0.
4.\" You may only use this file in accordance with the terms of version
5.\" 1.0 of the CDDL.
6.\"
7.\" A full copy of the text of the CDDL should have accompanied this
8.\" source.  A copy of the CDDL is also available via the Internet at
9.\" http://www.illumos.org/license/CDDL.
10.\"
11.\"
12.\" Copyright 2023 Oxide Computer Company
13.\"
14.Dd February 26, 2023
15.Dt AMDZEN 4D
16.Os
17.Sh NAME
18.Nm amdzen ,
19.Nm amdzen_stub
20.Nd AMD Zen Nexus Driver
21.Sh DESCRIPTION
22The
23.Nm
24driver provides access to the Northbridge, Data Fabric, and System
25Management Network
26.Pq SMN
27for a number of AMD processor lines, including AMD Ryzen CPUs and APUs,
28ThreadRipper CPUs, and EPYC CPUs from the following families:
29.Bl -bullet
30.It
31AMD Zen Naples, Summit Ridge, Whitehaven
32.Pq Family 17h
33.It
34AMD Zen+ Colfax, Picasso, and Pinnacle Ridge
35.Pq Family 17h
36.It
37AMD Zen 2 Castle Peak, Matisse, Mendocino, Rome, Renoir, and Van Gogh
38.Pq Family 17h
39.It
40AMD Zen 3 Cezanne, Milan, and Vermeer
41.Pq Family 19h
42.It
43AMD Zen 3+ Rembrandt
44.Pq Family 19h
45.It
46AMD Zen 4 Genoa, Bergamo, Raphael, and Phoenix
47.Pq Family 19h
48.El
49.Pp
50This driver is a nexus driver and facilitates access to the northbridge,
51data fabric, and SMN between various other devices such as
52.Xr smntemp 4D .
53The various processor devices that make up the northbridge and data
54fabric have the
55.Sy amdzen_stub
56driver attached to them.
57The different devices are all amalgamated and a single uniform view is
58provided by the
59.Sy amdzen
60driver.
61.Pp
62The
63.Nm
64driver is a nexus driver that has the following children:
65.Bl -tag -width "smntemp(4D)"
66.It Xr smntemp 4D
67Provides access to on-die temperature sensors.
68.It Xr usmn 4D
69Provides read access to the SMN.
70This driver is intended for development purposes.
71.It Xr zen_udf 4D
72Provides read access to the data fabric.
73This driver is intended for development purposes.
74.El
75.Sh ARCHITECTURE
76The
77.Sy amdzen
78and
79.Sy amdzen_stub
80drivers are limited to
81.Sy x86
82platforms with AMD Family 17h and 19h processors.
83.Sh SEE ALSO
84.Xr smntemp 4D ,
85.Xr usmn 4D ,
86.Xr zen_udf 4D
87