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/ardupilot-setup.md b/docs/zh/quick-start/ardupilot-setup.md new file mode 100644 index 000000000..849c12f47 --- /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 的 UART + +祝你飞行愉快! :airplane: diff --git a/docs/zh/quick-start/binding.md b/docs/zh/quick-start/binding.md new file mode 100644 index 000000000..420d4b312 --- /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..3adb774e5 --- /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 new file mode 100644 index 000000000..9ef702d9e --- /dev/null +++ b/docs/zh/quick-start/getting-started.md @@ -0,0 +1,106 @@ +--- +template: i18n/zh/main.html +description: 在这里开始你的 ELRS 历程! 这是让你用 ELRS 飞起来的最全面的指南 +--- + +![Setup-Banner](https://raw.githubusercontent.com/ExpressLRS/ExpressLRS-hardware/master/img/quick-start.png) + +!!! attention "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/docs/zh/quick-start/installing-configurator.md b/docs/zh/quick-start/installing-configurator.md new file mode 100644 index 000000000..c2cd756ae --- /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..8343ccc30 --- /dev/null +++ b/docs/zh/quick-start/led-status.md @@ -0,0 +1,71 @@ +--- +template: i18n/zh/main.html +description: ExpressLRS 接收机和发射端模块上的 LED 是非常有用的诊断工具,可以帮助你判断设备当前状态。 +--- + +![Setup-Banner](https://github.com/ExpressLRS/ExpressLRS-Hardware/raw/master/img/quick-start.png) + +## 接收机/发射端 LED 状态 + +ExpressLRS 使用 LED 指示发射端和接收机的工作状态。 + +不同状态下的 LED 指示如下: + +=== "接收机单色 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 模式 | + +=== "接收机 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 颜色 | 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 | | + +=== "发射端 RGB LED" + | LED 指示 | 状态说明 | + |-------------------------------|--------------------------------------------------------------| + | 彩虹渐变效果 | 启动中 | + | 绿色闪烁 | 进入 Web 更新模式 | + | 蓝色闪烁 | 启用蓝牙摇杆 | + | 红色闪烁(100ms) | 无法检测到射频芯片 | + | 橙色(1000ms) | 未连接遥控器 | + | 单色常亮 | 已连接接收机,颜色表示包速率 | + | 单色渐变 | 未连接接收机,颜色表示包速率 | + + | 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 | | \ No newline at end of file diff --git a/docs/zh/quick-start/pre-1stflight.md b/docs/zh/quick-start/pre-1stflight.md new file mode 100644 index 000000000..b04813b42 --- /dev/null +++ b/docs/zh/quick-start/pre-1stflight.md @@ -0,0 +1,162 @@ +--- +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 模块天线方向一致。(建议暂时断开图传,或让图传进入 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)。 + +## 黑匣子 + +黑匣子可以用来评估飞行时射频链路性能。将黑匣子设置为 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/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/docs/zh/quick-start/webui.md b/docs/zh/quick-start/webui.md new file mode 100644 index 000000000..5d3313991 --- /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/docs/zh/receivers/configuring-fc.md b/docs/zh/receivers/configuring-fc.md new file mode 100644 index 000000000..0751b6731 --- /dev/null +++ b/docs/zh/receivers/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/docs/zh/receivers/firmware-version.md b/docs/zh/receivers/firmware-version.md new file mode 100644 index 000000000..26d598b99 --- /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/docs/zh/receivers/wiring-up.md b/docs/zh/receivers/wiring-up.md new file mode 100644 index 000000000..97d3a65ec --- /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/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/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 a57117884..6d39d8db5 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 + - 固件选项: quick-start/firmware-options.md + - WebUI: quick-start/webui.md + - 高频头: + - 设置遥控器: quick-start/transmitters/tx-prep.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 + - 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 + - 接收机: + - 接收机接线: quick-start/receivers/wiring-up.md + - 飞控配置: quick-start/receivers/configuring-fc.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 + - 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 状态: quick-start/led-status.md + - 对频: quick-start/binding.md + - 首飞之前: quick-start/pre-1stflight.md + - Ardupilot 设置: quick-start/ardupilot-setup.md + - Troubleshooting: quick-start/troubleshooting.md + - 救砖: 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 %}