2 * PCI Error Recovery Driver for RPA-compliant PPC64 platform.
3 * Copyright IBM Corp. 2004 2005
4 * Copyright Linas Vepstas <linas@linas.org> 2004, 2005
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or (at
11 * your option) any later version.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
16 * NON INFRINGEMENT. See the GNU General Public License for more
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 * Send comments and feedback to Linas Vepstas <linas@austin.ibm.com>
25 #include <linux/delay.h>
26 #include <linux/interrupt.h>
27 #include <linux/irq.h>
28 #include <linux/pci.h>
30 #include <asm/eeh_event.h>
31 #include <asm/ppc-pci.h>
32 #include <asm/pci-bridge.h>
37 static inline const char * pcid_name (struct pci_dev
*pdev
)
39 if (pdev
&& pdev
->dev
.driver
)
40 return pdev
->dev
.driver
->name
;
45 static void print_device_node_tree(struct pci_dn
*pdn
, int dent
)
48 struct device_node
*pc
;
52 for (i
= 0; i
< dent
; i
++)
54 printk("dn=%s mode=%x \tcfg_addr=%x pe_addr=%x \tfull=%s\n",
55 pdn
->node
->name
, pdn
->eeh_mode
, pdn
->eeh_config_addr
,
56 pdn
->eeh_pe_config_addr
, pdn
->node
->full_name
);
58 pc
= pdn
->node
->child
;
60 print_device_node_tree(PCI_DN(pc
), dent
);
67 * irq_in_use - return true if this irq is being used
69 static int irq_in_use(unsigned int irq
)
73 struct irq_desc
*desc
= irq_desc
+ irq
;
75 spin_lock_irqsave(&desc
->lock
, flags
);
78 spin_unlock_irqrestore(&desc
->lock
, flags
);
83 * eeh_disable_irq - disable interrupt for the recovering device
85 static void eeh_disable_irq(struct pci_dev
*dev
)
87 struct device_node
*dn
= pci_device_to_OF_node(dev
);
89 /* Don't disable MSI and MSI-X interrupts. They are
90 * effectively disabled by the DMA Stopped state
91 * when an EEH error occurs.
93 if (dev
->msi_enabled
|| dev
->msix_enabled
)
96 if (!irq_in_use(dev
->irq
))
99 PCI_DN(dn
)->eeh_mode
|= EEH_MODE_IRQ_DISABLED
;
100 disable_irq_nosync(dev
->irq
);
104 * eeh_enable_irq - enable interrupt for the recovering device
106 static void eeh_enable_irq(struct pci_dev
*dev
)
108 struct device_node
*dn
= pci_device_to_OF_node(dev
);
110 if ((PCI_DN(dn
)->eeh_mode
) & EEH_MODE_IRQ_DISABLED
) {
111 PCI_DN(dn
)->eeh_mode
&= ~EEH_MODE_IRQ_DISABLED
;
112 enable_irq(dev
->irq
);
116 /* ------------------------------------------------------- */
118 * eeh_report_error - report pci error to each device driver
120 * Report an EEH error to each device driver, collect up and
121 * merge the device driver responses. Cumulative response
122 * passed back in "userdata".
125 static int eeh_report_error(struct pci_dev
*dev
, void *userdata
)
127 enum pci_ers_result rc
, *res
= userdata
;
128 struct pci_driver
*driver
= dev
->driver
;
130 dev
->error_state
= pci_channel_io_frozen
;
135 eeh_disable_irq(dev
);
137 if (!driver
->err_handler
||
138 !driver
->err_handler
->error_detected
)
141 rc
= driver
->err_handler
->error_detected (dev
, pci_channel_io_frozen
);
143 /* A driver that needs a reset trumps all others */
144 if (rc
== PCI_ERS_RESULT_NEED_RESET
) *res
= rc
;
145 if (*res
== PCI_ERS_RESULT_NONE
) *res
= rc
;
151 * eeh_report_mmio_enabled - tell drivers that MMIO has been enabled
153 * Tells each device driver that IO ports, MMIO and config space I/O
154 * are now enabled. Collects up and merges the device driver responses.
155 * Cumulative response passed back in "userdata".
158 static int eeh_report_mmio_enabled(struct pci_dev
*dev
, void *userdata
)
160 enum pci_ers_result rc
, *res
= userdata
;
161 struct pci_driver
*driver
= dev
->driver
;
164 !driver
->err_handler
||
165 !driver
->err_handler
->mmio_enabled
)
168 rc
= driver
->err_handler
->mmio_enabled (dev
);
170 /* A driver that needs a reset trumps all others */
171 if (rc
== PCI_ERS_RESULT_NEED_RESET
) *res
= rc
;
172 if (*res
== PCI_ERS_RESULT_NONE
) *res
= rc
;
178 * eeh_report_reset - tell device that slot has been reset
181 static int eeh_report_reset(struct pci_dev
*dev
, void *userdata
)
183 enum pci_ers_result rc
, *res
= userdata
;
184 struct pci_driver
*driver
= dev
->driver
;
189 dev
->error_state
= pci_channel_io_normal
;
193 if (!driver
->err_handler
||
194 !driver
->err_handler
->slot_reset
)
197 rc
= driver
->err_handler
->slot_reset(dev
);
198 if ((*res
== PCI_ERS_RESULT_NONE
) ||
199 (*res
== PCI_ERS_RESULT_RECOVERED
)) *res
= rc
;
200 if (*res
== PCI_ERS_RESULT_DISCONNECT
&&
201 rc
== PCI_ERS_RESULT_NEED_RESET
) *res
= rc
;
207 * eeh_report_resume - tell device to resume normal operations
210 static int eeh_report_resume(struct pci_dev
*dev
, void *userdata
)
212 struct pci_driver
*driver
= dev
->driver
;
214 dev
->error_state
= pci_channel_io_normal
;
221 if (!driver
->err_handler
||
222 !driver
->err_handler
->resume
)
225 driver
->err_handler
->resume(dev
);
231 * eeh_report_failure - tell device driver that device is dead.
233 * This informs the device driver that the device is permanently
234 * dead, and that no further recovery attempts will be made on it.
237 static int eeh_report_failure(struct pci_dev
*dev
, void *userdata
)
239 struct pci_driver
*driver
= dev
->driver
;
241 dev
->error_state
= pci_channel_io_perm_failure
;
246 eeh_disable_irq(dev
);
248 if (!driver
->err_handler
||
249 !driver
->err_handler
->error_detected
)
252 driver
->err_handler
->error_detected(dev
, pci_channel_io_perm_failure
);
257 /* ------------------------------------------------------- */
259 * handle_eeh_events -- reset a PCI device after hard lockup.
261 * pSeries systems will isolate a PCI slot if the PCI-Host
262 * bridge detects address or data parity errors, DMA's
263 * occurring to wild addresses (which usually happen due to
264 * bugs in device drivers or in PCI adapter firmware).
265 * Slot isolations also occur if #SERR, #PERR or other misc
266 * PCI-related errors are detected.
268 * Recovery process consists of unplugging the device driver
269 * (which generated hotplug events to userspace), then issuing
270 * a PCI #RST to the device, then reconfiguring the PCI config
271 * space for all bridges & devices under this slot, and then
272 * finally restarting the device drivers (which cause a second
273 * set of hotplug events to go out to userspace).
277 * eeh_reset_device() -- perform actual reset of a pci slot
278 * @bus: pointer to the pci bus structure corresponding
279 * to the isolated slot. A non-null value will
280 * cause all devices under the bus to be removed
282 * @pe_dn: pointer to a "Partionable Endpoint" device node.
283 * This is the top-level structure on which pci
284 * bus resets can be performed.
287 static int eeh_reset_device (struct pci_dn
*pe_dn
, struct pci_bus
*bus
)
289 struct device_node
*dn
;
292 /* pcibios will clear the counter; save the value */
293 cnt
= pe_dn
->eeh_freeze_count
;
296 pcibios_remove_pci_devices(bus
);
298 /* Reset the pci controller. (Asserts RST#; resets config space).
299 * Reconfigure bridges and devices. Don't try to bring the system
300 * up if the reset failed for some reason. */
301 rc
= rtas_set_slot_reset(pe_dn
);
305 /* Walk over all functions on this device. */
307 if (!pcibios_find_pci_bus(dn
) && PCI_DN(dn
->parent
))
308 dn
= dn
->parent
->child
;
311 struct pci_dn
*ppe
= PCI_DN(dn
);
312 /* On Power4, always true because eeh_pe_config_addr=0 */
313 if (pe_dn
->eeh_pe_config_addr
== ppe
->eeh_pe_config_addr
) {
314 rtas_configure_bridge(ppe
);
315 eeh_restore_bars(ppe
);
320 /* Give the system 5 seconds to finish running the user-space
321 * hotplug shutdown scripts, e.g. ifdown for ethernet. Yes,
322 * this is a hack, but if we don't do this, and try to bring
323 * the device up before the scripts have taken it down,
324 * potentially weird things happen.
328 pcibios_add_pci_devices(bus
);
330 pe_dn
->eeh_freeze_count
= cnt
;
335 /* The longest amount of time to wait for a pci device
336 * to come back on line, in seconds.
338 #define MAX_WAIT_FOR_RECOVERY 150
340 struct pci_dn
* handle_eeh_events (struct eeh_event
*event
)
342 struct device_node
*frozen_dn
;
343 struct pci_dn
*frozen_pdn
;
344 struct pci_bus
*frozen_bus
;
346 enum pci_ers_result result
= PCI_ERS_RESULT_NONE
;
347 const char *location
, *pci_str
, *drv_str
;
349 frozen_dn
= find_device_pe(event
->dn
);
352 location
= of_get_property(event
->dn
, "ibm,loc-code", NULL
);
353 location
= location
? location
: "unknown";
354 printk(KERN_ERR
"EEH: Error: Cannot find partition endpoint "
355 "for location=%s pci addr=%s\n",
356 location
, pci_name(event
->dev
));
360 frozen_bus
= pcibios_find_pci_bus(frozen_dn
);
361 location
= of_get_property(frozen_dn
, "ibm,loc-code", NULL
);
362 location
= location
? location
: "unknown";
364 /* There are two different styles for coming up with the PE.
365 * In the old style, it was the highest EEH-capable device
366 * which was always an EADS pci bridge. In the new style,
367 * there might not be any EADS bridges, and even when there are,
368 * the firmware marks them as "EEH incapable". So another
369 * two-step is needed to find the pci bus.. */
371 frozen_bus
= pcibios_find_pci_bus (frozen_dn
->parent
);
374 printk(KERN_ERR
"EEH: Cannot find PCI bus "
375 "for location=%s dn=%s\n",
376 location
, frozen_dn
->full_name
);
380 frozen_pdn
= PCI_DN(frozen_dn
);
381 frozen_pdn
->eeh_freeze_count
++;
383 if (frozen_pdn
->pcidev
) {
384 pci_str
= pci_name (frozen_pdn
->pcidev
);
385 drv_str
= pcid_name (frozen_pdn
->pcidev
);
387 pci_str
= pci_name (event
->dev
);
388 drv_str
= pcid_name (event
->dev
);
391 if (frozen_pdn
->eeh_freeze_count
> EEH_MAX_ALLOWED_FREEZES
)
392 goto excess_failures
;
395 "EEH: This PCI device has failed %d times in the last hour:\n",
396 frozen_pdn
->eeh_freeze_count
);
398 "EEH: location=%s driver=%s pci addr=%s\n",
399 location
, drv_str
, pci_str
);
401 /* Walk the various device drivers attached to this slot through
402 * a reset sequence, giving each an opportunity to do what it needs
403 * to accomplish the reset. Each child gets a report of the
404 * status ... if any child can't handle the reset, then the entire
405 * slot is dlpar removed and added.
407 pci_walk_bus(frozen_bus
, eeh_report_error
, &result
);
409 /* Get the current PCI slot state. This can take a long time,
410 * sometimes over 3 seconds for certain systems. */
411 rc
= eeh_wait_for_slot_status (frozen_pdn
, MAX_WAIT_FOR_RECOVERY
*1000);
413 printk(KERN_WARNING
"EEH: Permanent failure\n");
417 /* Since rtas may enable MMIO when posting the error log,
418 * don't post the error log until after all dev drivers
419 * have been informed.
421 eeh_slot_error_detail(frozen_pdn
, EEH_LOG_TEMP_FAILURE
);
423 /* If all device drivers were EEH-unaware, then shut
424 * down all of the device drivers, and hope they
425 * go down willingly, without panicing the system.
427 if (result
== PCI_ERS_RESULT_NONE
) {
428 rc
= eeh_reset_device(frozen_pdn
, frozen_bus
);
430 printk(KERN_WARNING
"EEH: Unable to reset, rc=%d\n", rc
);
435 /* If all devices reported they can proceed, then re-enable MMIO */
436 if (result
== PCI_ERS_RESULT_CAN_RECOVER
) {
437 rc
= rtas_pci_enable(frozen_pdn
, EEH_THAW_MMIO
);
442 result
= PCI_ERS_RESULT_NEED_RESET
;
444 result
= PCI_ERS_RESULT_NONE
;
445 pci_walk_bus(frozen_bus
, eeh_report_mmio_enabled
, &result
);
449 /* If all devices reported they can proceed, then re-enable DMA */
450 if (result
== PCI_ERS_RESULT_CAN_RECOVER
) {
451 rc
= rtas_pci_enable(frozen_pdn
, EEH_THAW_DMA
);
456 result
= PCI_ERS_RESULT_NEED_RESET
;
458 result
= PCI_ERS_RESULT_RECOVERED
;
461 /* If any device has a hard failure, then shut off everything. */
462 if (result
== PCI_ERS_RESULT_DISCONNECT
) {
463 printk(KERN_WARNING
"EEH: Device driver gave up\n");
467 /* If any device called out for a reset, then reset the slot */
468 if (result
== PCI_ERS_RESULT_NEED_RESET
) {
469 rc
= eeh_reset_device(frozen_pdn
, NULL
);
471 printk(KERN_WARNING
"EEH: Cannot reset, rc=%d\n", rc
);
474 result
= PCI_ERS_RESULT_NONE
;
475 pci_walk_bus(frozen_bus
, eeh_report_reset
, &result
);
478 /* All devices should claim they have recovered by now. */
479 if ((result
!= PCI_ERS_RESULT_RECOVERED
) &&
480 (result
!= PCI_ERS_RESULT_NONE
)) {
481 printk(KERN_WARNING
"EEH: Not recovered\n");
485 /* Tell all device drivers that they can resume operations */
486 pci_walk_bus(frozen_bus
, eeh_report_resume
, NULL
);
492 * About 90% of all real-life EEH failures in the field
493 * are due to poorly seated PCI cards. Only 10% or so are
494 * due to actual, failed cards.
497 "EEH: PCI device at location=%s driver=%s pci addr=%s \n"
498 "has failed %d times in the last hour "
499 "and has been permanently disabled. \n"
500 "Please try reseating this device or replacing it.\n",
501 location
, drv_str
, pci_str
, frozen_pdn
->eeh_freeze_count
);
506 "EEH: Unable to recover from failure of PCI device "
507 "at location=%s driver=%s pci addr=%s \n"
508 "Please try reseating this device or replacing it.\n",
509 location
, drv_str
, pci_str
);
512 eeh_slot_error_detail(frozen_pdn
, EEH_LOG_PERM_FAILURE
);
514 /* Notify all devices that they're about to go down. */
515 pci_walk_bus(frozen_bus
, eeh_report_failure
, NULL
);
517 /* Shut down the device drivers for good. */
518 pcibios_remove_pci_devices(frozen_bus
);
523 /* ---------- end of file ---------- */