mtk7621驱动

Posted 2022-04-26 smartvxworks

mtk7621驱动

无线驱动在完成驱动注册的同时，需要进行 cfg80211接口注册（提供命令支持）。
 

1. 驱动

mtk wifi驱动基于pci进行扩展，第一个文件：/os/linux/pci_main_dev.c

文件用于创建和注册基于pci接口的网络设备，PCI设备上有三种地址空间：PCI的I/O空间、PCI的存储空间和PCI的配置空间。CPU可以访问PCI设备上的所有地址空间，其中I/O空间和存储空间提供给设备驱动程序使用，而配置空间则由Linux内核中的PCI初始化代码使用。内核在启动时负责对所有PCI设备进行初始化，配置好所有的PCI设备，包括中断号以及I/O基址，并在文件/proc/pci中列出所有找到的PCI设备，以及这些设备的参数和属性。

Linux驱动程序通常使用结构（struct）来表示一种设备，而结构体中的变量则代表某一具体设备，该变量存放了与该设备相关的所有信息。好的驱动程序都应该能驱动多个同种设备，每个设备之间用次设备号进行区分，如果采用结构数据来代表所有能由该驱动程序驱动的设备，那么就可以简单地使用数组下标来表示次设备号。

1.1 数据结构

1 static struct pci_device_id rt_pci_tbl[] DEVINITDATA =

PCI_DEVICE(NIC_PCI_VENDOR_ID, NIC3091_PCIe_DEVICE_ID),

#ifdef RT8592

PCI_DEVICE(NIC_PCI_VENDOR_ID, NIC8592_PCIe_DEVICE_ID),

#endif /* RT8592 */

#ifdef MT76x2

PCI_DEVICE(0x1400, NIC7650_PCIe_DEVICE_ID),

PCI_DEVICE(0x1400, NIC7662_PCIe_DEVICE_ID),

PCI_DEVICE(MTK_PCI_VENDOR_ID, NIC7662_PCIe_DEVICE_ID),

PCI_DEVICE(MTK_PCI_VENDOR_ID, NIC7632_PCIe_DEVICE_ID),

PCI_DEVICE(MTK_PCI_VENDOR_ID, NIC7612_PCIe_DEVICE_ID),

PCI_DEVICE(MTK_PCI_VENDOR_ID, NIC7602_PCIe_DEVICE_ID),

#endif /* MT76x2 */

/* terminate list */

;

struct pci_device_id

         __u32 vendor,device;                    //厂商和设备ID

         __u32 subvendor,subdevice;          //子系统和设备ID

         __u32 class,class_mask;                //类、子类、prog-if三元组

         kernel_ulong_t driver_data;           //驱动私有数据

pci_device_id 用MODULE_DEVICE_TABLE映射到用户空间。
 

2 struct pci_driver

struct list_head node;

const char *name;

const struct pci_device_id *id_table; /* must be non-NULL for probe to be called */

int (*probe) (struct pci_dev *dev, const struct pci_device_id *id); /* New device inserted */

void (*remove) (struct pci_dev *dev); /* Device removed (NULL if not a hot-plug capable driver) */

int (*suspend) (struct pci_dev *dev, pm_message_t state); /* Device suspended */

int (*suspend_late) (struct pci_dev *dev, pm_message_t state);

int (*resume_early) (struct pci_dev *dev);

int (*resume) (struct pci_dev *dev); /* Device woken up */

void (*shutdown) (struct pci_dev *dev);

int (*sriov_configure) (struct pci_dev *dev, int num_vfs); /* PF pdev */

const struct pci_error_handlers *err_handler;

struct device_driver driver;

struct pci_dynids dynids;

;
 

3 struct pci_dev

struct list_head bus_list;

/* 总线设备链表元素bus_list：每一个pci_dev结构除了链接到全局设备链表中外，还会通过这个成员连接到其所属PCI总线的设备链表中。每一条PCI总线都维护一条它自己的设备链表视图，以便描述所有连接在该PCI总线上的设备，其表头由PCI总线的pci_bus结构中的 devices成员所描述t*/

struct pci_bus *bus;

/* 总线指针bus：指向这个PCI设备所在的PCI总线的pci_bus结构。因此，对于桥设备而言，bus指针将指向桥设备的主总线（primary bus），也即指向桥设备所在的PCI总线*/

struct pci_bus *subordinate;

/* 指针subordinate：指向这个PCI设备所桥接的下级总线。这个指针成员仅对桥设备才有意义，而对于一般的非桥PCI设备而言，该指针成员总是为NULL*/

 

void *sysdata;

/* 无类型指针sysdata：指向一片特定于系统的扩展数据*/

 

struct proc_dir_entry *procent;

/* 指针procent：指向该PCI设备在／proc文件系统中对应的目录项*/

 

unsigned int devfn;

