Meshtastic 入门指南
本文档由 AI 翻译。如您发现内容有误或有改进建议,欢迎通过页面下方的评论区,或在以下 Issue 页面中告诉我们:https://github.com/Seeed-Studio/wiki-documents/issues
Meshtastic 是一个开源、离网、去中心化的网状网络,专为运行在经济实惠、低功耗设备上而设计。Seeed Studio 为爱好者和工业用户提供了一系列即插即用的 Meshtastic 设备。XIAO ESP32S3 & Wio-SX1262 套件是一个灵活的解决方案,适用于 Meshtastic 开发者和创客。
刷写固件
如果您在 2024 年 10 月 24 日之前购买了 XIAO ESP32S3 & Wio-SX1262 套件,请按照以下分步教程将固件刷写到您的设备上。
步骤 1:首先,打开浏览器并访问 https://flasher.meshtastic.org/#,需要使用 Chrome 或 Edge 浏览器。
步骤 2:然后,使用合适的 USB 数据线将设备连接到电脑。您可能需要关闭设备,然后 按住 BOOT 按钮 的同时插入 USB 数据线。
步骤 3:按照提供的说明执行后续的刷写操作。选择设备为 "Seeed XIAO S3",固件选择 最新版本,然后点击 "Flash"。如果您希望覆盖之前的固件,请记得勾选 "Full Erase and Install"。

软件概览
Meshtastic 为用户提供了多种平台软件选择,包括 Android 应用、Apple 应用和 Web 客户端。它还为开发者提供了 Python CLI、Linux Native 和集成方法。
有关具体信息,请参考 Meshtastic 官方网站。
- Android 应用: Android 应用可在 F-Droid 仓库和 Google Play 商店中获取。它允许您通过蓝牙、Wi-Fi(如果在同一网络中)或 USB On-The-Go (OTG) 从 Android 手机连接到 Meshtastic 设备。
- Apple 应用: 可在 App Store 中获取。默认情况下,iOS 的 Meshtastic 应用支持使用原生离线 Apple 地图。
- Web 客户端: Meshtastic Web 是一个直接在浏览器中运行的 Meshtastic 客户端。
- Python CLI: Python pip 包会安装一个 "meshtastic" 命令行可执行文件,用于以 JSON 格式显示网络中发送的数据包,并让您查看来自 Meshtastic 设备的串行调试信息。
- Linux Native: 借助 Portduino 框架,设备软件也可以在原生 Linux 机器上运行。
- Meshtastic 集成: Meshtastic 生态系统高度可扩展,允许轻松与许多现有软件产品和项目集成。
设备连接
在使用 Meshtastic 之前,需要先连接设备。有两种连接方法。第一种是使用扩展板,相关信息会显示在显示屏上。然后可以根据显示的信息在相应平台上进行配置。第二种是连接 XIAO 和 Wio-SX1262 模块,并使用串口工具获取节点 ID 和密码。
方法 1: 连接扩展板
在刷写固件并下载 Meshtastic 应用后,扩展板是一个很好的连接工具,并可轻松添加 Grove 传感器和模块等附加应用。
步骤 1:确保要连接的设备(例如 "device")已打开并处于可发现状态。然后在手机上打开 Meshtastic 应用。
步骤 2:在 Meshtastic 应用中,点击右下角的 "+" 图标,让应用开始扫描附近可连接的设备。然后选择 OLED 显示屏上显示的对应设备 ID。
步骤 3:正确选择后,输入 OLED 显示屏上显示的代码。按按钮切换显示内容。
按钮功能:
- 按一次切换屏幕。
- 按两次进行广播。
- 按三次切换 GPS 模式。
步骤 4:设置 LoRa 区域,然后设备将重新启动。
步骤 5:重新启动完成后,可以在 Meshtastic 应用和 OLED 显示屏上检查设备状态。
方法 2: 串口工具
选择您喜欢的串口调试工具。以下以 mac 上的 Comtool 为例。选择 串口 连接,选择 对应的端口,将波特率配置为 115200,并打开 RTS 和 DTR。打开连接后,您可以看到连接数据。 搜索 "nodenum" 以找到对应的节点 ID。其默认 密码为 123456。

