Cannot connect, or buttons do not respond
Check the wiring first, then try the official tool once. If it cannot connect either, the device side is likely; if it can, the software side is.
Get the three ports right
The box has three ports printed on the side: the gaming PC goes to USB1, the device running HWMacro goes to USB2, and the mouse or its wireless receiver goes to USB3.
- HWMacro runs on an Android phone, a tablet, or a second Windows PC, never on the gaming PC. Plug USB2 into the gaming PC and that PC becomes the control device, so HWMacro cannot find the box.
- The cable has to carry data. Many USB-A male-to-male cables are charge-only and do nothing when plugged in; use one that states it supports data transfer.
- On a second Windows PC, install the CH343 serial driver first: Download CH343SER.EXE
The wiring diagram is in step 1 of Get started.
Try the official tool once
The official tool is MAKCU Toolkit. It tells you directly whether the box can be reached.
Quit HWMacro before you open it. Only one program can open the USB2 management port at a time. When two of them fight over it, the official tool reports that it cannot connect, even though the box is fine.
With the cables in and HWMacro closed, connect once following the official guide and see which case you are in.
The official tool cannot connect either
Most likely the device side. Contact the seller (Taobao, Pinduoduo, Xianyu) and send them what the official tool reported. Also ask whether the box has the latest firmware: the tool has a repair flash option and the seller will usually walk you through it.
The official tool connects, HWMacro does not
That is the software side. Send support two screenshots: the connection check result in the official tool, and the error HWMacro shows after you tap Connect. Same thing if it connects but Test buttons does not respond.
Connected, but not stable
It drops out after a while: Android clears background apps and kills HWMacro. Turn off battery optimization for HWMacro and allow it to auto-start. The exact path differs by brand; look for HWMacro under app management in system settings.
Stutter, dropouts, or sticky keys: the mouse polling rate is set too high. Set it to 1000 Hz in your mouse software.