tcpm_typec_disable_function调用后端口无响应？

Question

调用 `tcpm_typec_disable_function` 后端口无响应是常见于 USB Type-C 端口管理中的疑难问题。该函数用于禁用 Type-C 端口的电源传输和角色协商功能，但在某些平台（如基于 Intel PMIC 或 TI TPS6598x 的设计）中，若未正确处理状态机迁移或未重置底层 TCPM（Type-C Power Manager）状态，可能导致端口陷入不可恢复的挂起状态。常见表现为：调用后无法重新启用端口、CC 线无检测、VCONN 供电异常或 PD 通信中断。问题根源通常包括资源锁未释放、中断处理未清除、或硬件复位序列缺失。需结合内核日志与 I2C 通信跟踪，确认 TCPM 状态机是否停留在非活动态，并检查相关回调是否被阻塞。

Answer 1

1. 问题背景与现象描述

在现代嵌入式系统中，USB Type-C 接口的电源管理由 TCPM（Type-C Power Manager）模块负责。调用 tcpm_typec_disable_function 是一种常见的操作，用于临时禁用端口的电源传输（PD）协商和角色切换功能，例如在设备进入低功耗模式或热插拔检测阶段。

然而，在基于 Intel PMIC 或 TI TPS6598x 等特定硬件平台中，若该函数执行后未正确清理状态机上下文，可能导致端口陷入“无响应”状态。典型表现为：

• CC 引脚电压检测失效，无法识别连接设备
• VCONN 供电异常，导致有源线缆无法工作
• PD 消息通信中断，即使重新启用也无法恢复
• 调用 tcpm_register_port 后仍无法唤醒端口
• 内核日志显示 “port stuck in disabled state” 错误

2. 根本原因分析：从资源锁到状态机迁移

深入分析此类问题，需关注 TCPM 子系统的内部状态机行为。Linux 内核中的 TCPM 驱动采用有限状态机（FSM）模型控制端口行为。当调用 tcpm_typec_disable_function 时，理想路径应为：

1. 暂停 PD 协商任务
2. 释放 Type-C 角色控制权
3. 清除中断使能位
4. 重置 FSM 至初始态（如 DISABLED 或 UNATTACHED）
5. 通知上层取消注册回调

但在部分平台实现中，以下缺陷会导致状态迁移失败：

问题类别	具体表现	影响组件
资源锁未释放	mutex 被持有但未 unlock	PD worker thread 阻塞
中断未屏蔽	CC 变化中断持续触发	中断下半部死锁
TCPM 状态未重置	state == ATTACHED_SRC	角色切换逻辑错乱
硬件复位缺失	TPS6598x 未 soft-reset	I2C 寄存器残留旧配置
回调阻塞	.notify_disconnected()	用户空间事件丢失

3. 分析方法与调试手段

为定位此类疑难问题，建议结合软硬件多维度排查：

# 查看内核日志中 TCPM 相关输出
dmesg | grep -i "tcpm\|typec\|pd"

# 检查 I2C 通信是否正常（以 TPS6598x 为例）
i2cdump -y 1 0x50     # 读取设备寄存器
i2cget -y 1 0x50 0x0A # 获取端口状态字节

# 使用 ftrace 跟踪函数调用链
echo function_graph > /sys/kernel/debug/tracing/current_tracer
echo tcpm_* > /sys/kernel/debug/tracing/set_ftrace_filter
cat /sys/kernel/debug/tracing/trace_pipe

重点关注以下信号流：

1. tcpm_typec_disable_function() 是否返回成功
2. 后续是否有 tcpm_set_state() 进入 hard_reset 或 unattached
3. 中断处理函数 tcpm_irq_handler() 是否仍在运行
4. workqueue 中的任务是否被 cancel

4. 解决方案设计与代码修复示例

针对上述问题，提出分层修复策略：

1. 确保在 disable 前取消所有 pending work
2. 显式调用硬件 reset 序列（尤其对 TPS6598x）
3. 强制将 FSM 设置为已知安全状态
4. 添加超时机制防止无限等待

修复代码片段如下：

static int fixed_tcpm_disable(struct tcpm_port *port)
{
    // Step 1: Cancel all queued works
    cancel_delayed_work_sync(&port->state_machine);
    
    // Step 2: Disable interrupts
    tcpm_disable_interrupts(port);

    // Step 3: Reset internal state
    port->state = SNK_UNATTACHED;
    port->pending_hard_reset = false;

    // Step 4: Optional hardware reset (TPS6598x specific)
    if (port->drv->hard_reset)
        port->drv->hard_reset(port);

    // Step 5: Release mutex and notify
    mutex_unlock(&port->lock);
    typec_set_role(port->typec_port, TYPEC_NO_ROLE);

    return 0;
}

5. 状态机恢复流程图（Mermaid）

下图为推荐的状态迁移路径，确保从 DISABLE 到 RE-ENABLE 的可恢复性：

graph TD
    A[tcpm_typec_disable_function] --> B[Cancel Workqueue]
    B --> C[Disable Interrupts]
    C --> D[Clear Pending Events]
    D --> E[Hard Reset TCPM Chip]
    E --> F[Set FSM to UNATTACHED]
    F --> G[Release Mutex Lock]
    G --> H[Notify Upper Layers]
    H --> I[Port Ready for Re-enable]

6. 平台差异与兼容性建议

不同 PMIC 平台对 TCPM 管理存在显著差异：

平台	关键注意事项	推荐补丁点
Intel PMIC (RPMH)	需同步 PDC（Power Domain Controller）状态	在 disable 中调用 rpmh_power_off
TI TPS6598x	必须执行 SOFT_RESET 命令（I2C 0x0B）	集成到 .hard_reset 回调
ST USB-PD MCU	固件可能需重启	发送 BOOT_CMD
NXP PTN5150	依赖 GPIO 复位引脚	控制 RESET_N 管脚

建议在驱动初始化阶段注册平台特定的 reset_hook，以增强可维护性。