cmd.h 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173
  1. /*
  2. * Atheros CARL9170 driver
  3. *
  4. * Basic HW register/memory/command access functions
  5. *
  6. * Copyright 2008, Johannes Berg <johannes@sipsolutions.net>
  7. * Copyright 2010, Christian Lamparter <chunkeey@googlemail.com>
  8. *
  9. * This program is free software; you can redistribute it and/or modify
  10. * it under the terms of the GNU General Public License as published by
  11. * the Free Software Foundation; either version 2 of the License, or
  12. * (at your option) any later version.
  13. *
  14. * This program is distributed in the hope that it will be useful,
  15. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17. * GNU General Public License for more details.
  18. *
  19. * You should have received a copy of the GNU General Public License
  20. * along with this program; see the file COPYING. If not, see
  21. * http://www.gnu.org/licenses/.
  22. *
  23. * This file incorporates work covered by the following copyright and
  24. * permission notice:
  25. * Copyright (c) 2007-2008 Atheros Communications, Inc.
  26. *
  27. * Permission to use, copy, modify, and/or distribute this software for any
  28. * purpose with or without fee is hereby granted, provided that the above
  29. * copyright notice and this permission notice appear in all copies.
  30. *
  31. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  32. * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  33. * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  34. * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  35. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  36. * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  37. * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  38. */
  39. #ifndef __CMD_H
  40. #define __CMD_H
  41. #include "carl9170.h"
  42. /* basic HW access */
  43. int carl9170_write_reg(struct ar9170 *ar, const u32 reg, const u32 val);
  44. int carl9170_read_reg(struct ar9170 *ar, const u32 reg, u32 *val);
  45. int carl9170_read_mreg(struct ar9170 *ar, const int nregs,
  46. const u32 *regs, u32 *out);
  47. int carl9170_echo_test(struct ar9170 *ar, u32 v);
  48. int carl9170_reboot(struct ar9170 *ar);
  49. int carl9170_mac_reset(struct ar9170 *ar);
  50. int carl9170_powersave(struct ar9170 *ar, const bool power_on);
  51. int carl9170_bcn_ctrl(struct ar9170 *ar, const unsigned int vif_id,
  52. const u32 mode, const u32 addr, const u32 len);
  53. static inline int carl9170_flush_cab(struct ar9170 *ar,
  54. const unsigned int vif_id)
  55. {
  56. return carl9170_bcn_ctrl(ar, vif_id, CARL9170_BCN_CTRL_DRAIN, 0, 0);
  57. }
  58. static inline int carl9170_rx_filter(struct ar9170 *ar,
  59. const unsigned int _rx_filter)
  60. {
  61. __le32 rx_filter = cpu_to_le32(_rx_filter);
  62. return carl9170_exec_cmd(ar, CARL9170_CMD_RX_FILTER,
  63. sizeof(rx_filter), (u8 *)&rx_filter,
  64. 0, NULL);
  65. }
  66. struct carl9170_cmd *carl9170_cmd_buf(struct ar9170 *ar,
  67. const enum carl9170_cmd_oids cmd, const unsigned int len);
  68. /*
  69. * Macros to facilitate writing multiple registers in a single
  70. * write-combining USB command. Note that when the first group
  71. * fails the whole thing will fail without any others attempted,
  72. * but you won't know which write in the group failed.
  73. */
  74. #define carl9170_regwrite_begin(ar) \
  75. do { \
  76. int __nreg = 0, __err = 0; \
  77. struct ar9170 *__ar = ar;
  78. #define carl9170_regwrite(r, v) do { \
  79. __ar->cmd_buf[2 * __nreg + 1] = cpu_to_le32(r); \
  80. __ar->cmd_buf[2 * __nreg + 2] = cpu_to_le32(v); \
  81. __nreg++; \
  82. if ((__nreg >= PAYLOAD_MAX/2)) { \
  83. if (IS_ACCEPTING_CMD(__ar)) \
  84. __err = carl9170_exec_cmd(__ar, \
  85. CARL9170_CMD_WREG, 8 * __nreg, \
  86. (u8 *) &__ar->cmd_buf[1], 0, NULL); \
  87. else \
  88. goto __regwrite_out; \
  89. \
  90. __nreg = 0; \
  91. if (__err) \
  92. goto __regwrite_out; \
  93. } \
  94. } while (0)
  95. #define carl9170_regwrite_finish() \
  96. __regwrite_out : \
  97. if (__err == 0 && __nreg) { \
  98. if (IS_ACCEPTING_CMD(__ar)) \
  99. __err = carl9170_exec_cmd(__ar, \
  100. CARL9170_CMD_WREG, 8 * __nreg, \
  101. (u8 *) &__ar->cmd_buf[1], 0, NULL); \
  102. __nreg = 0; \
  103. }
  104. #define carl9170_regwrite_result() \
  105. __err; \
  106. } while (0);
  107. #define carl9170_async_regwrite_get_buf() \
  108. do { \
  109. __nreg = 0; \
  110. __cmd = carl9170_cmd_buf(__carl, CARL9170_CMD_WREG_ASYNC, \
  111. CARL9170_MAX_CMD_PAYLOAD_LEN); \
  112. if (__cmd == NULL) { \
  113. __err = -ENOMEM; \
  114. goto __async_regwrite_out; \
  115. } \
  116. } while (0);
  117. #define carl9170_async_regwrite_begin(carl) \
  118. do { \
  119. struct ar9170 *__carl = carl; \
  120. struct carl9170_cmd *__cmd; \
  121. unsigned int __nreg; \
  122. int __err = 0; \
  123. carl9170_async_regwrite_get_buf(); \
  124. #define carl9170_async_regwrite_flush() \
  125. do { \
  126. if (__cmd == NULL || __nreg == 0) \
  127. break; \
  128. \
  129. if (IS_ACCEPTING_CMD(__carl) && __nreg) { \
  130. __cmd->hdr.len = 8 * __nreg; \
  131. __err = __carl9170_exec_cmd(__carl, __cmd, true); \
  132. __cmd = NULL; \
  133. break; \
  134. } \
  135. goto __async_regwrite_out; \
  136. } while (0)
  137. #define carl9170_async_regwrite(r, v) do { \
  138. if (__cmd == NULL) \
  139. carl9170_async_regwrite_get_buf(); \
  140. __cmd->wreg.regs[__nreg].addr = cpu_to_le32(r); \
  141. __cmd->wreg.regs[__nreg].val = cpu_to_le32(v); \
  142. __nreg++; \
  143. if ((__nreg >= PAYLOAD_MAX / 2)) \
  144. carl9170_async_regwrite_flush(); \
  145. } while (0)
  146. #define carl9170_async_regwrite_finish() do { \
  147. __async_regwrite_out : \
  148. if (__cmd != NULL && __err == 0) \
  149. carl9170_async_regwrite_flush(); \
  150. kfree(__cmd); \
  151. } while (0) \
  152. #define carl9170_async_regwrite_result() \
  153. __err; \
  154. } while (0);
  155. #endif /* __CMD_H */