Skip to content

Getting Started with MeshCore

Hardware Requirements

  • MeshCore-compatible device: Check the MeshCore documentation and MeshCore.io for supported hardware
  • Antenna: A suitable antenna for your frequency band (915MHz for US operations)
  • USB cable: For device programming and power
  • Power solution: Battery pack, solar panel, or wall adapter depending on your deployment

Antenna Safety

Never power on your device without an antenna connected. This can permanently damage the radio hardware.

Hardware Setup

  1. Connect your antenna to the device BEFORE powering on
  2. Connect your device via USB to your computer
  3. Ensure you have a stable power source for your intended deployment

Software Installation and Device Role Selection

  1. Visit the Meshcore Web Flasher in your web browser
  2. Connect your device via USB to your computer

  3. Choose your device role by selecting the appropriate firmware type:

    • Companion Firmware (BLE or USB): Recommended for your first node. Provides full messaging capabilities and connects to mobile apps
    • Room Server Firmware: Good choice if you have multiple nodes in the same location. Handles local message routing
    • Repeater Firmware: Only use if your node has excellent line-of-sight to many other nodes. Helps extend network coverage

  4. Follow the flasher instructions to:

    • Select your specific device model
    • Choose the firmware type that matches your intended role
    • Flash the firmware directly through your browser

Role Selection

Start with Companion firmware for your first node. You can always reflash with different firmware later as you learn more about your local mesh network.

Next Steps

View the Configuring Meshcore page to configure your node.

Using MeshCore Client Apps

After setting up your Meshcore device with Companion firmware, you'll need a client app to send and receive messages. Meshcore offers several client options depending on your device and preferences.

Mobile Apps

Android

iOS

Web Clients

Connecting Your Client

  1. For BLE Companion firmware: Use Bluetooth pairing with mobile apps
  2. For USB Companion firmware: Use web clients with USB serial connection
  3. Default Bluetooth pairing code: 123456 (if prompted)

Basic Usage

Once connected to your client app:

  • Send messages: Type and send text messages to other Meshcore users
  • View contacts: See discovered nodes and their last seen times
  • Join channels: Connect to public channels for group communications
  • Manage settings: Configure your node remotely through the app
  • View diagnostics: Monitor signal strength, battery, and network status

First Time Setup

When you first connect your client app to your Companion device, take some time to explore the interface and send test messages to verify everything is working correctly.

Getting Help

If you need assistance with the Meshcore:

  1. Community Resources: Check our community resources and Discord channels
  2. Documentation: Review the MeshCore project documentation
  • FCC Compliance: Ensure your operations comply with FCC Part 15 regulations
  • Power Limits: Stay within legal power limits for unlicensed operation
  • Antenna Safety: Use appropriate antenna installations and maintain safe RF exposure levels

Next Steps

Once you have your Meshcore device connected: