Skip to main content

Meshtastic 入门指南

note

当设备处于以下状态时，请不要手动重启或关闭设备。否则设备可能会损坏。

  1. 尚未完成消息传输过程
  2. 正在配置中

视频教程​

第 1 部分：开箱与设置​

第 2 部分：状态指示​

第 3 部分：刷写新固件​

note

在刷写固件之前，请确保你购买的是 T1000-E for Meshtastic。请不要将固件刷写到其他不支持 Meshtastic 的追踪器型号上。请不要使用 NRF-OTA 更新固件，否则可能导致设备完全损坏。

第 4 部分：故障排查说明​

入门​

下载 Meshtastic 应用：

打开设备电源​

短按一次按键即可打开设备电源，会有一个上升的提示音旋律，LED 指示灯会常亮约 1 秒。

tip

如果按下按键后设备没有响应，请先为其充电。不要使用快充充电器。

通过 App 连接​

  • 在蓝牙面板中选择目标设备。

pir

  • 输入配对码（默认配对码为 123456），然后点击 OK 连接设备。

pir

配置 LoRa​

为了开始在 Mesh 网络中通信，你必须设置所在区域。该设置控制设备使用的频率范围，应根据你所在的地区进行设置。

pir

区域列表

区域代码描述频率范围 (MHz)占空比 (%)功率限制 (dBm)
UNSET未设置N/AN/AN/A
US美国902.0 - 928.010030
EU_868欧盟 868MHz869.4 - 869.651027

更多完整列表请参考 按国家划分的 LoRa 区域。

info

EU_868 必须遵守每小时 10% 的占空比限制，以滚动 1 小时为周期、每分钟计算一次。当达到该限制时，你的设备将停止发射，直到再次被允许发射为止。

现在你已经在设备上设置了 LoRa 区域，可以继续配置任意适合你需求的 LoRa 配置。

高级配置​

通过网站连接​

如果你想在网站上发送文本消息并与其他节点通信，现在可以将设备连接到 Meshtastic 网站。

步骤 1：打开网站

点击这里 进入网站。

pir

步骤 2：添加新设备

点击 "+ New Connection"。

pir

有两种连接方式，你可以选择自己偏好的方式。

方法 1：通过蓝牙

选择蓝牙方式。在弹出的窗口中选择设备 ID。

pir

方法 2：通过串口

选择串口方式。打开设备管理器查看设备连接到哪个端口，然后在弹出的窗口中选择该端口。

pir

你的设备会显示在列表中。点击进行连接。如果连接成功，你可以在网站上直接看到设备状态。

pir

配置传感器​

传感器描述
Temperature✅
Light当前 App 不支持
Accelerometer敬请期待

温度传感器配置

进入 Settings -> Telemetry(Sensors) -> 启用传感器。

pir

蜂鸣器和 LED 配置

组件类型输出引脚
BuzzerPWM 蜂鸣器25
LED-24

进入 Settings -> External Notification -> 启用 GPIO -> 设置 Output Pin GPIO。

pir

更多详情请查看 External Notification Config。

tip

在你更新设备配置后，设备会重启，这可能需要一些时间。

配置铃声​

进入 Settings -> Ringtone Config，然后输入你想用于外部通知的 RTTTL 铃声字符串。

pir

24:d=16,o=5,b=120:g,c6,d6,2g6

配置 GPS​

请将 GPS 设置为启用状态。你可以调整更新间隔和广播间隔，以获取更加实时的位置数据。

pir

对于 IOS，请打开 Accurate Location。否则定位可能会有偏差。

pir

配置蜂鸣器​

蜂鸣器默认启用。如果你想禁用蜂鸣器，请将 Alert Message buzzer、Alert bell buzzer 和 Use PWM buzzer 设置为如下截图所示。

pir

烧录固件​

检查固件版本​

进入 Settings -> Firmware Updates，检查当前固件版本。

pir

⚠️请勿烧录以下固件
​

danger

请勿烧录除 T1000-E 固件以外的其他固件，否则可能导致设备死机。

以下固件会使你的设备变砖：

  • nrf52_promicro_diy_tcxo
  • nrf52_promicro_diy_xtal
  • Dongle_nRF52840-pca10059-v1
  • feather_diy
  • TWC_mesh_v4
  • wio-sdk-wm1110
  • wio-tracker-wm1110
  • xiao_ble

烧录应用固件​

note

在烧录固件之前，请确保你购买的是 T1000-E for Meshtastic。请不要将固件烧录到不支持 Meshtastic 的其他追踪器型号上。请不要使用 NRF-OTA 更新固件，否则可能导致设备完全损坏。

步骤 1：进入 DFU 模式​

访问 Meshtastic Web Flasher。

