Skip to main content

Meshtastic 入门指南

SenseCAP MeshPager X2 系列通过物理按键操作两个 Meshtastic 界面:MUI(带有图形页面和地图)和 Base UI(信息屏幕和菜单)。

有关规格、连接器和引脚分配,请参阅 SenseCAP MeshPager X2 系列简介。

上电前

连接与工作频段匹配的 LoRa 天线。使用指定的 X2 电池,其额定充电电压为 4.4 V;额定最大充电电压为 4.2 V 的电芯不适用。

刷写固件​

如果已安装固件,请继续阅读 入门指南。

  1. 使用 USB 数据线将 X2 连接到电脑。
  2. 在支持 Web Serial 的浏览器(如桌面版 Chrome 或 Edge)中打开 Meshtastic Web Flasher。
  3. 打开 Select Target Device,查找 Seeed MeshPager X2。如果可用,选择它并选择兼容的固件版本。
  4. 点击 Flash,并按照提示进入下载模式并选择 X2 当前的 USB 端口。在编程完成前保持 USB 连接。
如果列表中没有 X2

在编写本指南时,公共 Web Flasher 的设备列表中尚未包含 X2。如果你找不到 Seeed MeshPager X2,请使用 X2 出厂镜像并按照使用 esptool 手动安装固件操作。不要为 X2 选择其他设备型号。

要强制 X2 进入固件刷写模式,同时按住 Power 和 Return 键,然后插入 USB 线。保持两个按键按下 1 秒 后再松开。

要刷写已下载的 X2 .factory.bin,请参阅使用 esptool 手动安装固件。

仅使用 X2 固件

使用 Seeed MeshPager X2(seeed_meshpager_x2)的固件,并遵循镜像附带的说明。仅在需要时启用完全擦除,并先备份你的设置。

入门指南​

开机与导航​

  1. 将稳压的 5 V USB 电源连接到 USB-C 接口为电池充电。
  2. 使用 Power 键启动 X2。要离开仅充电界面,先松开 Power,然后再次按住约 5 秒。
  3. 等待 Base UI 或 MUI 加载完成。

在连接 USB 的情况下关机,可能会使 X2 返回到仅充电界面。

强制重启​

要强制 X2 重启,按下 Power 并同时插入已供电的 USB-C(Type-C)线缆。

按键控制​

按键Base UIMUI
上 / 下浏览菜单项、节点或消息线程。从主界面进入消息编辑器。高亮导航图标或控件。
左 / 右切换信息屏幕或在键盘按键之间移动。右键进入高亮页面。在页面内切换选项卡、调节滑块或在键盘按键之间移动。
确认(左侧橙色键)打开当前屏幕的菜单或选择项目。激活高亮项目。
长按确认在支持的情况下,运行所选控件的长按操作。在支持的情况下,运行所选控件的长按操作。
返回取消输入或关闭菜单。关闭键盘、列表或对话框,或返回上一级。
电源短按:熄屏/唤醒。长按约 4 秒:关机。短按:熄屏/唤醒。长按约 4 秒:关机。

在本指南中,选择指使用方向键高亮某个项目并按下 Confirm。Confirm 是屏幕左下方带有水平线标记的橙色按键。Left/Right 指方向键盘上的左右方向。

UI 切换​

在下方选择切换方向。无需重新刷写固件。

Close-up of MeshPager X2 Base UI showing battery, node, satellite, and channel-utilization information
Base UI — 信息屏幕和菜单。
Close-up of MeshPager X2 MUI showing the Home page and navigation icons along the left edge
MUI — 图形页面和地图。
  1. 使用 Left/Right 到达 System,然后按 Confirm。
  2. 选择 Reboot/Shutdown → Switch to MUI → Yes。
  3. 等待 X2 重启进入 MUI。
Base UI 到 MUI。视频在重启过程中结束。

手机连接​

步骤 1. 在 X2 上启用蓝牙。

