Meshtastic 完全指南：离网 Mesh 通信

1
2
3
4
5
6
7
8
9

# 安装 Python（需 3.9+）并安装 meshtastic CLI
pip install meshtastic

# 查看已连接设备
meshtastic --info

# 刷入固件（需下载 .bin 文件）
pip install esptool
esptool --port /dev/ttyUSB0 write_flash 0x0 firmware.bin

1
2
3
4
5
6

# 中国大陆用户注意：
# 中国 ISM 频段主要为 470‑510 MHz 或部分 920‑925 MHz
# 需要确认当地无线电管理规定

# 通过 CLI 设置区域
meshtastic --set lora.region CN   # 或 AS（Asia）

1
2

# 设置频道名称和 PSK（预共享密钥）
meshtastic --ch-set name "MyMesh" --ch-set psk "your-secret-key" --ch-index 0

1
2

meshtastic --set device.device_id "my-node-01"
meshtastic --set owner "你的呼号或名称"

1
2
3
4
5
6

# 设备角色
meshtastic --set device.role CLIENT          # 普通客户端（默认）
meshtastic --set device.role CLIENT_MUTE     # 客户端但不中继
meshtastic --set device.role ROUTER          # 中继节点（适合固定部署）
meshtastic --set device.role ROUTER_CLIENT   # 兼具中继与收发
meshtastic --set device.role REPEATER        # 纯中继，省电

1
2
3
4
5
6
7
8

# 设置 Wi‑Fi
meshtastic --set wifi.ssid "YourWiFi" --set wifi.password "YourPassword"

# 设置 MQTT（可选，用于将消息转发到互联网）
meshtastic --set mqtt.enabled true
meshtastic --set mqtt.address "mqtt.meshtastic.org"
meshtastic --set mqtt.username "meshdev"
meshtastic --set mqtt.password "large4cats"

1
2
3

meshtastic --set mqtt.enabled true
meshtastic --set mqtt.address "mqtt.meshtastic.org"
meshtastic --set mqtt.json_enabled true

1
2
3
4
5

docker run -it -p 1883:1883 -p 9001:9001 \
  -v /mosquitto/config:/mosquitto/config \
  -v /mosquitto/data:/mosquitto/data \
  -v /mosquitto/log:/mosquitto/log \
  eclipse-mosquitto

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

import meshtastic
import meshtastic.serial_interface

iface = meshtastic.serial_interface.SerialInterface("/dev/ttyUSB0")
iface.sendText("Hello Mesh!")

def onReceive(packet, interface):
    print(f"Received: {packet}")

iface.onReceive = onReceive

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# 查看设备信息
meshtastic --info

# 设置设备名称
meshtastic --set owner "MyNode"

# 设置角色
meshtastic --set device.role ROUTER

# 设置区域
meshtastic --set lora.region CN

# 设置发射功率（dBm）
meshtastic --set lora.tx_power 20

# 发送消息
meshtastic --sendtext "Hello World"

# 发送给特定节点
meshtastic --dest '!abcdef12' --sendtext "Private msg"

# 查看节点列表
meshtastic --nodes

# 重置设备
meshtastic --set factory_reset true

# 导出配置
meshtastic --export-config > config.yaml

# 导入配置
meshtastic --configure config.yaml

# 设置 Wi‑Fi
meshtastic --set wifi.ssid "MyWiFi" --set wifi.password "pass123"

# 开启/关闭 GPS
meshtastic --set position.gps_enabled true

1
2
3
4
5
6
7
8

1. 购买硬件：至少 2 块 Heltec V3 或 T‑Beam（约 ¥60–180/块）  
2. 准备 USB‑C 数据线 + 电脑（Chrome 浏览器）  
3. 访问 https://flasher.meshtastic.org 烧录固件  
4. 手机安装 Meshtastic App（Android / iOS）  
5. 蓝牙连接设备  
6. 设置区域、频道、设备名称  
7. 两台设备互相看到 → 成功组网  
8. 发送第一条 Mesh 消息