Commit | Line | Data |
---|---|---|
7c9281d7 DT |
1 | /* |
2 | * Defines, structures, APIs for edac_core module | |
3 | * | |
4 | * (C) 2007 Linux Networx (http://lnxi.com) | |
5 | * This file may be distributed under the terms of the | |
6 | * GNU General Public License. | |
7 | * | |
8 | * Written by Thayne Harbaugh | |
9 | * Based on work by Dan Hollis <goemon at anime dot net> and others. | |
10 | * http://www.anime.net/~goemon/linux-ecc/ | |
11 | * | |
12 | * NMI handling support added by | |
13 | * Dave Peterson <dsp@llnl.gov> <dave_peterson@pobox.com> | |
14 | * | |
15 | * Refactored for multi-source files: | |
16 | * Doug Thompson <norsk5@xmission.com> | |
17 | * | |
18 | */ | |
19 | ||
20 | #ifndef _EDAC_CORE_H_ | |
21 | #define _EDAC_CORE_H_ | |
22 | ||
23 | #include <linux/kernel.h> | |
24 | #include <linux/types.h> | |
25 | #include <linux/module.h> | |
26 | #include <linux/spinlock.h> | |
27 | #include <linux/smp.h> | |
28 | #include <linux/pci.h> | |
29 | #include <linux/time.h> | |
30 | #include <linux/nmi.h> | |
31 | #include <linux/rcupdate.h> | |
32 | #include <linux/completion.h> | |
33 | #include <linux/kobject.h> | |
34 | #include <linux/platform_device.h> | |
e27e3dac DT |
35 | #include <linux/sysdev.h> |
36 | #include <linux/workqueue.h> | |
7c9281d7 DT |
37 | |
38 | #define EDAC_MC_LABEL_LEN 31 | |
e27e3dac DT |
39 | #define EDAC_DEVICE_NAME_LEN 31 |
40 | #define EDAC_ATTRIB_VALUE_LEN 15 | |
41 | #define MC_PROC_NAME_MAX_LEN 7 | |
7c9281d7 DT |
42 | |
43 | #if PAGE_SHIFT < 20 | |
76f04f25 AK |
44 | #define PAGES_TO_MiB(pages) ((pages) >> (20 - PAGE_SHIFT)) |
45 | #define MiB_TO_PAGES(mb) ((mb) << (20 - PAGE_SHIFT)) | |
7c9281d7 | 46 | #else /* PAGE_SHIFT > 20 */ |
76f04f25 | 47 | #define PAGES_TO_MiB(pages) ((pages) << (PAGE_SHIFT - 20)) |
e9144601 | 48 | #define MiB_TO_PAGES(mb) ((mb) >> (PAGE_SHIFT - 20)) |
7c9281d7 DT |
49 | #endif |
50 | ||
51 | #define edac_printk(level, prefix, fmt, arg...) \ | |
52 | printk(level "EDAC " prefix ": " fmt, ##arg) | |
53 | ||
54 | #define edac_mc_printk(mci, level, fmt, arg...) \ | |
55 | printk(level "EDAC MC%d: " fmt, mci->mc_idx, ##arg) | |
56 | ||
57 | #define edac_mc_chipset_printk(mci, level, prefix, fmt, arg...) \ | |
58 | printk(level "EDAC " prefix " MC%d: " fmt, mci->mc_idx, ##arg) | |
59 | ||
e27e3dac DT |
60 | #define edac_device_printk(ctl, level, fmt, arg...) \ |
61 | printk(level "EDAC DEVICE%d: " fmt, ctl->dev_idx, ##arg) | |
62 | ||
91b99041 DJ |
63 | #define edac_pci_printk(ctl, level, fmt, arg...) \ |
64 | printk(level "EDAC PCI%d: " fmt, ctl->pci_idx, ##arg) | |
65 | ||
7c9281d7 DT |
66 | /* prefixes for edac_printk() and edac_mc_printk() */ |
67 | #define EDAC_MC "MC" | |
68 | #define EDAC_PCI "PCI" | |
69 | #define EDAC_DEBUG "DEBUG" | |
70 | ||
24f9a7fe BP |
71 | extern const char *edac_mem_types[]; |
72 | ||
7c9281d7 DT |
73 | #ifdef CONFIG_EDAC_DEBUG |
74 | extern int edac_debug_level; | |
75 | ||
d357cbb4 BP |
76 | #define edac_debug_printk(level, fmt, arg...) \ |
77 | do { \ | |
78 | if (level <= edac_debug_level) \ | |
79 | edac_printk(KERN_DEBUG, EDAC_DEBUG, \ | |
80 | "%s: " fmt, __func__, ##arg); \ | |
cc18e3cd | 81 | } while (0) |
7c9281d7 DT |
82 | |
83 | #define debugf0( ... ) edac_debug_printk(0, __VA_ARGS__ ) | |
84 | #define debugf1( ... ) edac_debug_printk(1, __VA_ARGS__ ) | |
85 | #define debugf2( ... ) edac_debug_printk(2, __VA_ARGS__ ) | |
86 | #define debugf3( ... ) edac_debug_printk(3, __VA_ARGS__ ) | |
87 | #define debugf4( ... ) edac_debug_printk(4, __VA_ARGS__ ) | |
88 | ||
079708b9 | 89 | #else /* !CONFIG_EDAC_DEBUG */ |
7c9281d7 DT |
90 | |
91 | #define debugf0( ... ) | |
92 | #define debugf1( ... ) | |
93 | #define debugf2( ... ) | |
94 | #define debugf3( ... ) | |
95 | #define debugf4( ... ) | |
96 | ||
079708b9 | 97 | #endif /* !CONFIG_EDAC_DEBUG */ |
7c9281d7 | 98 | |
7c9281d7 DT |
99 | #define PCI_VEND_DEV(vend, dev) PCI_VENDOR_ID_ ## vend, \ |
100 | PCI_DEVICE_ID_ ## vend ## _ ## dev | |
101 | ||
17aa7e03 | 102 | #define edac_dev_name(dev) (dev)->dev_name |
7c9281d7 DT |
103 | |
104 | /* memory devices */ | |
105 | enum dev_type { | |
106 | DEV_UNKNOWN = 0, | |
107 | DEV_X1, | |
108 | DEV_X2, | |
109 | DEV_X4, | |
110 | DEV_X8, | |
111 | DEV_X16, | |
112 | DEV_X32, /* Do these parts exist? */ | |
113 | DEV_X64 /* Do these parts exist? */ | |
114 | }; | |
115 | ||
116 | #define DEV_FLAG_UNKNOWN BIT(DEV_UNKNOWN) | |
117 | #define DEV_FLAG_X1 BIT(DEV_X1) | |
118 | #define DEV_FLAG_X2 BIT(DEV_X2) | |
119 | #define DEV_FLAG_X4 BIT(DEV_X4) | |
120 | #define DEV_FLAG_X8 BIT(DEV_X8) | |
121 | #define DEV_FLAG_X16 BIT(DEV_X16) | |
122 | #define DEV_FLAG_X32 BIT(DEV_X32) | |
123 | #define DEV_FLAG_X64 BIT(DEV_X64) | |
124 | ||
125 | /* memory types */ | |
126 | enum mem_type { | |
127 | MEM_EMPTY = 0, /* Empty csrow */ | |
128 | MEM_RESERVED, /* Reserved csrow type */ | |
129 | MEM_UNKNOWN, /* Unknown csrow type */ | |
130 | MEM_FPM, /* Fast page mode */ | |
131 | MEM_EDO, /* Extended data out */ | |
132 | MEM_BEDO, /* Burst Extended data out */ | |
133 | MEM_SDR, /* Single data rate SDRAM */ | |
134 | MEM_RDR, /* Registered single data rate SDRAM */ | |
135 | MEM_DDR, /* Double data rate SDRAM */ | |
136 | MEM_RDDR, /* Registered Double data rate SDRAM */ | |
137 | MEM_RMBS, /* Rambus DRAM */ | |
079708b9 DT |
138 | MEM_DDR2, /* DDR2 RAM */ |
139 | MEM_FB_DDR2, /* fully buffered DDR2 */ | |
140 | MEM_RDDR2, /* Registered DDR2 RAM */ | |
1d5f726c | 141 | MEM_XDR, /* Rambus XDR */ |
b1cfebc9 YS |
142 | MEM_DDR3, /* DDR3 RAM */ |
143 | MEM_RDDR3, /* Registered DDR3 RAM */ | |
7c9281d7 DT |
144 | }; |
145 | ||
146 | #define MEM_FLAG_EMPTY BIT(MEM_EMPTY) | |
147 | #define MEM_FLAG_RESERVED BIT(MEM_RESERVED) | |
148 | #define MEM_FLAG_UNKNOWN BIT(MEM_UNKNOWN) | |
149 | #define MEM_FLAG_FPM BIT(MEM_FPM) | |
150 | #define MEM_FLAG_EDO BIT(MEM_EDO) | |
151 | #define MEM_FLAG_BEDO BIT(MEM_BEDO) | |
152 | #define MEM_FLAG_SDR BIT(MEM_SDR) | |
153 | #define MEM_FLAG_RDR BIT(MEM_RDR) | |
154 | #define MEM_FLAG_DDR BIT(MEM_DDR) | |
155 | #define MEM_FLAG_RDDR BIT(MEM_RDDR) | |
156 | #define MEM_FLAG_RMBS BIT(MEM_RMBS) | |
157 | #define MEM_FLAG_DDR2 BIT(MEM_DDR2) | |
158 | #define MEM_FLAG_FB_DDR2 BIT(MEM_FB_DDR2) | |
159 | #define MEM_FLAG_RDDR2 BIT(MEM_RDDR2) | |
1d5f726c | 160 | #define MEM_FLAG_XDR BIT(MEM_XDR) |
b1cfebc9 YS |
161 | #define MEM_FLAG_DDR3 BIT(MEM_DDR3) |
162 | #define MEM_FLAG_RDDR3 BIT(MEM_RDDR3) | |
7c9281d7 DT |
163 | |
164 | /* chipset Error Detection and Correction capabilities and mode */ | |
165 | enum edac_type { | |
166 | EDAC_UNKNOWN = 0, /* Unknown if ECC is available */ | |
167 | EDAC_NONE, /* Doesnt support ECC */ | |
168 | EDAC_RESERVED, /* Reserved ECC type */ | |
169 | EDAC_PARITY, /* Detects parity errors */ | |
170 | EDAC_EC, /* Error Checking - no correction */ | |
171 | EDAC_SECDED, /* Single bit error correction, Double detection */ | |
172 | EDAC_S2ECD2ED, /* Chipkill x2 devices - do these exist? */ | |
173 | EDAC_S4ECD4ED, /* Chipkill x4 devices */ | |
174 | EDAC_S8ECD8ED, /* Chipkill x8 devices */ | |
175 | EDAC_S16ECD16ED, /* Chipkill x16 devices */ | |
176 | }; | |
177 | ||
178 | #define EDAC_FLAG_UNKNOWN BIT(EDAC_UNKNOWN) | |
179 | #define EDAC_FLAG_NONE BIT(EDAC_NONE) | |
180 | #define EDAC_FLAG_PARITY BIT(EDAC_PARITY) | |
181 | #define EDAC_FLAG_EC BIT(EDAC_EC) | |
182 | #define EDAC_FLAG_SECDED BIT(EDAC_SECDED) | |
183 | #define EDAC_FLAG_S2ECD2ED BIT(EDAC_S2ECD2ED) | |
184 | #define EDAC_FLAG_S4ECD4ED BIT(EDAC_S4ECD4ED) | |
185 | #define EDAC_FLAG_S8ECD8ED BIT(EDAC_S8ECD8ED) | |
186 | #define EDAC_FLAG_S16ECD16ED BIT(EDAC_S16ECD16ED) | |
187 | ||
188 | /* scrubbing capabilities */ | |
189 | enum scrub_type { | |
190 | SCRUB_UNKNOWN = 0, /* Unknown if scrubber is available */ | |
191 | SCRUB_NONE, /* No scrubber */ | |
192 | SCRUB_SW_PROG, /* SW progressive (sequential) scrubbing */ | |
193 | SCRUB_SW_SRC, /* Software scrub only errors */ | |
194 | SCRUB_SW_PROG_SRC, /* Progressive software scrub from an error */ | |
195 | SCRUB_SW_TUNABLE, /* Software scrub frequency is tunable */ | |
196 | SCRUB_HW_PROG, /* HW progressive (sequential) scrubbing */ | |
197 | SCRUB_HW_SRC, /* Hardware scrub only errors */ | |
198 | SCRUB_HW_PROG_SRC, /* Progressive hardware scrub from an error */ | |
199 | SCRUB_HW_TUNABLE /* Hardware scrub frequency is tunable */ | |
200 | }; | |
201 | ||
202 | #define SCRUB_FLAG_SW_PROG BIT(SCRUB_SW_PROG) | |
522a94bd DT |
203 | #define SCRUB_FLAG_SW_SRC BIT(SCRUB_SW_SRC) |
204 | #define SCRUB_FLAG_SW_PROG_SRC BIT(SCRUB_SW_PROG_SRC) | |
7c9281d7 DT |
205 | #define SCRUB_FLAG_SW_TUN BIT(SCRUB_SW_SCRUB_TUNABLE) |
206 | #define SCRUB_FLAG_HW_PROG BIT(SCRUB_HW_PROG) | |
522a94bd DT |
207 | #define SCRUB_FLAG_HW_SRC BIT(SCRUB_HW_SRC) |
208 | #define SCRUB_FLAG_HW_PROG_SRC BIT(SCRUB_HW_PROG_SRC) | |
7c9281d7 DT |
209 | #define SCRUB_FLAG_HW_TUN BIT(SCRUB_HW_TUNABLE) |
210 | ||
211 | /* FIXME - should have notify capabilities: NMI, LOG, PROC, etc */ | |
212 | ||
91b99041 DJ |
213 | /* EDAC internal operation states */ |
214 | #define OP_ALLOC 0x100 | |
215 | #define OP_RUNNING_POLL 0x201 | |
216 | #define OP_RUNNING_INTERRUPT 0x202 | |
217 | #define OP_RUNNING_POLL_INTR 0x203 | |
218 | #define OP_OFFLINE 0x300 | |
219 | ||
7c9281d7 DT |
220 | /* |
221 | * There are several things to be aware of that aren't at all obvious: | |
222 | * | |
223 | * | |
224 | * SOCKETS, SOCKET SETS, BANKS, ROWS, CHIP-SELECT ROWS, CHANNELS, etc.. | |
225 | * | |
226 | * These are some of the many terms that are thrown about that don't always | |
227 | * mean what people think they mean (Inconceivable!). In the interest of | |
228 | * creating a common ground for discussion, terms and their definitions | |
229 | * will be established. | |
230 | * | |
231 | * Memory devices: The individual chip on a memory stick. These devices | |
232 | * commonly output 4 and 8 bits each. Grouping several | |
233 | * of these in parallel provides 64 bits which is common | |
234 | * for a memory stick. | |
235 | * | |
236 | * Memory Stick: A printed circuit board that agregates multiple | |
237 | * memory devices in parallel. This is the atomic | |
238 | * memory component that is purchaseable by Joe consumer | |
239 | * and loaded into a memory socket. | |
240 | * | |
241 | * Socket: A physical connector on the motherboard that accepts | |
242 | * a single memory stick. | |
243 | * | |
244 | * Channel: Set of memory devices on a memory stick that must be | |
245 | * grouped in parallel with one or more additional | |
246 | * channels from other memory sticks. This parallel | |
247 | * grouping of the output from multiple channels are | |
248 | * necessary for the smallest granularity of memory access. | |
249 | * Some memory controllers are capable of single channel - | |
250 | * which means that memory sticks can be loaded | |
251 | * individually. Other memory controllers are only | |
252 | * capable of dual channel - which means that memory | |
253 | * sticks must be loaded as pairs (see "socket set"). | |
254 | * | |
255 | * Chip-select row: All of the memory devices that are selected together. | |
256 | * for a single, minimum grain of memory access. | |
257 | * This selects all of the parallel memory devices across | |
258 | * all of the parallel channels. Common chip-select rows | |
259 | * for single channel are 64 bits, for dual channel 128 | |
260 | * bits. | |
261 | * | |
b595076a | 262 | * Single-Ranked stick: A Single-ranked stick has 1 chip-select row of memory. |
7c9281d7 DT |
263 | * Motherboards commonly drive two chip-select pins to |
264 | * a memory stick. A single-ranked stick, will occupy | |
265 | * only one of those rows. The other will be unused. | |
266 | * | |
267 | * Double-Ranked stick: A double-ranked stick has two chip-select rows which | |
268 | * access different sets of memory devices. The two | |
269 | * rows cannot be accessed concurrently. | |
270 | * | |
271 | * Double-sided stick: DEPRECATED TERM, see Double-Ranked stick. | |
272 | * A double-sided stick has two chip-select rows which | |
273 | * access different sets of memory devices. The two | |
274 | * rows cannot be accessed concurrently. "Double-sided" | |
275 | * is irrespective of the memory devices being mounted | |
276 | * on both sides of the memory stick. | |
277 | * | |
411c9403 | 278 | * Socket set: All of the memory sticks that are required for |
7c9281d7 DT |
279 | * a single memory access or all of the memory sticks |
280 | * spanned by a chip-select row. A single socket set | |
281 | * has two chip-select rows and if double-sided sticks | |
282 | * are used these will occupy those chip-select rows. | |
283 | * | |
284 | * Bank: This term is avoided because it is unclear when | |
285 | * needing to distinguish between chip-select rows and | |
286 | * socket sets. | |
287 | * | |
288 | * Controller pages: | |
289 | * | |
290 | * Physical pages: | |
291 | * | |
292 | * Virtual pages: | |
293 | * | |
294 | * | |
295 | * STRUCTURE ORGANIZATION AND CHOICES | |
296 | * | |
297 | * | |
298 | * | |
299 | * PS - I enjoyed writing all that about as much as you enjoyed reading it. | |
300 | */ | |
301 | ||
302 | struct channel_info { | |
303 | int chan_idx; /* channel index */ | |
304 | u32 ce_count; /* Correctable Errors for this CHANNEL */ | |
079708b9 | 305 | char label[EDAC_MC_LABEL_LEN + 1]; /* DIMM label on motherboard */ |
7c9281d7 DT |
306 | struct csrow_info *csrow; /* the parent */ |
307 | }; | |
308 | ||
309 | struct csrow_info { | |
310 | unsigned long first_page; /* first page number in dimm */ | |
311 | unsigned long last_page; /* last page number in dimm */ | |
312 | unsigned long page_mask; /* used for interleaving - | |
313 | * 0UL for non intlv | |
314 | */ | |
315 | u32 nr_pages; /* number of pages in csrow */ | |
316 | u32 grain; /* granularity of reported error in bytes */ | |
317 | int csrow_idx; /* the chip-select row */ | |
318 | enum dev_type dtype; /* memory device type */ | |
319 | u32 ue_count; /* Uncorrectable Errors for this csrow */ | |
320 | u32 ce_count; /* Correctable Errors for this csrow */ | |
321 | enum mem_type mtype; /* memory csrow type */ | |
322 | enum edac_type edac_mode; /* EDAC mode for this csrow */ | |
323 | struct mem_ctl_info *mci; /* the parent */ | |
324 | ||
325 | struct kobject kobj; /* sysfs kobject for this csrow */ | |
7c9281d7 | 326 | |
8096cfaf | 327 | /* channel information for this csrow */ |
7c9281d7 DT |
328 | u32 nr_channels; |
329 | struct channel_info *channels; | |
330 | }; | |
331 | ||
9fa2fc2e | 332 | struct mcidev_sysfs_group { |
b968759e | 333 | const char *name; /* group name */ |
1288c18f | 334 | const struct mcidev_sysfs_attribute *mcidev_attr; /* group attributes */ |
b968759e MCC |
335 | }; |
336 | ||
337 | struct mcidev_sysfs_group_kobj { | |
338 | struct list_head list; /* list for all instances within a mc */ | |
339 | ||
340 | struct kobject kobj; /* kobj for the group */ | |
cc301b3a | 341 | |
1288c18f | 342 | const struct mcidev_sysfs_group *grp; /* group description table */ |
cc301b3a | 343 | struct mem_ctl_info *mci; /* the parent */ |
9fa2fc2e MCC |
344 | }; |
345 | ||
42a8e397 DT |
346 | /* mcidev_sysfs_attribute structure |
347 | * used for driver sysfs attributes and in mem_ctl_info | |
348 | * sysfs top level entries | |
349 | */ | |
350 | struct mcidev_sysfs_attribute { | |
b968759e | 351 | /* It should use either attr or grp */ |
9fa2fc2e | 352 | struct attribute attr; |
1288c18f | 353 | const struct mcidev_sysfs_group *grp; /* Points to a group of attributes */ |
9fa2fc2e | 354 | |
b968759e | 355 | /* Ops for show/store values at the attribute - not used on group */ |
42a8e397 DT |
356 | ssize_t (*show)(struct mem_ctl_info *,char *); |
357 | ssize_t (*store)(struct mem_ctl_info *, const char *,size_t); | |
358 | }; | |
359 | ||
360 | /* MEMORY controller information structure | |
361 | */ | |
7c9281d7 | 362 | struct mem_ctl_info { |
079708b9 | 363 | struct list_head link; /* for global list of mem_ctl_info structs */ |
1c3631ff DT |
364 | |
365 | struct module *owner; /* Module owner of this control struct */ | |
366 | ||
7c9281d7 DT |
367 | unsigned long mtype_cap; /* memory types supported by mc */ |
368 | unsigned long edac_ctl_cap; /* Mem controller EDAC capabilities */ | |
369 | unsigned long edac_cap; /* configuration capabilities - this is | |
370 | * closely related to edac_ctl_cap. The | |
371 | * difference is that the controller may be | |
372 | * capable of s4ecd4ed which would be listed | |
373 | * in edac_ctl_cap, but if channels aren't | |
374 | * capable of s4ecd4ed then the edac_cap would | |
375 | * not have that capability. | |
376 | */ | |
377 | unsigned long scrub_cap; /* chipset scrub capabilities */ | |
378 | enum scrub_type scrub_mode; /* current scrub mode */ | |
379 | ||
380 | /* Translates sdram memory scrub rate given in bytes/sec to the | |
381 | internal representation and configures whatever else needs | |
382 | to be configured. | |
079708b9 | 383 | */ |
eba042a8 | 384 | int (*set_sdram_scrub_rate) (struct mem_ctl_info * mci, u32 bw); |
7c9281d7 DT |
385 | |
386 | /* Get the current sdram memory scrub rate from the internal | |
387 | representation and converts it to the closest matching | |
388 | bandwith in bytes/sec. | |
079708b9 | 389 | */ |
39094443 | 390 | int (*get_sdram_scrub_rate) (struct mem_ctl_info * mci); |
7c9281d7 | 391 | |
42a8e397 | 392 | |
7c9281d7 DT |
393 | /* pointer to edac checking routine */ |
394 | void (*edac_check) (struct mem_ctl_info * mci); | |
395 | ||
396 | /* | |
397 | * Remaps memory pages: controller pages to physical pages. | |
398 | * For most MC's, this will be NULL. | |
399 | */ | |
400 | /* FIXME - why not send the phys page to begin with? */ | |
401 | unsigned long (*ctl_page_to_phys) (struct mem_ctl_info * mci, | |
079708b9 | 402 | unsigned long page); |
7c9281d7 DT |
403 | int mc_idx; |
404 | int nr_csrows; | |
405 | struct csrow_info *csrows; | |
406 | /* | |
407 | * FIXME - what about controllers on other busses? - IDs must be | |
408 | * unique. dev pointer should be sufficiently unique, but | |
409 | * BUS:SLOT.FUNC numbers may not be unique. | |
410 | */ | |
411 | struct device *dev; | |
412 | const char *mod_name; | |
413 | const char *mod_ver; | |
414 | const char *ctl_name; | |
c4192705 | 415 | const char *dev_name; |
7c9281d7 DT |
416 | char proc_name[MC_PROC_NAME_MAX_LEN + 1]; |
417 | void *pvt_info; | |
418 | u32 ue_noinfo_count; /* Uncorrectable Errors w/o info */ | |
419 | u32 ce_noinfo_count; /* Correctable Errors w/o info */ | |
420 | u32 ue_count; /* Total Uncorrectable Errors for this MC */ | |
421 | u32 ce_count; /* Total Correctable Errors for this MC */ | |
422 | unsigned long start_time; /* mci load start time (in jiffies) */ | |
423 | ||
424 | /* this stuff is for safe removal of mc devices from global list while | |
425 | * NMI handlers may be traversing list | |
426 | */ | |
427 | struct rcu_head rcu; | |
428 | struct completion complete; | |
429 | ||
430 | /* edac sysfs device control */ | |
431 | struct kobject edac_mci_kobj; | |
81d87cb1 | 432 | |
b968759e MCC |
433 | /* list for all grp instances within a mc */ |
434 | struct list_head grp_kobj_list; | |
435 | ||
42a8e397 DT |
436 | /* Additional top controller level attributes, but specified |
437 | * by the low level driver. | |
438 | * | |
439 | * Set by the low level driver to provide attributes at the | |
440 | * controller level, same level as 'ue_count' and 'ce_count' above. | |
441 | * An array of structures, NULL terminated | |
442 | * | |
443 | * If attributes are desired, then set to array of attributes | |
444 | * If no attributes are desired, leave NULL | |
445 | */ | |
1288c18f | 446 | const struct mcidev_sysfs_attribute *mc_driver_sysfs_attributes; |
42a8e397 | 447 | |
81d87cb1 | 448 | /* work struct for this MC */ |
81d87cb1 | 449 | struct delayed_work work; |
86aa8cb7 | 450 | |
81d87cb1 DJ |
451 | /* the internal state of this controller instance */ |
452 | int op_state; | |
7c9281d7 DT |
453 | }; |
454 | ||
e27e3dac | 455 | /* |
42a8e397 | 456 | * The following are the structures to provide for a generic |
e27e3dac DT |
457 | * or abstract 'edac_device'. This set of structures and the |
458 | * code that implements the APIs for the same, provide for | |
459 | * registering EDAC type devices which are NOT standard memory. | |
460 | * | |
461 | * CPU caches (L1 and L2) | |
462 | * DMA engines | |
463 | * Core CPU swithces | |
464 | * Fabric switch units | |
465 | * PCIe interface controllers | |
466 | * other EDAC/ECC type devices that can be monitored for | |
467 | * errors, etc. | |
468 | * | |
469 | * It allows for a 2 level set of hiearchry. For example: | |
470 | * | |
471 | * cache could be composed of L1, L2 and L3 levels of cache. | |
472 | * Each CPU core would have its own L1 cache, while sharing | |
473 | * L2 and maybe L3 caches. | |
474 | * | |
475 | * View them arranged, via the sysfs presentation: | |
476 | * /sys/devices/system/edac/.. | |
477 | * | |
478 | * mc/ <existing memory device directory> | |
479 | * cpu/cpu0/.. <L1 and L2 block directory> | |
480 | * /L1-cache/ce_count | |
481 | * /ue_count | |
482 | * /L2-cache/ce_count | |
483 | * /ue_count | |
484 | * cpu/cpu1/.. <L1 and L2 block directory> | |
485 | * /L1-cache/ce_count | |
486 | * /ue_count | |
487 | * /L2-cache/ce_count | |
488 | * /ue_count | |
489 | * ... | |
490 | * | |
491 | * the L1 and L2 directories would be "edac_device_block's" | |
492 | */ | |
493 | ||
494 | struct edac_device_counter { | |
079708b9 DT |
495 | u32 ue_count; |
496 | u32 ce_count; | |
e27e3dac DT |
497 | }; |
498 | ||
fd309a9d DT |
499 | /* forward reference */ |
500 | struct edac_device_ctl_info; | |
501 | struct edac_device_block; | |
e27e3dac | 502 | |
fd309a9d DT |
503 | /* edac_dev_sysfs_attribute structure |
504 | * used for driver sysfs attributes in mem_ctl_info | |
505 | * for extra controls and attributes: | |
506 | * like high level error Injection controls | |
507 | */ | |
508 | struct edac_dev_sysfs_attribute { | |
509 | struct attribute attr; | |
510 | ssize_t (*show)(struct edac_device_ctl_info *, char *); | |
511 | ssize_t (*store)(struct edac_device_ctl_info *, const char *, size_t); | |
e27e3dac DT |
512 | }; |
513 | ||
fd309a9d | 514 | /* edac_dev_sysfs_block_attribute structure |
b2a4ac0c | 515 | * |
fd309a9d | 516 | * used in leaf 'block' nodes for adding controls/attributes |
b2a4ac0c DT |
517 | * |
518 | * each block in each instance of the containing control structure | |
519 | * can have an array of the following. The show and store functions | |
520 | * will be filled in with the show/store function in the | |
521 | * low level driver. | |
522 | * | |
523 | * The 'value' field will be the actual value field used for | |
524 | * counting | |
e27e3dac | 525 | */ |
fd309a9d DT |
526 | struct edac_dev_sysfs_block_attribute { |
527 | struct attribute attr; | |
528 | ssize_t (*show)(struct kobject *, struct attribute *, char *); | |
529 | ssize_t (*store)(struct kobject *, struct attribute *, | |
530 | const char *, size_t); | |
531 | struct edac_device_block *block; | |
532 | ||
fd309a9d | 533 | unsigned int value; |
e27e3dac DT |
534 | }; |
535 | ||
536 | /* device block control structure */ | |
537 | struct edac_device_block { | |
538 | struct edac_device_instance *instance; /* Up Pointer */ | |
079708b9 | 539 | char name[EDAC_DEVICE_NAME_LEN + 1]; |
e27e3dac DT |
540 | |
541 | struct edac_device_counter counters; /* basic UE and CE counters */ | |
542 | ||
079708b9 | 543 | int nr_attribs; /* how many attributes */ |
fd309a9d DT |
544 | |
545 | /* this block's attributes, could be NULL */ | |
546 | struct edac_dev_sysfs_block_attribute *block_attributes; | |
e27e3dac DT |
547 | |
548 | /* edac sysfs device control */ | |
549 | struct kobject kobj; | |
e27e3dac DT |
550 | }; |
551 | ||
552 | /* device instance control structure */ | |
553 | struct edac_device_instance { | |
554 | struct edac_device_ctl_info *ctl; /* Up pointer */ | |
555 | char name[EDAC_DEVICE_NAME_LEN + 4]; | |
556 | ||
557 | struct edac_device_counter counters; /* instance counters */ | |
558 | ||
079708b9 | 559 | u32 nr_blocks; /* how many blocks */ |
e27e3dac DT |
560 | struct edac_device_block *blocks; /* block array */ |
561 | ||
562 | /* edac sysfs device control */ | |
563 | struct kobject kobj; | |
e27e3dac DT |
564 | }; |
565 | ||
42a8e397 | 566 | |
e27e3dac DT |
567 | /* |
568 | * Abstract edac_device control info structure | |
569 | * | |
570 | */ | |
571 | struct edac_device_ctl_info { | |
572 | /* for global list of edac_device_ctl_info structs */ | |
573 | struct list_head link; | |
574 | ||
1c3631ff DT |
575 | struct module *owner; /* Module owner of this control struct */ |
576 | ||
e27e3dac DT |
577 | int dev_idx; |
578 | ||
579 | /* Per instance controls for this edac_device */ | |
580 | int log_ue; /* boolean for logging UEs */ | |
581 | int log_ce; /* boolean for logging CEs */ | |
582 | int panic_on_ue; /* boolean for panic'ing on an UE */ | |
583 | unsigned poll_msec; /* number of milliseconds to poll interval */ | |
584 | unsigned long delay; /* number of jiffies for poll_msec */ | |
585 | ||
42a8e397 DT |
586 | /* Additional top controller level attributes, but specified |
587 | * by the low level driver. | |
588 | * | |
589 | * Set by the low level driver to provide attributes at the | |
590 | * controller level, same level as 'ue_count' and 'ce_count' above. | |
591 | * An array of structures, NULL terminated | |
592 | * | |
593 | * If attributes are desired, then set to array of attributes | |
594 | * If no attributes are desired, leave NULL | |
595 | */ | |
596 | struct edac_dev_sysfs_attribute *sysfs_attributes; | |
597 | ||
598 | /* pointer to main 'edac' class in sysfs */ | |
599 | struct sysdev_class *edac_class; | |
e27e3dac DT |
600 | |
601 | /* the internal state of this controller instance */ | |
602 | int op_state; | |
e27e3dac | 603 | /* work struct for this instance */ |
e27e3dac | 604 | struct delayed_work work; |
e27e3dac DT |
605 | |
606 | /* pointer to edac polling checking routine: | |
079708b9 DT |
607 | * If NOT NULL: points to polling check routine |
608 | * If NULL: Then assumes INTERRUPT operation, where | |
609 | * MC driver will receive events | |
e27e3dac DT |
610 | */ |
611 | void (*edac_check) (struct edac_device_ctl_info * edac_dev); | |
612 | ||
613 | struct device *dev; /* pointer to device structure */ | |
614 | ||
615 | const char *mod_name; /* module name */ | |
616 | const char *ctl_name; /* edac controller name */ | |
c4192705 | 617 | const char *dev_name; /* pci/platform/etc... name */ |
e27e3dac DT |
618 | |
619 | void *pvt_info; /* pointer to 'private driver' info */ | |
620 | ||
079708b9 | 621 | unsigned long start_time; /* edac_device load start time (jiffies) */ |
e27e3dac DT |
622 | |
623 | /* these are for safe removal of mc devices from global list while | |
624 | * NMI handlers may be traversing list | |
625 | */ | |
626 | struct rcu_head rcu; | |
1c3631ff | 627 | struct completion removal_complete; |
e27e3dac DT |
628 | |
629 | /* sysfs top name under 'edac' directory | |
630 | * and instance name: | |
079708b9 DT |
631 | * cpu/cpu0/... |
632 | * cpu/cpu1/... | |
633 | * cpu/cpu2/... | |
634 | * ... | |
e27e3dac DT |
635 | */ |
636 | char name[EDAC_DEVICE_NAME_LEN + 1]; | |
637 | ||
638 | /* Number of instances supported on this control structure | |
639 | * and the array of those instances | |
640 | */ | |
641 | u32 nr_instances; | |
642 | struct edac_device_instance *instances; | |
643 | ||
644 | /* Event counters for the this whole EDAC Device */ | |
645 | struct edac_device_counter counters; | |
646 | ||
647 | /* edac sysfs device control for the 'name' | |
648 | * device this structure controls | |
649 | */ | |
650 | struct kobject kobj; | |
e27e3dac DT |
651 | }; |
652 | ||
653 | /* To get from the instance's wq to the beginning of the ctl structure */ | |
81d87cb1 DJ |
654 | #define to_edac_mem_ctl_work(w) \ |
655 | container_of(w, struct mem_ctl_info, work) | |
656 | ||
e27e3dac DT |
657 | #define to_edac_device_ctl_work(w) \ |
658 | container_of(w,struct edac_device_ctl_info,work) | |
659 | ||
e27e3dac DT |
660 | /* |
661 | * The alloc() and free() functions for the 'edac_device' control info | |
662 | * structure. A MC driver will allocate one of these for each edac_device | |
663 | * it is going to control/register with the EDAC CORE. | |
664 | */ | |
665 | extern struct edac_device_ctl_info *edac_device_alloc_ctl_info( | |
079708b9 | 666 | unsigned sizeof_private, |
fd309a9d DT |
667 | char *edac_device_name, unsigned nr_instances, |
668 | char *edac_block_name, unsigned nr_blocks, | |
079708b9 | 669 | unsigned offset_value, |
fd309a9d | 670 | struct edac_dev_sysfs_block_attribute *block_attributes, |
d45e7823 DT |
671 | unsigned nr_attribs, |
672 | int device_index); | |
e27e3dac DT |
673 | |
674 | /* The offset value can be: | |
675 | * -1 indicating no offset value | |
676 | * 0 for zero-based block numbers | |
677 | * 1 for 1-based block number | |
678 | * other for other-based block number | |
679 | */ | |
680 | #define BLOCK_OFFSET_VALUE_OFF ((unsigned) -1) | |
681 | ||
079708b9 | 682 | extern void edac_device_free_ctl_info(struct edac_device_ctl_info *ctl_info); |
e27e3dac | 683 | |
7c9281d7 DT |
684 | #ifdef CONFIG_PCI |
685 | ||
91b99041 | 686 | struct edac_pci_counter { |
079708b9 DT |
687 | atomic_t pe_count; |
688 | atomic_t npe_count; | |
91b99041 DJ |
689 | }; |
690 | ||
691 | /* | |
692 | * Abstract edac_pci control info structure | |
693 | * | |
694 | */ | |
695 | struct edac_pci_ctl_info { | |
696 | /* for global list of edac_pci_ctl_info structs */ | |
697 | struct list_head link; | |
698 | ||
699 | int pci_idx; | |
700 | ||
91b99041 DJ |
701 | struct sysdev_class *edac_class; /* pointer to class */ |
702 | ||
703 | /* the internal state of this controller instance */ | |
704 | int op_state; | |
705 | /* work struct for this instance */ | |
91b99041 | 706 | struct delayed_work work; |
91b99041 DJ |
707 | |
708 | /* pointer to edac polling checking routine: | |
079708b9 DT |
709 | * If NOT NULL: points to polling check routine |
710 | * If NULL: Then assumes INTERRUPT operation, where | |
711 | * MC driver will receive events | |
91b99041 DJ |
712 | */ |
713 | void (*edac_check) (struct edac_pci_ctl_info * edac_dev); | |
714 | ||
715 | struct device *dev; /* pointer to device structure */ | |
716 | ||
717 | const char *mod_name; /* module name */ | |
718 | const char *ctl_name; /* edac controller name */ | |
719 | const char *dev_name; /* pci/platform/etc... name */ | |
720 | ||
721 | void *pvt_info; /* pointer to 'private driver' info */ | |
722 | ||
079708b9 | 723 | unsigned long start_time; /* edac_pci load start time (jiffies) */ |
91b99041 DJ |
724 | |
725 | /* these are for safe removal of devices from global list while | |
726 | * NMI handlers may be traversing list | |
727 | */ | |
728 | struct rcu_head rcu; | |
729 | struct completion complete; | |
730 | ||
731 | /* sysfs top name under 'edac' directory | |
732 | * and instance name: | |
079708b9 DT |
733 | * cpu/cpu0/... |
734 | * cpu/cpu1/... | |
735 | * cpu/cpu2/... | |
736 | * ... | |
91b99041 DJ |
737 | */ |
738 | char name[EDAC_DEVICE_NAME_LEN + 1]; | |
739 | ||
740 | /* Event counters for the this whole EDAC Device */ | |
741 | struct edac_pci_counter counters; | |
742 | ||
743 | /* edac sysfs device control for the 'name' | |
744 | * device this structure controls | |
745 | */ | |
746 | struct kobject kobj; | |
747 | struct completion kobj_complete; | |
748 | }; | |
749 | ||
750 | #define to_edac_pci_ctl_work(w) \ | |
751 | container_of(w, struct edac_pci_ctl_info,work) | |
752 | ||
7c9281d7 DT |
753 | /* write all or some bits in a byte-register*/ |
754 | static inline void pci_write_bits8(struct pci_dev *pdev, int offset, u8 value, | |
079708b9 | 755 | u8 mask) |
7c9281d7 DT |
756 | { |
757 | if (mask != 0xff) { | |
758 | u8 buf; | |
759 | ||
760 | pci_read_config_byte(pdev, offset, &buf); | |
761 | value &= mask; | |
762 | buf &= ~mask; | |
763 | value |= buf; | |
764 | } | |
765 | ||
766 | pci_write_config_byte(pdev, offset, value); | |
767 | } | |
768 | ||
769 | /* write all or some bits in a word-register*/ | |
770 | static inline void pci_write_bits16(struct pci_dev *pdev, int offset, | |
079708b9 | 771 | u16 value, u16 mask) |
7c9281d7 DT |
772 | { |
773 | if (mask != 0xffff) { | |
774 | u16 buf; | |
775 | ||
776 | pci_read_config_word(pdev, offset, &buf); | |
777 | value &= mask; | |
778 | buf &= ~mask; | |
779 | value |= buf; | |
780 | } | |
781 | ||
782 | pci_write_config_word(pdev, offset, value); | |
783 | } | |
784 | ||
e6da46b2 JH |
785 | /* |
786 | * pci_write_bits32 | |
787 | * | |
788 | * edac local routine to do pci_write_config_dword, but adds | |
789 | * a mask parameter. If mask is all ones, ignore the mask. | |
790 | * Otherwise utilize the mask to isolate specified bits | |
791 | * | |
792 | * write all or some bits in a dword-register | |
793 | */ | |
7c9281d7 | 794 | static inline void pci_write_bits32(struct pci_dev *pdev, int offset, |
079708b9 | 795 | u32 value, u32 mask) |
7c9281d7 | 796 | { |
e6da46b2 | 797 | if (mask != 0xffffffff) { |
7c9281d7 DT |
798 | u32 buf; |
799 | ||
800 | pci_read_config_dword(pdev, offset, &buf); | |
801 | value &= mask; | |
802 | buf &= ~mask; | |
803 | value |= buf; | |
804 | } | |
805 | ||
806 | pci_write_config_dword(pdev, offset, value); | |
807 | } | |
808 | ||
079708b9 | 809 | #endif /* CONFIG_PCI */ |
7c9281d7 | 810 | |
b8f6f975 DT |
811 | extern struct mem_ctl_info *edac_mc_alloc(unsigned sz_pvt, unsigned nr_csrows, |
812 | unsigned nr_chans, int edac_index); | |
813 | extern int edac_mc_add_mc(struct mem_ctl_info *mci); | |
814 | extern void edac_mc_free(struct mem_ctl_info *mci); | |
079708b9 | 815 | extern struct mem_ctl_info *edac_mc_find(int idx); |
939747bd | 816 | extern struct mem_ctl_info *find_mci_by_dev(struct device *dev); |
079708b9 | 817 | extern struct mem_ctl_info *edac_mc_del_mc(struct device *dev); |
7c9281d7 | 818 | extern int edac_mc_find_csrow_by_page(struct mem_ctl_info *mci, |
079708b9 | 819 | unsigned long page); |
7c9281d7 DT |
820 | |
821 | /* | |
822 | * The no info errors are used when error overflows are reported. | |
823 | * There are a limited number of error logging registers that can | |
824 | * be exausted. When all registers are exhausted and an additional | |
825 | * error occurs then an error overflow register records that an | |
826 | * error occured and the type of error, but doesn't have any | |
827 | * further information. The ce/ue versions make for cleaner | |
828 | * reporting logic and function interface - reduces conditional | |
829 | * statement clutter and extra function arguments. | |
830 | */ | |
831 | extern void edac_mc_handle_ce(struct mem_ctl_info *mci, | |
079708b9 DT |
832 | unsigned long page_frame_number, |
833 | unsigned long offset_in_page, | |
834 | unsigned long syndrome, int row, int channel, | |
835 | const char *msg); | |
7c9281d7 | 836 | extern void edac_mc_handle_ce_no_info(struct mem_ctl_info *mci, |
079708b9 | 837 | const char *msg); |
7c9281d7 | 838 | extern void edac_mc_handle_ue(struct mem_ctl_info *mci, |
079708b9 DT |
839 | unsigned long page_frame_number, |
840 | unsigned long offset_in_page, int row, | |
841 | const char *msg); | |
7c9281d7 | 842 | extern void edac_mc_handle_ue_no_info(struct mem_ctl_info *mci, |
079708b9 DT |
843 | const char *msg); |
844 | extern void edac_mc_handle_fbd_ue(struct mem_ctl_info *mci, unsigned int csrow, | |
845 | unsigned int channel0, unsigned int channel1, | |
846 | char *msg); | |
847 | extern void edac_mc_handle_fbd_ce(struct mem_ctl_info *mci, unsigned int csrow, | |
848 | unsigned int channel, char *msg); | |
7c9281d7 DT |
849 | |
850 | /* | |
e27e3dac | 851 | * edac_device APIs |
7c9281d7 | 852 | */ |
d45e7823 | 853 | extern int edac_device_add_device(struct edac_device_ctl_info *edac_dev); |
079708b9 | 854 | extern struct edac_device_ctl_info *edac_device_del_device(struct device *dev); |
e27e3dac | 855 | extern void edac_device_handle_ue(struct edac_device_ctl_info *edac_dev, |
b8f6f975 | 856 | int inst_nr, int block_nr, const char *msg); |
e27e3dac | 857 | extern void edac_device_handle_ce(struct edac_device_ctl_info *edac_dev, |
b8f6f975 | 858 | int inst_nr, int block_nr, const char *msg); |
1dc9b70d | 859 | extern int edac_device_alloc_index(void); |
e27e3dac | 860 | |
91b99041 DJ |
861 | /* |
862 | * edac_pci APIs | |
863 | */ | |
b8f6f975 DT |
864 | extern struct edac_pci_ctl_info *edac_pci_alloc_ctl_info(unsigned int sz_pvt, |
865 | const char *edac_pci_name); | |
91b99041 DJ |
866 | |
867 | extern void edac_pci_free_ctl_info(struct edac_pci_ctl_info *pci); | |
868 | ||
b8f6f975 DT |
869 | extern void edac_pci_reset_delay_period(struct edac_pci_ctl_info *pci, |
870 | unsigned long value); | |
91b99041 | 871 | |
8641a384 | 872 | extern int edac_pci_alloc_index(void); |
91b99041 | 873 | extern int edac_pci_add_device(struct edac_pci_ctl_info *pci, int edac_idx); |
079708b9 | 874 | extern struct edac_pci_ctl_info *edac_pci_del_device(struct device *dev); |
91b99041 | 875 | |
b8f6f975 DT |
876 | extern struct edac_pci_ctl_info *edac_pci_create_generic_ctl( |
877 | struct device *dev, | |
878 | const char *mod_name); | |
91b99041 DJ |
879 | |
880 | extern void edac_pci_release_generic_ctl(struct edac_pci_ctl_info *pci); | |
881 | extern int edac_pci_create_sysfs(struct edac_pci_ctl_info *pci); | |
882 | extern void edac_pci_remove_sysfs(struct edac_pci_ctl_info *pci); | |
883 | ||
884 | /* | |
885 | * edac misc APIs | |
886 | */ | |
494d0d55 | 887 | extern char *edac_op_state_to_string(int op_state); |
7c9281d7 DT |
888 | |
889 | #endif /* _EDAC_CORE_H_ */ |