18c2ecf20Sopenharmony_ci// SPDX-License-Identifier: ISC 28c2ecf20Sopenharmony_ci/* 38c2ecf20Sopenharmony_ci * Copyright (C) 2016 Felix Fietkau <nbd@nbd.name> 48c2ecf20Sopenharmony_ci */ 58c2ecf20Sopenharmony_ci 68c2ecf20Sopenharmony_ci#include <linux/dma-mapping.h> 78c2ecf20Sopenharmony_ci#include "mt76.h" 88c2ecf20Sopenharmony_ci#include "dma.h" 98c2ecf20Sopenharmony_ci 108c2ecf20Sopenharmony_cistatic struct mt76_txwi_cache * 118c2ecf20Sopenharmony_cimt76_alloc_txwi(struct mt76_dev *dev) 128c2ecf20Sopenharmony_ci{ 138c2ecf20Sopenharmony_ci struct mt76_txwi_cache *t; 148c2ecf20Sopenharmony_ci dma_addr_t addr; 158c2ecf20Sopenharmony_ci u8 *txwi; 168c2ecf20Sopenharmony_ci int size; 178c2ecf20Sopenharmony_ci 188c2ecf20Sopenharmony_ci size = L1_CACHE_ALIGN(dev->drv->txwi_size + sizeof(*t)); 198c2ecf20Sopenharmony_ci txwi = devm_kzalloc(dev->dev, size, GFP_ATOMIC); 208c2ecf20Sopenharmony_ci if (!txwi) 218c2ecf20Sopenharmony_ci return NULL; 228c2ecf20Sopenharmony_ci 238c2ecf20Sopenharmony_ci addr = dma_map_single(dev->dev, txwi, dev->drv->txwi_size, 248c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 258c2ecf20Sopenharmony_ci t = (struct mt76_txwi_cache *)(txwi + dev->drv->txwi_size); 268c2ecf20Sopenharmony_ci t->dma_addr = addr; 278c2ecf20Sopenharmony_ci 288c2ecf20Sopenharmony_ci return t; 298c2ecf20Sopenharmony_ci} 308c2ecf20Sopenharmony_ci 318c2ecf20Sopenharmony_cistatic struct mt76_txwi_cache * 328c2ecf20Sopenharmony_ci__mt76_get_txwi(struct mt76_dev *dev) 338c2ecf20Sopenharmony_ci{ 348c2ecf20Sopenharmony_ci struct mt76_txwi_cache *t = NULL; 358c2ecf20Sopenharmony_ci 368c2ecf20Sopenharmony_ci spin_lock(&dev->lock); 378c2ecf20Sopenharmony_ci if (!list_empty(&dev->txwi_cache)) { 388c2ecf20Sopenharmony_ci t = list_first_entry(&dev->txwi_cache, struct mt76_txwi_cache, 398c2ecf20Sopenharmony_ci list); 408c2ecf20Sopenharmony_ci list_del(&t->list); 418c2ecf20Sopenharmony_ci } 428c2ecf20Sopenharmony_ci spin_unlock(&dev->lock); 438c2ecf20Sopenharmony_ci 448c2ecf20Sopenharmony_ci return t; 458c2ecf20Sopenharmony_ci} 468c2ecf20Sopenharmony_ci 478c2ecf20Sopenharmony_cistatic struct mt76_txwi_cache * 488c2ecf20Sopenharmony_cimt76_get_txwi(struct mt76_dev *dev) 498c2ecf20Sopenharmony_ci{ 508c2ecf20Sopenharmony_ci struct mt76_txwi_cache *t = __mt76_get_txwi(dev); 518c2ecf20Sopenharmony_ci 528c2ecf20Sopenharmony_ci if (t) 538c2ecf20Sopenharmony_ci return t; 548c2ecf20Sopenharmony_ci 558c2ecf20Sopenharmony_ci return mt76_alloc_txwi(dev); 568c2ecf20Sopenharmony_ci} 578c2ecf20Sopenharmony_ci 588c2ecf20Sopenharmony_civoid 598c2ecf20Sopenharmony_cimt76_put_txwi(struct mt76_dev *dev, struct mt76_txwi_cache *t) 608c2ecf20Sopenharmony_ci{ 618c2ecf20Sopenharmony_ci if (!t) 628c2ecf20Sopenharmony_ci return; 638c2ecf20Sopenharmony_ci 648c2ecf20Sopenharmony_ci spin_lock(&dev->lock); 658c2ecf20Sopenharmony_ci list_add(&t->list, &dev->txwi_cache); 668c2ecf20Sopenharmony_ci spin_unlock(&dev->lock); 678c2ecf20Sopenharmony_ci} 688c2ecf20Sopenharmony_ciEXPORT_SYMBOL_GPL(mt76_put_txwi); 698c2ecf20Sopenharmony_ci 708c2ecf20Sopenharmony_cistatic void 718c2ecf20Sopenharmony_cimt76_free_pending_txwi(struct mt76_dev *dev) 728c2ecf20Sopenharmony_ci{ 738c2ecf20Sopenharmony_ci struct mt76_txwi_cache *t; 748c2ecf20Sopenharmony_ci 758c2ecf20Sopenharmony_ci local_bh_disable(); 768c2ecf20Sopenharmony_ci while ((t = __mt76_get_txwi(dev)) != NULL) 778c2ecf20Sopenharmony_ci dma_unmap_single(dev->dev, t->dma_addr, dev->drv->txwi_size, 788c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 798c2ecf20Sopenharmony_ci local_bh_enable(); 808c2ecf20Sopenharmony_ci} 818c2ecf20Sopenharmony_ci 828c2ecf20Sopenharmony_cistatic int 838c2ecf20Sopenharmony_cimt76_dma_alloc_queue(struct mt76_dev *dev, struct mt76_queue *q, 848c2ecf20Sopenharmony_ci int idx, int n_desc, int bufsize, 858c2ecf20Sopenharmony_ci u32 ring_base) 868c2ecf20Sopenharmony_ci{ 878c2ecf20Sopenharmony_ci int size; 888c2ecf20Sopenharmony_ci int i; 898c2ecf20Sopenharmony_ci 908c2ecf20Sopenharmony_ci spin_lock_init(&q->lock); 918c2ecf20Sopenharmony_ci 928c2ecf20Sopenharmony_ci q->regs = dev->mmio.regs + ring_base + idx * MT_RING_SIZE; 938c2ecf20Sopenharmony_ci q->ndesc = n_desc; 948c2ecf20Sopenharmony_ci q->buf_size = bufsize; 958c2ecf20Sopenharmony_ci q->hw_idx = idx; 968c2ecf20Sopenharmony_ci 978c2ecf20Sopenharmony_ci size = q->ndesc * sizeof(struct mt76_desc); 988c2ecf20Sopenharmony_ci q->desc = dmam_alloc_coherent(dev->dev, size, &q->desc_dma, GFP_KERNEL); 998c2ecf20Sopenharmony_ci if (!q->desc) 1008c2ecf20Sopenharmony_ci return -ENOMEM; 1018c2ecf20Sopenharmony_ci 1028c2ecf20Sopenharmony_ci size = q->ndesc * sizeof(*q->entry); 1038c2ecf20Sopenharmony_ci q->entry = devm_kzalloc(dev->dev, size, GFP_KERNEL); 1048c2ecf20Sopenharmony_ci if (!q->entry) 1058c2ecf20Sopenharmony_ci return -ENOMEM; 1068c2ecf20Sopenharmony_ci 1078c2ecf20Sopenharmony_ci /* clear descriptors */ 1088c2ecf20Sopenharmony_ci for (i = 0; i < q->ndesc; i++) 1098c2ecf20Sopenharmony_ci q->desc[i].ctrl = cpu_to_le32(MT_DMA_CTL_DMA_DONE); 1108c2ecf20Sopenharmony_ci 1118c2ecf20Sopenharmony_ci writel(q->desc_dma, &q->regs->desc_base); 1128c2ecf20Sopenharmony_ci writel(0, &q->regs->cpu_idx); 1138c2ecf20Sopenharmony_ci writel(0, &q->regs->dma_idx); 1148c2ecf20Sopenharmony_ci writel(q->ndesc, &q->regs->ring_size); 1158c2ecf20Sopenharmony_ci 1168c2ecf20Sopenharmony_ci return 0; 1178c2ecf20Sopenharmony_ci} 1188c2ecf20Sopenharmony_ci 1198c2ecf20Sopenharmony_cistatic int 1208c2ecf20Sopenharmony_cimt76_dma_add_buf(struct mt76_dev *dev, struct mt76_queue *q, 1218c2ecf20Sopenharmony_ci struct mt76_queue_buf *buf, int nbufs, u32 info, 1228c2ecf20Sopenharmony_ci struct sk_buff *skb, void *txwi) 1238c2ecf20Sopenharmony_ci{ 1248c2ecf20Sopenharmony_ci struct mt76_queue_entry *entry; 1258c2ecf20Sopenharmony_ci struct mt76_desc *desc; 1268c2ecf20Sopenharmony_ci u32 ctrl; 1278c2ecf20Sopenharmony_ci int i, idx = -1; 1288c2ecf20Sopenharmony_ci 1298c2ecf20Sopenharmony_ci if (txwi) { 1308c2ecf20Sopenharmony_ci q->entry[q->head].txwi = DMA_DUMMY_DATA; 1318c2ecf20Sopenharmony_ci q->entry[q->head].skip_buf0 = true; 1328c2ecf20Sopenharmony_ci } 1338c2ecf20Sopenharmony_ci 1348c2ecf20Sopenharmony_ci for (i = 0; i < nbufs; i += 2, buf += 2) { 1358c2ecf20Sopenharmony_ci u32 buf0 = buf[0].addr, buf1 = 0; 1368c2ecf20Sopenharmony_ci 1378c2ecf20Sopenharmony_ci idx = q->head; 1388c2ecf20Sopenharmony_ci q->head = (q->head + 1) % q->ndesc; 1398c2ecf20Sopenharmony_ci 1408c2ecf20Sopenharmony_ci desc = &q->desc[idx]; 1418c2ecf20Sopenharmony_ci entry = &q->entry[idx]; 1428c2ecf20Sopenharmony_ci 1438c2ecf20Sopenharmony_ci if (buf[0].skip_unmap) 1448c2ecf20Sopenharmony_ci entry->skip_buf0 = true; 1458c2ecf20Sopenharmony_ci entry->skip_buf1 = i == nbufs - 1; 1468c2ecf20Sopenharmony_ci 1478c2ecf20Sopenharmony_ci entry->dma_addr[0] = buf[0].addr; 1488c2ecf20Sopenharmony_ci entry->dma_len[0] = buf[0].len; 1498c2ecf20Sopenharmony_ci 1508c2ecf20Sopenharmony_ci ctrl = FIELD_PREP(MT_DMA_CTL_SD_LEN0, buf[0].len); 1518c2ecf20Sopenharmony_ci if (i < nbufs - 1) { 1528c2ecf20Sopenharmony_ci entry->dma_addr[1] = buf[1].addr; 1538c2ecf20Sopenharmony_ci entry->dma_len[1] = buf[1].len; 1548c2ecf20Sopenharmony_ci buf1 = buf[1].addr; 1558c2ecf20Sopenharmony_ci ctrl |= FIELD_PREP(MT_DMA_CTL_SD_LEN1, buf[1].len); 1568c2ecf20Sopenharmony_ci if (buf[1].skip_unmap) 1578c2ecf20Sopenharmony_ci entry->skip_buf1 = true; 1588c2ecf20Sopenharmony_ci } 1598c2ecf20Sopenharmony_ci 1608c2ecf20Sopenharmony_ci if (i == nbufs - 1) 1618c2ecf20Sopenharmony_ci ctrl |= MT_DMA_CTL_LAST_SEC0; 1628c2ecf20Sopenharmony_ci else if (i == nbufs - 2) 1638c2ecf20Sopenharmony_ci ctrl |= MT_DMA_CTL_LAST_SEC1; 1648c2ecf20Sopenharmony_ci 1658c2ecf20Sopenharmony_ci WRITE_ONCE(desc->buf0, cpu_to_le32(buf0)); 1668c2ecf20Sopenharmony_ci WRITE_ONCE(desc->buf1, cpu_to_le32(buf1)); 1678c2ecf20Sopenharmony_ci WRITE_ONCE(desc->info, cpu_to_le32(info)); 1688c2ecf20Sopenharmony_ci WRITE_ONCE(desc->ctrl, cpu_to_le32(ctrl)); 1698c2ecf20Sopenharmony_ci 1708c2ecf20Sopenharmony_ci q->queued++; 1718c2ecf20Sopenharmony_ci } 1728c2ecf20Sopenharmony_ci 1738c2ecf20Sopenharmony_ci q->entry[idx].txwi = txwi; 1748c2ecf20Sopenharmony_ci q->entry[idx].skb = skb; 1758c2ecf20Sopenharmony_ci 1768c2ecf20Sopenharmony_ci return idx; 1778c2ecf20Sopenharmony_ci} 1788c2ecf20Sopenharmony_ci 1798c2ecf20Sopenharmony_cistatic void 1808c2ecf20Sopenharmony_cimt76_dma_tx_cleanup_idx(struct mt76_dev *dev, struct mt76_queue *q, int idx, 1818c2ecf20Sopenharmony_ci struct mt76_queue_entry *prev_e) 1828c2ecf20Sopenharmony_ci{ 1838c2ecf20Sopenharmony_ci struct mt76_queue_entry *e = &q->entry[idx]; 1848c2ecf20Sopenharmony_ci 1858c2ecf20Sopenharmony_ci if (!e->skip_buf0) 1868c2ecf20Sopenharmony_ci dma_unmap_single(dev->dev, e->dma_addr[0], e->dma_len[0], 1878c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 1888c2ecf20Sopenharmony_ci 1898c2ecf20Sopenharmony_ci if (!e->skip_buf1) 1908c2ecf20Sopenharmony_ci dma_unmap_single(dev->dev, e->dma_addr[1], e->dma_len[1], 1918c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 1928c2ecf20Sopenharmony_ci 1938c2ecf20Sopenharmony_ci if (e->txwi == DMA_DUMMY_DATA) 1948c2ecf20Sopenharmony_ci e->txwi = NULL; 1958c2ecf20Sopenharmony_ci 1968c2ecf20Sopenharmony_ci if (e->skb == DMA_DUMMY_DATA) 1978c2ecf20Sopenharmony_ci e->skb = NULL; 1988c2ecf20Sopenharmony_ci 1998c2ecf20Sopenharmony_ci *prev_e = *e; 2008c2ecf20Sopenharmony_ci memset(e, 0, sizeof(*e)); 2018c2ecf20Sopenharmony_ci} 2028c2ecf20Sopenharmony_ci 2038c2ecf20Sopenharmony_cistatic void 2048c2ecf20Sopenharmony_cimt76_dma_sync_idx(struct mt76_dev *dev, struct mt76_queue *q) 2058c2ecf20Sopenharmony_ci{ 2068c2ecf20Sopenharmony_ci writel(q->desc_dma, &q->regs->desc_base); 2078c2ecf20Sopenharmony_ci writel(q->ndesc, &q->regs->ring_size); 2088c2ecf20Sopenharmony_ci q->head = readl(&q->regs->dma_idx); 2098c2ecf20Sopenharmony_ci q->tail = q->head; 2108c2ecf20Sopenharmony_ci} 2118c2ecf20Sopenharmony_ci 2128c2ecf20Sopenharmony_cistatic void 2138c2ecf20Sopenharmony_cimt76_dma_kick_queue(struct mt76_dev *dev, struct mt76_queue *q) 2148c2ecf20Sopenharmony_ci{ 2158c2ecf20Sopenharmony_ci wmb(); 2168c2ecf20Sopenharmony_ci writel(q->head, &q->regs->cpu_idx); 2178c2ecf20Sopenharmony_ci} 2188c2ecf20Sopenharmony_ci 2198c2ecf20Sopenharmony_cistatic void 2208c2ecf20Sopenharmony_cimt76_dma_tx_cleanup(struct mt76_dev *dev, enum mt76_txq_id qid, bool flush) 2218c2ecf20Sopenharmony_ci{ 2228c2ecf20Sopenharmony_ci struct mt76_queue *q = dev->q_tx[qid]; 2238c2ecf20Sopenharmony_ci struct mt76_queue_entry entry; 2248c2ecf20Sopenharmony_ci bool wake = false; 2258c2ecf20Sopenharmony_ci int last; 2268c2ecf20Sopenharmony_ci 2278c2ecf20Sopenharmony_ci if (!q) 2288c2ecf20Sopenharmony_ci return; 2298c2ecf20Sopenharmony_ci 2308c2ecf20Sopenharmony_ci if (flush) 2318c2ecf20Sopenharmony_ci last = -1; 2328c2ecf20Sopenharmony_ci else 2338c2ecf20Sopenharmony_ci last = readl(&q->regs->dma_idx); 2348c2ecf20Sopenharmony_ci 2358c2ecf20Sopenharmony_ci while (q->queued > 0 && q->tail != last) { 2368c2ecf20Sopenharmony_ci mt76_dma_tx_cleanup_idx(dev, q, q->tail, &entry); 2378c2ecf20Sopenharmony_ci mt76_queue_tx_complete(dev, q, &entry); 2388c2ecf20Sopenharmony_ci 2398c2ecf20Sopenharmony_ci if (entry.txwi) { 2408c2ecf20Sopenharmony_ci if (!(dev->drv->drv_flags & MT_DRV_TXWI_NO_FREE)) 2418c2ecf20Sopenharmony_ci mt76_put_txwi(dev, entry.txwi); 2428c2ecf20Sopenharmony_ci wake = !flush; 2438c2ecf20Sopenharmony_ci } 2448c2ecf20Sopenharmony_ci 2458c2ecf20Sopenharmony_ci if (!flush && q->tail == last) 2468c2ecf20Sopenharmony_ci last = readl(&q->regs->dma_idx); 2478c2ecf20Sopenharmony_ci 2488c2ecf20Sopenharmony_ci } 2498c2ecf20Sopenharmony_ci 2508c2ecf20Sopenharmony_ci if (flush) { 2518c2ecf20Sopenharmony_ci spin_lock_bh(&q->lock); 2528c2ecf20Sopenharmony_ci mt76_dma_sync_idx(dev, q); 2538c2ecf20Sopenharmony_ci mt76_dma_kick_queue(dev, q); 2548c2ecf20Sopenharmony_ci spin_unlock_bh(&q->lock); 2558c2ecf20Sopenharmony_ci } 2568c2ecf20Sopenharmony_ci 2578c2ecf20Sopenharmony_ci wake = wake && q->stopped && 2588c2ecf20Sopenharmony_ci qid < IEEE80211_NUM_ACS && q->queued < q->ndesc - 8; 2598c2ecf20Sopenharmony_ci if (wake) 2608c2ecf20Sopenharmony_ci q->stopped = false; 2618c2ecf20Sopenharmony_ci 2628c2ecf20Sopenharmony_ci if (!q->queued) 2638c2ecf20Sopenharmony_ci wake_up(&dev->tx_wait); 2648c2ecf20Sopenharmony_ci 2658c2ecf20Sopenharmony_ci if (wake) 2668c2ecf20Sopenharmony_ci ieee80211_wake_queue(dev->hw, qid); 2678c2ecf20Sopenharmony_ci} 2688c2ecf20Sopenharmony_ci 2698c2ecf20Sopenharmony_cistatic void * 2708c2ecf20Sopenharmony_cimt76_dma_get_buf(struct mt76_dev *dev, struct mt76_queue *q, int idx, 2718c2ecf20Sopenharmony_ci int *len, u32 *info, bool *more) 2728c2ecf20Sopenharmony_ci{ 2738c2ecf20Sopenharmony_ci struct mt76_queue_entry *e = &q->entry[idx]; 2748c2ecf20Sopenharmony_ci struct mt76_desc *desc = &q->desc[idx]; 2758c2ecf20Sopenharmony_ci dma_addr_t buf_addr; 2768c2ecf20Sopenharmony_ci void *buf = e->buf; 2778c2ecf20Sopenharmony_ci int buf_len = SKB_WITH_OVERHEAD(q->buf_size); 2788c2ecf20Sopenharmony_ci 2798c2ecf20Sopenharmony_ci buf_addr = e->dma_addr[0]; 2808c2ecf20Sopenharmony_ci if (len) { 2818c2ecf20Sopenharmony_ci u32 ctl = le32_to_cpu(READ_ONCE(desc->ctrl)); 2828c2ecf20Sopenharmony_ci *len = FIELD_GET(MT_DMA_CTL_SD_LEN0, ctl); 2838c2ecf20Sopenharmony_ci *more = !(ctl & MT_DMA_CTL_LAST_SEC0); 2848c2ecf20Sopenharmony_ci } 2858c2ecf20Sopenharmony_ci 2868c2ecf20Sopenharmony_ci if (info) 2878c2ecf20Sopenharmony_ci *info = le32_to_cpu(desc->info); 2888c2ecf20Sopenharmony_ci 2898c2ecf20Sopenharmony_ci dma_unmap_single(dev->dev, buf_addr, buf_len, DMA_FROM_DEVICE); 2908c2ecf20Sopenharmony_ci e->buf = NULL; 2918c2ecf20Sopenharmony_ci 2928c2ecf20Sopenharmony_ci return buf; 2938c2ecf20Sopenharmony_ci} 2948c2ecf20Sopenharmony_ci 2958c2ecf20Sopenharmony_cistatic void * 2968c2ecf20Sopenharmony_cimt76_dma_dequeue(struct mt76_dev *dev, struct mt76_queue *q, bool flush, 2978c2ecf20Sopenharmony_ci int *len, u32 *info, bool *more) 2988c2ecf20Sopenharmony_ci{ 2998c2ecf20Sopenharmony_ci int idx = q->tail; 3008c2ecf20Sopenharmony_ci 3018c2ecf20Sopenharmony_ci *more = false; 3028c2ecf20Sopenharmony_ci if (!q->queued) 3038c2ecf20Sopenharmony_ci return NULL; 3048c2ecf20Sopenharmony_ci 3058c2ecf20Sopenharmony_ci if (flush) 3068c2ecf20Sopenharmony_ci q->desc[idx].ctrl |= cpu_to_le32(MT_DMA_CTL_DMA_DONE); 3078c2ecf20Sopenharmony_ci else if (!(q->desc[idx].ctrl & cpu_to_le32(MT_DMA_CTL_DMA_DONE))) 3088c2ecf20Sopenharmony_ci return NULL; 3098c2ecf20Sopenharmony_ci 3108c2ecf20Sopenharmony_ci q->tail = (q->tail + 1) % q->ndesc; 3118c2ecf20Sopenharmony_ci q->queued--; 3128c2ecf20Sopenharmony_ci 3138c2ecf20Sopenharmony_ci return mt76_dma_get_buf(dev, q, idx, len, info, more); 3148c2ecf20Sopenharmony_ci} 3158c2ecf20Sopenharmony_ci 3168c2ecf20Sopenharmony_cistatic int 3178c2ecf20Sopenharmony_cimt76_dma_tx_queue_skb_raw(struct mt76_dev *dev, enum mt76_txq_id qid, 3188c2ecf20Sopenharmony_ci struct sk_buff *skb, u32 tx_info) 3198c2ecf20Sopenharmony_ci{ 3208c2ecf20Sopenharmony_ci struct mt76_queue *q = dev->q_tx[qid]; 3218c2ecf20Sopenharmony_ci struct mt76_queue_buf buf = {}; 3228c2ecf20Sopenharmony_ci dma_addr_t addr; 3238c2ecf20Sopenharmony_ci 3248c2ecf20Sopenharmony_ci if (q->queued + 1 >= q->ndesc - 1) 3258c2ecf20Sopenharmony_ci goto error; 3268c2ecf20Sopenharmony_ci 3278c2ecf20Sopenharmony_ci addr = dma_map_single(dev->dev, skb->data, skb->len, 3288c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 3298c2ecf20Sopenharmony_ci if (unlikely(dma_mapping_error(dev->dev, addr))) 3308c2ecf20Sopenharmony_ci goto error; 3318c2ecf20Sopenharmony_ci 3328c2ecf20Sopenharmony_ci buf.addr = addr; 3338c2ecf20Sopenharmony_ci buf.len = skb->len; 3348c2ecf20Sopenharmony_ci 3358c2ecf20Sopenharmony_ci spin_lock_bh(&q->lock); 3368c2ecf20Sopenharmony_ci mt76_dma_add_buf(dev, q, &buf, 1, tx_info, skb, NULL); 3378c2ecf20Sopenharmony_ci mt76_dma_kick_queue(dev, q); 3388c2ecf20Sopenharmony_ci spin_unlock_bh(&q->lock); 3398c2ecf20Sopenharmony_ci 3408c2ecf20Sopenharmony_ci return 0; 3418c2ecf20Sopenharmony_ci 3428c2ecf20Sopenharmony_cierror: 3438c2ecf20Sopenharmony_ci dev_kfree_skb(skb); 3448c2ecf20Sopenharmony_ci return -ENOMEM; 3458c2ecf20Sopenharmony_ci} 3468c2ecf20Sopenharmony_ci 3478c2ecf20Sopenharmony_cistatic int 3488c2ecf20Sopenharmony_cimt76_dma_tx_queue_skb(struct mt76_dev *dev, enum mt76_txq_id qid, 3498c2ecf20Sopenharmony_ci struct sk_buff *skb, struct mt76_wcid *wcid, 3508c2ecf20Sopenharmony_ci struct ieee80211_sta *sta) 3518c2ecf20Sopenharmony_ci{ 3528c2ecf20Sopenharmony_ci struct mt76_queue *q = dev->q_tx[qid]; 3538c2ecf20Sopenharmony_ci struct mt76_tx_info tx_info = { 3548c2ecf20Sopenharmony_ci .skb = skb, 3558c2ecf20Sopenharmony_ci }; 3568c2ecf20Sopenharmony_ci struct ieee80211_hw *hw; 3578c2ecf20Sopenharmony_ci int len, n = 0, ret = -ENOMEM; 3588c2ecf20Sopenharmony_ci struct mt76_txwi_cache *t; 3598c2ecf20Sopenharmony_ci struct sk_buff *iter; 3608c2ecf20Sopenharmony_ci dma_addr_t addr; 3618c2ecf20Sopenharmony_ci u8 *txwi; 3628c2ecf20Sopenharmony_ci 3638c2ecf20Sopenharmony_ci t = mt76_get_txwi(dev); 3648c2ecf20Sopenharmony_ci if (!t) { 3658c2ecf20Sopenharmony_ci hw = mt76_tx_status_get_hw(dev, skb); 3668c2ecf20Sopenharmony_ci ieee80211_free_txskb(hw, skb); 3678c2ecf20Sopenharmony_ci return -ENOMEM; 3688c2ecf20Sopenharmony_ci } 3698c2ecf20Sopenharmony_ci txwi = mt76_get_txwi_ptr(dev, t); 3708c2ecf20Sopenharmony_ci 3718c2ecf20Sopenharmony_ci skb->prev = skb->next = NULL; 3728c2ecf20Sopenharmony_ci if (dev->drv->drv_flags & MT_DRV_TX_ALIGNED4_SKBS) 3738c2ecf20Sopenharmony_ci mt76_insert_hdr_pad(skb); 3748c2ecf20Sopenharmony_ci 3758c2ecf20Sopenharmony_ci len = skb_headlen(skb); 3768c2ecf20Sopenharmony_ci addr = dma_map_single(dev->dev, skb->data, len, DMA_TO_DEVICE); 3778c2ecf20Sopenharmony_ci if (unlikely(dma_mapping_error(dev->dev, addr))) 3788c2ecf20Sopenharmony_ci goto free; 3798c2ecf20Sopenharmony_ci 3808c2ecf20Sopenharmony_ci tx_info.buf[n].addr = t->dma_addr; 3818c2ecf20Sopenharmony_ci tx_info.buf[n++].len = dev->drv->txwi_size; 3828c2ecf20Sopenharmony_ci tx_info.buf[n].addr = addr; 3838c2ecf20Sopenharmony_ci tx_info.buf[n++].len = len; 3848c2ecf20Sopenharmony_ci 3858c2ecf20Sopenharmony_ci skb_walk_frags(skb, iter) { 3868c2ecf20Sopenharmony_ci if (n == ARRAY_SIZE(tx_info.buf)) 3878c2ecf20Sopenharmony_ci goto unmap; 3888c2ecf20Sopenharmony_ci 3898c2ecf20Sopenharmony_ci addr = dma_map_single(dev->dev, iter->data, iter->len, 3908c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 3918c2ecf20Sopenharmony_ci if (unlikely(dma_mapping_error(dev->dev, addr))) 3928c2ecf20Sopenharmony_ci goto unmap; 3938c2ecf20Sopenharmony_ci 3948c2ecf20Sopenharmony_ci tx_info.buf[n].addr = addr; 3958c2ecf20Sopenharmony_ci tx_info.buf[n++].len = iter->len; 3968c2ecf20Sopenharmony_ci } 3978c2ecf20Sopenharmony_ci tx_info.nbuf = n; 3988c2ecf20Sopenharmony_ci 3998c2ecf20Sopenharmony_ci if (q->queued + (tx_info.nbuf + 1) / 2 >= q->ndesc - 1) { 4008c2ecf20Sopenharmony_ci ret = -ENOMEM; 4018c2ecf20Sopenharmony_ci goto unmap; 4028c2ecf20Sopenharmony_ci } 4038c2ecf20Sopenharmony_ci 4048c2ecf20Sopenharmony_ci dma_sync_single_for_cpu(dev->dev, t->dma_addr, dev->drv->txwi_size, 4058c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 4068c2ecf20Sopenharmony_ci ret = dev->drv->tx_prepare_skb(dev, txwi, qid, wcid, sta, &tx_info); 4078c2ecf20Sopenharmony_ci dma_sync_single_for_device(dev->dev, t->dma_addr, dev->drv->txwi_size, 4088c2ecf20Sopenharmony_ci DMA_TO_DEVICE); 4098c2ecf20Sopenharmony_ci if (ret < 0) 4108c2ecf20Sopenharmony_ci goto unmap; 4118c2ecf20Sopenharmony_ci 4128c2ecf20Sopenharmony_ci return mt76_dma_add_buf(dev, q, tx_info.buf, tx_info.nbuf, 4138c2ecf20Sopenharmony_ci tx_info.info, tx_info.skb, t); 4148c2ecf20Sopenharmony_ci 4158c2ecf20Sopenharmony_ciunmap: 4168c2ecf20Sopenharmony_ci for (n--; n > 0; n--) 4178c2ecf20Sopenharmony_ci dma_unmap_single(dev->dev, tx_info.buf[n].addr, 4188c2ecf20Sopenharmony_ci tx_info.buf[n].len, DMA_TO_DEVICE); 4198c2ecf20Sopenharmony_ci 4208c2ecf20Sopenharmony_cifree: 4218c2ecf20Sopenharmony_ci#ifdef CONFIG_NL80211_TESTMODE 4228c2ecf20Sopenharmony_ci /* fix tx_done accounting on queue overflow */ 4238c2ecf20Sopenharmony_ci if (tx_info.skb == dev->test.tx_skb) 4248c2ecf20Sopenharmony_ci dev->test.tx_done--; 4258c2ecf20Sopenharmony_ci#endif 4268c2ecf20Sopenharmony_ci 4278c2ecf20Sopenharmony_ci dev_kfree_skb(tx_info.skb); 4288c2ecf20Sopenharmony_ci mt76_put_txwi(dev, t); 4298c2ecf20Sopenharmony_ci return ret; 4308c2ecf20Sopenharmony_ci} 4318c2ecf20Sopenharmony_ci 4328c2ecf20Sopenharmony_cistatic int 4338c2ecf20Sopenharmony_cimt76_dma_rx_fill(struct mt76_dev *dev, struct mt76_queue *q) 4348c2ecf20Sopenharmony_ci{ 4358c2ecf20Sopenharmony_ci dma_addr_t addr; 4368c2ecf20Sopenharmony_ci void *buf; 4378c2ecf20Sopenharmony_ci int frames = 0; 4388c2ecf20Sopenharmony_ci int len = SKB_WITH_OVERHEAD(q->buf_size); 4398c2ecf20Sopenharmony_ci int offset = q->buf_offset; 4408c2ecf20Sopenharmony_ci 4418c2ecf20Sopenharmony_ci spin_lock_bh(&q->lock); 4428c2ecf20Sopenharmony_ci 4438c2ecf20Sopenharmony_ci while (q->queued < q->ndesc - 1) { 4448c2ecf20Sopenharmony_ci struct mt76_queue_buf qbuf; 4458c2ecf20Sopenharmony_ci 4468c2ecf20Sopenharmony_ci buf = page_frag_alloc(&q->rx_page, q->buf_size, GFP_ATOMIC); 4478c2ecf20Sopenharmony_ci if (!buf) 4488c2ecf20Sopenharmony_ci break; 4498c2ecf20Sopenharmony_ci 4508c2ecf20Sopenharmony_ci addr = dma_map_single(dev->dev, buf, len, DMA_FROM_DEVICE); 4518c2ecf20Sopenharmony_ci if (unlikely(dma_mapping_error(dev->dev, addr))) { 4528c2ecf20Sopenharmony_ci skb_free_frag(buf); 4538c2ecf20Sopenharmony_ci break; 4548c2ecf20Sopenharmony_ci } 4558c2ecf20Sopenharmony_ci 4568c2ecf20Sopenharmony_ci qbuf.addr = addr + offset; 4578c2ecf20Sopenharmony_ci qbuf.len = len - offset; 4588c2ecf20Sopenharmony_ci qbuf.skip_unmap = false; 4598c2ecf20Sopenharmony_ci mt76_dma_add_buf(dev, q, &qbuf, 1, 0, buf, NULL); 4608c2ecf20Sopenharmony_ci frames++; 4618c2ecf20Sopenharmony_ci } 4628c2ecf20Sopenharmony_ci 4638c2ecf20Sopenharmony_ci if (frames) 4648c2ecf20Sopenharmony_ci mt76_dma_kick_queue(dev, q); 4658c2ecf20Sopenharmony_ci 4668c2ecf20Sopenharmony_ci spin_unlock_bh(&q->lock); 4678c2ecf20Sopenharmony_ci 4688c2ecf20Sopenharmony_ci return frames; 4698c2ecf20Sopenharmony_ci} 4708c2ecf20Sopenharmony_ci 4718c2ecf20Sopenharmony_cistatic void 4728c2ecf20Sopenharmony_cimt76_dma_rx_cleanup(struct mt76_dev *dev, struct mt76_queue *q) 4738c2ecf20Sopenharmony_ci{ 4748c2ecf20Sopenharmony_ci struct page *page; 4758c2ecf20Sopenharmony_ci void *buf; 4768c2ecf20Sopenharmony_ci bool more; 4778c2ecf20Sopenharmony_ci 4788c2ecf20Sopenharmony_ci spin_lock_bh(&q->lock); 4798c2ecf20Sopenharmony_ci 4808c2ecf20Sopenharmony_ci do { 4818c2ecf20Sopenharmony_ci buf = mt76_dma_dequeue(dev, q, true, NULL, NULL, &more); 4828c2ecf20Sopenharmony_ci if (!buf) 4838c2ecf20Sopenharmony_ci break; 4848c2ecf20Sopenharmony_ci 4858c2ecf20Sopenharmony_ci skb_free_frag(buf); 4868c2ecf20Sopenharmony_ci } while (1); 4878c2ecf20Sopenharmony_ci 4888c2ecf20Sopenharmony_ci if (q->rx_head) { 4898c2ecf20Sopenharmony_ci dev_kfree_skb(q->rx_head); 4908c2ecf20Sopenharmony_ci q->rx_head = NULL; 4918c2ecf20Sopenharmony_ci } 4928c2ecf20Sopenharmony_ci 4938c2ecf20Sopenharmony_ci spin_unlock_bh(&q->lock); 4948c2ecf20Sopenharmony_ci 4958c2ecf20Sopenharmony_ci if (!q->rx_page.va) 4968c2ecf20Sopenharmony_ci return; 4978c2ecf20Sopenharmony_ci 4988c2ecf20Sopenharmony_ci page = virt_to_page(q->rx_page.va); 4998c2ecf20Sopenharmony_ci __page_frag_cache_drain(page, q->rx_page.pagecnt_bias); 5008c2ecf20Sopenharmony_ci memset(&q->rx_page, 0, sizeof(q->rx_page)); 5018c2ecf20Sopenharmony_ci} 5028c2ecf20Sopenharmony_ci 5038c2ecf20Sopenharmony_cistatic void 5048c2ecf20Sopenharmony_cimt76_dma_rx_reset(struct mt76_dev *dev, enum mt76_rxq_id qid) 5058c2ecf20Sopenharmony_ci{ 5068c2ecf20Sopenharmony_ci struct mt76_queue *q = &dev->q_rx[qid]; 5078c2ecf20Sopenharmony_ci int i; 5088c2ecf20Sopenharmony_ci 5098c2ecf20Sopenharmony_ci for (i = 0; i < q->ndesc; i++) 5108c2ecf20Sopenharmony_ci q->desc[i].ctrl = cpu_to_le32(MT_DMA_CTL_DMA_DONE); 5118c2ecf20Sopenharmony_ci 5128c2ecf20Sopenharmony_ci mt76_dma_rx_cleanup(dev, q); 5138c2ecf20Sopenharmony_ci mt76_dma_sync_idx(dev, q); 5148c2ecf20Sopenharmony_ci mt76_dma_rx_fill(dev, q); 5158c2ecf20Sopenharmony_ci} 5168c2ecf20Sopenharmony_ci 5178c2ecf20Sopenharmony_cistatic void 5188c2ecf20Sopenharmony_cimt76_add_fragment(struct mt76_dev *dev, struct mt76_queue *q, void *data, 5198c2ecf20Sopenharmony_ci int len, bool more) 5208c2ecf20Sopenharmony_ci{ 5218c2ecf20Sopenharmony_ci struct sk_buff *skb = q->rx_head; 5228c2ecf20Sopenharmony_ci struct skb_shared_info *shinfo = skb_shinfo(skb); 5238c2ecf20Sopenharmony_ci int nr_frags = shinfo->nr_frags; 5248c2ecf20Sopenharmony_ci 5258c2ecf20Sopenharmony_ci if (nr_frags < ARRAY_SIZE(shinfo->frags)) { 5268c2ecf20Sopenharmony_ci struct page *page = virt_to_head_page(data); 5278c2ecf20Sopenharmony_ci int offset = data - page_address(page) + q->buf_offset; 5288c2ecf20Sopenharmony_ci 5298c2ecf20Sopenharmony_ci skb_add_rx_frag(skb, nr_frags, page, offset, len, q->buf_size); 5308c2ecf20Sopenharmony_ci } else { 5318c2ecf20Sopenharmony_ci skb_free_frag(data); 5328c2ecf20Sopenharmony_ci } 5338c2ecf20Sopenharmony_ci 5348c2ecf20Sopenharmony_ci if (more) 5358c2ecf20Sopenharmony_ci return; 5368c2ecf20Sopenharmony_ci 5378c2ecf20Sopenharmony_ci q->rx_head = NULL; 5388c2ecf20Sopenharmony_ci if (nr_frags < ARRAY_SIZE(shinfo->frags)) 5398c2ecf20Sopenharmony_ci dev->drv->rx_skb(dev, q - dev->q_rx, skb); 5408c2ecf20Sopenharmony_ci else 5418c2ecf20Sopenharmony_ci dev_kfree_skb(skb); 5428c2ecf20Sopenharmony_ci} 5438c2ecf20Sopenharmony_ci 5448c2ecf20Sopenharmony_cistatic int 5458c2ecf20Sopenharmony_cimt76_dma_rx_process(struct mt76_dev *dev, struct mt76_queue *q, int budget) 5468c2ecf20Sopenharmony_ci{ 5478c2ecf20Sopenharmony_ci int len, data_len, done = 0; 5488c2ecf20Sopenharmony_ci struct sk_buff *skb; 5498c2ecf20Sopenharmony_ci unsigned char *data; 5508c2ecf20Sopenharmony_ci bool more; 5518c2ecf20Sopenharmony_ci 5528c2ecf20Sopenharmony_ci while (done < budget) { 5538c2ecf20Sopenharmony_ci u32 info; 5548c2ecf20Sopenharmony_ci 5558c2ecf20Sopenharmony_ci data = mt76_dma_dequeue(dev, q, false, &len, &info, &more); 5568c2ecf20Sopenharmony_ci if (!data) 5578c2ecf20Sopenharmony_ci break; 5588c2ecf20Sopenharmony_ci 5598c2ecf20Sopenharmony_ci if (q->rx_head) 5608c2ecf20Sopenharmony_ci data_len = q->buf_size; 5618c2ecf20Sopenharmony_ci else 5628c2ecf20Sopenharmony_ci data_len = SKB_WITH_OVERHEAD(q->buf_size); 5638c2ecf20Sopenharmony_ci 5648c2ecf20Sopenharmony_ci if (data_len < len + q->buf_offset) { 5658c2ecf20Sopenharmony_ci dev_kfree_skb(q->rx_head); 5668c2ecf20Sopenharmony_ci q->rx_head = NULL; 5678c2ecf20Sopenharmony_ci 5688c2ecf20Sopenharmony_ci skb_free_frag(data); 5698c2ecf20Sopenharmony_ci continue; 5708c2ecf20Sopenharmony_ci } 5718c2ecf20Sopenharmony_ci 5728c2ecf20Sopenharmony_ci if (q->rx_head) { 5738c2ecf20Sopenharmony_ci mt76_add_fragment(dev, q, data, len, more); 5748c2ecf20Sopenharmony_ci continue; 5758c2ecf20Sopenharmony_ci } 5768c2ecf20Sopenharmony_ci 5778c2ecf20Sopenharmony_ci skb = build_skb(data, q->buf_size); 5788c2ecf20Sopenharmony_ci if (!skb) { 5798c2ecf20Sopenharmony_ci skb_free_frag(data); 5808c2ecf20Sopenharmony_ci continue; 5818c2ecf20Sopenharmony_ci } 5828c2ecf20Sopenharmony_ci skb_reserve(skb, q->buf_offset); 5838c2ecf20Sopenharmony_ci 5848c2ecf20Sopenharmony_ci if (q == &dev->q_rx[MT_RXQ_MCU]) { 5858c2ecf20Sopenharmony_ci u32 *rxfce = (u32 *)skb->cb; 5868c2ecf20Sopenharmony_ci *rxfce = info; 5878c2ecf20Sopenharmony_ci } 5888c2ecf20Sopenharmony_ci 5898c2ecf20Sopenharmony_ci __skb_put(skb, len); 5908c2ecf20Sopenharmony_ci done++; 5918c2ecf20Sopenharmony_ci 5928c2ecf20Sopenharmony_ci if (more) { 5938c2ecf20Sopenharmony_ci q->rx_head = skb; 5948c2ecf20Sopenharmony_ci continue; 5958c2ecf20Sopenharmony_ci } 5968c2ecf20Sopenharmony_ci 5978c2ecf20Sopenharmony_ci dev->drv->rx_skb(dev, q - dev->q_rx, skb); 5988c2ecf20Sopenharmony_ci } 5998c2ecf20Sopenharmony_ci 6008c2ecf20Sopenharmony_ci mt76_dma_rx_fill(dev, q); 6018c2ecf20Sopenharmony_ci return done; 6028c2ecf20Sopenharmony_ci} 6038c2ecf20Sopenharmony_ci 6048c2ecf20Sopenharmony_cistatic int 6058c2ecf20Sopenharmony_cimt76_dma_rx_poll(struct napi_struct *napi, int budget) 6068c2ecf20Sopenharmony_ci{ 6078c2ecf20Sopenharmony_ci struct mt76_dev *dev; 6088c2ecf20Sopenharmony_ci int qid, done = 0, cur; 6098c2ecf20Sopenharmony_ci 6108c2ecf20Sopenharmony_ci dev = container_of(napi->dev, struct mt76_dev, napi_dev); 6118c2ecf20Sopenharmony_ci qid = napi - dev->napi; 6128c2ecf20Sopenharmony_ci 6138c2ecf20Sopenharmony_ci local_bh_disable(); 6148c2ecf20Sopenharmony_ci rcu_read_lock(); 6158c2ecf20Sopenharmony_ci 6168c2ecf20Sopenharmony_ci do { 6178c2ecf20Sopenharmony_ci cur = mt76_dma_rx_process(dev, &dev->q_rx[qid], budget - done); 6188c2ecf20Sopenharmony_ci mt76_rx_poll_complete(dev, qid, napi); 6198c2ecf20Sopenharmony_ci done += cur; 6208c2ecf20Sopenharmony_ci } while (cur && done < budget); 6218c2ecf20Sopenharmony_ci 6228c2ecf20Sopenharmony_ci rcu_read_unlock(); 6238c2ecf20Sopenharmony_ci local_bh_enable(); 6248c2ecf20Sopenharmony_ci 6258c2ecf20Sopenharmony_ci if (done < budget && napi_complete(napi)) 6268c2ecf20Sopenharmony_ci dev->drv->rx_poll_complete(dev, qid); 6278c2ecf20Sopenharmony_ci 6288c2ecf20Sopenharmony_ci return done; 6298c2ecf20Sopenharmony_ci} 6308c2ecf20Sopenharmony_ci 6318c2ecf20Sopenharmony_cistatic int 6328c2ecf20Sopenharmony_cimt76_dma_init(struct mt76_dev *dev) 6338c2ecf20Sopenharmony_ci{ 6348c2ecf20Sopenharmony_ci int i; 6358c2ecf20Sopenharmony_ci 6368c2ecf20Sopenharmony_ci init_dummy_netdev(&dev->napi_dev); 6378c2ecf20Sopenharmony_ci 6388c2ecf20Sopenharmony_ci mt76_for_each_q_rx(dev, i) { 6398c2ecf20Sopenharmony_ci netif_napi_add(&dev->napi_dev, &dev->napi[i], mt76_dma_rx_poll, 6408c2ecf20Sopenharmony_ci 64); 6418c2ecf20Sopenharmony_ci mt76_dma_rx_fill(dev, &dev->q_rx[i]); 6428c2ecf20Sopenharmony_ci napi_enable(&dev->napi[i]); 6438c2ecf20Sopenharmony_ci } 6448c2ecf20Sopenharmony_ci 6458c2ecf20Sopenharmony_ci return 0; 6468c2ecf20Sopenharmony_ci} 6478c2ecf20Sopenharmony_ci 6488c2ecf20Sopenharmony_cistatic const struct mt76_queue_ops mt76_dma_ops = { 6498c2ecf20Sopenharmony_ci .init = mt76_dma_init, 6508c2ecf20Sopenharmony_ci .alloc = mt76_dma_alloc_queue, 6518c2ecf20Sopenharmony_ci .tx_queue_skb_raw = mt76_dma_tx_queue_skb_raw, 6528c2ecf20Sopenharmony_ci .tx_queue_skb = mt76_dma_tx_queue_skb, 6538c2ecf20Sopenharmony_ci .tx_cleanup = mt76_dma_tx_cleanup, 6548c2ecf20Sopenharmony_ci .rx_reset = mt76_dma_rx_reset, 6558c2ecf20Sopenharmony_ci .kick = mt76_dma_kick_queue, 6568c2ecf20Sopenharmony_ci}; 6578c2ecf20Sopenharmony_ci 6588c2ecf20Sopenharmony_civoid mt76_dma_attach(struct mt76_dev *dev) 6598c2ecf20Sopenharmony_ci{ 6608c2ecf20Sopenharmony_ci dev->queue_ops = &mt76_dma_ops; 6618c2ecf20Sopenharmony_ci} 6628c2ecf20Sopenharmony_ciEXPORT_SYMBOL_GPL(mt76_dma_attach); 6638c2ecf20Sopenharmony_ci 6648c2ecf20Sopenharmony_civoid mt76_dma_cleanup(struct mt76_dev *dev) 6658c2ecf20Sopenharmony_ci{ 6668c2ecf20Sopenharmony_ci int i; 6678c2ecf20Sopenharmony_ci 6688c2ecf20Sopenharmony_ci mt76_worker_disable(&dev->tx_worker); 6698c2ecf20Sopenharmony_ci netif_napi_del(&dev->tx_napi); 6708c2ecf20Sopenharmony_ci for (i = 0; i < ARRAY_SIZE(dev->q_tx); i++) 6718c2ecf20Sopenharmony_ci mt76_dma_tx_cleanup(dev, i, true); 6728c2ecf20Sopenharmony_ci 6738c2ecf20Sopenharmony_ci mt76_for_each_q_rx(dev, i) { 6748c2ecf20Sopenharmony_ci netif_napi_del(&dev->napi[i]); 6758c2ecf20Sopenharmony_ci mt76_dma_rx_cleanup(dev, &dev->q_rx[i]); 6768c2ecf20Sopenharmony_ci } 6778c2ecf20Sopenharmony_ci 6788c2ecf20Sopenharmony_ci mt76_free_pending_txwi(dev); 6798c2ecf20Sopenharmony_ci} 6808c2ecf20Sopenharmony_ciEXPORT_SYMBOL_GPL(mt76_dma_cleanup); 681