我第一次拿树莓派接GPS模块时被串口折腾了一整晚。GPS模块明明搜到星了代码也照着教程抄了串口就是不出数据。来回查了很久才意识到一个反直觉的事实在树莓派上/dev/ttyAMA0这个看起来根正苗红的串口设备名在不少型号上根本不是 GPIO 14/15 引出来的那个物理串口。树莓派的串口体系确实比普通开发板多了一层坑。这篇就把树莓派各串口一次盘清楚适合刚入手树莓派、准备接传感器或单片机做联调的读者也适合被 GPIO 串口乱码、Permission denied、蓝牙占用设备名折磨已久的朋友。1. 树莓派的串口不是只有 GPIO 那个先从“三种串口”说起很多教程提到树莓派串口默认就指向 40 pin 排针上的 TXD/RXD 两个引脚。但真正用起来就会发现树莓派的串口至少有三类物理引脚上的原生 UART、被蓝牙模块占用的那一路 UART、以及通过 USB 口扩展出来的虚拟串口。这三类串口在设备名、配置方式、稳定性上完全是不同世界的东西不先分清它们后面所有排查都像无头苍蝇。1.1 GPIO 14/15 上的原生串口树莓派自己的 UART40 pin 排针上的物理串口是最常用的物理引脚 8 是 TXD对应 GPIO 14物理引脚 10 是 RXD对应 GPIO 15地线随便接一个 GND 引脚就行。这里说的“原生”指的是它直接由树莓派主芯片内部的 UART 外设驱动不经过 USB 协议转换延迟低、可配置性强。需要注意的是这个物理串口默认不一定是启用的。树莓派官方系统为了省电和避免蓝牙冲突早期经常把enable_uart默认关掉。你如果直接打开终端去读写/dev/ttyAMA0或/dev/ttyS0有可能发现设备节点都找不到或者打开后收不到任何数据。第一次接触树莓派串口的人最容易在这一步被卡住。这个引脚串口的电平是 3.3V不是 5V。这一点会在后面专门展开讲但先记住把它当成和 Arduino 的 5V UART 直接对接轻则乱码重则烧引脚。树莓派的 UART 对外只认 3.3V 逻辑电平规格上就是这么设计的。1.2 蓝牙背后的 PL011为什么它也算“串口”树莓派从 3 代开始集成了蓝牙。蓝牙模块和主芯片之间走的是什么通道本质上就是一路 UART。这就产生了一个很有意思的资源争夺芯片里的 PL011 UART 只有那么一两个给了蓝牙GPIO 引脚上的串口就只能用功能阉割的 mini UART不给蓝牙GPIO 串口才能拿到完整硬件能力。所以“树莓派有几路串口”这个问题的标准答案不是“一路”而是“从芯片层面看有至少两路 UART但默认分配很微妙”。蓝牙占用的那一路你平时看不到数据但它确确实实占着设备名占着中断资源也占着芯片内部的串口外设。这也是为什么很多老教程会告诉你去raspi-config或/boot/config.txt里“禁用蓝牙换个稳定串口”——本质就是让蓝牙把占着的好 UART 吐出来。1.3 通过 USB 接入的“虚拟串口”另一个世界第三类串口不占用 GPIO也不占用芯片原生 UART 资源插一个 USB 转串口模块系统识别后会在/dev下生成ttyUSB0或ttyACM0这样的设备节点。它本质上是把 USB 协议转换成串口信号的“桥”驱动层由内核的usb-serial或cdc_acm处理。这类串口的好处是即插即用不需要改enable_uart不需要管蓝牙占用也不需要关心 GPIO 电平转换。它甚至可以是 5V 逻辑电平多数成品 USB 转串口线自带电平转换输出可以是 5V/3.3V 可跳线因为两端之间隔着一块桥接芯片树莓派 GPIO 并不会直接暴露给外部设备。新手分辨这三类串口最直观的办法就是看设备名和触发条件ttyAMA0、ttyS0属于原生 UART跟蓝牙、GPIO 硬件映射强相关ttyUSB0、ttyACM0属于 USB 虚拟串口插上 USB 就出现。搞清楚这个你就可以跳过“为什么我的ttyAMA0不工作”这类问题了。2. 为什么 ttyAMA0 经常“名不副实”PL011、mini UART 与设备名分配树莓派串口最让人头疼的地方不是硬件难接而是设备名分配反直觉。同样是 GPIO 14/15 引出的串口在树莓派 1、2、3、4、5 上的设备名可能完全不同。要理解这件事必须知道芯片内部的两个 UART 外设分别是谁它们各自有什么脾气。2.1 PL011 与 mini UART稳定性的分水岭树莓派主芯片内部主要有两个 UART 外设一个是 ARM 标准的 PL011一个是 Broadcom 自己设计的 mini UART。它们之间的差别不是“谁新谁旧”而是“谁功能完整、谁便宜够用”。特性PL011mini UART硬件 FIFO完整收发均有较深 FIFO很浅容易丢数据DMA 支持支持不支持硬件流控 RTS/CTS支持支持但不完整波特率来源独立 UART 时钟不随 CPU 频率变化由核心时钟派生会随 CPU 变频漂移规格稳定性高低高负载下容易乱码PL011 是 ARM 官方 IP稳定、独立时钟、支持 DMA适合做正经的串口通信。mini UART 则是 Broadcom 为了省成本和功耗搞的简化版最关键的问题是它的波特率由 GPU/CPU 核心时钟派生CPU 在省电模式和性能模式之间切换时波特率会跟着抖。你在树莓派 4B 上满负载跑程序同时用 GPIO 串口收 GPS 数据数据出现随机乱码很大概率就是 mini UART 在飙车时“压线”了。2.2 serial0/serial1 与设备名的来龙去脉因为有两路 UART树莓派系统启动时会根据设备树给它们分配名字。经典情况是树莓派 1、2 代无蓝牙PL011 分配给 GPIO 串口设备名/dev/ttyAMA0。树莓派 3、4 代有蓝牙PL011 默认分给蓝牙设备名/dev/ttyAMA0GPIO 串口改用 mini UART设备名/dev/ttyS0。于是出现了一个经典陷阱你在树莓派 4B 上按老教程去操作/dev/ttyAMA0读写到的其实是蓝牙那一路而不是你接在 GPIO 14/15 上的传感器。我当年就是因为没意识到这一点对着一个并不存在的“串口”调试了半天。/dev/serial0和/dev/serial1是两个符号链接由系统根据唯一别名自动指向真正可用的串口。其中serial0永远指向 GPIO 14/15 对应的那路串口serial1通常指向蓝牙那一路。所以最稳妥的写法是代码里统一用/dev/serial0不要直接写死ttyAMA0或ttyS0。这样无论板子和系统怎么变你操作的都是物理引脚上那个串口。2.3 用 dtoverlay 拨乱反正disable-bt 与 miniuart-bt既然默认分配不合理官方提供了两种设备树配置来调整。常见做法是在/boot/config.txt或/boot/firmware/config.txt里追加一行。第一种直接禁用蓝牙让 PL011 完全释放dtoverlaydisable-bt这个方案最干净GPIO 串口拿到 PL011波特率稳定支持 DMA硬件流控完整。代价是蓝牙功能没了想用蓝牙键盘、蓝牙音箱就不行了。如果你只是拿树莓派做嵌入式控制蓝牙基本用不上推荐直接走这条路。第二种保留蓝牙但让蓝牙用 mini UARTdtoverlayminiuart-bt这个方案下GPIO 串口拿到 PL011蓝牙改走 mini UART。GPIO 串口稳定了但蓝牙质量会下降毕竟蓝牙的数据流也跟着 CPU 变频走重负载下可能出现音频卡顿或蓝牙键鼠掉线。如果你的项目必须同时用蓝牙和稳定串口这个折中方案可以试但我实测下来蓝牙体验确实不如原版。改完以后重启再用ls -l /dev/serial*看一眼符号链接指向确认serial0指向了你想用的那个 UART。这里还有一个细节如果你用的是带蓝牙的树莓派 3B/4B默认情况下 GPIO 串口是 mini UART并不是说不能用只是建议低速率、低负载、调试场景才可以凑合要做高速通信或接工业级外设还是把 PL011 抢回来更稳。3. 打开并验证一个能用的 GPIO 串口实操从这里开始理论说清楚了开始动真格。这里我以树莓派官方系统为例演示从配置到回环测试的完整链路。整个过程不需要外接任何芯片只需要一根杜邦线。3.1 raspi-config 里的两道选择题树莓派官方系统提供了图形化配置工具直接在终端跑sudo raspi-config进入Interface Options找到Serial Port。它会问两个问题这两个问题是新手最常选错的。第一问通常类似Would you like a login shell to be accessible over serial?是否允许通过串口登录系统。这里要选No。为什么不选 Yes因为如果允许串口登录系统会把串口当成控制台启动日志、登录提示符都会从串口涌出来你外接的外设数据会被淹没根本没法正常通信。第二问通常是Would you like the serial port hardware to be enabled?是否启用串口硬件。这里选Yes。选完以后它会自动往配置里写enable_uart1。如果你不想用菜单也可以手动在/boot/config.txt文件末尾加一行enable_uart1效果一样。重启之后执行ls -l /dev/serial0。如果能看到符号链接就说明 GPIO 串口已经激活。如果看不到先检查/boot/config.txt里的enable_uart1是否生效再看你是不是用了过于精简的第三方系统镜像。3.2 回环测试一根杜邦线确认硬件串口配置好之后不要直接接外设先做一次回环测试确认树莓派自身的收发链路是通的。回环测试的原理非常简单把 TXD 和 RXD 短接让树莓派自己发给自己的数据从 RXD 原路收回来。如果自发自收都成功说明串口硬件、系统驱动、设备节点全都没问题。拿一根母对母杜邦线把树莓派 GPIO 14TXD和 GPIO 15RXD直接连起来再设置好波特率。终端里可以先用stty工具设置stty -F /dev/serial0 115200 raw然后用两个终端窗口一个执行cat /dev/serial0另一个执行echo hello-uart /dev/serial0执行后在第一个终端应该能看到hello-uart被原样打印出来。看到这个输出你的 GPIO 串口就基本确认可以用了。这里有个容易犯的错有些人把 TXD 和 RXD 接反了回环测试时本来应该短接同一个物理引脚的他却把引脚 8 和引脚 10 当成“一发一收”去接外设。回环测试明确要求是TXD 和 RXD 之间直接用杜邦线连接不是把外设接上去。3.3 Python pyserial 读写树莓派串口命令行验证后最终还是要落到代码里。Python 生态里最常用的就是pyserial。安装方式sudo apt install python3-serial或者用 pippip3 install pyserial一个最小可用的收发脚本是这样import serial ser serial.Serial( port/dev/serial0, baudrate115200, timeout1 ) ser.write(bping\r\n) data ser.read(10) print(data) ser.close()如果你已经做了回环短接运行这段代码后应该能打印出bping\r\n之类的字节。如果打印出来是b那就说明读不到数据优先检查回环线是否短接好再检查当前用户是否有权限访问串口。关于timeout参数我建议开发阶段一定设置非零值否则read()在没有数据时会一直阻塞在那里程序看起来就像死掉了。设置成 1 秒让脚本能在没有数据时及时返回方便排查问题。4. 和外设通信时容易翻车的四个细节电平、共地、波特率、权限GPIO 串口能自己收发数据了只是万里长征第一步。真正接外设时新手的翻车率特别高而且翻车姿势高度集中在电平、共地、波特率、权限这几个点。下面挨个拆。4.1 3.3V 不等于 5V树莓派串口不能直连 5V 单片机树莓派 GPIO 的 UART 逻辑电平是 3.3V但很多单片机、传感器模块用的是 5V TTL 电平比如经典 Arduino UNO 的 UART 输出就是 5V。如果你把 Arduino 的 TXD 直接接到树莓派的 RXD5V 高电平会超过树莓派 GPIO 的耐压范围轻则导致接收电平判断异常、乱码重则损伤树莓派 GPIO 引脚甚至整颗 SoC。正确做法是加电平转换。最省事的方案是买一块 4 通道双向电平转换模块常见基于 TXS0108E 或 BSS138 的设计把两边电源分别接 3.3V 和 5V然后 TXD/RXD 各串一路过去。如果你手头没有模块也可以用两个三极管搭一个单向电平转换电路但只适合低速串口而且方向搞反了也会出问题。一句话总结拿树莓派去接任何模块前先查模块的 UART 电平是多少。如果是 3.3V 就直连如果是 5V 就必须加转换别拿“应该没事”赌引脚寿命。4.2 乱码与丢字节先怀疑波特率再查共地和供电串口乱码的第一个嫌疑永远是波特率不匹配。发送方 9600接收方 115200收到的必然是乱码。这在入门阶段能解决 80% 的乱码问题。剩下 20% 就比较隐藏了常见的有两种第一种是没共地。UART 的电平是相对的两边必须有一个共同参考地。如果树莓派的 GND 和传感器模块的 GND 没有连在一起电平参考点漂移数据就会在 0 和 1 之间反复横跳你以为线接对了其实完全是噪声。接任何串口外设第一件事就是把两边 GND 连起来。第二种是 mini UART 的波特率漂移。前面已经说过树莓派 3/4 代默认 GPIO 串口可能用的是 mini UARTCPU 变频时波特率会跟着抖动。表现就是系统刚启动时正常跑了一会儿负载上来串口数据开始间歇性乱码。遇到这种情况别纠结外设先按之前说的dtoverlaydisable-bt把 PL011 释放出来。还有一个冷门但真实的原因劣质杜邦线和接触不良。树莓派 40 pin 排针本身很细杜邦线插久了会氧化接触电阻变大高速串口下就容易丢字节。怀疑到这个点的时候可以换一根短线试试也可以检查引脚是否松动。4.3 串口被登录 shell 占用现象与解法如果你在raspi-config第一问选了 Yes或者用的是某些默认开启串口控制台的镜像你会看到一个经典现象打开串口终端后屏幕上不断滚动系统启动日志甚至出现登录提示符。这时候你去读外设数据读到的全是系统日志没有任何传感器输出而且你的写操作也发不出去。这个问题还容易和“乱码”混淆。如果串口终端上出现的是清晰可读的 Linux 日志那就是控制台占用了如果是一堆乱码才需要考虑波特率和电平问题。解决方法就是回到raspi-config把第一问改成 No然后重启。如果你手动改过/boot/cmdline.txt看到里面有类似consoleserial0,115200的内容把它删掉也能解决但我更推荐用菜单操作避免改错导致系统起不来。4.4 Permission denied让当前用户进入 dialout 组默认情况下普通用户直接打开/dev/ttyAMA0或/dev/ttyS0会报Permission denied。这是因为串口设备节点归属于dialout组普通用户没有写权限。临时方案是加sudo但每次都 sudo 很累而且 Python 脚本以 root 身份运行容易产生文件权限问题。一劳永逸的办法是把当前用户加入dialout组sudo usermod -aG dialout $USER执行完后需要重新登录或者重启一次组权限才会真正生效。验证方式很简单groups输出里出现dialout就说明加入成功了。注意如果你用的不是官方系统而是 Ubuntu用户组名可能也叫dialout命令是一样的。这个细节看着不起眼但几乎每一个初写串口程序的树莓派用户都会撞上一次。5. USB 转串口与 /dev/ttyACM0什么时候放弃 GPIO 串口更聪明GPIO 串口虽然好但不是万能的。很多时候USB 转串口才是更合理的选择。尤其是当你需要多路串口、需要 5V 电平、或者懒得处理蓝牙/引脚映射问题时USB 转串口能帮你省下大把时间。5.1 ttyUSB0 与 ttyACM0 到底差在哪树莓派上插入 USB 串口设备后设备节点一般是ttyUSB0或ttyACM0。这两个名字代表不同的驱动和协议栈。特性ttyUSB0ttyACM0典型芯片CH340、CP2102、FT232STM32 虚拟串口、Arduino Uno 原生 USB、ESP32-C3 USB 串口底层驱动usb-serialcdc_acm协议复杂度较低纯数据流支持更完整的 CDC ACM 控制语义如 DTR 信号常见场景经典 USB 转串口线开发板自带 USB 虚拟串口很多老教程只提ttyUSB0导致一些人插上 STM32 的 USB 虚拟串口后发现设备名是ttyACM0还以为驱动没装好。其实不是没装好是协议类别不同。你只要记住外接 CH340/CP2102 这类成品转接板大概率是ttyUSB0插的是单片机开发板自带的 USB 口大概率是ttyACM0。5.2 用 USB 转串口调试树莓派本身无头调试的最稳路径USB 转串口还有一个不可替代的使用场景调试树莓派本身。当树莓派没有网络、HDMI 画面黑屏、SSH 连不上的时候你还有一条最后的救命通道就是串口控制台。把 USB 转串口线的 TXD 接到树莓派 GPIO 14RXD 接到 GPIO 15GND 共地然后在电脑终端里用minicom或screen连接对应的 USB 串口设备波特率设 115200。树莓派开机时内核日志会从串口输出你甚至可以在串口上登录系统。这个玩法特别适合排查启动问题。比如你给树莓派换了张新 TF 卡、装了 Ubuntu 系统结果 HDMI 没输出、网络找不到设备这时候串口日志能直接告诉你系统卡在哪个环节。我做树莓派无头调试时USB 转串口是常年插在桌面上的标配。5.3 外接多路设备的便宜方案USB HUB 多块转接板树莓派的 GPIO 串口资源非常紧张默认只有一路稳定的物理串口蓝牙还时不时来插一脚。如果你要做一个小车、网关或机器人控制板需要同时接 GPS、RS485、指纹模块、ESP32 等多个串口外设根本不够用。最省事的扩展方案就是 USB HUB 加多块 USB 转串口板。一个 USB 转串口板对应一个独立设备节点比如ttyUSB0、ttyUSB1、ttyUSB2互不干扰。驱动层会把它们都认成独立的串口你可以在 Python 里分别打开也可以绑定到不同应用。这里有一个实用心得插多块相同芯片的 USB 转串口板时Linux 的设备节点顺序不一定是插拔顺序。识别具体是哪块板要用/dev/serial/by-id/里的符号链接或者根据 USB 端口号来定位。如果你的 ROS2 小车或者数据采集程序里写死了ttyUSB0重启后设备顺序一变程序可能就找不到串口了这是一个很隐蔽的坑。6. 不同型号树莓派的串口差异换板子后别用旧经验硬套树莓派型号跨度很大串口配置也不是一成不变。你如果一直用树莓派 4B突然换成树莓派 5再套用旧经验可能会一脸懵。每个时代的板子都有自己的脾气。6.1 树莓派 5RP1 与更多 UART树莓派 5 的 IO 架构发生了明显变化GPIO 和很多外设不再由主芯片直接引出而是通过一颗叫做 RP1 的 IO 控制器芯片来管理。这颗 RP1 提供了比以往更丰富的 UART 资源所以在树莓派 5 上可能看到的不再是只有ttyAMA0和ttyS0这两个老面孔而是一个ttyAMA系列设备群。具体哪些设备节点对应哪组引脚不同内核版本和系统镜像之间可能有差异不要想当然。最可靠的办法是看系统日志确认 GPIO 14/15 对应的主串口到底是谁。有一点仍然保持不变那就是/dev/serial0这个符号链接会稳定指向 GPIO 主串口所以代码层面继续用/dev/serial0依然最安全。6.2 Zero W、CM4 与早期型号蓝牙和载板带来的差异树莓派 Zero W 虽然板子小但同样带蓝牙所以它也面临 GPIO 串口和蓝牙抢 PL011 的问题。如果你拿 Zero W 做物联网节点想用 GPIO 串口接传感器最好也做一次dtoverlaydisable-bt的释放操作或者接受 mini UART 的稳定性折中。树莓派 Compute Module 系列则更特殊。CM4 本身是一颗核心板没有固定的 GPIO 排针所有串口引脚都靠底板硬件决定。同样一片 CM4放在不同厂商的载板上串口设备名、可用引脚、甚至有没有引出串口都完全不同。用 CM4 做产品时第一件事就是看载板的原理图搞清楚 UART 走的是哪根引脚被分配到了哪个设备节点。而树莓派 1 代和 2 代因为没有蓝牙通常/dev/ttyAMA0直接就是 GPIO 串口没有这么多弯弯绕绕。这也解释了为什么老教程里的方法放到新板子上会失灵因为硬件分配变了。6.3 拿到陌生板子的通用排查流程不管是什么型号的树莓派拿到手后先用三步确认串口状态可以避免绝大多数盲目操作dmesg | grep -i tty ls -l /dev/serial* cat /boot/config.txt | grep -i -E uart|serial|bt运行dmesg后你会看到内核枚举出的串口设备列表以及设备节点名。运行ls -l /dev/serial*你能看到serial0和serial1分别指向谁。最后看一下配置文件里的相关行就能判断系统当前是否启用了串口、有没有禁用蓝牙、有没有加载陌生的 overlay。如果发现/dev/serial0不存在第一时间检查enable_uart1有没有写进去。如果设备存在但读写异常再按前面的电平、波特率、共地顺序排查。这套流程我每次拿新板子都会跑一遍基本不会漏东西。最后再分享一个日常习惯调试任何串口外设之前我会先在树莓派本机上做一次回环测试确认板子自己没问题再去碰外设。这样可以把问题快速切分到“树莓派侧”还是“外设侧”省去大量猜测。树莓派的串口体系看着绕但只要分清楚 PL011、mini UART、USB 虚拟串口这三类角色再牢记电平、共地、波特率三件事绝大多数串口问题都能当场定位。