Evlers/rt-thread_wifi-host-driver

RT-Thread Wi-Fi Host Driver (WHD)

概述

WHD是一个独立的嵌入式Wi-Fi主机驱动程序，它提供了一组与英飞凌WLAN芯片交互的api。WHD是一个独立的固件产品，可以很容易地移植到任何嵌入式软件环境，包括流行的物联网框架，如Mbed OS和Amazon FreeRTOS。因此，WHD包含了RTOS和TCP/IP网络抽象层的钩子。

有关Wi-Fi主机驱动程序的详细信息可在Wi-Fi Host Driver readme文件中找到。
release notes详细说明了当前的版本。您还可以找到有关以前版本的信息。

该存储库已将WHD适应于RT-Thread系统，目前仅支持SDIO总线协议，并使用RT-Thread的mmcsd进行SDIO总线操作。
欢迎大家PR支持更多总线接口和芯片。

移植结构

porting/inc 存放与英飞凌 BSP/HAL 对齐的最小公共头文件，避免必须引入完整的 ModusToolbox SDK 才能编译。
porting/src/bsp 负责 REG_ON、HOST_WAKE 与 SDIO 资源的绑定（参考 porting/src/bsp/whd_bsp.c）以及网络缓冲区适配代码 porting/src/bsp/whd_network_buffer.c。
porting/src/hal 提供 cyhal_* 系列 GPIO/SDIO 实现，把 WHD 的 HAL 调用映射到 RT-Thread 驱动。
porting/src/rtos/whd_rtos.c 将 cyabs RTOS 抽象转换为 RT-Thread 的线程、互斥量、信号量与定时器。
porting/src/resources 包含运行时资源加载器 (resources.c) 与 whd_res_download CLI (download.c)。
porting/src/wlan/whd_wlan.c 负责把驱动注册到 RT-Thread Wi-Fi 框架，同时根据 WHD_PORTING_* Kconfig 选项裁剪功能。

使用

在软件包选中Wifi-Host-Driver(WHD) for RT-Thread

RT-Thread online packages  --->                         # 在线软件包
    IoT - internet of things  --->                      # IOT菜单栏中
        [*] Wifi-Host-Driver(WHD) for RT-Thread.  --->  # 选中该软件包

软件包配置

--- Wifi-Host-Driver(WHD) for RT-Thread
    --- WHD Configuration
        [*] Set country code from host
            (AU) Set the default country code
            (0)  Set the default country code revision
        [ ] Default enable powersave mode
            (200) Set return to sleep delay.(PM2)
        [ ] Using thread initialization
            (10) The priority level value of init thread
            (2048) The stack size for init thread
        --- WHD Thread Configuration
            (8)   The priority level value of WHD thread
            (5120) The stack size for WHD thread
        --- WHD Resources Configuration
            ( ) File System
                (/sdcard/whd/43438A1.bin) Set the file path of the firmware files
                (/sdcard/whd/43438A1.clm_blob) Set the file path of the clm files
                (/sdcard/whd/nvram.txt) Set the file path of the nvram files
            (X) Flash Abstraction Layer(FAL)
                ("whd_firmware") Set the partition name of the firmware files
                ("whd_clm") Set the partition name of the clm files
                ("whd_nvram") Set the partition name of the nvram files
            (1024) Set the block size for resources
    --- Hardware Configuration
        (X) CYW43438
        ( ) CYW4373
        ( ) CYW43012
        ( ) CYW43439
        ( ) CYW43022
        ( ) CYW4343W
        ( ) CYW55500
        ( ) CYW55572
        --- Pin Configuration
            (Number) Select the pin name or number  --->
                (-1) Set the WiFi_REG ON pin number
                (-1) Set the HOST_WAKE_IRQ pin number
            (falling) Select HOST_WAKE_IRQ event type  --->
            (2) Set the interrupt priority for HOST_WAKE_IRQ pin
    --- Porting options
        [*] Using BSP porting
        [*] Using HAL porting
        [*] Using RTOS porting
        [*] Using the malloc/free of RT-Thread
    --- WHD log level
        (Error) Select the log level

