• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _ASM_X86_CPU_DEVICE_ID
3 #define _ASM_X86_CPU_DEVICE_ID
4 
5 /*
6  * Declare drivers belonging to specific x86 CPUs
7  * Similar in spirit to pci_device_id and related PCI functions
8  *
9  * The wildcard initializers are in mod_devicetable.h because
10  * file2alias needs them. Sigh.
11  */
12 #include <linux/mod_devicetable.h>
13 /* Get the INTEL_FAM* model defines */
14 #include <asm/intel-family.h>
15 /* And the X86_VENDOR_* ones */
16 #include <asm/processor.h>
17 
18 /* Centaur FAM6 models */
19 #define X86_CENTAUR_FAM6_C7_A		0xa
20 #define X86_CENTAUR_FAM6_C7_D		0xd
21 #define X86_CENTAUR_FAM6_NANO		0xf
22 
23 #define X86_STEPPINGS(mins, maxs)    GENMASK(maxs, mins)
24 /**
25  * X86_MATCH_VENDOR_FAM_MODEL_STEPPINGS_FEATURE - Base macro for CPU matching
26  * @_vendor:	The vendor name, e.g. INTEL, AMD, HYGON, ..., ANY
27  *		The name is expanded to X86_VENDOR_@_vendor
28  * @_family:	The family number or X86_FAMILY_ANY
29  * @_model:	The model number, model constant or X86_MODEL_ANY
30  * @_steppings:	Bitmask for steppings, stepping constant or X86_STEPPING_ANY
31  * @_feature:	A X86_FEATURE bit or X86_FEATURE_ANY
32  * @_data:	Driver specific data or NULL. The internal storage
33  *		format is unsigned long. The supplied value, pointer
34  *		etc. is casted to unsigned long internally.
35  *
36  * Use only if you need all selectors. Otherwise use one of the shorter
37  * macros of the X86_MATCH_* family. If there is no matching shorthand
38  * macro, consider to add one. If you really need to wrap one of the macros
39  * into another macro at the usage site for good reasons, then please
40  * start this local macro with X86_MATCH to allow easy grepping.
41  */
42 #define X86_MATCH_VENDOR_FAM_MODEL_STEPPINGS_FEATURE(_vendor, _family, _model, \
43 						    _steppings, _feature, _data) { \
44 	.vendor		= X86_VENDOR_##_vendor,				\
45 	.family		= _family,					\
46 	.model		= _model,					\
47 	.steppings	= _steppings,					\
48 	.feature	= _feature,					\
49 	.driver_data	= (unsigned long) _data				\
50 }
51 
52 /**
53  * X86_MATCH_VENDOR_FAM_MODEL_FEATURE - Macro for CPU matching
54  * @_vendor:	The vendor name, e.g. INTEL, AMD, HYGON, ..., ANY
55  *		The name is expanded to X86_VENDOR_@_vendor
56  * @_family:	The family number or X86_FAMILY_ANY
57  * @_model:	The model number, model constant or X86_MODEL_ANY
58  * @_feature:	A X86_FEATURE bit or X86_FEATURE_ANY
59  * @_data:	Driver specific data or NULL. The internal storage
60  *		format is unsigned long. The supplied value, pointer
61  *		etc. is casted to unsigned long internally.
62  *
63  * The steppings arguments of X86_MATCH_VENDOR_FAM_MODEL_STEPPINGS_FEATURE() is
64  * set to wildcards.
65  */
66 #define X86_MATCH_VENDOR_FAM_MODEL_FEATURE(vendor, family, model, feature, data) \
67 	X86_MATCH_VENDOR_FAM_MODEL_STEPPINGS_FEATURE(vendor, family, model, \
68 						X86_STEPPING_ANY, feature, data)
69 
70 /**
71  * X86_MATCH_VENDOR_FAM_FEATURE - Macro for matching vendor, family and CPU feature
72  * @vendor:	The vendor name, e.g. INTEL, AMD, HYGON, ..., ANY
73  *		The name is expanded to X86_VENDOR_@vendor
74  * @family:	The family number or X86_FAMILY_ANY
75  * @feature:	A X86_FEATURE bit
76  * @data:	Driver specific data or NULL. The internal storage
77  *		format is unsigned long. The supplied value, pointer
78  *		etc. is casted to unsigned long internally.
79  *
80  * All other missing arguments of X86_MATCH_VENDOR_FAM_MODEL_FEATURE() are
81  * set to wildcards.
82  */
83 #define X86_MATCH_VENDOR_FAM_FEATURE(vendor, family, feature, data)	\
84 	X86_MATCH_VENDOR_FAM_MODEL_FEATURE(vendor, family,		\
85 					   X86_MODEL_ANY, feature, data)
86 
87 /**
88  * X86_MATCH_VENDOR_FEATURE - Macro for matching vendor and CPU feature
89  * @vendor:	The vendor name, e.g. INTEL, AMD, HYGON, ..., ANY
90  *		The name is expanded to X86_VENDOR_@vendor
91  * @feature:	A X86_FEATURE bit
92  * @data:	Driver specific data or NULL. The internal storage
93  *		format is unsigned long. The supplied value, pointer
94  *		etc. is casted to unsigned long internally.
95  *
96  * All other missing arguments of X86_MATCH_VENDOR_FAM_MODEL_FEATURE() are
97  * set to wildcards.
98  */
99 #define X86_MATCH_VENDOR_FEATURE(vendor, feature, data)			\
100 	X86_MATCH_VENDOR_FAM_FEATURE(vendor, X86_FAMILY_ANY, feature, data)
101 
102 /**
103  * X86_MATCH_FEATURE - Macro for matching a CPU feature
104  * @feature:	A X86_FEATURE bit
105  * @data:	Driver specific data or NULL. The internal storage
106  *		format is unsigned long. The supplied value, pointer
107  *		etc. is casted to unsigned long internally.
108  *
109  * All other missing arguments of X86_MATCH_VENDOR_FAM_MODEL_FEATURE() are
110  * set to wildcards.
111  */
112 #define X86_MATCH_FEATURE(feature, data)				\
113 	X86_MATCH_VENDOR_FEATURE(ANY, feature, data)
114 
115 /* Transitional to keep the existing code working */
116 #define X86_FEATURE_MATCH(feature)	X86_MATCH_FEATURE(feature, NULL)
117 
118 /**
119  * X86_MATCH_VENDOR_FAM_MODEL - Match vendor, family and model
120  * @vendor:	The vendor name, e.g. INTEL, AMD, HYGON, ..., ANY
121  *		The name is expanded to X86_VENDOR_@vendor
122  * @family:	The family number or X86_FAMILY_ANY
123  * @model:	The model number, model constant or X86_MODEL_ANY
124  * @data:	Driver specific data or NULL. The internal storage
125  *		format is unsigned long. The supplied value, pointer
126  *		etc. is casted to unsigned long internally.
127  *
128  * All other missing arguments of X86_MATCH_VENDOR_FAM_MODEL_FEATURE() are
129  * set to wildcards.
130  */
131 #define X86_MATCH_VENDOR_FAM_MODEL(vendor, family, model, data)		\
132 	X86_MATCH_VENDOR_FAM_MODEL_FEATURE(vendor, family, model,	\
133 					   X86_FEATURE_ANY, data)
134 
135 /**
136  * X86_MATCH_VENDOR_FAM - Match vendor and family
137  * @vendor:	The vendor name, e.g. INTEL, AMD, HYGON, ..., ANY
138  *		The name is expanded to X86_VENDOR_@vendor
139  * @family:	The family number or X86_FAMILY_ANY
140  * @data:	Driver specific data or NULL. The internal storage
141  *		format is unsigned long. The supplied value, pointer
142  *		etc. is casted to unsigned long internally.
143  *
144  * All other missing arguments to X86_MATCH_VENDOR_FAM_MODEL_FEATURE() are
145  * set of wildcards.
146  */
147 #define X86_MATCH_VENDOR_FAM(vendor, family, data)			\
148 	X86_MATCH_VENDOR_FAM_MODEL(vendor, family, X86_MODEL_ANY, data)
149 
150 /**
151  * X86_MATCH_INTEL_FAM6_MODEL - Match vendor INTEL, family 6 and model
152  * @model:	The model name without the INTEL_FAM6_ prefix or ANY
153  *		The model name is expanded to INTEL_FAM6_@model internally
154  * @data:	Driver specific data or NULL. The internal storage
155  *		format is unsigned long. The supplied value, pointer
156  *		etc. is casted to unsigned long internally.
157  *
158  * The vendor is set to INTEL, the family to 6 and all other missing
159  * arguments of X86_MATCH_VENDOR_FAM_MODEL_FEATURE() are set to wildcards.
160  *
161  * See X86_MATCH_VENDOR_FAM_MODEL_FEATURE() for further information.
162  */
163 #define X86_MATCH_INTEL_FAM6_MODEL(model, data)				\
164 	X86_MATCH_VENDOR_FAM_MODEL(INTEL, 6, INTEL_FAM6_##model, data)
165 
166 /*
167  * Match specific microcode revisions.
168  *
169  * vendor/family/model/stepping must be all set.
170  *
171  * Only checks against the boot CPU.  When mixed-stepping configs are
172  * valid for a CPU model, add a quirk for every valid stepping and
173  * do the fine-tuning in the quirk handler.
174  */
175 
176 struct x86_cpu_desc {
177 	u8	x86_family;
178 	u8	x86_vendor;
179 	u8	x86_model;
180 	u8	x86_stepping;
181 	u32	x86_microcode_rev;
182 };
183 
184 #define INTEL_CPU_DESC(model, stepping, revision) {		\
185 	.x86_family		= 6,				\
186 	.x86_vendor		= X86_VENDOR_INTEL,		\
187 	.x86_model		= (model),			\
188 	.x86_stepping		= (stepping),			\
189 	.x86_microcode_rev	= (revision),			\
190 }
191 
192 extern const struct x86_cpu_id *x86_match_cpu(const struct x86_cpu_id *match);
193 extern bool x86_cpu_has_min_microcode_rev(const struct x86_cpu_desc *table);
194 
195 #endif /* _ASM_X86_CPU_DEVICE_ID */
196