# TLMM

Source: [https://docs.qualcomm.com/doc/80-70014-4Y/topic/tlmm-developer-touchpoints.html](https://docs.qualcomm.com/doc/80-70014-4Y/topic/tlmm-developer-touchpoints.html)

顶层模式多路复用控制器 (TLMM) 有助于实现通用输入/输出 (GPIO) 和由硬件驱动的备用功能的多路复用。TLMM 的 DT 属性可以在启动过程中配置 GPIO。

文件路径：

- \boot\_images\boot\Settings\Soc\&lt;Chipset&gt;\Core\SocInfra\TLMM\&lt;Chipset&gt;-pinctrl.dtsi
- \boot\_images\boot\Settings\Soc\&lt;Chipset&gt;\Core\SocInfra\TLMM\tlmm.dtsi

下表列出了描述如何根据主板要求配置 GPIO 默认值的属性。

| 属性名称 | 属性描述 | 数据类型 | 可能的值/取值范围 | 设备行为 |
| --- | --- | --- | --- | --- |
| QCOM, sleep-config | &lt;Chipset&gt;-pinctrl.dtsi 中定义的 GPIO 配置设置。适用于设备启动。 | UINT32 | 引脚方向：<br><ul class="ul" id="tlmm-developer-touchpoints__ul_emt_cmk_l1c"><br>                                <li class="li">GPIO_INPUT – 0x1</li><br><br>                                <li class="li">GPIO_OUTPUT – 0x2</li><br><br>                                <li class="li">引脚拉拔配置：</li><br><br>                                <li class="li">GPIO_PULL_DOWN – 0x4</li><br><br>                                <li class="li">GPIO_PULL_UP – 0x8</li><br><br>                                <li class="li">GPIO_NO_PULL – 0x10</li><br><br>                                <li class="li">GPIO_KEEPER – 0x20</li><br><br>                                <li class="li">引脚输出：</li><br><br>                                <li class="li">GPIO_OUT_LOW – 0x40</li><br><br>                                <li class="li">GPIO_OUT_HIGH – 0x80</li><br><br>                                <li class="li">GPIO_PRG_YES – 0x100</li><br><br>                                <li class="li">GPIO_PRG_NO – 0x000</li><br><br>                            </ul> | <ul class="ul" id="tlmm-developer-touchpoints__ul_jzt_kmk_l1c"><br>                                <li class="li">默认值为 GPIO_INPUT<ul class="ul" id="tlmm-developer-touchpoints__ul_khh_lmk_l1c"><br>                                        <li class="li">GPIO_INPUT：允许读取输入引脚的状态</li><br><br>                                        <li class="li">GPIO_OUTPUT：控制输出引脚的输出状态</li><br><br>                                    </ul><br></li><br><br>                            </ul><ul class="ul" id="tlmm-developer-touchpoints__ul_wbp_lmk_l1c"><br>                                <li class="li">默认值为 GPIO_PULL_DOWN。<ul class="ul" id="tlmm-developer-touchpoints__ul_ows_lmk_l1c"><br>                                        <li class="li">GPIO_PULL_DOWN – 逻辑 0，视为接地</li><br><br>                                        <li class="li"><br>                                            <p class="p">GPIO_PULL_UP – 逻辑 1，连接到 Vdd 电源</p><br><br>                                        </li><br><br>                                        <li class="li"><br>                                            <p class="p">GPIO_NO_PULL – 浮动/高阻抗状态</p><br><br>                                        </li><br><br>                                        <li class="li"><br>                                            <p class="p">GPIO_KEEPER – 保持 GPIO 先前的状态。当 SoC 进入最深层省电模式时，将应用此配置。</p><br><br>                                        </li><br><br>                                    </ul><br></li><br><br>                            </ul><ul class="ul" id="tlmm-developer-touchpoints__ul_xbm_4mk_l1c"><br>                                <li class="li">默认值为 GPIO_OUT_LOW<p class="p">GPIO_OUT_HIGH – 逻辑高电平，视为连接到 Vdd。</p><br></li><br><br>                            </ul><ul class="ul" id="tlmm-developer-touchpoints__ul_tdt_4mk_l1c"><br>                                <li class="li">默认值为 GPIO_PRG_NO。<p class="p">GPIO_PRG_YES - 确保任何未使用的 GPIO 在启动后保持低功耗状态</p><br></li><br><br>                            </ul><br><br>                            <br><br><br><br>                            <br>示例：<br><br><br>                            <br>`(GPIO_INPUT | GPIO_PULL_DOWN | GPIO_OUT_LOW | GPIO_PRG_NO) /* PIN 10 */` |
| Compatible | 包含指向兼容芯片组的字符串。<br><br><br>这是只读属性。<br><br><br>示例：<br><br>compatible = "qcom,&lt;chipset&gt;-pinctrl" | String | – | – |
| reg | 表示 GPIO 基址和大小。<br><br><br>                            <br>这是只读属性。<br><br><br>                            <br>在 reg 属性元组中，第一个索引包含基址，第二个索引包含大小。示例： `reg = <0xf100000 0x100000>;` | UINT32 | – | – |
| ngpios | 芯片组中的 GPIO 引脚数量。<br><br><br>                            <br>这是只读属性。<br><br><br>                            <br>示例：<br><br><br>                            <br>`ngpios = <175>;` | UINT32 | – | – |
| width | 每个 GPIO 引脚都有自己的一组控制寄存器。宽度表示引脚到引脚的寄存器偏移量。<br><br><br>                            <br>这是只读属性。<br><br><br>                            <br>示例：<br><br><br>                            <br>`width = <0x1000>;` | – | – | – |
| id | GPIO 接插口 ID 的硬件实例<br><br><br>                            <br>这是只读属性。<br><br><br>                            <br>示例：<br><br><br>                            <br>`id = <0x0>;` | UINT32 | – | – |
| version | GPIO 驱动程序版本。<br><br><br>                            <br>这是只读属性。<br><br><br>                            <br>驱动程序 1.0 称为 0x1。<br><br><br>                            <br>示例：<br><br><br>                            <br>`version = <0x1>;` | UINT32 | – | – |
| gpio-controller | 用于将连接的设备表示为 GPIO 设备的标识符。<br><br><br>                            <br>这是只读属性。 | 字符串 | – | – |
| phandles for pin configurations | 用于配置 GPIO 备选功能的多路复用配置。有关详细信息，请参阅 [引脚说明](https://docs.qualcomm.com/bundle/80-23889-1/resource/80-23889-1_REV_AM_QCS6490_QCS5430_Data_Sheet.pdf)。<br><br><br>                            <br>示例：<br><br><br>                            <br>`sdc4_data_1: sdc4_data_1 { mux = <13 3>; };`<br><br><br>                            <br>在此处，13 表示 GPIO 编号，3 则表示备用功能选择。 | – | `sdc4_data_1: sdc4_data_1 { mux = <13 3>; };` | 启动时，GPIO 配置为 GPIO 的备用功能。 |

**Parent Topic:** [接口](https://docs.qualcomm.com/doc/80-70014-4Y/topic/interfaces.html)

Last Published: Feb 03, 2026

[Previous Topic
PMIC](https://docs.qualcomm.com/bundle/publicresource/80-70014-4Y/topics/pmic-developer-touchpoints.md) [Next Topic
总线](https://docs.qualcomm.com/bundle/publicresource/80-70014-4Y/topics/buses.md)