节点号的最后四位数字是 Meshtastic 应用发现的设备编号 ID。例如,"nodenum 0x9e20d02c" 在 Meshtastic 中显示为 "Meshtastic_d02c"。
与 Wio Tracker T1000-E 通信
步骤 1. 按照 wiki 连接 Wio Tracker T1000-E。
步骤 2. 确保以下设置与您在 XIAO ESP32S3 上的 Meshtastic 配置相同。
- 设备激活和设置
- 确保两个设备都已打开并处于正常工作状态。
- 设备的无线通信功能(如蓝牙、LoRa 等)应已启用。检查相关设置,确保未意外关闭或限制。
距离与信号强度
- 两个设备之间的距离不能太远。根据初步测试,使用 2 dbm IPEX 天线的 XIAO ESP32S3 在 Meshtastic 中的通信距离超过 2.5 公里。一般来说,在更开阔的环境中,通信距离可以超过 20 公里。
网络设置
- 确保设备处于相同的网络模式或频道设置。可以通过 Meshtastic APP 轻松设置相同的 "lora region" 和 "Modem preset"。

步骤 3. 与 Wio Tracker T1000-E 通信
连接后,您可以通过 Meshtastic 网络开始发送和接收消息。消息可以是基于文本的,也可以根据设备和应用的功能支持其他特性。您还可以监控网络活动,查看当前连接和活动的设备。

传感器连接
在 Meshtastic 应用中,使用 XIAO ESP32S3 套件的 Wio-SX1262 支持多种传感器。当与 XIAO 扩展板结合使用时,它可以支持许多 Grove 传感器,请查看 此处。此外,与 GNSS 附加模块结合使用时,它是 Meshtastic 中最小的具有 GPS 功能的模块。
温湿度传感器
DHT20 温湿度传感器 |
---|
![]() |
步骤 1: 将 Grove DHT20 传感器连接到 XIAO 扩展板
步骤 2: 在 Meshtastic APP 中启用 Detection Sensor
GNSS 传感器
适用于 XIAO 的 L76K GNSS 模块 |
---|
![]() |
初始配置
更多详情请参考 Meshtastic。
无线电配置
Meshtastic 固件中包含多个配置部分,这些部分被分解为小型管理消息,可以通过网状网络发送。
名称 | 描述 |
---|---|
Bluetooth | 蓝牙配置选项包括:启用、配对模式和固定 PIN。 |
Channels | 频道配置选项包括:索引、角色和设置。 |
Device | 设备配置选项包括:设备角色、串口输出、调试日志和恢复出厂设置。 |
Display | 显示配置选项包括:屏幕开启时长、自动轮播间隔、始终指向北方和 GPS 格式。 |
LoRa | LoRa 配置选项包括:区域、调制解调器预设、最大跳数、发射功率、带宽、扩展因子、编码率、频率偏移、禁用发射和忽略接收数组。 |
Network | 网络配置选项包括:启用 WiFi、WiFi SSID、WiFi PSK、WiFi 模式和 NTP 服务器。 |
Position | 位置配置选项包括:启用 GPS、GPS 更新间隔、GPS 尝试时间、固定位置、智能广播、广播间隔和位置包标志。 |
Power | 电源配置选项包括:充电电流、省电模式、断电后关闭、ADC 倍增器覆盖等待蓝牙间隔、轻度睡眠间隔和最小唤醒间隔。 |
User | 用户配置选项包括:长名称、短名称和是否已授权。 |
模块配置
固件中包含模块,允许用户扩展其网状网络或设备的功能。
名称 | 描述 |
---|---|
Ambient Lighting | 调整 NCP5623 I2C RGB LED 的亮度。 |
Audio | 在某些设备上启用 Codec2 语音通信支持。 |
Canned Message | 设置预定义消息,通过旋转编码器等输入设备直接从设备发送。 |
Detection Sensor | 配置 GPIO 引脚以监控指定的高/低状态并发送文本警报。 |
External Notification | 通过连接到设备的电路(如 LED、蜂鸣器等)提醒收到的消息。 |
MQTT | 将数据包转发到 MQTT 服务器。这允许本地网状网络上的用户通过互联网与另一个网状网络上的用户通信。 |
Neighbor Info | 向网状网络发送 0 跳邻居的信息。 |
Paxcounter | 统计经过节点的 BLE 和 WiFi 设备数量。 |
Range Test | 以间隔发送带有 GPS 位置的消息,以测试设备的通信距离。需要至少一个设备设置为发送方,一个设备设置为接收方。接收方将记录所有收到的消息到 CSV 文件。 |
Remote Hardware | 通过网状网络远程设置和读取 GPIO 状态。 |
Serial Module | 通过串口发送字符串,跨网状网络发送消息。 |
Store & Forward | 在设备上存储消息,以便在断开连接的客户端重新加入网状网络后进行传递。 |
Telemetry | 将传感器连接到设备,并定期向网状网络传输读数。 |
Traceroute | 跟踪消息到达目标时使用的节点跳数。 |
技术支持与产品讨论
感谢您选择我们的产品!我们致力于为您提供多种支持,确保您使用我们的产品时体验尽可能顺畅。我们提供了多种沟通渠道,以满足不同的偏好和需求。