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 | |
42 | #include "carl9170.h" |
43 | |
44 | /* basic HW access */ |
45 | int carl9170_write_reg(struct ar9170 *ar, const u32 reg, const u32 val); |
46 | int carl9170_read_reg(struct ar9170 *ar, const u32 reg, u32 *val); |
47 | int carl9170_read_mreg(struct ar9170 *ar, const int nregs, |
48 | const u32 *regs, u32 *out); |
49 | int carl9170_echo_test(struct ar9170 *ar, u32 v); |
50 | int carl9170_reboot(struct ar9170 *ar); |
51 | int carl9170_mac_reset(struct ar9170 *ar); |
52 | int carl9170_powersave(struct ar9170 *ar, const bool power_on); |
53 | int carl9170_collect_tally(struct ar9170 *ar); |
54 | int carl9170_bcn_ctrl(struct ar9170 *ar, const unsigned int vif_id, |
55 | const u32 mode, const u32 addr, const u32 len); |
56 | |
57 | static inline int carl9170_flush_cab(struct ar9170 *ar, |
58 | const unsigned int vif_id) |
59 | { |
60 | return carl9170_bcn_ctrl(ar, vif_id, CARL9170_BCN_CTRL_DRAIN, addr: 0, len: 0); |
61 | } |
62 | |
63 | static inline int carl9170_rx_filter(struct ar9170 *ar, |
64 | const unsigned int _rx_filter) |
65 | { |
66 | __le32 rx_filter = cpu_to_le32(_rx_filter); |
67 | |
68 | return carl9170_exec_cmd(ar, CARL9170_CMD_RX_FILTER, |
69 | plen: sizeof(rx_filter), payload: (u8 *)&rx_filter, |
70 | rlen: 0, NULL); |
71 | } |
72 | |
73 | struct carl9170_cmd *carl9170_cmd_buf(struct ar9170 *ar, |
74 | const enum carl9170_cmd_oids cmd, const unsigned int len); |
75 | |
76 | /* |
77 | * Macros to facilitate writing multiple registers in a single |
78 | * write-combining USB command. Note that when the first group |
79 | * fails the whole thing will fail without any others attempted, |
80 | * but you won't know which write in the group failed. |
81 | */ |
82 | #define carl9170_regwrite_begin(ar) \ |
83 | do { \ |
84 | int __nreg = 0, __err = 0; \ |
85 | struct ar9170 *__ar = ar; |
86 | |
87 | #define carl9170_regwrite(r, v) do { \ |
88 | __ar->cmd_buf[2 * __nreg + 1] = cpu_to_le32(r); \ |
89 | __ar->cmd_buf[2 * __nreg + 2] = cpu_to_le32(v); \ |
90 | __nreg++; \ |
91 | if ((__nreg >= PAYLOAD_MAX / 2)) { \ |
92 | if (IS_ACCEPTING_CMD(__ar)) \ |
93 | __err = carl9170_exec_cmd(__ar, \ |
94 | CARL9170_CMD_WREG, 8 * __nreg, \ |
95 | (u8 *) &__ar->cmd_buf[1], 0, NULL); \ |
96 | else \ |
97 | goto __regwrite_out; \ |
98 | \ |
99 | __nreg = 0; \ |
100 | if (__err) \ |
101 | goto __regwrite_out; \ |
102 | } \ |
103 | } while (0) |
104 | |
105 | #define carl9170_regwrite_finish() \ |
106 | __regwrite_out : \ |
107 | if (__err == 0 && __nreg) { \ |
108 | if (IS_ACCEPTING_CMD(__ar)) \ |
109 | __err = carl9170_exec_cmd(__ar, \ |
110 | CARL9170_CMD_WREG, 8 * __nreg, \ |
111 | (u8 *) &__ar->cmd_buf[1], 0, NULL); \ |
112 | __nreg = 0; \ |
113 | } |
114 | |
115 | #define carl9170_regwrite_result() \ |
116 | __err; \ |
117 | } while (0) |
118 | |
119 | |
120 | #define carl9170_async_regwrite_get_buf() \ |
121 | do { \ |
122 | __nreg = 0; \ |
123 | __cmd = carl9170_cmd_buf(__carl, CARL9170_CMD_WREG_ASYNC, \ |
124 | CARL9170_MAX_CMD_PAYLOAD_LEN); \ |
125 | if (__cmd == NULL) { \ |
126 | __err = -ENOMEM; \ |
127 | goto __async_regwrite_out; \ |
128 | } \ |
129 | } while (0) |
130 | |
131 | #define carl9170_async_regwrite_begin(carl) \ |
132 | do { \ |
133 | struct ar9170 *__carl = carl; \ |
134 | struct carl9170_cmd *__cmd; \ |
135 | unsigned int __nreg; \ |
136 | int __err = 0; \ |
137 | carl9170_async_regwrite_get_buf(); \ |
138 | |
139 | #define carl9170_async_regwrite_flush() \ |
140 | do { \ |
141 | if (__cmd == NULL || __nreg == 0) \ |
142 | break; \ |
143 | \ |
144 | if (IS_ACCEPTING_CMD(__carl) && __nreg) { \ |
145 | __cmd->hdr.len = 8 * __nreg; \ |
146 | __err = __carl9170_exec_cmd(__carl, __cmd, true); \ |
147 | __cmd = NULL; \ |
148 | break; \ |
149 | } \ |
150 | goto __async_regwrite_out; \ |
151 | } while (0) |
152 | |
153 | #define carl9170_async_regwrite(r, v) do { \ |
154 | if (__cmd == NULL) \ |
155 | carl9170_async_regwrite_get_buf(); \ |
156 | __cmd->wreg.regs[__nreg].addr = cpu_to_le32(r); \ |
157 | __cmd->wreg.regs[__nreg].val = cpu_to_le32(v); \ |
158 | __nreg++; \ |
159 | if ((__nreg >= PAYLOAD_MAX / 2)) \ |
160 | carl9170_async_regwrite_flush(); \ |
161 | } while (0) |
162 | |
163 | #define carl9170_async_regwrite_finish() do { \ |
164 | __async_regwrite_out: \ |
165 | if (__cmd != NULL && __err == 0) \ |
166 | carl9170_async_regwrite_flush(); \ |
167 | kfree(__cmd); \ |
168 | } while (0) \ |
169 | |
170 | #define carl9170_async_regwrite_result() \ |
171 | __err; \ |
172 | } while (0) |
173 | |
174 | #endif /* __CMD_H */ |
175 | |