WHD_SET_COUNTRY_FROM_HOST 允许主机在运行时下发与目标市场匹配的法规配置 (WHD_COUNTRY_CODE 与 WHD_COUNTRY_CODE_REVISION)，无需重新打包固件资源。
CY_WIFI_DEFAULT_ENABLE_POWERSAVE_MODE、CY_WIFI_DEFAULT_PM2_SLEEP_RET_TIME、CY_WIFI_USING_THREAD_INIT、CY_WIFI_INIT_THREAD_PRIORITY/STACK_SIZE 以及 WHD 线程菜单帮助你根据 BSP 的调度限制选择合适的启动模型。
新的资源菜单取代了旧的“外部存储”开关：若选择文件系统，请将 *.bin、*.clm_blob、nvram.txt 拷贝到对应路径；若选择 FAL，请保证分区存在，并调整 WHD_RESOURCES_BLOCK_SIZE 以匹配吞吐需求。若文件系统挂载较慢，可在 porting/src/resources/resources.c 中重写弱符号 whd_wait_fs_mount()。
WHD_PORTING_BSP、WHD_PORTING_HAL、WHD_PORTING_RTOS 与 WHD_USE_CUSTOM_MALLOC_IMPL 对应 porting 目录下的适配代码：保持打开即可使用 RT-Thread Glue，如需对接英飞凌原生 BSP/HAL/RTOS，可按需关闭。
日志级别开关会为 WHD 的 WPRINT 宏启用不同的输出（仅错误/包含信息/调试/数据追踪），便于排障。

当资源文件存放于文件系统时，请把对应芯片的 firmware/clm/nvram 文件放到上面配置的路径；若使用 FAL，请提前写入相应分区，并通过 whd_res_download 命令刷新内容。

新的 WHD 发行版可能不再在 wifi-host-driver/WHD/COMPONENT_WIFI5/resources 或 wifi-host-driver/WHD/COMPONENT_WIFI6/resources 中附带 *.clm_blob 与 nvram.txt。若仓库缺失这些文件，请向模组/供应商索取官方认证的固件与 NVRAM 组合，避免违背本地射频法规。

当选择 WHD_RESOURCES_IN_EXTERNAL_STORAGE_FS 时，WHD 会直接从文件系统（如 SD 卡、SPI Flash 文件系统、U 盘等）读取资源；只需在启动前确保配置的路径（如 /sdcard/whd/43438A1.bin、/sdcard/whd/43438A1.clm_blob、/sdcard/whd/nvram.txt）已经存在即可，无需再为 FAL 分区。请实现或重写 porting/src/resources/resources.c 中的弱符号 whd_wait_fs_mount()，或在系统启动顺序中保证文件系统驱动已挂载完成，再启动 WHD。

引脚菜单支持使用逻辑名称（例如 “PA.0”）或数字，同时可配置 HOST_WAKE 的触发沿（下降/上升/双沿）及中断优先级，以匹配模组硬件设计。

注意
SDIO驱动需要支持数据流传输，在RT-Thread的bsp中，大多数芯片都未适配数据流传输的功能。
Cortex-M4内核需要软件来计算CRC16并在数据后面发送它，参考数据流传输解决方案。
对于Cortex-M7内核，只需要修改drv_sdio.c文件的一处地方即可，示例如下:

/* 该示例是STM32H750的SDIO驱动程序 */
SCB_CleanInvalidateDCache();

reg_cmd |= SDMMC_CMD_CMDTRANS;
hw_sdio->mask &= ~(SDMMC_MASK_CMDRENDIE | SDMMC_MASK_CMDSENTIE);
hw_sdio->dtimer = HW_SDIO_DATATIMEOUT;
hw_sdio->dlen = data->blks * data->blksize;
hw_sdio->dctrl = (get_order(data->blksize)<<4) |
                    (data->flags & DATA_DIR_READ ? SDMMC_DCTRL_DTDIR : 0) | \
                    /* 增加数据流标志的检测 */
                    ((data->flags & DATA_STREAM) ? SDMMC_DCTRL_DTMODE_0 : 0);
hw_sdio->idmabase0r = (rt_uint32_t)sdio->cache_buf;
hw_sdio->idmatrlr = SDMMC_IDMA_IDMAEN;

资源下载

可以通过ymodem协议下载资源文件。驱动会使用FAL组件来加载资源文件。
资源下载功能依赖于ymodem组件，请确保打开RT_USING_RYM，并在 WHD Resources Configuration 中选择 Flash Abstraction Layer(FAL)。

