MAINTAINERS: Add phy-miphy28lp.c and phy-miphy365x.c to ARCH/STI architecture
[deliverable/linux.git] / drivers / net / wireless / iwlwifi / mvm / tx.c
1 /******************************************************************************
2 *
3 * This file is provided under a dual BSD/GPLv2 license. When using or
4 * redistributing this file, you may do so under either license.
5 *
6 * GPL LICENSE SUMMARY
7 *
8 * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
9 * Copyright(c) 2013 - 2014 Intel Mobile Communications GmbH
10 *
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of version 2 of the GNU General Public License as
13 * published by the Free Software Foundation.
14 *
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
23 * USA
24 *
25 * The full GNU General Public License is included in this distribution
26 * in the file called COPYING.
27 *
28 * Contact Information:
29 * Intel Linux Wireless <ilw@linux.intel.com>
30 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
31 *
32 * BSD LICENSE
33 *
34 * Copyright(c) 2012 - 2014 Intel Corporation. All rights reserved.
35 * Copyright(c) 2013 - 2014 Intel Mobile Communications GmbH
36 * All rights reserved.
37 *
38 * Redistribution and use in source and binary forms, with or without
39 * modification, are permitted provided that the following conditions
40 * are met:
41 *
42 * * Redistributions of source code must retain the above copyright
43 * notice, this list of conditions and the following disclaimer.
44 * * Redistributions in binary form must reproduce the above copyright
45 * notice, this list of conditions and the following disclaimer in
46 * the documentation and/or other materials provided with the
47 * distribution.
48 * * Neither the name Intel Corporation nor the names of its
49 * contributors may be used to endorse or promote products derived
50 * from this software without specific prior written permission.
51 *
52 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
53 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
54 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
55 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
56 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
57 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
58 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
59 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
60 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
61 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
62 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
63 *
64 *****************************************************************************/
65 #include <linux/ieee80211.h>
66 #include <linux/etherdevice.h>
67
68 #include "iwl-trans.h"
69 #include "iwl-eeprom-parse.h"
70 #include "mvm.h"
71 #include "sta.h"
72
73 /*
74 * Sets most of the Tx cmd's fields
75 */
76 void iwl_mvm_set_tx_cmd(struct iwl_mvm *mvm, struct sk_buff *skb,
77 struct iwl_tx_cmd *tx_cmd,
78 struct ieee80211_tx_info *info, u8 sta_id)
79 {
80 struct ieee80211_hdr *hdr = (void *)skb->data;
81 __le16 fc = hdr->frame_control;
82 u32 tx_flags = le32_to_cpu(tx_cmd->tx_flags);
83 u32 len = skb->len + FCS_LEN;
84 u8 ac;
85
86 if (!(info->flags & IEEE80211_TX_CTL_NO_ACK))
87 tx_flags |= TX_CMD_FLG_ACK;
88 else
89 tx_flags &= ~TX_CMD_FLG_ACK;
90
91 if (ieee80211_is_probe_resp(fc))
92 tx_flags |= TX_CMD_FLG_TSF;
93
94 if (ieee80211_has_morefrags(fc))
95 tx_flags |= TX_CMD_FLG_MORE_FRAG;
96
97 if (ieee80211_is_data_qos(fc)) {
98 u8 *qc = ieee80211_get_qos_ctl(hdr);
99 tx_cmd->tid_tspec = qc[0] & 0xf;
100 tx_flags &= ~TX_CMD_FLG_SEQ_CTL;
101 } else if (ieee80211_is_back_req(fc)) {
102 struct ieee80211_bar *bar = (void *)skb->data;
103 u16 control = le16_to_cpu(bar->control);
104
105 tx_flags |= TX_CMD_FLG_ACK | TX_CMD_FLG_BAR;
106 tx_cmd->tid_tspec = (control &
107 IEEE80211_BAR_CTRL_TID_INFO_MASK) >>
108 IEEE80211_BAR_CTRL_TID_INFO_SHIFT;
109 WARN_ON_ONCE(tx_cmd->tid_tspec >= IWL_MAX_TID_COUNT);
110 } else {
111 tx_cmd->tid_tspec = IWL_TID_NON_QOS;
112 if (info->flags & IEEE80211_TX_CTL_ASSIGN_SEQ)
113 tx_flags |= TX_CMD_FLG_SEQ_CTL;
114 else
115 tx_flags &= ~TX_CMD_FLG_SEQ_CTL;
116 }
117
118 /* Default to 0 (BE) when tid_spec is set to IWL_TID_NON_QOS */
119 if (tx_cmd->tid_tspec < IWL_MAX_TID_COUNT)
120 ac = tid_to_mac80211_ac[tx_cmd->tid_tspec];
121 else
122 ac = tid_to_mac80211_ac[0];
123
124 tx_flags |= iwl_mvm_bt_coex_tx_prio(mvm, hdr, info, ac) <<
125 TX_CMD_FLG_BT_PRIO_POS;
126
127 if (ieee80211_is_mgmt(fc)) {
128 if (ieee80211_is_assoc_req(fc) || ieee80211_is_reassoc_req(fc))
129 tx_cmd->pm_frame_timeout = cpu_to_le16(3);
130 else
131 tx_cmd->pm_frame_timeout = cpu_to_le16(2);
132
133 /* The spec allows Action frames in A-MPDU, we don't support
134 * it
135 */
136 WARN_ON_ONCE(info->flags & IEEE80211_TX_CTL_AMPDU);
137 } else if (info->control.flags & IEEE80211_TX_CTRL_PORT_CTRL_PROTO) {
138 tx_cmd->pm_frame_timeout = cpu_to_le16(2);
139 } else {
140 tx_cmd->pm_frame_timeout = 0;
141 }
142
143 if (ieee80211_is_data(fc) && len > mvm->rts_threshold &&
144 !is_multicast_ether_addr(ieee80211_get_DA(hdr)))
145 tx_flags |= TX_CMD_FLG_PROT_REQUIRE;
146
147 if ((mvm->fw->ucode_capa.capa[0] &
148 IWL_UCODE_TLV_CAPA_TXPOWER_INSERTION_SUPPORT) &&
149 ieee80211_action_contains_tpc(skb))
150 tx_flags |= TX_CMD_FLG_WRITE_TX_POWER;
151
152 tx_cmd->tx_flags = cpu_to_le32(tx_flags);
153 /* Total # bytes to be transmitted */
154 tx_cmd->len = cpu_to_le16((u16)skb->len);
155 tx_cmd->next_frame_len = 0;
156 tx_cmd->life_time = cpu_to_le32(TX_CMD_LIFE_TIME_INFINITE);
157 tx_cmd->sta_id = sta_id;
158 }
159
160 /*
161 * Sets the fields in the Tx cmd that are rate related
162 */
163 void iwl_mvm_set_tx_cmd_rate(struct iwl_mvm *mvm, struct iwl_tx_cmd *tx_cmd,
164 struct ieee80211_tx_info *info,
165 struct ieee80211_sta *sta, __le16 fc)
166 {
167 u32 rate_flags;
168 int rate_idx;
169 u8 rate_plcp;
170
171 /* Set retry limit on RTS packets */
172 tx_cmd->rts_retry_limit = IWL_RTS_DFAULT_RETRY_LIMIT;
173
174 /* Set retry limit on DATA packets and Probe Responses*/
175 if (ieee80211_is_probe_resp(fc)) {
176 tx_cmd->data_retry_limit = IWL_MGMT_DFAULT_RETRY_LIMIT;
177 tx_cmd->rts_retry_limit =
178 min(tx_cmd->data_retry_limit, tx_cmd->rts_retry_limit);
179 } else if (ieee80211_is_back_req(fc)) {
180 tx_cmd->data_retry_limit = IWL_BAR_DFAULT_RETRY_LIMIT;
181 } else {
182 tx_cmd->data_retry_limit = IWL_DEFAULT_TX_RETRY;
183 }
184
185 /*
186 * for data packets, rate info comes from the table inside the fw. This
187 * table is controlled by LINK_QUALITY commands
188 */
189
190 if (ieee80211_is_data(fc) && sta) {
191 tx_cmd->initial_rate_index = 0;
192 tx_cmd->tx_flags |= cpu_to_le32(TX_CMD_FLG_STA_RATE);
193 return;
194 } else if (ieee80211_is_back_req(fc)) {
195 tx_cmd->tx_flags |=
196 cpu_to_le32(TX_CMD_FLG_ACK | TX_CMD_FLG_BAR);
197 }
198
199 /* HT rate doesn't make sense for a non data frame */
200 WARN_ONCE(info->control.rates[0].flags & IEEE80211_TX_RC_MCS,
201 "Got an HT rate (flags:0x%x/mcs:%d) for a non data frame (fc:0x%x)\n",
202 info->control.rates[0].flags,
203 info->control.rates[0].idx,
204 le16_to_cpu(fc));
205
206 rate_idx = info->control.rates[0].idx;
207 /* if the rate isn't a well known legacy rate, take the lowest one */
208 if (rate_idx < 0 || rate_idx > IWL_RATE_COUNT_LEGACY)
209 rate_idx = rate_lowest_index(
210 &mvm->nvm_data->bands[info->band], sta);
211
212 /* For 5 GHZ band, remap mac80211 rate indices into driver indices */
213 if (info->band == IEEE80211_BAND_5GHZ)
214 rate_idx += IWL_FIRST_OFDM_RATE;
215
216 /* For 2.4 GHZ band, check that there is no need to remap */
217 BUILD_BUG_ON(IWL_FIRST_CCK_RATE != 0);
218
219 /* Get PLCP rate for tx_cmd->rate_n_flags */
220 rate_plcp = iwl_mvm_mac80211_idx_to_hwrate(rate_idx);
221
222 mvm->mgmt_last_antenna_idx =
223 iwl_mvm_next_antenna(mvm, iwl_mvm_get_valid_tx_ant(mvm),
224 mvm->mgmt_last_antenna_idx);
225
226 if (info->band == IEEE80211_BAND_2GHZ &&
227 !iwl_mvm_bt_coex_is_shared_ant_avail(mvm))
228 rate_flags = BIT(mvm->cfg->non_shared_ant) << RATE_MCS_ANT_POS;
229 else
230 rate_flags =
231 BIT(mvm->mgmt_last_antenna_idx) << RATE_MCS_ANT_POS;
232
233 /* Set CCK flag as needed */
234 if ((rate_idx >= IWL_FIRST_CCK_RATE) && (rate_idx <= IWL_LAST_CCK_RATE))
235 rate_flags |= RATE_MCS_CCK_MSK;
236
237 /* Set the rate in the TX cmd */
238 tx_cmd->rate_n_flags = cpu_to_le32((u32)rate_plcp | rate_flags);
239 }
240
241 /*
242 * Sets the fields in the Tx cmd that are crypto related
243 */
244 void iwl_mvm_set_tx_cmd_crypto(struct iwl_mvm *mvm,
245 struct ieee80211_tx_info *info,
246 struct iwl_tx_cmd *tx_cmd,
247 struct sk_buff *skb_frag)
248 {
249 struct ieee80211_key_conf *keyconf = info->control.hw_key;
250
251 switch (keyconf->cipher) {
252 case WLAN_CIPHER_SUITE_CCMP:
253 tx_cmd->sec_ctl = TX_CMD_SEC_CCM;
254 memcpy(tx_cmd->key, keyconf->key, keyconf->keylen);
255 if (info->flags & IEEE80211_TX_CTL_AMPDU)
256 tx_cmd->tx_flags |= cpu_to_le32(TX_CMD_FLG_CCMP_AGG);
257 break;
258
259 case WLAN_CIPHER_SUITE_TKIP:
260 tx_cmd->sec_ctl = TX_CMD_SEC_TKIP;
261 ieee80211_get_tkip_p2k(keyconf, skb_frag, tx_cmd->key);
262 break;
263
264 case WLAN_CIPHER_SUITE_WEP104:
265 tx_cmd->sec_ctl |= TX_CMD_SEC_KEY128;
266 /* fall through */
267 case WLAN_CIPHER_SUITE_WEP40:
268 tx_cmd->sec_ctl |= TX_CMD_SEC_WEP |
269 ((keyconf->keyidx << TX_CMD_SEC_WEP_KEY_IDX_POS) &
270 TX_CMD_SEC_WEP_KEY_IDX_MSK);
271
272 memcpy(&tx_cmd->key[3], keyconf->key, keyconf->keylen);
273 break;
274 default:
275 tx_cmd->sec_ctl |= TX_CMD_SEC_EXT;
276 }
277 }
278
279 /*
280 * Allocates and sets the Tx cmd the driver data pointers in the skb
281 */
282 static struct iwl_device_cmd *
283 iwl_mvm_set_tx_params(struct iwl_mvm *mvm, struct sk_buff *skb,
284 struct ieee80211_sta *sta, u8 sta_id)
285 {
286 struct ieee80211_hdr *hdr = (struct ieee80211_hdr *)skb->data;
287 struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
288 struct iwl_device_cmd *dev_cmd;
289 struct iwl_tx_cmd *tx_cmd;
290
291 dev_cmd = iwl_trans_alloc_tx_cmd(mvm->trans);
292
293 if (unlikely(!dev_cmd))
294 return NULL;
295
296 memset(dev_cmd, 0, sizeof(*dev_cmd));
297 dev_cmd->hdr.cmd = TX_CMD;
298 tx_cmd = (struct iwl_tx_cmd *)dev_cmd->payload;
299
300 if (info->control.hw_key)
301 iwl_mvm_set_tx_cmd_crypto(mvm, info, tx_cmd, skb);
302
303 iwl_mvm_set_tx_cmd(mvm, skb, tx_cmd, info, sta_id);
304
305 iwl_mvm_set_tx_cmd_rate(mvm, tx_cmd, info, sta, hdr->frame_control);
306
307 memset(&info->status, 0, sizeof(info->status));
308
309 info->driver_data[0] = NULL;
310 info->driver_data[1] = dev_cmd;
311
312 return dev_cmd;
313 }
314
315 int iwl_mvm_tx_skb_non_sta(struct iwl_mvm *mvm, struct sk_buff *skb)
316 {
317 struct ieee80211_hdr *hdr = (struct ieee80211_hdr *)skb->data;
318 struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
319 struct iwl_device_cmd *dev_cmd;
320 struct iwl_tx_cmd *tx_cmd;
321 u8 sta_id;
322
323 if (WARN_ON_ONCE(info->flags & IEEE80211_TX_CTL_AMPDU))
324 return -1;
325
326 if (WARN_ON_ONCE(info->flags & IEEE80211_TX_CTL_SEND_AFTER_DTIM &&
327 (!info->control.vif ||
328 info->hw_queue != info->control.vif->cab_queue)))
329 return -1;
330
331 /*
332 * IWL_MVM_OFFCHANNEL_QUEUE is used for ROC packets that can be used
333 * in 2 different types of vifs, P2P & STATION. P2P uses the offchannel
334 * queue. STATION (HS2.0) uses the auxiliary context of the FW,
335 * and hence needs to be sent on the aux queue
336 */
337 if (IEEE80211_SKB_CB(skb)->hw_queue == IWL_MVM_OFFCHANNEL_QUEUE &&
338 info->control.vif->type == NL80211_IFTYPE_STATION)
339 IEEE80211_SKB_CB(skb)->hw_queue = mvm->aux_queue;
340
341 /*
342 * If the interface on which frame is sent is the P2P_DEVICE
343 * or an AP/GO interface use the broadcast station associated
344 * with it; otherwise use the AUX station.
345 */
346 if (info->control.vif &&
347 (info->control.vif->type == NL80211_IFTYPE_P2P_DEVICE ||
348 info->control.vif->type == NL80211_IFTYPE_AP)) {
349 struct iwl_mvm_vif *mvmvif =
350 iwl_mvm_vif_from_mac80211(info->control.vif);
351 sta_id = mvmvif->bcast_sta.sta_id;
352 } else {
353 sta_id = mvm->aux_sta.sta_id;
354 }
355
356 IWL_DEBUG_TX(mvm, "station Id %d, queue=%d\n", sta_id, info->hw_queue);
357
358 dev_cmd = iwl_mvm_set_tx_params(mvm, skb, NULL, sta_id);
359 if (!dev_cmd)
360 return -1;
361
362 /* From now on, we cannot access info->control */
363 tx_cmd = (struct iwl_tx_cmd *)dev_cmd->payload;
364
365 /* Copy MAC header from skb into command buffer */
366 memcpy(tx_cmd->hdr, hdr, ieee80211_hdrlen(hdr->frame_control));
367
368 if (iwl_trans_tx(mvm->trans, skb, dev_cmd, info->hw_queue)) {
369 iwl_trans_free_tx_cmd(mvm->trans, dev_cmd);
370 return -1;
371 }
372
373 return 0;
374 }
375
376 /*
377 * Sets the fields in the Tx cmd that are crypto related
378 */
379 int iwl_mvm_tx_skb(struct iwl_mvm *mvm, struct sk_buff *skb,
380 struct ieee80211_sta *sta)
381 {
382 struct ieee80211_hdr *hdr = (struct ieee80211_hdr *)skb->data;
383 struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
384 struct iwl_mvm_sta *mvmsta;
385 struct iwl_device_cmd *dev_cmd;
386 struct iwl_tx_cmd *tx_cmd;
387 __le16 fc;
388 u16 seq_number = 0;
389 u8 tid = IWL_MAX_TID_COUNT;
390 u8 txq_id = info->hw_queue;
391 bool is_data_qos = false, is_ampdu = false;
392
393 mvmsta = iwl_mvm_sta_from_mac80211(sta);
394 fc = hdr->frame_control;
395
396 if (WARN_ON_ONCE(!mvmsta))
397 return -1;
398
399 if (WARN_ON_ONCE(mvmsta->sta_id == IWL_MVM_STATION_COUNT))
400 return -1;
401
402 dev_cmd = iwl_mvm_set_tx_params(mvm, skb, sta, mvmsta->sta_id);
403 if (!dev_cmd)
404 goto drop;
405
406 tx_cmd = (struct iwl_tx_cmd *)dev_cmd->payload;
407 /* From now on, we cannot access info->control */
408
409 /*
410 * we handle that entirely ourselves -- for uAPSD the firmware
411 * will always send a notification, and for PS-Poll responses
412 * we'll notify mac80211 when getting frame status
413 */
414 info->flags &= ~IEEE80211_TX_STATUS_EOSP;
415
416 spin_lock(&mvmsta->lock);
417
418 if (ieee80211_is_data_qos(fc) && !ieee80211_is_qos_nullfunc(fc)) {
419 u8 *qc = NULL;
420 qc = ieee80211_get_qos_ctl(hdr);
421 tid = qc[0] & IEEE80211_QOS_CTL_TID_MASK;
422 if (WARN_ON_ONCE(tid >= IWL_MAX_TID_COUNT))
423 goto drop_unlock_sta;
424
425 seq_number = mvmsta->tid_data[tid].seq_number;
426 seq_number &= IEEE80211_SCTL_SEQ;
427 hdr->seq_ctrl &= cpu_to_le16(IEEE80211_SCTL_FRAG);
428 hdr->seq_ctrl |= cpu_to_le16(seq_number);
429 is_data_qos = true;
430 is_ampdu = info->flags & IEEE80211_TX_CTL_AMPDU;
431 }
432
433 /* Copy MAC header from skb into command buffer */
434 memcpy(tx_cmd->hdr, hdr, ieee80211_hdrlen(fc));
435
436 WARN_ON_ONCE(info->flags & IEEE80211_TX_CTL_SEND_AFTER_DTIM);
437
438 if (sta->tdls) {
439 /* default to TID 0 for non-QoS packets */
440 u8 tdls_tid = tid == IWL_MAX_TID_COUNT ? 0 : tid;
441
442 txq_id = mvmsta->hw_queue[tid_to_mac80211_ac[tdls_tid]];
443 }
444
445 if (is_ampdu) {
446 if (WARN_ON_ONCE(mvmsta->tid_data[tid].state != IWL_AGG_ON))
447 goto drop_unlock_sta;
448 txq_id = mvmsta->tid_data[tid].txq_id;
449 }
450
451 IWL_DEBUG_TX(mvm, "TX to [%d|%d] Q:%d - seq: 0x%x\n", mvmsta->sta_id,
452 tid, txq_id, IEEE80211_SEQ_TO_SN(seq_number));
453
454 if (iwl_trans_tx(mvm->trans, skb, dev_cmd, txq_id))
455 goto drop_unlock_sta;
456
457 if (is_data_qos && !ieee80211_has_morefrags(fc))
458 mvmsta->tid_data[tid].seq_number = seq_number + 0x10;
459
460 spin_unlock(&mvmsta->lock);
461
462 if (txq_id < mvm->first_agg_queue)
463 atomic_inc(&mvm->pending_frames[mvmsta->sta_id]);
464
465 return 0;
466
467 drop_unlock_sta:
468 iwl_trans_free_tx_cmd(mvm->trans, dev_cmd);
469 spin_unlock(&mvmsta->lock);
470 drop:
471 return -1;
472 }
473
474 static void iwl_mvm_check_ratid_empty(struct iwl_mvm *mvm,
475 struct ieee80211_sta *sta, u8 tid)
476 {
477 struct iwl_mvm_sta *mvmsta = iwl_mvm_sta_from_mac80211(sta);
478 struct iwl_mvm_tid_data *tid_data = &mvmsta->tid_data[tid];
479 struct ieee80211_vif *vif = mvmsta->vif;
480
481 lockdep_assert_held(&mvmsta->lock);
482
483 if ((tid_data->state == IWL_AGG_ON ||
484 tid_data->state == IWL_EMPTYING_HW_QUEUE_DELBA) &&
485 iwl_mvm_tid_queued(tid_data) == 0) {
486 /*
487 * Now that this aggregation queue is empty tell mac80211 so it
488 * knows we no longer have frames buffered for the station on
489 * this TID (for the TIM bitmap calculation.)
490 */
491 ieee80211_sta_set_buffered(sta, tid, false);
492 }
493
494 if (tid_data->ssn != tid_data->next_reclaimed)
495 return;
496
497 switch (tid_data->state) {
498 case IWL_EMPTYING_HW_QUEUE_ADDBA:
499 IWL_DEBUG_TX_QUEUES(mvm,
500 "Can continue addBA flow ssn = next_recl = %d\n",
501 tid_data->next_reclaimed);
502 tid_data->state = IWL_AGG_STARTING;
503 ieee80211_start_tx_ba_cb_irqsafe(vif, sta->addr, tid);
504 break;
505
506 case IWL_EMPTYING_HW_QUEUE_DELBA:
507 IWL_DEBUG_TX_QUEUES(mvm,
508 "Can continue DELBA flow ssn = next_recl = %d\n",
509 tid_data->next_reclaimed);
510 iwl_mvm_disable_txq(mvm, tid_data->txq_id, CMD_ASYNC);
511 tid_data->state = IWL_AGG_OFF;
512 /*
513 * we can't hold the mutex - but since we are after a sequence
514 * point (call to iwl_mvm_disable_txq(), so we don't even need
515 * a memory barrier.
516 */
517 mvm->queue_to_mac80211[tid_data->txq_id] =
518 IWL_INVALID_MAC80211_QUEUE;
519 ieee80211_stop_tx_ba_cb_irqsafe(vif, sta->addr, tid);
520 break;
521
522 default:
523 break;
524 }
525 }
526
527 #ifdef CONFIG_IWLWIFI_DEBUG
528 const char *iwl_mvm_get_tx_fail_reason(u32 status)
529 {
530 #define TX_STATUS_FAIL(x) case TX_STATUS_FAIL_ ## x: return #x
531 #define TX_STATUS_POSTPONE(x) case TX_STATUS_POSTPONE_ ## x: return #x
532
533 switch (status & TX_STATUS_MSK) {
534 case TX_STATUS_SUCCESS:
535 return "SUCCESS";
536 TX_STATUS_POSTPONE(DELAY);
537 TX_STATUS_POSTPONE(FEW_BYTES);
538 TX_STATUS_POSTPONE(BT_PRIO);
539 TX_STATUS_POSTPONE(QUIET_PERIOD);
540 TX_STATUS_POSTPONE(CALC_TTAK);
541 TX_STATUS_FAIL(INTERNAL_CROSSED_RETRY);
542 TX_STATUS_FAIL(SHORT_LIMIT);
543 TX_STATUS_FAIL(LONG_LIMIT);
544 TX_STATUS_FAIL(UNDERRUN);
545 TX_STATUS_FAIL(DRAIN_FLOW);
546 TX_STATUS_FAIL(RFKILL_FLUSH);
547 TX_STATUS_FAIL(LIFE_EXPIRE);
548 TX_STATUS_FAIL(DEST_PS);
549 TX_STATUS_FAIL(HOST_ABORTED);
550 TX_STATUS_FAIL(BT_RETRY);
551 TX_STATUS_FAIL(STA_INVALID);
552 TX_STATUS_FAIL(FRAG_DROPPED);
553 TX_STATUS_FAIL(TID_DISABLE);
554 TX_STATUS_FAIL(FIFO_FLUSHED);
555 TX_STATUS_FAIL(SMALL_CF_POLL);
556 TX_STATUS_FAIL(FW_DROP);
557 TX_STATUS_FAIL(STA_COLOR_MISMATCH);
558 }
559
560 return "UNKNOWN";
561
562 #undef TX_STATUS_FAIL
563 #undef TX_STATUS_POSTPONE
564 }
565 #endif /* CONFIG_IWLWIFI_DEBUG */
566
567 void iwl_mvm_hwrate_to_tx_rate(u32 rate_n_flags,
568 enum ieee80211_band band,
569 struct ieee80211_tx_rate *r)
570 {
571 if (rate_n_flags & RATE_HT_MCS_GF_MSK)
572 r->flags |= IEEE80211_TX_RC_GREEN_FIELD;
573 switch (rate_n_flags & RATE_MCS_CHAN_WIDTH_MSK) {
574 case RATE_MCS_CHAN_WIDTH_20:
575 break;
576 case RATE_MCS_CHAN_WIDTH_40:
577 r->flags |= IEEE80211_TX_RC_40_MHZ_WIDTH;
578 break;
579 case RATE_MCS_CHAN_WIDTH_80:
580 r->flags |= IEEE80211_TX_RC_80_MHZ_WIDTH;
581 break;
582 case RATE_MCS_CHAN_WIDTH_160:
583 r->flags |= IEEE80211_TX_RC_160_MHZ_WIDTH;
584 break;
585 }
586 if (rate_n_flags & RATE_MCS_SGI_MSK)
587 r->flags |= IEEE80211_TX_RC_SHORT_GI;
588 if (rate_n_flags & RATE_MCS_HT_MSK) {
589 r->flags |= IEEE80211_TX_RC_MCS;
590 r->idx = rate_n_flags & RATE_HT_MCS_INDEX_MSK;
591 } else if (rate_n_flags & RATE_MCS_VHT_MSK) {
592 ieee80211_rate_set_vht(
593 r, rate_n_flags & RATE_VHT_MCS_RATE_CODE_MSK,
594 ((rate_n_flags & RATE_VHT_MCS_NSS_MSK) >>
595 RATE_VHT_MCS_NSS_POS) + 1);
596 r->flags |= IEEE80211_TX_RC_VHT_MCS;
597 } else {
598 r->idx = iwl_mvm_legacy_rate_to_mac80211_idx(rate_n_flags,
599 band);
600 }
601 }
602
603 /**
604 * translate ucode response to mac80211 tx status control values
605 */
606 static void iwl_mvm_hwrate_to_tx_status(u32 rate_n_flags,
607 struct ieee80211_tx_info *info)
608 {
609 struct ieee80211_tx_rate *r = &info->status.rates[0];
610
611 info->status.antenna =
612 ((rate_n_flags & RATE_MCS_ANT_ABC_MSK) >> RATE_MCS_ANT_POS);
613 iwl_mvm_hwrate_to_tx_rate(rate_n_flags, info->band, r);
614 }
615
616 static void iwl_mvm_rx_tx_cmd_single(struct iwl_mvm *mvm,
617 struct iwl_rx_packet *pkt)
618 {
619 struct ieee80211_sta *sta;
620 u16 sequence = le16_to_cpu(pkt->hdr.sequence);
621 int txq_id = SEQ_TO_QUEUE(sequence);
622 struct iwl_mvm_tx_resp *tx_resp = (void *)pkt->data;
623 int sta_id = IWL_MVM_TX_RES_GET_RA(tx_resp->ra_tid);
624 int tid = IWL_MVM_TX_RES_GET_TID(tx_resp->ra_tid);
625 u32 status = le16_to_cpu(tx_resp->status.status);
626 u16 ssn = iwl_mvm_get_scd_ssn(tx_resp);
627 struct iwl_mvm_sta *mvmsta;
628 struct sk_buff_head skbs;
629 u8 skb_freed = 0;
630 u16 next_reclaimed, seq_ctl;
631
632 __skb_queue_head_init(&skbs);
633
634 seq_ctl = le16_to_cpu(tx_resp->seq_ctl);
635
636 /* we can free until ssn % q.n_bd not inclusive */
637 iwl_trans_reclaim(mvm->trans, txq_id, ssn, &skbs);
638
639 while (!skb_queue_empty(&skbs)) {
640 struct sk_buff *skb = __skb_dequeue(&skbs);
641 struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
642
643 skb_freed++;
644
645 iwl_trans_free_tx_cmd(mvm->trans, info->driver_data[1]);
646
647 memset(&info->status, 0, sizeof(info->status));
648
649 info->flags &= ~IEEE80211_TX_CTL_AMPDU;
650
651 /* inform mac80211 about what happened with the frame */
652 switch (status & TX_STATUS_MSK) {
653 case TX_STATUS_SUCCESS:
654 case TX_STATUS_DIRECT_DONE:
655 info->flags |= IEEE80211_TX_STAT_ACK;
656 break;
657 case TX_STATUS_FAIL_DEST_PS:
658 info->flags |= IEEE80211_TX_STAT_TX_FILTERED;
659 break;
660 default:
661 break;
662 }
663
664 info->status.rates[0].count = tx_resp->failure_frame + 1;
665 iwl_mvm_hwrate_to_tx_status(le32_to_cpu(tx_resp->initial_rate),
666 info);
667
668 /* Single frame failure in an AMPDU queue => send BAR */
669 if (txq_id >= mvm->first_agg_queue &&
670 !(info->flags & IEEE80211_TX_STAT_ACK) &&
671 !(info->flags & IEEE80211_TX_STAT_TX_FILTERED))
672 info->flags |= IEEE80211_TX_STAT_AMPDU_NO_BACK;
673
674 /* W/A FW bug: seq_ctl is wrong when the status isn't success */
675 if (status != TX_STATUS_SUCCESS) {
676 struct ieee80211_hdr *hdr = (void *)skb->data;
677 seq_ctl = le16_to_cpu(hdr->seq_ctrl);
678 }
679
680 /*
681 * TODO: this is not accurate if we are freeing more than one
682 * packet.
683 */
684 info->status.tx_time =
685 le16_to_cpu(tx_resp->wireless_media_time);
686 BUILD_BUG_ON(ARRAY_SIZE(info->status.status_driver_data) < 1);
687 info->status.status_driver_data[0] =
688 (void *)(uintptr_t)tx_resp->reduced_tpc;
689
690 ieee80211_tx_status(mvm->hw, skb);
691 }
692
693 if (txq_id >= mvm->first_agg_queue) {
694 /* If this is an aggregation queue, we use the ssn since:
695 * ssn = wifi seq_num % 256.
696 * The seq_ctl is the sequence control of the packet to which
697 * this Tx response relates. But if there is a hole in the
698 * bitmap of the BA we received, this Tx response may allow to
699 * reclaim the hole and all the subsequent packets that were
700 * already acked. In that case, seq_ctl != ssn, and the next
701 * packet to be reclaimed will be ssn and not seq_ctl. In that
702 * case, several packets will be reclaimed even if
703 * frame_count = 1.
704 *
705 * The ssn is the index (% 256) of the latest packet that has
706 * treated (acked / dropped) + 1.
707 */
708 next_reclaimed = ssn;
709 } else {
710 /* The next packet to be reclaimed is the one after this one */
711 next_reclaimed = IEEE80211_SEQ_TO_SN(seq_ctl + 0x10);
712 }
713
714 IWL_DEBUG_TX_REPLY(mvm,
715 "TXQ %d status %s (0x%08x)\n",
716 txq_id, iwl_mvm_get_tx_fail_reason(status), status);
717
718 IWL_DEBUG_TX_REPLY(mvm,
719 "\t\t\t\tinitial_rate 0x%x retries %d, idx=%d ssn=%d next_reclaimed=0x%x seq_ctl=0x%x\n",
720 le32_to_cpu(tx_resp->initial_rate),
721 tx_resp->failure_frame, SEQ_TO_INDEX(sequence),
722 ssn, next_reclaimed, seq_ctl);
723
724 rcu_read_lock();
725
726 sta = rcu_dereference(mvm->fw_id_to_mac_id[sta_id]);
727 /*
728 * sta can't be NULL otherwise it'd mean that the sta has been freed in
729 * the firmware while we still have packets for it in the Tx queues.
730 */
731 if (WARN_ON_ONCE(!sta))
732 goto out;
733
734 if (!IS_ERR(sta)) {
735 mvmsta = iwl_mvm_sta_from_mac80211(sta);
736
737 if (tid != IWL_TID_NON_QOS) {
738 struct iwl_mvm_tid_data *tid_data =
739 &mvmsta->tid_data[tid];
740
741 spin_lock_bh(&mvmsta->lock);
742 tid_data->next_reclaimed = next_reclaimed;
743 IWL_DEBUG_TX_REPLY(mvm, "Next reclaimed packet:%d\n",
744 next_reclaimed);
745 iwl_mvm_check_ratid_empty(mvm, sta, tid);
746 spin_unlock_bh(&mvmsta->lock);
747 }
748
749 if (mvmsta->next_status_eosp) {
750 mvmsta->next_status_eosp = false;
751 ieee80211_sta_eosp(sta);
752 }
753 } else {
754 mvmsta = NULL;
755 }
756
757 /*
758 * If the txq is not an AMPDU queue, there is no chance we freed
759 * several skbs. Check that out...
760 */
761 if (txq_id >= mvm->first_agg_queue)
762 goto out;
763
764 /* We can't free more than one frame at once on a shared queue */
765 WARN_ON(skb_freed > 1);
766
767 /* If we have still frames for this STA nothing to do here */
768 if (!atomic_sub_and_test(skb_freed, &mvm->pending_frames[sta_id]))
769 goto out;
770
771 if (mvmsta && mvmsta->vif->type == NL80211_IFTYPE_AP) {
772
773 /*
774 * If there are no pending frames for this STA and
775 * the tx to this station is not disabled, notify
776 * mac80211 that this station can now wake up in its
777 * STA table.
778 * If mvmsta is not NULL, sta is valid.
779 */
780
781 spin_lock_bh(&mvmsta->lock);
782
783 if (!mvmsta->disable_tx)
784 ieee80211_sta_block_awake(mvm->hw, sta, false);
785
786 spin_unlock_bh(&mvmsta->lock);
787 }
788
789 if (PTR_ERR(sta) == -EBUSY || PTR_ERR(sta) == -ENOENT) {
790 /*
791 * We are draining and this was the last packet - pre_rcu_remove
792 * has been called already. We might be after the
793 * synchronize_net already.
794 * Don't rely on iwl_mvm_rm_sta to see the empty Tx queues.
795 */
796 set_bit(sta_id, mvm->sta_drained);
797 schedule_work(&mvm->sta_drained_wk);
798 }
799
800 out:
801 rcu_read_unlock();
802 }
803
804 #ifdef CONFIG_IWLWIFI_DEBUG
805 #define AGG_TX_STATE_(x) case AGG_TX_STATE_ ## x: return #x
806 static const char *iwl_get_agg_tx_status(u16 status)
807 {
808 switch (status & AGG_TX_STATE_STATUS_MSK) {
809 AGG_TX_STATE_(TRANSMITTED);
810 AGG_TX_STATE_(UNDERRUN);
811 AGG_TX_STATE_(BT_PRIO);
812 AGG_TX_STATE_(FEW_BYTES);
813 AGG_TX_STATE_(ABORT);
814 AGG_TX_STATE_(LAST_SENT_TTL);
815 AGG_TX_STATE_(LAST_SENT_TRY_CNT);
816 AGG_TX_STATE_(LAST_SENT_BT_KILL);
817 AGG_TX_STATE_(SCD_QUERY);
818 AGG_TX_STATE_(TEST_BAD_CRC32);
819 AGG_TX_STATE_(RESPONSE);
820 AGG_TX_STATE_(DUMP_TX);
821 AGG_TX_STATE_(DELAY_TX);
822 }
823
824 return "UNKNOWN";
825 }
826
827 static void iwl_mvm_rx_tx_cmd_agg_dbg(struct iwl_mvm *mvm,
828 struct iwl_rx_packet *pkt)
829 {
830 struct iwl_mvm_tx_resp *tx_resp = (void *)pkt->data;
831 struct agg_tx_status *frame_status = &tx_resp->status;
832 int i;
833
834 for (i = 0; i < tx_resp->frame_count; i++) {
835 u16 fstatus = le16_to_cpu(frame_status[i].status);
836
837 IWL_DEBUG_TX_REPLY(mvm,
838 "status %s (0x%04x), try-count (%d) seq (0x%x)\n",
839 iwl_get_agg_tx_status(fstatus),
840 fstatus & AGG_TX_STATE_STATUS_MSK,
841 (fstatus & AGG_TX_STATE_TRY_CNT_MSK) >>
842 AGG_TX_STATE_TRY_CNT_POS,
843 le16_to_cpu(frame_status[i].sequence));
844 }
845 }
846 #else
847 static void iwl_mvm_rx_tx_cmd_agg_dbg(struct iwl_mvm *mvm,
848 struct iwl_rx_packet *pkt)
849 {}
850 #endif /* CONFIG_IWLWIFI_DEBUG */
851
852 static void iwl_mvm_rx_tx_cmd_agg(struct iwl_mvm *mvm,
853 struct iwl_rx_packet *pkt)
854 {
855 struct iwl_mvm_tx_resp *tx_resp = (void *)pkt->data;
856 int sta_id = IWL_MVM_TX_RES_GET_RA(tx_resp->ra_tid);
857 int tid = IWL_MVM_TX_RES_GET_TID(tx_resp->ra_tid);
858 u16 sequence = le16_to_cpu(pkt->hdr.sequence);
859 struct ieee80211_sta *sta;
860
861 if (WARN_ON_ONCE(SEQ_TO_QUEUE(sequence) < mvm->first_agg_queue))
862 return;
863
864 if (WARN_ON_ONCE(tid == IWL_TID_NON_QOS))
865 return;
866
867 iwl_mvm_rx_tx_cmd_agg_dbg(mvm, pkt);
868
869 rcu_read_lock();
870
871 sta = rcu_dereference(mvm->fw_id_to_mac_id[sta_id]);
872
873 if (!WARN_ON_ONCE(IS_ERR_OR_NULL(sta))) {
874 struct iwl_mvm_sta *mvmsta = iwl_mvm_sta_from_mac80211(sta);
875 mvmsta->tid_data[tid].rate_n_flags =
876 le32_to_cpu(tx_resp->initial_rate);
877 mvmsta->tid_data[tid].reduced_tpc = tx_resp->reduced_tpc;
878 mvmsta->tid_data[tid].tx_time =
879 le16_to_cpu(tx_resp->wireless_media_time);
880 }
881
882 rcu_read_unlock();
883 }
884
885 int iwl_mvm_rx_tx_cmd(struct iwl_mvm *mvm, struct iwl_rx_cmd_buffer *rxb,
886 struct iwl_device_cmd *cmd)
887 {
888 struct iwl_rx_packet *pkt = rxb_addr(rxb);
889 struct iwl_mvm_tx_resp *tx_resp = (void *)pkt->data;
890
891 if (tx_resp->frame_count == 1)
892 iwl_mvm_rx_tx_cmd_single(mvm, pkt);
893 else
894 iwl_mvm_rx_tx_cmd_agg(mvm, pkt);
895
896 return 0;
897 }
898
899 static void iwl_mvm_tx_info_from_ba_notif(struct ieee80211_tx_info *info,
900 struct iwl_mvm_ba_notif *ba_notif,
901 struct iwl_mvm_tid_data *tid_data)
902 {
903 info->flags |= IEEE80211_TX_STAT_AMPDU;
904 info->status.ampdu_ack_len = ba_notif->txed_2_done;
905 info->status.ampdu_len = ba_notif->txed;
906 iwl_mvm_hwrate_to_tx_status(tid_data->rate_n_flags,
907 info);
908 /* TODO: not accounted if the whole A-MPDU failed */
909 info->status.tx_time = tid_data->tx_time;
910 info->status.status_driver_data[0] =
911 (void *)(uintptr_t)tid_data->reduced_tpc;
912 }
913
914 int iwl_mvm_rx_ba_notif(struct iwl_mvm *mvm, struct iwl_rx_cmd_buffer *rxb,
915 struct iwl_device_cmd *cmd)
916 {
917 struct iwl_rx_packet *pkt = rxb_addr(rxb);
918 struct iwl_mvm_ba_notif *ba_notif = (void *)pkt->data;
919 struct sk_buff_head reclaimed_skbs;
920 struct iwl_mvm_tid_data *tid_data;
921 struct ieee80211_sta *sta;
922 struct iwl_mvm_sta *mvmsta;
923 struct sk_buff *skb;
924 int sta_id, tid, freed;
925 /* "flow" corresponds to Tx queue */
926 u16 scd_flow = le16_to_cpu(ba_notif->scd_flow);
927 /* "ssn" is start of block-ack Tx window, corresponds to index
928 * (in Tx queue's circular buffer) of first TFD/frame in window */
929 u16 ba_resp_scd_ssn = le16_to_cpu(ba_notif->scd_ssn);
930
931 sta_id = ba_notif->sta_id;
932 tid = ba_notif->tid;
933
934 if (WARN_ONCE(sta_id >= IWL_MVM_STATION_COUNT ||
935 tid >= IWL_MAX_TID_COUNT,
936 "sta_id %d tid %d", sta_id, tid))
937 return 0;
938
939 rcu_read_lock();
940
941 sta = rcu_dereference(mvm->fw_id_to_mac_id[sta_id]);
942
943 /* Reclaiming frames for a station that has been deleted ? */
944 if (WARN_ON_ONCE(IS_ERR_OR_NULL(sta))) {
945 rcu_read_unlock();
946 return 0;
947 }
948
949 mvmsta = iwl_mvm_sta_from_mac80211(sta);
950 tid_data = &mvmsta->tid_data[tid];
951
952 if (WARN_ONCE(tid_data->txq_id != scd_flow, "Q %d, tid %d, flow %d",
953 tid_data->txq_id, tid, scd_flow)) {
954 rcu_read_unlock();
955 return 0;
956 }
957
958 spin_lock_bh(&mvmsta->lock);
959
960 __skb_queue_head_init(&reclaimed_skbs);
961
962 /*
963 * Release all TFDs before the SSN, i.e. all TFDs in front of
964 * block-ack window (we assume that they've been successfully
965 * transmitted ... if not, it's too late anyway).
966 */
967 iwl_trans_reclaim(mvm->trans, scd_flow, ba_resp_scd_ssn,
968 &reclaimed_skbs);
969
970 IWL_DEBUG_TX_REPLY(mvm,
971 "BA_NOTIFICATION Received from %pM, sta_id = %d\n",
972 (u8 *)&ba_notif->sta_addr_lo32,
973 ba_notif->sta_id);
974 IWL_DEBUG_TX_REPLY(mvm,
975 "TID = %d, SeqCtl = %d, bitmap = 0x%llx, scd_flow = %d, scd_ssn = %d sent:%d, acked:%d\n",
976 ba_notif->tid, le16_to_cpu(ba_notif->seq_ctl),
977 (unsigned long long)le64_to_cpu(ba_notif->bitmap),
978 scd_flow, ba_resp_scd_ssn, ba_notif->txed,
979 ba_notif->txed_2_done);
980
981 tid_data->next_reclaimed = ba_resp_scd_ssn;
982
983 iwl_mvm_check_ratid_empty(mvm, sta, tid);
984
985 freed = 0;
986
987 skb_queue_walk(&reclaimed_skbs, skb) {
988 struct ieee80211_hdr *hdr = (void *)skb->data;
989 struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
990
991 if (ieee80211_is_data_qos(hdr->frame_control))
992 freed++;
993 else
994 WARN_ON_ONCE(1);
995
996 iwl_trans_free_tx_cmd(mvm->trans, info->driver_data[1]);
997
998 memset(&info->status, 0, sizeof(info->status));
999 /* Packet was transmitted successfully, failures come as single
1000 * frames because before failing a frame the firmware transmits
1001 * it without aggregation at least once.
1002 */
1003 info->flags |= IEEE80211_TX_STAT_ACK;
1004
1005 /* this is the first skb we deliver in this batch */
1006 /* put the rate scaling data there */
1007 if (freed == 1)
1008 iwl_mvm_tx_info_from_ba_notif(info, ba_notif, tid_data);
1009 }
1010
1011 spin_unlock_bh(&mvmsta->lock);
1012
1013 /* We got a BA notif with 0 acked or scd_ssn didn't progress which is
1014 * possible (i.e. first MPDU in the aggregation wasn't acked)
1015 * Still it's important to update RS about sent vs. acked.
1016 */
1017 if (skb_queue_empty(&reclaimed_skbs)) {
1018 struct ieee80211_tx_info ba_info = {};
1019 struct ieee80211_chanctx_conf *chanctx_conf = NULL;
1020
1021 if (mvmsta->vif)
1022 chanctx_conf =
1023 rcu_dereference(mvmsta->vif->chanctx_conf);
1024
1025 if (WARN_ON_ONCE(!chanctx_conf))
1026 goto out;
1027
1028 ba_info.band = chanctx_conf->def.chan->band;
1029 iwl_mvm_tx_info_from_ba_notif(&ba_info, ba_notif, tid_data);
1030
1031 IWL_DEBUG_TX_REPLY(mvm, "No reclaim. Update rs directly\n");
1032 iwl_mvm_rs_tx_status(mvm, sta, tid, &ba_info);
1033 }
1034
1035 out:
1036 rcu_read_unlock();
1037
1038 while (!skb_queue_empty(&reclaimed_skbs)) {
1039 skb = __skb_dequeue(&reclaimed_skbs);
1040 ieee80211_tx_status(mvm->hw, skb);
1041 }
1042
1043 return 0;
1044 }
1045
1046 int iwl_mvm_flush_tx_path(struct iwl_mvm *mvm, u32 tfd_msk, bool sync)
1047 {
1048 int ret;
1049 struct iwl_tx_path_flush_cmd flush_cmd = {
1050 .queues_ctl = cpu_to_le32(tfd_msk),
1051 .flush_ctl = cpu_to_le16(DUMP_TX_FIFO_FLUSH),
1052 };
1053
1054 u32 flags = sync ? 0 : CMD_ASYNC;
1055
1056 ret = iwl_mvm_send_cmd_pdu(mvm, TXPATH_FLUSH, flags,
1057 sizeof(flush_cmd), &flush_cmd);
1058 if (ret)
1059 IWL_ERR(mvm, "Failed to send flush command (%d)\n", ret);
1060 return ret;
1061 }
This page took 0.099799 seconds and 5 git commands to generate.