1 介绍

WK2124 软件包是为WK2124 SPI转四串口扩展芯片而开发的RT-Thread驱动包。通过RT-Thread SPI 设备和RT-Thread UART 设备驱动框架，为RT-Thread系统新增最多四路串口字符设备。与片上串口使用方式一致，实现了对串口设备进行open、close、read、write、control操作的功能，并支持轮询和中断接收两种模式。

WK2124 软件包为串口设备资源不足的产品提供串口扩展的方法，目前已在stm32f429验证通过。

1.1 目录结构

wk2124-latest/
├── ChangeLog.md # 修改记录
├── LICENSE # 软件包许可证
├── README.md # 软件包使用说明
├── sample # 串口使用程序样例
│ ├── uart_int_sample.c # 中断模式
│ └── uart_sample.c # 轮询模式
├── SConscript # RT-Thread 默认的构建脚本
├── wk2124s.c # wk2124 驱动
├── wk2124s.h # wk2124 驱动头文件
├── wk2124_usart.c # wk2124 spi及uart驱动文件
└── wk2124_usart.h # wk2124 spi及uart驱动头文件

1.2 许可证

AT24CXX 软件包遵循 Apache-2.0 许可，详见 LICENSE 文件。

1.3 依赖

RT-Thread 4.0.1+
SPI 驱动：WK2124 设备使用 SPI 进行数据通讯，需要系统 SPI 驱动框架支持；
PIN 驱动：用于处理设备中断引脚；

2 获取软件包

使用 wk2124 软件包需要在 RT-Thread 的包管理器中选择它，具体路径如下：

RT-Thread online packages
peripheral libraries and drivers --->
[] wk2124: spi wk2124 driver library. --->
--- wk2124: spi wk2124 driver library.
[] Enable UART SWK1
[] Enable UART SWK2
[] Enable UART SWK3
[*] Enable UART SWK4
WK2124 device configure --->
(spi2dev) SPI device name
(17) IRQ pin number
Select crystal frequency (11.0592MHz) --->
( ) 1.8432MHz
( ) 3.6864MHz
( ) 7.3728MHz
(X ) 11.0592MHz
( ) 14.7456MHz
( ) 8MHz
( ) 16MHz
( ) 24MHz
( ) 32MHz
Version (latest) --->

每个功能的配置说明如下：

Enable UART SWK1：使能串行字符设备uart swk1
Enable UART SWK2：使能串行字符设备uart swk2
Enable UART SWK3：使能串行字符设备uart swk3
Enable UART SWK4：使能串行字符设备uart swk4
WK2124 device configure：配置使用设备的参数
SPI device name：配置使用 SPI 的设备名称（注意需设置为非 SPI 总线设备）
IRQ pin number：配置设备连接的中断引脚号（根据实际使用引脚号修改）
Select crystal frequency：wk2124硬件电路的晶振频率（影响串口波特率）
Version：配置软件包版本，默认最新版本。
然后让 RT-Thread 的包管理器自动更新，或者使用 pkgs --update 命令更新包到 BSP 中。

3 使用 wk2124 软件包

按照前文介绍，获取 wk2124 软件包并配置参数项。软件包编译进RT-Thread系统以后，通过宏定义INIT_ENV_EXPORT(wk2124_device_init)，软件包会在开机时自动初始化，并产生串行字符设备。

初始化信息

\ | /

RT - Thread Operating System
/ | \ 4.0.1 build Aug 25 2020
2006 - 2019 Copyright by rt-thread team
.....
[I/drv] RT-Thread WK2124 package initialize success.
......
msh />

串行字符设备

msh />list_device
device type ref count

......
uartswk4 Character Device 0
uartswk3 Character Device 0
uartswk2 Character Device 0
uartswk1 Character Device 0
......
uartswk1—4串行字符设备支持轮询和中断接收两种模式（不支持DMA模式），使用方法可参考RT-Thread UART设备使用文档和sample文件夹。

4 注意事项

获取软件包时，需要注意正确配置使用的 SPI 设备名称、中断引脚号和芯片晶振频率；

原作者：Michael_Lee