从 MUI 切换后会自动启用蓝牙。要手动启用,在 System 中按 Confirm,并选择 Bluetooth Toggle。如有重启提示,请按提示重启。如果 Wi-Fi 阻止蓝牙配对,请先关闭 Wi-Fi。

X2 Base UI Home screen with BT off and the example node name outlined in red
1. 检查蓝牙状态。 BT off 表示蓝牙已禁用。此处显示的节点名称仅为示例;请在应用中查找你自己的 X2。
X2 Base UI System Action menu with Bluetooth Toggle and the left orange Confirm key outlined in red
2. 启用蓝牙。 在 System 屏幕上按 Confirm,选择 Bluetooth Toggle,并按照任何重启提示操作。

步骤 2. 下载 Meshtastic App

Click here 下载适用于 iOS 或 Android 的 Meshtastic 应用。

步骤 3. 与设备配对

在手机上启用蓝牙,打开 Meshtastic 应用,并授予请求的蓝牙或附近设备权限。下方截图展示了应用的操作流程;从列表中选择你的 X2 设备名称。

  1. 在 Meshtastic 应用中打开 Bluetooth 面板,并在 Available Radios 下选择你的 X2。
Meshtastic iOS app Bluetooth panel with an example radio highlighted under Available Radios
  1. 输入 X2 屏幕上显示的代码,然后点击 Pair 进行连接。如果你配置了固定 PIN,请使用该 PIN。
iOS Bluetooth pairing request showing the PIN entry field and Pair button

在更改设置之前,请等待设备配置加载完成。

配置 LoRa​

在通过 Mesh 通信之前,先设置你的 区域。该设置控制设备使用的频率范围,并且应与你所在位置、X2 的 863–928 MHz 射频硬件以及其天线相匹配。

区域列表

Region CodeDescriptionFrequency Range (MHz)Duty Cycle (%)Power Limit (dBm)
UNSET未设置N/AN/AN/A
US美国902.0 - 928.010030
EU_868欧盟 868MHz869.4 - 869.651027

更完整的列表请参考 LoRa Region by Country。上表中的功率限制是 Meshtastic 区域限制;X2 的实际发射功率还取决于其硬件和固件。

EU_868 占空比

EU_868 具有 10% 占空比限制,按滚动一小时、每分钟计算。如果设备达到该限制,它会停止发射,直到再次允许发射。

  1. 使用左/右键进入 LoRa,然后按确认键。
  2. 选择 LoRa Region,选择你的区域,并确认所有提示。
X2 Base UI LoRa Actions menu with LoRa Region and the Confirm key outlined in red
打开区域设置。 选择 LoRa Region,然后在下一屏中选择你所在位置的区域。
X2 Base UI LoRa Info screen showing the example US region, LongTurbo preset, frequency, and a BLE identifier
检查当前配置。 LoRa Info 显示区域、调制解调器预设和频率。本示例使用 US / LongTurbo;请使用适合你所在位置和群组的设置。

LoRa Info 中的四字符 BLE 标签是设备标识符,而不是蓝牙配对 PIN。配对时,请使用 X2 配对提示中显示的 PIN 或你配置的固定 PIN。

要与其他节点通信,需要匹配它们的 调制解调器预设、频率槽、频道名称和预共享密钥。你可以在手机应用中配置这些设置,或导入你所在群组的频道配置。

发射功率和占空比设置必须符合当地法规。详情请参阅 Meshtastic LoRa configuration。

地图使用​

使用 MUI 查看地图。要显示当前位置,请启用 GPS 并在室外等待定位完成;参见 Configure GPS。

离线地图需要 MUI 和一张 microSD 卡。

步骤 1. 准备存储卡。

  1. 在格式化前先备份存储卡;格式化会清除其内容。使用 MBR 分区和 FAT32 来准备存储卡。
  2. 从 Meshtastic UI map starter kit 下载一个样式 ZIP,例如 osm.zip 或 atlas.zip。
  3. 将压缩包解压到存储卡根目录,保留其中的文件夹结构。检查最终路径,而不是在解压文件外再添加一层 maps 文件夹:
