Meshtastic: from your first board to your first message

A radio on the table, a phone in your hand and a message appearing on another device: that is a good first Meshtastic project. Begin with a small, repeatable test. Once you know the equipment works, explore range, positioning and the local network.

Understand the two connections

The phone connects to a nearby radio through a supported local connection, such as Bluetooth or USB. The radio uses LoRa to communicate with other radios. The direct radio link needs neither mobile coverage nor an internet subscription. See the options for your device in the official introduction.

Think of the phone as the notebook and the radio as the messenger. A connected phone does not by itself prove that another radio can receive your messages.

Choose the board for the project

Start with practical questions: will it sit on a desk, travel in your pocket or operate far from a power socket? Do you need positioning? Would a display help? Are you happy to solder, or do you want as little assembly as possible?

See the current Meshtastic range, where legacy hardware is clearly marked. Heltec WiFi LoRa V3.2, Wireless Tracker, LILYGO T-Beam and LoRa32 V2.1.6 have different practical features. Check package contents and assembly requirements on the specific product page. A separately included display is not necessarily installed. Use the same exact board revision when selecting firmware.

Gather it on your workbench

• A supported radio board and an antenna matching its connector and frequency band.
• The right USB data cable. A charge-only cable can supply power without allowing configuration.
• A suitable power supply and any accessories that need to be bought separately.
• Another compatible node, or a known-working nearby node, for the radio test.

Attach the antenna before powering the radio. Meshtastic warns that powering a radio without an antenna can damage it. Its preparation guide also explains how to check the USB cable.

Make the first connection

1. Identify the exact model and hardware version. Similar names do not necessarily mean the same firmware.
2. Follow the current installation instructions for the hardware. ESP32 and other chip families may use different update methods. Use the ESP32 guide when it matches your board.
3. Connect a supported client and select the region. Menus vary between clients; follow the initial configuration.
4. For an appropriate 868 MHz board in Denmark or Sweden, look up EU_868 in the country list. The hardware band and region setting must match. A menu setting does not change the antenna or radio hardware.
5. Use the same region and modem settings on the radios. A shared messaging channel also requires a matching name and key. See the distinction between LoRa settings and channel settings.

Test before chasing kilometres

Send a short message between two nodes a few metres apart. Record the models, firmware versions and settings that worked. Move only one node for the next test and change one thing at a time. A notebook often helps more than changing every radio setting at once.

A successful long-range test does not guarantee the same range elsewhere. Test where you actually intend to use the equipment. Buildings, terrain, antenna placement and the available network can change the result.

If the message does not arrive

Split troubleshooting in two. Can the client talk to its own radio? Check the cable, permissions, connection type and firmware choice. Can the radios talk to each other? Compare region, modem settings, channels and antennas. A paired phone is only the first half of the connection.

Keep the first setup simple. Use the project’s documented client configuration before experimenting with special roles or advanced radio settings. Consider channel keys and position sharing; read the channel guide before sharing a channel link.

Your next step

First get one pair working reliably. Then choose what to investigate: a portable node, a positioning project or better coverage in a particular place. See our development boards, check package contents, or ask us about your project. eBits is a Danish webshop shipping from Aarhus.