This page is for setting up a normal MeshCore user node: a LoRa radio running companion firmware and connected to a phone, tablet, or computer.
If this is your first MeshCore device, start here. A companion node is the right firmware for most users who want to send and receive messages.
Useful links:
A companion node is a supported LoRa device running MeshCore companion firmware. The radio handles LoRa traffic, while an app on your phone or computer provides the user interface.
There are two common companion styles:
| Companion type |
Connects by |
Use when |
| BLE companion |
Bluetooth Low Energy |
You want to use a phone or tablet app |
| USB serial companion |
USB cable / serial |
You want to use a computer or web app over USB |
If unsure, most phone users should start with BLE companion firmware.
You need:
- A supported LoRa device.
- A suitable antenna for your band.
- A data-capable USB cable for flashing.
- A phone/tablet app or computer with the web companion app.
- The local MeshCore radio settings used by your area.
- Another MeshCore node or repeater in range for testing.
For supported devices, check the MeshCore flasher. The supported device list changes over time.
Before flashing firmware:
- Confirm the exact board model.
- Confirm the device frequency band matches your region.
- Fit an antenna before transmitting.
- Use a known data-capable USB cable, not a charge-only cable.
- If replacing Meshtastic or other firmware, make sure you are selecting MeshCore firmware.
- Open the MeshCore flasher: https://flasher.meshcore.io
- Select your device.
- Select companion firmware.
- Choose BLE companion or USB serial companion as appropriate.
- Flash the device.
- Reboot the device after flashing.
- Connect using the app or web companion.
- Confirm the local radio settings.
- Set your display name.
- Send an advert.
- Test with a nearby known MeshCore user or repeater.
Use BLE companion if you want to connect from a phone or tablet.
Good for:
- normal mobile use
- field testing
- carrying a node with a phone
- simple first setup
If the device does not appear over Bluetooth, check that you flashed BLE companion firmware rather than USB serial companion or repeater firmware.
Use USB serial companion if you want to connect from a computer or another host over USB serial.
Good for:
- desktop testing
- browser/web companion use
- development and debugging
- devices that will stay connected to a computer
The web companion app is here: https://app.meshcore.nz
After flashing:
- Power-cycle the device.
- Open the MeshCore app or web companion.
- Connect to the device.
- Confirm the app can read device information.
- Confirm the radio settings are correct for the local mesh.
If the app connects but nothing is heard over radio, treat that as a radio/settings/antenna problem, not just an app problem.
Your companion must use radio settings compatible with the local mesh. If the frequency, bandwidth, spreading factor, or coding rate are wrong, the node will not hear the local mesh even if the app connection works.
Current South Australian MeshCore radio settings are:
| Setting |
Value |
| Frequency |
923.125 MHz |
| Bandwidth |
62.5 kHz |
| Spreading factor |
8 |
| Coding rate |
8 |
Western Australia and Queensland use the same settings.
Do not change advanced radio settings randomly. Change one thing at a time and test.
¶ Set your name and identity
Set a short, recognisable display name. Good names make it easier for other users to identify who they are hearing.
Suggested style:
Name or callsign
Examples:
VK5ABC
Alice
Alice-VK5ABC
Avoid names that look like repeaters unless the device is actually a repeater.
After setup, send an advert so nearby nodes can discover you.
An advert is a MeshCore announcement. It lets other users learn your node identity and contact information.
If no one can see you yet:
- make sure you sent an advert
- ask a nearby user to send an advert
- move outdoors or near a window
- check the antenna
- confirm local radio settings
For the first test:
- Use a known-good nearby user or repeater if possible.
- Start outdoors or near a window.
- Keep the antenna vertical unless your local test setup says otherwise.
- Send an advert.
- Send a short test message.
- Ask the other user what they saw, including signal reports if available.
Do not judge the setup from one indoor test beside a computer, charger, or other noisy electronics.
Check:
- Is it powered on?
- Did you flash BLE companion firmware?
- Is another phone or app already connected?
- Does the device need to be forgotten/re-paired?
- Is Bluetooth enabled on the phone?
- Is the device close enough during setup?
Check:
- Use Chrome or another browser with WebSerial support.
- Use a data-capable USB cable.
- Close other serial monitors or flasher tabs.
- Try another USB port.
- Put the board into bootloader/DFU mode if required by that device.
Check:
- wrong frequency or modem settings
- wrong firmware type
- no local MeshCore nodes in range
- bad or missing antenna
- indoor location or poor antenna position
- local RF noise
- stale contacts or routes
Ask a known nearby user to send an advert while you test.
Possible causes:
- local receive noise near your node
- poor antenna or antenna connection
- your node is lower or more obstructed
- the other station is reaching a repeater that you cannot hear
- settings mismatch or stale route information
Move to a clearer location and test with a known nearby node.
Possible causes:
- antenna problem
- transmit power or board-specific RF issue
- poor location
- wrong regional settings
- you are hearing a repeater but cannot reach it reliably
Do a short-range test with another known-good node before changing advanced settings.
Avoid these early mistakes:
- Do not flash repeater firmware for a normal user device.
- Do not deploy a repeater before you have a working companion node.
- Do not tune repeater settings from a companion setup problem.
- Do not change many settings at once.
- Do not test only indoors beside noisy electronics.
- Do not assume Meshtastic settings apply to MeshCore.
When asking for help, include:
- device model
- firmware type: BLE companion or USB serial companion
- firmware version if known
- app or web companion used
- frequency/modem preset if known
- antenna used
- indoor/outdoor test location
- what you expected to happen
- what actually happened
This makes it much easier for others to help without guessing.
If your companion node can send and receive basic messages reliably, then you can start thinking about coverage, repeaters, room servers, or more advanced tuning.