在嵌入式開發中，UART（通用異步收發傳輸器）是實現設備間數據交互的關鍵接口，廣泛應用于調試、傳感器通信等場景。瑞芯微（Rockchip）平臺針對不同操作系統（Linux、RT-Thread）提供了完善的UART開發支持，本文將結合官方開發指南，從功能特點、驅動配置、測試驗證三個維度，帶大家快速掌握RK平臺UART開發技巧，文末還附上知識腦圖方便梳理思路～

一、RK UART核心功能特點

無論基于Linux還是RT-Thread系統，RK平臺UART均以16550A串口標準為基礎，核心功能保持一致，實際支持情況需以具體芯片手冊為準：

?數據格式靈活：支持5-8位數據位、1/1.5/2位停止位，僅支持奇校驗/偶校驗（不支持mark/space校驗）。

?高效傳輸能力：自帶32字節或64字節的收發FIFO，最高支持4M波特率（需配合芯片時鐘分頻策略），支持中斷傳輸和DMA傳輸兩種模式。

?增強功能支持：部分UART模塊支持硬件自動流控（RTS+CTS）和串口喚醒系統（需修改trust固件）。

二、Linux系統下UART開發實戰

Linux系統中，RK UART分為“普通串口”和“控制臺”兩種使用場景，配置流程差異較大，以下以常用的Linux 4.4/4.19內核為例說明。

（一）普通串口配置：三步搞定驅動與參數

普通串口適用于設備間數據通信（如與傳感器、模塊交互），核心是完成驅動路徑確認、配置項開啟和DTS參數修改。

1.明確驅動路徑

Linux 3.10內核使用獨立驅動文件drivers/tty/serial/rk_serial.c；Linux 4.4及以上內核采用8250通用串口驅動，核心文件包括：

?drivers/tty/serial/8250/8250_core.c（驅動核心）

?drivers/tty/serial/8250/8250_dw.c（Synopsis DesignWare適配）

?drivers/tty/serial/8250/8250_dma.c（DMA功能支持）

2. menuconfig開啟配置

進入內核配置界面，按以下路徑勾選UART相關選項，建議使用RK SDK默認配置：

Device Drivers--->Characterdevices--->  Serial drivers--->   [*]8250/16550andcompatible serial support（勾選8250驅動）   [*] Rockchip serial port support（RK專屬選項）

3. DTS參數配置（關鍵?。?/span>

DTS（設備樹）用于定義UART硬件資源，以RK3568芯片UART1為例，典型配置如下，僅允許修改標注的可配置參數：

