mirror of
https://github.com/AuxXxilium/linux_dsm_epyc7002.git
synced 2024-12-28 11:18:45 +07:00
9a46d44eda
Add missing kernel-doc variables for structures/functions. Signed-off-by: Ivo van Doorn <IvDoorn@gmail.com> Signed-off-by: John W. Linville <linville@tuxdriver.com>
167 lines
4.5 KiB
C
167 lines
4.5 KiB
C
/*
|
|
Copyright (C) 2004 - 2008 rt2x00 SourceForge Project
|
|
<http://rt2x00.serialmonkey.com>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the
|
|
Free Software Foundation, Inc.,
|
|
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
/*
|
|
Module: rt2x00pci
|
|
Abstract: Data structures for the rt2x00pci module.
|
|
*/
|
|
|
|
#ifndef RT2X00PCI_H
|
|
#define RT2X00PCI_H
|
|
|
|
#include <linux/io.h>
|
|
|
|
/*
|
|
* This variable should be used with the
|
|
* pci_driver structure initialization.
|
|
*/
|
|
#define PCI_DEVICE_DATA(__ops) .driver_data = (kernel_ulong_t)(__ops)
|
|
|
|
/*
|
|
* Register defines.
|
|
* Some registers require multiple attempts before success,
|
|
* in those cases REGISTER_BUSY_COUNT attempts should be
|
|
* taken with a REGISTER_BUSY_DELAY interval.
|
|
*/
|
|
#define REGISTER_BUSY_COUNT 5
|
|
#define REGISTER_BUSY_DELAY 100
|
|
|
|
/*
|
|
* Descriptor availability flags.
|
|
* All PCI device descriptors have these 2 flags
|
|
* with the exact same definition.
|
|
* By storing them here we can use them inside rt2x00pci
|
|
* for some simple entry availability checking.
|
|
*/
|
|
#define TXD_ENTRY_OWNER_NIC FIELD32(0x00000001)
|
|
#define TXD_ENTRY_VALID FIELD32(0x00000002)
|
|
#define RXD_ENTRY_OWNER_NIC FIELD32(0x00000001)
|
|
|
|
/*
|
|
* Register access.
|
|
*/
|
|
static inline void rt2x00pci_register_read(struct rt2x00_dev *rt2x00dev,
|
|
const unsigned long offset,
|
|
u32 *value)
|
|
{
|
|
*value = readl(rt2x00dev->csr.base + offset);
|
|
}
|
|
|
|
static inline void
|
|
rt2x00pci_register_multiread(struct rt2x00_dev *rt2x00dev,
|
|
const unsigned long offset,
|
|
void *value, const u16 length)
|
|
{
|
|
memcpy_fromio(value, rt2x00dev->csr.base + offset, length);
|
|
}
|
|
|
|
static inline void rt2x00pci_register_write(struct rt2x00_dev *rt2x00dev,
|
|
const unsigned long offset,
|
|
u32 value)
|
|
{
|
|
writel(value, rt2x00dev->csr.base + offset);
|
|
}
|
|
|
|
static inline void
|
|
rt2x00pci_register_multiwrite(struct rt2x00_dev *rt2x00dev,
|
|
const unsigned long offset,
|
|
void *value, const u16 length)
|
|
{
|
|
memcpy_toio(rt2x00dev->csr.base + offset, value, length);
|
|
}
|
|
|
|
/*
|
|
* TX data handlers.
|
|
*/
|
|
int rt2x00pci_write_tx_data(struct rt2x00_dev *rt2x00dev,
|
|
struct data_queue *queue, struct sk_buff *skb,
|
|
struct ieee80211_tx_control *control);
|
|
|
|
/**
|
|
* struct queue_entry_priv_pci_rx: Per RX entry PCI specific information
|
|
*
|
|
* @desc: Pointer to device descriptor.
|
|
* @desc_dma: DMA pointer to @desc.
|
|
* @data: Pointer to device's entry memory.
|
|
* @data_dma: DMA pointer to &data.
|
|
*/
|
|
struct queue_entry_priv_pci_rx {
|
|
__le32 *desc;
|
|
dma_addr_t desc_dma;
|
|
|
|
void *data;
|
|
dma_addr_t data_dma;
|
|
};
|
|
|
|
/**
|
|
* struct queue_entry_priv_pci_tx: Per TX entry PCI specific information
|
|
*
|
|
* @desc: Pointer to device descriptor
|
|
* @desc_dma: DMA pointer to @desc.
|
|
* @data: Pointer to device's entry memory.
|
|
* @data_dma: DMA pointer to &data.
|
|
* @control: mac80211 control structure used to transmit data.
|
|
*/
|
|
struct queue_entry_priv_pci_tx {
|
|
__le32 *desc;
|
|
dma_addr_t desc_dma;
|
|
|
|
void *data;
|
|
dma_addr_t data_dma;
|
|
|
|
struct ieee80211_tx_control control;
|
|
};
|
|
|
|
/**
|
|
* rt2x00pci_rxdone - Handle RX done events
|
|
* @rt2x00dev: Device pointer, see &struct rt2x00_dev.
|
|
*/
|
|
void rt2x00pci_rxdone(struct rt2x00_dev *rt2x00dev);
|
|
|
|
/**
|
|
* rt2x00pci_txdone - Handle TX done events
|
|
* @rt2x00dev: Device pointer, see &struct rt2x00_dev.
|
|
* @entry: Entry which has completed the transmission of a frame.
|
|
* @desc: TX done descriptor
|
|
*/
|
|
void rt2x00pci_txdone(struct rt2x00_dev *rt2x00dev, struct queue_entry *entry,
|
|
struct txdone_entry_desc *desc);
|
|
|
|
/*
|
|
* Device initialization handlers.
|
|
*/
|
|
int rt2x00pci_initialize(struct rt2x00_dev *rt2x00dev);
|
|
void rt2x00pci_uninitialize(struct rt2x00_dev *rt2x00dev);
|
|
|
|
/*
|
|
* PCI driver handlers.
|
|
*/
|
|
int rt2x00pci_probe(struct pci_dev *pci_dev, const struct pci_device_id *id);
|
|
void rt2x00pci_remove(struct pci_dev *pci_dev);
|
|
#ifdef CONFIG_PM
|
|
int rt2x00pci_suspend(struct pci_dev *pci_dev, pm_message_t state);
|
|
int rt2x00pci_resume(struct pci_dev *pci_dev);
|
|
#else
|
|
#define rt2x00pci_suspend NULL
|
|
#define rt2x00pci_resume NULL
|
|
#endif /* CONFIG_PM */
|
|
|
|
#endif /* RT2X00PCI_H */
|