From d203ccfa8f29656f50a9c896c4506e0cab2083b2 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 00:00:52 +0800 Subject: [PATCH 01/19] Add chinese translation --- docs/zh/index.md | 4 + docs/zh/quick-start/getting-started.md | 106 ++++++++++++++++++ mkdocs.yml | 142 +++++++++++++++++++++++++ overrides/i18n/zh/home.html | 92 ++++++++++++++++ overrides/i18n/zh/main.html | 17 +++ 5 files changed, 361 insertions(+) create mode 100644 docs/zh/index.md create mode 100644 docs/zh/quick-start/getting-started.md create mode 100644 overrides/i18n/zh/home.html create mode 100644 overrides/i18n/zh/main.html diff --git a/docs/zh/index.md b/docs/zh/index.md new file mode 100644 index 000000000..5ccf95531 --- /dev/null +++ b/docs/zh/index.md @@ -0,0 +1,4 @@ +--- +template: i18n/zh/home.html +title: 开源的高性能遥控链路 +--- diff --git a/docs/zh/quick-start/getting-started.md b/docs/zh/quick-start/getting-started.md new file mode 100644 index 000000000..61bf40090 --- /dev/null +++ b/docs/zh/quick-start/getting-started.md @@ -0,0 +1,106 @@ +--- +template: main.html +description: 在这里开始你的ELRS历程! 这是让你用ELRS飞起来的最全面的指南 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +!!! warning "Working In Progress" + 中文翻译工作正在进行，部分内容尚未完成 + +!!! warning "注意!" + ELRS团队与制造商紧密合作，负责审核和测试硬件。只有在测试通过后，才会为特定硬件添加ELRS地面站目标。 + + 如果在ELRS地面站中找不到某个硬件，说明该硬件未通过要求，或者制造商选择不合作。在这种情况下，请联系制造商获取技术支持。 + + 通用目标仅适用于预生产或DIY硬件。现成的硬件应使用专用的硬件目标。 + + 省流: 想支持开源就买在ELRS地面站里有的硬件 + +## 快速入门指南 + +### 前置条件 + +你需要熟悉你的遥控器系统(OpenTX/EdgeTX)以及模型设置，因为此指南主要涵盖如何设置你的遥控器以使用ELRS + +此外,你还需要熟悉飞控固件(Betaflight、INAV等)调参, 此指南只说明如何将ELRS接收机正确连接到飞控 + +### 我应该先做什么？ + +你下单(自制)的ELRS接收机已经到货(做好)了，无论是自带ELRS的新遥控器，还是一个外置的ELRS高频头又或者是到手飞套装，你该从哪里开始？ + +我们的建议如下： + +=== "发射端" + 1. [设置遥控器](transmitters/tx-prep.md) + 2. [检查高频头固件版本](transmitters/firmware-version.md) + 3. [更新高频头固件](transmitters/updating.md) + +=== "接收端" + 1. [接收机接线](receivers/wiring-up.md) + 2. [配置飞控](receivers/configuring-fc.md) + 3. [检查接收机版本](receivers/firmware-version.md) + 4. [更新接收机固件](receivers/updating.md) + +弄完了之后，你可以继续以下步骤: + +- [对频](binding.md) +- [性能测试](pre-1stflight.md#性能测试) +- [遥控器和飞控配置](pre-1stflight.md) +- 起飞! + +### 如何使用或浏览本指南 + +![指南结构](../assets/images/PageOrder.png){ align=right } + +
+本用户指南旨在帮助新手和有经验的用户。左侧导航菜单从安装ELRS地面站开始，介绍可用选项、遥控器和高频头设置、飞控和接收机设置、“起飞前”页面以及故障排查页面。 + +
+ +你也可以使用下方的页脚导航来依次浏览这些步骤： + +
+![Footer Navigation](../assets/images/FooterNav.png) +
+ +针对特定硬件的刷机指南，页面分别在“升级接收机”或“升级发射端”部分，按英文字母顺序排列。 + +
+![Menu Updating Receivers](../assets/images/menusectionUpdatingReceivers.png) +
+ +
+![Menu Updating Transmitters](../assets/images/menusectionUpdatingTransmitters.png) +
+ +你还可以使用搜索栏查找任何你需要的内容： + +
+![Search Bar](../assets/images/SearchBar.png) +
+ +较长的页面在右侧有 **目录** + +![Search Bar](../assets/images/website-tabbed.png){ align=right } + +
+ +每种设备的升级方法都可以通过点击对应的标签访问 + +
+ +我们希望这些页面能帮助你快速上手ELRS，体验业界最优秀、最具创新性的遥控链路之一。 + +如果你有其他问题或疑虑，或者需要本指南未涵盖的进一步帮助，请加入我们的Discord频道！ + +!!! warning "注意" + 国内无法访问Discord + +[ExpressLRS Discord :fontawesome-brands-discord:](https://discord.gg/dS6ReFY){ .md-button .md-button--primary .center-block } + +## 哪里有视频教程？ + +由于开发进展非常快，视频教程往往很快就会过时。某些教程有时会使用预发布固件目标或用于不同硬件的目标，这可能会造成混淆，尤其是在特定固件目标添加后。 + +我们很快会添加一个单独的视频板块，但在此之前，除非找到高质量、相关且适用的教程，否则请自行查找。请注意这些视频的发布日期，以确保内容仍然适用。 diff --git a/mkdocs.yml b/mkdocs.yml index a57117884..ca91851a9 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -78,6 +78,148 @@ plugins: name: English build: true default: true + - locale: zh # zh: 简体中文 zh-Hant: 繁体中文 注意: 在 mkdocs 中没有 zh-CN 这个说法！ + name: 中文（简体） + build: true + site_description: >- + ExpressLRS 致力于提供完全开源的高刷新率的遥控链路， + 同时在该刷新率下保持最大的通信距离以及较低的延迟， + ELRS 在 900 MHz 与 2.4 GHz 频段均提供广泛的硬件支持。 + nav: + - 主页: index.md + - 快速开始: + - 入门: quick-start/getting-started.md + - 安装地面站: quick-start/installing-configurator.md + - Firmware Options: quick-start/firmware-options.md + - The Web UI: quick-start/webui.md + - Transmitters: + - Radio Preparation: quick-start/transmitters/tx-prep.md + - Checking FW Version: quick-start/transmitters/firmware-version.md + - Typical Updating Steps: quick-start/transmitters/updating.md + - Updating Transmitters: + - Axisflying Thor: quick-start/transmitters/axisflying-thor.md + - BetaFPV 2.4GHz: quick-start/transmitters/betafpv2400.md + - BetaFPV 900MHz: quick-start/transmitters/betafpv900.md + - BetaFPV LR3 Pro: quick-start/transmitters/betafpvlr3pro.md + - EMAX 2.4GHz: quick-start/transmitters/emax2400.md + - EMAX 900MHz: quick-start/transmitters/emax900.md + - Frsky R9 Modules: quick-start/transmitters/frsky-r9modules.md + - Happymodel ES24TX: quick-start/transmitters/es24tx.md + - Happymodel ES900TX: quick-start/transmitters/es900tx.md + - HGLRC Hermes: quick-start/transmitters/hglrc-hermes.md + - iFlight Commando: quick-start/transmitters/iflight-commando.md + - IMRC Ghost: quick-start/transmitters/ghost2400.md + - Internal RadioMaster: quick-start/transmitters/rm-internal.md + - Internal Jumper T-Pro: quick-start/transmitters/aion-internal.md + - Internal Jumper TLite V2: quick-start/transmitters/jumper-internal.md + - Internal Jumper T14/T15: quick-start/transmitters/jumper-t14-t15-internal.md + - Internal Jumper T20: quick-start/transmitters/jumper-t20-internal.md + - Jumper Aion Nano: quick-start/transmitters/jumper-aion.md + - NamimnoRC Flash: quick-start/transmitters/flash2400.md + - NamimnoRC Voyager: quick-start/transmitters/voyager900.md + - Radiomaster Bandit: quick-start/transmitters/rm-bandit.md + - Radiomaster Ranger: quick-start/transmitters/rm-ranger.md + - Siyi FM30: quick-start/transmitters/siyifm30.md + - Vantac Lite: quick-start/transmitters/vantac-lite.md + - DIY 900TX: quick-start/transmitters/diy900.md + - DIY 2400TX: quick-start/transmitters/diy2400.md + - The ExpressLRS Lua Script: quick-start/transmitters/lua-howto.md + - 接收机: + - Receiver Wiring: quick-start/receivers/wiring-up.md + - Configuring FC: quick-start/receivers/configuring-fc.md + - Checking FW Version: quick-start/receivers/firmware-version.md + - Typical Updating Steps: quick-start/receivers/updating.md + - Updating Receivers: + - Axisflying Thor: quick-start/receivers/axisflying-thor.md + - BetaFPV Lite/Nano/AIO 2.4GHz: quick-start/receivers/betafpv2400.md + - BetaFPV Nano 900MHz: quick-start/receivers/betafpv900.md + - BetaFPV SuperD 2.4GHz: quick-start/receivers/betafpv-superd.md + - BetaFPV SuperD 900MHz: quick-start/receivers/betafpv-superd900.md + - Foxeer LNA & Lite 2.4GHz: quick-start/receivers/foxeer2400.md + - Frsky R9: quick-start/receivers/r9.md + - GEPRC Nano & Dual 2.4GHz: quick-start/receivers/geprc2400.md + - GEPRC Nano & Dual 900MHz: quick-start/receivers/geprc900.md + - Happymodel EP: quick-start/receivers/hmep2400.md + - Happymodel PP: quick-start/receivers/hmpp2400.md + - Happymodel ES900RX: quick-start/receivers/hmes900.md + - HGLRC Hermes 2.4GHz: quick-start/receivers/hglrc-hermes2400.md + - HGLRC Hermes 900MHz: quick-start/receivers/hglrc-hermes900.md + - iFlight 2.4GHz: quick-start/receivers/iflight2400.md + - iFlight 900MHz: quick-start/receivers/iflight900.md + - IMRC Ghost: quick-start/receivers/ghost2400.md + - Jumper Aion Nano: quick-start/receivers/jumper-aion.md + - Jumper R9 Mini: quick-start/receivers/jumper900.md + - Matek R24: quick-start/receivers/matek2400.md + - NamimnoRC Flash: quick-start/receivers/flash2400.md + - NamimnoRC Voyager: quick-start/receivers/voyager900.md + - RadioMaster RP: quick-start/receivers/radiomaster-rp-2400.md + - Siyi FR Mini: quick-start/receivers/siyiFRmini.md + - Vantac: quick-start/receivers/vantac2400.md + - DIY 900RX: quick-start/receivers/diy900.md + - DIY 2400RX: quick-start/receivers/diy2400.md + - 烧录后: + - LED Status: quick-start/led-status.md + - Binding ExpressLRS: quick-start/binding.md + - Before First Flight: quick-start/pre-1stflight.md + - Ardupilot Setup: quick-start/ardupilot-setup.md + - Troubleshooting: quick-start/troubleshooting.md + - Unbricking: quick-start/unbricking.md + - 软件: + - Obsolete Defines: software/obsolete-defines.md + - OpenOCD for STLink: software/open-ocd.md + - PIO STLink Fix: software/stlink-fix.md + - Switch Configs: software/switch-config.md + - Toolchain Setup: software/toolchain-install.md + - User Defines: software/user-defines.md + - Updating: + - Betaflight Passthrough: software/updating/betaflight-passthrough.md + - Wifi Updating: software/updating/wifi-updating.md + - Features: + - AirPort: software/airport.md + - Dynamic Transmit Power: software/dynamic-transmit-power.md + - Gemini: software/gemini.md + - Loan Model: software/loan-model.md + - MAVLink: software/mavlink.md + - MFD Crossbow Tracker Integration: software/mfd-crossbow.md + - Model Matching: software/model-config-match.md + - Receiver Serial Protocols: software/serial-protocols.md + - Sentinel Tracker Integration: software/backpack-telemetry.md + - Serial VTX: software/serialvtx.md + - Team Racing: software/teamracing.md + - Testing: + - CRC Testing: software/testing/crc-testing.md + - RX Testing: software/testing/rx-scoreboard.md + - Unit Testing: software/testing/unit-testing.md + - 硬件: + - Hardware Selection: hardware/hardware-selection.md + - R9M Inverter Mod: hardware/inverter-mod.md + - R9M Fan Mod: hardware/fan-mod.md + - Troubleshooting the X9D(+): hardware/x9d-troubleshooting.md + - Crystal Oscillator (XO) Frequency Error: hardware/crystal-frequency-error.md + - SMD Antenna: hardware/smd-antenna.md + - PWM Receivers: hardware/pwm-receivers.md + - SPI Receivers: hardware/spi-receivers.md + - ESP Backpacks: + - Backpack Info: hardware/backpack/esp-backpack.md + - Tx Backpack Setup: hardware/backpack/backpack-tx-setup.md + - VRx Backpack Setup: hardware/backpack/backpack-vrx-setup.md + - HDZero Goggle VRx Backpack: hardware/backpack/hdzero-goggles.md + - Special Targets: + - DIY Receiver: hardware/special-targets/diy-rx.md + - DIY Transmitter: hardware/special-targets/diy-tx.md + - Nuclear Targets: hardware/special-targets/nuclear-hardware.md + - 信息: + - Glossary: info/glossary.md + - Signal Health: info/signal-health.md + - Telemetry Bandwidth: info/telem-bandwidth.md + - Init Rate: info/init-rate.md + - Long Range Competition: info/long-range.md + - Advance Technical Info: info/advance-technical-info.md + - Privacy Policy: info/privacy-policy.md + - Licenses: info/licenses.md + - Terms & Conditions: info/terms-and-conditions.md + - 常见问题: faq.md + - 合作伙伴: partners-program.md git-revision-date-localized: enabled: !ENV [CI, false] type: timeago diff --git a/overrides/i18n/zh/home.html b/overrides/i18n/zh/home.html new file mode 100644 index 000000000..1b498b9f6 --- /dev/null +++ b/overrides/i18n/zh/home.html @@ -0,0 +1,92 @@ +{% extends "i18n/zh/main.html" %} + + +{% block tabs %} {{ super() }} + + + + + +
+
+
+ +
+ +
+ + +
+

开源的高性能遥控链路

+

{{ config.site_description }}

+ + 快速开始 + + + + 下载地面站 + + + 在线刷写固件 + +
+
+
+
+{% endblock %} + + +{% block content %}{% endblock %} + + +{% block footer %}{% endblock %} diff --git a/overrides/i18n/zh/main.html b/overrides/i18n/zh/main.html new file mode 100644 index 000000000..a7d0bf454 --- /dev/null +++ b/overrides/i18n/zh/main.html @@ -0,0 +1,17 @@ +{% extends "base.html" %} + + +{% block extrahead %} {{ super() }} + + + +{% endblock %} +{% block announce %} +ExpressLRS v3.5.6 现已发布! 在 GitHub 上查看. +{% endblock %} From 02c2ebd778c2d748f53ff1d176fc972c8d4ffc68 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 00:03:47 +0800 Subject: [PATCH 02/19] update --- docs/zh/quick-start/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh/quick-start/getting-started.md b/docs/zh/quick-start/getting-started.md index 61bf40090..48151fc01 100644 --- a/docs/zh/quick-start/getting-started.md +++ b/docs/zh/quick-start/getting-started.md @@ -27,7 +27,7 @@ description: 在这里开始你的ELRS历程! 这是让你用ELRS飞起来的最 ### 我应该先做什么？ -你下单(自制)的ELRS接收机已经到货(做好)了，无论是自带ELRS的新遥控器，还是一个外置的ELRS高频头又或者是到手飞套装，你该从哪里开始？ +你已经有了相关的ELRS硬件，无论是内置ELRS的新遥控器，还是一个外置的ELRS高频头又或者是到手飞套装，你该从哪里开始？ 我们的建议如下： From 476f2c5cbab08cf75a4790f82c0508fcc5760a6a Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 11:11:39 +0800 Subject: [PATCH 03/19] Add some translated articles --- docs/quick-start/led-status.md | 118 +++---- docs/zh/quick-start/ardupilot-setup.md | 56 ++++ docs/zh/quick-start/binding.md | 201 ++++++++++++ docs/zh/quick-start/firmware-options.md | 108 ++++++ docs/zh/quick-start/getting-started.md | 22 +- .../zh/quick-start/installing-configurator.md | 25 ++ docs/zh/quick-start/led-status.md | 71 ++++ docs/zh/quick-start/webui.md | 307 ++++++++++++++++++ mkdocs.yml | 8 +- 9 files changed, 842 insertions(+), 74 deletions(-) create mode 100644 docs/zh/quick-start/ardupilot-setup.md create mode 100644 docs/zh/quick-start/binding.md create mode 100644 docs/zh/quick-start/firmware-options.md create mode 100644 docs/zh/quick-start/installing-configurator.md create mode 100644 docs/zh/quick-start/led-status.md create mode 100644 docs/zh/quick-start/webui.md diff --git a/docs/quick-start/led-status.md b/docs/quick-start/led-status.md index 64bcafc30..8d8992f74 100644 --- a/docs/quick-start/led-status.md +++ b/docs/quick-start/led-status.md @@ -1,71 +1,71 @@ --- -template: main.html -description: The LEDs on both the ExpressLRS Receivers and Transmitter Modules are very helpful diagnostic tool in determining the current status of the device. +template: i18n/zh/main.html +description: ExpressLRS 接收机和发射端模块上的 LED 是非常有用的诊断工具，可以帮助你判断设备当前状态。 --- ![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) -## Receiver/Transmitter LED Status +## 接收机/发射端 LED 状态 -ExpressLRS uses the LED to communicate the status of the transmitter/receiver. +ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 -The conditions and status LED are as follows: +不同状态下的 LED 指示如下： -=== "Receiver Single Color LED" - | | LED Indication | Status | - |-----------------------------------------------------------------------------------------|---------------------------------|-------------------------------------------------------------------| - | ![CONNECTED](../assets/images/LED_ON.gif) | Solid on | Connected to a transmitter, or bootloader mode enabled | - | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | Double blink then pause | Binding mode enabled | - | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | - | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | Triple blink then pause | Connected to transmitter but mismatched model-match configuration | - | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | Medium speed blink 100ms on/off | Radio chip not detected | - | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | Fast blinking 25ms on/off | WiFi mode enabled | +=== "接收机单色 LED" + | | LED 指示 | 状态说明 | + |-----------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| + | ![CONNECTED](../assets/images/LED_ON.gif) | 常亮 | 已连接到发射端，或处于 Bootloader 模式 | + | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | 快速双闪后暂停 | 进入对频模式 | + | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | + | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | 三快闪后暂停 | 已连接发射端但模型匹配参数不一致 | + | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | 中速闪烁 100ms 开/关 | 无法检测到射频芯片 | + | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | 快速闪烁 25ms 开/关 | 进入 WiFi 模式 | -=== "Receiver RGB LED" - | | LED Indication | Status | - |-------------------------------------------------------------------------------------|--------------------------------|-------------------------------------------------------------------| - | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | Rainbow fade effect | Starting Up | - | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | Green heartbeat | Web update mode enabled | - | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | - | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | Red flashing 100ms on/off | Radio chip not detected | - | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | Orange Double blink then pause | Binding mode enabled | - | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | Orange Triple blink then pause | Connected to transmitter but mismatched model-match configuration | - | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | Solid single color | Connected to a transmitter, color indicates packet rate | - | ![BOOTLOADER_OR_OFF](../assets/images/LED_RGB_OFF.png) | No Light | Off or in Bootloader Mode | +=== "接收机 RGB LED" + | | LED 指示 | 状态说明 | + |-------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| + | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | 彩虹渐变效果 | 启动中 | + | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | 绿色心跳 | 进入 Web 更新模式 | + | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | + | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | + | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | 橙色双闪后暂停 | 进入对频模式 | + | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | 橙色三闪后暂停 | 已连接发射端但模型匹配参数不一致 | + | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | 单色常亮 | 已连接到发射端，颜色表示包速率 | + | ![BOOTLOADER_OR_OFF](../assets/images/LED_RGB_OFF.png) | 熄灭 | 关闭或处于 Bootloader 模式 | - | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | - |--------------|-------------------------|-----------------------------| - | Red | F1000 | 200 | - | Yellow | F500 | | - | Yellow-Green | D500 | 100 Full | - | Green | D250 | 100 | - | Cyan | 333 Full | | - | Light Blue | 500 | 50 | - | Blue | 250 | 25 | - | Blue-Purple | 150 | | - | Purple | 100 Full | D50 | - | Magenta | 50 | | + | LED 颜色 | 2.4GHz 包速率 (Hz) | 915/868MHz 包速率 (Hz) | + |---------------|--------------------|------------------------| + | 红色 | F1000 | 200 | + | 黄色 | F500 | | + | 黄绿色 | D500 | 100 Full | + | 绿色 | D250 | 100 | + | 青色 | 333 Full | | + | 浅蓝色 | 500 | 50 | + | 蓝色 | 250 | 25 | + | 蓝紫色 | 150 | | + | 紫色 | 100 Full | D50 | + | 品红色 | 50 | | -=== "Transmitter RGB LED" - | LED Indication | Status | - |-------------------------------|--------------------------------------------------------| - | Rainbow fade effect | Starting Up | - | Green heartbeat | Web update mode enabled | - | Blue heartbeat | Bluetooth joystick enabled | - | Red flashing 100ms on/off | Radio chip not detected | - | One Orange flash every second | No handset connection | - | Solid single color | Connected to receiver, color indicates packet rate | - | Fading single color | No connection to receiver, color indicates packet rate | +=== "发射端 RGB LED" + | LED 指示 | 状态说明 | + |-------------------------------|--------------------------------------------------------------| + | 彩虹渐变效果 | 启动中 | + | 绿色心跳 | 进入 Web 更新模式 | + | 蓝色心跳 | 启用蓝牙摇杆 | + | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | + | 每秒橙色闪烁一次 | 未连接遥控器 | + | 单色常亮 | 已连接接收机，颜色表示包速率 | + | 单色渐变 | 未连接接收机，颜色表示包速率 | - | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | - |--------------|-------------------------|-----------------------------| - | Red | F1000 | 200 | - | Yellow | F500 | | - | Yellow-Green | D500 | 100 Full | - | Green | D250 | 100 | - | Cyan | 333 Full | | - | Light Blue | 500 | 50 | - | Blue | 250 | 25 | - | Blue-Purple | 150 | | - | Purple | 100 Full | D50 | - | Magenta | 50 | | + | LED 颜色 | 2.4GHz 包速率 (Hz) | 915/868MHz 包速率 (Hz) | + |---------------|--------------------|------------------------| + | 红色 | F1000 | 200 | + | 黄色 | F500 | | + | 黄绿色 | D500 | 100 Full | + | 绿色 | D250 | 100 | + | 青色 | 333 Full | | + | 浅蓝色 | 500 | 50 | + | 蓝色 | 250 | 25 | + | 蓝紫色 | 150 | | + | 紫色 | 100 Full | D50 | + | 品 \ No newline at end of file diff --git a/docs/zh/quick-start/ardupilot-setup.md b/docs/zh/quick-start/ardupilot-setup.md new file mode 100644 index 000000000..12f078338 --- /dev/null +++ b/docs/zh/quick-start/ardupilot-setup.md @@ -0,0 +1,56 @@ +--- +template: i18n/zh/main.html +description: ELRS支持ArduPilot！本指南为你提供正确的ArduPilot参数设置。 +--- + +![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) + +## ArduPilot 串口设置 + +ArduPilot 固件必须为 4.1 或更高版本才能运行 CRSF 协议。 +和所有串口接收机一样，你需要将接收机的 TX/RX 焊盘连接到飞控上的 UART，并在 ArduPilot 中为对应 UART 启用串口接收（Serial RX）。 +在 Mission Planner 中，请进入 ```配置/调试 -> 全部参数表```，设置如下参数： +``` +SERIALx_PROTOCOL = 23 (RCIN) +RSSI_TYPE = 3 (ReceiverProtocol) +``` +ELRS的包速率与 ArduPilot 的 CRSF 包速率不同，ArduPilot 会持续报告速率不匹配，但最近已提供关闭该提示的选项。你可以通过如下参数关闭该通知（不会影响 RC 链路和遥测链路）： +``` +在 RC_OPTIONS 中勾选"Suppress CRSF mode/rate message for ELRS systems". +``` +建议开启 RC_OPTIONS 中的"Use 420kbaud for ELRS protocol"，这样会让接收机与飞控使用 420K 的波特率通信 + + +
+![RC_Options Bitmask](../assets/images/ArduRCOPTIONS.png) +
+ +设置好上述参数后，请断开并重新连接电池和 USB，重启飞控。ArduPilot 应自动识别 ELRS 接收机，如果未成功，请将打开 ``RC_PROTOCOL`` 中的 "CRSF" 选项，并设置如下参数： +``` +SERIALx_PROTOCOL = 23 (RCIN) +SERIALx_BAUD = 115 +RSSI_TYPE = 3 (ReceiverProtocol) +``` + +## ArduPilot 飞行模式通道 + +~~ArduPilot 默认飞行模式通道为通道 8，但 ELRS 的 8 位开关通道在混合开关模式下为通道 12。你需要将遥控器设置为通道 12 控制飞行模式，并设置 ArduPilot 参数：~~ + +~~FLTMODE_CH=12~~ + +~~如果你使用的是宽开关模式（仅 ELRS V2 及以上版本支持），可以用任意通道选择 8 个飞行模式（除通道 15 为 LQ，通道 16 为 RSSI）。~~ + +就 ELRS 当前版本(3.5.6)而言，可以使用16个通道中的任意一个通道控制飞行模式，前提是 Switch Mode 设置为 **Wide** + +## ArduPilot 的 RSSI 和 Link Quality(LQ) +如需在 OSD 上显示 RSSI 和 LQ（百分比），请设置： +``` +RSSI_TYPE = 3 (ReceiverProtocol) +``` + +然后进入 OSD 选项卡，将 RSSI 和 LQ 元素放置在你想要的位置。 + +如果你感觉控制有延迟或卡顿，请检查接收机与飞控的连接。 +部分飞控需要使用支持全 DMA 的输入引脚。 + +祝你飞行愉快！ :airplane: diff --git a/docs/zh/quick-start/binding.md b/docs/zh/quick-start/binding.md new file mode 100644 index 000000000..0a868dfa6 --- /dev/null +++ b/docs/zh/quick-start/binding.md @@ -0,0 +1,201 @@ +--- +template: i18n/zh/main.html +description: 对频 ELRS 接收机是很简单的事情~!~如果设置了对频短语，甚至连按钮都不需要按！如果你想按按钮，也可以手动对频 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-Hardware/master/img/quick-start.png) + +省流：快速插拔3下接收机进入对频模式，遥控器 ELRS Lua 选择 `[Bind]` 选项对频 + +## 兼容性检查 + +高频头和接收机的固件版本号的第一个数字必须一致。 + +例如： + +- 高频头固件版本为 3.1.2，可以与固件版本为 3.0.1 的接收机对频 +- 高频头固件版本为 3.2.0，**不能**与固件版本为 2.4.0 的接收机对频 +- 接收机固件版本为 3.1.2，可以与固件版本为 3.0.1 的高频头对频 +- 接收机固件版本为 3.2.0，**不能**与固件版本为 2.4.0 的高频头对频 +- SPI 接收机在（官方）Betaflight 4.3.1 及更早版本只能与 ExpressLRS 2.x 固件对频 +- SPI 接收机在 Betaflight 4.4.0 及更新版本只能与 ExpressLRS 3.x 固件对频 + +如果你的固件版本不兼容，下面的所有方法都无法对频。 + +如何检查你的 ELRS 设备固件版本，请参阅： + +- [高频头](../quick-start/transmitters/firmware-version.md) +- [接收机](../quick-start/receivers/firmware-version.md) +- [SPI 接收机](../hardware/spi-receivers.md) + + +## 怎么对频？ + +有**两种**方法可以对频： + +1. [使用对频短语](#使用对频短语) +2. [传统对频方法](#传统对频方法) + +如果你本来就要更新或刷写 ELRS 固件，建议直接使用对频短语。 + +自 ELRS v3.0 起，可以通过 WebUI 更新对频短语，更推荐使用对频短语。 + +以下是 ELRS 的不同对频流程。 + +## 使用对频短语 +你可以在刷写或更新固件前，在 [ELRS 地面站](installing-configurator.md) 的对频短语字段中输入一个简短且独特的对频短语。 + +
+![Binding Phrase Field](../assets/images/bindingphrase-textfield.png) +
对频短语输入框
+
+ +如果你的设备支持 WiFi，并且已升级到 ExpressLRS 3.0 或更高版本，也可以通过 WebUI 更改对频短语。详见[WebUI 用户指南](webui.md)。 + +
+![Binding Phrase Field WebUI](../assets/images/bindingphrase-webui.png) +
WebUI 中的对频短语输入框
+
+ +建议使用至少 8 位字母和数字组成的**唯一**短语。推荐用你的飞手昵称。这个短语不需要复杂或保密，因为它不是密码或加密密钥。 + +??? info "我的对频短语需要保密吗？（点击展开）" + 不需要，就像你的图传频道不是秘密一样。对频短语不是安全用途，而是防止干扰。如果大家都用一样的短语，互相干扰的概率就很高。请确保你的短语独特，避免与他人重复，也可以发挥创意，设置有趣的短语。 + +## 传统对频方法 + +传统对频要求接收机未设置对频短语。 + +!!! info "3.4.0 更新" + 任何刷写了 3.4.0 或更高版本的接收机，即使设置了对频短语，也可以进入对频模式。 + +!!! warning "注意" + 如果接收机已设置对频短语，将无法进入手动对频模式，无论你尝试多少次。必须先重新刷写并取消设置对频短语。既然都要刷固件了，建议直接用对频短语 :grin: + +接收机上电后，LED 应该会闪烁。 + +
+![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) +
+ +??? danger "接收机 LED 不闪烁（点击展开）" + 如果接收机进入 Bootloader 模式，可以尝试以下方法： + + 1. 检查接收机上的 Boot 按钮是否被按下或损坏。 + - 如果被按下或挤压，移除原因（如热缩管压到按钮）。 + - 如果损坏，建议更换或联系卖家售后。 + + 2. 如果是 Boot 焊盘，检查是否与 GND 焊盘连接。 + - 如果连接了 GND 焊盘，断开连接。 + + 3. 断开接收机的 RX 和 TX 线，重新上电，观察 LED。 + - 如果开始慢闪（500ms），建议换到其他 UART。 + - 如果其他 UART 被占用，尝试加上拉电阻（300~1k 欧姆，越小效果越好），连接 UART 的 RX 焊盘和 5V 或 3.3V。 + +
+ ![ExpressLRS Pull-up](../assets/images/pull-up.png) +
+ + 4. 如果你用的是数字图传（如 DJI Air Unit、Caddx Vista、DJI O3），且六根线都接到飞控，需要移除 SBUS/DJI HDL 线。 + +对频步骤如下： + +1. 关闭你的遥控器/发射端。 +2. 给接收机断电并重新上电 3 次。 + - 给接收机供电。 + - LED 亮起。 + - 2 秒内断电。 + - 重复 2 次。 + + !!! warning "注意" + 建议用电池操作，确保飞控接线无误且无短路，避免烧坏设备，你也不想让魔法烟雾释放出来吧 + +3. 确认 LED 快速双闪，表示接收机进入对频模式。 + +
+ ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) +
+ +4. 打开遥控器/发射端，在 ELRS Lua 脚本中选择 ++"[BIND]"++，发送对频信号。弹窗会短暂出现后消失。 + +
+ ![Bind Mode](../assets/images/lua/bind-bw.png) +
+ +5. 如果接收机 LED 常亮，说明对频成功！ + +
+ ![CONNECTED](../assets/images/LED_ON.gif) +
+ +## ExpressLRS 3.4.0 及以上的对频流程 + +自 [PR#2542](https://github.com/ExpressLRS/ExpressLRS/pull/2542) 合并进 3.4.0 后，用户可以通过以下方式让接收机与发射端对频： + +1. 刷写或设置(WebUI)对频短语到两个设备。 +2. 3 次断电重启。 +3. 在 BF 地面站 10.10（或更高）接收机页面点击 `Bind Receiver` 按钮（或 CLI 输入 `bind_rx`），仅适用于 Betaflight 4.5.0 及以上。 +4. 长按接收机上的按键 1.5 秒（或短接 Boot 焊盘到地）。 + +以上三种方法，接收机 LED 会双闪，暂停后重复，直到对频成功（LED 常亮）。在 ExpressLRS Lua 脚本中按 `[Bind]` 按钮即可完成对频。 + +
+![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) +
+ +对频成功后，用户可随时用以上三种方法让接收机再次进入对频模式。对频信息会一直保留，直到再次进行对频。 + +取消对频模式只需重启或断电，或与发射端对频。若没有对频重启后会用旧的对频信息。 + +Lua 脚本或 WebUI 可设置对频信息为易失性（volatile），即只在本次上电有效，重启后自动进入对频模式。 + +## 连接检查 + +使用 [ExpressLRS Lua 脚本](transmitters/lua-howto.md)，观察屏幕右上角是否有 `C`，表示发射端和接收机已连接并通信。 + +1. 按下遥控器上的 ++"SYS"++ 键。 + - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 + +2. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。 + +
+ ![Lua Script] +
+ + - 如果没有该脚本，请从[这里](transmitters/lua-howto.md)下载并保存到遥控器 SD 卡的 Scripts/Tools/ 文件夹。 + +3. 按 ++enter++ 加载脚本。 + +
+ ![Lua Running] +
+ + - 如果脚本卡在 "Loading..."，请返回[遥控器准备](transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + + +4. 屏幕右上角出现 `C`，表示发射端和接收机已连接。 + +
+ ![Lua Loaded](../assets/images/tx-internalLuaCheck.jpg) +
+ +??? tip "模型不匹配（点击展开）" + 如果 Lua 脚本右上角出现 `C`，但随后消失并显示 "Model Mismatch"，不用担心。ExpressLRS 检测到接收机的 Model ID 与当前遥控器模型配置的 Receiver ID 不一致。 + + 接收机 LED 会三快闪后暂停： + +
+ ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) +
+ + 如果你按[此页面](../software/model-config-match.md)设置了模型匹配，请确保参数正确。 + + 如果 Lua 脚本中的 Model Match 项为开启，并且你需要模型匹配功能，先关闭再重新开启即可分配当前 Receiver 和 Model ID。 + + 如果不需要模型匹配，直接关闭 Model Match 项即可。 + + 必须在发射端和接收机都通电且已对频时操作。 + +[Lua Script]: ../assets/images/lua1.jpg +[Lua Running]: ../assets/images/lua/config-bw.png diff --git a/docs/zh/quick-start/firmware-options.md b/docs/zh/quick-start/firmware-options.md new file mode 100644 index 000000000..696b702a7 --- /dev/null +++ b/docs/zh/quick-start/firmware-options.md @@ -0,0 +1,108 @@ +--- +template: i18n/zh/main.html +description: 按照你的需求设置 ELRS 设备！通过固件选项自定义你的接收机和高频头。 +--- + +![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) + +本页仅介绍你在 ELRS 地面站中初次设置时可能需要的关键选项。关于**所有**可用选项的完整说明，请参阅[用户自定义选项页面](../software/user-defines.md)。 + +部分选项在高频头和接收端目标中都存在。为了能够正常对频，这些选项必须在发射模块和接收机上保持一致。`team2400`和`team900`也有一些共享选项，同时也有各自频段独有的选项。下方展示了`team2400`和`team900`发射端常见的选项。 + +
+![2400 TX Options](../assets/images/ConfigurationOptions2400tx.png) +
+ +
+![900 TX Options](../assets/images/ConfigurationOptions900tx.png) +
+ +## 无线通信监管域 +``` +Regulatory_Domain_AU_915 +Regulatory_Domain_EU_868 +Regulatory_Domain_IN_866 +Regulatory_Domain_FCC_915 + +Regulatory_Domain_ISM_2400 +Regulatory_Domain_EU_CE_2400 +``` +这个选项很简单——根据你所在地区选择对应的法规区域，以确定使用的频率范围。 + +欧盟法规区域现在已符合 LBT（Listen Before Talk） 要求！ + +## 对频短语 + +设置对频短语可以让你跳过传统的对频步骤——强烈建议设置。任何使用相同对频短语的发射端都能连接到使用相同短语的接收机，所以请确保短语具有唯一性。仅限使用英文字母和数字。未启用对频短语的固件需要使用传统[对频方法](binding.md)。 + +## 网络选项 + +``` +HOME_WIFI_SSID +HOME_WIFI_PASSWORD +``` +设置这两个参数后，“WiFi升级”模式会尝试使用这些信息连接到已有的WiFi网络。建议配置为你刷写固件时所在环境的 WiFi，以免在刷写过程中需要切换电脑或手机的 WiFi。如果设备无法连接该网络，会自动创建自己的热点。 +密码默认是`expresslrs`，即 ELRS 的全称 + +## 其他选项 + +``` +UNLOCK_HIGHER_POWER +``` +为支持的设备启用更高的输出功率，但可能会导致设备过热甚至损坏。启用前请确保设备有足够的散热或已验证不会过热。 + +``` +UART_INVERTED +``` +~~仅适用于ESP32发射端。**绝大多数遥控器**都需要开启`UART_INVERTED`，如FrSky QX7、TBS Tango 2、RadioMaster TX16S。T8SG V2或Deviation固件则需关闭此选项。~~ +目前**大部分开源遥控器**不需要开启这个功能，若无法使用，请开启此功能 + +## 接收机专用选项 + +
+![2400 RX Options](../assets/images/ConfigurationOptions2400rx.png) +
+ +
+![900 RX Options](../assets/images/ConfigurationOptions900rx.png) +
+ +!!! attention "注意" + 接收机的配置应与高频头保持一致，才能实现同步和对频。 + + +高频头的大部分选项同样适用于接收机。以下是接收机特有的选项： + +### 输出反转 + +``` +RCVR_INVERT_TX +``` +如果你的飞控**只有** SBUS/RXI（RX inverted，RX 反转）焊盘，请开启此选项，将接收机的 CRSF 输出反转，以便使用该焊盘。此选项不会将输出转换为 SBUS 协议，仍需在飞控软件中选择CRSF协议。仅适用于 ESP 系列接收机。 + + +``` +USE_R9MM_R9MINI_SBUS +``` +仅适用于R9MM/R9Mini，此选项会将接收机的 CRSF 输出从侧边的 A9 和 A10 引脚切换到标有“SBUS”的引脚（反转）。同样不会转换为 SBUS 协议，飞控协议仍需选择 CRSF + + +**相当于反转的CRSF协议，可以接到飞控的SBUS焊盘** + +## 这些选项要不要开启？ + +``` +NO_SYNC_ON_ARM +``` +在解锁（ARM）状态下，同步包每5秒发送一次。除非关闭遥测，否则建议保持此选项关闭，否则解锁后失控时无法重新连接。 + +``` +LOCK_ON_FIRST_CONNECTION +``` +失控时保持接收机在最后一次连接的包速率，不会尝试所有包速率重新连接。建议保持此选项开启。 + +## F完整选项列表 + +完整的用户自定义选项请参阅[用户自定义选项页面](../software/user-defines.md)。 + +**全部设置完成！现在可以为你的高频头刷写固件了。** diff --git a/docs/zh/quick-start/getting-started.md b/docs/zh/quick-start/getting-started.md index 48151fc01..0e7985a83 100644 --- a/docs/zh/quick-start/getting-started.md +++ b/docs/zh/quick-start/getting-started.md @@ -1,21 +1,21 @@ --- -template: main.html -description: 在这里开始你的ELRS历程! 这是让你用ELRS飞起来的最全面的指南 +template: i18n/zh/main.html +description: 在这里开始你的 ELRS 历程! 这是让你用 ELRS 飞起来的最全面的指南 --- ![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) -!!! warning "Working In Progress" +!!! attention "Working In Progress" 中文翻译工作正在进行，部分内容尚未完成 !!! warning "注意!" - ELRS团队与制造商紧密合作，负责审核和测试硬件。只有在测试通过后，才会为特定硬件添加ELRS地面站目标。 + ELRS 团队与制造商紧密合作，负责审核和测试硬件。只有在测试通过后，才会为特定硬件添加 ELRS 地面站目标。 - 如果在ELRS地面站中找不到某个硬件，说明该硬件未通过要求，或者制造商选择不合作。在这种情况下，请联系制造商获取技术支持。 + 如果在 ELRS 地面站中找不到某个硬件，说明该硬件未通过要求，或者制造商选择不合作。在这种情况下，请联系制造商获取技术支持。 - 通用目标仅适用于预生产或DIY硬件。现成的硬件应使用专用的硬件目标。 + 通用目标仅适用于预生产或 DIY 硬件。现成的硬件应使用专用的硬件目标。 - 省流: 想支持开源就买在ELRS地面站里有的硬件 + 省流: 想支持开源就买在 ELRS 地面站里有的硬件 ## 快速入门指南 @@ -23,11 +23,11 @@ description: 在这里开始你的ELRS历程! 这是让你用ELRS飞起来的最 你需要熟悉你的遥控器系统(OpenTX/EdgeTX)以及模型设置，因为此指南主要涵盖如何设置你的遥控器以使用ELRS -此外,你还需要熟悉飞控固件(Betaflight、INAV等)调参, 此指南只说明如何将ELRS接收机正确连接到飞控 +此外,你还需要熟悉飞控固件(Betaflight、INAV等)调参, 此指南只说明如何将 ELRS 接收机正确连接到飞控 ### 我应该先做什么？ -你已经有了相关的ELRS硬件，无论是内置ELRS的新遥控器，还是一个外置的ELRS高频头又或者是到手飞套装，你该从哪里开始？ +你已经有了相关的 ELRS 硬件，无论是内置 ELRS 的新遥控器，还是一个外置的ELRS高频头又或者是到手飞套装，你该从哪里开始？ 我们的建议如下： @@ -90,9 +90,9 @@ description: 在这里开始你的ELRS历程! 这是让你用ELRS飞起来的最
-我们希望这些页面能帮助你快速上手ELRS，体验业界最优秀、最具创新性的遥控链路之一。 +我们希望这些页面能帮助你快速上手 ELRS ，体验业界最优秀、最具创新性的遥控链路之一。 -如果你有其他问题或疑虑，或者需要本指南未涵盖的进一步帮助，请加入我们的Discord频道！ +如果你有其他问题或疑虑，或者需要本指南未涵盖的进一步帮助，请加入我们的 Discord 频道！ !!! warning "注意" 国内无法访问Discord diff --git a/docs/zh/quick-start/installing-configurator.md b/docs/zh/quick-start/installing-configurator.md new file mode 100644 index 000000000..4ec62f427 --- /dev/null +++ b/docs/zh/quick-start/installing-configurator.md @@ -0,0 +1,25 @@ +--- +template: i18n/zh/main.html +description: ELRS地面站极大提升了ELRS的易用性，是让你的ELRS设备保持最新状态的不可或缺工具。 +--- + +![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) + +刷写ELRS有两种方式： + +1. [ELRS 地面站](https://github.com/ExpressLRS/ExpressLRS-Configurator/releases) (**推荐**) +2. [开发工具链](../software/toolchain-install.md) (仅限于高级用户) + +## 地面站安装 + +请根据[jurgelenas](https://github.com/jurgelenas/)编写的说明，在[此处](https://github.com/ExpressLRS/ExpressLRS-Configurator/releases)下载最新版的ELRS地面站 +注：Windows用户请下载`exe`结尾的文件 + +
+![Configurator](../assets/images/ConfiguratorScreenCap.png) +
ELRS 地面站
+
+ +每种支持的硬件目标都可以在对应的设备页面查看。请使用左侧导航菜单进入具体硬件页面。 + +在下一页，你将看到可以设置的不同固件选项及其说明。 \ No newline at end of file diff --git a/docs/zh/quick-start/led-status.md b/docs/zh/quick-start/led-status.md new file mode 100644 index 000000000..64bcafc30 --- /dev/null +++ b/docs/zh/quick-start/led-status.md @@ -0,0 +1,71 @@ +--- +template: main.html +description: The LEDs on both the ExpressLRS Receivers and Transmitter Modules are very helpful diagnostic tool in determining the current status of the device. +--- + +![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) + +## Receiver/Transmitter LED Status + +ExpressLRS uses the LED to communicate the status of the transmitter/receiver. + +The conditions and status LED are as follows: + +=== "Receiver Single Color LED" + | | LED Indication | Status | + |-----------------------------------------------------------------------------------------|---------------------------------|-------------------------------------------------------------------| + | ![CONNECTED](../assets/images/LED_ON.gif) | Solid on | Connected to a transmitter, or bootloader mode enabled | + | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | Double blink then pause | Binding mode enabled | + | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | + | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | Triple blink then pause | Connected to transmitter but mismatched model-match configuration | + | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | Medium speed blink 100ms on/off | Radio chip not detected | + | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | Fast blinking 25ms on/off | WiFi mode enabled | + +=== "Receiver RGB LED" + | | LED Indication | Status | + |-------------------------------------------------------------------------------------|--------------------------------|-------------------------------------------------------------------| + | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | Rainbow fade effect | Starting Up | + | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | Green heartbeat | Web update mode enabled | + | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | + | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | Red flashing 100ms on/off | Radio chip not detected | + | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | Orange Double blink then pause | Binding mode enabled | + | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | Orange Triple blink then pause | Connected to transmitter but mismatched model-match configuration | + | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | Solid single color | Connected to a transmitter, color indicates packet rate | + | ![BOOTLOADER_OR_OFF](../assets/images/LED_RGB_OFF.png) | No Light | Off or in Bootloader Mode | + + | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | + |--------------|-------------------------|-----------------------------| + | Red | F1000 | 200 | + | Yellow | F500 | | + | Yellow-Green | D500 | 100 Full | + | Green | D250 | 100 | + | Cyan | 333 Full | | + | Light Blue | 500 | 50 | + | Blue | 250 | 25 | + | Blue-Purple | 150 | | + | Purple | 100 Full | D50 | + | Magenta | 50 | | + +=== "Transmitter RGB LED" + | LED Indication | Status | + |-------------------------------|--------------------------------------------------------| + | Rainbow fade effect | Starting Up | + | Green heartbeat | Web update mode enabled | + | Blue heartbeat | Bluetooth joystick enabled | + | Red flashing 100ms on/off | Radio chip not detected | + | One Orange flash every second | No handset connection | + | Solid single color | Connected to receiver, color indicates packet rate | + | Fading single color | No connection to receiver, color indicates packet rate | + + | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | + |--------------|-------------------------|-----------------------------| + | Red | F1000 | 200 | + | Yellow | F500 | | + | Yellow-Green | D500 | 100 Full | + | Green | D250 | 100 | + | Cyan | 333 Full | | + | Light Blue | 500 | 50 | + | Blue | 250 | 25 | + | Blue-Purple | 150 | | + | Purple | 100 Full | D50 | + | Magenta | 50 | | diff --git a/docs/zh/quick-start/webui.md b/docs/zh/quick-start/webui.md new file mode 100644 index 000000000..010ef4f83 --- /dev/null +++ b/docs/zh/quick-start/webui.md @@ -0,0 +1,307 @@ +--- +template: i18n/zh/main.html +description: ExpressLRS Web UI 是 ExpressLRS 生态系统的重要组成部分。你可以通过它进行 WiFi 固件升级和参数配置。 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-Hardware/master/img/quick-start.png) + +## ExpressLRS Web UI 简介 + +ExpressLRS Web UI 是 ExpressLRS 生态系统的重要组成部分。在项目早期版本中，Web UI 主要用于升级 ExpressLRS 固件，以及日志记录和调试（部分硬件支持）。 + +自 ExpressLRS 3.0 起，Web UI 的功能进一步扩展。现在可以直接修改固件参数，包括对频短语、法规区域（900MHz 设备）、UART 反转等。 + +### 顶部横幅 + +
+![Web UI Banner](../assets/images/web-banner.png) +
ExpressLRS Web UI 顶部横幅
+
+ +### 选项标签页 + +此标签页允许用户无需重新刷写设备即可更改固件选项，还可以导入和导出配置，方便备份设备设置。 + +发射端和接收机通用选项： + +- 对频短语：在此输入你的对频短语，可以覆盖出厂设置或之前刷写的设置。 + + !!! abstract "显示为空？" + 该字段不会显示明文短语。如果看到是空白，不用担心。下一个 UID 字段已包含相关信息。 + +- UID：当你在上方输入对频短语时，这个只读字段会自动更新为 UID，这是实际存储在设备中的内容。 + +- 法规区域：仅适用于 900MHz 系统。此字段允许用户更改设备的法规区域。 + + !!! abstract "2.4GHz 怎么办？" + EU_CE 法规区域是编译时选项，LBT 代码需要在编译时加入才能生效。 + +- WiFi“自动开启”间隔（秒）：设置设备上电后多久自动进入 WiFi 模式（发射端无有效 CRSF 信号或接收机无同步包时）。 + +=== "接收机选项" + +
+ ![Web UI Banner](../assets/images/web-options-rx.png) +
ExpressLRS 接收机选项标签页
+
+ + - UART 波特率：接收机与飞控或其他串口设备通信的速率。一般保持默认 420000。 + - 特例：如使用 KISS/Kiss Ultra 固件，请设置为 400000，因为 KISS 使用该速率。 + + - 反转 TX 引脚：一般保持关闭。该选项会反转接收机 TX 引脚输出的 CRSF 信号。 + - 如果接收机要接到飞控的 SBUS 焊盘（没有额外的非反转 RX 焊盘），需开启此选项，并在飞控配置中执行 `set serialrx_inverted = on`。 + + - 首次连接锁定：如果你不更改射频模式/包速率，建议开启此项以加快重连速度。 + +=== "发射端选项" + +
+ ![Web UI Banner](../assets/images/web-options-tx.png) +
ExpressLRS 发射端选项标签页
+
+ + - 遥测报告间隔：控制遥测包发送频率。默认 240LU，已足够快，适用于 EdgeTX 或 OpenTX。 + + - UART 反转：如在 OpenTX 或 EdgeTX 遥控器上使用发射端模块，需保持开启。外部模块仓的 S.Port 引脚为反转双向引脚。 + + - 风扇运行时间（秒）：控制发射端模块风扇在功率降到 Lua 脚本阈值以下后继续运行的时间。 + +### WiFi 标签页 + +
+![Web UI Banner](../assets/images/web-homenetwork.png) +
ExpressLRS WebUI WiFi 标签页
+
+ +### 模型标签页 + +
+![Web UI Banner](../assets/images/web-rxmodel.png) +
ExpressLRS 接收机模型标签页
+
+ +
+![Web UI Banner](../assets/images/web-pwmoutput.png) +
ExpressLRS PWM 接收机输出设置
+
+ +### 按钮标签页 + +目前仅适用于 RadioMaster Ranger 模块。 + +
+![Web UI Banner](../assets/images/web-buttonsTX.png) +
ExpressLRS 发射端按钮标签页
+
+ +### 固件升级标签页 + +=== "接收机升级标签页" +
+ ![Web UI Banner](../assets/images/web-update-rx.png) +
ExpressLRS 接收机升级标签页
+
+ +=== "发射端升级标签页" +
+ ![Web UI Banner](../assets/images/web-update-tx.png) +
ExpressLRS 发射端升级标签页
+
+ +## 如何进入 Web UI +=== "接收机" + + 1. 让接收机进入 WiFi 模式。 + + === "自动 WiFi 开启" + + 1. 确保遥控器和发射端模块关闭。 + + 2. 给接收机断电再上电。LED 会慢闪，如下图所示。 + +
+ ![RX Waiting](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) +
+ + ??? warning "接收机 LED 不闪烁！（点击展开）" + 如果 LED 常亮，可能是进入了 Bootloader 模式。请重新接线到其他 UART。如果之前升级失败，可能已软砖。请参考[救砖指南](../quick-start/unbricking.md)。 + + 3. 等约 60 秒，或直到接收机 LED 快速闪烁，表示已进入 WiFi 模式。 + +
+ ![RX WiFi](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) +
+ + === "通过 Lua 脚本" + 1. 确保接收机和发射端已对频并同步。遥控器主屏应有 RSSI 指示，接收机 LED 常亮。 + +
+ ![RX Bound](../assets/images/LED_ON.gif) +
+ + 2. 按遥控器上的 ++"SYS"++ 键。 + - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 + 3. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。 + +
+ ![Lua Script] +
+ + - 如果没有该脚本，请从[这里](./transmitters/lua-howto.md)下载并保存到 SD 卡 Scripts/Tools/ 文件夹。 + 4. 按 ++enter++ 加载脚本。 + +
+ ![Lua Running] +
+ + - 如果卡在 "Loading..."，请返回[遥控器准备](./transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + - 右上角应有 C，表示发射端和接收机已连接。 + 5. 下拉选择 `Wifi Connectivity` 并按 ++enter++。 + 6. 选择 `Enable RX WiFi` 并按 ++enter++。 + +
+ ![Lua WiFi RX] +
+ + 7. 会短暂显示 `WiFi Running`，接收机 LED 快速闪烁，表示已进入 WiFi 模式。 + +
+ ![RX WiFi](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) +
+ + !!! info "说明" + 接收机进入 WiFi 模式后会断开与发射端的连接，遥控器会提示 "Telemetry Lost"（需安装语音包）。 + + === "通过按键" + 1. 如果接收机有 Boot 按钮，可用此方法进入 WiFi 模式。 + - 找到接收机上的 Boot 按钮： + +
+ ![betafpv SuperD](../assets/images/BetaFPVSuperD.png) +
带 Boot 按钮的接收机示例
+
+ + 2. 长按 Boot 按钮 5 秒，LED 快速闪烁，表示进入 WiFi 模式。 + +
+ ![RX WiFi](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) +
+ + 4. 搜索 `ExpressLRS RX` WiFi 热点。 + ![WiFi Hotspot](../assets/images/WifiHotspot.png){ align=right } + + - 如果接收机已刷入家庭 WiFi SSID 和密码，并能连接该网络，则不会显示该热点。 + - 热点密码为 `expresslrs`。 + +
+ + 5. 在浏览器中访问 Web UI，地址如下： + - http://10.0.0.1/ —— 连接到 `ExpressLRS RX` 热点时使用 + + !!! Note + 该 IP 也常被路由器占用。如果电脑有网线连接，可能会打开路由器或 ISP 配置页面而不是 Web UI。 + + 建议先断开网络或用手机、平板等设备访问。 + + !!! Note + 有些设备会弹出网络登录窗口，点进去可能是不完整的 WebUI。请手动在浏览器输入 http://10.0.0.1/。 + + - http://elrs_rx.local —— 如果接收机已配置家庭 WiFi 并连接 + + !!! Note + 如果无法访问，可能是电脑或网络未启用 MDNS。 + + ??? tip "用 IP 地址访问！（点击展开）" + === "`arp` 命令" + + 1. 打开命令提示符窗口。 + 2. 输入 `arp -a`，查看所有网络设备。 + 3. 依次尝试标记为 `Dynamic` 的 IP 地址，直到打开 ExpressLRS Web UI。 + + === "路由器 DHCP 列表" + 1. 登录路由器后台。 + 2. 查看 DHCP 列表，找到 "elrs" 设备。 + 3. 记下分配的 IP 地址。 + 4. 在浏览器中输入该 IP 地址访问。 + +=== "发射端模块" + + 1. 让发射端模块进入 WiFi 模式。 + + === "通过 ExpressLRS Lua 脚本" + + 1. 按遥控器上的 ++"SYS"++ 键。 + - 老款遥控器或只有一个菜单键的需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 + 2. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。 + +
+ ![Lua Script] +
+ + - 如果没有该脚本，请从[这里](./transmitters/lua-howto.md)下载并保存到 SD 卡 Scripts/Tools/ 文件夹。 + 3. 按 ++enter++ 加载脚本。 + +
+ ![Lua Running] +
+ + - 如果卡在 "Loading..."，请返回[遥控器准备](./transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + 4. 下拉选择 `Wifi Connectivity` 并按 ++enter++。 + 5. 选择 `Enable WiFi` 并按 ++enter++。 + +
+ ![Lua WiFi] +
+ + 6. 显示 `WiFi Running`，发射端模块已进入 WiFi 模式。 + - 如果脚本报语法错误，不用担心，模块已进入 WiFi 模式。可能是遥控器或固件较旧，或 Lua 脚本版本较新。 + + === "外部模块脱离遥控器" + + 1. 将发射端模块从遥控器模块仓取下，用外部电源（2S）或 USB 供电。 + 2. 等待 60 秒，RGB LED 会变为绿色呼吸灯，表示进入 WiFi 模式。 + - 带 OLED 屏的模块也会显示 WiFi 模式提示。 + + 2. 搜索 `ExpressLRS TX` WiFi 热点。 + ![WiFi Hotspot](../assets/images/WifiHotspotTX.png){ align=right } + + - 如果发射端模块已刷入家庭 WiFi SSID 和密码，并能连接该网络，则不会显示该热点。 + - 热点密码为 `expresslrs`。 + +
+ + 3. 在浏览器中访问 Web UI，地址如下： + - http://10.0.0.1/ —— 连接到 `ExpressLRS TX` 热点时使用 + + !!! Note + 该 IP 也常被路由器占用。如果电脑有网线连接，可能会打开路由器或 ISP 配置页面而不是 Web UI。 + + 建议先断开网络或用手机、平板等设备访问。 + + !!! Note + 有些设备会弹出网络登录窗口，点进去可能是不完整的 WebUI。请手动在浏览器输入 http://10.0.0.1/。 + + - http://elrs_tx.local —— 如果发射端模块已配置家庭 WiFi 并连接 + + !!! Note + 如果无法访问，可能是电脑或网络未启用 MDNS。 + + ??? tip "用 IP 地址访问！（点击展开）" + === "`arp` 命令" + + 1. 打开命令提示符窗口。 + 2. 输入 `arp -a`，查看所有网络设备。 + 3. 依次尝试标记为 `Dynamic` 的 IP 地址，直到打开 ExpressLRS Web UI。 + + === "路由器 DHCP 列表" + 1. 登录路由器后台。 + 2. 查看 DHCP 列表，找到 "elrs" 设备。 + 3. 记下分配的 IP 地址。 + 4. 在浏览器中输入该 IP 地址访问。 + +[Lua Script]: ../assets/images/lua1.jpg +[Lua Running]: ../assets/images/lua/config-bw.png +[Lua WiFi]: ../assets/images/lua/wifi-bw.png +[Lua WiFi RX]: ../assets/images/lua/wifi-bw-rx.png \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index ca91851a9..6aa6a2e4c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -90,8 +90,8 @@ plugins: - 快速开始: - 入门: quick-start/getting-started.md - 安装地面站: quick-start/installing-configurator.md - - Firmware Options: quick-start/firmware-options.md - - The Web UI: quick-start/webui.md + - 固件选项: quick-start/firmware-options.md + - WebUI: quick-start/webui.md - Transmitters: - Radio Preparation: quick-start/transmitters/tx-prep.md - Checking FW Version: quick-start/transmitters/firmware-version.md @@ -159,9 +159,9 @@ plugins: - DIY 2400RX: quick-start/receivers/diy2400.md - 烧录后: - LED Status: quick-start/led-status.md - - Binding ExpressLRS: quick-start/binding.md + - 对频: quick-start/binding.md - Before First Flight: quick-start/pre-1stflight.md - - Ardupilot Setup: quick-start/ardupilot-setup.md + - Ardupilot 设置: quick-start/ardupilot-setup.md - Troubleshooting: quick-start/troubleshooting.md - Unbricking: quick-start/unbricking.md - 软件: From af4da7cc9ecac7282d7b8b7862ef97e3cbaccc40 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 11:15:53 +0800 Subject: [PATCH 04/19] sorry, changed wrong file --- docs/quick-start/led-status.md | 118 +++++++++++++++--------------- docs/zh/quick-start/led-status.md | 118 +++++++++++++++--------------- 2 files changed, 118 insertions(+), 118 deletions(-) diff --git a/docs/quick-start/led-status.md b/docs/quick-start/led-status.md index 8d8992f74..64bcafc30 100644 --- a/docs/quick-start/led-status.md +++ b/docs/quick-start/led-status.md @@ -1,71 +1,71 @@ --- -template: i18n/zh/main.html -description: ExpressLRS 接收机和发射端模块上的 LED 是非常有用的诊断工具，可以帮助你判断设备当前状态。 +template: main.html +description: The LEDs on both the ExpressLRS Receivers and Transmitter Modules are very helpful diagnostic tool in determining the current status of the device. --- ![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) -## 接收机/发射端 LED 状态 +## Receiver/Transmitter LED Status -ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 +ExpressLRS uses the LED to communicate the status of the transmitter/receiver. -不同状态下的 LED 指示如下： +The conditions and status LED are as follows: -=== "接收机单色 LED" - | | LED 指示 | 状态说明 | - |-----------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| - | ![CONNECTED](../assets/images/LED_ON.gif) | 常亮 | 已连接到发射端，或处于 Bootloader 模式 | - | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | 快速双闪后暂停 | 进入对频模式 | - | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | - | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | 三快闪后暂停 | 已连接发射端但模型匹配参数不一致 | - | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | 中速闪烁 100ms 开/关 | 无法检测到射频芯片 | - | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | 快速闪烁 25ms 开/关 | 进入 WiFi 模式 | +=== "Receiver Single Color LED" + | | LED Indication | Status | + |-----------------------------------------------------------------------------------------|---------------------------------|-------------------------------------------------------------------| + | ![CONNECTED](../assets/images/LED_ON.gif) | Solid on | Connected to a transmitter, or bootloader mode enabled | + | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | Double blink then pause | Binding mode enabled | + | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | + | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | Triple blink then pause | Connected to transmitter but mismatched model-match configuration | + | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | Medium speed blink 100ms on/off | Radio chip not detected | + | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | Fast blinking 25ms on/off | WiFi mode enabled | -=== "接收机 RGB LED" - | | LED 指示 | 状态说明 | - |-------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| - | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | 彩虹渐变效果 | 启动中 | - | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | 绿色心跳 | 进入 Web 更新模式 | - | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | - | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | - | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | 橙色双闪后暂停 | 进入对频模式 | - | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | 橙色三闪后暂停 | 已连接发射端但模型匹配参数不一致 | - | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | 单色常亮 | 已连接到发射端，颜色表示包速率 | - | ![BOOTLOADER_OR_OFF](../assets/images/LED_RGB_OFF.png) | 熄灭 | 关闭或处于 Bootloader 模式 | +=== "Receiver RGB LED" + | | LED Indication | Status | + |-------------------------------------------------------------------------------------|--------------------------------|-------------------------------------------------------------------| + | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | Rainbow fade effect | Starting Up | + | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | Green heartbeat | Web update mode enabled | + | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | + | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | Red flashing 100ms on/off | Radio chip not detected | + | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | Orange Double blink then pause | Binding mode enabled | + | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | Orange Triple blink then pause | Connected to transmitter but mismatched model-match configuration | + | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | Solid single color | Connected to a transmitter, color indicates packet rate | + | ![BOOTLOADER_OR_OFF](../assets/images/LED_RGB_OFF.png) | No Light | Off or in Bootloader Mode | - | LED 颜色 | 2.4GHz 包速率 (Hz) | 915/868MHz 包速率 (Hz) | - |---------------|--------------------|------------------------| - | 红色 | F1000 | 200 | - | 黄色 | F500 | | - | 黄绿色 | D500 | 100 Full | - | 绿色 | D250 | 100 | - | 青色 | 333 Full | | - | 浅蓝色 | 500 | 50 | - | 蓝色 | 250 | 25 | - | 蓝紫色 | 150 | | - | 紫色 | 100 Full | D50 | - | 品红色 | 50 | | + | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | + |--------------|-------------------------|-----------------------------| + | Red | F1000 | 200 | + | Yellow | F500 | | + | Yellow-Green | D500 | 100 Full | + | Green | D250 | 100 | + | Cyan | 333 Full | | + | Light Blue | 500 | 50 | + | Blue | 250 | 25 | + | Blue-Purple | 150 | | + | Purple | 100 Full | D50 | + | Magenta | 50 | | -=== "发射端 RGB LED" - | LED 指示 | 状态说明 | - |-------------------------------|--------------------------------------------------------------| - | 彩虹渐变效果 | 启动中 | - | 绿色心跳 | 进入 Web 更新模式 | - | 蓝色心跳 | 启用蓝牙摇杆 | - | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | - | 每秒橙色闪烁一次 | 未连接遥控器 | - | 单色常亮 | 已连接接收机，颜色表示包速率 | - | 单色渐变 | 未连接接收机，颜色表示包速率 | +=== "Transmitter RGB LED" + | LED Indication | Status | + |-------------------------------|--------------------------------------------------------| + | Rainbow fade effect | Starting Up | + | Green heartbeat | Web update mode enabled | + | Blue heartbeat | Bluetooth joystick enabled | + | Red flashing 100ms on/off | Radio chip not detected | + | One Orange flash every second | No handset connection | + | Solid single color | Connected to receiver, color indicates packet rate | + | Fading single color | No connection to receiver, color indicates packet rate | - | LED 颜色 | 2.4GHz 包速率 (Hz) | 915/868MHz 包速率 (Hz) | - |---------------|--------------------|------------------------| - | 红色 | F1000 | 200 | - | 黄色 | F500 | | - | 黄绿色 | D500 | 100 Full | - | 绿色 | D250 | 100 | - | 青色 | 333 Full | | - | 浅蓝色 | 500 | 50 | - | 蓝色 | 250 | 25 | - | 蓝紫色 | 150 | | - | 紫色 | 100 Full | D50 | - | 品 \ No newline at end of file + | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | + |--------------|-------------------------|-----------------------------| + | Red | F1000 | 200 | + | Yellow | F500 | | + | Yellow-Green | D500 | 100 Full | + | Green | D250 | 100 | + | Cyan | 333 Full | | + | Light Blue | 500 | 50 | + | Blue | 250 | 25 | + | Blue-Purple | 150 | | + | Purple | 100 Full | D50 | + | Magenta | 50 | | diff --git a/docs/zh/quick-start/led-status.md b/docs/zh/quick-start/led-status.md index 64bcafc30..8d8992f74 100644 --- a/docs/zh/quick-start/led-status.md +++ b/docs/zh/quick-start/led-status.md @@ -1,71 +1,71 @@ --- -template: main.html -description: The LEDs on both the ExpressLRS Receivers and Transmitter Modules are very helpful diagnostic tool in determining the current status of the device. +template: i18n/zh/main.html +description: ExpressLRS 接收机和发射端模块上的 LED 是非常有用的诊断工具，可以帮助你判断设备当前状态。 --- ![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) -## Receiver/Transmitter LED Status +## 接收机/发射端 LED 状态 -ExpressLRS uses the LED to communicate the status of the transmitter/receiver. +ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 -The conditions and status LED are as follows: +不同状态下的 LED 指示如下： -=== "Receiver Single Color LED" - | | LED Indication | Status | - |-----------------------------------------------------------------------------------------|---------------------------------|-------------------------------------------------------------------| - | ![CONNECTED](../assets/images/LED_ON.gif) | Solid on | Connected to a transmitter, or bootloader mode enabled | - | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | Double blink then pause | Binding mode enabled | - | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | - | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | Triple blink then pause | Connected to transmitter but mismatched model-match configuration | - | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | Medium speed blink 100ms on/off | Radio chip not detected | - | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | Fast blinking 25ms on/off | WiFi mode enabled | +=== "接收机单色 LED" + | | LED 指示 | 状态说明 | + |-----------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| + | ![CONNECTED](../assets/images/LED_ON.gif) | 常亮 | 已连接到发射端，或处于 Bootloader 模式 | + | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | 快速双闪后暂停 | 进入对频模式 | + | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | + | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | 三快闪后暂停 | 已连接发射端但模型匹配参数不一致 | + | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | 中速闪烁 100ms 开/关 | 无法检测到射频芯片 | + | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | 快速闪烁 25ms 开/关 | 进入 WiFi 模式 | -=== "Receiver RGB LED" - | | LED Indication | Status | - |-------------------------------------------------------------------------------------|--------------------------------|-------------------------------------------------------------------| - | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | Rainbow fade effect | Starting Up | - | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | Green heartbeat | Web update mode enabled | - | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | Slow blink 500ms on/off | Waiting for connection from transmitter | - | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | Red flashing 100ms on/off | Radio chip not detected | - | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | Orange Double blink then pause | Binding mode enabled | - | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | Orange Triple blink then pause | Connected to transmitter but mismatched model-match configuration | - | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | Solid single color | Connected to a transmitter, color indicates packet rate | - | ![BOOTLOADER_OR_OFF](../assets/images/LED_RGB_OFF.png) | No Light | Off or in Bootloader Mode | +=== "接收机 RGB LED" + | | LED 指示 | 状态说明 | + |-------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| + | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | 彩虹渐变效果 | 启动中 | + | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | 绿色心跳 | 进入 Web 更新模式 | + | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | + | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | + | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | 橙色双闪后暂停 | 进入对频模式 | + | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | 橙色三闪后暂停 | 已连接发射端但模型匹配参数不一致 | + | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | 单色常亮 | 已连接到发射端，颜色表示包速率 | + | ![BOOTLOADER_OR_OFF](../assets/images/LED_RGB_OFF.png) | 熄灭 | 关闭或处于 Bootloader 模式 | - | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | - |--------------|-------------------------|-----------------------------| - | Red | F1000 | 200 | - | Yellow | F500 | | - | Yellow-Green | D500 | 100 Full | - | Green | D250 | 100 | - | Cyan | 333 Full | | - | Light Blue | 500 | 50 | - | Blue | 250 | 25 | - | Blue-Purple | 150 | | - | Purple | 100 Full | D50 | - | Magenta | 50 | | + | LED 颜色 | 2.4GHz 包速率 (Hz) | 915/868MHz 包速率 (Hz) | + |---------------|--------------------|------------------------| + | 红色 | F1000 | 200 | + | 黄色 | F500 | | + | 黄绿色 | D500 | 100 Full | + | 绿色 | D250 | 100 | + | 青色 | 333 Full | | + | 浅蓝色 | 500 | 50 | + | 蓝色 | 250 | 25 | + | 蓝紫色 | 150 | | + | 紫色 | 100 Full | D50 | + | 品红色 | 50 | | -=== "Transmitter RGB LED" - | LED Indication | Status | - |-------------------------------|--------------------------------------------------------| - | Rainbow fade effect | Starting Up | - | Green heartbeat | Web update mode enabled | - | Blue heartbeat | Bluetooth joystick enabled | - | Red flashing 100ms on/off | Radio chip not detected | - | One Orange flash every second | No handset connection | - | Solid single color | Connected to receiver, color indicates packet rate | - | Fading single color | No connection to receiver, color indicates packet rate | +=== "发射端 RGB LED" + | LED 指示 | 状态说明 | + |-------------------------------|--------------------------------------------------------------| + | 彩虹渐变效果 | 启动中 | + | 绿色心跳 | 进入 Web 更新模式 | + | 蓝色心跳 | 启用蓝牙摇杆 | + | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | + | 每秒橙色闪烁一次 | 未连接遥控器 | + | 单色常亮 | 已连接接收机，颜色表示包速率 | + | 单色渐变 | 未连接接收机，颜色表示包速率 | - | LED Color | 2.4GHz Packet rate (Hz) | 915/868MHz Packet rate (Hz) | - |--------------|-------------------------|-----------------------------| - | Red | F1000 | 200 | - | Yellow | F500 | | - | Yellow-Green | D500 | 100 Full | - | Green | D250 | 100 | - | Cyan | 333 Full | | - | Light Blue | 500 | 50 | - | Blue | 250 | 25 | - | Blue-Purple | 150 | | - | Purple | 100 Full | D50 | - | Magenta | 50 | | + | LED 颜色 | 2.4GHz 包速率 (Hz) | 915/868MHz 包速率 (Hz) | + |---------------|--------------------|------------------------| + | 红色 | F1000 | 200 | + | 黄色 | F500 | | + | 黄绿色 | D500 | 100 Full | + | 绿色 | D250 | 100 | + | 青色 | 333 Full | | + | 浅蓝色 | 500 | 50 | + | 蓝色 | 250 | 25 | + | 蓝紫色 | 150 | | + | 紫色 | 100 Full | D50 | + | 品 \ No newline at end of file From 504ad8e992fa211ebe16a86c2a369473934d3b51 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 11:18:59 +0800 Subject: [PATCH 05/19] zh: pre-1stflight.md --- docs/zh/quick-start/pre-1stflight.md | 160 +++++++++++++++++++++++++++ mkdocs.yml | 4 +- 2 files changed, 162 insertions(+), 2 deletions(-) create mode 100644 docs/zh/quick-start/pre-1stflight.md diff --git a/docs/zh/quick-start/pre-1stflight.md b/docs/zh/quick-start/pre-1stflight.md new file mode 100644 index 000000000..13ba62867 --- /dev/null +++ b/docs/zh/quick-start/pre-1stflight.md @@ -0,0 +1,160 @@ +--- +template: i18n/zh/main.html +description: 什么是性能测试？如何设置 Aux1 解锁？OSD 上的 RSSI dBm 和链路质量怎么显示？ExpressLRS 遥测怎么配置？你来对地方了！ +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +在你第一次使用 ExpressLRS 飞行前，建议对设备进行一些调整，以确保飞行顺利愉快！ + +## 模式 + +默认情况下，ExpressLRS 对 AUX 开关采用有限位数（AUX1 用 1 位，其他 AUX 通道用 3-4 位），这会导致 AUX 通道在 Betaflight/INAV 上只有 8 或 16 档分辨率。大多数情况下已经足够（尤其是多旋翼），但如果你需要更高分辨率，可以启用 **Wide** Switch Mode 选项，将 AUX2-AUX8 的分辨率扩展到 128 档。详情请参考 [开关模式页面](../software/switch-config.md)。 + +需要注意的是，Aux1 应作为你的解锁（ARM）开关，低电平（约 1000us）为未解锁，高电平（约 2000us）为已解锁。AUX1 是低延迟开关，每个包都会发送，只支持开/关（两档）操作。ExpressLRS 用 AUX1 判断模型是否解锁，这是最可靠的解锁方式。如果你把解锁开关设在其他 AUX 通道，可能要等几个包才会发送，没有保证接收机能及时收到。 + +!!! warning "警告" + 请确保你的 **ARM 模式在 AUX1 通道，且已解锁状态为 ~2000。** + +
+![Modes](../assets/images/Modes.jpg) +
+ +## RSSI 和链路质量 + +要在 OSD 上显示 RSSI 和链路质量，请将 **RSSI Channel** 和 **RSSI_ADC** 都设置为 {==Disabled==}，这两个设置在接收机标签页。 + +
+![Conf Tab](../assets/images/ConfigurationTab.png) +
+ +
+![INAV Config](../assets/images/FC-rxconfig-INAV.png) +
+ +在 OSD 标签页，使用 **Link Quality** 和 **RSSI dBm value** 元素（不要用 "RSSI Value"）。INAV 在 `CRSF RX Statistics` 区域显示这些内容。 + +
+![OSD](../assets/images/OSD.jpg) +
+ +如果你想启用 RSSI dBm 警告，需要在 CLI 用 `set osd_rssi_dbm_alarm = -100` 修改报警阈值。合理的数值是比 ELRS.lua 显示的包速率灵敏度高 5-10（比如 250Hz=-108，则报警设为 -103 到 -98）。 + +同样，如果你想修改 LQ 报警阈值，可以用 CLI 命令 `set osd_link_quality_alarm = x`，`x` 为你的报警阈值。`60` 是一个不错的起点。 + +如果你用的是 DJI V1 或 V2（未 root），只能用 "RSSI Value" 作为 OSD 元素，所以你需要在接收机标签页选择 AUX11（LQ）或 AUX12（RSSI）作为 RSSI Channel（见上图）。 + +对于支持 "Canvas Mode" 或 MSP DisplayPort 的数字图传（Walksnail Avatar、HDZero、DJI O3），配置方式与模拟 FPV 一样，无需设置 RSSI Channel（保持禁用）。 + +更多信号指标信息请参考这篇[信号健康文章](../info/signal-health.md)。 + +## 性能测试 + +
+![ExpressLRS Bench Test](../assets/images/BenchTest.jpg) +
ExpressLRS 性能测试
+
+ +上图是性能测试，用于判断你的遥控信号是否正常。这可以帮助你检查天线（尤其是 R9 的 Super 8）或硬件是否有问题。 + +- 用 Lua 脚本将 ExpressLRS 模块设为最低功率，包速率无所谓。 +- 遥控器距离接收机 1 米（3 英尺），通电。确保接收机和 TX 模块天线方向一致。（建议暂时断开 VTX/图传，或让 VTX 进入 pit 模式，或用风扇吹散热）。 +- 用 OSD 或遥控器的 Telemetry 页面，记录 RSSI dBm 或 1RSS 遥测数据。 + +900MHz 硬件，-20dBm 左右说明硬件正常；2.4GHz 硬件，-40dBm 到 -25dBm 都可以。如果数值比这些低（越接近 0 越好），可以检查： + +- ExpressLRS 模块天线是否松动。有些 3D 打印模块壳体太厚，RP-SMA/SMA 接头拧不紧，建议拧紧螺母。 +- 天线尾线是否损坏或未正确连接主板。 +- 用 SMD 天线的接收机，数值会比线天线低。如果热缩管包裹、装在 whoop 机罩、碳板包围或埋在机身里，信号会进一步衰减。 +- FrSky 的 Super 8 天线（大多数 R9M 标配）容易损坏或用几周就性能下降。建议更换，或临时修复可在同轴线屏蔽层和 RP-SMA 连接处全焊一圈。另一故障点是同轴线与天线主动元件的连接，天线扭动可能导致断开。 + +
+![NotSuper8](../assets/images/super8notsuper.jpg) +
+ +
+![NotSuper8 for sure](../assets/images/super8notsuper2.jpg) +
Super8 天线常见故障点
+
+ +- 检查接收机是否有缺失元件，比如 RF 滤波器（在天线或 UFL 附近），也要检查 SMD 天线是否损坏或焊接良好。 + +
+![missing filter](../assets/images/missingfilter.png) +
+ +- 大多数 DIY 模块需要把 E28 上的 0 欧姆电阻从 PCB 天线侧移到 UFL 侧。也可以用焊桥，但要确保焊在正确的焊盘上。 +- 换接收机或 TX 模块的天线；大多数 ExpressLRS 接收机用 IPEX 1/UFL 接头，只要天线频率合适就能用。2.4GHz 模块可以用旧 WiFi 路由器天线，但不要用双频天线。注意天线接头类型（R9 模块用 RP-SMA，大多数 ExpressLRS 模块用 SMA）。 + +## Blackbox + +Blackbox 可以用来评估飞行时射频链路性能。将 BB 设置为 debug 模式 `RC_SMOOTHING_RATE`，可记录 Betaflight 从接收机收到 RC 包的速率。 + +## 遥测 + +接收机会转发飞控发来的部分遥测数据。禁用某些消息只在飞控固件支持时有效。Betaflight 可用如下 CLI 设置禁用遥测项： + +``` +# 禁用姿态遥测 +set telemetry_disabled_pitch = ON +set telemetry_disabled_roll = ON +set telemetry_disabled_heading = ON +# 禁用电池遥测 +set telemetry_disabled_voltage = ON +set telemetry_disabled_current = ON +set telemetry_disabled_fuel = ON +# 禁用 GPS 遥测 +set telemetry_disabled_altitude = ON +set telemetry_disabled_lat_long = ON +set telemetry_disabled_ground_speed = ON +set telemetry_disabled_heading = ON +# 禁用飞行模式遥测（BF >4.2.9） +set telemetry_disabled_mode = ON +``` + +由于遥测消息优先级低，传输数据可能需要一些时间。Lua 设置脚本中的遥测比率控制消息发送频率。比如 1:2 表示每两条消息发一条遥测，数据传输很快；1:64 表示每 64 条消息发一条遥测，传输很慢。 + +刷新率也影响传输速度。50Hz 比 200Hz 慢。如果需要快速遥测更新，选择高刷新率和较高遥测比率，比如 200Hz 和 1:16 通常效果不错。不同速率和比率下的遥测带宽详见[遥测带宽页面](../info/telem-bandwidth.md)。 + +完成遥测设置后，打开遥控器的遥测页面，选择 "Discover new sensors"，等待列表填满。 + +!!! hint "* 星号指示" + 每行有一个 * 星号，表示该遥测传感器刚刚更新。 + +!!! hint "[ ] 方括号指示" + 如果某行不变且名称为方括号，说明该传感器长时间未更新。 + +RSSI 和链路质量等首行数值应始终更新（星号闪烁）。如果每秒没有多次更新，遥控器会发出 "telemetry warning"。为避免警告，可用 TLM_REPORT_INTERVAL_MS 设置。 + +效果如下（如果不是这样，说明设置有问题）： + +
+![Link data update speed](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/wiki-from-discord/link.gif) +
+ +其他数值更新频率不同（取决于刷新率和遥测比率）。比如 50Hz 和 1:64 时更新很慢，每个传感器要几秒： + +
+![Slow update rate](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/wiki-from-discord/slow.gif) +
+ +如果用 200Hz 和 1:2 遥测比率，星号几乎不闪，因为更新太快： + +
+![Fast update rate](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/wiki-from-discord/fast.gif) +
+ +## MSP + +可用 Betaflight lua 脚本从遥控器配置 Betaflight。 +需要 RX+TX 支持遥测功能。如果 OpenTX 遥测页面没有所有传感器的定期更新，LUA 脚本也无法正常工作。 + +为获得响应式 UI，ExpressLRS 应配置为高速数据传输，比如 `200Hz/500Hz` 配合 `1:2` Tlm 比率和 `400000` 串口波特率。当前 MSP 限制为 `50Hz`、`115200` 波特率，不能用 `500Hz` 刷新率。VTX 表首次下载较慢，但会缓存。 + +如果保存设置时出现 "retrying" 提示，说明 Lua 脚本未及时收到响应，但通常设置已生效，刷新页面即可。推荐设置下不会出现此问题，慢速设置可能会出现。 + +## MAVLINK + +详见 [Airport](../software/airport.md)。 + +**全部完成，可以起飞了！** \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 6aa6a2e4c..aa44c6889 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -158,9 +158,9 @@ plugins: - DIY 900RX: quick-start/receivers/diy900.md - DIY 2400RX: quick-start/receivers/diy2400.md - 烧录后: - - LED Status: quick-start/led-status.md + - LED 状态: quick-start/led-status.md - 对频: quick-start/binding.md - - Before First Flight: quick-start/pre-1stflight.md + - 首飞之前: quick-start/pre-1stflight.md - Ardupilot 设置: quick-start/ardupilot-setup.md - Troubleshooting: quick-start/troubleshooting.md - Unbricking: quick-start/unbricking.md From 8ab80b6dab5efd4d0ca517c2c144ff2570561954 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 11:31:29 +0800 Subject: [PATCH 06/19] update --- docs/zh/quick-start/led-status.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh/quick-start/led-status.md b/docs/zh/quick-start/led-status.md index 8d8992f74..69c7b554a 100644 --- a/docs/zh/quick-start/led-status.md +++ b/docs/zh/quick-start/led-status.md @@ -68,4 +68,4 @@ ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 | 蓝色 | 250 | 25 | | 蓝紫色 | 150 | | | 紫色 | 100 Full | D50 | - | 品 \ No newline at end of file + | 品红色 | 50 | | \ No newline at end of file From 86bd086bd2ef45f83f0af0a018ab111afe88a319 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 22:21:26 +0800 Subject: [PATCH 07/19] update --- docs/zh/quick-start/led-status.md | 22 +++++++++++----------- docs/zh/quick-start/pre-1stflight.md | 4 +++- 2 files changed, 14 insertions(+), 12 deletions(-) diff --git a/docs/zh/quick-start/led-status.md b/docs/zh/quick-start/led-status.md index 69c7b554a..6b5f6899c 100644 --- a/docs/zh/quick-start/led-status.md +++ b/docs/zh/quick-start/led-status.md @@ -16,18 +16,18 @@ ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 |-----------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| | ![CONNECTED](../assets/images/LED_ON.gif) | 常亮 | 已连接到发射端，或处于 Bootloader 模式 | | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | 快速双闪后暂停 | 进入对频模式 | - | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | - | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | 三快闪后暂停 | 已连接发射端但模型匹配参数不一致 | - | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | 中速闪烁 100ms 开/关 | 无法检测到射频芯片 | - | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | 快速闪烁 25ms 开/关 | 进入 WiFi 模式 | + | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | 每500ms闪烁一次 | 等待与发射端连接 | + | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | 三次快闪后暂停 | 已连接发射端但模型匹配参数不一致 | + | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | 每100ms闪烁一次 | 无法检测到射频芯片 | + | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | 每25ms闪烁一次 | 进入 WiFi 模式 | === "接收机 RGB LED" | | LED 指示 | 状态说明 | |-------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | 彩虹渐变效果 | 启动中 | - | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | 绿色心跳 | 进入 Web 更新模式 | - | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | 慢闪 500ms 开/关 | 等待与发射端连接 | - | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | + | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | 绿色闪烁 | 进入 Web 更新模式 | + | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | 橙色 每500ms闪烁一次 | 等待与发射端连接 | + | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | 红色 每100ms闪烁一次 | 无法检测到射频芯片 | | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | 橙色双闪后暂停 | 进入对频模式 | | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | 橙色三闪后暂停 | 已连接发射端但模型匹配参数不一致 | | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | 单色常亮 | 已连接到发射端，颜色表示包速率 | @@ -50,10 +50,10 @@ ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 | LED 指示 | 状态说明 | |-------------------------------|--------------------------------------------------------------| | 彩虹渐变效果 | 启动中 | - | 绿色心跳 | 进入 Web 更新模式 | - | 蓝色心跳 | 启用蓝牙摇杆 | - | 红色快速闪烁 100ms 开/关 | 无法检测到射频芯片 | - | 每秒橙色闪烁一次 | 未连接遥控器 | + | 绿色闪烁 | 进入 Web 更新模式 | + | 蓝色闪烁 | 启用蓝牙摇杆 | + | 红色 每100ms闪烁一次 | 无法检测到射频芯片 | + | 橙色 每秒闪烁一次 | 未连接遥控器 | | 单色常亮 | 已连接接收机，颜色表示包速率 | | 单色渐变 | 未连接接收机，颜色表示包速率 | diff --git a/docs/zh/quick-start/pre-1stflight.md b/docs/zh/quick-start/pre-1stflight.md index 13ba62867..29d97efcc 100644 --- a/docs/zh/quick-start/pre-1stflight.md +++ b/docs/zh/quick-start/pre-1stflight.md @@ -61,7 +61,9 @@ description: 什么是性能测试？如何设置 Aux1 解锁？OSD 上的 RSSI - 遥控器距离接收机 1 米（3 英尺），通电。确保接收机和 TX 模块天线方向一致。（建议暂时断开 VTX/图传，或让 VTX 进入 pit 模式，或用风扇吹散热）。 - 用 OSD 或遥控器的 Telemetry 页面，记录 RSSI dBm 或 1RSS 遥测数据。 -900MHz 硬件，-20dBm 左右说明硬件正常；2.4GHz 硬件，-40dBm 到 -25dBm 都可以。如果数值比这些低（越接近 0 越好），可以检查： +如果是 900MHz 硬件，-20dBm 左右说明硬件正常 +如果是 2.4GHz 硬件，-40dBm 到 -25dBm 都可以。 +如果数值比这些低（越接近 0 越好），请检查： - ExpressLRS 模块天线是否松动。有些 3D 打印模块壳体太厚，RP-SMA/SMA 接头拧不紧，建议拧紧螺母。 - 天线尾线是否损坏或未正确连接主板。 From c17560cde56a7685c584f5855505630e92d7b29f Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 23:26:29 +0800 Subject: [PATCH 08/19] add space --- docs/zh/quick-start/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh/quick-start/getting-started.md b/docs/zh/quick-start/getting-started.md index 0e7985a83..adf65e96d 100644 --- a/docs/zh/quick-start/getting-started.md +++ b/docs/zh/quick-start/getting-started.md @@ -95,7 +95,7 @@ description: 在这里开始你的 ELRS 历程! 这是让你用 ELRS 飞起来 如果你有其他问题或疑虑，或者需要本指南未涵盖的进一步帮助，请加入我们的 Discord 频道！ !!! warning "注意" - 国内无法访问Discord + 国内无法访问 Discord [ExpressLRS Discord :fontawesome-brands-discord:](https://discord.gg/dS6ReFY){ .md-button .md-button--primary .center-block } From 4279b03933edcede647565a82838c4cb5ce4acb6 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Sun, 3 Aug 2025 23:26:56 +0800 Subject: [PATCH 09/19] zh: unbricking.md --- docs/zh/quick-start/unbricking.md | 110 ++++++++++++++++++++++++++++++ mkdocs.yml | 2 +- 2 files changed, 111 insertions(+), 1 deletion(-) create mode 100644 docs/zh/quick-start/unbricking.md diff --git a/docs/zh/quick-start/unbricking.md b/docs/zh/quick-start/unbricking.md new file mode 100644 index 000000000..d34bd2ba4 --- /dev/null +++ b/docs/zh/quick-start/unbricking.md @@ -0,0 +1,110 @@ +--- +template: i18n/zh/main.html +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-Hardware/master/img/quick-start.png) + +## 救命！我的接收机变砖了！ + +深呼吸，冷静下来，别慌。 + +所有基于 ESP 的接收机都内置了出厂 bootloader，**无法被损坏或篡改**。即使升级彻底失败，也能用这个默认 bootloader 恢复。 + +所以技术上讲，只要硬件没坏，你的接收机就没真正“变砖”。 + +但为了方便，我们还是用“变砖”来指接收机无法正常工作或表现异常。 + +请严格按照以下步骤操作，恢复你的“砖头”接收机。 + +1. 确保你的接收机只能在连接电池时上电。 + - 如果接收机仅插 USB 就能上电，请将接收机的 5V 线移到只在电池供电时有电的 5V 焊盘。 + - 用万用表的直流电压档。 + - 插上飞控 USB，断开电池 + - 测试每个 5V 焊盘。 + - 读数为 0V 的焊盘就是只在电池供电时有电的焊盘。 + - 把接收机的 5V 线焊到这个焊盘。 + - 如果找不到合适的 5V 焊盘，请按如下操作： + - 断开接收机的 5V 线与飞控上的 5V 焊盘。 + - 另焊一根线到飞控任意 5V 焊盘。 + - 露出一段线，方便后续与接收机 5V 线连接。 + +2. 如果之前已连接电池，请把电池拔掉，同时拔掉飞控的 USB。 + +3. 让接收机进入 bootloader 模式。 + - 如果有 boot 焊盘，用锡桥连起来。 + - 如果有按键，用鳄鱼夹一直按住按钮。 + - 如果只有一个 boot 焊盘，将其与 GND 焊盘连接。 + +
+ ![betafpv Lite](../assets/images/betaFPVrxLite.png) +
带 Boot 焊盘的接收机示例
+
+ +
+ ![betafpv SuperD](../assets/images/BetaFPVSuperD.png) +
带 Boot 按钮的接收机示例
+
+ + !!! warning "注意" + 即使接收机 LED 只是常亮，也不要跳过这一步，以确保接收机确实进入了 bootloader 状态。 + +4. 连接 Betaflight 地面站 或 INAV 地面站，确保你已正确[配置飞控](receivers/configuring-fc.md)，暂时将 `遥测` 设置为 **禁用**。 + +5. ++"保存并重启"++。关闭 Betaflight 地面站。也关闭所有可能占用串口的其他软件。 + + !!! info "Cura Slicer" + 我们发现 Cura Slicer 及类似软件(3D 打印机切片软件)会占用串口，导致 Passthrough 刷写/恢复失败。 + +6. 拔掉再插上 USB，确保飞控与电脑重新连接，串口未被占用。 + +7. 打开 ExpressLRS 地面站，选择你要恢复的固件版本，选择设备类型和目标，以及常用固件选项。 + +8. 刷写方式选择 `Betaflight Passthrough`。 + +
+ ![via Passthrough](../assets/images/Method_RX_Passthrough.png) +
+ +9. 点击 `Flash` 按钮。等待日志中出现 **PASSTHROUGH DONE**，然后给接收机上电。 + +
+ ![Passthrough Done](../assets/images/passthrough-done.jpg) +
+ + ??? tip "没看到 PASSTHROUGH DONE？（点击展开）" + 你可能跳过了上面的某些步骤，或者飞控配置有误。请返回并确保每一步都正确执行。 + + - 插上电池或将 5V 线扭在一起给接收机供电（见第 1 步）。接收机 LED 应该常亮。 + +
+ ![BOOTLOADER](../assets/images/LED_ON.gif) +
+ +10. 等待刷写完成，出现成功提示。如果失败，重复上述步骤或尝试其他方法（如 FTDI/UART 刷写）。 + +11. 刷写完成后，可以断开飞控电源，拔掉电池和 USB 线。 + +12. 移除 boot 焊盘的锡桥或与 GND 的连接，如果是按钮，移除鳄鱼夹。 + +13. 再次给接收机上电，确认已恢复正常工作状态。 + +
+ ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) +
+ +### 文字太多？这里有视频！ + +!!! warning "注意" + 国内无法访问 Youtube + +
+ +
+ +## 高频头怎么救砖？ + +大多数基于 ESP 芯片的 ExpressLRS 高频头都支持 UART 刷写或 EdgeTX Passthrough 刷写。可用这些方法恢复 ESP 芯片的高频头。 + +STM 系列芯片高频头则需用 STLink 刷写。 + +ExpressLRS 高频头在升级时很难变砖，只要按本网站官方刷写指南操作基本上不会出问题。 \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index aa44c6889..5e1ed7ef1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -163,7 +163,7 @@ plugins: - 首飞之前: quick-start/pre-1stflight.md - Ardupilot 设置: quick-start/ardupilot-setup.md - Troubleshooting: quick-start/troubleshooting.md - - Unbricking: quick-start/unbricking.md + - 救砖: quick-start/unbricking.md - 软件: - Obsolete Defines: software/obsolete-defines.md - OpenOCD for STLink: software/open-ocd.md From d3bb7d3bc3c9ad02662f909bdbe4c5ab95a7d40c Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 10:29:34 +0800 Subject: [PATCH 10/19] zh: update led-status.md --- docs/zh/quick-start/led-status.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/zh/quick-start/led-status.md b/docs/zh/quick-start/led-status.md index 6b5f6899c..34ca6d0e4 100644 --- a/docs/zh/quick-start/led-status.md +++ b/docs/zh/quick-start/led-status.md @@ -16,10 +16,10 @@ ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 |-----------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| | ![CONNECTED](../assets/images/LED_ON.gif) | 常亮 | 已连接到发射端，或处于 Bootloader 模式 | | ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif) | 快速双闪后暂停 | 进入对频模式 | - | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | 每500ms闪烁一次 | 等待与发射端连接 | + | ![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif) | 慢闪(500ms) | 等待与发射端连接 | | ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif) | 三次快闪后暂停 | 已连接发射端但模型匹配参数不一致 | - | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | 每100ms闪烁一次 | 无法检测到射频芯片 | - | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | 每25ms闪烁一次 | 进入 WiFi 模式 | + | ![LEDSEQ_RADIO_FAILED](../assets/images/LEDSEQ_RADIO_FAILED_20_100.gif) | 闪烁(100ms) | 无法检测到射频芯片 | + | ![LEDSEQ_WIFI_UPDATE](../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) | 快闪(25ms) | 进入 WiFi 模式 | === "接收机 RGB LED" | | LED 指示 | 状态说明 | @@ -52,8 +52,8 @@ ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 | 彩虹渐变效果 | 启动中 | | 绿色闪烁 | 进入 Web 更新模式 | | 蓝色闪烁 | 启用蓝牙摇杆 | - | 红色 每100ms闪烁一次 | 无法检测到射频芯片 | - | 橙色 每秒闪烁一次 | 未连接遥控器 | + | 红色闪烁(100ms) | 无法检测到射频芯片 | + | 橙色(1000ms) | 未连接遥控器 | | 单色常亮 | 已连接接收机，颜色表示包速率 | | 单色渐变 | 未连接接收机，颜色表示包速率 | From c976cc8ad86d76bcab5e0ba39c79480242f20d0c Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 11:03:20 +0800 Subject: [PATCH 11/19] zh: add wiring-up.md --- docs/zh/receivers/wiring-up.md | 103 +++++++++++++++++++++++++++++++++ mkdocs.yml | 2 +- 2 files changed, 104 insertions(+), 1 deletion(-) create mode 100644 docs/zh/receivers/wiring-up.md diff --git a/docs/zh/receivers/wiring-up.md b/docs/zh/receivers/wiring-up.md new file mode 100644 index 000000000..d64ab181a --- /dev/null +++ b/docs/zh/receivers/wiring-up.md @@ -0,0 +1,103 @@ +--- +template: i18n/zh/main.html +description: 连接你的 ExpressLRS 接收机到飞控吧！ +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +!!! tip "实用提示" + 有些厂家推荐的接收机 UART，或者专门分配给接收机的 UART，通常带有下拉电阻以适配 SBUS（RX 焊盘反转），这会导致 ESP 系列 ExpressLRS 接收机 LED 常亮。除非你了解 UART 原理，否则建议避免使用这些 UART。 + +!!! tip "小提示" + KISS 飞控的 UART 命名可能不同。你可能需要将 RX 引脚接到 RX 焊盘，TX 引脚接到 TX 焊盘。务必查阅你的飞控接线图或说明书。 + +## 简介 + +基于 UART 的 ExpressLRS 接收机通过 CRSF 串口协议与飞控通信。该协议使用两根线：一根用于控制信号，另一根用于遥测信号。可以理解为双向高速公路。 + +下图是典型的 ExpressLRS 接收机引脚定义及与飞控焊盘的连接方式： + +
+![HM2400 connection](../../assets/images/EPWiring.png) +
+ +ExpressLRS 接收机的 TX 引脚负责将遥控器接收到的控制信号发送给飞控；RX 引脚则接收飞控发来的遥测数据（如电池电压、电流、GPS 坐标、飞行姿态等），并回传给遥控器。 + +??? Tip "什么是 UART？（点击展开）" + UART 是飞控上的一组 RX 和 TX 焊盘。通常把它当作飞控的“USB 接口”，可以连接不同的外设，比如 GPS 或接收机。每个 UART 只能连接一个设备，只能执行一个功能。 + + R3 和 T3 属于 UART3；RX2 和 TX2 属于 UART2。不同厂家命名方式不同，有的用 "R" 和 "T" 加数字，有的用 "RX" 和 "TX" 加数字。 + + __UART__ 即 Universal Asynchronous Receiver/Transmitter（通用异步收发器） + +## 接收机接线 + +了解基础知识后，将接收机连接到飞控任意空闲 UART。查阅飞控接线手册，确认可用的 UART。 + +- GND 或 G 焊盘接飞控任意 GND 焊盘 +- VCC 或 5 焊盘接飞控任意 5V（或 4.5V）焊盘 +- TX 或 T 焊盘接飞控同一 UART 号的 RX 焊盘 +- RX 或 R 焊盘接飞控同一 UART 号的 TX 焊盘 + +**即 TX RX 交叉连接** + +
+![Receiver-to-FC Wiring](../../assets/images/receiver-wiring-to-FC.png) +
+ +如果你自己焊接接收机，请检查焊盘间是否有短路，并清理助焊剂或残留物。 + +!!! warning "慢着！" + 先别急着给接收机套热缩管，还要做初步测试！ + +确保接线无短路后给接收机通电。 + +- 建议用电池给飞控供电，确保接收机在实际飞行条件下能正常工作。 +- 通电前务必确认接线无短路。 + +观察接收机 LED，应该有以下几种状态： + +|| LED 指示 | 状态说明 | +|---|---|---| +|![LEDSEQ_DISCONNECTED](../../assets/images/LEDSEQ_DISCONNECTED_50_50.gif)| 慢闪(500ms) | 等待与发射端连接 | +|![LEDSEQ_BINDING](../../assets/images/LEDSEQ_BINDING_10_10_10_100.gif)| 双闪后暂停 | 进入对频模式 | +|![LEDSEQ_WIFI_UPDATE](../../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif)| 快闪(25ms) | 进入 WiFi 模式（60 秒后自动进入） | +|![CONNECTED](../../assets/images/LED_ON.gif)| 常亮 | 处于 Bootloader 模式 | + +如果接收机带 RGB LED（如 Foxeer LNA、BetaFPV SuperD、Happymodel EP Dual），LED 状态如下： + +| LED 指示 | 状态说明 | +|---|---| +| 彩虹渐变 | 启动中 | +| 慢闪(500ms) | 等待与发射端连接 | +| 橙色双闪后暂停 | 进入对频模式 | +| 绿色闪烁 | 进入 WiFi 模式（60 秒后自动进入） | + +如果接收机 LED 完全不亮，请立即断电并检查接线。 + +如果你的接收机带 RGB LED（如 Foxeer LNA、BetaFPV SuperD、Happymodel EP Dual），且 LED 不亮但接线无误，可能是接收机进入了 Bootloader 模式。 + +如果接收机 LED 常亮，说明处于 Bootloader 模式（见上表）。 + +??? danger "接收机进入 Bootloader 模式怎么办？（点击展开）" + + 遇到接收机进入 Bootloader 模式，可尝试以下方法： + + 1. 检查接收机上的 Boot 按钮是否被按下或损坏。 + - 如果被按下或挤压，移除原因（如热缩管压到按钮）。 + - 如果损坏，建议更换或联系卖家售后。 + + 2. 如果没有 Boot 按钮而是 Boot 焊盘，检查 Boot 焊盘是否与 GND 焊盘连接。 + - 如果连接了 GND 焊盘，断开连接。 + + 3. 断开接收机的 RX 和 TX 线，重新上电，观察 LED。 + - 如果开始慢闪(500ms)，建议换到其他 UART。 + - 如果其他 UART 被占用，尝试加上拉电阻(300~1k 欧姆，越小效果越好)，把 UART 的 RX 焊盘与 5V(或 3.3V) 接上。 + +
+ ![ExpressLRS Pull-up](../../assets/images/pull-up.png) +
+ + 4. 如果你用的是数字图传（如 DJI Air Unit、Caddx Vista、DJI O3），且六根线都接到飞控，需要移除 SBUS/DJI HDL 线。 + +如果接收机工作正常（即未进入 Bootloader 模式），可断电并进行下一步：[飞控配置](../receivers/configuring-fc.md) \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 5e1ed7ef1..8a3ac72ff 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -125,7 +125,7 @@ plugins: - DIY 2400TX: quick-start/transmitters/diy2400.md - The ExpressLRS Lua Script: quick-start/transmitters/lua-howto.md - 接收机: - - Receiver Wiring: quick-start/receivers/wiring-up.md + - 接收机接线: quick-start/receivers/wiring-up.md - Configuring FC: quick-start/receivers/configuring-fc.md - Checking FW Version: quick-start/receivers/firmware-version.md - Typical Updating Steps: quick-start/receivers/updating.md From c33576244faba8af6dd2d004f987c22bc00e48d8 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 11:10:49 +0800 Subject: [PATCH 12/19] zh: add configuring-fc.md --- docs/zh/quick-start/configuring-fc.md | 90 +++++++++++++++++++++++++++ mkdocs.yml | 2 +- 2 files changed, 91 insertions(+), 1 deletion(-) create mode 100644 docs/zh/quick-start/configuring-fc.md diff --git a/docs/zh/quick-start/configuring-fc.md b/docs/zh/quick-start/configuring-fc.md new file mode 100644 index 000000000..22eccea84 --- /dev/null +++ b/docs/zh/quick-start/configuring-fc.md @@ -0,0 +1,90 @@ +--- +template: i18n/zh/main.html +description: 按照本指南为你的飞控配置 ExpressLRS。 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +## 串口接收机设置 + +当你已经完成[接收机接线](wiring-up.md)后，需要在飞控配置工具的 Ports（端口）标签页为接收机所在 UART 启用 Serial RX（串口接收机）。 + +如下例，接收机接在 UART1（TX1 和 RX1 焊盘），则应在 Ports 标签页的 UART1 行勾选 Serial RX。 + +!!! note "注意" + 这只是示例。请根据你接收机的实际接线情况设置端口。 + +
+![Ports Tab](../../assets/images/PortsTab.png) +
Betaflight 串口接收机端口设置示例
+
+ +
+![INAV Ports](../../assets/images/FC-portsconfig-INAV.png) +
INAV 串口接收机端口设置示例
+
+ +## 串口接收机协议 + +基于 UART 的 ExpressLRS 接收机使用 CRSF 串口协议与飞控通信。 + +按以下步骤设置串口接收机协议： + +1. 进入飞控配置工具的 ++"Receiver"++（接收机）标签页。 +2. 将 `Receiver Mode`(接收机模式) 或 `Receiver Type`(接收机类型) 设置为 {==Serial==}（串口）。 +3. 将 `Serial Receiver Provider`(串行数字接收机协议) 设置为 {==CRSF==}。 +4. 将 `Telemetry`(遥测) 设置为 {==Enabled==}（启用）。 + - INAV 的 `Telemetry`(遥测) 选项在 ++"Configuration"++（配置）标签页。 +5. 如果你用的是模拟图传或支持 MSP DisplayPort/Canvas Mode 的数字图传，请将 `RSSI Channel`(RSSI 通道) 设置为 {==Disabled==}，`RSSI ADC`(模拟 RSSI 输入) 也设置为 {==Disabled==}。 + +!!! Note + 不同版本的飞控配置工具，这些设置的位置和名称可能会有变化。请参考你的飞控配置工具用户手册。 + +
+![Conf Tab](../../assets/images/ConfigurationTab.png) +
+ +
+![INAV Config](../../assets/images/FC-rxconfig-INAV.png) +
+ +
+![INAV Config](../../assets/images/FC-config-INAV.png) +
+ +## 软件反转与全双工模式 + +CRSF 协议需要完整的 UART 对（TX/RX），且需未反转、全双工。可在飞控配置工具的 ++"CLI"++ 标签页输入 `get serialrx` 检查相关设置： + +- `serialrx_inverted` 应为 **OFF**，如需设置请执行 `set serialrx_inverted = off`。 +- `serialrx_halfduplex` 应为 **OFF**，如需设置请执行 `set serialrx_halfduplex = off`。 +- 设置完成后别忘了输入 `save` 保存。 + +## RC Link 预设（仅 Betaflight） + +Betaflight 飞控支持 RC Link 预设，可根据你的包速率和使用场景自动配置前馈、平滑等相关参数。 + +!!! Warning + 未使用预设或选择了错误的预设，可能导致前馈信号噪声和抖动，影响飞行手感和性能。 + +在 **Betaflight 地面站** 中安装 RC Link 预设步骤如下： + +1. 选择 **Preset**(预设) 标签页。 +2. 在 Preset 标签页点击 **Save Backup**(保存备份)，先保存一份配置备份。 +3. 搜索 'ExpressLRS'，选择与你[包速率](../transmitters/lua-howto.md#packet-rate-and-telemetry-ratio)匹配的 Link Preset。如果没有完全匹配的选项，选择低于你包速率的最近预设。 + + ![Presets Home](../../assets/images/preset_home.png) + +4. 展开下拉列表，阅读可选项。注意：这些都是可选项，如无需求可全部不选。 +5. 点击 'Pick' 按钮，准备应用预设： + + ![Presets Pick](../../assets/images/preset_pick.png) + +6. 点击 **Save and Reboot**(保存并重启) 应用预设： + + ![Presets Save](../../assets/images/preset_save.png) + +!!! important + 配置完成后请关闭飞控配置工具，否则可能影响后续步骤（如 Passthrough 刷写）。在继续下一步前务必拔掉飞控 USB，刷新连接。 + +飞控配置完成后，可继续下一步：[检查接收机固件版本](./firmware-version.md)。 \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 8a3ac72ff..f0fcb2b54 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -126,7 +126,7 @@ plugins: - The ExpressLRS Lua Script: quick-start/transmitters/lua-howto.md - 接收机: - 接收机接线: quick-start/receivers/wiring-up.md - - Configuring FC: quick-start/receivers/configuring-fc.md + - 飞控配置: quick-start/receivers/configuring-fc.md - Checking FW Version: quick-start/receivers/firmware-version.md - Typical Updating Steps: quick-start/receivers/updating.md - Updating Receivers: From d8f21c07075ac02a469569b2eb81d2132ad0388f Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 11:12:01 +0800 Subject: [PATCH 13/19] zh: move to correct path --- docs/zh/{quick-start => receivers}/configuring-fc.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/zh/{quick-start => receivers}/configuring-fc.md (100%) diff --git a/docs/zh/quick-start/configuring-fc.md b/docs/zh/receivers/configuring-fc.md similarity index 100% rename from docs/zh/quick-start/configuring-fc.md rename to docs/zh/receivers/configuring-fc.md From 1182e9e3dbfb6115173707e6737848094b9e37ea Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 11:31:43 +0800 Subject: [PATCH 14/19] zh: add firmware-version.md --- docs/zh/receivers/firmware-version.md | 190 ++++++++++++++++++++++++++ mkdocs.yml | 2 +- 2 files changed, 191 insertions(+), 1 deletion(-) create mode 100644 docs/zh/receivers/firmware-version.md diff --git a/docs/zh/receivers/firmware-version.md b/docs/zh/receivers/firmware-version.md new file mode 100644 index 000000000..d6d52f67e --- /dev/null +++ b/docs/zh/receivers/firmware-version.md @@ -0,0 +1,190 @@ +--- +template: i18n/zh/main.html +description: 了解你的 ExpressLRS 接收机固件版本。 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +## 为什么要了解固件版本？ + +了解你设备当前的 ExpressLRS 固件版本，可以决定是否需要升级到新版本，或者可以直接对频无需升级。对于刚入门的新手来说，刷写新设备可能有些困难。 + +但仍然建议你将设备升级到最新固件，以获得所有的 bug 修复和最新功能。 + +## 接收机固件版本查询 + +=== "通过 WebUI 查询" + + 1. 让接收机进入 WiFi 模式。 + + === "自动 WiFi 模式" + + 1. 给接收机通电。 + + - 如果需要插电池才能给接收机供电： + + - 请确保你已检查好前一步的接线。 + - 确保有风扇吹着图传，也可以暂时断开图传与飞控的连接避免图传过热。 + + - 如果接收机已通电并与高频头对频，先关闭遥控器，然后断电再重新上电接收机。 + + 2. 等待至少 60 秒，LED 会变为快速闪烁或 RGB LED 变为绿色呼吸灯，表示已进入 WiFi 模式。 + + - 自动 WiFi 开启间隔选项决定设备上电后多久进入 WiFi 模式（未收到有效 CRSF 包时）。 + +
+ ![LEDSEQ_WIFI_UPDATE](../../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) +
+ + === "通过 ExpressLRS Lua 脚本" + + !!! Note + 此方法仅适用于接收机已与高频头对频的情况。 + + 1. 按遥控器上的 ++"SYS"++ 键。 + - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 + 2. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。 + - 如果没有该脚本，请从[这里](../transmitters/lua-howto.md)下载并保存到 SD 卡 Scripts/Tools/ 文件夹。 + 3. 按 ++enter++ 加载脚本。 + +
+ ![Lua Running] +
+ + - 如果脚本卡在 "Loading..."，请返回[遥控器准备](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + 4. 下拉选择 `Wifi Connectivity` 并按 ++enter++。 + 5. 选择 `Enable RX WiFi` 并按 ++enter++。 + +
+ ![Lua WiFi] +
+ + 6. 接收机 LED 会变为快速闪烁或 RGB LED 变为绿色呼吸灯，表示已进入 WiFi 模式。 + +
+ ![LEDSEQ_WIFI_UPDATE](../../assets/images/LEDSEQ_WIFI_UPDATE_2_3.gif) +
+ + 2. 搜索 `ExpressLRS RX` WiFi 热点。 + ![WiFi Hotspot]{ align=right } + + - 如果接收机之前已刷入家庭 WiFi SSID 和密码，并能连接该网络，则不会显示该热点。 + - 热点密码为 `expresslrs`。 + + ??? question "找不到热点？（点击展开）" + 如果找不到热点，请确保你的设备支持 2.4GHz WiFi，并尝试让设备靠近一些。 + + 如果还是找不到，可能是之前设置了家庭 WiFi SSID 和密码，接收机已连接到你的 WiFi 网络。 + +
+ + 3. 在浏览器中访问 WebUI，地址如下： + - http://10.0.0.1/ —— 连接到 `ExpressLRS RX` 热点时使用 + + !!! Note + 该 IP 也常被路由器占用。如果电脑有网线连接，可能会打开路由器或 ISP 配置页面而不是 Web UI。 + + 建议先断开网络或用手机、平板等设备访问。 + + - http://elrs_rx.local —— 如果接收机已配置家庭 WiFi 并连接 + + !!! Note + 如果无法访问，可能是电脑或网络未启用 MDNS。 + + ??? tip "用 IP 地址访问！（点击展开）" + === "`arp` 命令" + + 1. 打开命令提示符窗口。 + 2. 输入 `arp -a`，查看所有网络设备。 + 3. 依次尝试标记为 `Dynamic` 的 IP 地址，直到打开 ExpressLRS Web UI。 + + === "路由器 DHCP 列表" + 1. 登录路由器后台。 + 2. 查看 DHCP 列表，找到 "elrs" 设备。 + 3. 记下分配的 IP 地址。 + 4. 在浏览器中输入该 IP 地址访问。 + + 4. WebUI 顶部横幅会显示接收机已刷写的固件版本。 + +
+ ![Web UI Banner](../../assets/images/web-banner-rx.png) +
ExpressLRS Web UI 顶部横幅
+
+ +=== "通过 Lua 脚本查询" + + !!! Note + 此方法仅适用于接收机已与高频头对频的情况。 + + 1. 按遥控器上的 ++"SYS"++ 键。 + + - 老款遥控器或只有一个菜单键的需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 + + 2. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。 + + - 如果没有该脚本，请从[这里](../transmitters/lua-howto.md)下载并保存到 SD 卡 Scripts/Tools/ 文件夹。 + + 3. 按 ++enter++ 键激活脚本。 + +
+ ![Lua Running] +
+ + - 如果脚本卡在 "Loading..."，请返回[遥控器准备](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + + 4. 下拉到页面底部，选择 `Other Devices`。 + + 5. 按 ++enter++ 键打开文件夹。 + + 6. 选择接收机设备并按 ++enter++ 查询参数。 + + 7. 下图显示接收机固件版本信息。 + - 例如 Happymodel EP 接收机固件版本为 3.2.1，Git Hash 为 8dbbdb。 + +
+ ![ExpressLRS RX Version Info Color](../../assets/images/LuaColor-RXversion_info.jpg) +
彩屏遥控器上的接收机版本信息
+
+ +
+ +确定接收机已刷写的固件版本后，你可以决定继续使用还是升级到最新版本。 + +!!! Info "版本号说明" + ExpressLRS 固件采用 [语义化版本号](https://semver.org/)。 + + 格式为 "主版本.次版本.修订号" + + - 主版本：重大新功能和/或不兼容变更 + - 次版本：小功能或增强和/或新目标 + - 修订号：bug 修复 + + 版本号的第一个数字必须在高频头和接收机之间一致。 + 例如： + + - 接收机版本为 3.1.2，可以与发高频头固件版本 3.0.1 对频 + - 接收机版本为 3.2.0，**不能**与高频头固件版本 2.4.0 对频 + +最新 ExpressLRS 固件版本请查阅 [GitHub Releases 页面](https://github.com/ExpressLRS/ExpressLRS/releases) + +## 已知版本后怎么做？ + +=== "版本较旧" + + 请参考[下一页](../receivers/updating.md)的常规升级流程，或展开左侧菜单的 `升级接收机` 部分。 + +
+ ![Menu Updating Receivers](../../assets/images/menusectionUpdatingReceivers.png) +
+ + 你也可以用页面顶部的搜索栏查找你的接收机专用的升级/刷写指南。 + +=== "版本较新" + + 请参考[对频流程](../binding.md)，将接收机与高频头对频。 + +[Lua Running]: ../../assets/images/lua/config-bw.png +[Lua WiFi]: ../../assets/images/lua/wifi-bw-rx.png +[WiFi Hotspot]: ../../assets/images/WifiHotspot.png \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index f0fcb2b54..14e7f7e7f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -127,7 +127,7 @@ plugins: - 接收机: - 接收机接线: quick-start/receivers/wiring-up.md - 飞控配置: quick-start/receivers/configuring-fc.md - - Checking FW Version: quick-start/receivers/firmware-version.md + - 检查固件版本: quick-start/receivers/firmware-version.md - Typical Updating Steps: quick-start/receivers/updating.md - Updating Receivers: - Axisflying Thor: quick-start/receivers/axisflying-thor.md From c80a99db4c4d99c7595999cbc52bb2f1d3074ba9 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 11:41:07 +0800 Subject: [PATCH 15/19] zh: update --- docs/zh/quick-start/led-status.md | 4 ++-- docs/zh/quick-start/pre-1stflight.md | 16 ++++++++-------- docs/zh/receivers/firmware-version.md | 2 +- docs/zh/receivers/wiring-up.md | 2 +- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/zh/quick-start/led-status.md b/docs/zh/quick-start/led-status.md index 34ca6d0e4..8343ccc30 100644 --- a/docs/zh/quick-start/led-status.md +++ b/docs/zh/quick-start/led-status.md @@ -26,8 +26,8 @@ ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 |-------------------------------------------------------------------------------------|-------------------------------|-------------------------------------------------------------------| | ![LEDRGB_STARTUP](../assets/images/LEDSEQRGB_STARTUP.gif) | 彩虹渐变效果 | 启动中 | | ![LEDRGB_WIFI_UPDATE](../assets/images/LEDSEQRGB_WIFI_UPDATE.gif) | 绿色闪烁 | 进入 Web 更新模式 | - | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | 橙色 每500ms闪烁一次 | 等待与发射端连接 | - | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | 红色 每100ms闪烁一次 | 无法检测到射频芯片 | + | ![LEDRGB_WAITING_FOR_CONNECTION](../assets/images/LEDSEQRGB_WAITING_TO_CONNECT.gif) | 橙色慢闪(500ms) | 等待与发射端连接 | + | ![LEDRGB_RADIO_FAILED](../assets/images/LEDSEQRGB_RADIO_FAILED.gif) | 红色闪烁(100ms) | 无法检测到射频芯片 | | ![LEDRGB_BINDING_ENABLED](../assets/images/LEDSEQRGB_BINDING.gif) | 橙色双闪后暂停 | 进入对频模式 | | ![LEDRGB_MODEL_MISMATCH](../assets/images/LEDSEQRGB_MODEL_MISMATCH.gif) | 橙色三闪后暂停 | 已连接发射端但模型匹配参数不一致 | | ![LEDRGB_CONNECTED](../assets/images/LED_RGB_ON.png) | 单色常亮 | 已连接到发射端，颜色表示包速率 | diff --git a/docs/zh/quick-start/pre-1stflight.md b/docs/zh/quick-start/pre-1stflight.md index 29d97efcc..b04813b42 100644 --- a/docs/zh/quick-start/pre-1stflight.md +++ b/docs/zh/quick-start/pre-1stflight.md @@ -58,11 +58,11 @@ description: 什么是性能测试？如何设置 Aux1 解锁？OSD 上的 RSSI 上图是性能测试，用于判断你的遥控信号是否正常。这可以帮助你检查天线（尤其是 R9 的 Super 8）或硬件是否有问题。 - 用 Lua 脚本将 ExpressLRS 模块设为最低功率，包速率无所谓。 -- 遥控器距离接收机 1 米（3 英尺），通电。确保接收机和 TX 模块天线方向一致。（建议暂时断开 VTX/图传，或让 VTX 进入 pit 模式，或用风扇吹散热）。 +- 遥控器距离接收机 1 米（3 英尺），通电。确保接收机和 TX 模块天线方向一致。（建议暂时断开图传，或让图传进入 PIT(低功耗) 模式，也可以用风扇吹着）。 - 用 OSD 或遥控器的 Telemetry 页面，记录 RSSI dBm 或 1RSS 遥测数据。 如果是 900MHz 硬件，-20dBm 左右说明硬件正常 -如果是 2.4GHz 硬件，-40dBm 到 -25dBm 都可以。 +如果是 2.4GHz 硬件，-40dBm ~ -25dBm 正常。 如果数值比这些低（越接近 0 越好），请检查： - ExpressLRS 模块天线是否松动。有些 3D 打印模块壳体太厚，RP-SMA/SMA 接头拧不紧，建议拧紧螺母。 @@ -79,7 +79,7 @@ description: 什么是性能测试？如何设置 Aux1 解锁？OSD 上的 RSSI
Super8 天线常见故障点
-- 检查接收机是否有缺失元件，比如 RF 滤波器（在天线或 UFL 附近），也要检查 SMD 天线是否损坏或焊接良好。 +- 检查接收机是否有缺失元件，比如 RF 滤波器（在天线或 UFL 接口附近），也要检查 SMD 天线是否损坏或焊接良好。
![missing filter](../assets/images/missingfilter.png) @@ -88,13 +88,13 @@ description: 什么是性能测试？如何设置 Aux1 解锁？OSD 上的 RSSI - 大多数 DIY 模块需要把 E28 上的 0 欧姆电阻从 PCB 天线侧移到 UFL 侧。也可以用焊桥，但要确保焊在正确的焊盘上。 - 换接收机或 TX 模块的天线；大多数 ExpressLRS 接收机用 IPEX 1/UFL 接头，只要天线频率合适就能用。2.4GHz 模块可以用旧 WiFi 路由器天线，但不要用双频天线。注意天线接头类型（R9 模块用 RP-SMA，大多数 ExpressLRS 模块用 SMA）。 -## Blackbox +## 黑匣子 -Blackbox 可以用来评估飞行时射频链路性能。将 BB 设置为 debug 模式 `RC_SMOOTHING_RATE`，可记录 Betaflight 从接收机收到 RC 包的速率。 +黑匣子可以用来评估飞行时射频链路性能。将黑匣子设置为 debug 模式 `RC_SMOOTHING_RATE`，可记录 Betaflight 从接收机收到 RC 包的速率。 ## 遥测 -接收机会转发飞控发来的部分遥测数据。禁用某些消息只在飞控固件支持时有效。Betaflight 可用如下 CLI 设置禁用遥测项： +接收机会转发飞控发来的部分遥测数据。禁用某些遥测数据只在飞控固件支持时有效。Betaflight 可用如下 CLI 设置禁用遥测项： ``` # 禁用姿态遥测 @@ -126,7 +126,7 @@ set telemetry_disabled_mode = ON !!! hint "[ ] 方括号指示" 如果某行不变且名称为方括号，说明该传感器长时间未更新。 -RSSI 和链路质量等首行数值应始终更新（星号闪烁）。如果每秒没有多次更新，遥控器会发出 "telemetry warning"。为避免警告，可用 TLM_REPORT_INTERVAL_MS 设置。 +RSSI 和链路质量等首行数值应始终更新（星号闪烁）。如果每秒没有多次更新，遥控器会发出 "telemetry warning"(中文语音为"传感器丢失")。为避免警告，可用 TLM_REPORT_INTERVAL_MS 设置。 效果如下（如果不是这样，说明设置有问题）： @@ -140,7 +140,7 @@ RSSI 和链路质量等首行数值应始终更新（星号闪烁）。如果每 ![Slow update rate](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/wiki-from-discord/slow.gif)
-如果用 200Hz 和 1:2 遥测比率，星号几乎不闪，因为更新太快： +如果用 200Hz 和 1:2 遥测比率，因为更新得太快，星号几乎不闪：
![Fast update rate](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/wiki-from-discord/fast.gif) diff --git a/docs/zh/receivers/firmware-version.md b/docs/zh/receivers/firmware-version.md index d6d52f67e..8f6f1ec57 100644 --- a/docs/zh/receivers/firmware-version.md +++ b/docs/zh/receivers/firmware-version.md @@ -164,7 +164,7 @@ description: 了解你的 ExpressLRS 接收机固件版本。 版本号的第一个数字必须在高频头和接收机之间一致。 例如： - - 接收机版本为 3.1.2，可以与发高频头固件版本 3.0.1 对频 + - 接收机版本为 3.1.2，可以与高频头固件版本 3.0.1 对频 - 接收机版本为 3.2.0，**不能**与高频头固件版本 2.4.0 对频 最新 ExpressLRS 固件版本请查阅 [GitHub Releases 页面](https://github.com/ExpressLRS/ExpressLRS/releases) diff --git a/docs/zh/receivers/wiring-up.md b/docs/zh/receivers/wiring-up.md index d64ab181a..97d3a65ec 100644 --- a/docs/zh/receivers/wiring-up.md +++ b/docs/zh/receivers/wiring-up.md @@ -6,7 +6,7 @@ description: 连接你的 ExpressLRS 接收机到飞控吧！ ![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) !!! tip "实用提示" - 有些厂家推荐的接收机 UART，或者专门分配给接收机的 UART，通常带有下拉电阻以适配 SBUS（RX 焊盘反转），这会导致 ESP 系列 ExpressLRS 接收机 LED 常亮。除非你了解 UART 原理，否则建议避免使用这些 UART。 + 有些飞控厂家推荐的接收机 UART，或者专门分配给接收机的 UART，通常带有下拉电阻以适配 SBUS（RX 焊盘反转），这会导致 ESP 系列 ExpressLRS 接收机 LED 常亮。除非你了解 UART 原理，否则建议避免使用这些 UART。 !!! tip "小提示" KISS 飞控的 UART 命名可能不同。你可能需要将 RX 引脚接到 RX 焊盘，TX 引脚接到 TX 焊盘。务必查阅你的飞控接线图或说明书。 From 5c70aca1486d0582cf497db0a5b364e9c8f17944 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 11:51:19 +0800 Subject: [PATCH 16/19] zh: update --- docs/zh/quick-start/binding.md | 2 +- docs/zh/quick-start/getting-started.md | 2 +- docs/zh/quick-start/webui.md | 4 ++-- docs/zh/receivers/firmware-version.md | 4 ++-- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/zh/quick-start/binding.md b/docs/zh/quick-start/binding.md index 0a868dfa6..420d4b312 100644 --- a/docs/zh/quick-start/binding.md +++ b/docs/zh/quick-start/binding.md @@ -171,7 +171,7 @@ Lua 脚本或 WebUI 可设置对频信息为易失性（volatile），即只在 ![Lua Running]
- - 如果脚本卡在 "Loading..."，请返回[遥控器准备](transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + - 如果脚本卡在 "Loading..."，请返回[设置遥控器](transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 4. 屏幕右上角出现 `C`，表示发射端和接收机已连接。 diff --git a/docs/zh/quick-start/getting-started.md b/docs/zh/quick-start/getting-started.md index adf65e96d..fc7a04aca 100644 --- a/docs/zh/quick-start/getting-started.md +++ b/docs/zh/quick-start/getting-started.md @@ -46,7 +46,7 @@ description: 在这里开始你的 ELRS 历程! 这是让你用 ELRS 飞起来 - [对频](binding.md) - [性能测试](pre-1stflight.md#性能测试) -- [遥控器和飞控配置](pre-1stflight.md) +- [首飞之前](pre-1stflight.md) - 起飞! ### 如何使用或浏览本指南 diff --git a/docs/zh/quick-start/webui.md b/docs/zh/quick-start/webui.md index 010ef4f83..5d3313991 100644 --- a/docs/zh/quick-start/webui.md +++ b/docs/zh/quick-start/webui.md @@ -155,7 +155,7 @@ ExpressLRS Web UI 是 ExpressLRS 生态系统的重要组成部分。在项目 ![Lua Running] - - 如果卡在 "Loading..."，请返回[遥控器准备](./transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + - 如果卡在 "Loading..."，请返回[设置遥控器](./transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 - 右上角应有 C，表示发射端和接收机已连接。 5. 下拉选择 `Wifi Connectivity` 并按 ++enter++。 6. 选择 `Enable RX WiFi` 并按 ++enter++。 @@ -247,7 +247,7 @@ ExpressLRS Web UI 是 ExpressLRS 生态系统的重要组成部分。在项目 ![Lua Running] - - 如果卡在 "Loading..."，请返回[遥控器准备](./transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + - 如果卡在 "Loading..."，请返回[设置遥控器](./transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 4. 下拉选择 `Wifi Connectivity` 并按 ++enter++。 5. 选择 `Enable WiFi` 并按 ++enter++。 diff --git a/docs/zh/receivers/firmware-version.md b/docs/zh/receivers/firmware-version.md index 8f6f1ec57..26d598b99 100644 --- a/docs/zh/receivers/firmware-version.md +++ b/docs/zh/receivers/firmware-version.md @@ -52,7 +52,7 @@ description: 了解你的 ExpressLRS 接收机固件版本。 ![Lua Running] - - 如果脚本卡在 "Loading..."，请返回[遥控器准备](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + - 如果脚本卡在 "Loading..."，请返回[设置遥控器](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 4. 下拉选择 `Wifi Connectivity` 并按 ++enter++。 5. 选择 `Enable RX WiFi` 并按 ++enter++。 @@ -132,7 +132,7 @@ description: 了解你的 ExpressLRS 接收机固件版本。 ![Lua Running] - - 如果脚本卡在 "Loading..."，请返回[遥控器准备](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + - 如果脚本卡在 "Loading..."，请返回[设置遥控器](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 4. 下拉到页面底部，选择 `Other Devices`。 From 43e31360ab7b1978602c3cd1fd0901511feb3ec1 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 12:01:14 +0800 Subject: [PATCH 17/19] zh: add tx-prep.md --- docs/zh/transmitters/tx-prep.md | 347 ++++++++++++++++++++++++++++++++ mkdocs.yml | 4 +- 2 files changed, 349 insertions(+), 2 deletions(-) create mode 100644 docs/zh/transmitters/tx-prep.md diff --git a/docs/zh/transmitters/tx-prep.md b/docs/zh/transmitters/tx-prep.md new file mode 100644 index 000000000..7303634f2 --- /dev/null +++ b/docs/zh/transmitters/tx-prep.md @@ -0,0 +1,347 @@ +--- +template: i18n/zh/main.html +description: 按照本指南为你的遥控器准备 ExpressLRS。 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +## 外置 ExpressLRS 高频头 + +将你的外置 ExpressLRS 高频头插入遥控器的外置模块仓，确保所有引脚都未弯曲或缺失。外置 ExpressLRS 高频头需要三根引脚：VCC/VBAT GND S.Port/Data/Signal。 + +
+![ExternalRF Pinout Micro](../../assets/images/pinout-extmicro.jpg) +
Micro 外置模块仓引脚定义
+
+ +
+![ExternalRF Pinout Nano](../../assets/images/pinout-extnano.jpg) +
Nano 外置模块仓引脚定义
+
+ +## 内置 ExpressLRS 高频头 + +请确保你的新遥控器确实配备了内置 ExpressLRS 高频头。以下机型有 ELRS（ExpressLRS）和4合1版本，有些还有第三种（CC2500）。只有 ELRS 版本支持 ExpressLRS，其他版本因硬件不同无法使用。 + +- RadioMaster TX16S Mark II（ELRS, 4合1, CC2500）- ELRS 版本包装盒上有 ELRS 标签。 +- RadioMaster TX12 Mark II（ELRS, 4合1, CC2500）- ELRS 版本包装盒和 JR 模块仓都有 ELRS 标签。 +- RadioMaster Zorro（ELRS, 4合1, CC2500）- ELRS 版本包装盒有 ELRS 标签。 +- RadioMaster Boxer（ELRS, 4合1, CC2500）- ELRS 版本包装盒和 JR 模块仓都有 ELRS 标签。 +- Jumper T-Lite V2（ELRS, 4合1, CC2500） +- Jumper T-Pro V1/V2（ELRS, 4合1） +- BetaFPV Lite Radio 3 Pro（ELRS, CC2500）- 包底部条码标签可区分 ELRS 或 CC2500 版本。 + +
+![Internal ELRS Marking](../../assets/images/ELRS-variant-Box.jpg) +
RadioMaster 遥控器 ELRS 标签示例
+
+ +## 遥控器操作系统 + +ExpressLRS **需要** CRSFShot 或 Mixer Sync 功能，以支持高包速率。建议使用 [OpenTX 2.3.12](https://www.open-tx.org/2021/06/14/opentx-2.3.12) 或更高版本，或 [EdgeTX 2.4.0](https://github.com/EdgeTX/edgetx/releases/tag/v2.4.0) 或更高版本，这些版本已完整支持 CRSFShot/Mixer Sync。 + +如何查看遥控器操作系统版本： + +1. 按下 ++"SYS"++ 键。 + - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 +2. 按 ++"PAGE"++ 键，直到进入版本页面。 + +
+![System Key](../../assets/images/SystemKey.jpg) +
SYS 键，短按进入系统菜单
+
+ +
+![Menu Key](../../assets/images/MenuKey.jpg) +
菜单键，长按进入系统菜单
+
+ +如果你的系统版本较旧，请先升级到上述推荐版本。 +升级方法请查阅遥控器操作系统升级说明。 + +强烈推荐使用 [EdgeTX](https://github.com/EdgeTX/edgetx/releases)，兼容性和体验更佳。EdgeTX 支持 One Bit Sample Mode（适用于老款 FrSky 遥控器如 X9D 和 QX7）和 Mega Bauds（高于 400K 的波特率）。 + +??? Tip "最简单的 EdgeTX 升级流程（点击展开）" + 1. 访问 http://buddy.edgetx.org/ + 2. 左侧选择 EdgeTX 版本和你的遥控器型号 + 3. 点击页面底部 ++"Download .bin"++ 按钮 + 4. 将固件文件保存到遥控器 SD 卡的 `Firmware` 文件夹 + 5. 让遥控器进入 Bootloader 模式 + - 关机 + - 将两个水平微调键同时向内拨，再按电源键，屏幕亮起后松开 + - 部分遥控器流程不同，请查阅说明书 + 6. 选择 `Write Firmware` + 7. 找到刚下载的 EdgeTX 固件文件 + 8. 按照屏幕提示操作 + 9. 写入完成后重启遥控器 + 10. 在版本页面确认已升级 + +详细 EdgeTX 安装说明见 [此页面](https://github.com/EdgeTX/edgetx.github.io/wiki/EdgeTX-Installation-Guide)。 + +## 遥控器设置 + +### 串口波特率 + +波特率是遥控器与发射模块通信的速率，单位为比特每秒(bps)。常见波特率有 115200bps(115K)、400000bps(400K)。 + +波特率越高，通信越快，系统延迟越低。但并非所有遥控器和模块都支持高波特率，具体取决于硬件。 + +不同遥控器固件可设置不同波特率，具体操作如下： + +=== "EdgeTX 内置高频头" + + 1. 按 ++"SYS"++ 键 + - 老款遥控器或只有一个菜单键的需长按菜单键进入系统菜单 + - 具体操作请查阅说明书 + 2. 按 ++"PAGE"++ 键，进入硬件页面 + 3. 下拉找到 `Baudrate` 设置 + 4. 按 ++enter++ 键 + 5. 用滚轮选择你需要的波特率 + 6. 再按一次 ++enter++ 应用 + 7. 重启遥控器 + +
+ ![Baudrate](../../assets/images/txprep-clr-hardware.jpg) +
EdgeTX 内置模块波特率设置
+
+ +=== "EdgeTX 外置高频头" + + 1. 按 ++"MDL"++ 键 + - 老款遥控器或只有一个菜单键，需短按菜单键进入模型菜单 + - 具体操作请查阅说明书 + 2. 按 ++"PAGE"++ 键，进入模型设置页面（彩屏遥控器无需此步） + 3. 下拉找到外置 RF 设置 + 4. 选择 `Baudrate` 设置 + 5. 按 ++enter++ 键 + 6. 用滚轮选择你需要的波特率 + 7. 再按一次 ++enter++ 应用 + 8. 重启遥控器 + +
+ ![ExternalRF Color](../../assets/images/txprep-clr-externalRF.jpg) +
EdgeTX 外置模块波特率设置
+
+ +=== "OpenTX" + + 1. 按 ++"SYS"++ 键 + - 老款遥控器或只有一个菜单键的需长按菜单键进入系统菜单 + - 具体操作请查阅说明书 + 2. 按 ++"PAGE"++ 键，进入硬件页面 + 3. 下拉找到 `Baudrate` 设置 + - 如果没有此设置，说明你的遥控器固件不支持更改波特率，默认锁定为 400000 + 4. 按 ++enter++ 键 + 5. 用滚轮选择你需要的波特率 + 6. 再按一次 ++enter++ 应用 + 7. 重启遥控器 + +
+ ![Baud Rate](https://fpvfrenzy.com/wp-content/uploads/2017/11/baud-rate.jpg) +
老款遥控器波特率设置
+
+ +
+ +#### 推荐波特率 + +最低波特率取决于你要用的最高包速率： + +- 400K(400000bps)：适用于 250Hz 及以下包速率。大多数遥控器和模块都支持。 +- 921K(921000bps)：适用于 500Hz 及以下包速率。 +- 1.87M(1870000bps)：适用于 F1000 及以下包速率。 + +部分特殊情况： + +- FrSky Taranis QX7 ACCST、Horus X12S、Horus X10S 需做 [CRSF 修改(英文)](https://blog.seidel-philipp.de/fixed-inverter-mod-for-tbs-crossfire-and-frsky-qx7/) 才能稳定运行 400K 波特率。 +- FrSky Taranis X9D 即使默认 400K 也不稳定，建议开启 One Bit Sample Mode 并做硬件改造。详见 [X9D 故障排查](../../hardware/x9d-troubleshooting.md)。 + +其他遥控器可设置更高波特率，具体取决于所用模块。 + +#### 最大可用波特率 + +| 内置 TX 模块 | 最大波特率 | 备注 | +| ---- | ---- | ---- | +| RadioMaster TX16S | 5.25M | | +| RadioMaster Zorro | 5.25M | | +| RadioMaster Boxer | 5.25M | | +| RadioMaster Pocket | 5.25M | | +| RadioMaster MT12 | 5.25M | | +| RadioMaster TX12 | 5.25M | | +| Jumper T-Lite V2 | 1.87M | 受限于遥控器 | +| Jumper T-Pro | 1.87M | 受限于遥控器 | +| Jumper T20 | 1.87M | 受限于遥控器 | +| Jumper T14 | 5.25M | | +| Jumper T15 | 5.25M | | +| Jumper T12 Max | 5.25M | | +| BetaFPV Lite Radio 3 Pro | 1.87M | 受限于遥控器 | +| HelloRadio V16 | 5.25M | | + +| 外置 TX 模块 | 最大波特率 | 备注 | +| ---- | ---- | ---- | +| Happymodel ES24TX（含 slim, nano 等） | 5.25M | | +| Happymodel ES24TX Pro/Slim Pro | 5.25M | | +| Happymodel ES900TX | 5.25M | | +| Happymodel ES915/868TX | 1.87M | STM芯片 | +| BetaFPV Micro & Nano（V1 & V2） | 5.25M | | +| BetaFPV SuperG | 5.25M | | +| RadioMaster Ranger（含 Micro & Nano） | 5.25M | | +| RadioMaster Bandit（含 Micro & Nano） | 5.25M | | +| Axisflying Thor | 5.25M | | +| EMAX Aeris OLED & Nano | 5.25M | | +| NamimnoRC Flash/Voyager（无 OLED） | 3.75M | STM芯片 | +| NamimnoRC Flash/Voyager OLED | 5.25M | | +| Vantac Lite | 1.87M | | +| Jumper Aion Nano | 1.87M | | +| iFlight Command 8 | 3.75M | 作为外置模块 | +| HGLRC Hermes | 5.25M | | +| HGLRC T ONE OLED | 5.25M | | +| FrSky R9M/R9M Lite/R9M Lite Pro | 1.87M | | +| FrSky R9M 2018（非 ACCESS） | 115K | [电阻改造](../../hardware/inverter-mod.md)可达 400K | +| QuadKopters JR & Slim | 5.25M | | +| SIYI FM30 | 1.87M | STM芯片 | +| ImmersionRC GHOST | 1.87M | STM芯片 | + +!!! note "注意" + 外置模块最大波特率还取决于遥控器本身性能。 + + 老款 QX7 和 X9D(+) 需硬件改造和软件设置（如 One Bit 采样模式）才能稳定高波特率。建议这些老遥控器不要超过 400K。高于 400K 风险自负。 + + 新款 EdgeTX 遥控器可轻松使用更高波特率，建议尽量用最大波特率。 + +??? question "我的 TX 模块不在列表里！（点击展开）" + 别着急，说明维护者还没更新。现在新出的 TX 模块基本都是 ESP 芯片。如果你的 TX 模块支持 WiFi 或蓝牙，那就是 ESP 芯片，理论上可支持 5.25M 波特率（取决于遥控器）。 + +### ADC 滤波器 + +OpenTX 默认启用 ADC 滤波器，可能导致 RC 命令数据异常（如黑盒日志出现“锯齿”）。建议在 [OpenTX/EdgeTX](https://www.youtube.com/watch?v=ESr2H_EZ89Q) 关闭 ADC 滤波器。 + +设置方法如下： + +1. 按 ++"SYS"++ 键 + - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单 + - 具体操作请查阅说明书 +2. 按 ++"PAGE"++ 键，进入硬件页面 +3. 下拉找到 `ADC Filter` 设置 +4. 按 ++enter++ 键切换开关 + +??? info "EdgeTX 2.7.0（及以上）可按模型单独设置（点击展开）" + + EdgeTX 2.7 及以上支持按模型单独设置（Global、On、Off），适合 PWM 接收机和慢速舵机的固定翼机型。 + + 1. 按 ++"MDL"++ 键 + - 老款遥控器或只有一个菜单键，需短按菜单键进入模型菜单 + - 具体操作请查阅说明书 + 2. 按 ++"PAGE"++ 键，进入模型设置页面（彩屏遥控器无需此步） + 3. 下拉找到 `ADC Filter` 设置 + 4. 按 ++enter++ 键 + 5. 用滚轮选择 Global（跟随硬件页面设置）、On 或 Off + 6. 再按一次 ++enter++ 应用 + +## 模型设置 + +### RF 协议 + +!!! Note + 如果你用外置 ExpressLRS 高频头，请确保内置 RF 模块**关闭**。 + + 如果你的遥控器有内置 ExpressLRS 高频头，并且想用它而不是用外置高频头，则需关闭外置 RF 模块，并将内置 RF 模块设置为 **CRSF** 协议。 + +ExpressLRS 使用 CRSF 串口协议与高频头通信。设置方法如下： + +=== "外置 ExpressLRS 高频头" + + 1. 按 ++"MDL"++ 键 + - 老款遥控器或只有一个菜单键，需短按菜单键进入模型菜单 + - 具体操作请查阅说明书 + 2. 按 ++"PAGE"++ 键，进入模型设置页面（彩屏遥控器无需此步） + 3. 找到内置 RF 设置，设为 Off + 3. 找到外置 RF 设置 + 4. 模式设为 `CRSF` + - 此时可设置波特率 + 5. （可选）设置 Receiver ID 为唯一编号 + 6. 按 ++"RTN"++ 键或退出模型菜单 + +
+ ![ExternalRF BW](../../assets/images/txprep-bw-externalRF.jpg) +
+ +
+ ![ExternalRF Color](../../assets/images/txprep-clr-externalRF.jpg) +
+ +=== "内置 ExpressLRS 高频头" + + 1. 按 ++"MDL"++ 键 + - 老款遥控器或只有一个菜单键，需短按菜单键进入模型菜单 + - 具体操作请查阅说明书 + 2. 按 ++"PAGE"++ 键，进入模型设置页面（彩屏遥控器无需此步） + 3. 下拉找到内置 RF 设置 + 4. 模式设为 `CRSF` + 5. （可选）设置 Receiver ID 为唯一编号 + 6. 下拉找到外置 RF 设置，设为 Off + 7. 按 ++"RTN"++ 键或退出模型菜单 + + ??? info "没有 CRSF 协议选项？（点击展开）" + 如果找不到 CRSF 协议，请在系统菜单的硬件页面将 `Internal Module Type` 设为 CRSF。 + + 1. 按 ++"SYS"++ 键 + - 没有 SYS 键的遥控器需长按菜单键进入系统菜单 + - 具体操作请查阅说明书 + 2. 按 ++"PAGE"++ 键，进入硬件页面 + 3. 下拉找到内置 RF 设置 + 4. 类型设为 `CRSF` + - 此时可设置波特率 + 5. 按 ++"RTN"++ 键或退出硬件菜单，再回到模型设置 + +
+ ![InternalRF BW](../../assets/images/txprep-bw-internalRF.jpg) +
+ +
+ ![InternalRF Color](../../assets/images/txprep-clr-internalRF.jpg) +
+ +!!! Note + iFlight Commando 8 的 ExpressLRS 并非内置 RF 模块，与 RadioMaster Zorro、TX16S MK2、TX12 MK2、Jumper T-lite V2、T-pro 或 BetaFPV Lite Radio 3 Pro 不同。 + + 请将内置 RF 模块设为 Off，外置 RF 模块设为 CRSF 协议。 + +### 开关与辅助通道 + +新建模型默认没有配置任何辅助通道（Aux 通道从 CH5 开始，前四通道为摇杆）。如果你拨动遥控器上的开关，Betaflight 或 INAV 的模式没有反应，通常是因为没有配置辅助通道。请按以下步骤设置： + +1. 按 ++"MDL"++ 键 + - 老款遥控器或只有一个菜单键，需短按菜单键进入模型菜单 + - 具体操作请查阅说明书 +2. 按 ++"PAGE"++ 键，进入混控页面 +3. 下拉选择要配置的通道 +4. 长按 ++enter++，选择 Edit，再按一次 ++enter++ +5. （可选）可为该通道命名，方便记忆用途 +6. 选择 Source，按 ++enter++ 键 +7. 拨动你想分配给该通道的开关 + - 例如 CH5 通常设为解锁开关，建议选用两档开关 +8. 再按一次 ++enter++ 键确认 +9. 按 ++"RTN"++ 键退出混控编辑器 +10. 重复 3-9 步，配置所有需要的开关 + +=== "单色屏遥控器" + +
+ ![mixes BW](../../assets/images/txprep-bw-mixes.jpg) +
+ +
+ ![mixesAux BW](../../assets/images/txprep-bw-mixAux.jpg) +
+ +=== "彩屏遥控器" + +
+ ![mixes Color](../../assets/images/txprep-clr-mixes.jpg) +
+ +
+ ![mixesAux Color](../../assets/images/txprep-clr-mixAux.jpg) +
\ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 14e7f7e7f..5970ee015 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -92,8 +92,8 @@ plugins: - 安装地面站: quick-start/installing-configurator.md - 固件选项: quick-start/firmware-options.md - WebUI: quick-start/webui.md - - Transmitters: - - Radio Preparation: quick-start/transmitters/tx-prep.md + - 高频头: + - 设置遥控器: quick-start/transmitters/tx-prep.md - Checking FW Version: quick-start/transmitters/firmware-version.md - Typical Updating Steps: quick-start/transmitters/updating.md - Updating Transmitters: From e230fef4ebe6fa2c617d3a39b421c8431c1285f7 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Mon, 4 Aug 2025 13:49:20 +0800 Subject: [PATCH 18/19] zh: add firmware-version.md --- docs/zh/transmitters/firmware-version.md | 177 +++++++++++++++++++++++ mkdocs.yml | 2 +- 2 files changed, 178 insertions(+), 1 deletion(-) create mode 100644 docs/zh/transmitters/firmware-version.md diff --git a/docs/zh/transmitters/firmware-version.md b/docs/zh/transmitters/firmware-version.md new file mode 100644 index 000000000..2df6e4902 --- /dev/null +++ b/docs/zh/transmitters/firmware-version.md @@ -0,0 +1,177 @@ +--- +template: i18n/zh/main.html +description: 了解你的 ExpressLRS 高频头固件版本。 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +## 为什么要了解固件版本？ + +了解你设备当前的 ExpressLRS 固件版本，可以决定是否需要升级到新版本，或者可以直接对频无需升级。对于刚入门的新手来说，刷写新设备可能有些困难。 + +但仍然建议你将设备升级到最新固件，以获得所有的 bug 修复和最新功能。 + +## 高频头固件版本查询 + +你可以通过以下三种方法查询高频头当前固件版本： + +=== "通过 Lua 脚本查询" + + 1. 按遥控器上的 ++"SYS"++ 键。 + - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 + + 2. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。 + - 如果没有该脚本，请从[这里](../transmitters/lua-howto.md)下载并保存到 SD 卡 Scripts/Tools/ 文件夹。 + + 3. 按 ++enter++ 键激活脚本。 + +
+ ![Lua Running] +
+ + - 如果脚本卡在 "Loading..."，请返回[设置遥控器](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + + 4. 下拉到页面底部，即可看到当前高频头已刷写的固件版本。 + - 例如下图显示固件版本为 3.2.1，Git Hash 为 8dbbdb。 + +
+ ![ExpressLRS Version Info Color](../../assets/images/LuaColor-version_info.jpg) +
彩屏遥控器 Lua 脚本版本信息
+
+ +
+ ![ExpressLRS Version Info B&W](../../assets/images/LuaBW-version_info.jpg) +
单色屏遥控器 Lua 脚本版本信息
+
+ +=== "通过 OLED 屏幕查询" + + 如果你的外置高频头带有屏幕，主界面会显示当前模块的各项参数，也会显示已刷写的固件版本。 + +
+ ![ExpressLRS Version Info Color](../../assets/images/OLED-version_info.jpg) +
OLED 屏幕版本信息
+
+ +=== "通过 WebUI 查询" + + 1. 让发射端模块进入 WiFi 模式。 + + === "通过 ExpressLRS Lua 脚本" + + 1. 按遥控器上的 ++"SYS"++ 键。 + - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单。 + - 具体操作请查阅遥控器说明书。 + 2. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。 + - 如果没有该脚本，请从[这里](../transmitters/lua-howto.md)下载并保存到 SD 卡 Scripts/Tools/ 文件夹。 + 3. 按 ++enter++ 键加载脚本。 + +
+ ![Lua Running] +
+ + - 如果脚本卡在 "Loading..."，请返回[设置遥控器](../transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。 + 4. 下拉选择 `Wifi Connectivity` 并按 ++enter++。 + 5. 选择 `Enable WiFi` 并按 ++enter++。 + +
+ ![Lua WiFi] +
+ + 6. 屏幕会显示 `WiFi Running`，此时发射端模块已进入 WiFi 模式。 + - 如果脚本报语法错误，不用担心，模块已进入 WiFi 模式。可能是遥控器或固件较旧，或 Lua 脚本版本较新。 + + === "自动 WiFi 模式" + + 1. 将高频头从遥控器模块仓取下，用外部电源(2S)或 USB 供电。 + 2. 等待至少 60 秒，RGB LED 会变为绿色呼吸灯，表示进入 WiFi 模式。 + - 自动 WiFi 开启间隔选项决定设备上电后多久进入 WiFi 模式（未收到有效 CRSF 包时）。 + - 带 OLED 屏的模块也会显示 WiFi 模式提示。 + + 2. 搜索 `ExpressLRS TX` WiFi 热点。 + ![WiFi Hotspot]{ align=right } + + - 如果发射端模块已刷入家庭 WiFi SSID 和密码，并能连接该网络，则不会显示该热点。 + - 热点密码为 `expresslrs`。 + + ??? question "找不到热点？（点击展开）" + 如果找不到热点，请确保你的设备支持 2.4GHz WiFi，并尝试让设备靠近一些。 + + 如果还是找不到，可能是之前设置了家庭 WiFi SSID 和密码，模块已连接到你的 WiFi 网络。 + +
+ + 3. 在浏览器中访问 Web UI，地址如下： + - http://10.0.0.1/ —— 连接到 `ExpressLRS TX` 热点时使用 + + !!! Note + 该 IP 也常被路由器占用。如果电脑有网线连接，可能会打开路由器或 ISP 配置页面而不是 WebUI。 + + 建议先断开网络或用手机、平板等设备访问。 + + - http://elrs_tx.local —— 如果发射端模块已配置家庭 WiFi 并连接 + + !!! Note + 如果无法访问，可能是电脑或网络未启用 MDNS。 + + ??? tip "用 IP 地址访问！（点击展开）" + === "`arp` 命令" + + 1. 打开命令提示符窗口。 + 2. 输入 `arp -a`，查看所有网络设备。 + 3. 依次尝试标记为 `Dynamic` 的 IP 地址，直到打开 ExpressLRS Web UI。 + + === "路由器 DHCP 列表" + 1. 登录路由器后台。 + 2. 查看 DHCP 列表，找到 "elrs" 设备。 + 3. 记下分配的 IP 地址。 + 4. 在浏览器中输入该 IP 地址访问。 + + 4. WebUI 顶部横幅会显示发射端模块已刷写的固件版本。 + +
+ ![Web UI Banner](../../assets/images/web-banner.png) +
ExpressLRS Web UI 顶部横幅
+
+ +
+ +确定高频头的固件版本后，你可以决定继续使用还是升级到最新版本。 + +!!! Info "版本号说明" + ExpressLRS 固件采用 [语义化版本号](https://semver.org/)。 + + 格式为 "主版本.次版本.修订号" + + - 主版本：重大新功能和/或不兼容变更 + - 次版本：小功能或增强和/或新目标 + - 修订号：bug 修复 + + 版本号的第一个数字必须在发射端和接收机之间一致。 + 例如： + + - 高频头固件版本为 3.1.2，可以与接收机固件版本 3.0.1 对频 + - 高频头固件版本为 3.2.0，**不能**与接收机固件版本 2.4.0 对频 + +最新 ExpressLRS 固件版本请查阅 [GitHub Releases 页面](https://github.com/ExpressLRS/ExpressLRS/releases) + +## 知道了现在的高频头固件版本后可以怎么做？ + +=== "版本较旧" + + 请参考[下一页](../transmitters/updating.md)的常规升级流程，或展开左侧菜单的 `升级高频头` 部分。 + +
+ ![Menu Updating Transmitters](../../assets/images/menusectionUpdatingTransmitters.png) +
+ + 你也可以用页面顶部的搜索栏查找你的高频头专用升级/刷写指南。 + +=== "版本较新" + + 请参考[对频流程](../binding.md)，将高频头与接收机对频。 + +[Lua Running]: ../../assets/images/lua/config-bw.png +[Lua WiFi]: ../../assets/images/lua/wifi-bw.png +[WiFi Hotspot]: ../../assets/images/WifiHotspotTX.png \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 5970ee015..6d39d8db5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -94,7 +94,7 @@ plugins: - WebUI: quick-start/webui.md - 高频头: - 设置遥控器: quick-start/transmitters/tx-prep.md - - Checking FW Version: quick-start/transmitters/firmware-version.md + - 检查固件版本: quick-start/transmitters/firmware-version.md - Typical Updating Steps: quick-start/transmitters/updating.md - Updating Transmitters: - Axisflying Thor: quick-start/transmitters/axisflying-thor.md From b64f33a80b619c35db5b624b973e435b53667f38 Mon Sep 17 00:00:00 2001 From: zhou2008 <493505110@qq.com> Date: Thu, 7 Aug 2025 14:09:56 +0800 Subject: [PATCH 19/19] zh: update --- docs/zh/quick-start/ardupilot-setup.md | 4 ++-- docs/zh/quick-start/firmware-options.md | 6 +++--- docs/zh/quick-start/getting-started.md | 2 +- docs/zh/quick-start/installing-configurator.md | 2 +- docs/zh/receivers/configuring-fc.md | 8 ++++---- 5 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/zh/quick-start/ardupilot-setup.md b/docs/zh/quick-start/ardupilot-setup.md index 12f078338..849c12f47 100644 --- a/docs/zh/quick-start/ardupilot-setup.md +++ b/docs/zh/quick-start/ardupilot-setup.md @@ -18,7 +18,7 @@ ELRS的包速率与 ArduPilot 的 CRSF 包速率不同，ArduPilot 会持续报 ``` 在 RC_OPTIONS 中勾选"Suppress CRSF mode/rate message for ELRS systems". ``` -建议开启 RC_OPTIONS 中的"Use 420kbaud for ELRS protocol"，这样会让接收机与飞控使用 420K 的波特率通信 +建议开启 RC_OPTIONS 中的"Use 420kbaud for ELRS protocol"，这样会让飞控与接收机使用 420K 的波特率通信
@@ -51,6 +51,6 @@ RSSI_TYPE = 3 (ReceiverProtocol) 然后进入 OSD 选项卡，将 RSSI 和 LQ 元素放置在你想要的位置。 如果你感觉控制有延迟或卡顿，请检查接收机与飞控的连接。 -部分飞控需要使用支持全 DMA 的输入引脚。 +部分飞控还需要使用支持 DMA 的 UART 祝你飞行愉快！ :airplane: diff --git a/docs/zh/quick-start/firmware-options.md b/docs/zh/quick-start/firmware-options.md index 696b702a7..3adb774e5 100644 --- a/docs/zh/quick-start/firmware-options.md +++ b/docs/zh/quick-start/firmware-options.md @@ -29,11 +29,11 @@ Regulatory_Domain_EU_CE_2400 ``` 这个选项很简单——根据你所在地区选择对应的法规区域，以确定使用的频率范围。 -欧盟法规区域现在已符合 LBT（Listen Before Talk） 要求！ +欧盟法规区域现在已符合 LBT(Listen Before Talk) 要求！ ## 对频短语 -设置对频短语可以让你跳过传统的对频步骤——强烈建议设置。任何使用相同对频短语的发射端都能连接到使用相同短语的接收机，所以请确保短语具有唯一性。仅限使用英文字母和数字。未启用对频短语的固件需要使用传统[对频方法](binding.md)。 +设置对频短语可以让你跳过传统的对频步骤——强烈建议设置。任何使用相同对频短语的发射端都能连接到使用相同短语的接收机，所以请确保短语具有唯一性。仅限使用英文字母和数字。未启用对频短语的固件需要使用传统的[对频方法](binding.md)。 ## 网络选项 @@ -84,7 +84,7 @@ RCVR_INVERT_TX ``` USE_R9MM_R9MINI_SBUS ``` -仅适用于R9MM/R9Mini，此选项会将接收机的 CRSF 输出从侧边的 A9 和 A10 引脚切换到标有“SBUS”的引脚（反转）。同样不会转换为 SBUS 协议，飞控协议仍需选择 CRSF +仅适用于 R9MM/R9Mini，此选项会将接收机的 CRSF 输出从侧边的 A9 和 A10 引脚切换到标有“SBUS”的引脚（反转）。同样不会转换为 SBUS 协议，飞控协议仍需选择 CRSF **相当于反转的CRSF协议，可以接到飞控的SBUS焊盘** diff --git a/docs/zh/quick-start/getting-started.md b/docs/zh/quick-start/getting-started.md index fc7a04aca..9ef702d9e 100644 --- a/docs/zh/quick-start/getting-started.md +++ b/docs/zh/quick-start/getting-started.md @@ -42,7 +42,7 @@ description: 在这里开始你的 ELRS 历程! 这是让你用 ELRS 飞起来 3. [检查接收机版本](receivers/firmware-version.md) 4. [更新接收机固件](receivers/updating.md) -弄完了之后，你可以继续以下步骤: +完成以上操作了之后，你可以继续以下步骤: - [对频](binding.md) - [性能测试](pre-1stflight.md#性能测试) diff --git a/docs/zh/quick-start/installing-configurator.md b/docs/zh/quick-start/installing-configurator.md index 4ec62f427..c2cd756ae 100644 --- a/docs/zh/quick-start/installing-configurator.md +++ b/docs/zh/quick-start/installing-configurator.md @@ -5,7 +5,7 @@ description: ELRS地面站极大提升了ELRS的易用性，是让你的ELRS设 ![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) -刷写ELRS有两种方式： +刷写 ELRS 有两种方式： 1. [ELRS 地面站](https://github.com/ExpressLRS/ExpressLRS-Configurator/releases) (**推荐**) 2. [开发工具链](../software/toolchain-install.md) (仅限于高级用户) diff --git a/docs/zh/receivers/configuring-fc.md b/docs/zh/receivers/configuring-fc.md index 22eccea84..0751b6731 100644 --- a/docs/zh/receivers/configuring-fc.md +++ b/docs/zh/receivers/configuring-fc.md @@ -7,21 +7,21 @@ description: 按照本指南为你的飞控配置 ExpressLRS。 ## 串口接收机设置 -当你已经完成[接收机接线](wiring-up.md)后，需要在飞控配置工具的 Ports（端口）标签页为接收机所在 UART 启用 Serial RX（串口接收机）。 +当你已经完成[接收机接线](wiring-up.md)后，需要在飞控配置工具的 Ports（端口）标签页为接收机所在 UART 启用 Serial RX（串行数字接收机）。 -如下例，接收机接在 UART1（TX1 和 RX1 焊盘），则应在 Ports 标签页的 UART1 行勾选 Serial RX。 +如下例，接收机接在 UART1（TX1 和 RX1 焊盘），则应在 Ports 标签页的 UART1 行勾选 Serial RX（串行数字接收机）。 !!! note "注意" 这只是示例。请根据你接收机的实际接线情况设置端口。
![Ports Tab](../../assets/images/PortsTab.png) -
Betaflight 串口接收机端口设置示例
+
Betaflight 串口设置示例
![INAV Ports](../../assets/images/FC-portsconfig-INAV.png) -
INAV 串口接收机端口设置示例
+
INAV 串口设置示例
## 串口接收机协议