Troubleshoot¶
| Symptom | Likely cause | Fix |
|---|---|---|
| Browser shows no serial device | Charge-only cable or missing dialout |
Data USB-C; add user to dialout and re-login |
| Flasher cannot open port | Not in bootloader / wrong port after RST | Bootloader; reselect Espressif ttyACM* |
| Flash fails mid-way | Cable / port / erase interrupted | Retry flash; keep cable seated |
| App never finds the device | Wrong role (Repeater / Room Server) or BLE off | Reflash Companion · Bluetooth; enable phone Bluetooth |
| App stuck on Connecting | Stale iOS BLE session / half-open link | Forget MeshCore-… in iOS Bluetooth; RST board; re-enter OLED pin — Phone app |
| Wrong BLE PIN | Used 123456 while OLED shows a pin |
Enter Pin:###### from the OLED |
| DM Failed / no ACK | Wrong preset, no path, or out of range | New Zealand (Narrow); antenna; Flood Advert; Reset path; need MeshCore peers |
| Connected but no mesh peers | Alone on air or wrong preset | Confirm New Zealand (Narrow); wait for adverts / local repeater |
| Illegal / dead air | Wrong band for your country | Use MeshCore radio presets; do not invent frequencies |
| Still on Meshtastic UI / behaviour | Board not re-flashed with MeshCore | Full Companion flash from meshcore.io/flasher |
Still stuck? Re-check Prerequisites and Flash.