VBackground-1

# UART Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) UART 设备以异步方式发送数据。因此，时钟信号不会使发送 UART 的位输出与接收 UART 的位采样同步。发送 UART 会向正在传输的数据包中添加起始位和停止位，但不会添加时钟信号。这些位定义了数据包的开始和结束。这样，接收 UART 就知道何时开始读取这些位。当接收 UART 检测到起始位时，便开始以特定频率（称为波特率）读取传入的位。 Figure : 两个 UART 设备之间的数据传输下面列出了用于确定成功传输的参数： - Baud rate - Start bit - Stop bit - Parity bit - Data bits - Flow control 下图所示为 UART 数据包示例。 Figure : UART 数据包 ## 串口特性 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 下表描述了应用程序的UART传输模式。 Table : UART 传输模式 | 子系统 | 传输模式 | 说明 | | --- | --- | --- | | Linux |

FIFO（低速）

CPU DMA（高速）

支持 300 bps 至 4 Mbps 的波特率。

FIFO 模式在其 Rx/Tx 缓存和系统内存之间传输数据

DMA 模式在其 Rx/Tx 缓存和系统内存之间传输数据。如果使用支持更高波特率和更大数据包的高速 UART 驱动器，可以实现更高的性能。例如，蓝牙无线技术连接模块。

| | Boot | FIFO |

Rx/Tx 每个字符 5 位至 8 位。

最高支持 115200 的波特率。

| | aDSP | FIFO |

Rx/Tx 每个字符 5 位至 8 位。

支持的波特率：115200、230400、460800、921600、1000000、3000000 和 6000000。

| ## UART 接口组件 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 下表提供了不同子系统的 UART 驱动程序配置路径。 Table : UART 接口：Linux | 文件类型 | 说明 | | --- | --- | | 设备树源 |

QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi

Dragonwing IQ-9075: https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi

Dragonwing IQ-615: https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16

| | `Pinctrl`设置 |

相应的 QUP v3 串行引擎的引脚控制表位于 <workspace_path_of_LINUX_kernel_image>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/<chipset>.dts。

关于覆盖芯片产品的 DTSI 配置示例，请参阅以下 DTSI 文件。
- QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi
- Dragonwing IQ-9075: https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi

Dragonwing IQ-615: https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16

| | Qualcomm TEE 设置 |

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c

. | Table : UART 接口：Boot（仅限 UEFI） | 文件类型 | 说明 | | --- | --- | | QUP v3 串行引擎配置 |

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/BOOT.MXF.1.0.c1/boot_images/boot/QcomPkg/SocPkg/<chipset>/Settings/UART/UartSettings.c

| | Qualcomm TEE 设置 |

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c

| Table : UART 接口：aDSP/SLPI | 文件类型 | 说明 | | --- | --- | | QUP v3 串行引擎配置 |

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_common/config/<chipset>/adsp/ssc/qup_devcfg.c

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_fw/config/<chipset>/fw_devcfg.c

| | 固件配置设置 |

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_fw/config/<chipset>/fw_devcfg.c

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_fw/config/<chipset>/fw_devcfg.xml

