6.4.3.8. 连接描述符

通用输入/输出 (GPIO) 和简单外设总线 (SPB) 控制器是在硅方案中提供的硬件资源，用于支持广泛系统设计的灵活配置。这些控制器可以为系统中的任意设备提供输入、输出、中断和串行通信连接。这些连接所承担的功能取决于具体设备以及平台设计的需求。为了支持移动平台架构，ACPI 将这些连接抽象为资源。

6.4.3.8.1. GPIO 连接描述符

类型 1，大项名称 0xC

GPIO 连接描述符描述 GPIO 控制器与外设设备之间的连接。可以描述两种类型的 GPIO 连接：IO 连接和中断连接，它们通过描述符中的 GPIO 连接类型值加以区分。GPIO 控制器及连接到它们的设备可以位于命名空间中的任意位置，但该连接必须在外设设备的资源对象（PRS、_CRS 等）中进行描述。

表 6.54 GPIO 连接描述符定义

偏移量字段名称定义
字节 0GPIO 连接描述符值 = 0x8C, (10001100B) - 类型 = 1, 大项名称 = 0x0C
字节 1长度，位[7:0]可变长度，最小值 = 0x16 + L（22 + 资源源名称字符串的长度）
字节 2长度，位[15:8]可变长度，最小值 = 0x00
字节 3修订版本 ID指示 GPIO 中断描述符的修订版本。该值必须为 1。
字节 4GPIO 连接类型指示描述符的类型：0x00 = 中断连接 0x01 = IO 连接 0x02 - 0xFF 保留
字节 5通用标志，位 [7:0]标志。位 [7:1] 保留（必须为 0）位 [0] 使用者/产生者：0x0 = 此设备产生并消耗该资源 0x1 = 此设备消耗该资源
字节 6通用标志，位 [15:8]位 [15:8] 保留（必须为 0）。
字节 7用于中断连接的中断和 IO 标志，位 [7:0]位 [7:5] 保留（必须为 0）位 [4] 唤醒能力，_WKC：0x0 = 不具备唤醒能力：此中断不能唤醒系统。0x1 = 具备唤醒能力：此中断能够从低功耗空闲状态或系统睡眠状态唤醒系统。位 [3] 中断共享，_SHR：0x0 = 独占：此中断不与其他设备共享。0x1 = 共享：此中断与其他设备共享。位 [2:1] 中断极性，_POL：0x0 = 高电平有效：当信号为高电平或真时，对该中断进行采样。0x1 = 低电平有效：当信号为低电平或假时，对该中断进行采样。0x2 = 双边沿有效：在上升沿和下降沿都对该中断进行采样。中断模式必须设置为边沿触发。0x3 - 保留（不要使用）位 [0] 中断模式，_MOD 0x0 = 电平触发：当信号处于高或低状态时触发中断。0x1 = 边沿触发：当信号状态发生变化时触发该中断，无论是高到低还是低到高。
字节 7用于 IO 连接的中断和 IO 标志，位 [7:0]位 [7:4] 保留（必须为 0）位 [3] IO 共享，_SHR：0x0 = 独占：此 IO 连接仅由一个设备独占使用。0x1 = 共享：此 IO 连接由两个或更多设备共享。位 [2] 保留（必须为 0）位 [1:0] IO 限制 _IOR：0x0 = 该引脚可用作输入或输出。0x1 = 该引脚只能用作输入，且在未使用时必须保持引脚配置。0x2 = 该引脚只能用作输出，且在未使用时必须保持引脚配置。0x3 = 该引脚可用作输入或输出，但配置必须保持直到被显式更改。
字节 8中断和 IO 标志，位 [15:8]位 [15:8] 保留（必须为 0）
字节 9引脚配置_PPI：0x00 = 默认配置（不应用任何配置）0x01 = 上拉 0x02 = 下拉 0x03 = 无上下拉 0x04 - 0x7F；保留（不要使用）0x80 - 0xFF；厂商定义值
字节 10输出驱动强度，位 [7:0]配置引脚为输出时应用的输出驱动能力，以百分之一毫安为单位（高字节）。_DRS[7:0]
字节 11输出驱动强度，位 [15:8]配置引脚为输出时应用的输出驱动能力，以百分之一毫安为单位（高字节）。_DRS[15:8]
字节 12消抖超时，位 [7:0]配置引脚为中断时应用的消抖超时时间，以百分之一毫秒为单位（低字节）。_DBT[7:0]
字节 13消抖超时，位 [15:8]配置引脚为中断时应用的消抖超时时间，以百分之一毫秒为单位（高字节）。_DBT [15:8]
字节 14引脚表偏移量[7:0]到引脚表起始位置的偏移量（低字节）。该偏移量相对于此描述符的起始位置。注意：表中引脚的数量可通过 引脚计数 = (资源源名称偏移量 - 引脚表偏移量) / 2 计算
字节 15引脚表偏移量[15:8]到引脚表起始位置的偏移量（高字节）。该偏移量相对于此描述符的起始位置。
字节 16资源源索引保留供将来使用。该字段必须为 0。
字节 17资源源名称偏移量[7:0]到资源源名称起始位置的偏移量（低字节）。该偏移量相对于此描述符的起始位置。注意：ResourceSource 名称字符串的长度可由长度 L = 厂商数据偏移量 - 资源源名称偏移量计算得出。该长度包括字符串结尾的 NULL 字符（如果存在）
字节 18资源源名称偏移量[15:8]到资源源名称起始位置的偏移量（高字节）。该偏移量相对于此描述符的起始位置。
字节 19厂商数据偏移量[7:0]（低字节）到厂商定义数据起始位置的偏移量（ResourceSource 最后一个字节 + 1）。该值必须始终有效，以便进行长度计算。在没有厂商数据的情况下，该偏移量仍必须指向 ResourceSource 的最后一个字节 + 1。该偏移量相对于此描述符的起始位置。
字节 20厂商数据偏移量[15:8]（高字节）到厂商定义数据起始位置的偏移量。（ResourceSource 最后一个字节 + 1）。该值必须始终有效，以便进行长度计算。在没有厂商数据的情况下，该偏移量仍必须指向 ResourceSource 的最后一个字节 + 1。该偏移量相对于此描述符的起始位置。
字节 21厂商数据长度 [7:0]厂商定义数据的长度（低字节）。
字节 22厂商数据长度 [15:8]厂商定义数据的长度（高字节）。
字节 PinTableOffset[15:0] + 2n (n 是引脚表中的索引)引脚号，位 [7:0]GPIO 控制器相对的引脚号（低字节）：_PIN[7:0]。引脚编号从 0 开始。引脚号 0xFFFF = 无引脚。OSPM 将忽略该引脚号。
字节 PinTableOffset[15:0] + 2n + 1 (n 是引脚表中的索引)引脚号，位 [15:8]GPIO 控制器相对的引脚号（高字节）：_PIN[15:8]。引脚编号从 0 开始。引脚号 0xFFFF = 无引脚。OSPM 将忽略该引脚号。
字节 ResourceSourceNameOff set[15:0]资源源（长度 = L）此描述符适用的 GPIO 控制器设备名称。该名称可以是完全限定名称、相对名称，或使用命名空间搜索规则的名称段。
字节 VendorDataOffset[15:0 ]厂商定义数据（可选）由厂商提供的、特定于 GPIO 控制器设备的数据。该数据提供给此 GPIO Controller 的设备驱动程序。_VEN。

