New Crowdin translations - ko (#24677)

Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
2026-04-14 10:07:39 +08:00 · 2025-04-09 14:24:28 +10:00 · 2025-04-09 14:24:28 +10:00 · e58035c57a
commit e58035c57a
parent 6704cc14f9
10 changed files with 392 additions and 68 deletions
--- a/docs/ko/SUMMARY.md
+++ b/docs/ko/SUMMARY.md
@ -314,6 +314,7 @@
  - [Joysticks](config/joystick.md)
  - [Data Links](data_links/index.md)
    - [MAVLink 텔레메트리(OSD/GCS) ](peripherals/mavlink_peripherals.md)
+
    - [텔레메트리 무선통신](telemetry/index.md)
      - [SiK 무선통신](telemetry/sik_radio.md)
        - [RFD900 (SiK) 텔레메트리](telemetry/rfd900_telemetry.md)
@ -326,9 +327,13 @@
        - [ARK Electron Microhard Serial Telemetry Radio](telemetry/ark_microhard_serial.md)
        - [Holybro Microhard P900 Telemetry Radio](telemetry/holybro_microhard_p900_radio.md)
      - [CUAV P8 Telemetry Radio](telemetry/cuav_p8_radio.md)
+      - [J.Fi Wireless Telemetry Module](telemetry/jfi_telemetry.md)
      - [HolyBro XBP9X - Discontinued](telemetry/holybro_xbp9x_radio.md)
+
    - [FrSky 텔레메트리](peripherals/frsky_telemetry.md)
+
    - [TBS Crossfire (CRSF) Telemetry](telemetry/crsf_telemetry.md)
+
    - [Satellite Comms (Iridium/RockBlock)](advanced_features/satcom_roadblock.md)
  - [Power Systems](power_systems/index.md)
    - [Battery Estimation Tuning](config/battery.md)
@ -841,4 +846,4 @@
  - [1.15 (stable)](releases/1.15.md)
  - [1.14](releases/1.14.md)
  - [1.13](releases/1.13.md)
-  - [1.12](releases/1.12.md)
+  - [1.12](releases/1.12.md)
--- a/docs/ko/advanced/gimbal_control.md
+++ b/docs/ko/advanced/gimbal_control.md
@ -43,7 +43,9 @@ The gimbal can be connected to _any free serial port_ using the instructions in
 For example, if the `TELEM2` port on the flight controller is unused you can connect it to the gimbal and set the following PX4 parameters:

 - [MAV_1_CONFIG](../advanced_config/parameter_reference.md#MAV_1_CONFIG) to **TELEM2** (if `MAV_1_CONFIG` is already used for a companion computer (say), use `MAV_2_CONFIG`).
- [MAV_1_MODE](../advanced_config/parameter_reference.md#MAV_1_MODE) to **NORMAL**
+- [MAV_1_MODE](../advanced_config/parameter_reference.md#MAV_1_MODE) to **Gimbal**
+- [MAV_1_FLOW_CTRL](../advanced_config/parameter_reference.md#MAV_1_FLOW_CTRL) to **Off (0)** (very few gimbals will have RST/CST wires connected).
+- [MAV_1_FORWARD](../advanced_config/parameter_reference.md#MAV_1_FORWARD) to **Enabled** (Note strictly necessary as forwarding is enabled when `MAV_1_MODE` is set to Gimbal).
 - [SER_TEL2_BAUD](../advanced_config/parameter_reference.md#SER_TEL2_BAUD) to manufacturer recommended baud rate.

 ### Multiple Gimbal Support
--- a/docs/ko/config/_autotune.md
+++ b/docs/ko/config/_autotune.md
@ -131,6 +131,20 @@ Additional notes:

 - Whether tuning is applied while flying or after landing can be [configured using parameters](#apply-tuning-when-in-air-landed).

+<div v-if="$frontmatter.frame === 'Multicopter'">
+
+## Autotuning Large Vehicles
+
+For big multicopter vehicles you may need to increase the desired raise time of the step response [MC_AT_RISE_TIME](../advanced_config/parameter_reference.md#MC_AT_RISE_TIME).
+This requires some trial and error as an appropriate rise time depends on both vehicle size and the rotor response.
+
+Note that if there are slow oscillations in pretuning it may mean that the attitude loop is too fast compared to the rate loop.
+In this case you should troubleshoot as described in [Drone oscillates when performing the pre-tuning test](#drone-oscillates-when-performing-the-pre-tuning-test).
+
+<!-- Fixed wing rise time is hardcoded (it's lower than on multirotors and is probably enough for most platforms). -->
+
+</div>
+
 ## 문제 해결

 ### Drone oscillates when performing the pre-tuning test
--- a/docs/ko/config/safety.md
+++ b/docs/ko/config/safety.md
@ -146,6 +146,12 @@ The Data Link Loss failsafe is triggered if a telemetry link (connection to grou
 | 데이터 연결불량 시간 초과 | [COM_DL_LOSS_T](../advanced_config/parameter_reference.md#COM_DL_LOSS_T) | 데이터 연결이 끊어진 후 안전 장치가 동작하기 전까지의 시간입니다.                           |
 | 안전장치 동작        | [NAV_DLL_ACT](../advanced_config/parameter_reference.md#NAV_DLL_ACT)                          | Disabled, Hold mode, Return mode, Land mode, Disarm, Terminate. |

+다음 설정도 가능하지만 QGC UI에 표시되지 않습니다.
+
+| 설정                                                          | 매개변수                                                                                                                 | 설명                                                                   |
+| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| <a id="COM_DLL_EXCEPT"></a>Mode exceptions for DLL failsafe | [COM_DLL_EXCEPT](../advanced_config/parameter_reference.md#COM_DLL_EXCEPT) | Set modes where DL loss will not trigger a failsafe. |
+
 ## Geofence 안전장치

 The _Geofence Failsafe_ is triggered when the drone breaches a "virtual" perimeter.
--- a/docs/ko/contribute/docs.md
+++ b/docs/ko/contribute/docs.md
@ -17,7 +17,7 @@ Simple changes to _existing content_ can be made by clicking the **Edit on GitHu

 ![Vitepress: Edit Page button](../../assets/vuepress/vuepress_edit_page_on_github_link.png)

-기존 페이지를 편집하려면:
+To edit an existing English page:

 1. 해당 페이지를 엽니다.
 2. Click the **Edit on GitHub** link below the page content.
@ -26,19 +26,32 @@ Simple changes to _existing content_ can be made by clicking the **Edit on GitHu

 문서 팀은 요청을 검토하고, 병합하거나 업데이트하기 위하여 귀하와 협력할 것입니다.

-## Git을 사용한 변경(새 페이지 및 이미지)
+Note that you can only make changes to the English version directly in the source.
+[Translations are handled in Crowdin](../contribute/translation.md).
+
+## Changes using Git

 새 페이지 추가 또는 이미지 추가/수정을 포함하여 보다 실질적인 변경은 Github에서 수행(또는 적절하게 테스트)하는 것처럼 간단하지 않습니다.
+
 For these kinds of changes we suggest using the same approach as for _code_:

-1. Use the _git_ toolchain to get the documentation source code onto your local computer.
+1. Use the _git_ toolchain to get the PX4 source code onto your local computer.
 2. 필요한 문서를 수정합니다(추가, 변경, 삭제).
 3. _Test_ that it builds properly using Vitepress.
-4. 변경 사항에 대한 분기를 만들고 풀 요청을 만들어 문서로 다시 가져옵니다.
+4. Create a branch for your changes and create a pull request (PR) to pull it back into the [PX4-Autopilot](https://github.com/PX4/PX4-Autopilot.git) repo.

 다음에는 소스 코드를 가져오고, 로컬에서 빌드(테스트용)하고, 코드를 수정하는 방법을 설명합니다.

-### 문서 소스 코드 가져오기/보내기
+### Get Documentation Source Code
+
+Documentation sources are in the [PX4-Autopilot](https://github.com/PX4/PX4-Autopilot/) repo, alongside all the other PX4 source code.
+The sources are markdown files located the [/docs](https://github.com/PX4/PX4-Autopilot/tree/main/docs) subdirectory.
+The English source files are in the [/docs/en/](https://github.com/PX4/PX4-Autopilot/tree/main/docs/en) subdirectory and can be edited directly.
+[Translation](../contribute/translation.md) sources are in language specific subdirectories, such as `ko` for korean and `zh` for Chinese: these are edited via the Crowdin tool, and should not be edited directly.
+
+:::tip
+If you already have a clone of the [PX4-Autopilot](https://github.com/PX4/PX4-Autopilot/) you can ignore this section.
+:::

 라이브러리 소스를 로컬 컴퓨터로 가져오려면 git 명령어를 사용하여야 합니다.
 아래 지침은 git을 가져와 로컬 컴퓨터에서 사용하는 방법을 설명합니다.
@ -47,31 +60,31 @@ For these kinds of changes we suggest using the same approach as for _code_:

 2. [Sign up](https://github.com/join) for Github if you haven't already

-3. Create a copy (Fork) of the [PX4 User Guide repo](https://github.com/PX4/PX4-user_guide) on Github ([instructions here](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).
+3. Create a copy (Fork) of the [PX4-Autopilot repo](https://github.com/PX4/PX4-Autopilot) on Github ([instructions here](https://docs.github.com/en/get-started/quickstart/fork-a-repo)).

 4. 복사된 저장소를 로컬 컴퓨터에 복제합니다.

  ```sh
  cd ~/wherever/
-  git clone https://github.com/<your git name>/PX4-user_guide.git
+  git clone https://github.com/<your git name>/PX4-Autopilot.git
  ```

-  예를 들어, Github 계정이 "john_citizen"인 사용자의 PX4 사용자 가이드 포크를 복제합니다.
+  For example, to clone PX4 source fork for a user with Github account "john_citizen":

  ```sh
-  git clone https://github.com/john_citizen/PX4-user_guide.git
+  git clone https://github.com/john_citizen/PX4-Autopilot.git
  ```

 5. 로컬 저장소로 이동합니다.

  ```sh
-  cd ~/wherever/PX4-user_guide
+  cd ~/wherever/PX4-Autopilot
  ```

-6. Add a _remote_ called "upstream" to point to the PX4 version of the library:
+6. Add a _remote_ called "upstream" to point to the "official" PX4 version of the library:

  ```sh
-  git remote add upstream https://github.com/PX4/PX4-user_guide.git
+  git remote add upstream https://github.com/PX4/PX4-Autopilot.git
  ```

  :::tip
@ -81,7 +94,19 @@ For these kinds of changes we suggest using the same approach as for _code_:

 :::

-7. 변경 사항에 대한 브랜치를 생성합니다.
+### Make/Push Documentation Changes
+
+Within the repository you created above:
+
+1. Bring your copy of the repository `main` branch up to date:
+
+  ```sh
+  git checkout main
+  git fetch upstream main
+  git pull upstream main
+  ```
+
+2. Create a new branch for your changes:

  ```sh
  git checkout -b <your_feature_branch_name>
@ -89,9 +114,9 @@ For these kinds of changes we suggest using the same approach as for _code_:

  This creates a local branch on your computer named `your_feature_branch_name`.

-8. 필요에 따라 문서를 변경합니다(다음 섹션에서 이에 대한 일반 지침).
+3. 필요에 따라 문서를 변경합니다(다음 섹션에서 이에 대한 일반 지침).

-9. 변경 사항에 완료되면 "커밋"을 사용하여, 로컬 브랜치에 추가합니다.
+4. 변경 사항에 완료되면 "커밋"을 사용하여, 로컬 브랜치에 추가합니다.

  ```sh
  git add <file name>
@ -100,23 +125,26 @@ For these kinds of changes we suggest using the same approach as for _code_:

  For a good commit message, please refer to the [Source Code Management](../contribute/code.md#commits-and-commit-messages) section.

-10. 로컬 분기(추가된 커밋 포함)를 Github의 분기된 저장소에 푸시합니다.
+5. 로컬 분기(추가된 커밋 포함)를 Github의 분기된 저장소에 푸시합니다.

  ```sh
  git push origin your_feature_branch_name
  ```

-11. Go to your forked repository on Github in a web browser, e.g.: `https://github.com/<your git name>/PX4-user_guide.git`.
+6. Go to your forked repository on Github in a web browser, e.g.: `https://github.com/<your git name>/PX4-Autopilot.git`.
  새 분기가 분기된 저장소로 푸시되었다는 메시지가 표시되어야 합니다.

-12. 풀 요청(PR) 생성:
+7. 풀 요청(PR) 생성:
+
  - On the right hand side of the "new branch message" (see one step before), you should see a green button saying "Compare & Create Pull Request".
    클릭합니다.
  - 풀 요청 템플릿이 생성됩니다.
    그것은 당신의 커밋을 나열하고 의미 있는 제목(하나의 커밋 PR의 경우 일반적으로 커밋 메시지)과 메시지(<span style="color:orange">어떤 이유에서 수행했는지 설명</span>)를 추가할 수 있습니다(반드시).
-    Check [other pull requests](https://github.com/PX4/PX4-user_guide/pulls) for comparison)
+    Check [other pull requests](https://github.com/PX4/PX4-Autopilot/pulls) for comparison).
+  - Add the "Documentation" label.
+
+8. 완료하였습니다.

-13. 완료하였습니다.
  PX4 사용자 가이드 유지 관리자는 이제 귀하의 기여를 검투한 후에, 통합 여부를 결정합니다.
  때때로 변경 사항에 대한 질문을 확인하십시오.

@ -129,10 +157,10 @@ For these kinds of changes we suggest using the same approach as for _code_:
  - [Nodejs 18+](https://nodejs.org/en)
  - [Yarn classic](https://classic.yarnpkg.com/en/docs/install)

-2. 로컬 저장소로 이동합니다.
+2. Navigate to your local repository and the `/docs` subdirectory:

  ```sh
-  cd ~/wherever/PX4-user_guide
+  cd ~/wherever/PX4-Autopilot/docs
  ```

 3. 종속성(Vuepress 포함)들을 설치합니다.
--- a/docs/ko/data_links/index.md
+++ b/docs/ko/data_links/index.md
@ -11,3 +11,7 @@ This section provides information about various radio systems that you can use,
 - [FrSky Telemetry](../peripherals/frsky_telemetry.md) — Telemetry on your (FRSky) RC Receiver
 - [TBS Crossfire (CRSF) Telemetry](../telemetry/crsf_telemetry.md) — Telemetry on your (TBS Crossfire) RC Receiver
 - [Satellite Comms (Iridium/RockBlock)](../advanced_features/satcom_roadblock.md) — High-latency comms via satellite
+
+## See Also
+
+- [Safety Configuration > Data Link Loss Failsafe](../config/safety.md#data-link-loss-failsafe)
--- a/docs/ko/dev_log/log_encryption.md
+++ b/docs/ko/dev_log/log_encryption.md
@ -190,67 +190,189 @@ You can now build and test.

 ## Download & Decrypt Log Files

-Encrypted log files are downloaded using the QGroundControl [Log Download](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/analyze_view/log_download.html) view (**Analyze Tools > Log Download**) just like ordinary log files.
+Before you can analyse your logs they must first be downloaded and decrypted.
+PX4 includes Python scripts in [Tools/log_encryption](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/) that make this process easier:

-Note that the encrypted files will be downloaded with the `.ulg` suffix, instead of `.ulge`.
+- [download_logs.py](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/log_encryption/download_logs.py): Downloads the logs to `/logs/encrypted`.
+- [decrypt_logs.py](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/log_encryption/decrypt_logs.py): Decrypts encrypted logs in `/logs/encrypted` to `/logs/decrypted` using a specified (or default) key.
+
+The following sections show how these are used.
+
+### Download Log Files
+
+The easiest way to download the files is to use [download_logs.py](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/log_encryption/download_logs.py).
+This takes a single argument that sets the serial or UDP MAVLink connection to the device as shown below (adjust parameters as needed):
+
+- UDP connection
+
+  ```sh
+  cd PX4-Autopilot/Tools/log_encryption
+  python3 download_logs.py udp:0.0.0.0:14550
+  ```
+
+- USB serial port on Linux
+
+  ```sh
+  cd PX4-Autopilot/Tools/log_encryption
+  python3 download_logs.py /dev/ttyACM0 --baudrate 57600
+  ```
+
+The files are downloaded to `/logs/encrypted`, which is the location expected by the decryption script.
+
+:::info
+Encrypted log files can also be downloaded manually using the QGroundControl [Log Download](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/analyze_view/log_download.html) view (**Analyze Tools > Log Download**) just like ordinary log files.
+
+Note that in this case you will need to copy the files to `/logs/encrypted` and rename them to the `.ulge` suffix (they are downloaded with the `.ulg` suffix)
+:::

 ### Decrypt ULogs

-Before you can analyze your encrypted logs, you will need to decrypt them.
-There is a Python script that can be used to decrypt logs in `Tools/decrypt_ulog.py`.
+By default, the [decrypt_logs.py](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/log_encryption/decrypt_logs.py) script decrypts encrypted logs in `/logs/encrypted` using the private key in `keys/private/private_key.pem`, and generates the unencrypted logs in `/logs/decrypted`.

-When decrypting a `.ulge` file the script takes 3 arguments:
-
-1. The encrypted log file.
-2. An empty string `''`.
-3. The decryption key (the RSA2048 `.pem` private key which is used to unwrap the symmetric key).
-
-예:
+Navigate into the `Tools/log_encryption` folder and run the tool as shown below:

 ```sh
-python3 decrypt_ulog.py \
-/home/john/Downloads/log_24_2024-10-6-23-39-50.ulg '' \
-new_keys/private_key.pem
+cd PX4-Autopilot/Tools/log_encryption
+python3 decrypt_logs.py
 ```

-On success the decrypted log file is created with the `.ulog` suffix.
-
-:::info
-The script can be used with both `.ulge` logs and the `.ulgc`/`.ulgk` files used in [PX4 v1.15 Log Encryption](https://docs.px4.io/v1.15/en/dev_log/log_encryption.html).
-The full command line syntax is given below:
+On success the decrypted logs can be found in the decrypted folder.

 ```sh
-usage: decrypt_ulog.py [-h] [ulog_file] [ulog_key] [rsa_key]
+PX4-Autopilot/logs/decrypted
+```

-CLI tool to decrypt an ulog file
+The expected folder structure showing the location of encrypted logs, decrypted logs and the default private key is shown below:

-positional arguments:
-  ulog_file   .ulge/.ulgc, encrypted log file
-  ulog_key    .ulgk, legacy encrypted key (give empty string '' to ignore for .ulge)
-  rsa_key     .pem format key for decrypting the ulog key
+```sh
+PX4-Autopilot/
+│
+├── logs/ # Main directory for logs
+│ ├── encrypted/ # Stores encrypted logs (.ulge)
+│ │ ├── log-YYYY-MM-DD_HH-MM-SS_ID.ulge # Encrypted logs
+│ │
+│ ├── decrypted/
+│ │ ├── log-YYYY-MM-DD_HH-MM-SS_ID.ulg # Regular PX4 logs
+|
+├── keys/ # Main directory for keys
+  ├── private/ # Stores private keys
+    ├── private_key.pem # RSA private key (2048-bit)
+```

-optional arguments:
-  -h, --help  show this help message and exit
+:::tip
+The script also allows you to specify a particular key and/or to specify a particular file or folder to be decrypted using optional positional arguments:
+
+```sh
+python3 decrypt_logs.py ["" | custom_key] [log_file.ulge | log_folder]
+```
+
+The full set of command options are shown below:
+
+```sh
+# Default key + default folder
+python3 decrypt_logs.py
+
+# Specific key + default folder
+python3 decrypt_logs.py path/to/private_key.pem
+
+# Specific key + specific file
+python3 decrypt_logs.py path/to/private_key.pem path/to/log_file.ulge
+
+# Specific key + specific folder
+python3 decrypt_logs.py path/to/private_key.pem path/to/log_folder
+
+# Default key + specific file
+python3 decrypt_logs.py "" path/to/log_file.ulge
+
+# Default key + specific folder
+python3 decrypt_logs.py "" path/to/log_folder
 ```

 :::

 ## Generate RSA Public & Private Keys

-To generate a RSA2048 private and public key, you can use OpenSSL:
+The [Tools/log_encryption/generate_keys.py](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/log_encryption/generate_keys.py) script can be used to generate the public key that is used on the device for encryption, and the private key that is used on the computer as part of log decryption.
+
+:::details
+The script depends on OpenSSL.
+
+Run the following command to check if OpenSSL is present:

 ```sh
-openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048
+openssl version
 ```

-Then you can create a public key from this private key:
+If there is no output you can install OpenSSL as shown below:
+
+- Ubuntu/Debian
+
+  ```sh
+  sudo apt update
+  sudo apt install openssl
+  ```
+
+- macOS
+
+  ```sh
+  brew install openssl
+  ```
+
+:::
+
+The script is used as shown:

 ```sh
-# Convert private_key.pem to a DER file
-openssl rsa -pubout -in private_key.pem -outform DER -out public_key.der
-# From the DER file, generate a public key in hex format, separated by commas
-xxd -p public_key.der | tr -d '\n' | sed 's/\(..\)/0x\1, /g' > public_key.pub
+cd PX4-Autopilot/Tools/log_encryption
+python3 generate_keys.py
 ```

-To use this key you would modify your `.px4board` file to point `CONFIG_PUBLIC_KEY1` to the file location of `public_key.pub`.
-The private key generated should be stored safely and used when you need to decrypt log files.
+The private and public key will be generated into the folder structure below.
+The private key should be stored safely and used when you need to [decrypt log files](#decrypt-ulogs).
+
+```sh
+PX4-Autopilot/
+│
+├── keys/ # Main directory for keys
+│ ├── private/ # Stores private keys
+│ │ ├── private_key.pem # RSA private key (2048-bit)
+│ │
+│ ├── public/ # Stores public keys
+│ │ ├── public_key.der # Public key in DER format
+│ │ ├── public_key.pub # Public key in hex format
+```
+
+참고:
+
+- The script will not overwrite any existing keys in the folders.
+  It will generate a new public key if the folder only includes a private key.
+- The public key is created with the default name and location expected by the toolchain when building PX4 (i.e. in `CONFIG_PUBLIC_KEY1`), and the private key is created in the default location expected by the script we use for [decrypting ulogs](#decrypt-ulogs).
+
+### Manual Key Generation
+
+This section explains how you might manually run the same steps as the script (should you so wish):
+
+1. First install OpenSSL, as described in the previous section.
+
+2. Use OpenSSL to generate a RSA2048 private and public key:
+
+  ```sh
+  openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048
+  ```
+
+3. Create a public key from this private key:
+
+  ```sh
+  # Convert private_key.pem to a DER file
+  openssl rsa -pubout -in private_key.pem -outform DER -out public_key.der
+  # From the DER file, generate a public key in hex format, separated by commas
+  xxd -p public_key.der | tr -d '\n' | sed 's/\(..\)/0x\1, /g' > public_key.pub
+  ```
+
+4. Copy the keys into the appropriate locations expected by the rest of the toolchain (as shown in previous section).
+
+5. To use this key, modify your `.px4board` file to point `CONFIG_PUBLIC_KEY1` to the file location of `public_key.pub`.
+
+  ```sh
+  CONFIG_PUBLIC_KEY1="../../../keys/public/public_key.pub"
+  ```
--- a/docs/ko/peripherals/mavlink_peripherals.md
+++ b/docs/ko/peripherals/mavlink_peripherals.md
@ -1,6 +1,6 @@
-# MAVLink 주변 장치(OSD/GCS/보조 컴퓨터 등)
+# MAVLink Peripherals (GCS/OSD/Gimbal/Camera/Companion)

-GCS(Ground Control Station), OSD(On-Screen Display), 보조 컴퓨터, ADS-B 수신기와 기타 MAVLink 주변 장치들은 서로 다른 직렬 포트를 통하여 전송되는 별도의 MAVLink 스트림을 통하여 PX4와 상호 작용합니다.
+Ground Control Stations (GCS), On-Screen Displays (OSD), MAVLink Cameras & Gimbals, Remote IDs, Companion Computers, ADS-B receivers, and other MAVLink peripherals interact with PX4 using separate MAVLink streams, sent via different serial ports.

 In order to configure that a particular serial port is used for MAVLink traffic with a particular peripheral, we use [Serial Port Configuration](../peripherals/serial_configuration.md), assigning one of the abstract "MAVLink instance" configuration parameters to the desired port.
 We then set other properties of the MAVLink channel using the parameters associated with our selected MAVLink instance, so that they match the requirements of our particular peripheral.
@ -37,8 +37,10 @@ The number in the name means nothing; you can assign any instance to any port.
  - _OSD_: Standard set of messages for an OSD system.
  - _Config_: Standard set of messages and rate configuration for a fast link (e.g. USB).
  - _Minimal_: Minimal set of messages for use with a GCS connected on a high latency link.
-  - _ExtVision_ or _ExtVisionMin_: Messages for offboard vision systems (ExtVision needed for VIO).
-  - _Iridium_: Messages for an [Iridium satellite communication system](../advanced_features/satcom_roadblock.md).
+  - _External Vision_: Messages for offboard vision systems.
+  - _Gimbal_: Messages for a gimbal. Note this also enables [message forwarding](#MAV_X_FORWARD)
+  - _Onboard Low Bandwidth_: Standard set of messages for a companion computer connected on a lower speed link.
+  - _uAvionix_: Messages for a uAvionix ADS-B beacon.

  ::: info
  If you need to find the specific set of message for each mode search for `MAVLINK_MODE_` in [/src/modules/mavlink/mavlink_main.cpp](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/mavlink/mavlink_main.cpp).
@ -68,9 +70,7 @@ You will need to reboot PX4 to make the parameter available (i.e. in QGroundCont
 The parameter used will depend on the [assigned serial port](../advanced_config/parameter_reference.md#serial) - for example: `SER_GPS1_BAUD`, `SER_TEL2_BAUD`, etc.
 사용하는 값은 연결 유형과 연결된 MAVLink 주변 장치에 따라 달라집니다.

-<a id="default_ports"></a>
-
-## 기본 MAVLink 포트
+## Default MAVLink Ports {#default_ports}

 ### TELEM1

@ -112,8 +112,16 @@ On this hardware, there is a [default serial port mapping](../peripherals/serial

 For more information see: [PX4 Ethernet Setup](../advanced_config/ethernet_setup.md)

+## Device Specific Setup
+
+Links to setup instructions for specific MAVLink components:
+
+- [MAVLink Cameras (Camera Protocol v2) > PX4 Configuration](../camera/mavlink_v2_camera.md#px4-configuration)
+- [Gimbal Configuration > MAVLink Gimbal (MNT_MODE_OUT=MAVLINK)](../advanced/gimbal_control.md#mavlink-gimbal-mnt-mode-out-mavlink)
+
 ## See Also

 - [Serial Port Configuration](../peripherals/serial_configuration.md)
 - [PX4 Ethernet Setup > PX4 MAVLink Serial Port Configuration](../advanced_config/ethernet_setup.md#px4-mavlink-serial-port-configuration)
 - [Serial Port Mapping](../hardware/serial_port_mapping.md)
+
--- a/docs/ko/telemetry/index.md
+++ b/docs/ko/telemetry/index.md
@ -10,13 +10,14 @@ PX4는 다양한 텔레메트리 라디오 타입을 지원합니다:
  - <del>_HKPilot Telemetry Radio_</del> (Discontinued)
  - <del>_3DR Telemetry Radio_</del> (Discontinued)
 - [Telemetry Wifi](../telemetry/telemetry_wifi.md)
+- [J.Fi Wireless Telemetry Module](../telemetry/jfi_telemetry.md)
 - [Microhard Serial Telemetry Radio](../telemetry/microhard_serial.md)
  - [ARK Electron Microhard Serial Telemetry Radio](../telemetry/ark_microhard_serial.md)
  - [Holybro Microhard P900 Telemetry Radio](../telemetry/holybro_microhard_p900_radio.md)
 - CUAV Serial Telemetry Radio
  - [CUAV P8 Telemetry Radio](../telemetry/cuav_p8_radio.md)
 - XBee Serial Telemetry Radio
-  - [HolyBro XBP9X Telemetry Radio](../telemetry/holybro_xbp9x_radio.md) (Discontinued)
+  - <del>[HolyBro XBP9X Telemetry Radio](../telemetry/holybro_xbp9x_radio.md)</del> (Discontinued)

 PX4 is protocol compatible with [SiK Radio](../telemetry/sik_radio.md) and will generally work out of the box (though you may need to change/use an appropriate connector).

--- a/docs/ko/telemetry/jfi_telemetry.md
+++ b/docs/ko/telemetry/jfi_telemetry.md
@ -0,0 +1,134 @@
+# J.Fi Wireless Telemetry Module
+
+The J.MARPLE [J.Fi telemetry module](https://jmarple.ai/j-fi/) is a compact and lightweight wireless communication device featuring a PCB-integrated antenna or external antenna, enabling seamless telemetry connections between various drone flight controllers (FC) and ground control stations.
+
+This module includes a Pixhawk-standard JST 6-pin `TELEM` connector, ensuring compatibility with all PX4-based flight controllers.
+It supports quick plug-and-play operation to `TELEM1` with default settings, requiring no additional configuration.
+
+The J.Fi telemetry module provides reliable communication up to approximately 500 meters when using a PCB-integrated antenna.
+Operating in the 2.4GHz frequency band, it allows unrestricted global use without regulatory limitations.
+
+![J.Fi Wireless Telemetry Module](../../assets/hardware/telemetry/jmarple/jfi_telemetry_module.png)
+
+## 구매처
+
+- [https://jmarple.ai/j-fi/](https://jmarple.ai/j-fi/)
+
+## 기술 사양
+
+### Wireless Performance
+
+- **Frequency Band:** 2.4GHz
+- **Speed:** Up to 11 Mbps (adjustable)
+- **Range:** Up to 500 meters (varies upon environments)
+- **Payload Capacity:** Up to 1400 bytes
+
+### Network Schemes
+
+- **Supported Topologies:** 1:1, 1:N, N:N
+- **Collision Management:** Time Slot-Based Response Delay
+
+### User-Friendly Features
+
+- **Buttons:** Pairing and Mode Switching
+- **LED Indicators:** Real-time status updates
+- **Configuration:** Web browser-based setup
+- **Micro USB Port for connecting to PC or GCS**
+
+## Broadcast Communication
+
+With default settings enabled, the device automatically broadcasts data to all nearby J.Fi devices.
+Connect your external device or system to the **Broadcast port**.
+No additional setup is required.
+
+![J.Fi Wireless Telemetry Broadcast Communication](../../assets/hardware/telemetry/jmarple/jfi_telemetry_broadcast.png)
+
+## Paired Communication
+
+- Modules must first undergo an initial pairing procedure.
+- Once paired, communication is _restricted to paired J.Fi devices_. Connect your external device or system to the **Pair port.**
+
+![J.Fi Wireless Telemetry Paired Communication](../../assets/hardware/telemetry/jmarple/jfi_telemetry_paired.png)
+
+### 1:1 Pairing
+
+![J.Fi Wireless Telemetry Buttons](../../assets/hardware/telemetry/jmarple/jfi_telemetry_buttons.png)
+
+- On **each device,** press and hold _button A_, then click the _RST button_.
+  Release _button A_ when _LED 1_ blinks.
+  - Both devices will enter pairing mode
+- Choose one module and double-click _button A_
+- On the other module, click _button A_ once
+- On the first module, click _button A_ once again to finish pairing
+  - Pairing complete
+
+### 1:N Pairing
+
+- On **each device,** press and hold _button A_, then click the _RST button_.
+  Release _button A_ when _LED 1_ blinks.
+  - All devices will enter pairing mode
+- **Host module (1):** Double-click _button A_
+- **Client modules (N):** Click _button A_ once on each module to pair
+- **Host module (1):** Click _button A_ again to finish pairing
+  - Pairing complete.
+
+<lite-youtube videoid="CnjhTfvARmw" title="J.Fi Wireless Telemetry Module Pairing Guide"/>
+
+## PX4 Setup
+
+PX4 is plug-and-play with J.Fi if connected to the `TELEM1` port, and should connect without further connection.
+
+If you want to use another port you will need to assign a MAVLink instance to the serial port (see [MAVLink Peripherals (GCS/OSD/Companion)](../peripherals/mavlink_peripherals.md)) (and possibly unassign whatever is currently using the port).
+
+### One-to-one (1:1) Setups
+
+The `TELEM1` port is set to use `57600` as the baud rate by default (and J.Fi is set to match).
+This default baud rate is calibrated for inexpensive low-power telemetry radios.
+While this should be sufficient for 1:1 setups, J.Fi will work with much higher rates (i.e., `115200`).
+
+If you want to change the baud rate:
+
+1. Change [SER_TEL1_BAUD](../advanced_config/parameter_reference.md#SER_TEL1_BAUD) if you're using the `TELEM1` port (see [Serial Port Configuration](../peripherals/serial_configuration.md) for other ports).
+2. Update the baud rate in the [J.Fi Configuration](#j-fi-configuration) to match.
+
+### One-to-many (1:N) Setups
+
+For one-to-many (1:N) setups a higher baud rate is _highly recommended_ to ensure stable data reception.
+All J.Fi devices should be set to the same baud rate (although communication may work even when when devices use different baud rates).
+This should be changed in both PX4 and the J.Fi modules as explained in the previous section.
+
+You will also need to make sure that all vehicles on the MAVLink network are assigned a unique **System ID** ([MAV_SYS_ID](../advanced_config/parameter_reference.md#MAV_SYS_ID)).
+
+![J.Fi Wireless Telemetry Broadcast Communication](../../assets/hardware/telemetry/jmarple/jfi_telemetry_usage.png)
+
+<lite-youtube videoid="tPeJA2gn7Zw" title="Simultaneous Control using J.Fi Wireless Telemetry Module"/>
+
+## QGroundControl Configuration
+
+The J.Fi will connect plug-and-play to **QGroundControl** and automatically connect just like a SiK Radio.
+
+However if you change the baud rate from 57600 you will need to create and use a new link configuration:
+
+1. Disable SiK Radio in QGC (**Application Settings → General → AutoConnect**).
+2. Create a new link configuration:
+  - Go to **Application Settings → Comms Links**.
+  - Click **Add**.
+  - Set **Type** to **Serial**, configure the **Serial Port** and **Baud Rate** to match the J.Fi device.
+3. Select **Connect** to connect with the new configuration.
+
+## J.Fi Configuration
+
+- **Device:** Press and hold _button B_, then click the _RST button_.
+  Release _button B_ when _LED 2_ blinks.
+  - Device enters configuration mode
+- **Smart device:** Connect to Wi-Fi network named `J.Fi-xxxxxx` (x: alphanumeric characters)
+- **Browser:** Go to `192.168.4.1` to open the **configuration page**.
+- **Configuration page:** Adjust settings as needed, then click **Save**
+  - _LED 1_ blinks once upon saving
+
+![J.Fi Wireless Telemetry Broadcast Communication](../../assets/hardware/telemetry/jmarple/jfi_telemetry_config.jpg)
+
+## 추가 정보
+
+- [User Manual](https://docs.google.com/document/d/1NaVwOLuMCuNpd0uxgilXZ_qfHAnsFgBmaPxX9WGY2h4/edit?usp=sharing)
+- [ROS Github](https://github.com/SUV-Lab/J-Fi)