microSD root/
└── maps/
└── <style>/
└── <zoom>/
└── <x>/
└── <y>.png

例如,名为 osm 的样式应位于 /maps/osm/ 下。避免出现类似 /maps/maps/osm/ 这样的额外文件夹层级。

  1. 复制完成后安全弹出存储卡。
从概览地图开始

官方入门套件压缩包包含 缩放级别 1–6 的全球瓦片。将地图缩小到 6 级或更低,以检查地图是否加载。若需街道级细节,请下载覆盖你所在区域的更高缩放级别瓦片;仅靠入门套件并不包含这些细节。参见 map download instructions。

步骤 2. 插入存储卡并打开地图。

MeshPager X2 microSD card slot with the outer cover removed
X2 microSD 卡槽。
  1. 在插入或取出卡之前,先关闭 X2 并断开 USB 连接。
  2. 完全插入 microSD 卡,然后启动 X2 并进入 MUI。
  3. 针对你当前的位置,启用 GNSS,并在室外等待定位成功。
  4. 进入 Map 并选择与你瓦片匹配的样式。

已下载的瓦片在没有 Wi-Fi 或蜂窝网络服务时也能使用。

MeshPager X2 MUI Locations Map showing street tiles, location markers, zoom buttons, and navigation controls
带有位置标记、缩放和导航控件的 MUI 地图。

步骤 3. 使用按键导航。

地图状态操作
浏览使用方向键平移。
打开控件按 Confirm。
缩放或定位使用 Up/Down 高亮某个控件,然后按 Confirm。
返回地图按 Return。
返回导航栏再次按 Return。

发送和阅读消息​

撰写消息

  1. 使用 Left/Right 切换到 Home 信息屏幕。
  2. 按 Up 或 Down 打开消息编辑器。
  3. 选择 [Select Destination],然后选择一个频道或节点。
  4. 选择一条预设消息即可发送,或选择 [-- Free Text --] 打开键盘。
  5. 使用方向键和 Confirm 输入字符。使用键盘上的退格键删除。
  6. 选择键盘上的 Enter 键发送。Return 取消输入。

你也可以在 Messages 屏幕中打开编辑器:按 Confirm 并在 Message Action 菜单中选择 New Preset Msg。在选择预设消息或输入自由文本前,请先检查目标地址。

X2 Base UI Message Action menu with New Preset Msg and the Confirm key outlined in red
打开消息编辑器。 在 Messages 中,按 Confirm 并选择 New Preset Msg。选择目标地址和一条预设消息,或选择 Free Text 打开键盘。
X2 Base UI free-text keyboard with the character keys and ENTER outlined in red, addressed to the example LongTurbo channel
输入并发送。 检查 To: 旁边的收件人,使用方向键和 Confirm 输入,然后选择 ENTER 发送。LongTurbo 是示例目标频道。

如果编辑器不可用,请在手机应用中启用 Canned Message 模块,并使用支持屏幕键盘的固件。

MeshPager X2 Base UI showing the Message sent to LongFast confirmation
Base UI:消息已发送到 LongFast 频道。

阅读消息

使用 Left/Right 切换到消息屏幕,使用 Up/Down 浏览会话线程,并按 Confirm 打开会话操作。

直接消息需要设备先交换节点信息和公钥。

高级用法​

通过网站连接​

使用 Meshtastic Web Client 从浏览器读取消息、发送文本并配置你的节点。使用桌面版 Chrome 或 Edge,并确保固件支持所选连接方式。浏览器支持情况各不相同;请参阅 Web Client compatibility guide。

步骤 1. 打开 Web Client。

Meshtastic Web Client landing page

步骤 2. 添加连接。 选择 New Connection。截图展示的是客户端的操作流程;设备名称和端口号仅为示例。连接时请选择你自己的 X2。

