Heltec V4: Practice. Flashing, Setup, First Messages. Part 2

📌 This is Part 2 of the series. Part 1: Theory explains why this matters.

📦 Unboxing and Preparation

Heltec V4 Contents

⚠️ Important: without antenna connected, the radio module may be damaged. Always attach antenna before powering on.

Heltec V4 Specifications

⚡ Flashing: Web Flasher

Official flasher: https://flasher.meshtastic.org

Requirements

🐧 Linux: Serial Port Permissions

If you see:

[09:52:42.841] Serial: serial_io_handler.cc:157 Failed to open serial port: FILE_ERROR_ACCESS_DENIED

Fix:

# Add user to dialout group
sudo usermod -a -G dialout $USER

# Apply changes (re-login or)
newgrp dialout

# Verify access
ls -l /dev/ttyUSB*  # or /dev/ttyACM*

🔧 Flashing Process

1. Disconnect battery and USB from the board
2. Open web flasher, select:
   • Device: Heltec V4
   • Firmware: 2.7.21 (or latest stable/beta)
   • Variant: Full erase and install
3. Click Erase Flash and Install
4. Hold the PRG button on the board
5. While holding PRG, plug in the USB cable
6. Observe: brief red flash → USB JTAG appears in port dropdown
7. Release PRG, select USB JTAG, click Connect
8. Wait for flashing to complete (terminal shows progress)
9. After Leaving... message, press the RST button (reset)

💡 If flasher doesn’t detect the port - try another cable (not all support data), another USB port, or restart the browser.

🔌 First Connection: Three Ways

After flashing, the board reboots and starts Meshtastic.

Connection Options

⚠️ Bluetooth: only one active connection.
Wi-Fi: multiple devices can connect simultaneously (convenient for stationary nodes).
USB: reliable for setup and debugging, no wireless connection required.

Setup via App (Recommended)

1. Install Meshtastic (Android) or iOS version
2. Launch, grant location and Bluetooth permissions
3. Tap + → select your node (by name Meshtastic_XXXX)
4. Confirm pairing

Setup via Wi-Fi

1. Node screen displays IP address (usually 192.168.1.x)
2. Connect to node’s Wi-Fi network (password shown on screen)
3. Open http://<node_ip> in browser
4. Configure via web interface

💡 IP Address: node gets address from your router (not 192.168.4.1!). Exact address displayed on OLED screen.

👤 User Configuration

Core Parameters

💡 ShortName: strictly 4 characters! This is the identifier in messages.

🌐 MQTT Setup for ONEmesh (RU)

ONEmesh - map of Meshtastic devices in Russia. Connecting to their MQTT server lets your node appear on the map and exchange data with other participants.

🔐 MQTT transmits: messages, device metrics, location (if enabled) to the map and Telegram chats according to region/city settings.

Core Parameters

💡 Tip: if “Save” button is inactive - fill settings in stages: first basics (address, login, password), then map, then extra options.

Username Modes

⚠️ Using onemeshd with Downlink enabled adds load to the radio network. Use consciously.

📡 LoRa and Channel Settings

LoRa Section

🔁 If you change region - verify Root topic in MQTT updated automatically.

Channels

Configure the Primary channel:

✅ Setting one channel with PSK, Position enabled, and Precision is enough - even without MQTT, a neighboring node can forward your data.

📍 Position Settings

GPS Device

💡 Coordinates: enter without trailing zeros (e.g., 57.742, not 57.74200).

Position Packet

🔐 For privacy: reduce Precision in channel and Map precision, or set fixed coordinates away from real location.

⚙️ Additional Modules

Environment Module

🗺️ Map will show layers “Who heard this device” and “Who this device heard”.

Device Settings

Timezone

🔧 Optimal Flashing Process

For Heltec V4 (Bootloader Workaround)

Due to a Heltec V4 bootloader quirk, the standard order doesn’t always work. Optimal process:

1. Disconnect battery and USB from the board
2. Open web flasher
3. Select device: Heltec V4, firmware: 2.7.21
4. Click Erase Flash and Install
5. Hold the PRG button on the board
6. While holding PRG, plug in the USB cable
7. Observe: brief red flash → USB JTAG appears in port dropdown
8. Release PRG, select USB JTAG, click Connect
9. Wait for flashing to complete
10. After Leaving... message, press the RST button (reset)

💡 Note: this process is described in meshtastic/firmware#8543

📤 First Messages Between Two Nodes

Preparation

1. Flash both boards per instructions above
2. On each, configure:
   • Same region (Russia)
   • Same channel with identical PSK (AQ==)
   • Position enabled: Yes (for testing)
3. Place nodes 10–50 m apart (for initial test)

Test

1. On first node in app: Messages → + → type text → Send
2. On second node: incoming message should appear
3. Check Map tab - if MQTT is enabled, both nodes should appear on map within an hour

Troubleshooting

🆘 Help and Community

• 🗺️ ONEmesh Map - network visualization
• 💬 Telegram Group - questions, help, city coordination
• 📘 Official Meshtastic Docs
• 🐙 Firmware Repository
• 🔧 Heltec V4 Specs