2 * Intel 7300 class Memory Controllers kernel module (Clarksboro)
4 * This file may be distributed under the terms of the
5 * GNU General Public License version 2 only.
7 * Copyright (c) 2010 by:
8 * Mauro Carvalho Chehab <mchehab@redhat.com>
10 * Red Hat Inc. http://www.redhat.com
12 * Intel 7300 Chipset Memory Controller Hub (MCH) - Datasheet
13 * http://www.intel.com/Assets/PDF/datasheet/318082.pdf
15 * TODO: The chipset allow checking for PCI Express errors also. Currently,
16 * the driver covers only memory error errors
18 * This driver uses "csrows" EDAC attribute to represent DIMM slot#
21 #include <linux/module.h>
22 #include <linux/init.h>
23 #include <linux/pci.h>
24 #include <linux/pci_ids.h>
25 #include <linux/slab.h>
26 #include <linux/edac.h>
27 #include <linux/mmzone.h>
29 #include "edac_core.h"
32 * Alter this version for the I7300 module when modifications are made
34 #define I7300_REVISION " Ver: 1.0.0 " __DATE__
36 #define EDAC_MOD_STR "i7300_edac"
38 #define i7300_printk(level, fmt, arg...) \
39 edac_printk(level, "i7300", fmt, ##arg)
41 #define i7300_mc_printk(mci, level, fmt, arg...) \
42 edac_mc_chipset_printk(mci, level, "i7300", fmt, ##arg)
44 /***********************************************
45 * i7300 Limit constants Structs and static vars
46 ***********************************************/
49 * Memory topology is organized as:
50 * Branch 0 - 2 channels: channels 0 and 1 (FDB0 PCI dev 21.0)
51 * Branch 1 - 2 channels: channels 2 and 3 (FDB1 PCI dev 22.0)
52 * Each channel can have to 8 DIMM sets (called as SLOTS)
53 * Slots should generally be filled in pairs
54 * Except on Single Channel mode of operation
55 * just slot 0/channel0 filled on this mode
56 * On normal operation mode, the two channels on a branch should be
57 * filled together for the same SLOT#
58 * When in mirrored mode, Branch 1 replicate memory at Branch 0, so, the four
59 * channels on both branches should be filled
62 /* Limits for i7300 */
64 #define MAX_BRANCHES 2
65 #define MAX_CH_PER_BRANCH 2
66 #define MAX_CHANNELS (MAX_CH_PER_BRANCH * MAX_BRANCHES)
69 #define to_channel(ch, branch) ((((branch)) << 1) | (ch))
71 #define to_csrow(slot, ch, branch) \
72 (to_channel(ch, branch) | ((slot) << 2))
74 /* Device name and register DID (Device ID) */
75 struct i7300_dev_info {
76 const char *ctl_name; /* name for this device */
77 u16 fsb_mapping_errors; /* DID for the branchmap,control */
80 /* Table of devices attributes supported by this driver */
81 static const struct i7300_dev_info i7300_devs[] = {
84 .fsb_mapping_errors = PCI_DEVICE_ID_INTEL_I7300_MCH_ERR,
88 struct i7300_dimm_info {
89 int megabytes; /* size, 0 means not present */
92 /* driver private data structure */
94 struct pci_dev *pci_dev_16_0_fsb_ctlr; /* 16.0 */
95 struct pci_dev *pci_dev_16_1_fsb_addr_map; /* 16.1 */
96 struct pci_dev *pci_dev_16_2_fsb_err_regs; /* 16.2 */
97 struct pci_dev *pci_dev_2x_0_fbd_branch[MAX_BRANCHES]; /* 21.0 and 22.0 */
99 u16 tolm; /* top of low memory */
100 u64 ambase; /* AMB BAR */
102 u32 mc_settings; /* Report several settings */
105 u16 mir[MAX_MIR]; /* Memory Interleave Reg*/
107 u16 mtr[MAX_SLOTS][MAX_BRANCHES]; /* Memory Technlogy Reg */
108 u16 ambpresent[MAX_CHANNELS]; /* AMB present regs */
110 /* DIMM information matrix, allocating architecture maximums */
111 struct i7300_dimm_info dimm_info[MAX_SLOTS][MAX_CHANNELS];
113 /* Temporary buffer for use when preparing error messages */
114 char *tmp_prt_buffer;
117 /* FIXME: Why do we need to have this static? */
118 static struct edac_pci_ctl_info *i7300_pci;
120 /***************************************************
121 * i7300 Register definitions for memory enumeration
122 ***************************************************/
126 * Function 0: System Address (not documented)
127 * Function 1: Memory Branch Map, Control, Errors Register
130 /* OFFSETS for Function 0 */
131 #define AMBASE 0x48 /* AMB Mem Mapped Reg Region Base */
132 #define MAXCH 0x56 /* Max Channel Number */
133 #define MAXDIMMPERCH 0x57 /* Max DIMM PER Channel Number */
135 /* OFFSETS for Function 1 */
136 #define MC_SETTINGS 0x40
137 #define IS_MIRRORED(mc) ((mc) & (1 << 16))
138 #define IS_ECC_ENABLED(mc) ((mc) & (1 << 5))
139 #define IS_RETRY_ENABLED(mc) ((mc) & (1 << 31))
140 #define IS_SCRBALGO_ENHANCED(mc) ((mc) & (1 << 8))
142 #define MC_SETTINGS_A 0x58
143 #define IS_SINGLE_MODE(mca) ((mca) & (1 << 14))
152 * Note: Other Intel EDAC drivers use AMBPRESENT to identify if the available
153 * memory. From datasheet item 7.3.1 (FB-DIMM technology & organization), it
154 * seems that we cannot use this information directly for the same usage.
155 * Each memory slot may have up to 2 AMB interfaces, one for income and another
156 * for outcome interface to the next slot.
157 * For now, the driver just stores the AMB present registers, but rely only at
158 * the MTR info to detect memory.
159 * Datasheet is also not clear about how to map each AMBPRESENT registers to
160 * one of the 4 available channels.
162 #define AMBPRESENT_0 0x64
163 #define AMBPRESENT_1 0x66
165 const static u16 mtr_regs[MAX_SLOTS] = {
166 0x80, 0x84, 0x88, 0x8c,
167 0x82, 0x86, 0x8a, 0x8e
171 * Defines to extract the vaious fields from the
172 * MTRx - Memory Technology Registers
174 #define MTR_DIMMS_PRESENT(mtr) ((mtr) & (1 << 8))
175 #define MTR_DIMMS_ETHROTTLE(mtr) ((mtr) & (1 << 7))
176 #define MTR_DRAM_WIDTH(mtr) (((mtr) & (1 << 6)) ? 8 : 4)
177 #define MTR_DRAM_BANKS(mtr) (((mtr) & (1 << 5)) ? 8 : 4)
178 #define MTR_DIMM_RANKS(mtr) (((mtr) & (1 << 4)) ? 1 : 0)
179 #define MTR_DIMM_ROWS(mtr) (((mtr) >> 2) & 0x3)
180 #define MTR_DRAM_BANKS_ADDR_BITS 2
181 #define MTR_DIMM_ROWS_ADDR_BITS(mtr) (MTR_DIMM_ROWS(mtr) + 13)
182 #define MTR_DIMM_COLS(mtr) ((mtr) & 0x3)
183 #define MTR_DIMM_COLS_ADDR_BITS(mtr) (MTR_DIMM_COLS(mtr) + 10)
185 #ifdef CONFIG_EDAC_DEBUG
187 static const char *numrow_toString[] = {
195 static const char *numcol_toString[] = {
196 "1,024 - 10 columns",
197 "2,048 - 11 columns",
198 "4,096 - 12 columns",
203 /************************************************
204 * i7300 Register definitions for error detection
205 ************************************************/
208 * Device 16.1: FBD Error Registers
210 #define FERR_FAT_FBD 0x98
211 static const char *ferr_fat_fbd_name[] = {
212 [22] = "Non-Redundant Fast Reset Timeout",
213 [2] = ">Tmid Thermal event with intelligent throttling disabled",
214 [1] = "Memory or FBD configuration CRC read error",
215 [0] = "Memory Write error on non-redundant retry or "
216 "FBD configuration Write error on retry",
218 #define GET_FBD_FAT_IDX(fbderr) (fbderr & (3 << 28))
219 #define FERR_FAT_FBD_ERR_MASK ((1 << 0) | (1 << 1) | (1 << 2) | (1 << 3))
221 #define FERR_NF_FBD 0xa0
222 static const char *ferr_nf_fbd_name[] = {
223 [24] = "DIMM-Spare Copy Completed",
224 [23] = "DIMM-Spare Copy Initiated",
225 [22] = "Redundant Fast Reset Timeout",
226 [21] = "Memory Write error on redundant retry",
227 [18] = "SPD protocol Error",
228 [17] = "FBD Northbound parity error on FBD Sync Status",
229 [16] = "Correctable Patrol Data ECC",
230 [15] = "Correctable Resilver- or Spare-Copy Data ECC",
231 [14] = "Correctable Mirrored Demand Data ECC",
232 [13] = "Correctable Non-Mirrored Demand Data ECC",
233 [11] = "Memory or FBD configuration CRC read error",
234 [10] = "FBD Configuration Write error on first attempt",
235 [9] = "Memory Write error on first attempt",
236 [8] = "Non-Aliased Uncorrectable Patrol Data ECC",
237 [7] = "Non-Aliased Uncorrectable Resilver- or Spare-Copy Data ECC",
238 [6] = "Non-Aliased Uncorrectable Mirrored Demand Data ECC",
239 [5] = "Non-Aliased Uncorrectable Non-Mirrored Demand Data ECC",
240 [4] = "Aliased Uncorrectable Patrol Data ECC",
241 [3] = "Aliased Uncorrectable Resilver- or Spare-Copy Data ECC",
242 [2] = "Aliased Uncorrectable Mirrored Demand Data ECC",
243 [1] = "Aliased Uncorrectable Non-Mirrored Demand Data ECC",
244 [0] = "Uncorrectable Data ECC on Replay",
246 #define GET_FBD_NF_IDX(fbderr) (fbderr & (3 << 28))
247 #define FERR_NF_FBD_ERR_MASK ((1 << 24) | (1 << 23) | (1 << 22) | (1 << 21) |\
248 (1 << 18) | (1 << 17) | (1 << 16) | (1 << 15) |\
249 (1 << 14) | (1 << 13) | (1 << 11) | (1 << 10) |\
250 (1 << 9) | (1 << 8) | (1 << 7) | (1 << 6) |\
251 (1 << 5) | (1 << 4) | (1 << 3) | (1 << 2) |\
254 #define EMASK_FBD 0xa8
255 #define EMASK_FBD_ERR_MASK ((1 << 27) | (1 << 26) | (1 << 25) | (1 << 24) |\
256 (1 << 22) | (1 << 21) | (1 << 20) | (1 << 19) |\
257 (1 << 18) | (1 << 17) | (1 << 16) | (1 << 14) |\
258 (1 << 13) | (1 << 12) | (1 << 11) | (1 << 10) |\
259 (1 << 9) | (1 << 8) | (1 << 7) | (1 << 6) |\
260 (1 << 5) | (1 << 4) | (1 << 3) | (1 << 2) |\
264 * Device 16.2: Global Error Registers
267 #define FERR_GLOBAL_HI 0x48
268 static const char *ferr_global_hi_name[] = {
269 [3] = "FSB 3 Fatal Error",
270 [2] = "FSB 2 Fatal Error",
271 [1] = "FSB 1 Fatal Error",
272 [0] = "FSB 0 Fatal Error",
274 #define ferr_global_hi_is_fatal(errno) 1
276 #define FERR_GLOBAL_LO 0x40
277 static const char *ferr_global_lo_name[] = {
278 [31] = "Internal MCH Fatal Error",
279 [30] = "Intel QuickData Technology Device Fatal Error",
280 [29] = "FSB1 Fatal Error",
281 [28] = "FSB0 Fatal Error",
282 [27] = "FBD Channel 3 Fatal Error",
283 [26] = "FBD Channel 2 Fatal Error",
284 [25] = "FBD Channel 1 Fatal Error",
285 [24] = "FBD Channel 0 Fatal Error",
286 [23] = "PCI Express Device 7Fatal Error",
287 [22] = "PCI Express Device 6 Fatal Error",
288 [21] = "PCI Express Device 5 Fatal Error",
289 [20] = "PCI Express Device 4 Fatal Error",
290 [19] = "PCI Express Device 3 Fatal Error",
291 [18] = "PCI Express Device 2 Fatal Error",
292 [17] = "PCI Express Device 1 Fatal Error",
293 [16] = "ESI Fatal Error",
294 [15] = "Internal MCH Non-Fatal Error",
295 [14] = "Intel QuickData Technology Device Non Fatal Error",
296 [13] = "FSB1 Non-Fatal Error",
297 [12] = "FSB 0 Non-Fatal Error",
298 [11] = "FBD Channel 3 Non-Fatal Error",
299 [10] = "FBD Channel 2 Non-Fatal Error",
300 [9] = "FBD Channel 1 Non-Fatal Error",
301 [8] = "FBD Channel 0 Non-Fatal Error",
302 [7] = "PCI Express Device 7 Non-Fatal Error",
303 [6] = "PCI Express Device 6 Non-Fatal Error",
304 [5] = "PCI Express Device 5 Non-Fatal Error",
305 [4] = "PCI Express Device 4 Non-Fatal Error",
306 [3] = "PCI Express Device 3 Non-Fatal Error",
307 [2] = "PCI Express Device 2 Non-Fatal Error",
308 [1] = "PCI Express Device 1 Non-Fatal Error",
309 [0] = "ESI Non-Fatal Error",
311 #define ferr_global_lo_is_fatal(errno) ((errno < 16) ? 0 : 1)
313 #define NRECMEMA 0xbe
314 #define NRECMEMA_BANK(v) (((v) >> 12) & 7)
315 #define NRECMEMA_RANK(v) (((v) >> 8) & 15)
317 #define NRECMEMB 0xc0
318 #define NRECMEMB_IS_WR(v) ((v) & (1 << 31))
319 #define NRECMEMB_CAS(v) (((v) >> 16) & 0x1fff)
320 #define NRECMEMB_RAS(v) ((v) & 0xffff)
325 #define IS_SECOND_CH(v) ((v) * (1 << 17))
328 #define RECMEMA_BANK(v) (((v) >> 12) & 7)
329 #define RECMEMA_RANK(v) (((v) >> 8) & 15)
332 #define RECMEMB_IS_WR(v) ((v) & (1 << 31))
333 #define RECMEMB_CAS(v) (((v) >> 16) & 0x1fff)
334 #define RECMEMB_RAS(v) ((v) & 0xffff)
336 /********************************************
337 * i7300 Functions related to error detection
338 ********************************************/
341 * get_err_from_table() - Gets the error message from a table
342 * @table: table name (array of char *)
343 * @size: number of elements at the table
344 * @pos: position of the element to be returned
346 * This is a small routine that gets the pos-th element of a table. If the
347 * element doesn't exist (or it is empty), it returns "reserved".
348 * Instead of calling it directly, the better is to call via the macro
349 * GET_ERR_FROM_TABLE(), that automatically checks the table size via
352 static const char *get_err_from_table(const char *table[], int size, int pos)
354 if (unlikely(pos >= size))
357 if (unlikely(!table[pos]))
363 #define GET_ERR_FROM_TABLE(table, pos) \
364 get_err_from_table(table, ARRAY_SIZE(table), pos)
367 * i7300_process_error_global() - Retrieve the hardware error information from
368 * the hardware global error registers and
370 * @mci: struct mem_ctl_info pointer
372 static void i7300_process_error_global(struct mem_ctl_info *mci)
374 struct i7300_pvt *pvt;
376 unsigned long errors;
377 const char *specific;
382 /* read in the 1st FATAL error register */
383 pci_read_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
384 FERR_GLOBAL_HI, &value);
385 if (unlikely(value)) {
387 errnum = find_first_bit(&errors,
388 ARRAY_SIZE(ferr_global_hi_name));
389 specific = GET_ERR_FROM_TABLE(ferr_global_hi_name, errnum);
390 is_fatal = ferr_global_hi_is_fatal(errnum);
392 /* Clear the error bit */
393 pci_write_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
394 FERR_GLOBAL_HI, value);
399 pci_read_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
400 FERR_GLOBAL_LO, &value);
401 if (unlikely(value)) {
403 errnum = find_first_bit(&errors,
404 ARRAY_SIZE(ferr_global_lo_name));
405 specific = GET_ERR_FROM_TABLE(ferr_global_lo_name, errnum);
406 is_fatal = ferr_global_lo_is_fatal(errnum);
408 /* Clear the error bit */
409 pci_write_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
410 FERR_GLOBAL_LO, value);
417 i7300_mc_printk(mci, KERN_EMERG, "%s misc error: %s\n",
418 is_fatal ? "Fatal" : "NOT fatal", specific);
422 * i7300_process_fbd_error() - Retrieve the hardware error information from
423 * the FBD error registers and sends it via
424 * EDAC error API calls
425 * @mci: struct mem_ctl_info pointer
427 static void i7300_process_fbd_error(struct mem_ctl_info *mci)
429 struct i7300_pvt *pvt;
432 unsigned branch, channel, bank, rank, cas, ras;
435 unsigned long errors;
436 const char *specific;
441 /* read in the 1st FATAL error register */
442 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
443 FERR_FAT_FBD, &value);
444 if (unlikely(value & FERR_FAT_FBD_ERR_MASK)) {
445 errors = value & FERR_FAT_FBD_ERR_MASK ;
446 errnum = find_first_bit(&errors,
447 ARRAY_SIZE(ferr_fat_fbd_name));
448 specific = GET_ERR_FROM_TABLE(ferr_fat_fbd_name, errnum);
450 branch = (GET_FBD_FAT_IDX(value) == 2) ? 1 : 0;
451 pci_read_config_word(pvt->pci_dev_16_1_fsb_addr_map,
453 bank = NRECMEMA_BANK(val16);
454 rank = NRECMEMA_RANK(val16);
456 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
459 is_wr = NRECMEMB_IS_WR(value);
460 cas = NRECMEMB_CAS(value);
461 ras = NRECMEMB_RAS(value);
463 snprintf(pvt->tmp_prt_buffer, PAGE_SIZE,
464 "FATAL (Branch=%d DRAM-Bank=%d %s "
465 "RAS=%d CAS=%d Err=0x%lx (%s))",
467 is_wr ? "RDWR" : "RD",
471 /* Call the helper to output message */
472 edac_mc_handle_fbd_ue(mci, rank, branch << 1,
474 pvt->tmp_prt_buffer);
477 /* read in the 1st NON-FATAL error register */
478 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
479 FERR_NF_FBD, &value);
480 if (unlikely(value & FERR_NF_FBD_ERR_MASK)) {
481 errors = value & FERR_NF_FBD_ERR_MASK;
482 errnum = find_first_bit(&errors,
483 ARRAY_SIZE(ferr_nf_fbd_name));
484 specific = GET_ERR_FROM_TABLE(ferr_nf_fbd_name, errnum);
486 /* Clear the error bit */
487 pci_write_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
488 FERR_GLOBAL_LO, value);
490 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
493 branch = (GET_FBD_FAT_IDX(value) == 2) ? 1 : 0;
494 pci_read_config_word(pvt->pci_dev_16_1_fsb_addr_map,
496 bank = RECMEMA_BANK(val16);
497 rank = RECMEMA_RANK(val16);
499 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
502 is_wr = RECMEMB_IS_WR(value);
503 cas = RECMEMB_CAS(value);
504 ras = RECMEMB_RAS(value);
506 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
509 channel = (branch << 1);
510 if (IS_SECOND_CH(value))
513 /* Form out message */
514 snprintf(pvt->tmp_prt_buffer, PAGE_SIZE,
515 "Corrected error (Branch=%d, Channel %d), "
517 "RAS=%d CAS=%d, CE Err=0x%lx, Syndrome=0x%08x(%s))",
520 is_wr ? "RDWR" : "RD",
522 errors, syndrome, specific);
525 * Call the helper to output message
526 * NOTE: Errors are reported per-branch, and not per-channel
527 * Currently, we don't know how to identify the right
530 edac_mc_handle_fbd_ce(mci, rank, channel,
531 pvt->tmp_prt_buffer);
537 * i7300_check_error() - Calls the error checking subroutines
538 * @mci: struct mem_ctl_info pointer
540 static void i7300_check_error(struct mem_ctl_info *mci)
542 i7300_process_error_global(mci);
543 i7300_process_fbd_error(mci);
547 * i7300_clear_error() - Clears the error registers
548 * @mci: struct mem_ctl_info pointer
550 static void i7300_clear_error(struct mem_ctl_info *mci)
552 struct i7300_pvt *pvt = mci->pvt_info;
555 * All error values are RWC - we need to read and write 1 to the
556 * bit that we want to cleanup
559 /* Clear global error registers */
560 pci_read_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
561 FERR_GLOBAL_HI, &value);
562 pci_write_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
563 FERR_GLOBAL_HI, value);
565 pci_read_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
566 FERR_GLOBAL_LO, &value);
567 pci_write_config_dword(pvt->pci_dev_16_2_fsb_err_regs,
568 FERR_GLOBAL_LO, value);
570 /* Clear FBD error registers */
571 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
572 FERR_FAT_FBD, &value);
573 pci_write_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
574 FERR_FAT_FBD, value);
576 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
577 FERR_NF_FBD, &value);
578 pci_write_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
583 * i7300_enable_error_reporting() - Enable the memory reporting logic at the
585 * @mci: struct mem_ctl_info pointer
587 static void i7300_enable_error_reporting(struct mem_ctl_info *mci)
589 struct i7300_pvt *pvt = mci->pvt_info;
592 /* Read the FBD Error Mask Register */
593 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
594 EMASK_FBD, &fbd_error_mask);
596 /* Enable with a '0' */
597 fbd_error_mask &= ~(EMASK_FBD_ERR_MASK);
599 pci_write_config_dword(pvt->pci_dev_16_1_fsb_addr_map,
600 EMASK_FBD, fbd_error_mask);
603 /************************************************
604 * i7300 Functions related to memory enumberation
605 ************************************************/
608 * decode_mtr() - Decodes the MTR descriptor, filling the edac structs
609 * @pvt: pointer to the private data struct used by i7300 driver
610 * @slot: DIMM slot (0 to 7)
611 * @ch: Channel number within the branch (0 or 1)
612 * @branch: Branch number (0 or 1)
613 * @dinfo: Pointer to DIMM info where dimm size is stored
614 * @p_csrow: Pointer to the struct csrow_info that corresponds to that element
616 static int decode_mtr(struct i7300_pvt *pvt,
617 int slot, int ch, int branch,
618 struct i7300_dimm_info *dinfo,
619 struct csrow_info *p_csrow,
622 int mtr, ans, addrBits, channel;
624 channel = to_channel(ch, branch);
626 mtr = pvt->mtr[slot][branch];
627 ans = MTR_DIMMS_PRESENT(mtr) ? 1 : 0;
629 debugf2("\tMTR%d CH%d: DIMMs are %s (mtr)\n",
631 ans ? "Present" : "NOT Present");
633 /* Determine if there is a DIMM present in this DIMM slot */
637 /* Start with the number of bits for a Bank
639 addrBits = MTR_DRAM_BANKS_ADDR_BITS;
640 /* Add thenumber of ROW bits */
641 addrBits += MTR_DIMM_ROWS_ADDR_BITS(mtr);
642 /* add the number of COLUMN bits */
643 addrBits += MTR_DIMM_COLS_ADDR_BITS(mtr);
644 /* add the number of RANK bits */
645 addrBits += MTR_DIMM_RANKS(mtr);
647 addrBits += 6; /* add 64 bits per DIMM */
648 addrBits -= 20; /* divide by 2^^20 */
649 addrBits -= 3; /* 8 bits per bytes */
651 dinfo->megabytes = 1 << addrBits;
653 debugf2("\t\tWIDTH: x%d\n", MTR_DRAM_WIDTH(mtr));
655 debugf2("\t\tELECTRICAL THROTTLING is %s\n",
656 MTR_DIMMS_ETHROTTLE(mtr) ? "enabled" : "disabled");
658 debugf2("\t\tNUMBANK: %d bank(s)\n", MTR_DRAM_BANKS(mtr));
659 debugf2("\t\tNUMRANK: %s\n", MTR_DIMM_RANKS(mtr) ? "double" : "single");
660 debugf2("\t\tNUMROW: %s\n", numrow_toString[MTR_DIMM_ROWS(mtr)]);
661 debugf2("\t\tNUMCOL: %s\n", numcol_toString[MTR_DIMM_COLS(mtr)]);
662 debugf2("\t\tSIZE: %d MB\n", dinfo->megabytes);
665 p_csrow->nr_pages = dinfo->megabytes << 8;
666 p_csrow->mtype = MEM_FB_DDR2;
667 p_csrow->csrow_idx = slot;
668 p_csrow->first_page = *last_page;
669 *last_page += p_csrow->nr_pages;
670 p_csrow->last_page = *last_page;
671 p_csrow->page_mask = 0;
674 * The type of error detection actually depends of the
675 * mode of operation. When it is just one single memory chip, at
676 * socket 0, channel 0, it uses 8-byte-over-32-byte SECDED+ code.
677 * In normal or mirrored mode, it uses Lockstep mode,
678 * with the possibility of using an extended algorithm for x8 memories
679 * See datasheet Sections 7.3.6 to 7.3.8
682 if (IS_SINGLE_MODE(pvt->mc_settings_a)) {
683 p_csrow->edac_mode = EDAC_SECDED;
684 debugf2("\t\tECC code is 8-byte-over-32-byte SECDED+ code\n");
686 debugf2("\t\tECC code is on Lockstep mode\n");
687 if (MTR_DRAM_WIDTH(mtr) == 8)
688 p_csrow->edac_mode = EDAC_S8ECD8ED;
690 p_csrow->edac_mode = EDAC_S4ECD4ED;
693 /* ask what device type on this row */
694 if (MTR_DRAM_WIDTH(mtr) == 8) {
695 debugf2("\t\tScrub algorithm for x8 is on %s mode\n",
696 IS_SCRBALGO_ENHANCED(pvt->mc_settings) ?
697 "enhanced" : "normal");
699 p_csrow->dtype = DEV_X8;
701 p_csrow->dtype = DEV_X4;
707 * print_dimm_size() - Prints dump of the memory organization
708 * @pvt: pointer to the private data struct used by i7300 driver
710 * Useful for debug. If debug is disabled, this routine do nothing
712 static void print_dimm_size(struct i7300_pvt *pvt)
714 #ifdef CONFIG_EDAC_DEBUG
715 struct i7300_dimm_info *dinfo;
721 p = pvt->tmp_prt_buffer;
723 n = snprintf(p, space, " ");
726 for (channel = 0; channel < MAX_CHANNELS; channel++) {
727 n = snprintf(p, space, "channel %d | ", channel);
731 debugf2("%s\n", pvt->tmp_prt_buffer);
732 p = pvt->tmp_prt_buffer;
734 n = snprintf(p, space, "-------------------------------"
735 "------------------------------");
738 debugf2("%s\n", pvt->tmp_prt_buffer);
739 p = pvt->tmp_prt_buffer;
742 for (slot = 0; slot < MAX_SLOTS; slot++) {
743 n = snprintf(p, space, "csrow/SLOT %d ", slot);
747 for (channel = 0; channel < MAX_CHANNELS; channel++) {
748 dinfo = &pvt->dimm_info[slot][channel];
749 n = snprintf(p, space, "%4d MB | ", dinfo->megabytes);
754 debugf2("%s\n", pvt->tmp_prt_buffer);
755 p = pvt->tmp_prt_buffer;
759 n = snprintf(p, space, "-------------------------------"
760 "------------------------------");
763 debugf2("%s\n", pvt->tmp_prt_buffer);
764 p = pvt->tmp_prt_buffer;
770 * i7300_init_csrows() - Initialize the 'csrows' table within
771 * the mci control structure with the
772 * addressing of memory.
773 * @mci: struct mem_ctl_info pointer
775 static int i7300_init_csrows(struct mem_ctl_info *mci)
777 struct i7300_pvt *pvt;
778 struct i7300_dimm_info *dinfo;
779 struct csrow_info *p_csrow;
782 int ch, branch, slot, channel;
787 debugf2("Memory Technology Registers:\n");
789 /* Get the AMB present registers for the four channels */
790 for (branch = 0; branch < MAX_BRANCHES; branch++) {
791 /* Read and dump branch 0's MTRs */
792 channel = to_channel(0, branch);
793 pci_read_config_word(pvt->pci_dev_2x_0_fbd_branch[branch],
795 &pvt->ambpresent[channel]);
796 debugf2("\t\tAMB-present CH%d = 0x%x:\n",
797 channel, pvt->ambpresent[channel]);
799 channel = to_channel(1, branch);
800 pci_read_config_word(pvt->pci_dev_2x_0_fbd_branch[branch],
802 &pvt->ambpresent[channel]);
803 debugf2("\t\tAMB-present CH%d = 0x%x:\n",
804 channel, pvt->ambpresent[channel]);
807 /* Get the set of MTR[0-7] regs by each branch */
808 for (slot = 0; slot < MAX_SLOTS; slot++) {
809 int where = mtr_regs[slot];
810 for (branch = 0; branch < MAX_BRANCHES; branch++) {
811 pci_read_config_word(pvt->pci_dev_2x_0_fbd_branch[branch],
813 &pvt->mtr[slot][branch]);
814 for (ch = 0; ch < MAX_BRANCHES; ch++) {
815 int channel = to_channel(ch, branch);
817 dinfo = &pvt->dimm_info[slot][channel];
818 p_csrow = &mci->csrows[slot];
820 mtr = decode_mtr(pvt, slot, ch, branch,
821 dinfo, p_csrow, &last_page);
822 /* if no DIMMS on this row, continue */
823 if (!MTR_DIMMS_PRESENT(mtr))
835 * decode_mir() - Decodes Memory Interleave Register (MIR) info
836 * @int mir_no: number of the MIR register to decode
837 * @mir: array with the MIR data cached on the driver
839 static void decode_mir(int mir_no, u16 mir[MAX_MIR])
842 debugf2("MIR%d: limit= 0x%x Branch(es) that participate:"
845 (mir[mir_no] >> 4) & 0xfff,
846 (mir[mir_no] & 1) ? "B0" : "",
847 (mir[mir_no] & 2) ? "B1" : "");
851 * i7300_get_mc_regs() - Get the contents of the MC enumeration registers
852 * @mci: struct mem_ctl_info pointer
854 * Data read is cached internally for its usage when needed
856 static int i7300_get_mc_regs(struct mem_ctl_info *mci)
858 struct i7300_pvt *pvt;
864 pci_read_config_dword(pvt->pci_dev_16_0_fsb_ctlr, AMBASE,
865 (u32 *) &pvt->ambase);
867 debugf2("AMBASE= 0x%lx\n", (long unsigned int)pvt->ambase);
869 /* Get the Branch Map regs */
870 pci_read_config_word(pvt->pci_dev_16_1_fsb_addr_map, TOLM, &pvt->tolm);
872 debugf2("TOLM (number of 256M regions) =%u (0x%x)\n", pvt->tolm,
875 actual_tolm = (u32) ((1000l * pvt->tolm) >> (30 - 28));
876 debugf2("Actual TOLM byte addr=%u.%03u GB (0x%x)\n",
877 actual_tolm/1000, actual_tolm % 1000, pvt->tolm << 28);
879 /* Get memory controller settings */
880 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map, MC_SETTINGS,
882 pci_read_config_dword(pvt->pci_dev_16_1_fsb_addr_map, MC_SETTINGS_A,
883 &pvt->mc_settings_a);
885 if (IS_SINGLE_MODE(pvt->mc_settings_a))
886 debugf0("Memory controller operating on single mode\n");
888 debugf0("Memory controller operating on %s mode\n",
889 IS_MIRRORED(pvt->mc_settings) ? "mirrored" : "non-mirrored");
891 debugf0("Error detection is %s\n",
892 IS_ECC_ENABLED(pvt->mc_settings) ? "enabled" : "disabled");
893 debugf0("Retry is %s\n",
894 IS_RETRY_ENABLED(pvt->mc_settings) ? "enabled" : "disabled");
896 /* Get Memory Interleave Range registers */
897 pci_read_config_word(pvt->pci_dev_16_1_fsb_addr_map, MIR0,
899 pci_read_config_word(pvt->pci_dev_16_1_fsb_addr_map, MIR1,
901 pci_read_config_word(pvt->pci_dev_16_1_fsb_addr_map, MIR2,
904 /* Decode the MIR regs */
905 for (i = 0; i < MAX_MIR; i++)
906 decode_mir(i, pvt->mir);
908 rc = i7300_init_csrows(mci);
912 /* Go and determine the size of each DIMM and place in an
914 print_dimm_size(pvt);
919 /*************************************************
920 * i7300 Functions related to device probe/release
921 *************************************************/
924 * i7300_put_devices() - Release the PCI devices
925 * @mci: struct mem_ctl_info pointer
927 static void i7300_put_devices(struct mem_ctl_info *mci)
929 struct i7300_pvt *pvt;
934 /* Decrement usage count for devices */
935 for (branch = 0; branch < MAX_CH_PER_BRANCH; branch++)
936 pci_dev_put(pvt->pci_dev_2x_0_fbd_branch[branch]);
937 pci_dev_put(pvt->pci_dev_16_2_fsb_err_regs);
938 pci_dev_put(pvt->pci_dev_16_1_fsb_addr_map);
942 * i7300_get_devices() - Find and perform 'get' operation on the MCH's
943 * device/functions we want to reference for this driver
944 * @mci: struct mem_ctl_info pointer
946 * Access and prepare the several devices for usage:
947 * I7300 devices used by this driver:
948 * Device 16, functions 0,1 and 2: PCI_DEVICE_ID_INTEL_I7300_MCH_ERR
949 * Device 21 function 0: PCI_DEVICE_ID_INTEL_I7300_MCH_FB0
950 * Device 22 function 0: PCI_DEVICE_ID_INTEL_I7300_MCH_FB1
952 static int __devinit i7300_get_devices(struct mem_ctl_info *mci)
954 struct i7300_pvt *pvt;
955 struct pci_dev *pdev;
959 /* Attempt to 'get' the MCH register we want */
961 while (!pvt->pci_dev_16_1_fsb_addr_map ||
962 !pvt->pci_dev_16_2_fsb_err_regs) {
963 pdev = pci_get_device(PCI_VENDOR_ID_INTEL,
964 PCI_DEVICE_ID_INTEL_I7300_MCH_ERR, pdev);
966 /* End of list, leave */
967 i7300_printk(KERN_ERR,
968 "'system address,Process Bus' "
970 "vendor 0x%x device 0x%x ERR funcs "
973 PCI_DEVICE_ID_INTEL_I7300_MCH_ERR);
977 /* Store device 16 funcs 1 and 2 */
978 switch (PCI_FUNC(pdev->devfn)) {
980 pvt->pci_dev_16_1_fsb_addr_map = pdev;
983 pvt->pci_dev_16_2_fsb_err_regs = pdev;
988 debugf1("System Address, processor bus- PCI Bus ID: %s %x:%x\n",
989 pci_name(pvt->pci_dev_16_0_fsb_ctlr),
990 pvt->pci_dev_16_0_fsb_ctlr->vendor,
991 pvt->pci_dev_16_0_fsb_ctlr->device);
992 debugf1("Branchmap, control and errors - PCI Bus ID: %s %x:%x\n",
993 pci_name(pvt->pci_dev_16_1_fsb_addr_map),
994 pvt->pci_dev_16_1_fsb_addr_map->vendor,
995 pvt->pci_dev_16_1_fsb_addr_map->device);
996 debugf1("FSB Error Regs - PCI Bus ID: %s %x:%x\n",
997 pci_name(pvt->pci_dev_16_2_fsb_err_regs),
998 pvt->pci_dev_16_2_fsb_err_regs->vendor,
999 pvt->pci_dev_16_2_fsb_err_regs->device);
1001 pvt->pci_dev_2x_0_fbd_branch[0] = pci_get_device(PCI_VENDOR_ID_INTEL,
1002 PCI_DEVICE_ID_INTEL_I7300_MCH_FB0,
1004 if (!pvt->pci_dev_2x_0_fbd_branch[0]) {
1005 i7300_printk(KERN_ERR,
1006 "MC: 'BRANCH 0' device not found:"
1007 "vendor 0x%x device 0x%x Func 0 (broken BIOS?)\n",
1008 PCI_VENDOR_ID_INTEL, PCI_DEVICE_ID_INTEL_I7300_MCH_FB0);
1012 pvt->pci_dev_2x_0_fbd_branch[1] = pci_get_device(PCI_VENDOR_ID_INTEL,
1013 PCI_DEVICE_ID_INTEL_I7300_MCH_FB1,
1015 if (!pvt->pci_dev_2x_0_fbd_branch[1]) {
1016 i7300_printk(KERN_ERR,
1017 "MC: 'BRANCH 1' device not found:"
1018 "vendor 0x%x device 0x%x Func 0 "
1020 PCI_VENDOR_ID_INTEL,
1021 PCI_DEVICE_ID_INTEL_I7300_MCH_FB1);
1028 i7300_put_devices(mci);
1033 * i7300_init_one() - Probe for one instance of the device
1034 * @pdev: struct pci_dev pointer
1035 * @id: struct pci_device_id pointer - currently unused
1037 static int __devinit i7300_init_one(struct pci_dev *pdev,
1038 const struct pci_device_id *id)
1040 struct mem_ctl_info *mci;
1041 struct i7300_pvt *pvt;
1043 int num_dimms_per_channel;
1047 /* wake up device */
1048 rc = pci_enable_device(pdev);
1052 debugf0("MC: " __FILE__ ": %s(), pdev bus %u dev=0x%x fn=0x%x\n",
1055 PCI_SLOT(pdev->devfn), PCI_FUNC(pdev->devfn));
1057 /* We only are looking for func 0 of the set */
1058 if (PCI_FUNC(pdev->devfn) != 0)
1061 /* As we don't have a motherboard identification routine to determine
1062 * actual number of slots/dimms per channel, we thus utilize the
1063 * resource as specified by the chipset. Thus, we might have
1064 * have more DIMMs per channel than actually on the mobo, but this
1065 * allows the driver to support upto the chipset max, without
1066 * some fancy mobo determination.
1068 num_dimms_per_channel = MAX_SLOTS;
1069 num_channels = MAX_CHANNELS;
1070 num_csrows = MAX_SLOTS * MAX_CHANNELS;
1072 debugf0("MC: %s(): Number of - Channels= %d DIMMS= %d CSROWS= %d\n",
1073 __func__, num_channels, num_dimms_per_channel, num_csrows);
1075 /* allocate a new MC control structure */
1076 mci = edac_mc_alloc(sizeof(*pvt), num_csrows, num_channels, 0);
1081 debugf0("MC: " __FILE__ ": %s(): mci = %p\n", __func__, mci);
1083 mci->dev = &pdev->dev; /* record ptr to the generic device */
1085 pvt = mci->pvt_info;
1086 pvt->pci_dev_16_0_fsb_ctlr = pdev; /* Record this device in our private */
1088 pvt->tmp_prt_buffer = kmalloc(PAGE_SIZE, GFP_KERNEL);
1089 if (!pvt->tmp_prt_buffer) {
1094 /* 'get' the pci devices we want to reserve for our use */
1095 if (i7300_get_devices(mci))
1099 mci->mtype_cap = MEM_FLAG_FB_DDR2;
1100 mci->edac_ctl_cap = EDAC_FLAG_NONE;
1101 mci->edac_cap = EDAC_FLAG_NONE;
1102 mci->mod_name = "i7300_edac.c";
1103 mci->mod_ver = I7300_REVISION;
1104 mci->ctl_name = i7300_devs[0].ctl_name;
1105 mci->dev_name = pci_name(pdev);
1106 mci->ctl_page_to_phys = NULL;
1108 /* Set the function pointer to an actual operation function */
1109 mci->edac_check = i7300_check_error;
1111 /* initialize the MC control structure 'csrows' table
1112 * with the mapping and control information */
1113 if (i7300_get_mc_regs(mci)) {
1114 debugf0("MC: Setting mci->edac_cap to EDAC_FLAG_NONE\n"
1115 " because i7300_init_csrows() returned nonzero "
1117 mci->edac_cap = EDAC_FLAG_NONE; /* no csrows found */
1119 debugf1("MC: Enable error reporting now\n");
1120 i7300_enable_error_reporting(mci);
1123 /* add this new MC control structure to EDAC's list of MCs */
1124 if (edac_mc_add_mc(mci)) {
1125 debugf0("MC: " __FILE__
1126 ": %s(): failed edac_mc_add_mc()\n", __func__);
1127 /* FIXME: perhaps some code should go here that disables error
1128 * reporting if we just enabled it
1133 i7300_clear_error(mci);
1135 /* allocating generic PCI control info */
1136 i7300_pci = edac_pci_create_generic_ctl(&pdev->dev, EDAC_MOD_STR);
1139 "%s(): Unable to create PCI control\n",
1142 "%s(): PCI error report via EDAC not setup\n",
1148 /* Error exit unwinding stack */
1151 i7300_put_devices(mci);
1154 kfree(pvt->tmp_prt_buffer);
1160 * i7300_remove_one() - Remove the driver
1161 * @pdev: struct pci_dev pointer
1163 static void __devexit i7300_remove_one(struct pci_dev *pdev)
1165 struct mem_ctl_info *mci;
1168 debugf0(__FILE__ ": %s()\n", __func__);
1171 edac_pci_release_generic_ctl(i7300_pci);
1173 mci = edac_mc_del_mc(&pdev->dev);
1177 tmp = ((struct i7300_pvt *)mci->pvt_info)->tmp_prt_buffer;
1179 /* retrieve references to resources, and free those resources */
1180 i7300_put_devices(mci);
1187 * pci_device_id: table for which devices we are looking for
1189 * Has only 8086:360c PCI ID
1191 static const struct pci_device_id i7300_pci_tbl[] __devinitdata = {
1192 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, PCI_DEVICE_ID_INTEL_I7300_MCH_ERR)},
1193 {0,} /* 0 terminated list. */
1196 MODULE_DEVICE_TABLE(pci, i7300_pci_tbl);
1199 * i7300_driver: pci_driver structure for this module
1201 static struct pci_driver i7300_driver = {
1202 .name = "i7300_edac",
1203 .probe = i7300_init_one,
1204 .remove = __devexit_p(i7300_remove_one),
1205 .id_table = i7300_pci_tbl,
1209 * i7300_init() - Registers the driver
1211 static int __init i7300_init(void)
1215 debugf2("MC: " __FILE__ ": %s()\n", __func__);
1217 /* Ensure that the OPSTATE is set correctly for POLL or NMI */
1220 pci_rc = pci_register_driver(&i7300_driver);
1222 return (pci_rc < 0) ? pci_rc : 0;
1226 * i7300_init() - Unregisters the driver
1228 static void __exit i7300_exit(void)
1230 debugf2("MC: " __FILE__ ": %s()\n", __func__);
1231 pci_unregister_driver(&i7300_driver);
1234 module_init(i7300_init);
1235 module_exit(i7300_exit);
1237 MODULE_LICENSE("GPL");
1238 MODULE_AUTHOR("Mauro Carvalho Chehab <mchehab@redhat.com>");
1239 MODULE_AUTHOR("Red Hat Inc. (http://www.redhat.com)");
1240 MODULE_DESCRIPTION("MC Driver for Intel I7300 memory controllers - "
1243 module_param(edac_op_state, int, 0444);
1244 MODULE_PARM_DESC(edac_op_state, "EDAC Error Reporting state: 0=Poll,1=NMI");