The Idiot's Guide to MeshCore

You're Not an Idiot, But Your ISP Thinks You Are

Building Resilient Communication Together: Your MeshCore Guide

Welcome to MeshCore—a collaborative effort to build decentralized, resilient communication networks that work independently of traditional infrastructure. Whether you’re interested in emergency preparedness, off-grid communication, or simply want to participate in building robust community networks, you’re joining a growing movement of individuals committed to communication independence.

This guide will help you understand MeshCore, set up your first node, and contribute meaningfully to the network. Your participation matters—every node strengthens the mesh.


Getting Started: Quick Start Guide

Ready to join the MeshCore network? Here’s what you need to know to get your first node up and running:

What You’ll Need:

Frequency: 910.525 MHz
Bandwidth: 62.5 kHz
Spreading Factor: 7
Coding Rate: 5

Quick Start Steps:

  1. Flash Your Device: Visit the MeshCore Flasher, connect your device via USB, select your hardware model and firmware type (Companion Radio for personal use, Repeater to help extend the network), and click flash.

  2. Configure Network Settings: This is critical—use the coordinated settings for your region. In North America, that’s 910.525 MHz with 62.5 kHz bandwidth, SF7, and CR5. Without these settings, you won’t connect to the existing network.

  3. Advertise Your Node: Unlike other mesh systems, MeshCore requires you to manually announce your presence. Use the advertisement function in your app or device to let other nodes discover you.

  4. Start Communicating: Connect via Bluetooth (companion radios) or use your T-Deck’s built-in interface to begin messaging other nodes in the network.

That’s it! You’re now part of a resilient, decentralized communication network. Read on to understand how everything works and how to maximize your contribution to the mesh.


See It In Action

Don’t just take my word for it. Watch these videos and see what happens when regular people decide to actually solve problems:


Why Network Coordination Matters

MeshCore’s strength lies in its ability to create interconnected networks that span neighborhoods, cities, and regions. However, this only works when participants use coordinated settings. Think of it as speaking a common language—when everyone uses the same frequency and parameters, your messages can reach further and connect with more people.

North America Coordinated Settings

For optimal connectivity with the established MeshCore network in the USA and Canada, use these standardized settings:

Frequency: 910.525 MHz
Bandwidth: 62.5 kHz
Spreading Factor: 7
Coding Rate: 5

These settings are not optional if you want to connect with the existing network. They represent the consensus of the North American community and enable seamless communication from Portland to Vancouver to San Jose and beyond.

Other Regions

Always verify the appropriate frequency for your region and coordinate with local operators.


Understanding MeshCore

MeshCore is a lightweight mesh networking protocol built on LoRa radio technology. It enables:

Core Capabilities:

Use Cases:


Choosing Your Hardware

MeshCore supports a wide range of ESP32-based LoRa devices. Many are compatible with existing Meshtastic hardware, making it easy to repurpose equipment you may already own.

Heltec V3/V4 LoRa32

LilyGo LoRa32 / T-Beam

LilyGo T-Deck

RAK4631

Seeed Studio T-1000E

Most ESP32-based LoRa boards will work. Check the official MeshCore flasher for your specific device compatibility.


Understanding Firmware Types

MeshCore offers three firmware variants, each serving a specific role in the network:

1. Companion Radio Firmware

Purpose: Connects your radio to a smartphone or computer for messaging

Connection Methods: Bluetooth (BLE), USB, or WiFi

Best For:

Available Platforms: Android and iOS apps, web interface

2. Repeater Firmware

Purpose: Extends network coverage by intelligently forwarding messages

Key Features:

Critical Role: Repeaters form the backbone of the network. Well-placed repeaters dramatically improve coverage and reliability. If you have access to an elevated location—rooftop, hilltop, or tall building—deploying a repeater is one of the most valuable contributions you can make to your local network.

3. Room Server Firmware

Purpose: Provides persistent message boards (BBS-style) for community communication

Features:

Use Case: Community bulletin boards, persistent group coordination, asynchronous communication


Getting Started

Step 1: Flash Your Device

Option A: Web Flasher (Recommended)

  1. Visit meshcore.co.uk
  2. Connect your device via USB
  3. Select your device model and firmware type
  4. Follow the on-screen instructions
  5. Flash completes in minutes

Option B: PlatformIO (Advanced)

  1. Install PlatformIO extension in Visual Studio Code
  2. Clone the MeshCore repository from GitHub
  3. Open the appropriate example application:
    • Companion Radio
    • Simple Repeater
    • Simple Room Server
  4. Build and upload to your device

Step 2: Configure Your Settings

This is critical: Configure your device with the coordinated settings for your region.

For North America:

Frequency: 910.525 MHz
Bandwidth: 62.5 kHz
Spreading Factor: 7
Coding Rate: 5

You can configure these settings:

Step 3: Advertise Your Presence

MeshCore uses manual advertising to reduce network congestion. You must actively advertise yourself to be discovered by other nodes.

What is an Advertisement?

Advertisement Types:

Zero-Hop: Announces your presence to immediate neighbors only—useful for local discovery

Flood: Announces your presence across the entire network via repeaters—use when you want network-wide visibility

Access the advertisement function through the signal icon in your app or T-Deck interface.

Step 4: Connect and Communicate

Using Mobile Apps:

  1. Download the MeshCore app (available for Android and iOS)
  2. Enable Bluetooth on your device
  3. Pair with your companion radio
  4. Set your display name
  5. Configure your region’s coordinated settings
  6. Send your initial advertisement
  7. Begin discovering nearby nodes

Using T-Deck:

  1. Power on the device
  2. Configure network settings
  3. Optionally register your device for advanced features
  4. Begin messaging immediately—it’s a complete standalone system

Troubleshooting Common Issues

Incorrect Timestamps

Cause: No GPS lock or improper GPS configuration

Solutions:

Cannot Connect to Repeater via Bluetooth

Expected Behavior: Repeaters running repeater firmware do not support Bluetooth connections. They are dedicated to network infrastructure roles.

Solution: If you need Bluetooth connectivity, flash companion firmware instead

Network Appears Empty

Most Common Cause: You haven’t advertised your node

Solution: Click the advertisement button in your app or T-Deck. MeshCore nodes don’t continuously beacon—you must explicitly announce your presence.

Low Node Density in Your Area

Reality: While regions like Portland and Vancouver have established networks, many areas are still in early adoption phases.

Opportunity: This is where your leadership matters. Every network started with one person. You can:


Building Networks: A Call to Action

Strong networks don’t appear spontaneously—they’re built by committed individuals who understand the value of resilient communication. Here’s how you can contribute:

If You’re in an Established Area

If You’re in an Emerging Area

Universal Contributions


The Path Forward

MeshCore represents more than technology—it’s a commitment to communication resilience and community self-reliance. Every node you deploy, every person you help onboard, and every repeater you place strengthens the network for everyone.

Your participation matters. The time to build resilient communication infrastructure is before you need it.

Key Takeaways

Next Steps

  1. Flash your device with the appropriate firmware
  2. Configure with coordinated regional settings
  3. Deploy and advertise your node
  4. Consider strategic repeater placement
  5. Share your experience with others
  6. Join the community at discord.gg/meshcore

Welcome to MeshCore. Your network needs you.


Additional Resources


Disclaimer

This guide is educational, occasionally accurate, and written with love. Always follow FCC regulations for radio use. The author is not responsible for:


Now stop reading and start meshing! 📡