Move PX4 Guide source into /docs (#24490)

* Add vitepress tree

* Update existing workflows so they dont trigger on changes in the docs path

* Add nojekyll, package.json, LICENCE etc

* Add crowdin docs upload/download scripts

* Add docs flaw checker workflows

* Used docs prefix for docs workflows

* Crowdin obvious fixes

* ci: docs move to self hosted runner

runs on a beefy server for faster builds

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: don't run build action for docs or ci changes

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: update runners

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* Add docs/en

* Add docs assets and scripts

* Fix up editlinks to point to PX4 sources

* Download just the translations that are supported

* Add translation sources for zh, uk, ko

* Update latest tranlsation and uorb graphs

* update vitepress to latest

---------

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
Co-authored-by: Ramon Roche <mrpollo@gmail.com>
This commit is contained in:
Hamish Willee
2025-03-13 16:08:27 +11:00
committed by GitHub
co-authored by Ramon Roche
parent 8e6d2ebe4a
commit 88d623bedb
5176 changed files with 558771 additions and 2 deletions
+13
View File
@@ -0,0 +1,13 @@
# Посилання даних
Даними посиланнями є радіоканали, які використовуються для передачі телеметрії транспортного засобу (положення, швидкість, стан батареї та інше) з автопілота на наземні контрольні станції (і деякі радіокеровані системи), а також команди від наземних станцій до транспортного засобу.
Зазвичай для цих зв'язків використовуються інші радіо, ніж ті, що використовуються для ручного радіокерування транспортним засобом.
PX4 використовує [MAVLink](https://mavlink.io/en/) протокол MAVLink для передачі серійних даних через радіоканал.
У цьому розділі наведено інформацію про різні радіосистеми, які можна використовувати, та про те, як налаштувати їх для використання з PX4.
- [Телеметрія MAVLink (OSD/GCS)](../peripherals/mavlink_peripherals.md) — Налаштування виходів автопілота для телеметрії
- [Радіо телеметрії](../telemetry/README.md) - Популярні протоколи і радіосистеми для посилань на каналів передачі даних
- [Телеметрія FrSky Telemetry](../peripherals/frsky_telemetry.md) - Телеметрия на вашому (FRSky) RC Receiver
- [TBS Crossfire (Телеметрія CRSF)](../telemetry/crsf_telemetry.md) - Телеметрика на вашому (TBS Crossfire) RC Receiver
- [Супутниковий зв’язок (Iridium/RockBlock)](../advanced_features/satcom_roadblock.md) — Зв’язок із високою затримкою через супутник
+92
View File
@@ -0,0 +1,92 @@
# Радіоінтеграція SiK
[SiK radio](https://github.com/LorenzMeier/SiK) is a collection of firmware and tools for telemetry radios.
Information about _using_ SiK Radio can be found in [Peripheral Hardware > Telemetry > SiK Radio](../telemetry/sik_radio.md)
Наведена нижче інформація ("розробник") пояснює, як створити мікропрограму SiK із джерела та налаштувати її за допомогою AT-команд.
## Підтримуване радіообладнання
Репозиторій SiK містить завантажувачі та мікропрограми для наступних радіостанцій телеметрії (2020-02-25):
- HopeRF HM-TRP
- HopeRF RF50-DEMO
- RFD900
- RFD900a
- RFD900p
- RFD900pe
- RFD900u
- RFD900ue
:::info
The SiK repository does not currently firmware for RFD900x or RFD900ux telemetry radios.
Щоб оновити мікропрограму на цих радіостанціях (наприклад, щоб підтримувати MAVLink v2.0), пропонується такий процес:
1. Download the appropriate firmware from the [RFDesign website](https://files.rfdesign.com.au/firmware/).
2. On a Windows PC, download and install [RFD Modem Tools](https://files.rfdesign.com.au/tools/).
3. Використовуйте графічний інтерфейс RFD Modem Tools, щоб завантажити мікропрограму на телеметричну радіостанцію RFD900x або RFD900ux.
:::
## Інструкції з установки
Вам потрібно буде інсталювати потрібний компілятор 8051, оскільки він не включений у стандартний інструментарій збірки PX4.
### Mac OS
Встановити ланцюжок інструментів:
```sh
brew install sdcc
```
Створіть образ для стандартного SiK Radio / 3DR Radio:
```sh
git clone https://github.com/LorenzMeier/SiK.git
cd SiK/Firmware
make install
```
Upload it to the radio \(**change the serial port name**\):
```
tools/uploader.py --port /dev/tty.usbserial-CHANGETHIS dst/radio~hm_trp.ihx
```
## Інструкції з налаштування
Радіо підтримує AT-команди для налаштування.
```sh
screen /dev/tty.usbserial-CHANGETHIS 57600 8N1
```
Після цього почніть командний режим:
:::info
DO NOT TYPE ANYTHING ONE SECOND BEFORE AND AFTER
:::
```sh
+++
```
Перелічіть поточні налаштування:
```sh
ATI5
```
Потім встановіть net ID, запишіть налаштування та перезавантажте радіо:
```sh
ATS3=55
AT&W
ATZ
```
:::info
You might have to power-cycle the radio to connect it to the 2nd radio.
:::
+18
View File
@@ -0,0 +1,18 @@
# Інтеграція радіо/модему телеметрії
Telemetry Radios can (optionally) be used to provide a wireless MAVLink connection between a ground control station like _QGroundControl_ and a vehicle running PX4.
Цей розділ містить теми про розширене використання підтримуваних радіомодулів і інтеграцію нових телеметрічних систем в PX4.
:::tip
[Peripheral Hardware > Telemetry Radios](../telemetry/index.md) contains information about telemetry radio systems already supported by PX4.
This includes radios that use the _SiK Radio_ firmware and _3DR WiFi Telemetry Radios_.
:::
## Інтеграція телеметричних систем
PX4 дозволяє використовувати телеметрію на основі протоколу MAVLink через телеметрійний порт контролера польоту на основі Pixhawk.
При умові, що телеметрійне радіо підтримує MAVLink та надає інтерфейс UART з сумісними рівнями напруги/роз'ємом, подальша інтеграція не потрібна.
Телеметрійні системи, що використовують інший протокол, потребують більш глибокої інтеграції, можливо, як програмного (наприклад, драйвери пристрою), так і апаратного (роз'єми тощо).
While this has been done for specific cases (e.g. [FrSky Telemetry](../peripherals/frsky_telemetry.md) enables sending vehicle status to an RC controller via an FrSky receiver) providing general advice is difficult.
We recommend you start by [discussing with the development team](../contribute/support.md).