isa.h 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. /*
  3. * ISA bus.
  4. */
  5. #ifndef __LINUX_ISA_H
  6. #define __LINUX_ISA_H
  7. #include <linux/device.h>
  8. #include <linux/errno.h>
  9. #include <linux/kernel.h>
  10. struct isa_driver {
  11. int (*match)(struct device *, unsigned int);
  12. int (*probe)(struct device *, unsigned int);
  13. void (*remove)(struct device *, unsigned int);
  14. void (*shutdown)(struct device *, unsigned int);
  15. int (*suspend)(struct device *, unsigned int, pm_message_t);
  16. int (*resume)(struct device *, unsigned int);
  17. struct device_driver driver;
  18. struct device *devices;
  19. };
  20. #define to_isa_driver(x) container_of((x), struct isa_driver, driver)
  21. #ifdef CONFIG_ISA_BUS_API
  22. int isa_register_driver(struct isa_driver *, unsigned int);
  23. void isa_unregister_driver(struct isa_driver *);
  24. #else
  25. static inline int isa_register_driver(struct isa_driver *d, unsigned int i)
  26. {
  27. return -ENODEV;
  28. }
  29. static inline void isa_unregister_driver(struct isa_driver *d)
  30. {
  31. }
  32. #endif
  33. #define module_isa_driver_init(__isa_driver, __num_isa_dev) \
  34. static int __init __isa_driver##_init(void) \
  35. { \
  36. return isa_register_driver(&(__isa_driver), __num_isa_dev); \
  37. } \
  38. module_init(__isa_driver##_init)
  39. #define module_isa_driver_with_irq_init(__isa_driver, __num_isa_dev, __num_irq) \
  40. static int __init __isa_driver##_init(void) \
  41. { \
  42. if (__num_irq != __num_isa_dev) { \
  43. pr_err("%s: Number of irq (%u) does not match number of base (%u)\n", \
  44. __isa_driver.driver.name, __num_irq, __num_isa_dev); \
  45. return -EINVAL; \
  46. } \
  47. return isa_register_driver(&(__isa_driver), __num_isa_dev); \
  48. } \
  49. module_init(__isa_driver##_init)
  50. #define module_isa_driver_exit(__isa_driver) \
  51. static void __exit __isa_driver##_exit(void) \
  52. { \
  53. isa_unregister_driver(&(__isa_driver)); \
  54. } \
  55. module_exit(__isa_driver##_exit)
  56. /**
  57. * module_isa_driver() - Helper macro for registering a ISA driver
  58. * @__isa_driver: isa_driver struct
  59. * @__num_isa_dev: number of devices to register
  60. *
  61. * Helper macro for ISA drivers which do not do anything special in module
  62. * init/exit. This eliminates a lot of boilerplate code. Each module may only
  63. * use this macro once, and calling it replaces module_init and module_exit.
  64. */
  65. #define module_isa_driver(__isa_driver, __num_isa_dev) \
  66. module_isa_driver_init(__isa_driver, __num_isa_dev); \
  67. module_isa_driver_exit(__isa_driver)
  68. /**
  69. * module_isa_driver_with_irq() - Helper macro for registering an ISA driver with irq
  70. * @__isa_driver: isa_driver struct
  71. * @__num_isa_dev: number of devices to register
  72. * @__num_irq: number of IRQ to register
  73. *
  74. * Helper macro for ISA drivers with irq that do not do anything special in
  75. * module init/exit. Each module may only use this macro once, and calling it
  76. * replaces module_init and module_exit.
  77. */
  78. #define module_isa_driver_with_irq(__isa_driver, __num_isa_dev, __num_irq) \
  79. module_isa_driver_with_irq_init(__isa_driver, __num_isa_dev, __num_irq); \
  80. module_isa_driver_exit(__isa_driver)
  81. /**
  82. * max_num_isa_dev() - Maximum possible number registered of an ISA device
  83. * @__ida_dev_ext: ISA device address extent
  84. *
  85. * The highest base address possible for an ISA device is 0x3FF; this results in
  86. * 1024 possible base addresses. Dividing the number of possible base addresses
  87. * by the address extent taken by each device results in the maximum number of
  88. * devices on a system.
  89. */
  90. #define max_num_isa_dev(__isa_dev_ext) (1024 / __isa_dev_ext)
  91. #endif /* __LINUX_ISA_H */