WezTerm 如何连接串口控制台调试嵌入式设备与无头服务器【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/weztermWezTerm 除了作为终端仿真器还可以作为串口客户端直接打开本地串口设备。官方文档给出的典型场景正是本文标题中的两个用途调试 Arduino 等嵌入式设备以及连接无头服务器上的串口控制台。本文基于仓库中的 docs/serial.md、docs/cli/serial.md 和 docs/config/lua/config/serial_ports.md 三篇文档给出从一次性连接到处方配置的操作路径。一次性连接wezterm serial 端口最直接的方式是用wezterm serial子命令打开一个串口语法为$ wezterm serial [OPTIONS] PORT其中PORT是串口设备名文档对两个平台的命名方式有明确说明Linux 等 posix 系统设备路径例如/dev/ttyUSB0Windows 系统COM0这样的 COM 口名称对应的基本命令为# Linux $ wezterm serial /dev/ttyUSB0 # Windows $ wezterm serial COM0指定波特率--baud串口的通信速率必须与对端设备一致而wezterm serial的默认波特率是 9600来自 docs/examples/cmd-synopsis-wezterm-serial--help.txt 中--baud的说明。如果你的设备大多数嵌入式设备、UART 控制台运行在更高速率上需要显式用--baud指定$ wezterm serial --baud 38400 /dev/ttyUSB0--baud BAUD的含义文档中只说明为“Set the baud rate”其余参数以wezterm serial --help的输出为准此外还有--class覆盖窗口系统类名和--position覆盖初始窗口位置两个与调试流程无关的选项本文不展开。连接窗口上的行为限制文档明确说明当 wezterm 窗口处于串口模式时不能在该窗口内新建标签页When a wezterm window is operating in serial mode it is not possible to create new tabs。也就是说一个串口连接独占一个窗口如果你同时要观察设备输出和查资料需要另开一个 wezterm 普通终端窗口。常用串口固化为命名域serial_ports配置如果某个串口你经常连可以在 Lua 配置中定义serial_ports把端口和波特率固化下来之后通过wezterm connect或启动器菜单连接。配置项说明如下name- 串口域的名称必须在所有多路复用域中唯一port- 串口设备名Windows 下为COM0这类名称posix 下为/dev/ttyUSB0这类路径。省略时name字段会被当作端口名解释baud- 通信速率省略时默认 9600。定义单个端口的示例来自文档原文config.serial_ports { { name /dev/tty.usbserial-10, baud 115200, }, }多个端口可以起友好的名字例如config.serial_ports { { name Sensor 1, port /dev/tty.usbserial-10, baud 115200, }, { name Sensor 2, port /dev/tty.usbserial-11, baud 115200, }, }配置生效后文档给出了三种使用方式命令行直接连接$ wezterm connect /dev/tty.usbserial-10文档说明其行为类似于wezterm serial /dev/tty.usbserial-10 --baud 115200即端口名和波特率都取自配置。正常启动 wezterm 后使用 Command Palette 或 Launcher Menu在该串口域中打开新标签页连接设备。在包含 SpawnCommand 的标签/窗口生成类键绑定中按名称引用该串口域。结果验证与已知限制完成连接后如何判断成功文档没有给出固定的输出样例能依据文档确认的判据是wezterm serial/wezterm connect打开的窗口即为串口会话直接向其中输入如回车看对端设备是否有响应这是串口调试的常规确认方式若对端无响应按文档核对的第一项是波特率--baud/baud配置必须与设备侧一致默认值是 9600串口窗口内尝试新建标签页失败属于预期行为不是故障见上文限制。历史版本方面的一个参考信息docs/changelog.md 记录了 20200202 版本修复过“打开串口时波特率未生效”的 bug如果你使用的发行版包非常旧且发现--baud不生效可先考虑升级。适用边界本文覆盖的是本机直接打开串口USB 转串口设备或服务器串口映射到本地的设备文件远程服务器的串口需要先把设备路径映射到本机文档未覆盖这一步。Flatpak 安装方式运行在沙箱内文档提示其行为可能与原生包有差异见 docs/install/linux.md需要稳定访问/dev/tty*设备时建议按文档建议选择原生包安装。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考