将设备连接到电脑，在设备中选择 Seeed Card Tracker T1000-E 并选择最新固件，然后点击 Flash。

pir

点击 Enter DFU Mode，会出现一个名为 T1000-E xxx 的串口，点击并连接它，绿色 LED 会常亮，并且会出现一个名为 T1000-E 的驱动器。

pir

pir

步骤 2：擦除 Flash​

note

在烧录固件之前，请先烧录擦除固件！

点击 trash 图标。

pir

下载擦除固件并复制到驱动器中。

pir

此过程可能需要一些时间，等待驱动器消失，然后打开串口监视器以完成擦除过程。

步骤 3：烧录固件​

选择最新固件，并下载 UF2 文件。

pir

将 UF2 文件复制到 DFU 驱动器中。文件复制完成并且设备重启后，固件就会被烧录。

常见问题​

如何查看设备名称​

访问 Meshtastic Web Flasher。

点击 Open Serial Monitor，将设备连接到电脑，查看串口日志，关键字为 using nodenum。

pir

pir

如何重启设备​

按住按键，然后连接充电线。

故障排查​

设备无法开机​

  • 当 LED 指示灯和蜂鸣器未激活时，设备可能看起来像是关机状态。在执行以下步骤之前，建议先 检查以下参数：

pir

  • 使用已知正常的 USB 线持续 为设备充电 1–2 小时，以确保电池有足够电量唤醒系统。
note

锂电池即使在关机状态下也会缓慢自放电。长时间闲置存放的设备可能会因此深度放电，导致无法开机或在启动过程中不断重启。这是锂电池设备的常见现象，并非 T1000-E 的缺陷。

  • 如果设备长时间闲置且无法启动，请连续充电最长可达 24 小时，然后再尝试开机。24 小时充电仅用于恢复深度放电的电池，而不是正常充电。

  • 如果在启动过程中仍然不断重启，断开电源线，让设备闲置约 7 天，然后再次充电并尝试开机。

  • 为避免深度放电，请不要在电池电量耗尽或非常低的情况下长时间存放设备；当电量低于 20% 时请及时充电，并在长期存放期间定期补电。

  • 如果设备在充电后仍无响应，请按如下步骤 执行硬重置：拔下 USB 线。按住按键，然后在保持按键按下的同时插入 USB 线。大约按住 3 秒后松开。这将强制系统复位。

  • 如果仍然无效，尝试 重新安装引导加载程序。将 USB 线连接到电脑。按住设备按键，然后将设备连接到电脑，查看电脑上是否弹出一个磁盘。如果有，请重新安装引导加载程序。

设备卡在启动循环中​

现象说明：

设备会反复重启，串口会反复连接和断开。

解决方案：

note

如果设备长时间未使用，深度放电的电池也可能导致启动过程中反复重启。在进行下面的固件恢复之前，请先尝试设备无法开机中的电池恢复步骤。

  • 步骤 1：尝试手动进入 DFU 模式：按住设备按键，然后快速连接充电线两次，绿色 LED 会常亮。
note

要成功进入 DFU 模式，需要快速完成此操作。你可能需要尝试多次。

pir

设备变砖​

现象说明​

设备无响应，没有 LED 指示灯，无法与 App 配对。

1）设备仍然可以进入 DFU 模式，则尝试烧录引导加载程序。

烧录引导加载程序​

note

在烧录引导加载程序时，请确保线缆连接稳定，并且在烧录过程中不要断开连接。

步骤 1：安装 Adafruit-nrfutil

对于 Windows 用户，同时按下 "Win" 和 "R" 键，然后在弹出的窗口中输入 "cmd" 并按下 "Enter"。这将打开命令行。

对于 Mac 用户，同时按下 "Command" 和 "Space" 键打开 Spotlight。然后输入 "terminal" 并按下 "Return"。这将打开命令行。

对于 Linux 用户，打开一个终端。在 Ubuntu 上，你可以按 Ctrl + Alt + T。使用下面的 Linux (Ubuntu/Debian) 选项卡在虚拟环境中安装先决条件和工具。

先决条件

在命令行中检查 python 和 pip 是否安装成功。在 Linux 上，请使用 python3 而不是 python 进行这些检查。

python --version
python -m pip --version

然后应该会出现 "Python xxx" 和 "pip xxx"。如果没有，请尝试重新安装 Python。

对于 Windows 和 macOS，请使用以下命令安装最新版本。Linux 用户应使用 Linux (Ubuntu/Debian) 选项卡。

pip3 install --user adafruit-nrfutil

检查安装路径：

python -m pip show adafruit-nrfutil

这是安装位置：

pir

对于 Windows 用户，您可能需要手动添加路径。复制上一步中显示的安装位置，然后按如下方式添加：