/* devfn：这个PCI设备的设备功能号，也成为PCI逻辑设备号（0－255）。其中bit[7:3]是物理设备号（取值范围0－31），bit[2:0]是功能号（取值范围0－7）。 */

 

unsigned short vendor;

/* vendor：这是一个16无符号整数，表示PCI设备的厂商ID*/

 

unsigned short device;

/*device：这是一个16无符号整数，表示PCI设备的设备ID */

unsigned short subsystem_vendor;

/* subsystem_vendor：这是一个16无符号整数，表示PCI设备的子系统厂商ID*/

 

unsigned short subsystem_device;

/* subsystem_device：这是一个16无符号整数，表示PCI设备的子系统设备ID。*/

 

unsigned int class;

/* class：32位的无符号整数，表示该PCI设备的类别，其中，bit［7：0］为编程接口，bit［15：8］为子类别代码，bit ［23：16］为基类别代码，bit［31：24］无意义。显然，class成员的低3字节刚好对应与PCI配置空间中的类代码*/

u8 revision; /* PCI revision, low byte of class word */

u8 hdr_type; /* PCI header type (`multi' flag masked out) */

u8 pcie_cap; /* PCI-E capability offset */

u8 msi_cap; /* MSI capability offset */

u8 msix_cap; /* MSI-X capability offset */

u8 pcie_mpss:3; /* PCI-E Max Payload Size Supported */

u8 rom_base_reg; /* which config register controls the ROM */

u8 pin; /* which interrupt pin this device uses */

u16 pcie_flags_reg; /* cached PCI-E Capabilities Register */

 

struct pci_driver *driver;

/* 指针driver：指向这个PCI设备所对应的驱动程序定义的pci_driver结构。每一个pci设备驱动程序都必须定义它自己的pci_driver结构来描述它自己。*/

 

u64 dma_mask;

/*dma_mask：用于DMA的总线地址掩码，一般来说，这个成员的值是0xffffffff。数据类型dma_addr_t定义在include/asm/types.h中，在x86平台上，dma_addr_t类型就是u32类型*/

 

struct device_dma_parameters dma_parms;

 

pci_power_t current_state;

/* 当前操作状态 */

u8 pm_cap; /* PM capability offset */

unsigned int pme_support:5; /* Bitmask of states from which PME#

can be generated */

unsigned int pme_interrupt:1;

unsigned int pme_poll:1; /* Poll device's PME status bit */

unsigned int d1_support:1; /* Low power state D1 is supported */

unsigned int d2_support:1; /* Low power state D2 is supported */

unsigned int no_d1d2:1; /* D1 and D2 are forbidden */

unsigned int no_d3cold:1; /* D3cold is forbidden */

unsigned int d3cold_allowed:1; /* D3cold is allowed by user */

unsigned int mmio_always_on:1; /* disallow turning off io/mem

decoding during bar sizing */

unsigned int wakeup_prepared:1;

unsigned int runtime_d3cold:1; /* whether go through runtime

D3cold, not set for devices

powered on/off by the

corresponding bridge */

unsigned int d3_delay; /* D3->D0 transition time in ms */

unsigned int d3cold_delay; /* D3cold->D0 transition time in ms */

 

pci_channel_state_t error_state; /* current connectivity state */

struct device dev; /* Generic device interface */

 

int cfg_size;

/* 配置空间的大小 */

 

unsigned int irq;

struct resource resource[DEVICE_COUNT_RESOURCE]; /* I/O and memory regions + expansion ROMs */

 

bool match_driver; /* Skip attaching driver */

/* These fields are used by common fixups */

unsigned int transparent:1; /* Transparent PCI bridge */

unsigned int multifunction:1;/* Part of multi-function device */

/* keep track of device state */

unsigned int is_added:1;

unsigned int is_busmaster:1; /* device is busmaster */

unsigned int no_msi:1; /* device may not use msi */

unsigned int block_cfg_access:1; /* config space access is blocked */

unsigned int broken_parity_status:1; /* Device generates false positive parity */

unsigned int irq_reroute_variant:2; /* device needs IRQ rerouting variant */

unsigned int msi_enabled:1;

unsigned int msix_enabled:1;

unsigned int ari_enabled:1; /* ARI forwarding */

unsigned int is_managed:1;

unsigned int is_pcie:1; /* Obsolete. Will be removed.

Use pci_is_pcie() instead */

unsigned int needs_freset:1; /* Dev requires fundamental reset */

unsigned int state_saved:1;

unsigned int is_physfn:1;

unsigned int is_virtfn:1;

unsigned int reset_fn:1;

unsigned int is_hotplug_bridge:1;

unsigned int __aer_firmware_first_valid:1;

unsigned int __aer_firmware_first:1;

unsigned int broken_intx_masking:1;

unsigned int io_window_1k:1; /* Intel P2P bridge 1K I/O windows */

