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
+63
View File
@@ -0,0 +1,63 @@
# Підключення RC-приймача до автопілота на базі Linux PX4
This topic shows how to setup a PX4 Linux-based autopilot to connect and use a [supported RC receiver](../getting_started/rc_transmitter_receiver.md) on any serial port.
Для типів RC, крім S.Bus, ви можете просто під'єднати приймач безпосередньо до серійних портів або до USB через USB до TTY серійного кабелю (наприклад, PL2302 USB в Serial TTL)
:::info
For an S.Bus receiver (or encoder - e.g. from Futaba, RadioLink, etc.) you will usually need to connect the receiver and device via a [signal inverter circuit](#signal_inverter_circuit), but otherwise the setup is the same.
:::
Then [Start the PX4 RC Driver](#start_driver) on the device, as shown below.
<a id="start_driver"></a>
## Запуск драйвера
To start the RC driver on a particular UART (e.g. in this case `/dev/ttyS2`):
```sh
rc_input start -d /dev/ttyS2
```
For other driver usage information see: [rc_input](../modules/modules_driver.md#rc-input).
<a id="signal_inverter_circuit"></a>
## Схема інвертування сигналу (лише для S.Bus)
S.Bus is an _inverted_ UART communication signal.
Хоча деякі серійні порти / контролери польоту можуть читати інвертований сигнал UART, більшість вимагає схеми інвертування сигналу між приймачем та серійним портом для деінвертації сигналу.
:::tip
This circuit is also required to read S.Bus remote control signals through the serial port or USB-to-TTY serial converter.
:::
У цьому розділі показано, як створити відповідну схему.
### Необхідні компоненти
- 1x NPN транзистор (наприклад, NPN S9014 TO92)
- 1x 10K резистор
- 1x 1K резистор
:::info
Any type/model of transistor can be used because the current drain is very low.
:::
### Схема Діаграми/Підключення
Підключіть компоненти, як описано нижче (і показано на схемі):
- S.Bus сигнал &rarr; 1K резистор &rarr; база NPN транзистора
- NPN транзистора емітер &rarr; GND
- 3.3VCC &rarr; резистор 10K &rarr; колектор NPN транзистора &rarr; rxd USB-to-TTY
- 5.0VCC &rarr; S.Bus VCC
- GND &rarr; S.Bus GND
![Signal inverter circuit diagram](../../assets/sbus/driver_sbus_signal_inverter_circuit_diagram.png)
На зображенні нижче показано підключення на дошці для макету.
![Signal inverter breadboard](../../assets/sbus/driver_sbus_signal_inverter_breadboard.png)
+51
View File
@@ -0,0 +1,51 @@
# Польоти з використанням систем захоплення руху (VICON, NOKOV, Optitrack)
:::warning
**WORK IN PROGRESS**
This topic shares significant overlap with [External Position Estimation (ROS)](../ros/external_position_estimation.md).
:::
Системи захоплення руху у приміщенні, такі як VICON, NOKOV та Optitrack, можуть бути використані для надання даних про положення та орієнтацію для оцінки стану транспортного засобу або можуть бути використані як основа для аналізу.
Дані з систем захоплення руху можуть бути використані для оновлення локальної оцінки положення PX4 відносно локального початку координат Курс (поворот) з системи захоплення руху також може бути опціонально інтегрований оцінювачем положення.
Pose (position and orientation) data from the motion capture system is sent to the autopilot over MAVLink, using the [ATT_POS_MOCAP](https://mavlink.io/en/messages/common.html#ATT_POS_MOCAP) message. Дивіться розділ нижче про системи координат для норм представлення даних. The [mavros](../ros/mavros_installation.md) ROS-Mavlink interface has a default plugin to send this message. Їх також можна надсилати, використовуючи чистий код на мовах програмування C/C++ та бібліотеки MAVLink.
## Архітектура обчислювальних систем
It is **highly recommended** that you send motion capture data via an **onboard** computer (e.g Raspberry Pi, ODroid, etc.) for reliable communications. Вбудований комп'ютер може бути підключений до комп'ютера руху за допомогою WiFi, що забезпечує надійне, високопропускне з'єднання.
Most standard telemetry links like 3DR/SiK radios are **not** suitable for high-bandwidth motion capture applications.
## Системи координат
У цьому розділі показано, як налаштувати систему з відповідними опорними системами. Існує різноманітні представлення, але ми використовуватимемо два з них: ENU і NED.
- ENU is a ground-fixed frame where **X** axis points East, **Y** points North and **Z** up. The robot/vehicle body frame is **X** towards the front, **Z** up and **Y** towards the left.
- NED has **X** towards North, **Y** East and **Z** down. The robot/vehicle body frame has **X** towards the front, **Z** down and **Y** accordingly.
На зображенні нижче показані системи координат. NED ліворуч, ENU праворуч:
![Reference frames](../../assets/lpe/ref_frames.png)
With the external heading estimation, however, magnetic North is ignored and faked with a vector corresponding to world _x_ axis (which can be placed freely at mocap calibration); yaw angle will be given respect to local _x_.
:::warning
When creating the rigid body in the motion capture software, remember to first align the robot with the world **X** axis otherwise yaw estimation will have an initial offset.
:::
## Оціночники стану
EKF2 рекомендується для систем з GPS (LPE застаріла, тому її більше не підтримується або не підтримується).
Q-Estimator рекомендується, якщо у вас немає GPS, оскільки він працює без магнітометра або барометра.
See [Switching State Estimators](../advanced/switching_state_estimators.md) for more information.
### EKF2
The ROS topic for motion cap `mocap_pose_estimate` for mocap systems and `vision_pose_estimate` for vision.
Check [mavros_extras](http://wiki.ros.org/mavros_extras) for further info.
## Тестування
## Усунення проблем