New Connection button in the Meshtastic Web Client

步骤 3. 选择连接方式。

  1. 在 X2 上启用蓝牙。在 MUI 中,进入 Phone Connection 中描述的蓝牙连接模式。
  2. 将手机应用与 X2 断开连接,以便浏览器可以连接。
  3. 在 Web Client 中选择 Bluetooth,并在浏览器的设备选择器中选择 X2。如有提示,请完成配对。
  4. 等待节点配置加载完成,然后打开一个频道或会话。

步骤 4. 检查连接。 如果尚未连接,选择已添加的设备以建立连接。随后客户端会显示节点状态并加载其配置。打开消息视图以选择频道或节点会话。

Example node shown as connected in the Meshtastic Web Client

配置 GPS​

在户外使用 X2,并确保有开阔的天空视野,然后等待卫星定位完成。

使用 左/右 键切换到 Position,按 Confirm,并选择 On/Off Toggle → Enabled。

MeshPager X2 Base UI Position screen showing satellite count, latitude, longitude, and altitude
Base UI 位置界面。

在手机上配置

将 Meshtastic 应用连接到 X2,打开设备无线电配置下的 Position,并调整以下设置。保存更改,如果设备重启,请重新连接。

Setting控制内容
GPS Mode启用或禁用 X2 的 GNSS 接收机。
GPS Update Interval设备请求新的 GNSS 位置的频率。
Position Broadcast Interval设备通过 mesh 广播其位置的频率。
Smart Position根据移动情况允许位置广播,受配置阈值限制。
Fixed Position使用固定位置。当你希望设备位置随其移动而变化时,请禁用此项。
Meshtastic phone app Position settings for GPS updates and position broadcasts

更短的时间间隔可以提供更频繁的更新,但会增加功耗或 mesh 流量。根据设备移动的频率选择合适的间隔。参见 Meshtastic Position configuration。

iOS 位置权限

如果你在 Meshtastic 应用中使用手机的位置或将其共享给节点,请在 iOS 设置中允许位置访问,并为 Meshtastic 启用 Precise Location。此权限控制手机提供的位置;X2 内置的 GNSS 接收机会独立获取自己的定位。

iOS location permission settings with Precise Location enabled for Meshtastic

传感器连接​

X2 内置了用于环境读数、罗盘航向和运动检测的传感器。根据你想要使用的功能进行配置:

传感器功能配置
SPA06-003 气压计压力和传感器温度读数。手机应用中的 Telemetry → Environment。
BMM350 磁力计罗盘航向。Base UI 中的 Position → Compass 和 Compass Calibrate。
六轴 IMU加速度和角速度测量。由支持的固件功能使用;环境 Telemetry 页面不会显示原始六轴读数。

启用环境遥测

  1. 连接到 X2 并打开 Settings → Module Configuration → Telemetry。
  2. 启用 Environment Metrics Enabled 并设置 Environment Metrics 间隔。
  3. 如果希望在 Base UI 上显示支持的环境读数,请启用 Show on device screen,然后保存设置。
Meshtastic iOS app Telemetry settings for environmental measurements and on-screen display

截图中使用的是示例节点和读数。X2 的环境遥测会显示其检测到的传感器和已安装固件所支持的读数。它不会启用罗盘校准,也不会传输原始加速度计和陀螺仪读数。要使用罗盘功能,请在 Other Function 下使用 Position 选项卡。

Other Function​

使用方向键高亮某个控件。按下 Confirm 以选择它,或长按 Confirm 触发其长按操作。按 Return 关闭对话框或返回。菜单可用性取决于已安装的固件和启用的模块。

X2 操作效果
在 Home 上长按 Confirm使 MUI 与节点的配置和数据重新同步。
在 Nodes 上长按 Confirm打开节点筛选器。
在 Settings 上长按 Confirm锁定显示屏。使用 Power 唤醒,并在已配置的情况下输入屏幕 PIN。