| ### UART API Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 本节列出了以下子系统的 UART API。 - Linux：[https://github.com/torvalds/linux/blob/master/include/linux/tty.h](https://github.com/torvalds/linux/blob/master/include/linux/tty.h) - Boot：QcomPkg/Include/HSUart.h - aDSP: adsp\_proc/core/api/buses/uart.h ## UART 软件设备树配置 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 本节提供 UART 设备树配置的相关信息，以及设备节点的相关文档。 ### Linux 有关内核设备实例的信息，请参阅 [https://github.com/torvalds/linux/blob/master/Documentation/devicetree/bindings/serial/qcom%2Cserial-geni-qcom.yaml](https://github.com/torvalds/linux/blob/master/Documentation/devicetree/bindings/serial/qcom%2Cserial-geni-qcom.yaml)。有关 UART 驱动程序文件的信息，请参阅 [https://github.com/torvalds/linux/blob/master/drivers/tty/serial/qcom_geni_serial.c](https://github.com/torvalds/linux/blob/master/drivers/tty/serial/qcom_geni_serial.c)。 uart7: serial@99c000 { /* Manufacturer model of serial driver */ compatible = "qcom,geni-uart"; /* SE address and size */ reg = <0 0x0099c000 0 0x4000>; /*Clocks for SE */ clocks = <&gcc GCC_QUPV3_WRAP0_S7_CLK>; clock-names = "se"; /* pinctrl setting */ pinctrl-names = "default"; pinctrl-0 = <&qup_uart7_cts>, <&qup_uart7_rts>, <&qup_uart7_tx>, <&qup_uart7_rx>; interrupts = ; power-domains = <&rpmhpd SC7280_CX>; operating-points-v2 = <&qup_opp_table>; interconnects = <&clk_virt MASTER_QUP_CORE_0 0 &clk_virt SLAVE_QUP_CORE_0 0>, <&gem_noc MASTER_APPSS_PROC 0 &cnoc2 SLAVE_QUP_0 0>; interconnect-names = "qup-core", "qup-config"; /* To enable QUPV3 serial engine instance for UART protocol, change Status to OK */ status = "disabled"; }; }Copy to clipboard 关于串行引擎 GPIO 的配置设置，请参阅以下 DTSI 文件。 - QCS6490 和 QCS5430：[https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi) - Dragonwing IQ-9075: [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi) - Dragonwing IQ-615: [https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16](https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16) qup_uart7_cts: qup-uart7-cts-state { pins = "gpio28"; function = "qup07"; }; qup_uart7_rts: qup-uart7-rts-state { pins = "gpio29"; function = "qup07"; }; qup_uart7_tx: qup-uart7-tx-state { pins = "gpio30"; function = "qup07"; }; qup_uart7_rx: qup-uart7-rx-state { pins = "gpio31"; function = "qup07"; }; Copy to clipboard Note: Qualcomm TEE 配置必须在 QUPAC\_Access.c文件内保持一致，以确保可以使用 GPIO/QUP v3。您可以在 /firmware/qualcomm-linux-spf-1-0\_ap\_standard\_oem\_nomodem/TZ.XF.5.0/trustzone\_images/core/settings/buses/qup\_accesscontrol/qupv3/config/<chipset>/QUPAC\_Access.c访问 Qualcomm TEE 镜像。修改所需的设置，或者参考针对 QUP v3 串行引擎的特定实例分配的默认设置。 QUP v3 既支持启用流量控制的 4 线制 UART，也支持未启用流量控制的 2 线制 UART。以下是 Qualcomm TEE 访问的示例，用于控制进入这两种模式。用于启用 UART 协议的 QUP v3 串行引擎配置如下： - 针对 SE7 启用的默认配置（作为 HS UART） { QUPV3_0_SE7, QUPV3_PROTOCOL_UART_4W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, Copy to clipboard - 针对 SE5 的 2 线制 UART 配置 uart5: serial@994000 { compatible = "qcom,geni-uart"; reg = <0 0x00994000 0 0x4000>; clocks = <&gcc GCC_QUPV3_WRAP0_S5_CLK>; clock-names = "se"; pinctrl-names = "default"; pinctrl-0 = <&qup_uart5_tx>, <&qup_uart5_rx>; interrupts = ; power-domains = <&rpmhpd SC7280_CX>; operating-points-v2 = <&qup_opp_table>; interconnects = <&clk_virt MASTER_QUP_CORE_0 0 &clk_virt SLAVE_QUP_CORE_0 0>, <&gem_noc MASTER_APPSS_PROC 0 &cnoc2 SLAVE_QUP_0 0>; interconnect-names = "qup-core", "qup-config"; status = "disabled"; };Copy to clipboard { QUPV3_0_SE5, QUPV3_PROTOCOL_UART_2W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, FALSE, FALSE },Copy to clipboard ### Boot 在 boot 中，可使用 /firmware/qualcomm-linux-spf-1-0\_ap\_standard\_oem\_nomodem/BOOT.MXF.1.0.c1/boot\_images/boot/QcomPkg/SocPkg/<chipset>/Settings/UART/UartSettings.c文件将 QUP v3 串行引擎配置为 UART。 UART_PROPERTIES devices = { // MAIN_PORT 0x00994000, // Serial Engine Base address 0x009C0000,// qup_common base address 0x2001c161, // GPIO TX pin Config 0x2000c171, // GPIO RX Pin Config 0, // gpio_cts_config 0, // gpio_rfr_config 0, // clock_id_index (void*)0, // bus_clock_id (void*)CLK_QUPV3_WRAP0_S5, // core_clock_id 0, // irq number not used 0, //TCSR base 0, // TCSR offset 0 // TCSR value }; Copy to clipboard **GPIO 配置** 下表列出了 GPIO 配置。 Table : UART GPIO 配置 | 位 | 参数 | | :---: | --- | | [0:3] | GPIO 功能 | | [4:13] | GPIO 编号 | | [14] | 方向 | | [15:17] | 上下拉类型 | | [18:21] | 驱动强度 | 您必须根据以下位字段配置每个 GPIO。 /* | RESERVED | GPIO NUM | DRIVE | FUNC | PULL | DIR | ------------------------------------------------------------------------- | 0000 | 0000 | 0001 | 1110 | 0001 | 0001 | 0010 | 0001 | ------------------------------------------------------------------------- */Copy to clipboard ### aDSP 固件在 aDSP 子系统的启动序列期间加载 SSC QUP。因此，配置文件位于 aDSP 编译版本 (/firmware/qualcomm-linux-spf-1-0\_ap\_standard\_oem\_nomodem/ADSP.HT.5.5.c8/adsp\_proc/core/settings/buses/qup\_fw/config/<chipset>/fw\_devcfg.c) 中。以下配置是在 FIFO 模式下向 SSC QUP SE5/6 中加载 UART 固件的示例。 offset, protocol, mode, load_fw, dfs_mode se_cfg se0_cfg = { 0x80000, SE_PROTOCOL_I3C, GSI, TRUE, TRUE }; se_cfg se1_cfg = { 0x84000, SE_PROTOCOL_I2C, GSI, TRUE, TRUE }; se_cfg se2_cfg = { 0x88000, SE_PROTOCOL_I2C, GSI, TRUE, TRUE }; se_cfg se3_cfg = { 0x8C000, SE_PROTOCOL_I2C, GSI, FALSE, TRUE }; se_cfg se4_cfg = { 0x90000, SE_PROTOCOL_SPI, GSI, TRUE, TRUE }; se_cfg se5_cfg = { 0x94000, SE_PROTOCOL_UART, FIFO, TRUE,FALSE }; se_cfg se6_cfg = { 0x98000, SE_PROTOCOL_UART, FIFO, TRUE,FALSE }; Copy to clipboard GPIO 配置：QUP 通用驱动程序中的每个串行引擎都根据协议配置了默认的 GPIO 配置。QUP v3 通用驱动程序可根据 /firmware/qualcomm-linux-spf-1-0\_ap\_standard\_oem\_nomodem/ADSP.HT.5.5.c8/adsp\_proc/core/settings/buses/qup\_common/config/<chipset>/adsp/ssc/qup\_instance\_mapping.c中串行引擎中加载的协议选择 GPIO 配置。可按照如下所示覆盖默认 GPIO 配置。 { .instance_id = 6 , //Instance ID .qup = QUP_SSC, //QUP Type .se_index = 5, //SE ID .se_data = NULL, //devcfg_map .protocol_io_cfg = { TLMM_MAP(TLMM_GPIO_KEEPER ,TLMM_GPIO_2MA,TLMM_GPIO_KEEPER ), //SLEEP CFG TLMM_MAP(TLMM_GPIO_NO_PULL,TLMM_GPIO_6MA,TLMM_GPIO_KEEPER ), //SPI CFG TLMM_MAP(TLMM_GPIO_NO_PULL,TLMM_GPIO_2MA,TLMM_GPIO_NO_PULL), //UART CFG TLMM_MAP(TLMM_GPIO_PULL_UP,TLMM_GPIO_2MA,TLMM_GPIO_NO_PULL), //I2C CFG TLMM_MAP(TLMM_GPIO_PULL_UP,TLMM_GPIO_2MA,TLMM_GPIO_KEEPER ) //I3C CFG }, .se_exclusive = TRUE, } Copy to clipboard TLMM\_MAP 是用于初始化活动和休眠状态 GPIO 配置的宏。以下为 TLMM\_MAP 宏的使用示例。 TLMM_MAP (active state pull type, drive strength, sleep state pull type)Copy to clipboard ## 在 UART 中启用虚拟化 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 本节介绍从客户虚拟机客户端到主机硬件端口的高层流程，该流程将基于内核的虚拟机 (KVM) 视为虚拟机。应该对虚拟化、管理程序和虚拟机技术有基本的了解。 Table : 虚拟化功能 | 虚拟化组件 | 功能介绍 | | --- | --- | | VirtIO |

