Diagnosing MeshCore Repeater Problems

A systematic approach to diagnosing MeshCore repeater issues. Work from the physical layer up: radio first, then configuration, then network behavior.

Quick pre-diagnosis checklist

• Is the device powered? (check LED, screen, or measure supply voltage)
• Is an antenna connected? (transmitting without an antenna can damage the radio)
• Is the antenna connected to the LoRa SMA port, not the BLE u.FL? (Heltec V3/V4 have separate connectors)
• Is the device running repeater firmware, not Meshtastic or blank?
• Is it configured with the correct preset for your regional network?

Problem: Repeater is not appearing in MeshCore app contacts

Scenario A: Repeater has zero-hop advertisements

A repeater configured with 0-hop advertisements is only visible to nodes within direct radio range. If you're testing from a distant location, it won't appear. Connect via USB serial and confirm advertisement hop setting:

meshcli info # Check advert_hops value

Change to flood if you want the repeater visible network-wide:

meshcli set advert-hops flood

Scenario B: Wrong preset

A repeater on a different preset than your phone is on cannot be heard. The phone and repeater must use identical preset settings (same SF, BW, CR, frequency). Verify both devices use the USA/Canada preset.

Scenario C: Not yet advertised

A freshly configured repeater won't be visible until it broadcasts its first advertisement. Default interval is 12 hours. Force an immediate advertisement via serial CLI:

advert # Serial CLI command to immediately broadcast an advertisement

Scenario D: Out of radio range

Test with a device you control. Bring it within 100 feet of the repeater (direct physical proximity, no obstacles). If it appears in contacts at that range, the repeater is working and the issue is range/placement. If it still doesn't appear at 100 feet, it's a configuration or hardware issue.

Problem: Repeater visible but messages not routing through it

Check: Repeater role set correctly

meshcli info # Look for "role: repeater"

A node set to "client" role will not relay messages for other nodes. Must be set to "repeater" or "router" for active forwarding.

Check: Path discovery is completing

MeshCore must complete a route discovery (path discovery/acknowledgment exchange) before messages can be delivered. If messages are failing immediately after the repeater appears in contacts, path discovery may not have completed. Wait 60 seconds after first seeing the repeater, then try sending.

Check: Hop limit

If the destination node is more than 3 hops away from the sender (across multiple repeaters), and the hop limit is set to the default of 3, some paths may be cut off. Check and increase if needed:

meshcli set hop-limit 5

Problem: Repeater was working but stopped

Check: Power system

The most common cause of intermittent repeater failure. For solar-powered nodes:

• Battery voltage below 3.2V (LiFePO4) means it's nearly discharged - check solar panel and charge controller
• Charge controller LED indicators: verify charging when sun is on the panel
• Winter: reduced daylight hours may be insufficient for the panel size. Consider adding battery capacity for winter.
• Snow or debris covering the panel: physically inspect

Check: Firmware crash or lock

Firmware can occasionally hang, especially after a power interruption during a write operation. A full power cycle (disconnect and reconnect power) usually resolves this. If the device is cycling rapidly (power LED flashing repeatedly), it may be boot-looping - likely a firmware corruption requiring reflash.

Check: Physical damage

Water intrusion is the leading cause of permanent field failure. Signs: corrosion on the PCB, moisture beads inside the enclosure, condensation on components. Once water has infiltrated, the board often needs replacement. Prevention is much easier than cure - inspect enclosure seals annually.

Problem: Range is less than expected

1. Antenna connected? Transmitting into an open or disconnected SMA port causes VSWR problems and poor radiation.
2. Correct antenna for 915 MHz? An 868 MHz antenna on a US repeater will have higher SWR and reduced efficiency. Test with a NanoVNA (see the Antennas & RF section).
3. Antenna mount location: An antenna at 10 feet has dramatically less coverage than one at 30 feet. Every additional meter of height helps.
4. Coax cable length and quality: A 15-foot run of cheap RG58 can lose 3+ dB at 915 MHz. Use LMR-200 or better and keep runs short.
5. Obstructions at antenna level: Metal roof edges, HVAC equipment, or tree branches within a few feet of the antenna scatter and attenuate signal significantly.
6. TX power setting: Verify TX power hasn't been accidentally lowered: meshcli info