麦克风和扬声器为未来的语音消息更新提供硬件支持。可以使用上述控件配置通知声音。

常见问题​

设备无法通过 BLE 与手机配对​

  • 在 MUI 中,在手机应用中搜索 X2 之前先进入 Bluetooth 配对模式。打开 Settings → Reboot / Shutdown,高亮 Bluetooth 图标,然后短按 Confirm。等待配对屏幕,并使用 X2 上显示的 PIN。 |
MUI Settings, Reboot / Shutdown menu, and Bluetooth pairing mode

在 X2 上,使用方向键高亮控件并按 Confirm 进行选择。有关 X2 按钮示意图,请参见 手机连接。

  • 在 Base UI 中,启用 Wi-Fi 会禁用 Bluetooth。若要继续使用 Wi-Fi,请让手机连接到同一网络,并在 Meshtastic 应用中选择 Network,使用 X2 的 IP 地址。若要改为通过 BLE 配对,请禁用 Wi-Fi 并在 X2 上启用 System → Bluetooth Toggle。 |
Meshtastic phone app Network connection settings
  • 在手机上启用 Bluetooth,并授予应用其 Bluetooth / Nearby Devices 权限。断开任何已连接到 X2 的其他手机或浏览器,然后重新扫描。 |
  • 如果配对仍然失败,请在手机的 Bluetooth 设置中忘记旧的 X2 配对记录,并从 Meshtastic 应用重新连接。输入当前屏幕上的 PIN 或你配置的固定 PIN。 |

设备无法连接到我的 Wifi​

  1. 使用 2.4 GHz Wi-Fi 网络。X2 不支持 5 GHz Wi-Fi。要测试连接,可尝试使用配置为 2.4 GHz 的手机热点。 |
  2. 检查 Wi-Fi 名称和密码(包括大小写),然后在保存后启用 Wi-Fi。按照 地图使用中的 Online Map 选项卡进行操作。 |
  3. 检查 MUI Home 页面上的 Wi-Fi 图标和 IP 地址。灰色图标和空的 IP 字段表示 Wi-Fi 被禁用或尚未连接。白色图标并显示 IP 地址表示已连接。 |
MUI Home page showing Wi-Fi icon and IP address before and after connecting

进入蓝牙连接模式会禁用 Wi-Fi。返回 MUI 后,当你需要在线地图时,请再次启用 Wi-Fi。Wi-Fi 网络还必须提供互联网访问,以便下载地图瓦片。

设备自动关机​

说明

  • X2 在上电后不久就关机或反复重启。
  • 串口日志停止,设备无响应。

故障排查

  1. 检查电池电量和 USB 供电连接。如果只是屏幕变黑,短按 Power 检查 X2 是否仍在运行。屏幕熄灭与关机是不同的。
  2. 如果 X2 只显示充电画面,松开 Power,然后按住约 5 秒 以启动 Meshtastic。避免在保存设置或写入固件时中断电源。
  3. 如果设备仍然无响应,请按照 Forced Restart 操作。如果之后仍然反复重启,请抓取启动串口日志以帮助定位原因。
  4. 如果在电源稳定的情况下问题仍然存在,请对兼容的 X2 固件执行一次干净安装。按照 Manual Firmware Installation 完成全擦除出厂镜像流程。
干净安装

完全擦除会删除设置、频道、密钥和已保存的数据。继续之前请保存所有需要的内容。重新安装后,需要重新配置 LoRa 区域和频道。

恢复出厂设置​

恢复出厂设置会还原默认配置。重置前请保存你想保留的设置和频道信息。

  1. 打开 Settings → Configuration Reset。
  2. 选择 Factory Reset,然后使用方向键和确认键选择 OK。
  3. 等待 X2 以默认配置重启。
MUI Configuration Reset menu with Factory Reset and its confirmation dialog

重启后重新连接 X2,并在使用 mesh 之前设置正确的 LoRa 区域 和 频道。

