Add Chinese Localization

docs/zh/index.md

@@ -0,0 +1,4 @@
+---
+template: i18n/zh/home.html
+title: 开源的高性能遥控链路
+---

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 的波特率通信
+
+
+<figure markdown>
+![RC_Options Bitmask](../assets/images/ArduRCOPTIONS.png)
+</figure>
+
+设置好上述参数后，请断开并重新连接电池和 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:

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) 的对频短语字段中输入一个简短且独特的对频短语。
+
+<figure markdown>
+![Binding Phrase Field](../assets/images/bindingphrase-textfield.png)
+<figcaption>对频短语输入框</figcaption>
+</figure>
+
+如果你的设备支持 WiFi，并且已升级到 ExpressLRS 3.0 或更高版本，也可以通过 WebUI 更改对频短语。详见[WebUI 用户指南](webui.md)。
+
+<figure markdown>
+![Binding Phrase Field WebUI](../assets/images/bindingphrase-webui.png)
+<figcaption>WebUI 中的对频短语输入框</figcaption>
+</figure>
+
+建议使用至少 8 位字母和数字组成的**唯一**短语。推荐用你的飞手昵称。这个短语不需要复杂或保密，因为它不是密码或加密密钥。
+
+??? info "我的对频短语需要保密吗？（点击展开）"
+    不需要，就像你的图传频道不是秘密一样。对频短语不是安全用途，而是防止干扰。如果大家都用一样的短语，互相干扰的概率就很高。请确保你的短语独特，避免与他人重复，也可以发挥创意，设置有趣的短语。
+
+## 传统对频方法
+
+传统对频要求接收机未设置对频短语。
+
+!!! info "3.4.0 更新"
+    任何刷写了 3.4.0 或更高版本的接收机，即使设置了对频短语，也可以进入对频模式。
+
+!!! warning "注意"
+    如果接收机已设置对频短语，将无法进入手动对频模式，无论你尝试多少次。必须先重新刷写并取消设置对频短语。既然都要刷固件了，建议直接用对频短语 :grin:
+
+接收机上电后，LED 应该会闪烁。
+
+<figure markdown>
+![LEDSEQ_DISCONNECTED](../assets/images/LEDSEQ_DISCONNECTED_50_50.gif)
+</figure>
+
+??? danger "接收机 LED 不闪烁（点击展开）"
+    如果接收机进入 Bootloader 模式，可以尝试以下方法：
+
+    1. 检查接收机上的 Boot 按钮是否被按下或损坏。
+        - 如果被按下或挤压，移除原因（如热缩管压到按钮）。
+        - 如果损坏，建议更换或联系卖家售后。
+
+    2. 如果是 Boot 焊盘，检查是否与 GND 焊盘连接。
+        - 如果连接了 GND 焊盘，断开连接。
+
+    3. 断开接收机的 RX 和 TX 线，重新上电，观察 LED。
+        - 如果开始慢闪（500ms），建议换到其他 UART。
+        - 如果其他 UART 被占用，尝试加上拉电阻（300~1k 欧姆，越小效果越好），连接 UART 的 RX 焊盘和 5V 或 3.3V。
+
+        <figure markdown>
+        ![ExpressLRS Pull-up](../assets/images/pull-up.png)
+        </figure>
+
+    4. 如果你用的是数字图传（如 DJI Air Unit、Caddx Vista、DJI O3），且六根线都接到飞控，需要移除 SBUS/DJI HDL 线。
+
+对频步骤如下：
+
+1. 关闭你的遥控器/发射端。
+2. 给接收机断电并重新上电 3 次。
+    - 给接收机供电。
+    - LED 亮起。
+    - 2 秒内断电。
+    - 重复 2 次。
+
+    !!! warning "注意"
+        建议用电池操作，确保飞控接线无误且无短路，避免烧坏设备，你也不想让魔法烟雾释放出来吧
+
+3. 确认 LED 快速双闪，表示接收机进入对频模式。
+
+    <figure markdown>
+    ![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif)
+    </figure>
+
+4. 打开遥控器/发射端，在 ELRS Lua 脚本中选择 ++"[BIND]"++，发送对频信号。弹窗会短暂出现后消失。
+
+    <figure markdown>
+    ![Bind Mode](../assets/images/lua/bind-bw.png)
+    </figure>
+
+5. 如果接收机 LED 常亮，说明对频成功！
+
+    <figure markdown>
+    ![CONNECTED](../assets/images/LED_ON.gif)
+    </figure>
+
+## 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]` 按钮即可完成对频。
+
+<figure markdown>
+![LEDSEQ_BINDING](../assets/images/LEDSEQ_BINDING_10_10_10_100.gif)
+</figure>
+
+对频成功后，用户可随时用以上三种方法让接收机再次进入对频模式。对频信息会一直保留，直到再次进行对频。
+
+取消对频模式只需重启或断电，或与发射端对频。若没有对频重启后会用旧的对频信息。
+
+Lua 脚本或 WebUI 可设置对频信息为易失性（volatile），即只在本次上电有效，重启后自动进入对频模式。
+
+## 连接检查
+
+使用 [ExpressLRS Lua 脚本](transmitters/lua-howto.md)，观察屏幕右上角是否有 `C`，表示发射端和接收机已连接并通信。
+
+1. 按下遥控器上的 ++"SYS"++ 键。
+    - 老款遥控器或只有一个菜单键，需长按菜单键进入系统菜单。
+    - 具体操作请查阅遥控器说明书。
+
+2. 进入工具菜单，找到并选择 `ExpressLRS` Lua 脚本。
+
+    <figure markdown>
+    ![Lua Script]
+    </figure>
+
+    - 如果没有该脚本，请从[这里](transmitters/lua-howto.md)下载并保存到遥控器 SD 卡的 Scripts/Tools/ 文件夹。
+
+3. 按 ++enter++ 加载脚本。
+
+    <figure markdown >
+    ![Lua Running]
+    </figure> 
+
+    - 如果脚本卡在 "Loading..."，请返回[设置遥控器](transmitters/tx-prep.md)页面，确保已正确配置 ExpressLRS。
+
+
+4. 屏幕右上角出现 `C`，表示发射端和接收机已连接。
+
+    <figure markdown>
+    ![Lua Loaded](../assets/images/tx-internalLuaCheck.jpg)
+    </figure>
+
+??? tip "模型不匹配（点击展开）"
+    如果 Lua 脚本右上角出现 `C`，但随后消失并显示 "Model Mismatch"，不用担心。ExpressLRS 检测到接收机的 Model ID 与当前遥控器模型配置的 Receiver ID 不一致。
+
+    接收机 LED 会三快闪后暂停：
+
+    <figure markdown>
+    ![LEDSEQ_MODEL_MISMATCH](../assets/images/LEDSEQ_MODEL_MISMATCH_10_10_10_10_10_100.gif)
+    </figure>
+
+    如果你按[此页面](../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

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`发射端常见的选项。
+
+<figure markdown>
+![2400 TX Options](../assets/images/ConfigurationOptions2400tx.png)
+</figure>
+
+<figure markdown>
+![900 TX Options](../assets/images/ConfigurationOptions900tx.png)
+</figure>
+
+## 无线通信监管域
+```
+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固件则需关闭此选项。~~
+目前**大部分开源遥控器**不需要开启这个功能，若无法使用，请开启此功能
+
+## 接收机专用选项
+
+<figure markdown>
+![2400 RX Options](../assets/images/ConfigurationOptions2400rx.png)
+</figure>
+
+<figure markdown>
+![900 RX Options](../assets/images/ConfigurationOptions900rx.png)
+</figure>
+
+!!! 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)。
+
+**全部设置完成！现在可以为你的高频头刷写固件了。**