高通 8255 基本通信（QUP）Android侧控制方法说明

大家好，欢迎来到IT知识分享网。

一：整体说明

二：QUP资源示意图

在8255上共有 4组 QUP资源，每组对应不同通信通道和对应的gpio，各资源对应关系图如下：

上图中，我们可以得到信息例如：

• 所有通道都支持 UART（64B FIFO模式）
• QUP1_SE_6不支持API了master功能
• QUP0_SE_0 对应的gpio_pin是20 21 22 23 
• …

上图中对于QUP lane 对应gpio的关系如下

例如  QUP0_SE_0 对应的gpio_pin是20 21 22 23 ，

如果设置为UART模式的话，pin20为CTS  pin21为RFR  pin22为TX pin23 为RX

三：Android 控制使用QUP的方法

如果要在Android侧使用 QUP相关资源有两种方法

参考网页：

– Architecture (qnx.com)

方法1：virtual devices

此方法中大致逻辑如下：

1 硬件device通过Hypervisor 由 PVM（即QNX）直接使用driver控制

2 PVM（QNX侧）通过Hypervisor提供VirtoBE（BackEnd后端）向GVM（即Android侧）提供接口，这样GVM使用VirtoIOFE（FrontEnd前端） 来间接使用PVM的driver

核心逻辑：QNX直接使用QUP资源，Hypervisor作为桥梁，QNX提供driver的后端程序，Android提供driver的前端程序，即Android侧间接使用QUP资源

        相关网页：

– Virtual devices (qnx.com)

– Configuring vdevs (qnx.com)

– Configuring guests (qnx.com)

– Configuring the hypervisor host (qnx.com)

方法2：pass-through

 此方法中大致逻辑如下：

1 QUP资源通过Hypervisor 直接提供给GVM（Android）侧使用

即 Android需要提供完整的QUP驱动程序

相关网页：

– Configuring the hypervisor host (qnx.com)

总结：

上述两种方法其实包含三部分内容

1 Android配置

2 QNX 配置 （需要注意的是方法2 看似没有使用QNX，但因为QNX为主系统，不使用QNX应该理解为不使用VirtoDev的形式，所以对于QUP资源来说只要这路资源使用了，就需要在QNX进行配置。）

3 Hypervisor配置

四： pass-through配置示例

示例要求：将gpio91 92 93 94 配置成一路passthrough的 蓝牙Uart通道

通过上述资源图：可以确认要使用 QUP2 ：QUP2_SE_3的qup资源

QNX配置：

代码路径：/SD-AMSS4.5.5.0-ES2/tz/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/lemans/QUPAC_Access.c

关于ProtocolID SD-AMSS4.5.5.0-ES2/tz/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/interface/QupACCommonIds.h / QUPv3 protocols */ typedef enum { QUPV3_PROTOCOL_NONE = 0, QUPV3_PROTOCOL_SPI = 1, QUPV3_PROTOCOL_UART = 2, QUPV3_PROTOCOL_UART_2W = QUPV3_PROTOCOL_UART, QUPV3_PROTOCOL_I2C = 3, QUPV3_PROTOCOL_I3C = 4, QUPV3_PROTOCOL_SPI_SLAVE = 5, QUPV3_PROTOCOL_AFC = 6, QUPV3_PROTOCOL_SPMI = 7, QUPV3_PROTOCOL_QSPI_HID = 8, QUPV3_PROTOCOL_QSPI = 9, QUPV3_PROTOCOL_Q2SPI = 0xE, QUPV3_PROTOCOL_UFCS = 0xD, QUPV3_PROTOCOL_I3C_IBI = 0x104, QUPV3_PROTOCOL_UART_4W = QUPV3_PROTOCOL_UART + 16, QUPV3_PROTOCOL_I2C_MM = QUPV3_PROTOCOL_I2C + 16, QUPV3_PROTOCOL_UINT32 = 0x7fffffff } QUPv3_protocol_type; 