6.4.3.8.2. GenericSerialBus 连接描述符

类型 1，大项值 0x0E

所有串行总线资源描述符都使用以下格式。对于特定总线类型，使用类型特定字段。

表 6.55 GenericSerialBus 连接描述符

偏移量字段名称定义
字节 0串行总线类型值 = 0x8E (10001110B) - 类型 = 1, 大项名称 = 0x0E
字节 1长度，位[7:0]可变长度，最小值 = 0x09 + L(9 + ResourceSource 字符串长度)”
字节 2长度，位[15:8]可变长度，最小值 = 0x00
字节 3修订版本 ID指示串行总线连接描述符的修订版本。该值为 2。
字节 4资源源索引资源连接实例。如果此结构中 Resource Source 字段指定的设备支持多个连接（例如端口），则该字段描述此设备所连接到的连接实例。
字节 5串行总线类型指示此描述符描述的是哪种类型的串行总线连接。定义值为：0 - 保留 1 - I2C 2 - SPI 3 - UART 4 - CSI-2 5-191 - 保留 192-255 - 硬件厂商定义
字节 6通用标志 [7:0]所有串行总线连接类型共有的标志：位[7:3] 保留。必须为 0。位[2] 连接共享，_SHR：0x0：独占：此串行总线连接仅由一个设备独占使用。0x1：共享：此串行总线连接由两个或更多设备共享。位[1] 使用者/产生者：0x1：此设备消耗该资源 0x0：此设备产生并消耗该资源 位[0] 从模式：0x0：该连接上的通信由控制器发起。0x1：该连接上的通信由设备发起。
字节 7类型特定标志，位[7:0]特定于所指示串行总线类型的标志（见上文）。
字节 8类型特定标志，位[15:8]特定于所指示串行总线类型的标志（见上文）。
字节 9类型特定修订版本 ID由串行总线类型指定的串行总线连接描述数据的修订版本 ID（见上文）。
字节 10类型数据长度，位[7:0]可变长度，最小尺寸取决于所指示的串行总线类型（见上文）。
字节 11类型数据长度，位 [15:8]可变长度，最小尺寸取决于所指示的串行总线类型（见上文）。
字节 12类型特定数据（可选）特定于串行总线类型所指示的串行总线连接类型的数据（见上文）。
……特定于该串行总线连接类型的附加数据。
字符串资源源此连接描述符适用的串行总线控制器设备名称。该名称可以是完全限定路径、相对路径，或使用命名空间搜索规则的简单名称段。

