Troubleshooting
This guide covers the most common issues with MeshCore client devices and repeaters. Most problems come down to three things: physical connections, radio settings, or antenna placement.
First step for any issue: Check your physical hardware. Inspect all antenna connections, pigtail cables, battery connectors, and power leads before digging into software settings. A loose connection is the most common cause of problems that look like software or config issues.
Contents
Client Troubleshooting
Hardware Checklist
Before anything else, verify:
- Antenna is firmly connected — never power on a LoRa device without an antenna attached, it can damage the radio module
- If using a pigtail cable, check both ends are fully seated
- Battery connector is fully inserted and not loose
- USB cable is a data cable, not a charge-only cable
- Device powers on and shows activity (LED, display, etc.)
App will not connect to device over Bluetooth
- Make sure Bluetooth is enabled on your phone
- Power cycle the device (turn off and back on)
- Android: Go to phone Settings → Bluetooth, forget the device if previously paired, then reconnect
- iOS: Go to Settings → Bluetooth, forget the device, then reconnect
- The default Bluetooth pairing code is 123456 if prompted
- Make sure you flashed Companion firmware, not Repeater firmware — Repeater firmware has no Bluetooth
Heltec V3 keeps disconnecting from Bluetooth
- This is a known issue with certain Heltec V3 batches
- Update to the latest firmware via the MeshCore web flasher
- Try a different USB cable or port
- Some users report improvement when running on USB power only without the battery connected
No other nodes appearing
- MeshCore uses periodic adverts for discovery — it can take 2-5 minutes for nodes to appear. This is normal.
- Send a Flood Advert from the app to announce yourself to the mesh
- Confirm your radio preset is set to USA/Canada (Recommended) — 910.525 MHz, SF7, BW62.5
- Make sure you are using the MeshCore app, not the Meshtastic app — they are different protocols
- Check antenna connection — a missing or loose antenna will severely limit range
- Try moving to a higher location or outdoors for better line of sight to a repeater
Can hear others but they cannot hear me
- Check TX power in settings — make sure it matches your device capability (most boards support 22 dBm)
- Inspect antenna and pigtail connections
- When you send a message, look for "repeats heard" — if you see repeaters listed, your signal is getting out
- Use Tools → Trace Path to test connectivity to a specific repeater
- Move antenna higher or outdoors — antenna placement has the biggest impact on range
Messages not delivering
- A checkmark on a message means it was acknowledged by the destination
- If no checkmark, the destination node may be out of range or offline
- Try sending to a channel instead of a direct message
- Use Tools → Trace Path to verify a route exists to the destination
RAK or T1000-E device behaves strangely or does not respond
- Hold the reset button for 10 seconds while connecting via USB, then reflash firmware via the web flasher
- For T1000-E: use the nRF Connect app to perform a DFU factory reset, then reflash
Web flasher does not detect device
- Use Google Chrome or a Chromium-based browser — the flasher requires the Web Serial API
- Try a different USB cable (many included cables are charge-only)
- Try holding the BOOT button on the device while plugging in
- On Linux, you may need to add your user to the
dialoutgroup:sudo usermod -a -G dialout $USER
Repeater Troubleshooting
Hardware Checklist
Before anything else, verify:
- Antenna is firmly connected and rated for 915 MHz — a 2.4 GHz WiFi antenna will not work
- Pigtail cable connections are fully seated at both the board and antenna ends
- If using a weatherproof enclosure, check the cable gland is not pinching or damaging the pigtail
- Power supply is stable — solar nodes should be checked for battery charge level and solar panel connection
- Battery connector is fully inserted
- Device is powered on and running (check LED or connect via app)
Cannot connect to repeater via app
- Repeaters are configured via a companion device (your phone + client node) over LoRa — not Bluetooth
- Make sure your client node is in range of the repeater
- Send a Discover Nearby Nodes from the Tools menu to find the repeater
- If the repeater has an admin password set, you will need it to access admin functions
Repeater not appearing on the mesh
- Connect to the repeater and send a manual Flood Advert from the repeater tools menu
- Verify the radio preset matches the rest of the network — USA/Canada (Recommended) for the Inland Northwest
- Check antenna and pigtail connections — this is the most common cause
- Use Tools → Noise Floor to confirm the radio is receiving — a completely flat line may indicate a hardware issue
- Sync the clock via Sync Clock in repeater tools — clock drift can cause advert issues
Repeater was working but suddenly stopped
- Check for any recent config changes — reapply known-good defaults if unsure
- Inspect all physical connections first (antenna, pigtail, power)
- Use Tools → Trace Path from your client to trace to the repeater and check SNR
- Check Neighbors in repeater tools — if the neighbor list is empty, the repeater may not be hearing anyone
- Try a Reboot from repeater tools
- Check battery voltage via Telemetry — a low battery on a solar node can cause erratic behavior
Poor range from repeater
- Antenna height is the single biggest factor — even a few extra feet of elevation makes a significant difference
- Verify antenna is rated for 915 MHz and is the correct connector type
- Check pigtail cable length — longer cables introduce loss; keep them as short as practical
- Check TX power in repeater settings — should be set to the maximum your board supports (typically 22 dBm)
- Use Tools → Antenna Coverage and Line of Sight in the client app to evaluate placement
Solar node not staying online
- Check Telemetry → Battery voltage — should be above 3.6V under load
- Verify solar panel connection and inspect for damage or shading
- Confirm the charge controller or TP4056 module is functioning
- In winter months, Spokane averages only 2-3 peak sun hours — see the hardware guide solar calculator for sizing recommendations
Clock drift issues
- Connect to the repeater and run Sync Clock from the repeater tools menu
- If clock keeps drifting, reboot the repeater after syncing
- Accurate time is important for MeshCore adverts and message routing
Still stuck?
Join our Discord and ask in the #Troubleshooting channel — the community is active and happy to help diagnose issues. When asking for help, include:
- Your device model and firmware version
- What you have already tried
- Any error messages or unusual behavior
- Photos of your antenna and cable connections if relevant