关于Mode / QUPv3 FIFO/DMA access modes */ SD-AMSS4.5.5.0-ES2/tz/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/interface/QupACCommonIds.h typedef enum { QUPV3_MODE_FIFO = 0, QUPV3_MODE_CPU_DMA = 1, QUPV3_MODE_GSI = 2, QUPV3_MODE_MAX, QUPV3_MODE_UINT32 = 0x7fffffff } QUPv3_mode_type; 

关于NsOwner SD-AMSS4.5.5.0-ES2/tz/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/interface/QupACCommonIds.h / Defines for QUP access ids */ #define AC_NONE 0 #define AC_TZ 1 #define AC_HLOS_GSI 2 #define AC_HLOS 3 #define AC_HYP 4 #define AC_SSC_Q6_ELF 5 #define AC_ADSP_Q6_ELF 6 // Single #define AC_SSC_HLOS 7 // ??, may be we combine this with other SSC one // #define AC_CP_TOUCH 8 #define AC_CP_BITSTREAM 9 #define AC_CP_PIXEL 10 #define AC_CP_NON_PIXEL 11 #define AC_VIDEO_FW 12 #define AC_CP_CAMERA 13 #define AC_HLOS_UNMAPPED 14 #define AC_MSS_MSA 15 #define AC_MSS_NONMSA 16 #define AC_UNMAPPED 17 #define AC_LPASS 18 #define AC_NON_SECURE 19 // Use this ID to assign a SE to HLOS & ADSP with QUPV3_MODE_FIFO. // The mode of operation can be either GSI or FIFO. // But not CPU DMA. #define AC_HLOS_MODEM 20 // For SEs assigned with AC_HLOS_MODEM // 1. Set to FIFO mode, if there are any UEFI use cases and if UEFI driver support only FIFO mode. // 2. Set to GSI mode, if there are UEFI use cases and UEFI driver supports GSI mode. // SW will take care of assigning this SE to GSI mode after the FW loading is done at the end of UEFI. #define AC_GVM_TUI 21 // Assigned to TUI GVM #define AC_SPSS_SP 22 #define AC_OEM 23 #define AC_NON_SECURE_MODEM 24 #define AC_HOST 25 #define AC_GVM1 26 #define AC_GVM2 27 #define AC_GVM3 28 #define AC_GVM4 29 #define BLSP_AC_LAST 30 #define AC_DEFAULT 0xFF// Default as in retain whatever in SMMU static config table 

Hypervisor配置：

 相关代码路径：

①   /SD-QNX4.5.5.0/apps/qnx_ap/target/hypervisor/gvm/ivi/la/linux-la.config 

②    /SD-HQX4.5.5.0-ES2/apps_kernel/kernel_platform/qcom/proprietary/devicetree/qcom/lemans-vm-qupv3.dtsi    

 代码解读：

Hypervisor代码路径是 ①  ，需要配置的主要资源是 中断号和QUP资源

这两项内容对应的值可以从datasheet中取得，但查询比较麻烦，

因为Android的DTS高通厂商已经把基本信息填写好了，所以从DTS中取得更加方便，DTS路径如②

因此可以确认

中断号： 585

QUP的资源Memory地址： 0x88c000 范围是0x4000

可能疑问： 为什么DTS中锁定节点 qupv3_se17_4uart呢？

解答：建议查看一下dts中的节点包含关系

lemans-vm-qupv3.dtsi    源码节点包含关系如下：

