aubrcool / marvellwifi

Marvell WiFi driver for rt-thread

Marvell WiFi

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

Hardware Requirements

ROM: 512KB或以上
RAM: 128KB或以上

WiFi Chips Support

1. 88w8782
2. 88w8801
3. 88w8797(尚未测试)
   

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):  
若希望通过scons编译，请在rtconfig.py中指定toolchains为armcc，并在CFLAGS中添加 --gnu):

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文件夹下的固件放到该目录下。

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

Usage

提供msh下命令，键入

mwifi

可查看用法：

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到这个地址：[email protected]