# 入门指南：设置设备接口
Source: [https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html)
在开始之前，请按照 [Qualcomm Linux 编译指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/introduction.html)中所述搭建基础架构。
## 识别接口状态
Source: [https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html)
默认接口状态指示启动过程中的接口状态。要识别接口状态，必须确保接口注册成功并获取已启用接口的列表。
### 获取启动日志
Source: [https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html)
### About this task
请执行以下操作，以便获取设备的启动日志：
### Procedure
1. 以 permissive 模式打开 SSH shell 或使用 ADB shell。有关如何运行 SSH 的更多信息，请参见 [使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh) 一节。
2. 通过运行以下命令获取已启用接口的日志。
dmesgCopy to clipboard
输出：
[ 0.434365] msm_serial: driver initialized
[ 0.799123] 994000.serial: ttyMSM0 at MMIO 0x994000 (irq = 139, base_baud = 0) is a MSM
[ 0.801937] 99c000.serial: ttyHS1 at MMIO 0x99c000 (irq = 140, base_baud = 0) is a MSM
[ 0.804563] serial serial0: tty port ttyHS1 registered
[ 0.720945] usbhub_rest_vreg GPIO handle specifies active low - ignored
[ 0.815241] dwc3-qcom 8c00000.usb: Adding to iommu group 4
[ 5.195974] dwc3-qcom a600000.usb: Adding to iommu group 18
[ 5.229464] qcom_pmic_glink pmic-glink: Failed to create device link (0x180) with a600000.usb
[ 6.195825] usb usb2: We don't know the algorithms for LPM for this host, disabling LPM.
[ 6.450338] usb 1-1: new high-speed USB device number 2 using xhci_hcd
[ 6.664583] usbcore: registered new device driver onboard-usb-hub
[ 6.730998] usb 2-1: new SuperSpeed USB device number 2 using xhci_hcd
[ 7.083668] usb 2-1.1: new SuperSpeed USB device number 3 using xhci_hcd
[ 7.217287] ax88179_178a 2-1.1:1.0 eth0: register 'ax88179_178a' at usb-0001:04:00.0-1.1, ASIX AX88179 USB 3.0 Gigabit Ethernet, 02:fe:ee:05:44:23
[ 7.217415] usbcore: registered new interface driver ax88179_178a
[ 10.223140] dwc3-qcom a600000.usb: request 0000000000000000 was not queued to ep0ouCopy to clipboard
3. 连接 UART 串行端口以登录控制台。
### 列出设备上启用的接口
Source: [https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html)
要获取已启用接口的列表，应按照以下所述操作：
- 对于 UART，运行以下命令。
ls /dev/tty*Copy to clipboard
输出：
/dev/tty /dev/tty21 /dev/tty35 /dev/tty49 /dev/tty62 /dev/ttyp4
/dev/tty0 /dev/tty22 /dev/tty36 /dev/tty5 /dev/tty63 /dev/ttyp5
/dev/tty1 /dev/tty23 /dev/tty37 /dev/tty50 /dev/tty7 /dev/ttyp6
/dev/tty10 /dev/tty24 /dev/tty38 /dev/tty51 /dev/tty8 /dev/ttyp7
/dev/tty11 /dev/tty25 /dev/tty39 /dev/tty52 /dev/tty9 /dev/ttyp8
/dev/tty12 /dev/tty26 /dev/tty4 /dev/tty53 /dev/ttyMSM0 /dev/ttyp9
/dev/tty13 /dev/tty27 /dev/tty40 /dev/tty54 /dev/ttyS0 /dev/ttypa
/dev/tty14 /dev/tty28 /dev/tty41 /dev/tty55 /dev/ttyS1 /dev/ttypb
/dev/tty15 /dev/tty29 /dev/tty42 /dev/tty56 /dev/ttyS2 /dev/ttypc
/dev/tty16 /dev/tty3 /dev/tty43 /dev/tty57 /dev/ttyS3 /dev/ttypd
/dev/tty17 /dev/tty30 /dev/tty44 /dev/tty58 /dev/ttynull /dev/ttype
/dev/tty18 /dev/tty31 /dev/tty45 /dev/tty59 /dev/ttyp0 /dev/ttypf
/dev/tty19 /dev/tty32 /dev/tty46 /dev/tty6 /dev/ttyp1
/dev/tty2 /dev/tty33 /dev/tty47 /dev/tty60 /dev/ttyp2
/dev/tty20 /dev/tty34 /dev/tty48 /dev/tty61 /dev/ttyp3Copy to clipboard
- 对于 I2C，运行以下命令。
ls /dev/i2c*Copy to clipboard
随即显示以下输出。
/dev/i2c-0 /dev/i2c-1 /dev/i2c-16Copy to clipboard
- 对于 SPI，请运行以下命令。
ls /dev/spi*Copy to clipboard
随即显示以下输出。
spidev14.0Copy to clipboard
- 对于 PCIe，获取枚举日志。有关 PCIe 探测日志的更多信息，请参阅 [PCIe 相关配置](https://docs.qualcomm.com/doc/80-70018-8SC/topic/pcie.html#pcie-software-support-feature-for-qps615__section_xbl_hhd_l1c) 和 [QPS615 switch 支持](https://docs.qualcomm.com/doc/80-70018-8SC/topic/pcie.html#pcie-software-support-feature-for-qps615__section_nmw_5jd_l1c)。
## 在 QUP v3 串行引擎上加载 Linux 固件
Source: [https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html)
QUP v3 串行引擎将所需协议的固件加载到串行引擎上。协议（I2C、SPI、I3C）和通信模式（[FIFO](https://docs.qualcomm.com/doc/80-70018-8SC/topic/references.html#qup-v3-supported-transfer-modes__ul_unp_cdt_qzb)、[GSI](https://docs.qualcomm.com/doc/80-70018-8SC/topic/references.html#qup-v3-supported-transfer-modes__b_zzd_rsp_rcc)）的配置在安全执行环境（如 Qualcomm TEE `devcfg`）中完成。关于开源开发，此配置在 Linux `devkit` 中执行，允许非安全用例。然而，对于安全用例，需使用 Qualcomm TEE `devcfg`。
### 默认配置
每个串行引擎的默认配置（包括所选的数据传输模式和所有权）位于 /TZ.XF.5.0/core.tz/2.0/settings/buses/qup\_accesscontrol/qupv3/config/lemans/QUPAC\_Access.c 文件中。
在默认配置中，Linux 拥有所有串行引擎。所有安全用例均由 Qualcomm TEE 处理。
const QUPv3_se_security_permissions_type qupv3_perms_default =
{
/* PeriphID, ProtocolID, Mode, NsOwner, bAllowFifo, bLoad, bModExcl */
/*QUPV3_0_SE0*/
/*QUPV3_0_SE1*/
/*QUPV3_0_SE2*/
{ QUPV3_0_SE3, QUPV3_PROTOCOL_UART_4W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // BT UART (2nd Hastings)
{ QUPV3_0_SE4, QUPV3_PROTOCOL_UART_2W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // VIP UART/SPI (SOC SLAVE)
/*QUPV3_0_SE5*/ // Spare
{ QUPV3_1_SE0, QUPV3_PROTOCOL_I2C, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // I2C Carplay
/*QUPV3_1_SE1*/
{ QUPV3_1_SE2, QUPV3_PROTOCOL_UART_2W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // Tuner
{ QUPV3_1_SE3, QUPV3_PROTOCOL_UART_2W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, FALSE, FALSE }, // Debug UART
{ QUPV3_1_SE4, QUPV3_PROTOCOL_I2C, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // I2C A2B Controller & Audio port expander
{ QUPV3_1_SE5, QUPV3_PROTOCOL_UART_2W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // GNSS
/*QUPV3_1_SE6*/
{ QUPV3_2_SE0, QUPV3_PROTOCOL_SPI, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // FPGA
{ QUPV3_2_SE1, QUPV3_PROTOCOL_I2C, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // PCIe I2C MUX
{ QUPV3_2_SE2, QUPV3_PROTOCOL_SPI, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // SPI - Audio
{ QUPV3_2_SE3, QUPV3_PROTOCOL_UART_4W, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // BT UART
{ QUPV3_2_SE4, QUPV3_PROTOCOL_I2C, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // I2C Display 1
{ QUPV3_2_SE5, QUPV3_PROTOCOL_I2C, QUPV3_MODE_FIFO, AC_HLOS, TRUE, TRUE, FALSE }, // I2C Sensor
/*QUPV3_2_SE6 */
{ QUPV3_3_SE0, QUPV3_PROTOCOL_SPI, QUPV3_MODE_FIFO, AC_HLOS, TRUE, FALSE, FALSE }, // SPI
};
Copy to clipboard
### 加载 Linux 固件
要加载 Linux 固件，请执行以下操作：
1. 在以下文件中启用 CONFIG\_QUP\_FW\_LOAD：
- 在 arch/arm64/configs/qcom\_defconfig 中设置 `CONFIG_QCOM_QUP_FW_LOAD=y`
- 在 arch/arm64/configs/qcom\_vm\_defconfig 中设置 `CONFIG_QCOM_QUP_FW_LOAD=m`
2. 要使用所需协议加载固件，请在设备树节点中包含 `qcom,load-firmware` 属性。
3. 配置传输模式。
GENI_SE_INVALID, // 0
GENI_SE_FIFO, //1
GENI_SE_DMA, //2
GENI_GPI_DMA, //3
Copy to clipboard
4. 将固件加载至串行引擎。
例如，当 QUPv3\_2\_SE2 (0x00888000) 通过 FIFO 通信模式从 Linux 加载时，请使用以下 DTSI 属性。
spi16: spi@888000 {
compatible = "qcom,geni-spi";
reg = <0x0 0x00888000 0x0 0x4000>;
interrupts = ;
clocks = <&gcc GCC_QUPV3_WRAP2_S2_CLK>;
clock-names = "se";
interconnects = <&clk_virt MASTER_QUP_CORE_2 QCOM_ICC_TAG_ALWAYS
&clk_virt SLAVE_QUP_CORE_2 QCOM_ICC_TAG_ALWAYS>,
<&gem_noc MASTER_APPSS_PROC QCOM_ICC_TAG_ALWAYS
&config_noc SLAVE_QUP_2 QCOM_ICC_TAG_ALWAYS>,
<&aggre2_noc MASTER_QUP_2 QCOM_ICC_TAG_ALWAYS
&mc_virt SLAVE_EBI1 QCOM_ICC_TAG_ALWAYS>;
interconnect-names = "qup-core",
"qup-config",
"qup-memory";
power-domains = <&rpmhpd SA8775P_CX>;
dmas = <&gpi_dma2 0 2 QCOM_GPI_SPI>,
<&gpi_dma2 1 2 QCOM_GPI_SPI>;
dma-names = "tx", "rx";
address-cells = <1>;
#size-cells = <0>; qcom,load-firmware; xfer-mode = <1>;
status = "disabled";
};
Copy to clipboard
5. 加载 GPI 固件。
gpi_dma2: qcom,gpi-dma@800000 { #dma-cells = <3>; compatible = "qcom,sm6350-gpi-dma"; reg = <0x0 0x00800000 0x0 0x60000>; interrupts = , , , , , , , , , , , ; dma-channels = <12>; dma-channel-mask = <0xfff>;
iommus = <&apps_smmu 0x5b6 0x0>;
qcom,load-firmware;
xfer-mode = <3>; status = "disabled"; };
Copy to clipboard
## 启用所需接口
Source: [https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html)
要启用接口，应按照以下所述操作：
- 关于 UART，请参阅 [UART 软件](https://docs.qualcomm.com/doc/80-70018-8SC/topic/uart.html#uart_software) 部分。
- 关于 SPI，请参阅 [SPI 软件](https://docs.qualcomm.com/doc/80-70018-8SC/topic/spi.html#spi_software) 部分。
- 关于 I2C，请参阅 [I2C 软件](https://docs.qualcomm.com/doc/80-70018-8SC/topic/i2c.html#i2c-software) 部分。
- 关于 PCIe，请参阅 [PCIe 软件](https://docs.qualcomm.com/doc/80-70018-8SC/topic/pcie.html#pcie-software) 部分。
- 关于 USB，请参阅 [USB 软件](https://docs.qualcomm.com/doc/80-70018-8SC/topic/usb.html#usb-software) 部分。
## 验证接口状态
Source: [https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70018-8SC/topic/get-started.html)
要验证不同接口的功能，应按照以下所述操作：
- 关于 UART，请参阅 [验证 UART 接口](https://docs.qualcomm.com/doc/80-70018-8SC/topic/uart.html#uart_verification) 部分。
- 关于 SPI，请参阅 [SPI 验证](https://docs.qualcomm.com/doc/80-70018-8SC/topic/spi.html#spi_verification) 部分。
- 关于 I2C，请参阅 [验证 I2C 接口](https://docs.qualcomm.com/doc/80-70018-8SC/topic/i2c.html#i2c-verification) 部分。
- 对于 PCIe，使用以下命令验证连接的端点。
lspciCopy to clipboard
随即显示以下输出。
0001:00:00.0 PCI bridge: Qualcomm Device 010b
0001:01:00.0 PCI bridge: Toshiba Corporation Device 0623
0001:02:01.0 PCI bridge: Toshiba Corporation Device 0623
0001:02:02.0 PCI bridge: Toshiba Corporation Device 0623
0001:02:03.0 PCI bridge: Toshiba Corporation Device 0623
0001:04:00.0 USB controller: Renesas Technology Corp. uPD720201 USB 3.0 Host Controller (rev 03)
0001:05:00.0 Ethernet controller: Toshiba Corporation Device 0220
0001:05:00.1 Ethernet controller: Toshiba Corporation Device 0220Copy to clipboard
- 对于 USB，按照以下所述验证设备和主机：
- 设备：连接 USB Type-C 端口，然后通过主机 PC 验证枚举的日志。
adb devicesCopy to clipboard
随即显示以下输出。
List of devices attached
541eb4ba deviceCopy to clipboard
- 主机：连接 USB 设备（例如鼠标或 U 盘），并使用以下命令验证设备检测。
lsusbCopy to clipboard
随即显示以下输出。
Bus 002 Device 003: ID 0b95:1790 ASIX Electronics Corp. AX88179 Gigabit Ethernet
Bus 002 Device 002: ID 05e3:0625 Genesys Logic, Inc. USB3.2 Hub
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 05e3:0610 Genesys Logic, Inc. Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hubCopy to clipboard
Last Published: May 06, 2025
[Previous Topic
QCS8275 接口概述](https://docs.qualcomm.com/bundle/publicresource/80-70018-8SC/topics/qcs8275-interface-overview.md) [Next Topic
UART](https://docs.qualcomm.com/bundle/publicresource/80-70018-8SC/topics/uart.md)