简介MTK_USB_VCOM驱动源码包面向MTK平台开发与调试人员解决MediaTek芯片设备与PC之间通过USB虚拟串口通信的问题适用于固件升级、串口调试与故障排查等场景。包内共8个文件以exe安装程序为主配合inf驱动安装信息、cat数字签名及xml配置另有bmp位图资源整体约727KB结构紧凑便于直接部署与源码研读。源码涵盖驱动初始化、USB枚举、描述符解析、端点读写与虚拟串口创建等核心环节并包含错误检查与调试输出机制可帮助读者理解USB转串口的完整实现路径。目前已有1239人学习下载适合需要掌握MTK平台通信驱动原理、进行二次定制或排错的中高级开发者参考。1. MTK USB VCOM 驱动源码从 preloader 握手到串口枚举的完整链路MTK 平台的 USB VCOMVirtual COM Port驱动源码是联发科芯片在 BROM/preloader 阶段与 PC 端工具通信的核心组件。当你把一台 MTK 手机插上电脑设备管理器里冒出一个MediaTek USB Port或MediaTek PreLoader USB VCOM背后跑的就是这套东西。它解决的不是普通 USB 转串口芯片CH340、CP2102、FT232R那种固定 VID/PID 的枚举问题而是 MTK 芯片在不同启动阶段动态切换 USB 描述符、动态上报不同接口协议的场景。适合谁看做 MTK 平台刷机工具、产线烧录工装、售后维修诊断、以及需要自己编译或裁剪 VCOM 驱动的嵌入式工程师。热词里常出现的status: waiting for preloader vcom, please reconnect mobile to brom mode本质就是驱动没匹配上 preloader 阶段上报的 PID工具在等一个永远不会出现的串口句柄。这篇把源码结构、编译方法、参数配置和踩坑点一次讲透。2. MTK VCOM 源码的目录结构与驱动模型拆解2.1 源码包常见组成与各文件职责MTK 官方释放的 USB VCOM 驱动源码通常以MTK_USB_VCOM或SP_Drivers形式出现Windows 侧是 WDM/WDF 内核驱动Linux 侧是option.c的 vendor 扩展。一个典型的 Windows 驱动源码包结构如下文件/目录职责是否必须改driver/mtk_usb_vcom.c驱动入口、AddDevice、IRP 分发改 PID 表时动driver/mtk_vcom_inf.c生成 INF 的模板逻辑改 VID/PID 时动driver/mtk_serial.c串口读写、波特率模拟一般不动driver/mtk_usb_ids.hVID/PID/接口类定义必看inf/mtk_usb_vcom.inf安装信息文件部署时改lib/*.libMTK 预编译的 USB 协议栈无源码关键点在于mtk_usb_ids.h它定义了 MTK 在不同启动阶段上报的 PID。BROM 阶段通常是0x0003preloader 阶段是0x2000DA 阶段又切到0x2001。驱动靠这张表决定是否接管设备。/* mtk_usb_ids.h 节选不同启动阶段的 PID 映射 */ #define MTK_VID 0x0E8D /* 联发科统一 VID */ #define MTK_PID_BROM 0x0003 /* BROM 模式芯片最底层 */ #define MTK_PID_PRELOADER 0x2000 /* preloader 阶段VCOM 首次出现 */ #define MTK_PID_DA 0x2001 /* Download Agent 阶段 */ #define MTK_PID_META 0x2007 /* META 模式射频调试用 */ /* 驱动匹配表只有列出的 PID 才会被本驱动接管 */ static const struct usb_device_id mtk_vcom_table[] { { USB_DEVICE(MTK_VID, MTK_PID_BROM) }, { USB_DEVICE(MTK_VID, MTK_PID_PRELOADER) }, { USB_DEVICE(MTK_VID, MTK_PID_DA) }, { } };逻辑说明USB_DEVICE宏展开成match_flagsidVendoridProduct内核在枚举时逐条比对。参数说明MTK_VID固定0x0E8D不要改PID 按你手上芯片的 preloader 实际上报值填MT6765、MT6768、MT6833 的 preloader PID 可能不同用 USB 抓包或lsusb -v确认后再改。2.2 Windows 与 Linux 两套驱动模型的差异Windows 侧走的是 WDFKMDF框架驱动对象是WDFDRIVER设备对象是WDFDEVICE串口功能通过WDFQUEUE模拟。Linux 侧则简单得多直接往drivers/usb/serial/option.c的option_ids[]里加一行然后实现usb_serial_driver的open/close/write_room回调。/* Linux option.c 中追加 MTK VCOM 支持 */ static const struct usb_device_id option_ids[] { { USB_DEVICE(0x0E8D, 0x2000) }, /* preloader VCOM */ { USB_DEVICE(0x0E8D, 0x2001) }, /* DA VCOM */ { } }; static struct usb_serial_driver mtk_vcom_device { .driver { .owner THIS_MODULE, .name mtk_vcom, }, .id_table option_ids, .num_ports 1, .open mtk_vcom_open, .close mtk_vcom_close, .write mtk_vcom_write, .write_room mtk_vcom_write_room, };逻辑说明option_ids是匹配表usb_serial_driver是行为表。参数说明num_ports对 MTK VCOM 恒为 1因为 preloader 只暴露一个 bulk 端点对write_room返回当前可写字节数MTK 的 FIFO 深度一般是 4096返回太小会导致工具端写超时。选型理由如果你只是做刷机工具Windows 侧直接用 MTK 官方签名的usbser.sys变体最省事如果要定制协议或做产线自动化必须拿源码改 PID 表和超时参数。Linux 侧几乎没有选型余地option.c是唯一正路。3. 从零编译并加载 MTK VCOM 驱动的最小步骤3.1 Windows 侧WDK 编译与测试签名先装 WDK版本要和你目标系统匹配Win7 用 WDK 7600Win10/11 用 WDK 2004 以上然后进源码目录。# 以 Win10 x64 为例在 WDK 命令行环境执行 cd MTK_USB_VCOM\driver msbuild mtk_usb_vcom.vcxproj /p:ConfigurationRelease /p:Platformx64 # 生成测试证书仅开发机用产线必须用正式签名 makecert -r -pe -ss PrivateCertStore -n CNMTKTestCert MTKTestCert.cer signtool sign /v /s PrivateCertStore /n MTKTestCert /t http://timestamp.digicert.com mtk_usb_vcom.sys # 安装驱动 devcon install mtk_usb_vcom.inf USB\VID_0E8DPID_2000逻辑说明msbuild按 vcxproj 编译出.sysmakecert生成自签名证书signtool签名devcon是 WDK 自带的命令行设备安装工具。参数说明/p:Platformx64必须和你的目标系统一致32 位工具链编出来的驱动在 64 位系统上加载会报0xC0000428签名无效。devcon install的硬件 ID 必须和 INF 里的[Standard.NT$ARCH$]段一致。提示Win10 1607 以后强制驱动签名测试签名需要在开机时按 F8 进高级启动禁用强制签名或者用bcdedit /set testsigning on后重启。产线环境不要用测试签名会翻车。3.2 Linux 侧内核模块编译与 insmodLinux 侧改完option.c后最干净的做法是单独编一个option.ko不要重编整个内核。# 进入内核源码目录只编译 option 模块 cd /usr/src/linux-headers-$(uname -r) make Mdrivers/usb/serial modules # 加载模块 sudo insmod drivers/usb/serial/option.ko # 确认 MTK VCOM 是否枚举成功 dmesg | grep -i mtk_vcom ls -l /dev/ttyUSB*逻辑说明make M只编译指定目录的模块速度快insmod加载后内核会重新匹配 USB 设备dmesg看驱动 probe 日志。参数说明如果你的内核已经内置了option驱动需要先rmmod option再insmod新编的否则会报File exists。/dev/ttyUSB*的编号取决于系统里已有多少串口设备MTK VCOM 通常排在最后。3.3 验证驱动是否真正接管设备装完驱动不代表能用必须验证三件事设备管理器/lsusb里 PID 对不对、串口能不能打开、preloader 握手能不能过。# Linux 下确认 PID 和驱动绑定 lsusb -d 0e8d: # 输出示例Bus 001 Device 012: ID 0e8d:2000 MediaTek Inc. MTK PreLoader USB VCOM # 查看驱动绑定 ls /sys/bus/usb/drivers/mtk_vcom/ # 应该能看到 1-2:1.0 这样的接口目录 # 用 minicom 或 picocom 打开串口波特率对 MTK VCOM 无意义随便设 picocom -b 115200 /dev/ttyUSB0逻辑说明lsusb -d 0e8d:按 VID 过滤确认 PID 是2000还是2001/sys/bus/usb/drivers/下能看到接口说明驱动 probe 成功picocom打开串口后如果工具端能收到 preloader 的握手包说明链路通了。参数说明MTK VCOM 是虚拟串口波特率参数被驱动忽略设多少都行但有些工具会检查termios结构建议设115200避免工具报错。4. 参数配置与 PID 匹配让驱动认对芯片的四个关键点4.1 VID/PID 表的动态扩展方法MTK 芯片型号多PID 不统一。MT6765 的 preloader PID 可能是0x2000MT6833 可能是0x2001MT6768 又不一样。最稳的做法是把已知 PID 全列进匹配表而不是只写一个。/* 扩展后的匹配表覆盖多个平台 */ static const struct usb_device_id mtk_vcom_table[] { { USB_DEVICE(0x0E8D, 0x0003) }, /* BROM */ { USB_DEVICE(0x0E8D, 0x2000) }, /* preloader 通用 */ { USB_DEVICE(0x0E8D, 0x2001) }, /* DA 通用 */ { USB_DEVICE(0x0E8D, 0x2007) }, /* META */ { USB_DEVICE(0x0E8D, 0x201C) }, /* MT6765 部分批次 */ { USB_DEVICE(0x0E8D, 0x2020) }, /* MT6833 部分批次 */ { } };逻辑说明内核匹配是「或」关系表里任意一条命中就 probe。参数说明不要盲目加未知 PID加错了会导致驱动接管非 MTK 设备把正常串口设备搞挂。加之前先用lsusb -v确认idVendor是0x0E8D。4.2 超时与缓冲区参数怎么调MTK VCOM 在 preloader 阶段对超时很敏感。驱动默认的URB超时是 5000ms但 preloader 握手窗口只有 2 秒左右超时设太长会导致工具端已经放弃、驱动还在等。参数默认值建议值影响URB_TIMEOUT5000ms2000ms太长会错过 preloader 窗口READ_BUFFER_SIZE40968192太小会丢 DA 阶段的大包WRITE_BUFFER_SIZE40968192同上POLL_INTERVAL100ms50ms影响握手响应速度/* 在 mtk_usb_vcom.c 中调整超时 */ #define MTK_URB_TIMEOUT 2000 /* 单位 ms匹配 preloader 窗口 */ #define MTK_READ_BUF_SIZE 8192 #define MTK_WRITE_BUF_SIZE 8192 /* 提交 URB 时传入超时 */ urb-transfer_flags | URB_NO_TRANSFER_DMA_MAP; usb_fill_bulk_urb(urb, dev, pipe, buf, len, mtk_complete, ctx); urb-timeout msecs_to_jiffies(MTK_URB_TIMEOUT);逻辑说明usb_fill_bulk_urb填充 URBurb-timeout控制单次传输超时。参数说明msecs_to_jiffies把毫秒转成内核 jiffies不要直接写数字。URB_NO_TRANSFER_DMA_MAP表示 buf 已经是 DMA 地址如果你用的是kmalloc分配的普通内存不要加这个 flag。4.3 多设备同时接入时的实例管理产线工装经常一台 PC 接 8 个甚至 16 个 MTK 设备同时烧录。驱动必须支持多实例每个设备一个WDFDEVICE或一个usb_serial_port。/* Linux 侧多实例每个接口一个 port 结构 */ static int mtk_vcom_probe(struct usb_serial *serial, const struct usb_device_id *id) { struct usb_serial_port *port; int i; for (i 0; i serial-num_ports; i) { port serial-port[i]; /* 为每个 port 分配独立的读写缓冲区 */ port-read_urb-transfer_buffer kmalloc(MTK_READ_BUF_SIZE, GFP_KERNEL); port-write_urb-transfer_buffer kmalloc(MTK_WRITE_BUF_SIZE, GFP_KERNEL); } return 0; }逻辑说明probe在设备插入时调用serial-num_ports对 MTK VCOM 是 1但循环写法兼容多接口设备。参数说明GFP_KERNEL表示可睡眠分配在 probe 上下文里安全如果在中断上下文要用GFP_ATOMIC。每个 port 独立分配缓冲区避免多设备共享导致数据串包。4.4 INF 文件里的硬件 ID 与兼容 ID 写法Windows 侧 INF 写不对驱动根本不会加载。关键是[Standard.NT$ARCH$]段和[MTK_Models]段的对应关系。[Version] Signature$Windows NT$ ClassPorts ClassGuid{4D36E978-E325-11CE-BFC1-08002BE10318} Provider%MTK% CatalogFilemtk_usb_vcom.cat [Manufacturer] %MTK%MTK,NTamd64 [MTK.NTamd64] %MTK_VCOM_Device%MTK_Install, USB\VID_0E8DPID_2000 %MTK_VCOM_Device%MTK_Install, USB\VID_0E8DPID_2001 [MTK_Install.NT] CopyFilesMTK_CopyFiles [MTK_CopyFiles] mtk_usb_vcom.sys [MTK_Install.NT.Services] AddServicemtk_usb_vcom,0x00000002,MTK_Service [MTK_Service] DisplayName%MTK_VCOM_Service% ServiceType1 StartType3 ErrorControl1 ServiceBinary%12%\mtk_usb_vcom.sys逻辑说明[MTK.NTamd64]段把硬件 ID 映射到安装节AddService注册内核服务ServiceBinary指向%12%即System32\drivers。参数说明StartType3表示按需启动改成2是自动启动一般用3。CatalogFile必须和签名用的.cat文件名一致否则安装报0xE0000247。5. 避坑与排查MTK VCOM 驱动最常见的五个翻车现场5.1 设备管理器显示黄色感叹号错误码 10 或 28现象插上 MTK 设备设备管理器里出现MediaTek USB Port但带黄色感叹号属性里错误码10设备无法启动或28驱动未安装。原因错误码 10 通常是 INF 里的硬件 ID 和实际上报的 PID 不匹配驱动被加载了但StartDevice失败错误码 28 是根本没有匹配的 INF系统没找到驱动。解决先用lsusb -v或 USB 抓包确认实际 PID然后检查 INF 里[MTK.NTamd64]段是否包含这个 PID。如果是错误码 10还要看mtk_usb_vcom.c里EvtDevicePrepareHardware是否返回了失败常见原因是端点地址写错MTK 的 bulk IN 是0x81OUT 是0x01不要搞反。5.2 工具一直卡在 waiting for preloader vcom现象刷机工具界面显示status: waiting for preloader vcom, please reconnect mobile to brom mode设备管理器里能看到设备但工具就是连不上。原因驱动接管了设备但串口句柄没正确暴露给工具或者 preloader 上报的 PID 被驱动过滤掉了。另一个常见原因是驱动加载太慢preloader 窗口只有 2 秒驱动 probe 还没完成preloader 已经超时切到 BROM 了。解决把URB_TIMEOUT降到 2000ms 以下POLL_INTERVAL降到 50ms确认 INF 里包含了 preloader 的 PID如果是 USB 3.0 接口换到 USB 2.0 口试试部分 MTK 芯片在 USB 3.0 下枚举会多花 500ms 以上。5.3 Linux 下 /dev/ttyUSB0 能打开但读写无数据现象picocom能打开/dev/ttyUSB0但发数据没反应收数据也收不到。原因option驱动默认把 MTK VCOM 当成普通 3G 模块处理走了usb_wwan的 AT 命令通道而不是 raw bulk 通道。MTK VCOM 需要的是纯 bulk 透传不需要 AT 解析。解决在mtk_vcom_open里跳过usb_wwan_open直接usb_submit_urb提交读 URB或者在option.c的option_blacklist里把 MTK VCOM 标记为RESERVED阻止usb_wwan接管。5.4 多设备同时插入时串口号错乱现象产线工装插 8 个设备/dev/ttyUSB0到/dev/ttyUSB7的编号每次都不一样工具绑错设备。原因Linux 的ttyUSB编号是按 probe 顺序分配的多设备同时插入时顺序不确定。解决用 udev 规则按 USB 物理端口路径绑定固定名字。# /etc/udev/rules.d/99-mtk-vcom.rules SUBSYSTEMtty, ATTRS{idVendor}0e8d, ATTRS{idProduct}2000, \ KERNELS1-2.1, SYMLINKmtk_vcom_01 SUBSYSTEMtty, ATTRS{idVendor}0e8d, ATTRS{idProduct}2000, \ KERNELS1-2.2, SYMLINKmtk_vcom_02逻辑说明KERNELS匹配 USB 物理端口路径SYMLINK创建固定名字。参数说明1-2.1这种路径用udevadm info -a -n /dev/ttyUSB0查每台机器不一样产线工装要固定 USB 口物理位置。5.5 驱动签名过期导致产线批量安装失败现象开发机上驱动能用拷到产线机器上装不上报0xE000024B或0x800B0100。原因测试签名证书有有效期过期后签名失效或者产线机器没导入证书链。解决产线必须用正式代码签名证书EV 证书或企业证书不要用makecert自签的。如果只是内部工装把证书导入到Trusted Root和Trusted Publishers然后bcdedit /set testsigning on。但注意testsigning on会在桌面右下角显示水印客户产线可能不接受。6. 进阶用 USB 抓包反推 PID 与自定义 VCOM 协议6.1 用 Wireshark USBPcap 抓 preloader 握手包当 PID 表里没有你手上芯片的 PID 时最可靠的办法是抓包看设备到底上报了什么。Windows 侧装 USBPcapLinux 侧用usbmon。# Linux 下用 usbmon 抓包 sudo modprobe usbmon sudo tshark -i usbmon1 -w mtk_vcom.pcap # 插上 MTK 设备等 preloader 上报后停止抓包 # 用 tshark 过滤出设备描述符 tshark -r mtk_vcom.pcap -Y usb.idVendor 0x0e8d -T fields \ -e usb.idVendor -e usb.idProduct -e usb.bDescriptorType逻辑说明usbmon是 Linux 内核的 USB 抓包模块tshark过滤idVendor 0x0e8d的包输出 VID/PID。参数说明usbmon1对应 bus 1具体 bus 号用lsusb看。抓包要在设备插入前就开始否则会漏掉设备描述符阶段。6.2 从抓包结果反推驱动匹配表抓到 PID 后不要急着改代码先确认这个 PID 在 BROM、preloader、DA 三个阶段是否一致。有些芯片三个阶段 PID 相同有些不同。阶段典型 PID是否暴露 VCOM驱动是否应接管BROM0x0003否否BROM 不走 VCOMpreloader0x2000是是DA0x2001是是META0x2007是按需逻辑说明BROM 阶段虽然也有 USB但走的是 BROM 协议不是 VCOM驱动不应该接管。参数说明如果你的抓包显示 preloader PID 是0x201C就把它加进匹配表但不要加 BROM 的0x0003否则驱动会尝试接管 BROM 设备导致刷机工具报错。6.3 自定义 VCOM 协议时的端点配置如果你要在 MTK VCOM 基础上做自定义协议比如产线加密烧录需要改端点配置。MTK 的 bulk 端点对是固定的但你可以加一个 interrupt 端点做控制通道。/* 自定义协议在原有 bulk 端点基础上加 interrupt 控制端点 */ static struct usb_endpoint_descriptor mtk_ctrl_endpoint { .bLength USB_DT_ENDPOINT_SIZE, .bDescriptorType USB_DT_ENDPOINT, .bEndpointAddress 0x82, /* IN 方向地址 2 */ .bmAttributes USB_ENDPOINT_XFER_INT, .wMaxPacketSize cpu_to_le16(64), .bInterval 10, /* 10ms 轮询 */ };逻辑说明bEndpointAddress的 bit7 表示方向0x82是 IN0x02是 OUT。参数说明wMaxPacketSize对 interrupt 端点最大 64 字节全速或 1024 字节高速MTK 的 preloader 通常跑全速用 64。bInterval是轮询间隔10ms 对控制通道够用再小会占 CPU。6.4 验证自定义协议是否生效改完端点后用usbmon抓包确认 interrupt 端点有没有数据。# 抓 interrupt 端点的包 tshark -r mtk_vcom.pcap -Y usb.endpoint_address 0x82 -T fields \ -e usb.endpoint_address -e usb.data_len -e usb.capdata逻辑说明usb.endpoint_address 0x82过滤出 interrupt IN 端点的包usb.capdata是实际数据。参数说明如果抓不到包检查设备描述符里有没有正确上报这个端点MTK 的 preloader 默认不暴露 interrupt 端点需要改 preloader 配置这一步风险高改错了设备会变砖建议只在 DA 阶段做自定义协议。我自己的习惯是每次改完 PID 表或端点配置先用一台报废的 MTK 设备试确认能进 preloader 再上产线。血泪经验是MTK 的 preloader 窗口太短驱动加载慢 200ms 就错过所以URB_TIMEOUT和POLL_INTERVAL这两个参数我从来不敢用默认值。希望帮到你。本文还有配套的精品资源点击获取