rt2x00pci.h 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. /*
  2. Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
  3. <http://rt2x00.serialmonkey.com>
  4. This program is free software; you can redistribute it and/or modify
  5. it under the terms of the GNU General Public License as published by
  6. the Free Software Foundation; either version 2 of the License, or
  7. (at your option) any later version.
  8. This program is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11. GNU General Public License for more details.
  12. You should have received a copy of the GNU General Public License
  13. along with this program; if not, write to the
  14. Free Software Foundation, Inc.,
  15. 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  16. */
  17. /*
  18. Module: rt2x00pci
  19. Abstract: Data structures for the rt2x00pci module.
  20. */
  21. #ifndef RT2X00PCI_H
  22. #define RT2X00PCI_H
  23. #include <linux/io.h>
  24. #include <linux/pci.h>
  25. /*
  26. * This variable should be used with the
  27. * pci_driver structure initialization.
  28. */
  29. #define PCI_DEVICE_DATA(__ops) .driver_data = (kernel_ulong_t)(__ops)
  30. /*
  31. * Register access.
  32. */
  33. static inline void rt2x00pci_register_read(struct rt2x00_dev *rt2x00dev,
  34. const unsigned int offset,
  35. u32 *value)
  36. {
  37. *value = readl(rt2x00dev->csr.base + offset);
  38. }
  39. static inline void rt2x00pci_register_multiread(struct rt2x00_dev *rt2x00dev,
  40. const unsigned int offset,
  41. void *value, const u32 length)
  42. {
  43. memcpy_fromio(value, rt2x00dev->csr.base + offset, length);
  44. }
  45. static inline void rt2x00pci_register_write(struct rt2x00_dev *rt2x00dev,
  46. const unsigned int offset,
  47. u32 value)
  48. {
  49. writel(value, rt2x00dev->csr.base + offset);
  50. }
  51. static inline void rt2x00pci_register_multiwrite(struct rt2x00_dev *rt2x00dev,
  52. const unsigned int offset,
  53. const void *value,
  54. const u32 length)
  55. {
  56. __iowrite32_copy(rt2x00dev->csr.base + offset, value, length >> 2);
  57. }
  58. /**
  59. * rt2x00pci_regbusy_read - Read from register with busy check
  60. * @rt2x00dev: Device pointer, see &struct rt2x00_dev.
  61. * @offset: Register offset
  62. * @field: Field to check if register is busy
  63. * @reg: Pointer to where register contents should be stored
  64. *
  65. * This function will read the given register, and checks if the
  66. * register is busy. If it is, it will sleep for a couple of
  67. * microseconds before reading the register again. If the register
  68. * is not read after a certain timeout, this function will return
  69. * FALSE.
  70. */
  71. int rt2x00pci_regbusy_read(struct rt2x00_dev *rt2x00dev,
  72. const unsigned int offset,
  73. const struct rt2x00_field32 field,
  74. u32 *reg);
  75. /**
  76. * struct queue_entry_priv_pci: Per entry PCI specific information
  77. *
  78. * @desc: Pointer to device descriptor
  79. * @desc_dma: DMA pointer to &desc.
  80. * @data: Pointer to device's entry memory.
  81. * @data_dma: DMA pointer to &data.
  82. */
  83. struct queue_entry_priv_pci {
  84. __le32 *desc;
  85. dma_addr_t desc_dma;
  86. };
  87. /**
  88. * rt2x00pci_rxdone - Handle RX done events
  89. * @rt2x00dev: Device pointer, see &struct rt2x00_dev.
  90. *
  91. * Returns true if there are still rx frames pending and false if all
  92. * pending rx frames were processed.
  93. */
  94. bool rt2x00pci_rxdone(struct rt2x00_dev *rt2x00dev);
  95. /**
  96. * rt2x00pci_flush_queue - Flush data queue
  97. * @queue: Data queue to stop
  98. * @drop: True to drop all pending frames.
  99. *
  100. * This will wait for a maximum of 100ms, waiting for the queues
  101. * to become empty.
  102. */
  103. void rt2x00pci_flush_queue(struct data_queue *queue, bool drop);
  104. /*
  105. * Device initialization handlers.
  106. */
  107. int rt2x00pci_initialize(struct rt2x00_dev *rt2x00dev);
  108. void rt2x00pci_uninitialize(struct rt2x00_dev *rt2x00dev);
  109. /*
  110. * PCI driver handlers.
  111. */
  112. int rt2x00pci_probe(struct pci_dev *pci_dev, const struct rt2x00_ops *ops);
  113. void rt2x00pci_remove(struct pci_dev *pci_dev);
  114. #ifdef CONFIG_PM
  115. int rt2x00pci_suspend(struct pci_dev *pci_dev, pm_message_t state);
  116. int rt2x00pci_resume(struct pci_dev *pci_dev);
  117. #else
  118. #define rt2x00pci_suspend NULL
  119. #define rt2x00pci_resume NULL
  120. #endif /* CONFIG_PM */
  121. #endif /* RT2X00PCI_H */