OpenWrt路由器如何添加USB转串口功能以HLK_MTK7628n为例最近在折腾一个智能家居的本地控制中枢手头正好有一台闲置的HLK-MT7628n开发板。我发现很多传感器和控制器还是依赖古老的串口通信而这块开发板本身并没有引出串口引脚。于是一个想法冒了出来能不能给它加个“外挂”通过USB口扩展出串口功能呢这不仅仅是给路由器增加一个调试接口更是打开了一扇门让OpenWrt这个强大的网络系统能够直接与下位机硬件“对话”无论是读取温湿度传感器的数据还是控制一个步进电机都变得触手可及。对于热衷于网络设备DIY、智能家居深度定制或是从事小型工业控制项目的朋友来说掌握这项技能意味着能将路由器的边界从网络层拓展到物理层实现真正的“软硬一体”。今天我就以手头的HLK-MT7628n为例把从硬件选型、内核驱动配置到固件编译测试的全过程掰开揉碎了分享给大家。1. 硬件准备与芯片选型找到合适的“翻译官”要给路由器添加USB转串口功能核心是需要一个“翻译官”——USB转串口芯片。它负责将USB协议的数据流“翻译”成TTL电平的串行数据反之亦然。市面上常见的芯片型号不少选择哪一款直接关系到后续驱动的兼容性和系统的稳定性。首先我们需要确认路由器的硬件基础。以HLK-MT7628n为例它搭载了联发科MT7628AN方案其一大优势是集成了一个原生的USB 2.0 Host接口。这意味着我们无需额外的USB控制器可以直接将转接板插上。在动手焊接或连接之前请务必用万用表或查阅原理图确认这个USB口的5V电源和D、D-数据线是否已经正确引出到开发板的接口上。接下来就是芯片选型。不同的芯片在Linux内核中的驱动支持成熟度、功耗以及价格上各有差异。下面这个表格对比了几款最常见的型号你可以根据自己的需求和手头资源来决定。芯片型号驱动内核支持主要特点注意事项CH340G极好内核原生自带成本极低应用广泛稳定性经过大量验证。市面上版本混杂需注意购买正品。PL2303好但需区分版本老牌芯片历史久。特别注意PL2303HX新版和PL2303SA旧版驱动不同旧版驱动已从内核移除购买时需确认。CP2102/CP2104优秀内核原生自带由Silicon Labs生产稳定性高常用于工业领域。价格相对稍高但通常物有所值。FT232RL优秀内核原生自带性能强大功能丰富如可编程常用于专业设备。价格是CH340的数倍对于简单应用可能性能过剩。提示对于OpenWrt这类嵌入式系统优先选择内核原生支持的芯片可以省去大量编译额外驱动模块的麻烦强烈推荐CH340或CP2102作为入门首选。我这次演示用的就是一块CP2102模块。硬件连接非常简单将USB转串口模块通常是一个小PCB板的USB公头直接插入HLK-MT7628n的USB母座。模块的另一端会引出VCC3.3V/5V、GND、TXD、RXD四根线。这里有一个关键点路由器的串口逻辑电平通常是3.3V请确保你的模块输出电平也是3.3V或者至少是兼容3.3V的5V TTL电平直接接入可能损坏CPU。连接时模块的TXD应接路由器的RXD模块的RXD接路由器的TXD即交叉连接。2. 搭建OpenWrt编译环境打造专属固件的“厨房”要想让路由器系统识别并驱动我们的USB转串口芯片最根本的方法是在编译OpenWrt固件时就将对应的驱动模块“烹饪”进去。这需要我们搭建一个编译环境你可以把它理解为一个专门制作路由器固件的“厨房”。我选择在Ubuntu 22.04 LTS系统上进行操作其他Linux发行版步骤类似。首先我们需要安装一系列编译所需的工具和库。打开终端执行以下命令sudo apt update sudo apt install build-essential ccache ecj fastjar file g gawk \ gettext git java-propose-classpath libelf-dev libncurses5-dev \ libncursesw5-dev libssl-dev python3 python3-distutils python3-setuptools \ python3-dev rsync subversion swig time unzip wget zlib1g-dev这个过程会下载安装几百兆的软件包请保持网络通畅。完成后我们就可以获取OpenWrt的源代码了。OpenWrt有多个分支master分支是最新的开发版22.03.x是当前的稳定版。为了获得较好的硬件支持我选择使用官方master分支的代码。git clone https://git.openwrt.org/openwrt/openwrt.git cd openwrt ./scripts/feeds update -a ./scripts/feeds install -afeeds是OpenWrt的软件包管理系统update和install操作会拉取并准备所有可选的软件包定义这样我们才能在后续的菜单配置中找到它们。接下来是关键的一步配置编译目标。HLK-MT7628n使用的MT7628AN芯片在OpenWrt中归属于ramips架构下的mt76x8子目标。我们通过make menuconfig命令进入图形化配置界面。make menuconfig这个界面是经典的ncurses风格使用方向键和回车进行选择。我们需要依次定位并设置以下选项Target System-MediaTek Ralink MIPSSubtarget-MT76x8 based boardsTarget Profile- 选择HLK-7628N或者你手头开发板对应的型号3. 内核与软件配置勾选正确的“食材”配置好目标硬件后我们就要开始为固件添加USB转串口功能所需的“食材”——内核驱动和用户空间工具。这依然在make menuconfig界面中完成。首先确保USB支持已经打开。这是所有USB设备工作的基础。进入Kernel modules-USB Support确保以下模块被选中标为*表示编译进内核M表示编译为模块kmod-usb-core(USB核心支持通常已内置)kmod-usb2(USB 2.0控制器驱动对于MT7628的USB Host是必须的)kmod-usb-ohci(可选兼容旧的USB1.1设备建议选上)kmod-usb-serial(USB转串口的核心驱动模块)接下来根据你选择的芯片型号在kmod-usb-serial的子目录下选择具体的转换芯片驱动对于CH340选择kmod-usb-serial-ch341对于CP2102选择kmod-usb-serial-cp210x对于PL2303选择kmod-usb-serial-pl2303对于FTDI选择kmod-usb-serial-ftdi注意建议将这些驱动编译为模块 (M)而不是直接内置 (*)。这样生成的.ko文件可以独立加载和卸载调试起来更灵活也节省内核核心空间。仅有内核驱动还不够我们还需要在用户空间与串口交互的工具。回到make menuconfig主菜单进入Utilities-Terminal这里有几个常用的串口工具可选minicom 老牌、功能强大的串口终端程序类似于Windows下的SecureCRT。picocom 一个轻量级、简单的串口终端非常适合资源受限的嵌入式环境。screen 一个多窗口终端管理器也可以用来连接串口用法是screen /dev/ttyUSB0 115200。我通常会把picocom和screen都选上它们体积小足够应付大部分调试场景。配置完成后按右方向键选择Save保存配置然后退出。4. 编译固件与系统烧录从代码到实体配置保存后我们就可以开始编译了。这个过程比较耗时取决于你的电脑CPU性能首次编译可能需要一两个小时。在编译前可以下载一些必要的依赖make download -j$(nproc)-j$(nproc)参数表示使用与CPU核心数相同的线程数并行下载以加快速度。下载完成后开始编译make -j$(nproc) Vs-j$(nproc)同样是并行编译。Vs参数表示输出详细的编译信息如果出错可以从中看到具体的错误原因。如果一切顺利你将在编译完成后在bin/targets/ramips/mt76x8/目录下找到编译好的固件文件通常命名为openwrt-ramips-mt76x8-hlk_7628n-squashfs-sysupgrade.bin。接下来是烧录固件到HLK-MT7628n开发板。烧录方法取决于你的开发板当前状态如果开发板已有OpenWrt系统可以直接通过LuCI网页界面系统-备份/升级或使用sysupgrade命令进行刷写。如果开发板是空白或原厂系统可能需要通过串口如果原有调试串口可用或者编程器进行烧录。HLK-7628n通常可以通过上电时按住某个按键进入U-Boot的Web恢复模式然后通过浏览器上传固件。烧录过程有风险请务必确认固件型号与硬件完全匹配并保证供电稳定。刷机完成后路由器会重启进入新的OpenWrt系统。5. 功能测试与实战应用让串口“活”起来新系统启动后通过SSH登录路由器。首先我们插入准备好的USB转串口模块。然后使用lsusb命令查看USB设备列表这是验证硬件连接和内核底层识别是否成功的第一步。rootOpenWrt:~# lsusb Bus 001 Device 002: ID 10c4:ea60 Silicon Labs CP2102 UART Bridge Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub看到类似上面的输出ID10c4:ea60对应CP2102说明USB设备已经被系统识别。接下来检查对应的串口设备文件是否生成rootOpenWrt:~# ls -l /dev/ttyUSB* crw-rw---- 1 root root 188, 0 May 10 14:30 /dev/ttyUSB0如果出现了/dev/ttyUSB0或多个恭喜你驱动加载成功有时候驱动可能没有自动加载我们可以手动加载模块并查看内核日志rootOpenWrt:~# insmod usbserial rootOpenWrt:~# insmod cp210x # 如果是CH340则加载 ch341 rootOpenWrt:~# dmesg | tail -20 [ 123.456789] usbcore: registered new interface driver cp210x [ 123.465432] cp210x 1-1.1:1.0: cp210x converter detected [ 123.471234] usb 1-1.1: cp210x converter now attached to ttyUSB0现在我们可以使用之前编译进系统的终端工具来测试串口通信了。假设我们要连接一个波特率为115200的传感器使用 picocomrootOpenWrt:~# picocom -b 115200 /dev/ttyUSB0 picocom v3.1 port is : /dev/ttyUSB0 flowcontrol : none baudrate is : 115200 parity is : none databits are : 8 stopbits are : 1 escape is : C-a local echo is : no noinit is : no noreset is : no hangup is : no nolock is : no send_cmd is : sz -vv receive_cmd is: rz -vv -E imap is : omap is : emap is : crcrlf,delbs, logfile is : none initstring : none exit_after : not set exit is : no Type [C-a] [C-h] to see available commands Terminal ready按CtrlA再按CtrlQ即可退出picocom。使用 screenrootOpenWrt:~# screen /dev/ttyUSB0 115200要退出screen按CtrlA然后输入:进入命令模式再输入quit回车。为了更稳定地使用我们可以设置串口参数比如固定设备节点名。通过创建udev规则可以实现vi /etc/udev/rules.d/99-usb-serial.rules加入以下内容以CP2102为例通过USB的厂商ID和产品ID来匹配SUBSYSTEMtty, ATTRS{idVendor}10c4, ATTRS{idProduct}ea60, SYMLINKttySensor, MODE0666保存后重新插入设备你就会发现多了一个固定的符号链接/dev/ttySensor并且权限设置为所有用户可读写。6. 进阶集成与自动化从调试到系统服务基础通信测试通过后我们可以将这个串口深度集成到OpenWrt系统中实现自动化数据采集或控制。一个典型的场景是连接一个Modbus RTU协议的温湿度传感器并让OpenWrt定期读取数据通过MQTT发布到家庭自动化服务器如Home Assistant。首先安装必要的软件包。OpenWrt强大的包管理器opkg使得这一切变得简单。opkg update opkg install mosquitto-client-nossl # MQTT客户端 opkg install collectd-mod-serial # Collectd的串口插件用于数据采集 opkg install collectd-mod-mqtt # Collectd的MQTT输出插件然后配置Collectd来读取串口数据。假设我们的传感器接到串口后发送简单的文本格式数据如Temp:25.6,Humi:60。我们可以编写一个简单的Shell脚本通过串口发送查询指令并解析回复#!/bin/sh # /usr/bin/read_sensor.sh DEVICE/dev/ttySensor BAUD9600 # 发送查询命令示例具体命令需参考传感器手册 echo -en \x01\x03\x00\x00\x00\x02\xC4\x0B $DEVICE sleep 0.1 # 读取回复并解析 RESPONSE$(dd if$DEVICE bs1 count9 2/dev/null | hexdump -v -e /1 %02X ) # 这里简化处理实际应进行CRC校验和值解析 TEMP$((0x${RESPONSE:12:2}${RESPONSE:15:2})) echo temperature value_raw$TEMP接着在Collectd配置中调用这个脚本# vi /etc/collectd.conf LoadPlugin exec Plugin exec Exec nobody:users /usr/bin/read_sensor.sh /Plugin LoadPlugin network Plugin network Server 192.168.1.100 1883 SecurityLevel None Username openwrt Password your_password /Server /Plugin最后配置MQTT发布。我们可以直接使用mosquitto_pub命令结合cron定时任务# 编辑cron任务 crontab -e # 添加一行每分钟执行一次 * * * * * /usr/bin/read_sensor.sh | while read line; do mosquitto_pub -h 192.168.1.100 -t home/sensor/temperature -m $line; done通过这样的集成原本只是一个网络路由器的HLK-MT7628n就变身成为一个具备边缘计算能力的物联网关能够主动采集物理世界的数据并融入智能网络。你还可以发挥想象连接继电器模块控制家电连接GPS模块获取位置信息或者作为工业现场总线如RS485到TCP/IP网络的桥梁。