kernel/drivers/net/wireless/ath/carl9170/cmd.h

   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, 0, 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                                 sizeof(rx_filter), (u8 *)&rx_filter,
  70                                 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 */