&uart1 {  compatible ="rockchip,rk3568-uart","snps,dw-apb-uart";  reg = <0x00xfe6500000x00x100>;//硬件地址（不可修改）  interrupts = 117IRQ_TYPE_LEVEL_HIGH>;//中斷號（不可修改）  clocks = <&cru SCLK_UART1>, <&cru PCLK_UART1>;//時鐘（不可修改）  clock-names ="baudclk","apb_pclk";//時鐘名稱（不可修改）  reg-shift= <2>;//寄存器移位（不可修改）  reg-io-width = <4>;//寄存器寬度（不可修改）   // 可配置參數1：DMA使能/關閉  dma-names ="tx","rx";//"tx"/"rx"開啟，"!tx"/"!rx"關閉  // 可配置參數2：引腳復用（含流控引腳）  pinctrl-names ="default";  pinctrl-0= <&uart1m0_xfer &uart1m0_ctsn &uart1m0_rtsn>;//開啟流控引腳  // 可配置參數3：模塊使能/關閉  status ="okay";//"okay"開啟，"disabled"關閉  // 可配置參數4：串口喚醒（需配合trust固件）  wakeup-source;};

示例需求：開啟RK3568 UART1，啟用DMA和硬件流控。

DTS修改后：如上配置，確保dma-names為"tx"/"rx"，pinctrl-0包含流控引腳，status設為"okay"。

4.波特率配置與設備注冊

?波特率計算：UART波特率=工作時鐘源/內部分頻系數/ 16，驅動會自動根據配置的波特率獲取時鐘，常用波特率（115200、921600、1.5M、3M、4M）均穩定支持。

?設備注冊驗證：系統啟動后，若日志出現fe650000.serial: ttyS1 at MMIO 0xfe650000 (irq = 67, base_baud = 1500000) is a 16550A，說明設備注冊成功，對應節點為/dev/ttyS1（可通過DTS的aliases修改編號）。

（二）控制臺配置：作為系統調試接口

控制臺串口用于輸出系統日志、執行調試命令，基于fiq_debugger實現，以UART2為例：

1.驅動路徑

?Linux 3.10：arch/arm/mach-rockchip/rk_fiq_debugger.c

?Linux 4.4及以上：drivers/soc/rockchip/rk_fiq_debugger.c

核心驅動文件：drivers/staging/android/fiq_debugger/fiq_debugger.c

2.配置流程

1.menuconfig開啟：

Device Drivers --->[*]Staging drivers ---> [*]Android --->  [*]Rockchip FIQ Debugger

1.DTS配置：需禁用對應普通串口，配置bootargs和fiq-debugger節點：

chosen: chosen {  bootargs ="earlycon=uart8250,mmio32,0xfe660000 console=ttyFIQ0";// 指向控制臺設備};fiq-debugger {  compatible ="rockchip,fiq-debugger";  rockchip,serial-id = <2>;// 使用UART2  rockchip,wake-irq = <0>;  rockchip,irq-mode-enable = <1>;// 1=IRQ模式，0=FIQ模式  rockchip,baudrate = <1500000>;// 僅支持115200或1.5M  interrupts = 252IRQ_TYPE_LEVEL_LOW>;  pinctrl-names ="default";  pinctrl-0= <&uart2m0_xfer>;  status ="okay";};&uart2 {  status ="disabled";// 禁用普通串口模式};

1.parameter.txt配置（Linux 3.10/4.4需添加）：

CMDLINE:console=ttyFIQ0 androidboot.console=ttyFIQ0

（三）Linux UART測試：用官方工具驗證

瑞芯微提供測試程序ts_uart.uart及測試文件send_0x55/send_00_ff（可聯系FAE獲?。?，測試步驟如下：

1.準備工作：通過ADB推送文件到開發板并賦予權限：

adb root && adb remountadb push ts_uart.uart /dataadb push send_0x55 /data && adb push send_00_ff /dataadb shell"su -c chmod +x /data/ts_uart.uart"

1.測試發送：向/dev/ttyS1發送send_0x55文件，波特率1.5M，關閉流控：

adbshell"/data/ts_uart.uart s /data/send_0x55 1500000 0 0 0 /dev/ttyS1"

通過USB轉UART模塊連接PC，用串口工具（如SecureCRT）接收數據，驗證發送是否正常。

1.測試自發自收：無需外部硬件，驗證串口內部收發一致性：

adbshell"/data/ts_uart.uart m /data/send_00_ff 1500000 0 0 0 /dev/ttyS1"

若日志顯示send:1172, receive:1172 total:1172，說明收發一致，測試通過。

1.測試流控：驗證RTS/CTS硬件流控：

?拉高CTS引腳電平，執行發送命令，數據應阻塞；

?釋放CTS為低電平，阻塞數據應繼續發送；

?測量RTS引腳電平，確認能正常高低切換。

三、RT-Thread系統下UART開發實戰

RT-Thread作為輕量級實時操作系統，RK UART配置更簡潔，核心是開啟驅動、配置設備節點和測試驗證。

（一）代碼路徑與配置

1.核心代碼路徑：

?串口框架：components/drivers/serial/（serial.c/serial.h）

?適配層：bsp/rockchip-pisces/drivers/drv_uart.c/drv_uart.h

?測試程序：bsp/rockchip-common/tests/termios_test.c

1.開啟UART配置：進入RT-Thread配置界面，勾選需要的UART設備：

RT-Thread bsp drivers ---> RT-Thread rockchip common drivers ---> [*]Enable UART [*]Enable UART0 [*]Enable UART2  // 根據需求勾選其他UART（如UART1、UART3）

配置完成后，系統會生成/dev/uart0//dev/uart2等設備節點，通過list_device命令可查看：

msh>list_devicedevice    type    refcount------    -------------------- ----------uart2    CharacterDevice  0uart0    CharacterDevice  0

（二）串口測試與控制臺配置

1.開啟測試程序：

RT-Thread bsp testcase---> [*] Enable BSP Common TEST [*] Enable BSP Common UART TESTRT-Thread Components---> Device virtual filesystem--->  [*]Usingdevice virtual filesystem  [*]Usingdevfsfordevice objects POSIX layerandC standard library--->  [*] Enable termios feature

1.測試命令：

?接收數據：termtest r /dev/uart4 115200（從uart4接收，波特率115200）

?發送數據：termtest s /dev/uart4 115200（向uart4發送）

?收發雙向測試：termtest t /dev/uart4 115200

1.控制臺配置：將UART2設為控制臺，輸出rt_kprintf日志：

RT-ThreadKernel--->KernelDeviceObject--->  [*]Usingconsoleforrt_kprintf  (128) the buffer sizeforconsolelog printf  (uart2) the device nameforconsole  (1500000) the baud rateforconsole

（三）波特率支持

RT-Thread下，1.5M及以下波特率可穩定支持，1.5M以上需結合芯片時鐘樹實際測試，確保數據傳輸穩定性。

四、RK UART開發知識腦圖

五、開發注意事項

1.硬件差異：不同RK芯片UART功能可能裁剪（如部分不支持DMA或流控），需優先參考對應芯片手冊。

2.資源沖突：控制臺模式與普通串口模式互斥，啟用fiq_debugger后需禁用對應普通串口節點。

3.DMA使用場景：僅當數據量極大時，DMA才能明顯減輕CPU負載，普通場景建議用中斷模式（啟動更快、資源消耗少）。

掌握以上內容，即可輕松應對RK平臺UART在不同系統下的開發需求，無論是調試接口還是設備通信，都能高效實現～