# marvellwifi

**Repository Path**: hawkr/marvellwifi

## Basic Information

- **Project Name**: marvellwifi
- **Description**: Marvell WiFi driver for rt-thread
- **Primary Language**: C
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2024-07-16
- **Last Updated**: 2024-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Marvell WiFi
**Marvell WiFi** 是一款运行在RT-Thread实时操作系统上的sdio wifi驱动软件。

# Hardware Requirements
ROM: 512KB或以上  
RAM: 128KB或以上  

# WiFi Chips Support
1. 88w8782  
2. 88w8801  
3. 88w8797(尚未测试)  
![88w8782.png][1]
![88w8801.png][2]

# Features
1. STA, UAP模式(可共存，但无路由)
2. 认证方式: OPEN/WPA-PSK/WPA2-PSK
3. 自动重连
4. 低功耗模式
5. 速率高(stm32f407驱动可达2MB/s)

# Compiler
1.可以使用GCC编译  
2.或者添加到MDK5工程中编译  
(注意: 由于驱动含有大量gcc特性，请在编译器C/C++选项下Misc Controls中添加 --gnu):  
![mdk5(--gnu).png][3]  
若希望通过scons编译，请在rtconfig.py中指定toolchains为armcc，并在CFLAGS中添加
--gnu):  
![armcc(--gnu).png][4]
# Components Dependence
1. sdio驱动框架(RT_USING_SDIO)
2. Lwip协议栈(RT_USING_LWIP)
3. dfs虚拟文件系统(RT_USING_DFS)
4. libc库(RT_USING_LIBC)
5. rt_hw_us_delay(请在bsp中自行实现)
6. sdio host驱动(请在bsp中自行实现)
7. dhcpd协议(LWIP_USING_DHCPD optional，UAP模式时用到)

# Adding Method
利用RT-Thread官方提供的env工具获取pakage并生成工程  
或手动下载pakage添加到现有工程目录下，在rt_config.h中开启以下宏，并用scons工具重新生成mdk工程:

    #define PKG_USING_WLANMARVELL
    #define MARVELLWIFI_USING_STA

# Initialize
第一步：硬复位wifi芯片，可连接MCU复位电路或通过GPIO控制实现。  
第二步：若使用组件初始化，则只需开启以下宏：

    #define RT_USING_COMPONENTS_INIT

否则请先手动初始化本驱动所依赖的其他组件，再调用

    mwifi_system_init();

注意，在第一次使用前，请在目标板文件系统中新建目录：'/mrvl'，并将package中的FwImage文件夹下的固件放到该目录下。  
![firmware.png][5]

驱动加载时需要为芯片烧写固件，若加载成功可以在终端命令行中看到如下信息：  
![initialize.png][6]

# Usage
提供msh下命令，键入

    mwifi

可查看用法：  
![usage.png][7]

## Example

    mwifi mlan0 connect SSID -k PASSWORD    //连接SSID，密码PASSWORD
    mwifi mlan0 disconnect                  //断开连接
    mwifi mlan0 reassoc -e                  //开启自动重连
    mwifi mlan0 pwrsave -e                  //进入低功耗模式
    mwifi mlan0 scan                        //扫描附近的热点

更多用法，请参考mwifi.c

# Attention
1. 使用时注意调整任务优先级：tcpip > MOAL_WORKQ > sdio_irq = etx
2. 自动重连功能(MARVELLWIFI_STA_REASSOCIATION)仍处于测试阶段，请不要在实际项目中使用该功能。

***

如果在使用过程中有任何疑问，欢迎发起issues或email到这个地址：`jianb1995@hotmail.com`


  [1]: image/88w8782.png "88w8782.png"
  [2]: image/88w8801.png "88w8801.png"
  [3]: image/mdk5(--gnu).png "mdk5(--gnu).png"
  [4]: image/armcc(--gnu).png "armcc(--gnu).png"
  [5]: image/firmware.png "firmware.png"
  [6]: image/initialize.png "initialize.png"
  [7]: image/usage.png "usage.png"