简介为业余无线电爱好者和 MMDVM 玩家整理的 Nextion 串口屏操作指南重点解决驱动安装失败、刷中文固件后显示不全等问题。资源是一份 PDF 文档共 1 个文件包体约 1.51MB篇幅精简但结构完整。文档从 Pi-Star 恢复出厂设置、选择双工/单工模式、Nextion 端口配置到 SSH 执行安装命令均逐步说明并针对国内网络提供 Gitee 镜像代码避开 GitHub 超时问题中文固件部分详解 FAT32 格式化、TFT 文件放置、屏幕卡槽插拔及自动刷写流程以出现“SUcceed”提示作为成功判断。同时还补充了通讯录手动更新和常见故障排查经验既适合初次刷屏的新手也方便老手对照排错。目前已有 1616 人浏览学习是一份实用性较强的实操型参考。1. 先分清“驱动”和“固件”这两个坑买过二手 Nextion 串口屏的人很容易被同一个问题卡住USB 线插上电脑没看到 U 盘图标设备管理器里全是感叹号于是怀疑屏幕坏了。实际上 Nextion 这块屏走的是串口协议板上的 USB 转串口芯片决定你要装什么驱动而“刷固件”解决的是屏幕内部系统、页面工程和 HMI 逻辑的问题靠的是 TF 卡或串口下载两者完全不是一回事。这篇文章把“驱动装对、固件刷对、验证生效”这条链路拆开讲覆盖 Windows 和 Linux 两种环境适合正在做嵌入式 HMI 开发、维修串口屏、或者第一次用 Nextion 调试项目的工程师。搞懂这两个坑之间的边界后面所有操作都不会再对着错误的目标使劲。2. 驱动安装前先确认串口芯片别一上来就装 CH3402.1 看一眼芯片丝印和 VID/PID确定该装哪个 USB 转串口驱动Nextion 屏幕出厂时板上那颗 USB 转串口芯片并不统一。老一点的主控板上常见 CH340G 或 CH340C部分高配板子和第三方兼容屏用 CP2102也有一批用的是 FT232RL。很多人一搜“驱动安装”就下载 CH340 驱动插上没反应就继续点“安装”结果装上的是一个和硬件对不上的驱动。这属于典型的先射箭后画靶。最稳的做法是三步确认硬件身份。先看 PCB 背面靠近 USB 座的位置丝印上直接印着芯片型号这是最省事的判断方式。要是板子装在机箱里不方便拆就看设备管理器里这个未知设备在 USB 设备列表里显示的 VID/PID。把 VID/PID 抄下来对照芯片型号VID:PID常见Windows 下设备管理器显示名Linux 内核模块CH340 / CH3411a86:7523USB-SERIAL CH340ch341CP2102 / CP210x10c4:ea60Silicon Labs CP210x USB to UART Bridgecp210xFT232R / FT232RL0403:6001USB Serial Port (COMx)ftdi_sio这一步确认完再去找对应驱动基本不会装错。里面的细节在于同一颗 CH340 芯片在 Windows 11 和 Windows 7 下走的安装路径不一样Win7 下旧版 ch341ser 驱动还经常报“驱动预安装成功”但设备还是黄色感叹号。遇到这种情况我一般建议先卸载当前驱动重启之后用 Windows 自带的“更新驱动程序”功能手动指向驱动包目录。不要用第三方驱动管理软件批量装这些工具经常会把你机器上其他串口芯片的驱动也一起换掉一换就把 CP210x 和 CH340 搞混。2.2 Windows 下装完驱动后怎么确认串口真的通了驱动安装完成不代表串口可用很多人卡在“驱动安装教程看了三遍设备管理器里还是没出现 COM 口”。装完驱动以后第一件事是拔掉 USB 线重插一次让系统重新枚举设备。在 Win10/Win11 上这一步通常会在右下角弹出“设备已就绪”的提示但弹了提示也不一定稳定还是自己动手去设备管理器里看一眼靠谱。Get-PnpDevice -Class Ports | Select-Object Status, FriendlyName这条 PowerShell 命令能直接列出当前系统里所有端口的枚举状态和友好名称。如果这里看到类似 “USB-SERIAL CH340 (COM3)” 的条目说明驱动加载成功。只有 FriendlyName 没有 Status或者 Status 显示 Unknown说明驱动没加载成功需要回到 2.1 的对照表重新核对芯片型号。这里有个隐藏得很深的坑有些主板上同时插着 USB 蓝牙、调试器、ST-Link 仿真器多个设备它们也会被枚举成 COM 口。你看着 COM3 以为就是屏幕结果用工具打开串口发指令全是对着空气打。所以要确认一下 FriendlyName 里的芯片名前缀看到 CH340、CP210x 或 USB Serial Port 才是屏幕上那颗串口芯片。J-Link 的 CDC 口、ST-Link 的虚拟串口名称都不一样别认错。2.3 Linux 下不装驱动也能用先看 dmesg、lsusb 和用户组Linux 下很多 Nextion 用户根本没意识到自己跳过了“驱动安装”这一步因为内核自带的 ch341、cp210x 模块在插上 USB 的瞬间就自动加载了。这不代表你什么都不用做。实际开发里遇到最多的是两个问题一个是没有权限打开 /dev/ttyUSB0另一个是设备被 ModemManager 抢走。lsusb | grep -i 1a86\|10c4\|0403 dmesg | tail -n 20 sudo usermod -aG dialout $USERlsusb 用来确认系统枚举到了这颗 USB 转串口芯片1a86 是 CH340 的 vendor ID10c4 是 CP210x 的0403 是 FTDI 的。如果 lsusb 能看到设备但 dmesg 里没有 “ch341-uart converter now attached to ttyUSB0” 这类输出说明内核模块没自动加载多半是内核把模块编成了模块但没被 alias 匹配上。最后一条 usermod 是把当前用户加进 dialout 组加完以后必须重新登录或重启会话否则照样报 Permission denied。驱动安装失败时不要盯着设备管理器傻看。Linux 下看内核日志能直接定位到问题插上屏幕的瞬间执行 dmesg看有没有 USB 枚举错误。这跟我处理 Ubuntu 下安装显卡驱动后黑屏的思路一致都是先看日志再动手改配置而不是凭感觉反复重装。很多设备在 Linux 下装不上驱动第一反应是驱动包有问题实际是内核模块的 blacklist 把芯片驱动屏蔽了这类问题查 dmesg 比换驱动版本快得多。3. 刷固件前必须改好的三样东西文件格式、文件名和卡容量3.1 .tft 固件从哪来Nextion Editor 里怎么生成刷固件的第一步不是找一根好用的 USB 线而是先搞明白你要往屏幕里写的是什么文件。Nextion 屏幕能识别的固件文件是 .tft 格式这个文件里打包了系统固件和你的页面工程是一个完整的镜像。常见的获取方式有三种第一种是从官方渠道下载对应型号的固件包这类固件通常是用 Nextion Editor 里内置的固件管理功能直接拉取第二种是买屏幕时卖家提供的资料包里面一般放着一个或多个按型号命名的 tft 文件第三种是自己用 Nextion Editor 生成——新建工程时选对屏幕型号拖几个控件进去排版调好然后在菜单里点编译工程文件夹下就会生成一个 tft 文件。需要特别注意的是编译生成的 tft 文件大小通常和屏幕 flash 容量有对应关系。比如 16MB flash 的屏幕生成出来的 tft 文件不会超过这个容量上限如果编译产物明显偏大或者偏小先回工程里检查有没有误加了超大分辨率的图片。另一个容易犯的错是拿别的型号的 tft 硬刷。分辨率不同、flash 容量不同、Even 版本和 Intelligent 版本的协议栈也不一样硬刷进去最常见的表现是开机白屏、花屏或者一直处于升级循环。刷固件前先确认你手里这个屏幕的完整型号NX、X、N 系列的前缀不一样固件不通用。3.2 TF 卡刷机的最小步骤和命名规则SD 卡刷机是 Nextion 最可靠、也最适合批量生产的刷机方式。驱动可以反复装错串口刷机可能中断SD 卡只要卡和文件名没问题几乎不会翻车。准备一张 TF 卡容量控制在 16GB 以内8GB 最稳妥一张 4GB 的旧卡反而比 32GB 的新卡成功率高。sudo mkfs.vfat -F 32 -n NEXTION /dev/sdb1这条命令在 Linux 下把 SD 卡格式化成 FAT32卷标命名为 NEXTION。注意这里写的是 /dev/sdb1实际操作前务必确认你的读卡器对应的是哪个设备节点用 fdisk -l 看一眼容量再做决定把盘符写错格式化掉硬盘这种事并不少见。格式化完成之后把要刷的 tft 文件复制到 SD 卡根目录。这里必须强调一个规则文件名不能随便起绝大多数 Nextion 屏幕对 SD 卡里的固件文件名有严格要求前缀必须对应屏幕型号后缀必须是 .tft。网上有些固件包的文件名带日期、带版本号或者被二次压缩成 rar这类文件直接往 SD 卡里丢是无效的屏幕根本不认。我会先把文件名改成和屏幕型号严格匹配的格式再刷例如把固件包里的原文件名对着屏幕背面丝印上的型号改好这个看似不起眼的步骤解决掉的“刷不进去”问题比任何其他原因都多。刷机动作本身很简单屏幕完全断电插入 SD 卡重新上电。屏幕会先进入升级状态具体表现因型号而异有的是屏幕边框闪一下有的是屏幕短暂黑屏。整个升级过程一般持续十几秒到半分钟等到屏幕重新显示画面或者进入你放进去的页面工程就算刷完了。升级过程中不要拔电、不要碰 SD 卡。3.3 刷完没反应时的两种“正常”现象与回退方案刷机没反应不代表刷失败了。第一次刷 Nextion 的人经常被两个现象吓到一个是上电后屏幕亮了一下又黑了另一个是屏幕直接显示蓝屏或花屏不动。第一种情况很可能是屏幕上电后自动进入升级流程升级过程中主控板把显示输出切到了内部状态所以画面短暂消失升级完成后会自动跳转显示新页面。这时候耐心等二十秒比反复断电更靠谱。第二种情况更像是固件版本和屏幕型号不匹配尤其是用高分辨率固件刷了低分辨率屏幕或者反过来。这时候先别急着判断屏幕坏了用前面 2.1 的方法确认屏幕的芯片型号和 flash 容量去换一个完全匹配的固件文件。如果遇到 SD 卡完全不被识别的情况排查顺序是卡是不是 FAT32 格式卡容量是不是超过限制tft 文件是不是放在根目录且文件名正确。我自己踩过的坑是拿了一张 exFAT 格式的卡测试Windows 下看文件都能读但屏幕完全不进升级流程格式化回 FAT32 之后一次通过。适配器也很关键有些读卡器在写入时会产生坏块导致屏幕读文件读到一半中断换一张卡或者换一台读卡器能排除这个干扰。4. 串口刷固件与线刷失败恢复接线顺序比波特率更容易错4.1 什么时候走串口刷机什么时候必须用 SD 卡串口刷机在很多情况下确实更方便不需要读卡器不用关机拆 SD 卡开发时反复调整页面工程可以直接从 Nextion Editor 里点击上传。但需要明确一个边界Editor 的上传功能是把页面工程写到屏幕的 flash 里属于日常开发用的下载方式。真正意义上的刷固件也就是覆盖系统镜像的部分多数情况下仍然建议通过 SD 卡完成。串口刷机最典型的应用场景是屏幕处于半砖状态SD 卡槽又刚好失效或者采购回来的屏幕连一次 SD 卡刷机都没有执行过需要先在裸机上把整套系统烧进去。这时候屏幕的串口是最底层的通路只要 UART 引脚没烧救回来的概率就很大。4.2 接线顺序RX 接 TX、TX 接 RX共地之后再看波特率接线这一关说难不难但出错率极高。USB 转 TTL 模块上一般都会标注 TX 和 RXNextion 屏幕上的串口引脚也会标注。很多人的第一反应是 TX 接 TX、RX 接 RX这就是最常见的接法错误。串口通信是交叉连接你的发送脚要接到对方的接收脚也就是 USB 转串口模块的 TX 接屏幕的 RX模块的 RX 接屏幕的 TX最后把两边的 GND 接在一起。USB 转 TTL 模块Nextion 屏幕说明TXRX模块发送屏幕接收RXTX模块接收屏幕发送GNDGND必须先共地否则信号电平乱跳电平问题也是个隐性雷区。Nextion 的串口是 3.3V/5V TTL 电平不是 RS232 电平所以不能直接把屏幕接到电脑的 DB9 串口上。使用 USB 转串口模块时优先选 3.3V 供电的模块。用 5V 供电的模块接线也能跑但长时间带电工作时信号线上容易出毛刺插拔瞬间还会出现电压倒灌。波特率方面Nextion 屏幕和 Editor 之间默认是 9600 波特率但很多项目会在页面工程里自定义成 115200。如果屏幕是出厂状态用 9600如果是自己刷过或者二手淘来的屏幕最好先确认工程里设置的波特率否则 Editor 会一直提示连接超时。这个“先查接线再查波特率”的顺序能排掉至少一半的串口连接问题。4.3 Linux 串口刷机前先治 ModemManagerWindows 下串口刷机的坑大多集中在驱动和 COM 号Linux 下则多一个特有的干扰源ModemManager。这个系统服务会把新插入的 /dev/ttyUSB0 设备当成潜在的 3G/4G 上网卡主动往里面发 AT 指令探测。结果就是你的串口下载工具刚打开端口ModemManager 也同时打开两个进程互相抢数据下载到一半必然失败。systemctl stop ModemManager sudo systemctl mask ModemManagersystemctl stop 是临时停止服务mask 是把它彻底屏蔽掉防止下次开机或拔插 USB 时自动拉起。在嵌入式 Linux 开发机上我一般直接 mask反正这台机器也不需要模拟上网卡。屏蔽之后重新插拔一次 USB 转串口模块让端口重新枚举干净。验证串口是否真的归你用了可以这样做stty -F /dev/ttyUSB0 9600 raw -echo cat /dev/ttyUSB0 第一条命令把串口设置为 9600 波特率、原始模式第二条命令后台挂起一个读取进程。如果给屏幕上电或发送数据时终端里有输出说明通路是通的。这里的 raw 参数很关键不加的话终端会对输入输出做行缓冲处理看到的数据会怪怪的。cat 挂后台也不影响 Editor 打开同一个串口Linux 允许一个端口多进程打开但操作时还是建议把测试进程先关掉再连 Editor否则两边同时收发数据容易乱。4.4 刷到一半失败变砖怎么把屏救回来串口刷机失败最直接的后果是屏幕停在升级模式里开机一直闪或者完全没有画面。这里有个很容易误判的点屏幕没有画面不等于硬件烧了很多时候只是系统镜像写到一半断了bootloader 还好好的。恢复手段按优先级排先试 SD 卡刷机这是最干净的方式只要卡、文件名、格式对插卡上电就能覆盖损坏的镜像。如果 SD 卡刷不了再回到串口用 Editor 重新上传工程。断开一切自动打开串口的软件只留 Editor 一个进程把波特率降到能和屏幕通信的速度重试。最后一个手段是用 USB 转 TTL 模块直接连屏幕的串口引脚配合 Editor 强制进入系统的烧录模式这个模式下不依赖 SD 卡只要 UART 和供电正常就能把系统从头写一遍。整个过程如果还是失败才需要考虑主控损坏的可能。5. 验证与固化固定 COM 号、核对固件版本、批量克隆5.1 把设备管理器里的 COM 号固定下来驱动装好之后COM 号每次插拔都可能漂移。今天插上识别成 COM3明天变成 COM7Editor 里的端口配置跟着乱脚本里的串口号也要反复改。固定 COM 号的办法在 Windows 设备管理器里就能做端口 (COM 和 LPT) 下面找到对应的 COM 口右键进入属性切到“端口设置”选项卡点“高级”把右下角的 COM 端口号改为一个靠后的空闲编号比如 COM9。改完之后这个 USB 转串口芯片会一直固定在这个编号上不会再因为系统枚举顺序变化而漂移。这里有一个细节COM10 以上的端口号在某些老旧的串口调试工具里会识别异常建议还是选在 COM3 到 COM9 之间避开系统保留的 COM1 和 COM2。固定完要重新插拔一次 USB 线让配置生效。5.2 刷新后先查三样COM、波特率和 tft 文件名刷完固件后立即验证不要等设备装进机箱里再后悔。我的验证顺序是固定三查一看设备管理器里 COM 号是否稳定二看 Editor 连接时设置的波特率跟工程里是否一致三看 SD 卡里 tft 文件的命名和容量是否和屏幕型号匹配。这三样里任何一样出问题刷机失败的表现都极其相似都是屏幕没反应。还有一个容易被忽略的检查项是工程文件本身的版本。Nextion Editor 工程文件在编译时会把版本信息写进 tft 镜像里刷完以后用 Editor 重新连接屏幕可以在设备信息页看到当前的固件版本和工程版本。如果发现屏幕上跑的版本号和工程文件里的对不上先回到 3.2 检查命名规则而不是怀疑刷机动作没执行。5.3 sys0 显示版本号验证固件是否真正生效验证刷机是否成功最直观的办法是让屏幕自己告诉你版本号。Nextion 的系统变量里有一个只读变量 sys0保存着当前固件版本。在页面工程里放一个文本控件把它的 val 或者 txt 属性绑定到 sys0 上编译烧录后开机就能显示当前固件的版本字符串。这个方案和系统自带的版本查询相比更直观尤其适合批量生产时要快速确认每块屏幕固件版本是否一致的场景。批量克隆也是常见需求。先在一台调试好的屏幕上完成全部刷机、参数配置和页面工程上传然后从这台“母机”上导出固件配置备份再通过 SD 卡批量刷入其他屏幕。这种方法比逐个屏幕用 Editor 连接稳定得多速度也快。批量刷的时候记得每刷完一台就核对一下设备管理器里的 COM 号有没有被占用串口被其它程序抢走时Editor 会报一个模糊的连接超时问题其实不出在屏幕上。如果下次你还遇到刷完就黑屏的情况先把这一节里说的 COM 号和波特率重新看一遍——大多数情况下问题都出在这两个不起眼的设置上。本文还有配套的精品资源点击获取