&soc { /* QUPv3_0 wrapper instance */ qupv3_0: qcom,qupv3_0_geni_se@9c0000 { ... status = "ok"; qupv3_se0_i2c: i2c@ { ... status = "disabled"; }; qupv3_se0_spi: spi@ { ... status = "disabled"; }; qupv3_se1_i2c: i2c@ { ... status = "disabled"; }; qupv3_se1_spi: spi@ { ... status = "disabled"; }; qupv3_se2_i2c: i2c@ { ... status = "disabled"; }; qupv3_se2_spi: spi@ { ... status = "disabled"; }; qupv3_se3_i2c: i2c@98c000 { ... status = "disabled"; }; qupv3_se3_spi: spi@98c000 { ... status = "disabled"; }; qupv3_se4_i2c: i2c@ { ... status = "disabled"; }; qupv3_se4_spi: spi@ { ... status = "disabled"; }; qupv3_se5_i2c: i2c@ { ... status = "disabled"; }; qupv3_se5_spi: spi@ { ... status = "disabled"; }; qupv3_se5_2uart: qcom,qup_uart@ { ... status = "disabled"; }; }; /* QUPv3_1 wrapper instance */ qupv3_1: qcom,qupv3_1_geni_se@ac0000 { ... status = "ok"; qupv3_se7_i2c: i2c@a80000 { ... status = "disabled"; }; qupv3_se7_spi: spi@a80000 { ... status = "disabled"; }; qupv3_se8_i2c: i2c@a84000 { ... status = "disabled"; }; qupv3_se8_spi: spi@a84000 { ... status = "disabled"; }; qupv3_se9_i2c: i2c@a88000 { ... status = "disabled"; }; qupv3_se9_spi: spi@a88000 { ... status = "disabled"; }; /* Debug UART Instance for RUMI*/ qupv3_se9_2uart: qcom,qup_uart@a88000 { ... status = "disabled"; }; qupv3_se10_i2c: i2c@a8c000 { ... status = "disabled"; }; qupv3_se10_spi: spi@a8c000 { ... status = "disabled"; }; /* Debug UART Instance */ qupv3_se10_2uart: qcom,qup_uart@a8c000 { ... status = "disabled"; }; qupv3_se11_i2c: i2c@a90000 { ... status = "disabled"; }; qupv3_se11_spi: spi@a90000 { ... status = "disabled"; }; qupv3_se12_i2c: i2c@a94000 { ... status = "disabled"; }; qupv3_se12_spi: spi@a94000 { ... status = "disabled"; }; qupv3_se12_2uart: qcom,qup_uart@a94000 { ... status = "disabled"; }; qupv3_se13_i2c: i2c@a98000 { ... status = "disabled"; }; }; /* QUPv3_2 wrapper instance */ qupv3_2: qcom,qupv3_2_geni_se@8c0000 { ... status = "ok"; qupv3_se14_i2c: i2c@ { ... status = "disabled"; }; qupv3_se14_spi: spi@ { ... status = "disabled"; }; qupv3_se15_i2c: i2c@ { ... status = "disabled"; }; qupv3_se15_spi: spi@ { ... status = "disabled"; }; qupv3_se16_i2c: i2c@ { ... status = "disabled"; }; qupv3_se16_spi: spi@ { ... status = "disabled"; }; qupv3_se17_i2c: i2c@88c000 { ... status = "disabled"; }; qupv3_se17_spi: spi@88c000 { ... status = "disabled"; }; /* BT UART Instance */ qupv3_se17_4uart: qcom,qup_uart@88c000 { ... status = "disabled"; }; qupv3_se18_i2c: i2c@ { ... status = "disabled"; }; qupv3_se18_spi: spi@ { ... status = "disabled"; }; qupv3_se19_i2c: i2c@ { ... status = "disabled"; }; qupv3_se19_spi: spi@ { ... status = "disabled"; }; qupv3_se20_i2c: i2c@ { ... status = "disabled"; }; qupv3_se20_spi: spi@ { ... status = "disabled"; }; }; /* QUPv3_3 wrapper instance */ qupv3_3: qcom,qupv3_3_geni_se@bc0000 { ... status = "ok"; qupv3_se21_i2c: i2c@b80000 { ... status = "disabled"; }; qupv3_se21_spi: spi@b80000 { ... status = "disabled"; }; }; }; 

我这里总结了一下各节点和QUP资源的对应关系 如下：

Android侧配置：

对于Android侧的配置基本上就和Linux配置一样了

基本配置逻辑如下：

① 针对uart 的gpio的normal 和 sleep模式下的 Function及 config设定

② 上述 qup.dtsi中 qup节点信息设定

③ 需要特别注意的是，上面qup.dtsi中各子节点状态都是 disable，当需要使用的时候需要将状态更改为ok，同时便于使用需要在aliases节点中增加子节点描述

Android侧最终使用效果：

在Android侧最终会生成一个ttyHS0的device节点，其他操作正常通过该节点使用正常的linux或Android方法即可进行