未检测到 MAKCU 或鼠标无法工作：USB、COM 端口、固件和电缆诊断

10分钟快速检查

从简单的参考设置开始。在基本连接正常工作之前，请勿使用 USB 集线器、延长线、前面板端口或适配器。

如何区分 USB1、USB2 和 USB3

MAKCU 有三个用途不同的端口。正常工作时无需按下 Boot 按钮。

• USB1，左侧端口连接到游戏电脑。该板通过此端口发送标准鼠标输入。
• USB2，中间端口提供MAKCU与软件之间的控制通道。在 Windows 中，此连接创建 COM 端口。
• USB3，右侧端口在此连接鼠标或其 USB 接收器。

使用 Android 手机时，将 USB1 连接到游戏电脑，通过 OTG 适配器将 USB2 连接到手机，并将鼠标连接到 USB3。在双电脑方案中，将中间的 USB2 端口连接到第二台电脑。所有连接方案的详细图片请参阅： MAKCU 完整指南.

根据症状选择第一项检查

指示灯的含义

不同开发板版本和固件版本的指示灯表现可能不同，因此请结合 Windows 与软件的响应进行判断：

• 指示灯不亮： 首先检查电源、USB1、USB2、电缆和连接器。
• 指示灯亮，但无输入： 电源存在，但这并不能证明数据线可以工作。检查 COM 端口、连接布局和鼠标兼容性。
• 慢速闪烁不停： 断开所有电源 10 秒，重建连接，并检查板是否处于错误模式。

在 Windows 中诊断 COM 端口

在 Windows 中，中间的 USB2 连接创建 COM 端口。在运行宏软件的计算机或笔记本电脑上查找它。在 Android 上，应用程序直接处理此 USB 连接，因此它不会出现在 Windows 设备管理器中。

1. 打开设备管理器右键单击“开始”按钮并选择“设备管理器”。
2. 展开“端口（COM 和 LPT）”记下当前列表，然后仅拔下中间的 USB2 电缆并重新连接。
3. 找到发生变化的条目正确的 COM 端口应随着 USB2 的断开与重连而消失和出现。不要只凭名称判断，重新连接测试更可靠。
4. 检查COM号如果软件无法连接且端口号为 COM10 或更大，请通过“属性”→“端口设置”→“高级”分配一个未占用的 COM3 至 COM9 编号。
5. 释放端口彻底关闭固件刷写工具、MAKCU 网页工具、终端及其他串口程序。同一时间只能有一个程序占用 COM 端口。
6. 再次运行检查断开 MAKCU 10 秒钟，重新连接正常操作设置，然后才打开 TopMacro。

标准通信模式通常使用 115200 波特率。请勿随意按键更改开发板的通信速率：开发板与软件中的数值必须一致，否则可能会引入新问题。

检测到 MAKCU，但鼠标不工作

如果程序能识别开发板且 COM 端口稳定，但光标不移动，请将鼠标信号链路与固件问题分开检查。

1. 直接测试鼠标不通过 MAKCU，将鼠标直接连接到同一台游戏电脑。移动、主要按键和滚轮都应稳定工作。
2. 将鼠标重新连接到右侧 USB3 端口不要将鼠标连接到中间的 COM 端口。对于无线鼠标，请使用其 USB 接收器。不支持与开发板的直接蓝牙连接。
3. 检查完整的操作设置USB1 必须连接到游戏电脑，USB2 必须连接到运行软件的设备，USB3 必须连接到鼠标。正常工作时请勿持续按住 Boot 按钮。
4. 连接板子后启动软件选择 MAKCU 作为输入模式，并确认软件报告板已准备就绪。
5. 与另一只鼠标比较基本的有线 USB 鼠标最适合此测试。如果它工作而主鼠标不工作，则问题与该特定鼠标、其接收器或其 USB 协议有关。

何时确实需要重新刷写固件

以下情况适合刷写固件：开发板是未预装固件的新板；其中一侧无法进入正常工作模式；此前更新失败；或客服已确认线缆、USB 端口和 COM 连接均正常。

安全刷写顺序

1. 完全断开电路板进入 Flash 模式前请拔下所有线缆。每一侧都使用一根线缆单独刷写。
2. 刷写左侧按住左侧 Boot 按钮，将线缆连接到左侧 USB1 端口，检测到 Flash 模式后再松开按钮。在程序中选择“USB1 Flash”。
3. 刷写完成后拔下线缆等待写入成功消息。操作过程中请勿将电缆移至另一侧。
4. 刷写右侧按住右侧 Boot 按钮，将线缆连接到右侧 USB3 端口，等待识别完成，然后选择“USB3 Flash”。
5. 关闭固件刷写工具刷写完成后彻底关闭工具，使其释放 COM 端口，然后重新连接正常工作线路。

包含“USB1 Flash”和“USB3 Flash”按钮截图的完整说明见： 如何刷写MAKCU ESP32-S3.

如果在操作过程中连接断开

1. 移除中间设备将 USB1 和 USB2 直接连接到计算机。在测试期间移除 USB 集线器、KVM 切换器、延长线和前面板端口。
2. 交换电缆如果问题从一个端口转移到另一个端口，则表明电缆出现故障。如果它保留在同一连接器上，请在另一台计算机上测试该连接器和电路板。
3. 检查物理连接轻轻触摸连接器附近的电缆，不要弯曲电路板。如果设备在轻微移动后消失，则表明电缆或连接器已损坏。
4. 禁用 USB 省电功能进行排查如果在一段时间不活动后连接断开，请在高级 Windows 电源设置中暂时禁用 USB 选择性挂起，然后重复测试。
5. 在另一台电脑上测试如果两根确认正常的线缆在两台电脑上都出现相同问题，开发板或其接口故障的可能性更高。

为了准确诊断，需要向客服提供什么

仅说“MAKCU 无法工作”并不能说明连接在哪个环节中断。请简要准备以下信息：

• 从上方拍摄的开发板照片，确保三个端口和线缆全部清晰可见。
• 所选设置：一台 PC、两台 PC 或 PC + Android。
• Windows版本和TopMacro软件版本。
• “端口（COM 和 LPT）”部分的屏幕截图。
• 确切的 COM 端口号。
• 连接后哪些指示灯亮起或闪烁。
• 出现错误的步骤及其完整文本。
• 测试另一根电缆、端口、鼠标或 PC 的结果。

不要发送您的账户密码或付款详细信息。 故障排除不需要它们。

常见问题