UART

UART（通用异步收发器）使用起始位和停止位（而非时钟信号）异步传输数据。接收端 UART 以特定频率（即波特率）读取数据位。

关键参数

波特率 — 通信速率（每秒位数）
起始/停止位 — 帧定界符
奇偶校验位 — 可选的错误检查
数据位 — 每帧 5–9 位
流控 — 通过 CTS/RTS 进行硬件握手

各子系统的传输模式

子系统	传输模式	波特率	备注
Linux	FIFO、CPU DMA	300 bps – 4 Mbps	DMA 适合 Bluetooth 模块
Boot（UEFI）	仅 FIFO	最高 115200	每字符 5–8 位
aDSP	仅 FIFO	115200、230400、460800、921600、1M、3M、6M	每字符 5–8 位

接口组件

设备树源文件

平台	文件
Dragonwing IQ-8275	`arch/arm64/boot/dts/qcom/sa8295p.dtsi`

API

子系统	头文件
Linux	`include/linux/tty.h`
Boot	`QcomPkg/Include/HSUart.h`
aDSP	`adsp_proc/core/api/buses/uart.h`

软件配置

Linux 设备树示例

4 线 UART（带流控）：

uart7: serial@99c000 {
    compatible = "qcom,geni-uart";
    reg = <0 0x0099c000 0 0x4000>;
    clocks = <&gcc GCC_QUPV3_WRAP0_S7_CLK>;
    clock-names = "se";
    pinctrl-names = "default";
    pinctrl-0 = <&qup_uart7_cts>, <&qup_uart7_rts>,
                <&qup_uart7_tx>, <&qup_uart7_rx>;
    interrupts = <GIC_SPI 608 IRQ_TYPE_LEVEL_HIGH>;
    power-domains = <&rpmhpd SA8295P_CX>;
    interconnect-names = "qup-core", "qup-config";
    status = "disabled";
};

QUPAC 访问控制：

// 4-wire HS UART
{ QUPV3_0_SE7, QUPV3_PROTOCOL_UART_4W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }

// 2-wire UART (no flow control)
{ QUPV3_0_SE5, QUPV3_PROTOCOL_UART_2W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, FALSE, FALSE }

内核配置

CONFIG_QCOM_GENI_SE=y
CONFIG_SERIAL_QCOM_GENI=y

在设备树中启用 UART 节点：

+serial1 = &uart7;

+&uart7 {
+    status = "ok";
+};

验证

验证 UART 设备注册

ls /dev/ttyHS*
# Expected: /dev/ttyHS1

dmesg | grep ttyH

配置 UART 设置

stty -F /dev/ttyHS1 115200

运行回环测试

打开两个 SSH 终端。终端 1（写入）：

echo "Hello UART" > /dev/ttyHS1

终端 2（读取）：

cat /dev/ttyHS1

调试

mount -t debugfs none /sys/kernel/debug
echo -n "file qcom_geni_serial.c +p" > /sys/kernel/debug/dynamic_debug/control
echo -n "file serial_core.c +p" > /sys/kernel/debug/dynamic_debug/control
dmesg | grep -i uart
dmesg | grep ttyHS

故障排查

未检测到 UART 设备

lsmod | grep qcom_geni
cat /proc/device-tree/soc/serial@*/status
ls -la /dev/tty*

确认设备树中 status 为 "ok"
确认 CONFIG_SERIAL_QCOM_GENI=y

数据传输失败 / 数据乱码

stty -F /dev/ttyHS1 -a
stty -F /dev/ttyHS1 115200
stty -F /dev/ttyHS1 crtscts    # enable flow control
stty -F /dev/ttyHS1 -crtscts   # disable flow control

权限被拒绝

ls -la /dev/ttyHS*
usermod -a -G dialout $USER

IQ-8275 EVK

关键参数

各子系统的传输模式

接口组件

设备树源文件

API

软件配置

Linux 设备树示例

内核配置

验证

调试

故障排查

资源

​关键参数

​各子系统的传输模式

​接口组件

​设备树源文件

​API

​软件配置

​Linux 设备树示例

​内核配置

​验证

​调试

​故障排查

​资源

关键参数

各子系统的传输模式

接口组件

设备树源文件

API

软件配置

Linux 设备树示例

内核配置

验证

调试

故障排查

资源