6.4.3.8.2.1. I2C 串行总线连接资源描述符

表 6.56 I2C 串行总线连接描述符

偏移字段名称定义
字节 0I2C 总线连接描述符值 = 0x8E (10001110B) - 类型 = 1，大项名称 = 0x0E
字节 1长度，位 [7:0]可变长度，最小值 = 0xF + L（15 + 资源源字符串长度）
字节 2长度，位 [15:8]可变，长度最小值 = 0x00
字节 3修订 ID表示 I2C 资源描述符的修订版本。此值为 2。
字节 4资源源索引主控制器实例。如果本结构中的资源源字段指定的控制器设备支持多个主控制器，则该字段描述 I2C 从设备所连接的主控制器实例。第一个主控制器实例为 0。
字节 5串行总线类型对于 I2C，串行总线类型值必须为 1
字节 6通用标志 [7:0]适用于所有串行总线连接类型的标志。位 [7:2] 保留。必须为 0。位 [1] 使用者/生产者：0x1：该设备消耗此资源。0x0：该设备生产并消耗此资源。位 [0] 从模式，_SLV：0x0：该连接上的通信由控制器发起。0x1：该连接上的通信由设备发起。
字节 7类型特定标志，位 [7:0]：位 [7:1] 保留。必须为 0。位 [0] 10 位寻址模式，_MOD：0x1：该连接使用 10 位寻址 0x0：该连接使用 7 位寻址。注意：如果该设备连接到 I3C 主机控制器，则 _MOD 必须为 0。
字节 8类型特定标志，位 [15:8]传统虚拟寄存器，_LVR。该字段用于为连接到 I3C 主机控制器的 I2C 设备提供 MIPI I3C 规范中规定的 LVR 数据。对于 I2C 总线上的 I2C 设备，该字段为保留且未使用。
字节 9类型特定修订 ID表示 I2C 特定串行总线连接描述符数据的修订版本。此值为 1。
字节 10类型数据长度，位 [7:0]可变长度，最小值 = 0x6 (6)。
字节 11类型数据长度，位 [15:8]可变长度，最小大小 = 0x0 (0)
字节 12连接速度，位 [7:0]此连接支持的最大速度（单位为赫兹）的连接速度位 [7:0]。_SPE[7:0]
字节 13连接速度，位 [15:8]此连接支持的最大速度（单位为赫兹）的连接速度位 [15:8]。_SPE[15:8]
字节 14连接速度，位 [23:16]此连接支持的最大速度（单位为赫兹）的连接速度位 [23:16]。_SPE[23:16]
字节 15连接速度，位 [31:24]此连接支持的最大速度（单位为赫兹）的连接速度位 [31:24]。_SPE[31:24]
字节 16从地址，位 [7:0]该连接的 I2C 总线地址的低 8 位，_ADR[7:0]：位 [6:0] 地址的最低 7 位。在 7 位寻址模式下，这表示完整地址。
字节 17从地址，位 [15:8]该连接的 I2C 总线地址的高 8 位。高 8 位用于支持 10 位寻址，如果使用 7 位寻址，则应设为 0。_ADR[15:8]：位 [15:10] 保留。必须为 0。位 [9:8] 在 7 位寻址模式下，这些位保留且必须为 0。在 10 位寻址模式下，这些位是地址的最高两位。
字节 18供应商定义数据（可选）由供应商提供的、特定于控制器设备的数据。该字段中的字节数为类型数据长度 - 6。
……（可选）供应商提供的附加数据。
字符串资源源（长度 = L）此连接描述符适用的串行总线控制器设备的名称。该名称可以是完全限定路径、相对路径，或利用命名空间搜索规则的简单名称段

6.4.3.8.2.2. SPI 串行总线连接资源描述符

表 6.57 SPI 串行总线连接描述符

偏移字段名称定义
字节 0SPI 总线连接描述符值 = 0x8E (10001110B) - 类型 = 1，大项名称 = 0x0E
字节 1长度，位 [7:0]可变长度，最小值 = 0x12 + L（18 + 资源源字符串长度）
字节 2长度，位 [15:8]可变长度，最小值 = 0x00
字节 3修订 ID表示串行总线连接描述符的修订版本。此值为 1。
字节 4资源源索引保留（必须为 0）
字节 5串行总线类型对于 SPI，串行总线类型值必须为 2
字节 6通用标志 [7:0]适用于所有串行总线连接类型的标志。位 [7:2] 保留。必须为 0。位 [1] 使用者/生产者：0x1：该设备消耗此资源 0x0：该设备生产并消耗此资源 位 [0] 从模式，_SLV：0x0：该连接上的通信由控制器发起。0x1：该连接上的通信由设备发起。
字节 7类型特定标志，位 [7:0]位 [7:2] 保留（必须为 0）位 [1]：设备极性，_DPL 1 - 设备选择线为高电平有效 0 - 设备选择线为低电平有效 位 [0]：线模式。_MOD 1 - 该连接通过 3 线 0 - 该连接通过 4 线
字节 8类型特定标志，位 [15:8]保留。必须为 0。
字节 9类型特定修订 ID表示 SPI 特定串行总线连接描述符数据的修订版本。此值必须为 1。
字节 10类型数据长度，位 [7:0]可变长度，最小值 = 0x9 (9)。
字节 11类型数据长度，位 [15:8]可变长度，最小大小 = 0x0 (0)
字节 12连接速度，位 [7:0]此连接支持的最大速度（单位为赫兹）的连接速度位 [7:0]。_SPE[7:0]
字节 13连接速度，位 [15:8]此连接支持的最大速度（单位为赫兹）的连接速度位 [15:8]。_SPE[15:8]
字节 14连接速度，位 [23:16]此连接支持的最大速度（单位为赫兹）的连接速度位 [23:16]。_SPE[23:16]
字节 15连接速度，位 [31:24]此连接支持的最大速度（单位为赫兹）的连接速度位 [31:24]。_SPE[31:24]
字节 16数据位长度最小传输单元的位大小。_LEN
字节 17相位用于采样数据的时钟脉冲相位（CPHA）（另一个相位用于发送），_PHA：0 - 第一相位 1 - 第二相位
字节 18极性时钟的极性（CPOL）。该值指示时钟在第一相位期间为低还是高（见上文“相位”）。_POL 0 - 起始低 1 - 起始高
字节 19设备选择，位 [7:0]设备选择值的低 8 位。该值特定于设备，可能指代片选线、GPIO 线或其他线路选择机制。_ADR[7:0]
字节 20设备选择，位 [15:8]设备选择值的高 8 位。该值特定于设备，可能指代片选线、GPIO 线或其他线路选择机制。_ADR[15:8]
字节 21供应商定义数据（可选）由供应商提供的、特定于控制器设备的数据。该字段中的字节数为类型数据长度 - 9。
……（可选）供应商提供的附加数据。
字符串资源源（长度 = L）此连接描述符适用的串行总线控制器设备的名称。该名称可以是完全限定路径、相对路径，或利用命名空间搜索规则的简单名称段。

