RAK6421 WisMesh Pi HAT: start from zero

Absolute beginner guide • RAK6421 • Raspberry Pi • Meshtastic

This guide assumes you have never built a Raspberry Pi Meshtastic node before. We will go from loose parts to a working Linux-native Meshtastic node without assuming you know SPI, HAT EEPROMs, meshtasticd, or Linux.

Start the setup Back to Raspberry Pi Mesh Lab

⚠️ CONNECT THE LORA ANTENNA BEFORE POWERING THE PI.

RAK's quickstart explicitly warns to attach the LoRa antenna before power. Do not power a LoRa radio module with no antenna attached.

Standard radio

RAK13300 — SX1262, normal-power Meshtastic radio.

High-power radio

RAK13302 — SX1262 plus 1 W amplifier, intended for fixed infrastructure and backbone-style builds.

Host computer

RAK currently documents Raspberry Pi 4 and Raspberry Pi 5 for this setup.

Best beginner path: use RAKwireless' official Raspberry Pi image. It already includes and configures meshtasticd for the RAK6421. Manual Raspberry Pi OS installation is an advanced alternative.

Parts checklist

WHAT YOU NEED ON THE TABLE.

Raspberry Pi 4 or 5

The Linux computer that runs Meshtastic.

RAK6421 WisMesh Pi HAT

Mounts to the Pi's 40-pin header.

RAK13300 or RAK13302

You need one LoRa radio module. The bare HAT by itself is not the radio.

Correct LoRa antenna

For U.S. use, choose the correct 902–928 MHz hardware/antenna combination.

microSD card

Holds the Raspberry Pi image and software.

Optional GPS / sensors

RAK12501 GPS and supported WisBlock sensors can be added later. Keep the first build simple.

INSTALL THE RADIO MODULE ON THE HAT.

With everything powered off, install either the RAK13300 or RAK13302 in one of the HAT's IO slots and secure it correctly. RAK says to mount modules and sensors to the HAT first, with the Raspberry Pi unplugged.

If you have a RAK12501 GPS or environmental sensor, you can install it now, but beginners are better off proving the radio works before adding extras.

MOUNT THE HAT ON THE RASPBERRY PI.

Line up the RAK6421 with the Pi's 40-pin GPIO header. Use proper spacers/standoffs so the boards stay aligned and do not flex into each other.

Still no power yet. Attach the LoRa antenna now.

FLASH RAK'S RECOMMENDED IMAGE.

RAK's current quickstart recommends its dedicated Raspberry Pi Meshtastic image because it already includes meshtasticd and the RAK6421 hardware support.

Open current RAK quickstart ↗

Use the current image link from RAK's documentation rather than an old download from a forum or video.

INSERT THE SD CARD AND POWER ON.

Insert the flashed microSD card, confirm the LoRa antenna is connected, then power the Raspberry Pi.

The RAK6421 has an onboard HAT EEPROM so meshtasticd can automatically identify the HAT hardware. On RAK's official image, the needed EEPROM detection setting is already enabled.

FIND YOUR PI'S IP ADDRESS.

Look in your router's connected-device/DHCP list. Or, if you have a monitor and keyboard attached to the Pi, open Terminal and run:

hostname -I

You'll get an address similar to 192.168.1.100.

OPEN THE MESHTASTIC WEB CLIENT.

On a phone or computer connected to the same local network, open:

https://YOUR-PI-IP:9443

Example:

https://192.168.1.100:9443

Choose + New Connection, choose HTTP, enter the Pi address with port 9443, and connect.

VERIFY THE RADIO CONFIGURATION.

Go to Config → Radio Config → LoRa. Confirm the correct radio region for where the node is physically operating.

United States: use the legal U.S. region setting. Do not blindly copy a region from somebody else's screenshot.

Set a useful node name, save, and allow the service/device to restart if prompted.

SEND A MESSAGE AND PROVE THE BASIC NODE WORKS.

Before installing MQTT, Node-RED, Grafana, GPS, sensors, or anything else, prove the basic radio works. Confirm you can see nearby nodes and send/receive a message.

That is your first milestone. Once basic Meshtastic works, then add the fancy stuff one feature at a time.

Optional hardware

WHAT THE EXTRA SLOTS ARE FOR.

IO slots 1 & 2

LoRa radio modules such as RAK13300 or RAK13302.

Sensor slot A

Large slot used by the RAK12501 GNSS/GPS module.

Sensor slots B/C/D

Used by supported environmental, RTC, light, pressure and other WisBlock sensors.

Troubleshooting

IF IT DOESN'T WORK, CHECK THESE FIRST.

The web page at :9443 does not open

Verify the Pi's IP address, make sure your phone/computer is on the same LAN, and confirm the Raspberry Pi actually finished booting.

The HAT or radio is not detected

Power down fully. Reseat the RAK6421 on the 40-pin header and reseat the RAK13300/RAK13302 in the proper IO slot. If you built your own Raspberry Pi image instead of using RAK's image, HAT EEPROM detection must be enabled with I2C-0 settings documented by RAK.

I built my own Raspberry Pi OS image

This is the advanced path. RAK documents enabling HAT EEPROM discovery in /boot/firmware/config.txt using dtparam=i2c_vc=on and dtoverlay=i2c0, followed by a reboot, then installing/configuring meshtasticd manually.

GPS is installed but not working

RAK's current helper scripts use /dev/ttyS0 for Raspberry Pi 4 and /dev/ttyAMA0 for Raspberry Pi 5. Get basic radio operation working first, then troubleshoot GPS separately.

I am using the 1 W RAK13302

Treat it as fixed high-power infrastructure. Use the correct antenna, feedline and legal regional settings, and verify local RF requirements before deployment.

Advanced — optional

ONLY AFTER THE RADIO WORKS.

RAK also documents an optional stack with Mosquitto MQTT, InfluxDB, Node-RED and Grafana for dashboards and historical telemetry. Their current guide provides installation scripts for that workflow.

MQTT

Forward and integrate Meshtastic data.

Node-RED

Build automation and processing flows.

Grafana + InfluxDB

Store and graph telemetry/history.

Project documentation

Hardware revisions and software screens can change. Use the original project documentation alongside this walkthrough.

Open the original documentation →