pir

步骤 2：检查你的端口号

将设备连接到电脑，并检查端口号。

对于 Windows 用户，打开设备管理器，并检查连接设备后新出现的端口号。

对于 Mac 用户，例如：

pir

对于 Windows 用户，例如：

pir

对于 Linux 用户：

使用上文所述按键和数据线操作将 T1000-E 置于 DFU 模式。绿色 LED 应保持常亮。分别在连接设备前后运行以下命令，以识别其串口：

python -m serial.tools.list_ports -v

使用新出现的端口，通常为 /dev/ttyACM0。如果列出了多个端口，请对比 T1000-E 断开和连接时的结果。设备进入 DFU 模式时端口号可能会改变，因此在烧录前请再次检查。

检查端口权限，将 /dev/ttyACM0 替换为你的实际端口：

ls -l /dev/ttyACM0

在 Ubuntu/Debian 上，串口通常归属于 dialout 组。如果你收到 Permission denied 错误，并且该端口属于 dialout，请将你的用户添加到该组：

sudo usermod -aG dialout "$USER"

注销并重新登录以使组更改生效，然后重新打开终端并再次激活虚拟环境。在其他发行版上，请使用 ls -l 显示的串口访问组，并按照发行版的说明进行操作。

步骤 3：烧录 Bootloader

在终端或命令提示符中，导航到你下载的 bootloader 压缩包所在目录，并执行以下命令，将端口替换为你设备的正确端口：

--touch 1200 会以 1200 波特率打开并关闭串口，以在上传前请求 DFU 模式。如果设备已经处于绿色 LED 常亮的 DFU 模式，请省略 --touch 1200，并使用其当前的 DFU 串口。

  • 对于 Windows：
adafruit-nrfutil --verbose dfu serial --package t1000_e_bootloader-0.9.1-5-g488711a_s140_7.3.0.zip -p COMxx -b 115200 --singlebank --touch 1200

请将 COMxx 更改为你的 COM 端口号。例如，如果你的设备在 com6 上，请将命令更改为：

adafruit-nrfutil --verbose dfu serial --package t1000_e_bootloader-0.9.1-5-g488711a_s140_7.3.0.zip -p **COM6** -b 115200 --singlebank --touch 1200

如果在此命令之后串口发生变化，请按照下面的步骤 4 操作。

  • 对于 macOS：
adafruit-nrfutil --verbose dfu serial --package t1000_e_bootloader-0.9.1-5-g488711a_s140_7.3.0.zip -p /dev/tty.SLAB_USBtoUART -b 115200 --singlebank --touch 1200
  • 对于 Linux：

保持下载的 bootloader 包为 .zip 文件，不要解压。在已激活虚拟环境的终端中，导航到包含该压缩包的文件夹。关闭任何连接到设备的串口监视器或浏览器烧录工具。由于步骤 2 已手动将设备置于 DFU 模式，请在命令中去掉 --touch 1200：

adafruit-nrfutil --verbose dfu serial --package t1000_e_bootloader-0.9.1-5-g488711a_s140_7.3.0.zip -p /dev/ttyACM0 -b 115200 --singlebank

将 /dev/ttyACM0 替换为在步骤 2 中识别到的端口。如果设备仍在运行应用固件并具有串口，你可以追加 --touch 1200 以请求 DFU 模式。如果它没有响应，请按住设备按键，然后如上所示快速连接充电线两次。一旦绿色 LED 保持常亮，再次识别 DFU 端口，并在命令中不使用 --touch 1200。

步骤 4：处理串口变化

当 --touch 1200 将设备切换到 DFU 模式时，操作系统可能会分配一个不同的串口。如果命令报告 Touched serial port，随后出现找不到端口的错误，请检查是否出现了新的 DFU 端口。仅凭此错误并不能说明 bootloader 已成功烧录或设备已损坏。

保持 USB 线连接。在 Linux 上，在已激活的虚拟环境中再次运行以下命令：

python -m serial.tools.list_ports -v

在 Windows 上，刷新设备管理器；在 macOS 上，检查 ls /dev/cu.*。使用新识别到的端口重试，并且省略 --touch 1200，因为设备已经处于 DFU 模式。例如，如果新的 Linux 端口是 /dev/ttyACM1：

adafruit-nrfutil --verbose dfu serial --package t1000_e_bootloader-0.9.1-5-g488711a_s140_7.3.0.zip -p /dev/ttyACM1 -b 115200 --singlebank

请使用你的实际端口名。如果端口仍然无法打开，请按照步骤 2 中的说明检查其权限，并确保没有串口监视器或浏览器烧录工具正在使用它。

步骤 5：确认结果并重新安装应用固件

等待工具完成并打印：

