DIY Meshtastic 裝置! 使用 Faketec v5 + Ra-01SH-P 模組

前陣子被朋友推坑使用 Heltec v3 進了 Meshtastic 的坑，後來發現可以自己洗 PCB 板子來 DIY，手癢就開始搞事了。

Faketec v5 板子送洗?

目前社群大多使用 JLCPCB 送洗，洗板子的細節可以參考社群內大佬寫的筆記:

由於一次洗的量比較大，懶得洗的同學可以關注 FB 社群 Meshtastic Taiwan Community 臺灣鏈網時不時會有人開團洗板子。

零件怎麼買?

大多數的零件還是要從淘寶來，以下使我所購買的零件清單:

Promicro NRF52840开发板兼容nice!nano V2.0 带蓝牙充电管理
XB8089D0
1206 電阻
- 1206 1%（100个）阻值：10M
- 1206 1%（100个）阻值：1K
- 1206 1%（100个）阻值：10K
1206 電容
- 100NF 0.1UF 104K 10%电压：10V封装规格：1206=50个
SI2312选择货种：台产芯片
LoRa 模組
- 初階：沒有經驗的同學直接買 HT-RA62 會比較省事，不需要改 PCB 板、也不需要刷特別版的韌體，可以直接使用官網的 DIY Promicro 韌體：HT-RA62 - 863-928mhz。
- ※ 進階：如果想要功率放大器可以選擇 Ra-01SH-P，本篇就是用這片當範例，但 比較麻煩且需要刷客製化的韌體：Ra-01SH-P。
JST1.25
SMD 按鈕: 3x4x2.5：其實 Faketec v5 的 BOM 清單中的 3x6x2.5 是錯的因為我就照著買錯了，但其實一樣是可以焊上去的：

天線、轉接頭

【胶棒天线】TX915-JKD-20 - 亿佰特915MHz胶棒电路板天线全向高增益SMA接口数传无线模块专用
uf.l转sma跳线ipex ipxrg178网卡
- 颜色分类：母头内孔接口：1代IPEX线长：10CM

開始焊接之前

使用模組 RA-01-SH-P 需要注意：

ProMicro 先更新 Bootloader：新的板子直接接上PC，只需要拉 update-nice_nano_bootloader-0.9.2_nosd.uf2 進去會瞬間退出再出現，打開 INFO_UF2.txt 確認版本為 0.9.2 即可。
安裝 Meshtastic 韌體: 我使用版友編譯的 限制 3dbm 功率版本安裝參考這篇 的刷機章節，也是直接拖 firmware.uf2 進去就會更新了。
ProMicro 先裸板不要焊接直接開機，掃社團內的 QR Code 設定頻道:
藍芽連線密碼 123456 修改功率為 3dbm 避免把功率放大器燒壞 (如果是使用 板友編譯的版本就會鎖 3dbm)
將 v5 板子的 DIO2、RXEN 用綠油或耐高溫膠帶蓋起來

v5 板子的線路 VCCPA 是與 DIO2 對接的，而預設 3.3v 29dbm 版本的 RA-01-SH-P 模組的 VCCPA 內是沒有接任何東西的，所以其實可以不用絕緣 DIO2；但如果買到 5v 版本就需要拉 5v 供電到 VCCPA，所以建議可以先絕緣 DIO2 或 VCCPA避免買到特殊 31dbm 版本 (模組內 VCCPA 未懸空) 的模組而造成異常。

RXEN 高電位才會啟動，放大器 (PA) 預設就是打開的，接了反而 PA 會因為 RXEN 低電位會被關掉放大器 (PA) 。

經測試，長訊息會斷掉的問題目前未發現，最後附上 RA-01SH-P 的最新的文件

焊接過程我有記錄下來：

編譯韌體

可以使用以下指令在 Linux 環境進行編譯

# Ubuntu 24.04:
# sudo apt update && sudo apt install python3.12-venv
curl -fsSL -o get-platformio.py https://raw.githubusercontent.com/platformio/platformio-core-installer/master/get-platformio.py
python3 get-platformio.py
echo "export PATH=$PATH:$HOME/.platformio/penv/bin/" >> ~/.bashrc
source ~/.bashrc

# git clone https://github.com/Bu1227/faketec-RA-01SH-P.git
# cd faketec-RA-01SH-P
git clone https://github.com/meshtastic/firmware.git
cd firmware && git submodule update --init

# 限制功率至 3dbm 避免燒壞功率放大器 (PA)
sed -i.bak 's/\(RDEF([^,]*, [^,]*, [^,]*, [^,]*, [^,]*,\) [0-9]\+\(,\)/\1 3\2/g' src/mesh/RadioInterface.cpp
sed -i.bak '/SX126X_MAX_POWER/a\
// RA-01SH-P 需要限制 SX1262 功率為3dbm，如果使用無 PA 功率放大器就不需要限制功率\
// Datasheet: https://web.archive.org/web/20250828015915/https://aithinker-static.oss-cn-shenzhen.aliyuncs.com/docs/Specification/Ra-01SH-P_V1.0.3_Specification_cn_20250827.pdf\
#define SX126X_MAX_POWER 3
' variants/nrf52840/diy/nrf52_promicro_diy_tcxo/variant.h

# 開始編譯，-j 指定 CPU 核心數可以加速
pio run -e nrf52_promicro_diy_tcxo -j 4

# 完成後東西會在 .pio/build/nrf52_promicro_diy_tcxo/
ls .pio/build/nrf52_promicro_diy_tcxo/firmware*
.pio/build/nrf52_promicro_diy_tcxo/firmware-nrf52_promicro_diy_tcxo-2.7.19.2361776.elf      .pio/build/nrf52_promicro_diy_tcxo/firmware-nrf52_promicro_diy_tcxo-2.7.19.2361776.uf2
.pio/build/nrf52_promicro_diy_tcxo/firmware-nrf52_promicro_diy_tcxo-2.7.19.2361776.hex      .pio/build/nrf52_promicro_diy_tcxo/firmware-nrf52_promicro_diy_tcxo-2.7.19.2361776.zip
.pio/build/nrf52_promicro_diy_tcxo/firmware-nrf52_promicro_diy_tcxo-2.7.19.2361776.mt.json

這邊我也提供 2026-02-06 編譯好的韌體給有需要的同學：

firmware-nrf52_promicro_diy_tcxo-2.7.19.2361776.uf2
- md5sum: e1e361d7806a4378b71d7949e17f17a4)

如何更新？

將板子接上 PC 在 0.5 秒內按兩下 RST 鈕就可以進入 DFU 模式。
此時 PC 會跳一個新磁碟裝置出來。
直接將 .uf2 檔案拖進去即可。
完成後會磁碟消失並重新開機。
檢查一下 Meshtastic APP 有無成功連上。