pci_dev_flags_t dev_flags;

atomic_t enable_cnt; /* pci_enable_device has been called */

 

u32 saved_config_space[16]; /* config space saved at suspend time */

struct hlist_head saved_cap_space;

struct bin_attribute *rom_attr; /* attribute descriptor for sysfs ROM entry */

int rom_attr_enabled; /* has display of the rom attribute been enabled? */

struct bin_attribute *res_attr[DEVICE_COUNT_RESOURCE]; /* sysfs file for resources */

struct bin_attribute *res_attr_wc[DEVICE_COUNT_RESOURCE]; /* sysfs file for WC mapping of resources */

#ifdef CONFIG_PCI_MSI

struct list_head msi_list;

struct kset *msi_kset;

#endif

struct pci_vpd *vpd;

#ifdef CONFIG_PCI_ATS

union

struct pci_sriov *sriov; /* SR-IOV capability related */

struct pci_dev *physfn; /* the PF this VF is associated with */

;

struct pci_ats *ats; /* Address Translation Service */

#endif

phys_addr_t rom; /* Physical address of ROM if it's not from the BAR */

size_t romlen; /* Length of ROM if it's not from the BAR

;
 

1.2关键函数

1.2.1 rt_pci_init_module

调用函数pci_register_driver(&rt_pci_driver); 注册设备

1.2.2 rt_pci_probe

主要函数分析

1 rv = pci_enable_device(pdev)

唤醒和使能设备
 

2 rv = pci_request_regions(pdev, print_name)

函数通知内核，当前PCI将使用这些内存地址，其他设备不能再使用了
 

3 csr_addr = (unsigned long) ioremap(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0));

物理地址与虚拟地址进行映射
 

4 pci_set_master(pdev);

设置设备具有获得总线的能力，即调用这个函数，使设备具备申请使用PCI总线的能力
 

5 rv = RTMPAllocAdapterBlock(handle, &pAd);

适配器申请内存， 并进行初始化。(包括beaconbuf申请\\rx ring \\tx ring 等初始化)。
 

6 RTMP_DRIVER_PCI_CSR_SET(pAd, csr_addr);

设置pci 对应的虚拟地址映射
 

7 RTMP_DRIVER_PCIE_INIT(pAd, pdev);

设置wlan芯片相关寄存器设置 以及pcie的初始化,调用mac目录下的接口函数，对寄存器进行设置.
 

8 net_dev = RtmpPhyNetDevInit(pAd, &netDevHook);

实现物理层网络设备的创建、初始化、以及相关结构接口的初始化，主要是结构体的创建。
 

9 CFG80211_Register(pAd, &(pdev->dev), net_dev);

实现cfg80211网络设备模块的注册, 提供设备cfg80211接口命令：
os/linux/cfg80211/cfg80211.c
struct cfg80211_ops CFG80211_Ops =
#if (LINUX_VERSION_CODE < KERNEL_VERSION(3,4,0))
 .set_beacon = CFG80211_OpsSetBeacon,
 .add_beacon = CFG80211_OpsAddBeacon,
 .del_beacon = CFG80211_OpsDelBeacon,
#else
 .start_ap     = CFG80211_OpsStartAp,
 .change_beacon = CFG80211_OpsChangeBeacon,
 .stop_ap     = CFG80211_OpsStopAp,
#endif /* LINUX_VERSION_CODE 3.4 */

 /* set channel for a given wireless interface */
#if (LINUX_VERSION_CODE >= KERNEL_VERSION(3,6,0))
 //.set_monitor_channel = CFG80211_OpsMonitorChannelSet,
#else
 .set_channel      = CFG80211_OpsChannelSet,
#endif /* LINUX_VERSION_CODE: 3.6.0 */
 
 /* change type/configuration of virtual interface */
 .change_virtual_intf = CFG80211_OpsVirtualInfChg,
 .add_virtual_intf           = CFG80211_OpsVirtualInfAdd,
 .del_virtual_intf           = CFG80211_OpsVirtualInfDel,

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(3,6,0))
 .start_p2p_device = CFG80211_start_p2p_device,
 .stop_p2p_device = CFG80211_stop_p2p_device,
#endif /* LINUX_VERSION_CODE: 3.6.0 */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,30))
 /* request to do a scan */
 /*
 Note: must exist whatever AP or STA mode; Or your kernel will crash
 in v2.6.38.
 */
 .scan = CFG80211_OpsScan,
