xref: /illumos-gate/usr/src/man/man4d/amdzen.4d (revision 8bfb438df96fa91c2b1b34db1cc562e9330aba32)
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 2024 Oxide Computer Company
13.\"
14.Dd March 11, 2024
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.It
49Amd Zen 5
50.Pq Family 1ah
51.El
52.Pp
53This driver is a nexus driver and facilitates access to the northbridge,
54data fabric, and SMN between various other devices such as
55.Xr smntemp 4D .
56The various processor devices that make up the northbridge and data
57fabric have the
58.Sy amdzen_stub
59driver attached to them.
60The different devices are all amalgamated and a single uniform view is
61provided by the
62.Sy amdzen
63driver.
64.Pp
65The
66.Nm
67driver is a nexus driver that has the following children:
68.Bl -tag -width "smntemp(4D)"
69.It Xr smntemp 4D
70Provides access to on-die temperature sensors.
71.It Xr usmn 4D
72Provides read access to the SMN.
73This driver is intended for development purposes.
74.It Xr zen_udf 4D
75Provides read access to the data fabric.
76This driver is intended for development purposes.
77.El
78.Sh ARCHITECTURE
79The
80.Sy amdzen
81and
82.Sy amdzen_stub
83drivers are limited to
84.Sy x86
85platforms with AMD Family 17h and 19h processors.
86.Sh SEE ALSO
87.Xr smntemp 4D ,
88.Xr usmn 4D ,
89.Xr zen_udf 4D
90