Device programmed.

此消息确认 bootloader 传输已成功完成。请勿在传输过程中断开数据线。仅凭端口变化或出现一个 USB 驱动器，并不能确认烧录成功。

pir

烧录 bootloader 并不会重新安装 Meshtastic 应用固件。传输成功后，请按照 Flash Firmware 进行固件烧录，然后再使用设备。

2）设备无法进入 DFU 模式，但可以检测到串口。

  • 打开一个串口工具

  • 将波特率设置为 1200。

  • 连接设备。 当你连接设备时，指示灯会短暂闪烁。持续尝试此操作，直到指示灯保持常亮，这意味着设备已回到 DFU 模式，然后按顺序执行 flash bootloader -> Erase flash -> flash the firmware。

3）设备无法进入 DFU 模式且没有串口显示

  • 按住设备按键，然后连接充电线。当电脑中弹出一个磁盘后，你可能会看到串口。

  • 如果仍然不行，请断开充电线，将设备放置几天直到电池完全耗尽，然后连接充电线并尝试重新配对。

4）如果以上步骤都无效，请联系技术支持：[email protected]

固件烧录失败​

  • 串口未接收到数据

pir

检查设备是否处于 DFU 模式，当设备处于 DFU 模式时，绿色指示灯会常亮。

  • 无法打开串口

pir

检查端口是否正确，或者尝试使用其他端口。

无法在主信道上通信​

如果设备无法与附近节点通信或发送消息，首先检查 LoRa 区域和调制解调器预设是否与周围节点匹配。你还应该检查默认的 PSK 是否被更改。在主信道上使用不同的 PSK 会阻止设备与该信道上的其他节点通信。

最简单的排查方式是通过手机应用。打开应用，连接到目标设备，然后进入 Settings -> Channels。选择主信道并检查 PSK 值。如果它与周围节点不同，请将其更新为相同的 PSK 并保存信道设置。

Check primary channel PSK in the iOS app

解决方案

如果你不确定修改了哪些设置，请按照 Factory Reset 指南将设备恢复到默认设置。如果只更改了 PSK，请将其重新设置为 AQ==。

设备自动关机​

描述​

  • 设备开机后，过一段时间会自动关机或重启。
  • 串口日志运行一段时间后停止。

这可能是由于在设备处于以下状态时，手动强制重启或关机导致的：尚未完成消息发送过程、正在配置等。

故障排查​

点击此处 执行 flash-erase。

恢复出厂设置​

如果你想恢复到默认设置，可以执行出厂重置。你可以通过两种方法进行出厂重置。

  • 点击此处 对设备进行 flash 擦除。然后重新烧录最新固件。

  • 在 App 上点击 Factory Reset 按钮。设备将自动以出厂配置重启。

    pir

消息通信失败​

NodeDB 重置​

NodeDB 是本地数据库，用于存储当前 Mesh 网络中已发现节点的信息。如果你遇到无法与某个节点通信的情况，可能是因为你的 NodeDB 中存储了该节点的过时信息，你需要对其进行更新。

打开应用并连接到目标设备。进入 Settings->Device->Device Config->Reset NodeDB。

Device settings and Reset NodeDB button in the app

交换用户信息​

每个节点都会周期性地发送自己的节点信息，使 Mesh 中的其他节点能够“看到”和“识别”它。两个节点需要互相交换各自的节点信息，才能彼此通信。如果你无法与列表中的某个节点发送或接收私信，可以在应用中手动提示它们交换信息。

Device entry in Settings

重新生成私钥​

每个节点都拥有一对公钥/私钥。要交换加密的私信，发送方会使用接收方的公钥对消息进行加密，只有该接收方的私钥才能对其解密。因此，一旦两个节点互相知道对方的公钥，就可以进行私密通信。如果某个节点在私信传输中持续失败，请尝试重新生成它的私钥。重新生成后，从其他设备的节点列表中删除该节点，以便它们重新连接并获取该节点的新公钥。

Device entry in Settings

重启故障设备以使配置生效。密钥重新生成后，其他设备需要重新与该节点连接，因此最好从其他设备的节点列表中删除该节点。

note

有关与其他 LoRa 芯片通信的更多信息，请参考：link

信号质量​

  • SNR 反映通信链路的质量。正常设备通常在 -7 dB 以上工作。SNR 低于 -10 dB 的设备表示性能较差。

  • RSSI 由设备及其周围环境共同决定。正常设备通常在 -110 dBm 以上工作。RSSI 低于 -115 dBm 的设备被认为性能较差。

    为获得最佳信号效果，请在开阔、无遮挡且干扰较小的环境中使用设备。

弹簧针定义​

pir

资源​

技术支持与产品讨论​

Loading Comments...