xref: /illumos-gate/usr/src/uts/i86pc/cpu/amd_opteron/ao.h (revision 22e4c3ac)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
24  */
25 
26 #ifndef _AO_H
27 #define	_AO_H
28 
29 #include <sys/types.h>
30 #include <sys/mc.h>
31 #include <sys/mca_amd.h>
32 #include <sys/mc_amd.h>
33 #include <sys/cpu_module_ms_impl.h>
34 #include <sys/nvpair.h>
35 #include <sys/cyclic.h>
36 #include <sys/errorq.h>
37 #include <sys/kobj.h>
38 #include <sys/fm/util.h>
39 
40 #ifdef __cplusplus
41 extern "C" {
42 #endif
43 
44 #define	AO_MAX_CHIPS		8
45 
46 #define	AO_MCA_MAX_ERRORS	10
47 
48 typedef struct ao_ms_data ao_ms_data_t;
49 
50 /*
51  * Rather than using torturous conditionals, we match errors using a table of
52  * ao_error_disp_t's.  The members in the ao_error_disp_t are matched against
53  * the value of MCi_STATUS, with a successful match indicating that the given
54  * error occurred.
55  *
56  * While aed_stat_code will match most of the status code bits, a few of the
57  * status code fields are either/or, and are treated separately so as to
58  * minimize the number of ao_error_disp_t structures that must be created.
59  * For example, the dc.tag_par error can have r4 values drd or dwr.  Rather
60  * than creating two ao_error_disp_t's, we use the separate aed_stat_r4_bits
61  * field to indicate both AO_MCA_R4_BIT_DRD and AO_MCA_R4_BIT_DWD.  As the
62  * matching r4 values are drawn from aed_stat_r4_bits, we don't use the r4
63  * bits in aed_stat_code for matching.  Similar reasoning lies behind the
64  * creation of the pp and ii fields.
65  */
66 #define	AO_AED_PANIC_NEVER	0x00
67 #define	AO_AED_PANIC_IFMCE	0x01
68 #define	AO_AED_PANIC_ALWAYS	0x80
69 
70 /*
71  * The AO_AED_F_* flags tell us how to interpret aspects of the error
72  * telemetry, such as which bits of the captured address are valid for
73  * this error.
74  */
75 					/* MCi_ADDR ... */
76 #define	AO_AED_F_LINEAR		0x01	/* is a linear address */
77 #define	AO_AED_F_PHYSICAL	0x02	/* is a physical address */
78 #define	AO_AED_F_PAGEALIGNED	0x04	/* aligns to page size */
79 #define	AO_AED_F_L2SETWAY	0x08	/* 3:0 = way, 15/14/13/12:6 = set */
80 
81 #define	AO_AED_FLAGS_ADDRTYPE	(AO_AED_F_LINEAR | AO_AED_F_PHYSICAL | \
82     AO_AED_F_PAGEALIGNED | AO_AED_F_L2SETWAY)
83 
84 /*
85  * The AO_AED_ET_* flags group individual error dispositions into
86  * error types.  This is used to nominate additional telemetry beyond the
87  * architectural bank registers to capture for this error type.
88  */
89 #define	AO_AED_ET_MEMECC		0x0001	/* Main memory ECC error */
90 
91 typedef struct ao_error_disp {
92 	const char *aed_class;		/* ereport class for use if match */
93 	uint64_t aed_ereport_members;	/* ereport contents flags if match */
94 	uint64_t aed_stat_mask;		/* status msr bits for match */
95 	uint64_t aed_stat_mask_res;	/* status mask result for match */
96 	uint16_t aed_stat_code;		/* status code for match */
97 	uint8_t aed_stat_extcode;	/* extended status code for match */
98 	uint8_t aed_stat_pp_bits:4;	/* AO_MCA_PP_BIT_* for pp matching */
99 	uint8_t aed_stat_ii_bits:4;	/* AO_MCA_II_BIT_* for ii matching */
100 	uint16_t aed_stat_r4_bits;	/* AO_MCA_R4_BIT_* for r4 matching */
101 	uint8_t aed_addrvalid_hi;	/* most significant valid addr bit */
102 	uint8_t aed_addrvalid_lo;	/* least significant valid addr bit */
103 	uint8_t aed_panic_when;		/* extra conditions for panic */
104 	uint16_t aed_flags;		/* AO_AED_F_* */
105 	uint16_t aed_errtype;		/* AO_AED_ET_* */
106 } ao_error_disp_t;
107 
108 /*
109  * We store non-architectutal config as inherited from the BIOS to assist
110  * in troubleshooting.
111  */
112 struct ao_bios_cfg {
113 	uint64_t *bcfg_bank_mask;
114 };
115 
116 /*
117  * The master data structure used to hold MCA-related state.
118  */
119 typedef struct ao_ms_mca {
120 	struct ao_bios_cfg ao_mca_bios_cfg;
121 	kmutex_t ao_mca_poll_lock;	/* keep pollers from colliding */
122 	uint_t ao_mca_flags;		/* AO_MCA_F_* */
123 } ao_ms_mca_t;
124 
125 /*
126  * Per-chip shared state
127  */
128 struct ao_chipshared {
129 	x86_chiprev_t aos_chiprev;
130 	volatile ulong_t aos_cfgonce;	/* Config performed once per chip */
131 	hrtime_t aos_nb_poll_timestamp;
132 	cmi_hdl_t aos_nb_poll_owner;
133 	uint64_t aos_bcfg_nb_misc;	/* BIOS value of MC4_MISC MSR */
134 	uint32_t aos_bcfg_nb_cfg;	/* BIOS value of NB MCA Config */
135 	uint32_t aos_bcfg_nb_sparectl;	/* BIOS value of Online Spare Control */
136 	uint32_t aos_bcfg_dcfg_lo;	/* BIOS value of DRAM Config Low */
137 	uint32_t aos_bcfg_dcfg_hi;	/* BIOS value of DRAM Config High */
138 	uint32_t aos_bcfg_scrubctl;	/* BIOS value of scrub control */
139 };
140 
141 /* Bit numbers for once-per-chip operations policed by cms_once */
142 enum ao_cfgonce_bitnum {
143 	AO_CFGONCE_NBMCA,
144 	AO_CFGONCE_NBCFG,
145 	AO_CFGONCE_DRAMCFG
146 };
147 
148 /*
149  * Per-CPU model-specific state
150  */
151 struct ao_ms_data {
152 	cmi_hdl_t ao_ms_hdl;
153 	ao_ms_mca_t ao_ms_mca;
154 	struct ao_chipshared *ao_ms_shared;
155 	uint64_t ao_ms_hwcr_val;
156 };
157 
158 #ifdef _KERNEL
159 
160 struct regs;
161 
162 /*
163  * Our cms_ops operations and function prototypes for all non-NULL members.
164  */
165 extern const cms_ops_t _cms_ops;
166 
167 extern int ao_ms_init(cmi_hdl_t, void **);
168 extern void ao_ms_post_startup(cmi_hdl_t);
169 extern void ao_ms_post_mpstartup(cmi_hdl_t);
170 extern uint64_t ao_ms_mcgctl_val(cmi_hdl_t, int, uint64_t);
171 extern boolean_t ao_ms_bankctl_skipinit(cmi_hdl_t, int);
172 extern uint64_t ao_ms_bankctl_val(cmi_hdl_t, int, uint64_t);
173 extern void ao_ms_mca_init(cmi_hdl_t, int);
174 extern uint64_t ao_ms_poll_ownermask(cmi_hdl_t, hrtime_t);
175 extern uint32_t ao_ms_error_action(cmi_hdl_t, int, int, uint64_t,
176     uint64_t, uint64_t, void *);
177 extern cms_cookie_t ao_ms_disp_match(cmi_hdl_t, int, int, uint64_t, uint64_t,
178     uint64_t, void *);
179 extern void ao_ms_ereport_class(cmi_hdl_t, cms_cookie_t, const char **,
180     const char **);
181 extern boolean_t ao_ms_ereport_includestack(cmi_hdl_t, cms_cookie_t);
182 extern void ao_ms_ereport_add_logout(cmi_hdl_t, nvlist_t *,
183     nv_alloc_t *, int, uint64_t, uint64_t, uint64_t, void *, void *);
184 extern cms_errno_t ao_ms_msrinject(cmi_hdl_t, uint_t, uint64_t);
185 
186 /*
187  * Local functions
188  */
189 extern void ao_procnode_scrubber_enable(cmi_hdl_t, ao_ms_data_t *);
190 extern void ao_pcicfg_write(uint_t, uint_t, uint_t, uint32_t);
191 extern uint32_t ao_pcicfg_read(uint_t, uint_t, uint_t);
192 extern void ao_bankstatus_prewrite(cmi_hdl_t, ao_ms_data_t *);
193 extern void ao_bankstatus_postwrite(cmi_hdl_t, ao_ms_data_t *);
194 
195 #endif /* _KERNEL */
196 
197 #ifdef __cplusplus
198 }
199 #endif
200 
201 #endif /* _AO_H */
202