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
|