> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 总线

总线用于在各种系统组件之间传输数据。您可以使用 DT 属性配置 Qualcomm Universal Peripheral（QUP）v3 串行接口设备节点。

QUP v3 支持集成电路间总线（I<sup>2</sup>C）、串行外设接口（SPI）和通用异步收发器（UART）串行引擎。DT 属性包括这些串行引擎的活动（active）和睡眠（sleep）设置。

有关 QUP v3 及其外设接口的更多信息，请参阅[外设接口概述](https://dragonwingdocs.qualcomm.com/System/Interfaces/)。

您可以在固件加载到串行引擎时应用串行引擎协议和活动配置。

您可以配置以下 Linux 主机文件：

* `boot_images/boot/Settings/Soc/<chipset>/Core/Buses/qup_common/<chipset>-qupv3-pinctrl.dtsi`
* `boot_images/boot/Settings/Soc/<chipset>/Core/Buses/qup_common/<chipset>-qupv3.dtsi`

在 `&top_qup{k}_se{n}` 中，**k** 表示 QUP 编号，**n** 表示串行引擎编号。下表列出了 DT 属性：

<Frame caption="**表：总线 DT 属性**" />

| 属性名称                            | 属性描述                                                        | 数据类型         | 可能的值/取值范围                               | 设备行为                             |
| ------------------------------- | ----------------------------------------------------------- | ------------ | --------------------------------------- | -------------------------------- |
| `status = "disabled";`          | 用于启用/禁用 QUP v3 串行引擎支持的串行接口（I<sup>2</sup>C/SPI/UART）协议的状态控制。 | 字符串          | <ul><li>Okay</li><li>Disabled</li></ul> | 启用或禁用串行引擎。                       |
| `&top_qup{k}_se{n}_i2c_active`  | I<sup>2</sup>C 串行引擎的 GPIO 活动设置。                             | UINT32-array | 对节点标签的引用。                               | 为 I<sup>2</sup>C 协议设置活动 GPIO 配置。 |
| `&top_qup{k}_se{n}_i2c_sleep`   | I<sup>2</sup>C 的 GPIO 睡眠设置。                                 | UINT32-array | 对节点标签的引用。                               | 为 I<sup>2</sup>C 协议设置睡眠 GPIO 配置。 |
| `&top_qup{k}_se{n}_spi_active`  | SPI 的 GPIO 活动设置。                                            | UINT32-array | 对节点标签的引用。                               | 为 SPI 协议设置活动 GPIO 配置。            |
| `&top_qup{k}_se{n}_spi_sleep`   | SPI 的 GPIO 睡眠设置。                                            | UINT32-array | 对节点标签的引用。                               | 为 SPI 协议设置睡眠 GPIO 配置。            |
| `&top_qup{k}_se{n}_uart_active` | UART 的 GPIO 活动设置。                                           | UINT32-array | 对节点标签的引用。                               | 为 UART 协议设置活动 GPIO 配置。           |
| `&top_qup{k}_se{n}_uart_sleep`  | UART 的 GPIO 睡眠设置。                                           | UINT32-array | 对节点标签的引用。                               | 为 UART 协议设置睡眠 GPIO 配置。           |

## **示例配置**

```text theme={null}
TOP_QUP_0{}
/*TOP_QUP_0_SE_0 Instance */
TOP_QUP_0_SE_0
status = "disabled"; /* status to enable/disable SE0 Node */
pinctrl-0  = <&top_qup0_se0_i2c_active>;
pinctrl-1  = <&top_qup0_se0_i2c_sleep>;
pinctrl-2  = <&top_qup0_se0_spi_active>;
pinctrl-3  = <&top_qup0_se0_spi_sleep>;
pinctrl-4  = <&top_qup0_se0_uart_active>;
pinctrl-5  = <&top_qup0_se0_uart_sleep>;
```