Getting to Know Your Heltec WiFi LoRa 32 V4-R8 Kit — Hardware, Buttons, and Bluetooth Pairing

four labeled button icons: PWR, RST, USER and IO

We work closely with Heltec's hardware here in Taiwan, and one board that a lot of people ask us about is the WiFi LoRa 32 expansion kit, V4-R8 — the version with the 2.8" touchscreen, built-in GNSS (GPS-style positioning), and a TF (microSD) card slot. It's popular as Meshtastic hardware: flash it with Meshtastic firmware and you've got a mesh messaging/location node with an actual screen and touch input, not just a bare board.

I answer a lot of setup questions about this exact kit, and the most common one is about the buttons — so let's start there.

The four buttons, and what each one does

The board has four physical controls: PWR, RST, USER, and IO. It's easy to assume PWR and RST are your main interaction buttons and USER/IO are secondary — but it's actually the other way around for day-to-day use:

  • PWR (power) — hold for about 3 seconds to turn the device on or off. One long press, that's it — you don't need to mash it.
  • RST (reset) — resets the device. That's all it does. It won't wake a sleeping screen or do anything with the menu.
  • USER — this is your main screen button. A quick tap wakes the screen or moves between options on it. Hold it for about 2 seconds to confirm a selection or enter a menu. Hold it for about 5 seconds and the screen turns off.
  • IO — a quick tap goes back one screen. Holding it down jumps you into the "communication" page in the menu.

The question I get asked the most: "My screen went black and PWR/RST aren't doing anything — is it broken?"

No — that's actually expected behavior, and it trips people up because PWR and RST feel like the buttons that "should" do something. Here's what's really going on: the screen goes to sleep to save power, and waking it up is USER's job, not PWR's or RST's. RST only resets the whole device (which isn't what you want just to wake the screen), and PWR needs a full 3-second hold before it responds at all, so a quick tap on PWR looks like nothing happened. If your screen's gone dark, tap USER — that's the button that's supposed to bring it back.

Pairing over Bluetooth

To connect the device to the Meshtastic phone app: turn on Bluetooth on your phone, open the Meshtastic app, and let it scan for the device. You don't need to turn off Wi-Fi or mobile data first for this to work — a normal pairing doesn't require that. If you've ever had it only pair successfully after turning those off, that was most likely just a one-off hiccup on the phone's Bluetooth scan that particular time, not a real requirement — once pairing goes through cleanly, there's nothing special to keep doing there.

That covers the physical side of the kit. Next up: what you actually see on that touchscreen once it's paired — including something called MUI, and how channels and QR codes work in the Meshtastic app. That's the next post.

四個按鍵圖示,標示 PWR、RST、USER、IO

我們在台灣跟 Heltec 的硬體合作蠻密切的,其中最常被問到的一款,就是 WiFi LoRa 32 擴充套件 V4-R8——帶 2.8 吋觸控螢幕、內建 GNSS(GPS 定位)、還有 TF(microSD)卡插槽的版本。這是很受歡迎的 Meshtastic 硬體:燒進 Meshtastic 韌體之後,就是一台有螢幕、有觸控輸入的 mesh 訊息/定位節點,不只是一塊裸板。

我常常回答這套件的設定問題,最常見的一個就是按鍵怎麼用——那我們就先從這裡開始。

四顆按鍵,各自是做什麼的

板子上有四顆實體按鍵:PWR、RST、USER、IO。很容易直覺以為 PWR 跟 RST 是主要操作鍵、USER/IO 是次要的——但日常使用其實剛好相反:

  • PWR(電源鍵)——長按約 3 秒即可開機或關機。就這一個長按動作,不用連續按好幾次。
  • RST(重置鍵)——只會重置裝置,就這樣。它不會喚醒睡眠中的螢幕,也不會對選單做任何事。
  • USER——這是你螢幕操作的主要按鍵。輕按一下可以喚醒螢幕或在選項之間切換;長按約 2 秒可以確認選擇或進入選單;長按約 5 秒則會把螢幕關掉。
  • IO——輕按一下是返回上一頁;長按則會直接跳進選單裡的「通訊」頁面。

我被問最多次的問題:「螢幕黑掉了,按 PWR/RST 都沒反應,是不是壞了?」

不是——這其實是正常現象,只是因為 PWR 跟 RST 感覺上「應該」要有反應,才會讓人誤會。實際狀況是:螢幕是為了省電才進入休眠,而喚醒螢幕是 USER 的工作,不是 PWR 或 RST 的。RST 只會重置整台裝置(這不是你想要的,你只是想喚醒螢幕),PWR 則需要完整長按 3 秒才會有反應,所以隨手點一下 PWR 看起來就像沒反應一樣。如果螢幕黑掉了,按 USER——那才是負責把畫面叫回來的按鍵。

藍牙配對

要把裝置連上 Meshtastic 手機 App:手機開啟藍牙、打開 Meshtastic App,讓它搜尋裝置即可。不需要事先關閉 Wi-Fi 或行動數據,正常配對並不需要這麼做。如果你之前剛好是關掉這些之後才配對成功,那多半只是手機那次藍牙掃描剛好不順的個別狀況,不是真正的必要條件——只要配對順利完成,之後就不用特別在意這一步。

以上是套件實體操作的部分。下一篇來講配對完成後,觸控螢幕上實際會看到什麼——包括一個叫做 MUI 的東西,以及 Meshtastic App 裡的頻道跟 QR Code 是怎麼運作的。