私信发送失败​

首先检查两个节点是否使用兼容的 LoRa 设置,并且在直连或通过 mesh 的有效范围内。尝试发送共享频道消息。如果频道消息正常而私信失败,请检查下面存储的节点信息和密钥。

NodeDB 重置​

NodeDB 存储在 mesh 上发现的节点信息。过期的条目(例如在另一节点更改密钥之前保存的条目)可能会阻止私信。重置 NodeDB 会清除本地节点数据库,使设备可以重新发现节点。

打开 Settings → Configuration Reset,选择 NodeDB Reset,然后选择 OK。在 X2 上使用方向键和确认键。设备将会重启。

MUI Configuration Reset menu with NodeDB Reset and its confirmation dialog

等待节点列表重新填充,然后交换用户信息,再重试私信。

交换用户信息​

节点会定期广播其用户信息,其中包括加密私信所需的 public key。如果某个节点的信息缺失或过期,在手机应用中打开该节点条目并选择 Exchange User Info。等待交换完成;如有需要,从另一节点重复此操作。

Meshtastic app node menu with Exchange User Info

重新尝试私信并检查其投递状态。消息只出现在发送方的会话中并不能确认已被接收。

重新生成私钥​

如果在刷新节点信息后私信仍然失败,你可以在手机应用的 Security 设置中为受影响的节点重新生成密钥对。使用 Regenerate Private Key,保存更改,并按提示重启设备。

Meshtastic phone app Security settings for regenerating the private key
重新生成密钥后

节点的 public key 会发生变化,因此其他节点必须学习它的新信息。如有必要,从其他节点的列表中删除过期条目,然后再次交换用户信息。请对 private key 保密;只有 public key 会与其他节点共享。参见 Meshtastic Security configuration。

信号质量​

  • SNR(信噪比) 衡量接收信号相对于背景噪声的强度。数值越高通常表示链路越清晰。LoRa 可以接收 SNR 为负的信号;可用极限取决于调制解调器预设。
  • RSSI(接收信号强度指示) 以 dBm 为单位衡量接收信号功率。数值越不负表示信号越强:例如,−90 dBm 比 −110 dBm 更强。

结合实际消息投递情况同时检查这两个数值。单次 SNR 或 RSSI 读数不足以证明设备有故障。要改善链路,请使用与工作频段匹配的天线,检查其连接,并移动到更高、更开阔、远离遮挡物和干扰的位置。

电脑找不到 X2 或无法连接其串口​

  1. 使用 USB 数据 线,并在连接 X2 前后检查电脑的端口列表。仅出现充电画面并不能确认已建立 USB 数据连接。
  2. 在重新连接 X2、更换 USB 接口或进入下载模式后重新检查端口。在 macOS 上,/dev/cu.usbmodem... 的后缀可能会变化。
  3. 关闭使用该端口的其他烧录工具、串口监视器或浏览器连接。在 Linux 上,还要检查 USB 访问权限。
  4. 如果在端口列表中找不到该设备,请尝试另一根数据线或直接连接到电脑以检查 USB 连接。
  5. 对于固件安装,请按照 Flash Firmware 中的说明进入烧录模式。对于 Web Client,请让 Meshtastic 正常运行。

如果烧录工具报告 No serial data received,说明尚未与 bootloader 建立通信。仅凭这条消息无法判断是否存在 Flash 容量问题或设备缺陷。

Linux USB 访问​

在连接 X2 前后对比串口列表:

ls /dev/ttyACM* /dev/ttyUSB* 2>/dev/null

如果访问被拒绝,请检查检测到的端口权限(按需替换 /dev/ttyACM0):

ls -l /dev/ttyACM0

在 Ubuntu/Debian 上,如果端口属于 dialout,请将你的用户加入该用户组:

sudo usermod -aG dialout "$USER"

注销并重新登录,然后重试。关闭使用该端口的其他应用程序。进入下载模式后重新检查端口名称。