6.4.3.8.2.3. UART 串行总线连接资源描述符

表 6.58 UART 串行总线连接描述符

偏移字段名称定义
字节 0串行总线连接描述符值 = 0x8E (10001110B) - 类型 = 1，大项名称 = 0x0E
字节 1长度，位 [7:0]可变长度，最小值 = 0x13 + L（17 + 资源源字符串长度）
字节 2长度，位 [15:8]可变长度，最小值 = 0x00
字节 3修订 ID表示串行总线连接描述符的修订版本。此值为 1。
字节 4资源源索引保留（必须为 0）
字节 5串行总线类型对于 UART，串行总线类型值必须为 3
字节 6通用标志 [7:0]适用于所有串行总线连接类型的标志。位 [17:2] 保留。必须为 0。位 [1] 使用者/生产者：0x1：该设备消耗此资源 0x0：该设备生产并消耗此资源 位 [0] 从模式。_SLV 0x0：该连接上的通信由控制器发起：0x1：该连接上的通信由设备发起。
字节 7类型特定标志，位 [7:0]位 [7] - 字节序。_END 小端 = 0 大端 = 1 位 [6:4] - 数据位。每字节的位数。_LEN 000B - 5 位 001B - 6 位 010B - 7 位 011B - 8 位 100B - 9 位 位 [3:2] - 停止位。每个字符的停止位数。_STB 00B (0) - 无 01B (1) - 1 10B (2) - 1.5 11B (3) - 2 位 [1:0] - 流控制。表示连接的流控制类型。_FLC 00B (0) - 无 01B (1) - 硬件流控制 10B (2) - XON/XOFF
字节 8类型特定标志，位 [15:8]保留。必须为 0。
字节 9类型特定修订 ID表示 UART 特定串行总线连接描述符数据的修订版本。此值必须为 1。
字节 10类型数据长度，位 [7:0]可变长度，最小值 = 0x0A (10)。
字节 11类型数据长度，位 [15:8]可变长度，最小大小 = 0x0 (0)
字节 12默认波特率，位 [7:0]连接的默认波特率，以每秒位数表示。_SPE[7:0] 位 [7:0]
字节 13默认波特率，位 [15:8]连接的默认波特率，以每秒位数表示。_SPE[15:8] 位 [15:8]
字节 14默认波特率，位 [23:16]连接的默认波特率，以每秒位数表示。_SPE[23:16] 位 [23:16]
字节 15默认波特率，位 [31:24]连接的默认波特率，以每秒位数表示。_SPE[31:24] 位 [31:24]。
字节 16Rx FIFO，位 [7:0]此连接支持的最大接收 FIFO 缓冲区大小，以字节为单位。_RXL[7:0] 位 [7:0]
字节 17Rx FIFO，位 [15:8]此连接支持的最大接收 FIFO 缓冲区大小，以字节为单位。_RXL[15:8] 位 [15:8]
字节 18Tx FIFO，位 [7:0]此连接支持的最大发送缓冲区，以字节为单位。_TXL[7;0] 位 [7:0]
字节 19Tx FIFO，位 [15:8]此连接支持的最大发送缓冲区，以字节为单位。_TXL[15:8] 位 [15:8]
字节 20奇偶校验奇偶校验。_PAR 无 = 0x00 偶校验 = 0x01 奇校验 = 0x02 标记 = 0x03 空格 = 0x04
字节 21已启用的串行线路已启用的串行线路（启用 = 1，禁用 = 0），_LIN：位 [7] - 请求发送 (RTS) 位 [6] - 清除发送 (CTS) 位 [5] - 数据终端就绪 (DTR) 位 [4] - 数据设备就绪 (DSR) 位 [3] - 振铃指示 (RI) 位 [2] - 数据载波检测 (DTD) 位 [1] - 保留。必须为 0。位 [0] - 保留。必须为 0。
字节 22供应商定义数据（可选）由供应商提供的、特定于控制器设备的数据。该字段中的字节数为类型数据长度 - 10。
……（可选）供应商提供的附加数据。
字符串资源源（长度 = L）此连接描述符适用的串行总线控制器设备的名称。该名称可以是完全限定路径、相对路径，或利用命名空间搜索规则的简单名称段。