为半虚拟化管理程序中的一组常见模拟设备提供抽象

使用 UART 设备端口并处理应用程序请求。确保在 KVM 上支持 VirtIO 或虚拟功能输入/输出 (VFIO)

为设备仿真提供通用前端，以标准化接口并提高跨平台的代码重用。

支持实现 VirtIO 标准的虚拟化环境，例如 QEMU/KVM。

| | Hypervisor |

为通用应用程序编程接口 (API) 导出一组通用的模拟设备。

实现一组通用接口，并在一组后端驱动程序后面进行特定设备模拟

| ### 客户虚拟机中通过 UART 实现的 ZigBee 使用案例要识别设备字符名称，请将 Linux 中的 ZigBee 接口枚举为串行接口。例如，如果 ZigBee 通过 UART 连接，则枚举为 /dev/MSMx。 Note: 本节以 /dev/MSM0为例。将其替换为实际的字符设备 ID。 1. 通过运行以下命令禁用 SELinux。 setenforce 0Copy to clipboard 2. 要启用 KVM，请执行以下操作： 1. 将设备启动至 UEFI。 2. 在 BDS 菜单中选择选项 17进入 UEFI 菜单。 3. 选择选项 25进入操作系统配置选择菜单。 4. 使用向上箭头将操作系统类型增加至 2（带 KVM 的 Linux）。 5. 选择 Enter Power Cycle设备。等待设备上线。 6. 验证设备节点。 ls /dev/kvmCopy to clipboard 3. 从 workspace>\builds\kvm\gunyah\_k2l\svm\lemans\_svm\svm\Image.gz推送 KVM 镜像。 adb push Image /mnt/overlay/Copy to clipboard 4. 从 workspace>pkondeti\builds\kvm\gunyah\_k2l\svm\lemans\_svm\svm\yocto.cpio.gz推送 `initrd` 启动镜像。 adb push yocto.cpio /mnt/overlay/Copy to clipboard 5. 要将设备连接到 guest 虚拟机，用户可以使用以下两个选项之一。 - 选项 **A**: 对于快速模拟器 (QEMU) 虚拟器，使用以下命令将 /dev/ttyMSM0 字符设备连接至客户虚拟机。 qemu-system-aarch64 \ -M virt -m 2G \ -initrd \ -kernel \ -device virtio-serial-pci \ -chardev tty,path=/dev/ttyMSM0,id=char0 \ -device virtserialport,chardev=char0,name=zigbee \ -cpu host --enable-kvm -smp 4 -nographicCopy to clipboard - 选项 **B**: 对于 `libvirt` 虚拟器，将以下值复制至 [https://github.qualcomm.com/pkondeti/qli_virt_recipes/blob/main/example/hk-vm.xml](https://github.qualcomm.com/pkondeti/qli_virt_recipes/blob/main/example/hk-vm.xml) 处的文件中。

