USB转原生UART_autosuspend_型号兼容

NextPF 三大作业实战指南（MTK8788 / Android 15）

平台：MTK8788（SoC = MT6771）/ Android 15 / kernel-6.6

读法：每节先"是什么/为什么"（小白看），再"代码在哪/长啥样"（带全路径+行号），最后"怎么改/怎么测/怎么排错"（专业落地）。

0. 这张图要做的三件事

1. 名词扫盲

2. 关键文件全路径清单（照着打开）

链路图

open("/dev/ttyS1") → tty框架 → 8250_port.c → 8250_mtk.c → mt6771.dts apuart1 → 硬件 SoC UART @0x11003000

8250_mtk.c 函数行号（已核实）

3. 作业一：USB-UART → 原生 USB

现状（gki_defconfig 已核实）

542: CONFIG_USB_SERIAL=m 543: CONFIG_USB_SERIAL_FTDI_SIO=m # 现在靠FTDI桥

路径：MCU→FTDI芯片→USB→主机。

目标

MCU→SoC apuart→ttyS*，匹配mediatek,mt6577-uart（8250_mtk.c:649）。

dts 节点（mt6771.dts 已核实）

apuart1: serial@11003000 { compatible = "mediatek,mt6577-uart"; reg = <0 0x11003000 0 0x1000>; interrupts = <GIC_SPI 92 IRQ_TYPE_LEVEL_HIGH 0>; clocks = <&clk26m>, <&infracfg_ao INFRACFG_AO_UART1_CG>; clock-names = "baud", "bus"; dmas = <&apdma 2 &apdma 3>; dma-names = "tx", "rx"; };

改：&apuart1 { pinctrl-0=<&uart1_pin>; status="okay"; };，FTDI 留=m兼容旧机。

4. 真实引脚号（mt6771-pinfunc.h 已核实）

pinctrl 示例：

uart1_pin: uart1-pins { pins { pinmux = <PINMUX_GPIO19__FUNC_URXD1>, <PINMUX_GPIO20__FUNC_UTXD1>; }; };

带流控加 GPIO23/24。

5. 作业二：禁用 autosuspend（核心）

为什么：闲→关baud/bus时钟→来数据来不及上电→丢字节。

源码（已核实）

probe(L584):pm_runtime_set_active+pm_runtime_enable
suspend(L429):while(serial_in DEBUG0)等空闲→关uart_clk/bus_clk
do_pm(L455): 开口get_sync 关口put_sync_suspend
深睡(L604):pinctrl_pm_select_sleep_state+enable_irq_wake(rx_wakeup_irq)

禁法

• A 验证：echo on>.../power/control；autosuspend_delay_ms=-1
• B dts不写延时
• C 改驱动去掉pm_runtime_enable
  查：runtime_status=active，idle后不丢。

6. 作业三：型号兼容

status="okay"/"disabled"overlay 切；驱动内置；应用打不开ttyS1容错。

7. 流控(L243) / 8. DMA(L155)

HW=EFR_HW_FC开CTSI/RTSI；SW=XON1/XOFF1；DMA=dma-names tx/rx需CONFIG_SERIAL_8250_DMA。

9. 排错

10. 自检

• echo>/dev/ttyS1收发 [ ] idle后不丢 [ ] active [ ] 双机型同镜像 [ ] dmesg无错