在终端上执行whd_res_download命令开始下载资源。
该命令需要输入资源文件的分区名。

下载资源文件的实例(使用默认分区名，输入自己的分区名):

/* partition table */
/*      magic_word          partition name      flash name          offset          size            reserved        */
#define FAL_PART_TABLE                                                                                              \
{                                                                                                                   \
{ FAL_PART_MAGIC_WORD,  "whd_firmware",     "onchip_flash",              0,     512 * 1024,         0 },        \
{ FAL_PART_MAGIC_WORD,  "whd_clm",          "onchip_flash",     512 * 1024,      32 * 1024,         0 },        \
{ FAL_PART_MAGIC_WORD,  "whd_nvram",        "onchip_flash",     544 * 1024,      32 * 1024,         0 },        \
}

# 下载固件文件
whd_res_download whd_firmware

# 下载clm文件
whd_res_download whd_clm

# 下载nvram文件
whd_res_download whd_nvram

ymodem可以使用xshell工具，在完成命令输入后，等待xshell启动文件传输。

msh >whd_res_download whd_firmware
Please select the whd_firmware file and use Ymodem to send.

此时，在xshell中右键单击鼠标，选择文件传输到使用ymodem发送。
在 wifi-host-driver/WHD/COMPONENT_WIFI5/resources 目录中，选择和 menuconfig 里芯片一致的 firmware/clm/nvram 文件。
CYW55500 与 CYW55572 属于 Wi-Fi 6 器件，需要从 wifi-host-driver/WHD/COMPONENT_WIFI6/resources 目录拷贝对应的资源文件。

传输完成后，msh将输出如下日志：

Download whd_firmware to flash success. file size: 419799

下载完固件、clm 和 nvram 资源文件后，复位重启即可正常加载。
若在 menuconfig 中选择了 "File System" 模式，可直接把同名的固件/CLM/NVRAM 文件拷贝进配置路径（如将 SD 卡接到电脑并复制至 /whd/），待文件系统挂载完成且 whd_wait_fs_mount() 返回后，WHD 会直接从该路径加载，无需执行 whd_res_download。

资源文件的校验功能（建议打开）

在软件包选中TinyCrypt: A tiny and configurable crypt library

RT-Thread online packages  --->                                   # 在线软件包
security packages  --->                                       # 安全软件包中
    TinyCrypt: A tiny and configurable crypt library  --->    # 选中TinyCrypt

打开TinyCrypt软件包后，资源文件下载完成会自动计算并打印文件的MD5校验和。

芯片支持

CHIP	SDIO	SPI	M2M
CYW4343W	*	x	x
CYW43438	o	x	x
CYW4373	*	x	x
CYW43012	o	x	x
CYW43439	o	x	x
CYW43022	*	x	x
CYW55500	o	x	x
CYW55572	*	x	x

'x' 表示不支持
'o' 表示已测试和支持
'*' 理论上支持，但未经过测试

模组选择

该项目使用新联鑫威(杭州)科技有限公司的英飞凌模组进行测试，以下是模组型号和对应的芯片型号： | 模组型号 | 芯片型号 | | ------------ | ------------ | | CYWL6208 | CYW43438 | | CYWL6312 | CYW43012 | | CYWL6209 | CYW43439 | | CYWL6373 | CYW4373 |

如需模组测试可到新联鑫威淘宝购买。
这家有TF卡转接板，可以很方便的插到开发板的TF卡槽进行测试。

联系方式&支持

邮箱: 1425295900@qq.com
微信：Evlers
如果驱动上有什么问题欢迎提交PR或者联系我一起交流
如果你觉得这个项目不错，并且能够满足您的需求，请打赏打赏我吧~ 感谢支持！！

README_CN.md 12 KB

Permalink Histórico Raw

RT-Thread Wi-Fi Host Driver (WHD)

概述

移植结构

使用

资源下载

资源文件的校验功能（建议打开）

芯片支持

模组选择

联系方式&支持

更多信息

README_CN.md 12 KB Permalink Histórico Raw

RT-Thread Wi-Fi Host Driver (WHD)

概述

移植结构

使用

资源下载

资源文件的校验功能（建议打开）

芯片支持

模组选择

联系方式&支持

更多信息

README_CN.md 12 KB

Permalink Histórico Raw