#endif /* LINUX_VERSION_CODE */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,31))
#endif /* LINUX_VERSION_CODE */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,32))
 /* set the transmit power according to the parameters */
 .set_tx_power = CFG80211_OpsTxPwrSet,
 /* store the current TX power into the dbm variable */
 .get_tx_power = CFG80211_OpsTxPwrGet,
 /* configure WLAN power management */
 .set_power_mgmt = CFG80211_OpsPwrMgmt,
 /* get station information for the station identified by @mac */
 .get_station = CFG80211_OpsStaGet,
 /* dump station callback */
 .dump_station = CFG80211_OpsStaDump,
 /* notify that wiphy parameters have changed */
 .set_wiphy_params = CFG80211_OpsWiphyParamsSet,
 /* add a key with the given parameters */
 .add_key = CFG80211_OpsKeyAdd,
 /* get information about the key with the given parameters */
 .get_key = CFG80211_OpsKeyGet,
 /* remove a key given the @mac_addr */
 .del_key = CFG80211_OpsKeyDel,
 /* set the default key on an interface */
 .set_default_key = CFG80211_OpsKeyDefaultSet,
#ifdef DOT11W_PMF_SUPPORT
#if (LINUX_VERSION_CODE >= KERNEL_VERSION(3,10,0))
 .set_default_mgmt_key = CFG80211_OpsMgmtKeyDefaultSet,
#endif /* LINUX_VERSION_CODE */
#endif /* DOT11W_PMF_SUPPORT */

 /* connect to the ESS with the specified parameters */
 .connect = CFG80211_OpsConnect,
 /* disconnect from the BSS/ESS */
 .disconnect = CFG80211_OpsDisconnect,
#endif /* LINUX_VERSION_CODE */

#ifdef RFKILL_HW_SUPPORT
 /* polls the hw rfkill line */
 .rfkill_poll = CFG80211_OpsRFKill,
#endif /* RFKILL_HW_SUPPORT */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,33))
 /* get site survey information */
 //.dump_survey = CFG80211_OpsSurveyGet,
 /* cache a PMKID for a BSSID */
 .set_pmksa = CFG80211_OpsPmksaSet,
 /* delete a cached PMKID */
 .del_pmksa = CFG80211_OpsPmksaDel,
 /* flush all cached PMKIDs */
 .flush_pmksa = CFG80211_OpsPmksaFlush,
#endif /* LINUX_VERSION_CODE */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,34))
 /*
 Request the driver to remain awake on the specified
 channel for the specified duration to complete an off-channel
 operation (e.g., public action frame exchange).
 */
 .remain_on_channel = CFG80211_OpsRemainOnChannel,
 /* cancel an on-going remain-on-channel operation */
 .cancel_remain_on_channel =  CFG80211_OpsCancelRemainOnChannel,
#if (LINUX_VERSION_CODE < KERNEL_VERSION(2,6,37))
 /* transmit an action frame */
 .action = NULL,
#else 
 .mgmt_tx                    = CFG80211_OpsMgmtTx,
#endif /* LINUX_VERSION_CODE */
#endif /* LINUX_VERSION_CODE */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,38))
  .mgmt_tx_cancel_wait       = CFG80211_OpsTxCancelWait,
#endif /* LINUX_VERSION_CODE */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,35))
 /* configure connection quality monitor RSSI threshold */
 .set_cqm_rssi_config = NULL,
#endif /* LINUX_VERSION_CODE */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,37))
 /* notify driver that a management frame type was registered */
 .mgmt_frame_register = CFG80211_OpsMgmtFrameRegister,
#endif /* LINUX_VERSION_CODE */

#if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,38))
 /* set antenna configuration (tx_ant, rx_ant) on the device */
 .set_antenna = NULL,
 /* get current antenna configuration from device (tx_ant, rx_ant) */
 .get_antenna = NULL,
#endif /* LINUX_VERSION_CODE */
 .change_bss                             = CFG80211_OpsChangeBss,
 .del_station                            = CFG80211_OpsStaDel, 
 .add_station                            = CFG80211_OpsStaAdd,
 .change_station                         = CFG80211_OpsStaChg,
// .set_bitrate_mask                       = CFG80211_OpsBitrateSet,
#ifdef CONFIG_NL80211_TESTMODE
        .testmode_cmd                           = CFG80211_OpsTestModeCmd,
#endif /* CONFIG_NL80211_TESTMODE */
;

 

10 RTMP_DRIVER_OP_MODE_GET(pAd, &OpMode);

获取当前设备wlan设备的工作模式
 

11 rv = RtmpOSNetDevAttach(OpMode, net_dev, &netDevHook);

实现网络设备相应回调函数的初始化以及网络设备的注册
 

12 RtmpOSNetDevAddrSet(OpMode, net_dev, &mac_addr[0], NULL);

设置网络设备的mac地址

注释： 一般调用ioctl接口实现一些相关命令处理，函数接口 RTMP_COM_IoctlHandle()

位置/src/common/comm_cfg.c文件
 

1.2.3 rt_pci_resume

驱动唤醒时调用函数.
1 调用函数rt28xx_open，调用函数进行网络设备相关初始化