Copy to clipboard 6. 要查找并验证 `virtio-serial`虚拟串行端口，请运行以下命令列出所有端口。 ls /dev/virtio-ports/zigbeeCopy to clipboard 7. 验证虚拟端口连接。 echo "hello from guest" >> /dev/virtio-ports/zigbeeCopy to clipboard 输出： Hello from guestCopy to clipboard ## UART 工具 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 本节介绍 UART 串行接口驱动程序的各种测试工具和方法，用于确认 UART 数据传输。 ### Linux 更多详细信息，可访问 [https://docs.kernel.org/admin-guide/serial-console.html](https://docs.kernel.org/admin-guide/serial-console.html)。 ## 在内核中启用 UART Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 本节介绍如何在内核中启用 UART。 ### Linux 需要以下驱动程序内核配置才能支持 UART 接口。 - UART 驱动程序：[https://github.com/torvalds/linux/blob/master/drivers/tty/serial/qcom_geni_serial.c](https://github.com/torvalds/linux/blob/master/drivers/tty/serial/qcom_geni_serial.c) - 内核 `defconfig`文件路径：<workspace\_path\_of\_LINUX\_kernel\_image>/sources/kernel /kernel\_platform/kernel/arch/arm64/configs/qcom\_defconfig 启用以下内核配置。 - `CONFIG_QCOM_GENI_SE=y` - `CONFIG_SERIAL_QCOM_GENI=y` 要启用串行节点进行环回验证，需对 /arch/arm64/boot/dts/qcom/<chipset>.dtsi文件应用以下补丁。 --- a/arch/arm64/boot/dts/qcom/.dtsi +++ b/arch/arm64/boot/dts/qcom/.dtsi @@ -70,6 +70,7 @@ spi13 = &spi13; spi14 = &spi14; spi15 = &spi15; + serial1 = &uart7; }; + +&uart7 { + status = "ok"; +}; Copy to clipboard Note: 您应该编译内核配置和设备树更改。编译完成后，您可通过将镜像加载到设备上来验证接口。关于接口验证的信息，请参阅 [验证 UART 接口](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html#uart_verification)部分。 ### Boot/aDSP 有关定制的信息，请参阅 [UART 软件设备树配置](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html#uart_software)部分。 ## UART 定制 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 有关定制 UART 软件的信息，请参阅 [QUP v3 访问控制定制](https://docs.qualcomm.com/doc/80-70020-8SC/topic/references.html#customize-access-control-of-qup)。 ## 验证 UART 接口 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 本节介绍 UART 驱动程序的验证步骤，以及 Qualcomm 驱动程序的测试结果。 ### Linux 请执行以下操作并编译内核配置，以便启用 UART 节点。 1. 要将 UART 状态更改为 OK并将别名更改为特定 UART 节点，请编辑以下 DTSI 文件。 - QCS6490 和 QCS5430：[https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi) - Dragonwing IQ-9075: [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi) - Dragonwing IQ-615: [https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16](https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16) Note: 启用 SSH shell 或使用 ADB shell 运行命令，并在 SSH shell（控制台）窗口中显示输出。有关如何运行 SSH 的更多信息，请参阅 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html) 部分。 aliases { i2c0 = &i2c0; spi15 = &spi15; ++serial1 = &uart7; }; 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 = ; power-domains = <&rpmhpd SC7280_CX>; operating-points-v2 = <&qup_opp_table>; interconnects = <&clk_virt MASTER_QUP_CORE_0 0 &clk_virt SLAVE_QUP_CORE_0 0>, <&gem_noc MASTER_APPSS_PROC 0 &cnoc2 SLAVE_QUP_0 0>; interconnect-names = "qup-core", "qup-config"; ++status = "ok"; };Copy to clipboard 2. 禁用 [https://github.com/torvalds/linux/blob/master/drivers/tty/serial/qcom_geni_serial.c](https://github.com/torvalds/linux/blob/master/drivers/tty/serial/qcom_geni_serial.c)文件的 qcom\_geni\_serial.c 中的 `if` 条件进行环回测试。 //if (mctrl & TIOCM_LOOP) // Disabling the if condition for loopback test port->loopback = RX_TX_CTS_RTS_SORTED;Copy to clipboard 要在 Linux 内核中验证 QUP v3 UART 注册功能，应确保已向 TTY 层正确注册 UART。 1. 在以下 DTSI 文件中禁用 UART 默认用例。 - QCS6490 和 QCS5430：[https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi) - Dragonwing IQ-9075: [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi) - Dragonwing IQ-615: [https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16](https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16) bluetooth: bluetooth { ++ status = "disabled"; Copy to clipboard 随即显示以下输出。 ls /dev/ttyHS1 /dev/ttyHS1 dmesg | grep ttyH [ 3.355487] 99c000.serial: ttyHS1 at MMIO 0x99c000 (irq = 137, base_baud = 0) is a MSMCopy to clipboard 2. 要验证 UART 驱动程序，应进行以下操作： 1. 以 permissive 模式打开 SSH shell 或使用 ADB shell。 2. 注册 UART。 ls /dev/ttyHS*Copy to clipboard 以下为示例输出。 ls /dev/ttyHS* /dev/ttyHS1 Copy to clipboard 根据为 `ttyHS1`添加的别名映射 `serial1 = &uart7` 端口并启用串行引擎。随后将列出在内核中注册的 UART 设备。UART 驱动程序遵循测试步骤来启用环回。在 DUT 中启用 UART 节点后，运行以下命令以验证 DTSI 文件中是否启用了 UART 实例。 Note: 打开两个 SSH shell 或使用 ADB shell 为 UART 环回写入和读取数据。有关如何运行 SSH 的更多信息，请参阅[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html) 部分。 1. 以 permissive 模式打开 SSH shell 或使用 ADB shell。 2. 使用 `echo`命令传输数据。 echo "This Document Is Very Much Helpful" > /dev/ttyHS1Copy to clipboard 3. 读取 UART 设备节点中的数据。 cat /dev/ttyHS1Copy to clipboard ## 调试 UART 问题 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 本节介绍如何启用 UART 软件驱动程序中的调试日志。 ### Linux 通过动态调试方法启用 UART 驱动程序日志。启用 <workspace\_path\_of\_LINUX\_kernel\_image>/sources/kernel/kernel\_platform/kernel/arch/arm64/configs/qcom\_defconfig中的 `CONFIG_DYNAMIC_DEBUG` 以支持内核驱动程序的动态调试。要在内核日志 (`dmesg`) 中启用和查看 UART 驱动程序日志，应运行以下命令。 mount -t debugfs none /sys/kernel/debug echo -n "file qcom_geni_serial.c +p" > /sys/kernel/debug/dynamic_debug/control echo -n "file qcom-geni-se.c +p" > /sys/kernel/debug/dynamic_debug/control echo -n "file serial_core.c +p" > /sys/kernel/debug/dynamic_debug/control echo -n "file gpi.c +p" > /sys/kernel/debug/dynamic_debug/control Copy to clipboard ## UART 示例 Source: [https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html](https://docs.qualcomm.com/doc/80-70020-8SC/topic/uart.html) 有关上游设备树参考的信息，请参阅以下 DTSI 文件。 - QCS6490 和 QCS5430：[https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi) - Dragonwing IQ-9075: [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi) - Dragonwing IQ-615: [https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16](https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16) 有关 Qualcomm Linux 硬件 SoC 的设备树节点的信息，请参阅以下 DTSI 文件。 - QCS6490 和 QCS5430：[https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/qcs6490-rb3gen2.dts](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/qcs6490-rb3gen2.dts) - Dragonwing IQ-9075: [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi) - Dragonwing IQ-615: [https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16](https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16) Last Published: Jul 23, 2025 [Previous Topic 入门指南：设置设备接口](https://docs.qualcomm.com/bundle/publicresource/80-70020-8SC/topics/get-started.md) [Next Topic SPI](https://docs.qualcomm.com/bundle/publicresource/80-70020-8SC/topics/spi.md)