企业官网建设流程全解析

Flipper Zero WiFi 开发板串口连接输出乱码怎么排查？

【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper

用 PuTTY 等串口终端连接 Flipper Zero 的 WiFi 开发板（ESP32-S2）时，如果终端里刷出的是一大堆无法辨认的字符，而不是预期的设备输出，本仓库 Wifi_DevBoard/ReadMe.md 的 “If serial connection looks scrambled” 一节给出了对应排查路径：先核对 Flipper 侧的 USB-UART 配置与波特率，再核对终端工具参数，然后复位开发板并等待输出；如果问题持续，再重刷 Flipper 固件。该方法覆盖文档列出的几种连接方式：开发板经 Flipper USB-C 上电脑（USB-UART 桥接）、开发板直接插电脑 USB、或 Android 手机配合 Serial USB Terminal App。

乱码现象与连接前提

文档中“scrambled”现象指串口终端显示大量不可读的乱码字符，而不是 Marauder 的菜单或提示符。开始排查前确认两点：

• 文档明确要求：连接 Marauder 之前确保 qFlipper 是关闭状态（make sure qFlipper is CLOSED），否则串口会被占用。
• 开发板上的固件已经刷好（出厂默认是 Blackmagic 固件；刷 Marauder 的步骤见同一 ReadMe 的 Marauder 一节或 FZ_Marauder_Flasher/ReadMe.md）。

Windows 上如果不确定设备对应哪个串口，文档建议用 USB Device Tree View 工具找到 COM 口，再在 PuTTY 中选择。

第一步：核对 Flipper 侧 USB-UART 配置与波特率

ReadMe 引用的 Frog 修复步骤（原文标题 “Exactly what I had to do”）是这条排查路径的主干：

1. 在 Flipper 上进入GPIO > USB-UART > Config；
2. 把USB Channel 设为 1；
3. 把BaudRate 设为 115200；
4. 确认终端工具（PuTTY）里的Speed 也是 115200——两侧波特率必须一致。

关于第 2 步，ReadMe 内嵌的 E_Surge 分步截图给出了原因：USB-UART 应用默认配置下，Flipper 的 USB 口只暴露一个 USB 通道（串口）；改成使用 channel 1 后会出现两个 USB 串口，一个属于 flipperzero，另一个属于 wifiboard。也就是说，如果你的开发板挂在 Flipper 的 GPIO 口上、想从电脑经 Flipper 的 USB 访问它，通道配置不对就会连错对象或收不到正常数据。

115200 这个波特率在文档中多处出现：Mac 直连的screen命令、E_Surge 截图中 “connect to the Serial Port with baud 115200”，以及 Frog 步骤里的两侧设置，均指向同一数值，可直接照用。

第二步：复位开发板，等待输出

参数核对完成后，按 Frog 的步骤执行：连接上之后，多次点击 WiFi 开发板上的 Reset 按钮，然后耐心等待（原文强调 Wait PATIENTLY）。

判断依据以文档给出的现象为准：

• Mac 直连一节写的是：按下 Flipper 板上的 reset 后，你会看到终端开始有输出（"you'll see it populate"）；
• ReadMe 内嵌的 E_Surge 分步截图则写：按 wifi board 的 Reset 按钮后会看到 esp32marauder 的 ASCII logo（文档标注该现象为 optional）。

也就是说，乱码被修好的标志是：复位后终端出现可读输出。如果复位多次仍只有乱码或无输出，进入下一节。

Mac 直连时：选错串口设备名也会导致看不到输出

如果你是把开发板/Flipper 直接插到 Mac 上，ReadMe 给出的完整排查顺序是：

1. 打开 Terminal，执行ls /dev/tty.*；
2. 从列出的设备中选择名字里带有 flipper 字样的那个，文档示例为/dev/tty.usbmodemflip_XXXXX3（XXXXX3是文档中的示例占位，替换成你实际看到的设备名）；
3. 用screen前缀加波特率后缀建立连接：

screen /dev/tty.usbmodemflip_XXXXX3 115200

4. 按文档说明：对 Flipper 板按 reset，终端应开始有输出；如果没反应，直接换另一个 flipper 设备名再试（文档原话：simply try the other flipper directory name）。

这条路径同时回答了“输出为空”和“连错设备”两类现象，和乱码排查共用同一个成功标准。

仍然乱码：重刷 Flipper 固件

如果上述步骤都做了、串口输出依然持续乱码，Frog 在文档中的补充建议是：问题持续时，值得重刷 Flipper 自身的固件。操作顺序按文档原文：先刷 Official 官方固件并测试，确认正常后，如需要再换用解锁版固件。

注意区分两个对象：这里重刷的是Flipper 主机的固件，不是 ESP32-S2 开发板上的固件；开发板固件的刷写是另一套流程（见 ReadMe 的 Marauder/Blackmagic 章节），不属于本次乱码排查的步骤。

排查边界

• 文档对乱码问题给出的就是“USB-UART 配置 + 两侧 115200 + 多次复位等待 + 持续则重刷 Flipper 固件”这一条路径，没有提供引脚级或驱动级的进一步排查项；照此执行后仍无解时，文档没有给出更多依据。
• 通过 Flipper USB 桥接、开发板直连 PC、Android 手机 App 三种连接方式共用以上参数与验证标准；连接入口不同，但波特率 115200 与“复位后有可读输出”这两个判据不变。

【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper