一：整体说明
高通8255芯片中，SPI IIC UART核心统一由QUP V3 进行控制
QUP V3为可编程模块，可以将不同通道配置为SPI IIC UART通路，此部分配置在QNX侧
QUP 资源可以直接被QNX使用，Android侧可以通过两种方法使用QUP资源
二：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
QUP在QNX侧配置相关驱动，通过hypervisor提供虚拟的devices节点给Android侧使用
此方法中大致逻辑如下：
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
QUP资源通过hypervisor直接映射到Android侧，Android侧配置相关驱动使用真实的资源
此方法中大致逻辑如下：
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
| 对于结构体 QUPv3_se_security_permissions_type 各项定义：（大致含义） |
| PeriphID（外设ID）：指定要进行通信的外设的唯一标识符或地址。每个外设都有一个对应的唯一ID。 |
| ProtocolID（协议ID）：指定要在 QUP 上使用的通信协议，例如 UART、I2C 或 SPI。 |
| Mode（模式）：指定 QUP 的工作模式。常见的模式有主机模式、从设备模式、循环模式等。 |
| NsOwner（命名空间所有者）：确定外设的命名空间所有者。它用于指示访问特定功能或资源的权限。 |
| bAllowFifo（是否启用FIFO）：指示是否允许在数据传输过程中使用 FIFO（先进先出缓冲区）。当启用 FIFO 时，数据将被缓存，以提高传输效率。 |
| bLoad（是否加载）：用于指示当前操作是否涉及加载配置或固件。 |
| bModExcl（是否独占模式）：指示外设是否以独占模式进行访问。当以独占模式打开外设时，其他程序无法访问该外设。 |
关于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.htypedef 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 tableHypervisor配置：
相关代码路径：
① /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@980000 {...status = "disabled";};qupv3_se0_spi: spi@980000 {...status = "disabled";};qupv3_se1_i2c: i2c@984000 {...status = "disabled";};qupv3_se1_spi: spi@984000 {...status = "disabled";};qupv3_se2_i2c: i2c@988000 {...status = "disabled";};qupv3_se2_spi: spi@988000 {...status = "disabled";};qupv3_se3_i2c: i2c@98c000 {...status = "disabled";};qupv3_se3_spi: spi@98c000 {...status = "disabled";};qupv3_se4_i2c: i2c@990000 {...status = "disabled";};qupv3_se4_spi: spi@990000 {...status = "disabled";};qupv3_se5_i2c: i2c@994000 {...status = "disabled";};qupv3_se5_spi: spi@994000 {...status = "disabled";};qupv3_se5_2uart: qcom,qup_uart@994000 {...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@880000 {...status = "disabled";};qupv3_se14_spi: spi@880000 {...status = "disabled";};qupv3_se15_i2c: i2c@884000 {...status = "disabled";};qupv3_se15_spi: spi@884000 {...status = "disabled";};qupv3_se16_i2c: i2c@888000 {...status = "disabled";};qupv3_se16_spi: spi@888000 {...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@890000 {...status = "disabled";};qupv3_se18_spi: spi@890000 {...status = "disabled";};qupv3_se19_i2c: i2c@894000 {...status = "disabled";};qupv3_se19_spi: spi@894000 {...status = "disabled";};qupv3_se20_i2c: i2c@898000 {...status = "disabled";};qupv3_se20_spi: spi@898000 {...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资源的对应关系 如下：
| QUP serial engine | Android DTS KeyWord |
| QUP0_SE0 | qupv3_se0_xxxxx |
| QUP0_SE1 | qupv3_se1_xxxxx |
| QUP0_SE2 | qupv3_se2_xxxxx |
| QUP0_SE3 | qupv3_se3_xxxxx |
| QUP0_SE4 | qupv3_se4_xxxxx |
| QUP0_SE5 | qupv3_se5_xxxxx |
| QUP1_SE0 | qupv3_se7_xxxxx |
| QUP1_SE1 | qupv3_se8_xxxxx |
| QUP1_SE2 | qupv3_se9_xxxxx |
| QUP1_SE3 | qupv3_se10_xxxxx |
| QUP1_SE4 | qupv3_se11_xxxxx |
| QUP1_SE5 | qupv3_se12_xxxxx |
| QUP1_SE6 | qupv3_se13_xxxxx |
| QUP2_SE0 | qupv3_se14_xxxxx |
| QUP2_SE1 | qupv3_se15_xxxxx |
| QUP2_SE2 | qupv3_se16_xxxxx |
| QUP2_SE3 | qupv3_se17_xxxxx |
| QUP2_SE4 | qupv3_se18_xxxxx |
| QUP2_SE5 | qupv3_se19_xxxxx |
| QUP2_SE6 | qupv3_se20_xxxxx |
| QUP3_SE0 | qupv3_se21_xxxxx |
Android侧配置：
对于Android侧的配置基本上就和Linux配置一样了
基本配置逻辑如下：
① 针对uart 的gpio的normal 和 sleep模式下的 Function及 config设定
② 上述 qup.dtsi中 qup节点信息设定
③ 需要特别注意的是，上面qup.dtsi中各子节点状态都是 disable，当需要使用的时候需要将状态更改为ok，同时便于使用需要在aliases节点中增加子节点描述
Android侧最终使用效果：
在Android侧最终会生成一个ttyHS0的device节点，其他操作正常通过该节点使用正常的linux或Android方法即可进行
