WK2124 软件包
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 设备名称、中断引脚号和芯片晶振频率；
