2 * carl9170 firmware - used by the ar9170 wireless device
6 * Copyright (c) 2000-2005 ZyDAS Technology Corporation
7 * Copyright (c) 2007-2009 Atheros Communications, Inc.
8 * Copyright 2009 Johannes Berg <johannes@sipsolutions.net>
9 * Copyright 2009-2011 Christian Lamparter <chunkeey@googlemail.com>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License along
22 * with this program; if not, write to the Free Software Foundation, Inc.,
23 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
26 #ifndef __CARL9170FW_WLAN_H
27 #define __CARL9170FW_WLAN_H
35 static inline __inline void set_wlan_txq_dma_addr(const unsigned int q, const uint32_t v)
37 set(AR9170_MAC_REG_DMA_TXQ_ADDR + (q << 3), v);
40 static inline __inline void set_wlan_txq_dma_curr_addr(const unsigned int q, const uint32_t v)
42 set(AR9170_MAC_REG_DMA_TXQ_CURR_ADDR + (q << 3), v);
45 static inline __inline volatile struct dma_desc *get_wlan_txq_dma_addr(const unsigned int q)
47 return getp(AR9170_MAC_REG_DMA_TXQ_ADDR + (q << 3));
50 static inline __inline volatile struct dma_desc *get_wlan_txq_addr(const unsigned int q)
52 return getp(AR9170_MAC_REG_DMA_TXQ_CURR_ADDR + (q << 3));
55 static inline __inline volatile struct dma_desc *get_wlan_txq_last_addr(const unsigned int q)
57 return getp(AR9170_MAC_REG_DMA_TXQ_LAST_ADDR + (q << 2));
60 static inline __inline void wlan_trigger(const uint32_t queue_bit)
62 set(AR9170_MAC_REG_DMA_TRIGGER, queue_bit);
65 static inline __inline uint8_t ar9170_get_rx_macstatus_status(struct dma_desc *desc)
67 return *((uint8_t *) DESC_PAYLOAD_OFF(desc->lastAddr,
68 (unsigned int) desc->lastAddr->dataSize - 1));
71 static inline __inline uint8_t ar9170_get_rx_macstatus_error(struct dma_desc *desc)
75 if (desc->lastAddr->dataSize == 1) {
76 while (desc->lastAddr != desc->nextAddr)
77 desc = desc->nextAddr;
79 offset = (unsigned int) (desc->dataSize - 1);
81 desc = desc->lastAddr;
82 offset = desc->dataSize -
83 (sizeof(struct ar9170_rx_macstatus) -
84 offsetof(struct ar9170_rx_macstatus, error));
87 return *((uint8_t *) DESC_PAYLOAD_OFF(desc, offset));
90 static inline __inline struct ieee80211_hdr *ar9170_get_rx_i3e(struct dma_desc *desc)
92 if (!((ar9170_get_rx_macstatus_status(desc) &
93 AR9170_RX_STATUS_MPDU) & AR9170_RX_STATUS_MPDU_LAST)) {
94 return (void *)(DESC_PAYLOAD_OFF(desc,
95 offsetof(struct ar9170_rx_frame_head, i3e)));
97 return (void *)(DESC_PAYLOAD_OFF(desc,
98 offsetof(struct ar9170_rx_frame_tail, i3e)));
102 static inline __inline struct ar9170_rx_head *ar9170_get_rx_head(struct dma_desc *desc)
104 if (!((ar9170_get_rx_macstatus_status(desc) &
105 AR9170_RX_STATUS_MPDU) & AR9170_RX_STATUS_MPDU_LAST)) {
106 return (void *)((uint8_t *)DESC_PAYLOAD(desc) +
107 offsetof(struct ar9170_rx_frame_head, phy_head));
109 return (void *) NULL;
113 static inline __inline uint32_t ar9170_rx_to_phy(struct dma_desc *rx)
115 struct ar9170_tx_hw_phy_control phy;
116 struct ar9170_rx_head *head;
121 head = ar9170_get_rx_head(rx);
123 return le32_to_cpu(phy.set);
125 mac_status = ar9170_get_rx_macstatus_status(rx);
127 phy.modulation = mac_status & AR9170_RX_STATUS_MODULATION;
128 phy.chains = AR9170_TX_PHY_TXCHAIN_1;
130 switch (phy.modulation) {
131 case AR9170_RX_STATUS_MODULATION_CCK:
132 if (mac_status & AR9170_RX_STATUS_SHORT_PREAMBLE)
135 switch (head->plcp[0]) {
136 case AR9170_RX_PHY_RATE_CCK_2M:
137 phy.mcs = AR9170_TX_PHY_RATE_CCK_2M;
140 case AR9170_RX_PHY_RATE_CCK_5M:
141 phy.mcs = AR9170_TX_PHY_RATE_CCK_5M;
144 case AR9170_RX_PHY_RATE_CCK_11M:
145 phy.mcs = AR9170_TX_PHY_RATE_CCK_11M;
148 case AR9170_RX_PHY_RATE_CCK_1M:
150 phy.mcs = AR9170_TX_PHY_RATE_CCK_1M;
156 case AR9170_RX_STATUS_MODULATION_DUPOFDM:
157 case AR9170_RX_STATUS_MODULATION_OFDM:
158 phy.mcs = head->plcp[0] & 0xf;
161 case AR9170_RX_STATUS_MODULATION_HT:
162 if (head->plcp[3] & 0x80)
165 if (head->plcp[6] & 0x80)
168 /* TODO: Enable both chains for MCS > 7 */
169 phy.mcs = head->plcp[6] & 0x7;
173 return le32_to_cpu(phy.set);
176 static inline __inline unsigned int ar9170_get_rx_mpdu_len(struct dma_desc *desc)
179 * WARNING: you have to check the error bits in macstatus first!
182 unsigned int mpdu_len = desc->totalLen;
184 mpdu_len -= sizeof(struct ar9170_rx_macstatus);
186 switch (ar9170_get_rx_macstatus_status(desc) & AR9170_RX_STATUS_MPDU) {
187 case AR9170_RX_STATUS_MPDU_LAST:
188 mpdu_len -= sizeof(struct ar9170_rx_phystatus);
191 case AR9170_RX_STATUS_MPDU_SINGLE:
192 mpdu_len -= sizeof(struct ar9170_rx_phystatus);
194 case AR9170_RX_STATUS_MPDU_FIRST:
195 mpdu_len -= sizeof(struct ar9170_rx_head);
198 case AR9170_RX_STATUS_MPDU_MIDDLE:
206 static inline __inline bool ar9170_tx_length_check(const uint16_t len)
208 return len > (sizeof(struct carl9170_tx_superframe) + 24 +
212 static inline __inline struct carl9170_tx_superframe *get_super(struct dma_desc *desc)
214 return container_of(DESC_PAYLOAD(desc), struct carl9170_tx_superframe,
218 static inline __inline struct carl9170_tx_superframe *__get_super(struct dma_desc *desc)
220 return DESC_PAYLOAD(desc);
223 static inline __inline void hide_super(struct dma_desc *desc)
225 desc->dataAddr = (uint8_t *)
226 (((unsigned long)(DESC_PAYLOAD(desc)) +
227 offsetof(struct carl9170_tx_superframe, f)));
229 desc->dataSize -= sizeof(struct carl9170_tx_superdesc);
230 desc->totalLen -= sizeof(struct carl9170_tx_superdesc);
233 static inline __inline void unhide_super(struct dma_desc *desc)
235 desc->dataAddr = (uint8_t *) get_super(desc);
236 desc->dataSize += sizeof(struct carl9170_tx_superdesc);
237 desc->totalLen += sizeof(struct carl9170_tx_superdesc);
240 static inline __inline __hot void read_tsf(uint32_t *tsf)
243 * "According to the [hardware] documentation:
244 * > when TSF_LOW is read, TSF_HI is automatically concurrently
245 * > copied into a temporary register so that an immediate read
246 * > of TSF_HI will get the value that was present when TSF_LOW
249 * (David H. Lynch Jr. - mail from 2010-05-22)
250 * http://permalink.gmane.org/gmane.linux.kernel.wireless.general/51249
253 tsf[0] = get(AR9170_MAC_REG_TSF_L);
254 tsf[1] = get(AR9170_MAC_REG_TSF_H);
257 void wlan_tx(struct dma_desc *desc);
258 void wlan_timer(void);
259 void handle_wlan(void);
261 void wlan_cab_flush_queue(const unsigned int vif);
262 void wlan_modify_beacon(const unsigned int vif,
263 const unsigned int bcn_addr,
264 const unsigned int bcn_len);
266 void wlan_tx_complete(struct carl9170_tx_superframe *super, bool txs);
267 void wlan_prepare_wol(void);
269 static inline void __check_wlantx(void)
271 BUILD_BUG_ON(CARL9170_TX_SUPERDESC_LEN & 3);
272 BUILD_BUG_ON(sizeof(struct carl9170_tx_superdesc) != CARL9170_TX_SUPERDESC_LEN);
273 BUILD_BUG_ON(sizeof(struct _carl9170_tx_superdesc) != CARL9170_TX_SUPERDESC_LEN);
274 BUILD_BUG_ON(sizeof(struct _carl9170_tx_superframe) != CARL9170_TX_SUPERFRAME_LEN);
275 BUILD_BUG_ON((offsetof(struct carl9170_tx_superframe, f) & 3) != 0);
276 BUILD_BUG_ON(offsetof(struct _carl9170_tx_superframe, f) !=
277 (offsetof(struct _carl9170_tx_superframe, f)));
278 BUILD_BUG_ON(sizeof(struct ar9170_tx_hwdesc) != AR9170_TX_HWDESC_LEN);
279 BUILD_BUG_ON(sizeof(struct _ar9170_tx_hwdesc) != AR9170_TX_HWDESC_LEN);
280 BUILD_BUG_ON(sizeof(struct ar9170_rx_head) != AR9170_RX_HEAD_LEN);
281 BUILD_BUG_ON(sizeof(struct ar9170_rx_phystatus) != AR9170_RX_PHYSTATUS_LEN);
282 BUILD_BUG_ON(sizeof(struct ar9170_rx_macstatus) != AR9170_RX_MACSTATUS_LEN);
285 #endif /* __CARL9170FW_WLAN_H */