eeh.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375
  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) \
  69. list_for_each_entry(edev, &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_IRQ_DISABLED (1<<0) /* Interrupt disabled */
  78. struct eeh_dev {
  79. int mode; /* EEH mode */
  80. int class_code; /* Class code of the device */
  81. int config_addr; /* Config address */
  82. int pe_config_addr; /* PE config address */
  83. u32 config_space[16]; /* Saved PCI config space */
  84. struct eeh_pe *pe; /* Associated PE */
  85. struct list_head list; /* Form link list in the PE */
  86. struct pci_controller *phb; /* Associated PHB */
  87. struct device_node *dn; /* Associated device node */
  88. struct pci_dev *pdev; /* Associated PCI device */
  89. };
  90. static inline struct device_node *eeh_dev_to_of_node(struct eeh_dev *edev)
  91. {
  92. return edev ? edev->dn : NULL;
  93. }
  94. static inline struct pci_dev *eeh_dev_to_pci_dev(struct eeh_dev *edev)
  95. {
  96. return edev ? edev->pdev : NULL;
  97. }
  98. /*
  99. * The struct is used to trace the registered EEH operation
  100. * callback functions. Actually, those operation callback
  101. * functions are heavily platform dependent. That means the
  102. * platform should register its own EEH operation callback
  103. * functions before any EEH further operations.
  104. */
  105. #define EEH_OPT_DISABLE 0 /* EEH disable */
  106. #define EEH_OPT_ENABLE 1 /* EEH enable */
  107. #define EEH_OPT_THAW_MMIO 2 /* MMIO enable */
  108. #define EEH_OPT_THAW_DMA 3 /* DMA enable */
  109. #define EEH_STATE_UNAVAILABLE (1 << 0) /* State unavailable */
  110. #define EEH_STATE_NOT_SUPPORT (1 << 1) /* EEH not supported */
  111. #define EEH_STATE_RESET_ACTIVE (1 << 2) /* Active reset */
  112. #define EEH_STATE_MMIO_ACTIVE (1 << 3) /* Active MMIO */
  113. #define EEH_STATE_DMA_ACTIVE (1 << 4) /* Active DMA */
  114. #define EEH_STATE_MMIO_ENABLED (1 << 5) /* MMIO enabled */
  115. #define EEH_STATE_DMA_ENABLED (1 << 6) /* DMA enabled */
  116. #define EEH_RESET_DEACTIVATE 0 /* Deactivate the PE reset */
  117. #define EEH_RESET_HOT 1 /* Hot reset */
  118. #define EEH_RESET_FUNDAMENTAL 3 /* Fundamental reset */
  119. #define EEH_LOG_TEMP 1 /* EEH temporary error log */
  120. #define EEH_LOG_PERM 2 /* EEH permanent error log */
  121. struct eeh_ops {
  122. char *name;
  123. int (*init)(void);
  124. int (*post_init)(void);
  125. void* (*of_probe)(struct device_node *dn, void *flag);
  126. int (*dev_probe)(struct pci_dev *dev, void *flag);
  127. int (*set_option)(struct eeh_pe *pe, int option);
  128. int (*get_pe_addr)(struct eeh_pe *pe);
  129. int (*get_state)(struct eeh_pe *pe, int *state);
  130. int (*reset)(struct eeh_pe *pe, int option);
  131. int (*wait_state)(struct eeh_pe *pe, int max_wait);
  132. int (*get_log)(struct eeh_pe *pe, int severity, char *drv_log, unsigned long len);
  133. int (*configure_bridge)(struct eeh_pe *pe);
  134. int (*read_config)(struct device_node *dn, int where, int size, u32 *val);
  135. int (*write_config)(struct device_node *dn, int where, int size, u32 val);
  136. int (*next_error)(struct eeh_pe **pe);
  137. };
  138. extern struct eeh_ops *eeh_ops;
  139. extern int eeh_subsystem_enabled;
  140. extern raw_spinlock_t confirm_error_lock;
  141. extern int eeh_probe_mode;
  142. #define EEH_PROBE_MODE_DEV (1<<0) /* From PCI device */
  143. #define EEH_PROBE_MODE_DEVTREE (1<<1) /* From device tree */
  144. static inline void eeh_probe_mode_set(int flag)
  145. {
  146. eeh_probe_mode = flag;
  147. }
  148. static inline int eeh_probe_mode_devtree(void)
  149. {
  150. return (eeh_probe_mode == EEH_PROBE_MODE_DEVTREE);
  151. }
  152. static inline int eeh_probe_mode_dev(void)
  153. {
  154. return (eeh_probe_mode == EEH_PROBE_MODE_DEV);
  155. }
  156. static inline void eeh_serialize_lock(unsigned long *flags)
  157. {
  158. raw_spin_lock_irqsave(&confirm_error_lock, *flags);
  159. }
  160. static inline void eeh_serialize_unlock(unsigned long flags)
  161. {
  162. raw_spin_unlock_irqrestore(&confirm_error_lock, flags);
  163. }
  164. /*
  165. * Max number of EEH freezes allowed before we consider the device
  166. * to be permanently disabled.
  167. */
  168. #define EEH_MAX_ALLOWED_FREEZES 5
  169. typedef void *(*eeh_traverse_func)(void *data, void *flag);
  170. int eeh_phb_pe_create(struct pci_controller *phb);
  171. struct eeh_pe *eeh_phb_pe_get(struct pci_controller *phb);
  172. struct eeh_pe *eeh_pe_get(struct eeh_dev *edev);
  173. int eeh_add_to_parent_pe(struct eeh_dev *edev);
  174. int eeh_rmv_from_parent_pe(struct eeh_dev *edev);
  175. void eeh_pe_update_time_stamp(struct eeh_pe *pe);
  176. void *eeh_pe_dev_traverse(struct eeh_pe *root,
  177. eeh_traverse_func fn, void *flag);
  178. void eeh_pe_restore_bars(struct eeh_pe *pe);
  179. struct pci_bus *eeh_pe_bus_get(struct eeh_pe *pe);
  180. void *eeh_dev_init(struct device_node *dn, void *data);
  181. void eeh_dev_phb_init_dynamic(struct pci_controller *phb);
  182. int eeh_init(void);
  183. int __init eeh_ops_register(struct eeh_ops *ops);
  184. int __exit eeh_ops_unregister(const char *name);
  185. unsigned long eeh_check_failure(const volatile void __iomem *token,
  186. unsigned long val);
  187. int eeh_dev_check_failure(struct eeh_dev *edev);
  188. void eeh_addr_cache_build(void);
  189. void eeh_add_device_early(struct device_node *);
  190. void eeh_add_device_tree_early(struct device_node *);
  191. void eeh_add_device_late(struct pci_dev *);
  192. void eeh_add_device_tree_late(struct pci_bus *);
  193. void eeh_add_sysfs_files(struct pci_bus *);
  194. void eeh_remove_device(struct pci_dev *);
  195. /**
  196. * EEH_POSSIBLE_ERROR() -- test for possible MMIO failure.
  197. *
  198. * If this macro yields TRUE, the caller relays to eeh_check_failure()
  199. * which does further tests out of line.
  200. */
  201. #define EEH_POSSIBLE_ERROR(val, type) ((val) == (type)~0 && eeh_subsystem_enabled)
  202. /*
  203. * Reads from a device which has been isolated by EEH will return
  204. * all 1s. This macro gives an all-1s value of the given size (in
  205. * bytes: 1, 2, or 4) for comparing with the result of a read.
  206. */
  207. #define EEH_IO_ERROR_VALUE(size) (~0U >> ((4 - (size)) * 8))
  208. #else /* !CONFIG_EEH */
  209. static inline int eeh_init(void)
  210. {
  211. return 0;
  212. }
  213. static inline void *eeh_dev_init(struct device_node *dn, void *data)
  214. {
  215. return NULL;
  216. }
  217. static inline void eeh_dev_phb_init_dynamic(struct pci_controller *phb) { }
  218. static inline unsigned long eeh_check_failure(const volatile void __iomem *token, unsigned long val)
  219. {
  220. return val;
  221. }
  222. #define eeh_dev_check_failure(x) (0)
  223. static inline void eeh_addr_cache_build(void) { }
  224. static inline void eeh_add_device_early(struct device_node *dn) { }
  225. static inline void eeh_add_device_tree_early(struct device_node *dn) { }
  226. static inline void eeh_add_device_late(struct pci_dev *dev) { }
  227. static inline void eeh_add_device_tree_late(struct pci_bus *bus) { }
  228. static inline void eeh_add_sysfs_files(struct pci_bus *bus) { }
  229. static inline void eeh_remove_device(struct pci_dev *dev) { }
  230. #define EEH_POSSIBLE_ERROR(val, type) (0)
  231. #define EEH_IO_ERROR_VALUE(size) (-1UL)
  232. #endif /* CONFIG_EEH */
  233. #ifdef CONFIG_PPC64
  234. /*
  235. * MMIO read/write operations with EEH support.
  236. */
  237. static inline u8 eeh_readb(const volatile void __iomem *addr)
  238. {
  239. u8 val = in_8(addr);
  240. if (EEH_POSSIBLE_ERROR(val, u8))
  241. return eeh_check_failure(addr, val);
  242. return val;
  243. }
  244. static inline u16 eeh_readw(const volatile void __iomem *addr)
  245. {
  246. u16 val = in_le16(addr);
  247. if (EEH_POSSIBLE_ERROR(val, u16))
  248. return eeh_check_failure(addr, val);
  249. return val;
  250. }
  251. static inline u32 eeh_readl(const volatile void __iomem *addr)
  252. {
  253. u32 val = in_le32(addr);
  254. if (EEH_POSSIBLE_ERROR(val, u32))
  255. return eeh_check_failure(addr, val);
  256. return val;
  257. }
  258. static inline u64 eeh_readq(const volatile void __iomem *addr)
  259. {
  260. u64 val = in_le64(addr);
  261. if (EEH_POSSIBLE_ERROR(val, u64))
  262. return eeh_check_failure(addr, val);
  263. return val;
  264. }
  265. static inline u16 eeh_readw_be(const volatile void __iomem *addr)
  266. {
  267. u16 val = in_be16(addr);
  268. if (EEH_POSSIBLE_ERROR(val, u16))
  269. return eeh_check_failure(addr, val);
  270. return val;
  271. }
  272. static inline u32 eeh_readl_be(const volatile void __iomem *addr)
  273. {
  274. u32 val = in_be32(addr);
  275. if (EEH_POSSIBLE_ERROR(val, u32))
  276. return eeh_check_failure(addr, val);
  277. return val;
  278. }
  279. static inline u64 eeh_readq_be(const volatile void __iomem *addr)
  280. {
  281. u64 val = in_be64(addr);
  282. if (EEH_POSSIBLE_ERROR(val, u64))
  283. return eeh_check_failure(addr, val);
  284. return val;
  285. }
  286. static inline void eeh_memcpy_fromio(void *dest, const
  287. volatile void __iomem *src,
  288. unsigned long n)
  289. {
  290. _memcpy_fromio(dest, src, n);
  291. /* Look for ffff's here at dest[n]. Assume that at least 4 bytes
  292. * were copied. Check all four bytes.
  293. */
  294. if (n >= 4 && EEH_POSSIBLE_ERROR(*((u32 *)(dest + n - 4)), u32))
  295. eeh_check_failure(src, *((u32 *)(dest + n - 4)));
  296. }
  297. /* in-string eeh macros */
  298. static inline void eeh_readsb(const volatile void __iomem *addr, void * buf,
  299. int ns)
  300. {
  301. _insb(addr, buf, ns);
  302. if (EEH_POSSIBLE_ERROR((*(((u8*)buf)+ns-1)), u8))
  303. eeh_check_failure(addr, *(u8*)buf);
  304. }
  305. static inline void eeh_readsw(const volatile void __iomem *addr, void * buf,
  306. int ns)
  307. {
  308. _insw(addr, buf, ns);
  309. if (EEH_POSSIBLE_ERROR((*(((u16*)buf)+ns-1)), u16))
  310. eeh_check_failure(addr, *(u16*)buf);
  311. }
  312. static inline void eeh_readsl(const volatile void __iomem *addr, void * buf,
  313. int nl)
  314. {
  315. _insl(addr, buf, nl);
  316. if (EEH_POSSIBLE_ERROR((*(((u32*)buf)+nl-1)), u32))
  317. eeh_check_failure(addr, *(u32*)buf);
  318. }
  319. #endif /* CONFIG_PPC64 */
  320. #endif /* __KERNEL__ */
  321. #endif /* _POWERPC_EEH_H */