GNSS 不显示位置​

  • 使用 Configure GPS 启用 GNSS。
  • 移动到户外、确保视野开阔,并留出时间获取定位。长时间未使用后的首次定位可能比后续定位耗时更长。
  • 在期望其位置出现在地图上之前,先在 X2 上检查卫星和位置状态。
  • 如果你移动时位置仍然保持不变,请检查手机应用中的 Fixed Position 设置和 GNSS 更新间隔。参见 Meshtastic Position configuration。

离线地图为空白​

  1. 检查存储卡的 MBR/FAT32 格式以及 /maps/<style>/<zoom>/<x>/<y>.png 文件夹结构。
  2. 在 MUI 中选择与复制到存储卡相同的样式。
  3. 检查下载的瓦片是否覆盖正在查看的位置和缩放级别。仅安装官方入门套件时,将缩放级别缩小到 6 或更低。
  4. 对于当前位置,等待 GNSS 获取定位。如果未检测到存储卡,请先关闭 X2 并断开 USB,然后重新插入存储卡。

有关准备步骤,请参阅 地图使用。

手动固件安装​

使用 esptool 在 0x0 地址烧录 X2 的 .factory.bin。该组合镜像包含引导加载程序、分区表和应用程序。仅包含应用程序的 .bin 文件不适用于此操作。

完全擦除

下面的烧录命令会擦除所有内部闪存,包括设置、信道和已保存的数据。继续之前请备份所有需要的数据。

  1. 下载 X2 factory firmware 2.8.1.0046b50。将下载的文件从 firmware-seeed_meshpager_x2-2.8.1.0046b50.factory copy.bin 重命名为 x2.factory.bin,并将其放在电脑上的某个文件夹中。
  2. 安装 Python 3.10 或更高版本。
  3. 使用 USB 数据线将 X2 连接到电脑。关闭 Web Flasher、Web Client 以及任何可能占用串口的串口监视器。
  4. 在包含 x2.factory.bin 的文件夹中打开终端,并根据你的系统执行相应命令。先发送 1200 bps 复位,然后使用带有 --before usb-reset 的 esptool。

1200 bps 步骤会触发复位;esptool 负责执行固件写入。1200 bps 不是固件传输速率。 复位后 USB 端口可能会消失并以不同名称重新出现,因此在烧录前请重新列出端口。

在 PowerShell 中,安装 esptool 并列出串口:

py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade "esptool>=5,<6"
.\.venv\Scripts\python.exe -m serial.tools.list_ports

将 COM5 替换为 X2 当前使用的端口,并发送 1200 bps 复位:

.\.venv\Scripts\python.exe -c "import serial,time; s=serial.Serial('COM5',1200,timeout=0.2); s.dtr=True; time.sleep(0.5); s.dtr=False; s.close(); time.sleep(2)"
.\.venv\Scripts\python.exe -m serial.tools.list_ports

再次检查端口。将下面的 COM5 替换为 X2 现在使用的端口,然后开始烧录:

.\.venv\Scripts\python.exe -m esptool --chip esp32s3 --port COM5 --baud 460800 --before usb-reset write-flash --erase-all 0x0 x2.factory.bin

保持 USB 连接,直到 esptool 显示 Hash of data verified 并完成操作。然后在松开 Power 和 Return 的情况下重启 X2,并重新配置 LoRa 区域和信道。

如果 esptool 报告 No serial data received,请检查是否有其他应用程序占用该端口,重复执行 1200 bps 复位,并选择新枚举出来的端口。仅降低传输速率并不能让 X2 进入下载模式。

如果软件复位不可用,请使用 烧录固件 中描述的 X2 按键操作,然后重新检查端口。所需的复位行为可能取决于已安装的固件和硬件版本。

如果已经建立连接但写入多次失败,请使用 --baud 115200 重新尝试写入命令。

技术支持与产品讨论​

加入 Seeed Studio Meshtastic Facebook 社区

Loading Comments...