6.4.3.8.2.4. 摄像头串行接口 (CSI-2) 连接资源描述符

表 6.59 CSI-2 连接资源描述符

偏移量字段名称定义
字节 0CSI-2 连接描述符值 = 0x8E (10001110B) – Type = 1, 大项名称 = 0x0E
字节 1长度，位 [7:0]可变长度，最小值 = 0xF + L（15 + ResourceSource 字符串长度）
字节 2长度，位 [15:8]可变，长度最小值 = 0x00
字节 3修订版本 ID指示 CSI 资源描述符的修订版本。该值为 1。
字节 4资源源索引远程 Port 实例。如果此结构中 Resource Source 字段指定的控制器设备支持多个 Port，则此字段描述连接 CSI 传感器的 Port 实例。第一个 Port 实例为 0。
字节 5串行总线类型对于 CSI-2，串行总线类型值必须为 4
字节 6通用标志 [7:0]所有串行总线连接类型通用的标志：位 [7:2] 保留。必须为 0。位 [1] 使用者/生产者：0x0：此设备生成并消耗此资源 0x1：此设备消耗此资源 位 [0] 从属模式。_SLV 0x0：通过此连接的通信由控制器发起。0x1：通过此连接的通信由设备发起。
字节 7类型特定标志，位 [7:0]位 [7:2] 本地 Port 实例 _PRT。如果此设备支持多个本地 CSI-2 Port，则此值反映此连接所使用的本地 Port 的索引。第一个 Port 实例为 0。位 [1:0] PHY 类型 _PHY：00b - C-PHY 01b - D-PHY 其他值保留
字节 8类型特定标志，位 [15:8]保留。必须为 0。
字节 9类型特定修订版本 ID指示 CSI 特定串行总线连接描述符数据的修订版本。该值为 1。
字节 10类型数据长度，位 [7:0]可变长度，最小大小 = 0。
字节 11类型数据长度，位 [15:8]可变长度，最小大小 = 0。
字节 12供应商定义数据（可选）由供应商提供的、特定于控制器设备的数据。此字段中的字节数为类型数据长度。_VEN
……（可选）供应商提供的附加数据。
字节 12 + Type Data Length (String)资源源（长度 = L）此连接描述符适用的 CSI-2 控制器设备名称。该名称可以是完全限定路径、相对路径，或利用命名空间搜索规则的简单名称段。