eeh.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385
  1. /*
  2. * Copyright (C) 2001 Dave Engebretsen & Todd Inglett IBM Corporation.
  3. * Copyright 2001-2012 IBM Corporation.
  4. *
  5. * This program is free software; you can redistribute it and/or modify
  6. * it under the terms of the GNU General Public License as published by
  7. * the Free Software Foundation; either version 2 of the License, or
  8. * (at your option) any later version.
  9. *
  10. * This program is distributed in the hope that it will be useful,
  11. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13. * GNU General Public License for more details.
  14. *
  15. * You should have received a copy of the GNU General Public License
  16. * along with this program; if not, write to the Free Software
  17. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  18. */
  19. #ifndef _POWERPC_EEH_H
  20. #define _POWERPC_EEH_H
  21. #ifdef __KERNEL__
  22. #include <linux/init.h>
  23. #include <linux/list.h>
  24. #include <linux/string.h>
  25. #include <linux/time.h>
  26. struct pci_dev;
  27. struct pci_bus;
  28. struct device_node;
  29. #ifdef CONFIG_EEH
  30. /*
  31. * The struct is used to trace PE related EEH functionality.
  32. * In theory, there will have one instance of the struct to
  33. * be created against particular PE. In nature, PEs corelate
  34. * to each other. the struct has to reflect that hierarchy in
  35. * order to easily pick up those affected PEs when one particular
  36. * PE has EEH errors.
  37. *
  38. * Also, one particular PE might be composed of PCI device, PCI
  39. * bus and its subordinate components. The struct also need ship
  40. * the information. Further more, one particular PE is only meaingful
  41. * in the corresponding PHB. Therefore, the root PEs should be created
  42. * against existing PHBs in on-to-one fashion.
  43. */
  44. #define EEH_PE_INVALID (1 << 0) /* Invalid */
  45. #define EEH_PE_PHB (1 << 1) /* PHB PE */
  46. #define EEH_PE_DEVICE (1 << 2) /* Device PE */
  47. #define EEH_PE_BUS (1 << 3) /* Bus PE */
  48. #define EEH_PE_ISOLATED (1 << 0) /* Isolated PE */
  49. #define EEH_PE_RECOVERING (1 << 1) /* Recovering PE */
  50. #define EEH_PE_PHB_DEAD (1 << 2) /* Dead PHB */
  51. #define EEH_PE_KEEP (1 << 8) /* Keep PE on hotplug */
  52. struct eeh_pe {
  53. int type; /* PE type: PHB/Bus/Device */
  54. int state; /* PE EEH dependent mode */
  55. int config_addr; /* Traditional PCI address */
  56. int addr; /* PE configuration address */
  57. struct pci_controller *phb; /* Associated PHB */
  58. struct pci_bus *bus; /* Top PCI bus for bus PE */
  59. int check_count; /* Times of ignored error */
  60. int freeze_count; /* Times of froze up */
  61. struct timeval tstamp; /* Time on first-time freeze */
  62. int false_positives; /* Times of reported #ff's */
  63. struct eeh_pe *parent; /* Parent PE */
  64. struct list_head child_list; /* Link PE to the child list */
  65. struct list_head edevs; /* Link list of EEH devices */
  66. struct list_head child; /* Child PEs */
  67. };
  68. #define eeh_pe_for_each_dev(pe, edev, tmp) \
  69. list_for_each_entry_safe(edev, tmp, &pe->edevs, list)
  70. /*
  71. * The struct is used to trace EEH state for the associated
  72. * PCI device node or PCI device. In future, it might
  73. * represent PE as well so that the EEH device to form
  74. * another tree except the currently existing tree of PCI
  75. * buses and PCI devices
  76. */
  77. #define EEH_DEV_BRIDGE (1 << 0) /* PCI bridge */
  78. #define EEH_DEV_ROOT_PORT (1 << 1) /* PCIe root port */
  79. #define EEH_DEV_DS_PORT (1 << 2) /* Downstream port */
  80. #define EEH_DEV_IRQ_DISABLED (1 << 3) /* Interrupt disabled */
  81. #define EEH_DEV_DISCONNECTED (1 << 4) /* Removing from PE */
  82. #define EEH_DEV_SYSFS (1 << 8) /* Sysfs created */
  83. struct eeh_dev {
  84. int mode; /* EEH mode */
  85. int class_code; /* Class code of the device */
  86. int config_addr; /* Config address */
  87. int pe_config_addr; /* PE config address */
  88. u32 config_space[16]; /* Saved PCI config space */
  89. u8 pcie_cap; /* Saved PCIe capability */
  90. struct eeh_pe *pe; /* Associated PE */
  91. struct list_head list; /* Form link list in the PE */
  92. struct pci_controller *phb; /* Associated PHB */
  93. struct device_node *dn; /* Associated device node */
  94. struct pci_dev *pdev; /* Associated PCI device */
  95. struct pci_bus *bus; /* PCI bus for partial hotplug */
  96. };
  97. static inline struct device_node *eeh_dev_to_of_node(struct eeh_dev *edev)
  98. {
  99. return edev ? edev->dn : NULL;
  100. }
  101. static inline struct pci_dev *eeh_dev_to_pci_dev(struct eeh_dev *edev)
  102. {
  103. return edev ? edev->pdev : NULL;
  104. }
  105. /*
  106. * The struct is used to trace the registered EEH operation
  107. * callback functions. Actually, those operation callback
  108. * functions are heavily platform dependent. That means the
  109. * platform should register its own EEH operation callback
  110. * functions before any EEH further operations.
  111. */
  112. #define EEH_OPT_DISABLE 0 /* EEH disable */
  113. #define EEH_OPT_ENABLE 1 /* EEH enable */
  114. #define EEH_OPT_THAW_MMIO 2 /* MMIO enable */
  115. #define EEH_OPT_THAW_DMA 3 /* DMA enable */
  116. #define EEH_STATE_UNAVAILABLE (1 << 0) /* State unavailable */
  117. #define EEH_STATE_NOT_SUPPORT (1 << 1) /* EEH not supported */
  118. #define EEH_STATE_RESET_ACTIVE (1 << 2) /* Active reset */
  119. #define EEH_STATE_MMIO_ACTIVE (1 << 3) /* Active MMIO */
  120. #define EEH_STATE_DMA_ACTIVE (1 << 4) /* Active DMA */
  121. #define EEH_STATE_MMIO_ENABLED (1 << 5) /* MMIO enabled */
  122. #define EEH_STATE_DMA_ENABLED (1 << 6) /* DMA enabled */
  123. #define EEH_RESET_DEACTIVATE 0 /* Deactivate the PE reset */
  124. #define EEH_RESET_HOT 1 /* Hot reset */
  125. #define EEH_RESET_FUNDAMENTAL 3 /* Fundamental reset */
  126. #define EEH_LOG_TEMP 1 /* EEH temporary error log */
  127. #define EEH_LOG_PERM 2 /* EEH permanent error log */
  128. struct eeh_ops {
  129. char *name;
  130. int (*init)(void);
  131. int (*post_init)(void);
  132. void* (*of_probe)(struct device_node *dn, void *flag);
  133. int (*dev_probe)(struct pci_dev *dev, void *flag);
  134. int (*set_option)(struct eeh_pe *pe, int option);
  135. int (*get_pe_addr)(struct eeh_pe *pe);
  136. int (*get_state)(struct eeh_pe *pe, int *state);
  137. int (*reset)(struct eeh_pe *pe, int option);
  138. int (*wait_state)(struct eeh_pe *pe, int max_wait);
  139. int (*get_log)(struct eeh_pe *pe, int severity, char *drv_log, unsigned long len);
  140. int (*configure_bridge)(struct eeh_pe *pe);
  141. int (*read_config)(struct device_node *dn, int where, int size, u32 *val);
  142. int (*write_config)(struct device_node *dn, int where, int size, u32 val);
  143. int (*next_error)(struct eeh_pe **pe);
  144. };
  145. extern struct eeh_ops *eeh_ops;
  146. extern int eeh_subsystem_enabled;
  147. extern raw_spinlock_t confirm_error_lock;
  148. extern int eeh_probe_mode;
  149. #define EEH_PROBE_MODE_DEV (1<<0) /* From PCI device */
  150. #define EEH_PROBE_MODE_DEVTREE (1<<1) /* From device tree */
  151. static inline void eeh_probe_mode_set(int flag)
  152. {
  153. eeh_probe_mode = flag;
  154. }
  155. static inline int eeh_probe_mode_devtree(void)
  156. {
  157. return (eeh_probe_mode == EEH_PROBE_MODE_DEVTREE);
  158. }
  159. static inline int eeh_probe_mode_dev(void)
  160. {
  161. return (eeh_probe_mode == EEH_PROBE_MODE_DEV);
  162. }
  163. static inline void eeh_serialize_lock(unsigned long *flags)
  164. {
  165. raw_spin_lock_irqsave(&confirm_error_lock, *flags);
  166. }
  167. static inline void eeh_serialize_unlock(unsigned long flags)
  168. {
  169. raw_spin_unlock_irqrestore(&confirm_error_lock, flags);
  170. }
  171. /*
  172. * Max number of EEH freezes allowed before we consider the device
  173. * to be permanently disabled.
  174. */
  175. #define EEH_MAX_ALLOWED_FREEZES 5
  176. typedef void *(*eeh_traverse_func)(void *data, void *flag);
  177. int eeh_phb_pe_create(struct pci_controller *phb);
  178. struct eeh_pe *eeh_phb_pe_get(struct pci_controller *phb);
  179. struct eeh_pe *eeh_pe_get(struct eeh_dev *edev);
  180. int eeh_add_to_parent_pe(struct eeh_dev *edev);
  181. int eeh_rmv_from_parent_pe(struct eeh_dev *edev);
  182. void eeh_pe_update_time_stamp(struct eeh_pe *pe);
  183. void *eeh_pe_traverse(struct eeh_pe *root,
  184. eeh_traverse_func fn, void *flag);
  185. void *eeh_pe_dev_traverse(struct eeh_pe *root,
  186. eeh_traverse_func fn, void *flag);
  187. void eeh_pe_restore_bars(struct eeh_pe *pe);
  188. struct pci_bus *eeh_pe_bus_get(struct eeh_pe *pe);
  189. void *eeh_dev_init(struct device_node *dn, void *data);
  190. void eeh_dev_phb_init_dynamic(struct pci_controller *phb);
  191. int eeh_init(void);
  192. int __init eeh_ops_register(struct eeh_ops *ops);
  193. int __exit eeh_ops_unregister(const char *name);
  194. unsigned long eeh_check_failure(const volatile void __iomem *token,
  195. unsigned long val);
  196. int eeh_dev_check_failure(struct eeh_dev *edev);
  197. void eeh_addr_cache_build(void);
  198. void eeh_add_device_early(struct device_node *);
  199. void eeh_add_device_tree_early(struct device_node *);
  200. void eeh_add_device_late(struct pci_dev *);
  201. void eeh_add_device_tree_late(struct pci_bus *);
  202. void eeh_add_sysfs_files(struct pci_bus *);
  203. void eeh_remove_device(struct pci_dev *);
  204. /**
  205. * EEH_POSSIBLE_ERROR() -- test for possible MMIO failure.
  206. *
  207. * If this macro yields TRUE, the caller relays to eeh_check_failure()
  208. * which does further tests out of line.
  209. */
  210. #define EEH_POSSIBLE_ERROR(val, type) ((val) == (type)~0 && eeh_subsystem_enabled)
  211. /*
  212. * Reads from a device which has been isolated by EEH will return
  213. * all 1s. This macro gives an all-1s value of the given size (in
  214. * bytes: 1, 2, or 4) for comparing with the result of a read.
  215. */
  216. #define EEH_IO_ERROR_VALUE(size) (~0U >> ((4 - (size)) * 8))
  217. #else /* !CONFIG_EEH */
  218. static inline int eeh_init(void)
  219. {
  220. return 0;
  221. }
  222. static inline void *eeh_dev_init(struct device_node *dn, void *data)
  223. {
  224. return NULL;
  225. }
  226. static inline void eeh_dev_phb_init_dynamic(struct pci_controller *phb) { }
  227. static inline unsigned long eeh_check_failure(const volatile void __iomem *token, unsigned long val)
  228. {
  229. return val;
  230. }
  231. #define eeh_dev_check_failure(x) (0)
  232. static inline void eeh_addr_cache_build(void) { }
  233. static inline void eeh_add_device_early(struct device_node *dn) { }
  234. static inline void eeh_add_device_tree_early(struct device_node *dn) { }
  235. static inline void eeh_add_device_late(struct pci_dev *dev) { }
  236. static inline void eeh_add_device_tree_late(struct pci_bus *bus) { }
  237. static inline void eeh_add_sysfs_files(struct pci_bus *bus) { }
  238. static inline void eeh_remove_device(struct pci_dev *dev) { }
  239. #define EEH_POSSIBLE_ERROR(val, type) (0)
  240. #define EEH_IO_ERROR_VALUE(size) (-1UL)
  241. #endif /* CONFIG_EEH */
  242. #ifdef CONFIG_PPC64
  243. /*
  244. * MMIO read/write operations with EEH support.
  245. */
  246. static inline u8 eeh_readb(const volatile void __iomem *addr)
  247. {
  248. u8 val = in_8(addr);
  249. if (EEH_POSSIBLE_ERROR(val, u8))
  250. return eeh_check_failure(addr, val);
  251. return val;
  252. }
  253. static inline u16 eeh_readw(const volatile void __iomem *addr)
  254. {
  255. u16 val = in_le16(addr);
  256. if (EEH_POSSIBLE_ERROR(val, u16))
  257. return eeh_check_failure(addr, val);
  258. return val;
  259. }
  260. static inline u32 eeh_readl(const volatile void __iomem *addr)
  261. {
  262. u32 val = in_le32(addr);
  263. if (EEH_POSSIBLE_ERROR(val, u32))
  264. return eeh_check_failure(addr, val);
  265. return val;
  266. }
  267. static inline u64 eeh_readq(const volatile void __iomem *addr)
  268. {
  269. u64 val = in_le64(addr);
  270. if (EEH_POSSIBLE_ERROR(val, u64))
  271. return eeh_check_failure(addr, val);
  272. return val;
  273. }
  274. static inline u16 eeh_readw_be(const volatile void __iomem *addr)
  275. {
  276. u16 val = in_be16(addr);
  277. if (EEH_POSSIBLE_ERROR(val, u16))
  278. return eeh_check_failure(addr, val);
  279. return val;
  280. }
  281. static inline u32 eeh_readl_be(const volatile void __iomem *addr)
  282. {
  283. u32 val = in_be32(addr);
  284. if (EEH_POSSIBLE_ERROR(val, u32))
  285. return eeh_check_failure(addr, val);
  286. return val;
  287. }
  288. static inline u64 eeh_readq_be(const volatile void __iomem *addr)
  289. {
  290. u64 val = in_be64(addr);
  291. if (EEH_POSSIBLE_ERROR(val, u64))
  292. return eeh_check_failure(addr, val);
  293. return val;
  294. }
  295. static inline void eeh_memcpy_fromio(void *dest, const
  296. volatile void __iomem *src,
  297. unsigned long n)
  298. {
  299. _memcpy_fromio(dest, src, n);
  300. /* Look for ffff's here at dest[n]. Assume that at least 4 bytes
  301. * were copied. Check all four bytes.
  302. */
  303. if (n >= 4 && EEH_POSSIBLE_ERROR(*((u32 *)(dest + n - 4)), u32))
  304. eeh_check_failure(src, *((u32 *)(dest + n - 4)));
  305. }
  306. /* in-string eeh macros */
  307. static inline void eeh_readsb(const volatile void __iomem *addr, void * buf,
  308. int ns)
  309. {
  310. _insb(addr, buf, ns);
  311. if (EEH_POSSIBLE_ERROR((*(((u8*)buf)+ns-1)), u8))
  312. eeh_check_failure(addr, *(u8*)buf);
  313. }
  314. static inline void eeh_readsw(const volatile void __iomem *addr, void * buf,
  315. int ns)
  316. {
  317. _insw(addr, buf, ns);
  318. if (EEH_POSSIBLE_ERROR((*(((u16*)buf)+ns-1)), u16))
  319. eeh_check_failure(addr, *(u16*)buf);
  320. }
  321. static inline void eeh_readsl(const volatile void __iomem *addr, void * buf,
  322. int nl)
  323. {
  324. _insl(addr, buf, nl);
  325. if (EEH_POSSIBLE_ERROR((*(((u32*)buf)+nl-1)), u32))
  326. eeh_check_failure(addr, *(u32*)buf);
  327. }
  328. #endif /* CONFIG_PPC64 */
  329. #endif /* __KERNEL__ */
  330. #endif /* _POWERPC_EEH_H */