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
+19
View File
@@ -0,0 +1,19 @@
# 3DR WiFi телеметрія (Припинено)
:::info
This product is no longer manufactured or available from 3DR.
:::
The _3DR WiFi Telemetry Radio_ is supported by PX4.
Simply connect it to the flight controller's `TELEM1` port to create a WiFi "hotspot" for the vehicle with the details below:
```sh
essid: APM_PIX
password: 12345678
```
Під'єднайте вашу наземну станцію керування до вищезазначеного WiFi SSID.
After connecting the vehicle should automatically be detected and connect to _QGroundControl_.
![3DR Wifi Telemetry Radio 1](../../assets/hardware/telemetry/3dr_telemetry_wifi_1.jpg)
![3DR Wifi Telemetry Radio 2](../../assets/hardware/telemetry/3dr_telemetry_wifi_2.jpg)
+74
View File
@@ -0,0 +1,74 @@
# ARK Electron Microhard Серійне Телеметрійне Радіо
_ARK Electron Microhard Serial Telemetry Radios_ integrate the [Microhard Pico Serial](http://microhardcorp.com/P900.php) P900 RF module.
Це може бути використано для активації комунікації MAVLink між радіо на транспортному засобі та GCS.
Радіостанції Microhard Pico Serial - це радіостанції з вихідною потужністю (до) 1 Вт, які підтримують режими точка-точка, точка-багато точок та мережеві режими.
Радіопристрої Microhard Pico також можуть бути замовлені з шифруванням AES-256.
Приблизний діапазон з вихідною потужністю, встановленою на рівні 1 Вт, становить 8 км (5 миль), коли використовуються налаштування за замовчуванням.
Одне радіо земної станції може бути використано для зв'язку з кількома транспортними засобами за допомогою точка-багатоточної або мережевої топології меш.
Транспортні засоби повинні мати різні ідентифікатори MAVLINK.
![Microhard Radio](../../assets/hardware/telemetry/ark_microhard_serial.jpg)
## Де купити
- [1W 900MHz Serial Telemetry Radio](https://arkelectron.com/product/1w-900mhz-serial-telemetry-air-radio/) (vehicle)
- [1W 900MHz USB Serial Telemetry Radio](https://arkelectron.com/product/1w-900mhz-serial-telemetry-ground-radio/) (ground station)
- [1W 2.4GHz Serial Telemetry Radio](https://arkelectron.com/product/1w-2400mhz-serial-telemetry-radio/) (vehicle)
- [1W 2.4GHz USB Serial Telemetry Radio](https://arkelectron.com/product/1w-2400mhz-usb-serial-telemetry-radio/) (ground station)
## З'єднання
### Транспортний радіопередавач
Connect the vehicle radio to the flight controller `TELEM1` port.
Для цієї мети надається кабель телеметрії з 6 контактами JST GH стандарту Pixhawk.
Радіо може бути живлений за допомогою телеметричного кабелю, якщо вихідна потужність встановлена менше 100 мВт.
Для вищих рівнів виводу радіо повинно бути окремо живлене через 2-контактний роз'єм Molex Nano-Fit (тобто від батареї).
![Microhard Radio on Vehicle](../../assets/hardware/telemetry/microhard_serial_on_vehicle.jpg)
### Радіо наземної станції
Підключіть земельне радіо до земельної станції за допомогою USB C.
Радіо не потребує окремого живлення при використанні USB PD (може бути постачана потужність 1 Вт).
## Налаштування/Конфігурація
Радіостанції налаштовані за замовчуванням на використання режиму peer-to-peer та швидкість передачі 57600 бод.
This allows them to connect to the PX4 `TELEM1` port and _QGroundControl_ **without any further configuration**.
:::info
You can use a different baud rate, mode or flight controller port.
Єдине "вимога" - земний радіопередавач, повітряний радіопередавач, PX4 та QGroundControl повинні мати однакову швидкість передачі даних.
:::
[Microhard Serial Telemetry Radios > Configuration](../telemetry/microhard_serial.md#configuration) explains how to configure the radios, _QGroundControl_, and PX4.
The ARK Electron radios must be connected to the computer running the _PicoConfig_ configuration tool as described below:
- For vehicle radio configuration you will have to connect an FTDI adapter between the radio's 3 pin JST-GH Config port and a Windows PC running _Pico Config_ (the radio must be powered, which you can do from battery or the data connection to the flight-controller's `TELEM1` port).
![Ark Microhard Serial - Ports](../../assets/hardware/telemetry/ark_microhard_serial_ports.jpg)
_Pico Config_ will automatically detect the radio.
Налаштуйте швидкість передачі даних (бод-швидкість) так, щоб вона відповідала PX4 (і радіо земної станції).
- З'єднання USB C радіостанції наземної станції може бути використане для налаштування радіо (а також для телеметричних даних).
_Pico Config_ will automatically detect and connect to the configuration port.
Налаштуйте параметри так, щоб швидкість передачі даних відповідала PX4.
Як тільки радіостанції та PX4 будуть налаштовані на використання одного темпу передачі, ви зможете підключити QGroundControl до транспортного засобу через радіо.
### Конфігурація за замовчуванням
The default radio configuration as shipped is shown in _PicoConfig_ below.
![Pico Config](../../assets/hardware/telemetry/pico_configurator.png)
## Подальша інформація
- [Pico Config 1.7](https://arkelectron.com/wp-content/uploads/2021/04/PicoConfig-1.7.zip) - Radio configuration tool
+222
View File
@@ -0,0 +1,222 @@
# Телеметрія CRSF (TBS Crossfire Telemetry)
CRSF is a telemetry protocol that can be used for both [RC control](../getting_started/rc_transmitter_receiver.md) and to get telemetry information from the vehicle/flight controller on a compatible RC transmitter.
The protocol was developed by [Team BlackSheep](https://www.team-blacksheep.com/) for their Crossfire RC system, but is also used by [ExpressLRS (ELRS)](https://www.expresslrs.org/) RC systems.
Це бідирекціональний протокол, який потребує лише одного UART для обміну даними як з RC, так і з телеметрією.
The [supported telemetry messages are listed here](#telemetry-messages), and include: flight mode, battery level, GPS data RC signal strength, speed, altitude, and so on.
:::info
If you don't need telemetry you can connect a TBS Crossfire to the `RCIN` port and configure the receiver to use S.BUS.
Crossfire radio systems can also be used as [Telemetry Radios](../telemetry/index.md).
:::
:::warning
PX4 does not include the CRSF protocol support by default.
The [instructions below](#px4-configuration) explain how to build and upload custom PX4 firmware that includes the required modules.
:::
## Налаштування системи радіо
To use CRSF telemetry you will need a [TBS Crossfire radio system](#tbs-radio-systems) or [ExpressLRS radio system](#expresslrs-radio-systems) that includes an [RC controller](#rc-controllers) with a transmitter, and a receiver (from the same vendor).
:::info
An RC radio system historically consisted of a ground-based controller that transmitted to an on-vehicle receiver.
Навіть якщо багато радіосистем зараз є двосторонніми, земельний модуль все ще може називатися передавачем, а повітряний блок може називатися приймачем.
:::
Generally you will need to separately setup and configure the transmitter and receiver, and then _bind_ them together.
A transmitter might come as an integral part of an [RC controller](#rc-controllers), or it might be a separate module that you plug into a controller.
Якщо це окремий модуль, то вам може знадобитися також оновити програмне забезпечення модуля на передавачі на прошивку, яка підтримує CRSF, таку як OpenTX або EdgeTx.
У обох випадках вам потрібно налаштувати передавач для активації CRSF.
The receiver must be [wired](#wiring) to a spare port (UART) on the Flight Controller.
Then you can _bind_ the transmitter and receiver together.
Інструкції для вищезазначених кроків описані в
- [TBS Crossfire Manual](https://www.team-blacksheep.com/tbs-crossfire-manual.pdf)
- [Express LRS: QuickStart](https://www.expresslrs.org/quick-start/getting-started/)
### Підключення
TX і RX на обраному екрані контролю польоту потрібно підключитися до окремих каналів на приймачі.
Сигнал зазвичай є неінвертованим і може бути підключений безпосередньо (в кабелі не потрібна додаткова логіка інвертора).
Вам слід перевірити посібник для вашого конкретного приймача, однак!
#### Проводка приймача TBS
Для приймачів TBS ви підключаєте UART і приймач FC, як показано (це передбачає TBS Nano RX).
| FC UART | Nano RX |
| ------- | ------- |
| TX | Ch2 |
| RX | Ch1 |
#### Проводка приймача ExpressLRS
For ExpressLRS receivers wire to the flight controller UART as shown below (wiring is covered [in detail here](https://www.expresslrs.org/quick-start/receivers/wiring-up/)):
| FC UART | ExpressLRS |
| ------- | ---------- |
| TX | RX |
| RX | TX |
| VCC | VCC |
| GND | GND |
## Конфігурація PX4
### Конфігурація прошивки/збірка
Підтримка телеметрії CRSF не включена в жодне ПЗ PX4 за замовчуванням.
To use this feature you must build and upload custom firmware that includes [crsf-rc](../modules/modules_driver.md#crsf-rc) and removes [rc_input](../modules/modules_driver.md#rc-input).
Кроки наступні:
1. [Setup a development environment](../dev_setup/dev_env.md) for building PX4.
As part of this process you will have used `git` to fetch source code into the **PX4-Autopilot** directory.
2. Open a terminal and `cd` into the `PX4-Autopilot` directory.
```sh
cd PX4-Autopilot
```
3. Launch the [PX4 board config tool (`menuconfig`)](../hardware/porting_guide_config.md#px4-menuconfig-setup) for your `make` target using the `boardconfig` option (here the target is the [ARK Electronics ARKV6X](../flight_controller/ark_v6x.md) flight controller):
```sh
make ark_fmu-v6x_default boardconfig
```
4. У інструменті конфігурації плати PX4:
- Disable the default `rc_input` module
1. Navigate to the `drivers` submenu, then scroll down to highlight `rc_input`.
2. Use the enter key to remove the `*` from `rc_input` checkbox.
- Enable the `crsf_rc` module
1. Scroll to highlight the `RC` submenu, then press enter to open it.
2. Scroll to highlight `crsf_rc` and press enter to enable it.
Збережіть і вийдіть з інструменту конфігурації плати PX4.
5. [Build the PX4 source code](../dev_setup/building_px4.md) with your changes (again assuming you are using ARKV6X):
```sh
make ark_fmu-v6x_default
```
Це побудує вашу власну прошивку, яку зараз потрібно завантажити на ваш контролер польоту.
### Завантаження прошивки
Щоб завантажити кастомну прошивку, спочатку підключіть ваш контролер польотів до комп’ютера розробки через USB.
You can upload firmware as part of the build process using the `upload` options:
```sh
make ark_fmu-v6x_default upload
```
Alternatively you can use QGroundControl to install the firmware, as described in [Firmware > Installing PX4 master, beta, or custom firmware](../config/firmware.md#installing-px4-main-beta-or-custom-firmware).
### Налаштування параметрів
[Find and set](../advanced_config/parameters.md) the following parameters:
1. [RC_CRSF_PRT_CFG](../advanced_config/parameter_reference.md#RC_CRSF_PRT_CFG) — Set to the port that is connected to the CRSF receiver (such as `TELEM1`).
This [configures the serial port](../peripherals/serial_configuration.md) to use the CRSF protocol.
Note that some serial ports may already have a [default serial port mapping](../peripherals/serial_configuration.md#default-serial-port-configuration) or [default MAVLink serial port mapping](../peripherals/mavlink_peripherals.md#default-mavlink-ports) that you will have to un-map before you can assign the port to CRSF.
For example, if you want to use `TELEM1` or `TELEM2` you first need to modify [MAV_0_CONFIG](../advanced_config/parameter_reference.md#MAV_0_CONFIG) or [MAV_1_CONFIG](../advanced_config/parameter_reference.md#MAV_1_CONFIG) to stop setting those ports.
Немає потреби встановлювати швидкість передачі для порту, оскільки це налаштовано драйвером.
2. [RC_CRSF_TEL_EN](../advanced_config/parameter_reference.md#RC_CRSF_TEL_EN) — Enable to activate Crossfire telemetry.
### Налаштування радіо
[Radio Control Setup](../config/radio.md) explains how to map your RC controller's attitude control sticks (roll, pitch, yaw, throttle) to channels, and to calibrate the minimum, maximum, trim and reverse settings for all other transmitter controls/RC channels.
## Контролери RC
Трансмітер може бути неот'ємною частиною керування RC, або це може бути окремий модуль, який ви вставляєте в контролер.
RC Контролери, які підтримують модулі TX TBS Crossfire та ExpressLRS:
- [FrSky Taranis X9D Plus](https://www.frsky-rc.com/product/taranis-x9d-plus-2/) has an external module bay that can be used with TBS or ExpressLRS transmitter modules that are "JR module bay" compatible.
Вам потрібно буде встановити програмне забезпечення OpenTX, яке підтримує CRSF, та увімкнути зовнішній модуль та CRSF.
- [Radiomaster TX16S](https://www.radiomasterrc.com/collections/tx16s-mkii) has an internal ExpressLRS transmitter module.
Він також має зовнішній модульний бей, який може бути використаний з передавальними модулями TBS або ExpressLRS, які сумісні з "JR module bay".
Він працює як на програмному забезпеченні OpenTX, так і на програмному забезпеченні EdgeTx, кожне з яких може підтримувати CRSF.
## Радіосистеми TBS
[TBS Crossfire Radio Systems are listed here](https://www.team-blacksheep.com/shop/cat:cat_crossfire#product_listing).
Нижче наведено кілька опцій «turnkey».
Модулі передавача:
- [TBS CROSSFIRE TX - LONG RANGE R/C TRANSMITTER](https://www.team-blacksheep.com/products/prod:crossfire_tx)
Приймачі:
- [TBS Crossfire Nano RX](http://team-blacksheep.com/products/prod:crossfire_nano_rx) - designed for small quadcopters.
## Системи радіо ExpressLRS
Express LRS provide Radio System guidance in the [Hardware Selection](https://www.expresslrs.org/hardware/hardware-selection/) page.
Нижче наведено кілька перевірених варіантів.
Модулі передавача:
- Уточнюється
Приймачі:
- [ExpressLRS Matek Diversity RX](http://www.mateksys.com/?portfolio=elrs-r24).
::: info
This is used in the [Reptile Dragon 2 Build Log](../frames_plane/reptile_dragon_2.md).
See sections [ELRS Rx](../frames_plane/reptile_dragon_2.md#elrs-rx) and [Radio Setup](../frames_plane/reptile_dragon_2.md#radio-setup).
:::
## Телеметричні повідомлення
The supported telemetry messages and their source are listed below (this table is reproduced from the [TBS Crossfire Manual: "Available sensors with OpenTX"](https://www.team-blacksheep.com/tbs-crossfire-manual.pdf)).
| Datapoint | Опис | Джерела даних |
| --------- | ----------------------------------------------------------------- | -------------------------------- |
| 1RSS | Uplink - отримана сила сигналу антени 1 (RSSI) | TBS CROSSFIRE RX |
| 2RSS | Uplink - отримана сила сигналу антени 2 (RSSI) | TBS CROSSFIRE RX |
| RQly | Uplink - якість посилання (дійсні пакети) | TBS CROSSFIRE RX |
| RSNR | Uplink - відношення сигнал/шум | TBS CROSSFIRE RX |
| RFMD | Uplink - частота оновлення, 0 = 4Гц, 1 = 50Гц, 2 = 150Гц | TBS CROSSFIRE RX |
| TPWR | Uplink - потужність передачі | TBS CROSSFIRE TX |
| TRSS | Downlink - сила сигналу антени | TBS CROSSFIRE TX |
| TQly | Downlink - якість посилання (дійсні пакети) | TBS CROSSFIRE TX |
| TSNR | Downlink - відношення сигнал/шум | TBS CROSSFIRE TX |
| ANT | Датчик лише для налагодження | TBS CROSSFIRE TX |
| GPS | GPS координати | TBS GPS / FC |
| Alt | GPS Висоти | TBS GPS / FC |
| Sats | Супутники GPS отримано | TBS GPS / FC |
| Hdg | Магнітна орієнтація | TBS GPS / FC |
| RXBt | Напруга батареї | TBS GPS / FC/ CROSSFIRE RX/ CORE |
| Curr | Поточне витягування | TBS GPS / FC// CORE |
| Capa | Поточне споживання | TBS GPS / FC/ CORE |
| Ptch | Кут нахилу поля FC | FC |
| Roll | Кут кочення FC | FC |
| Yaw | Кут курсу FC | FC |
| FM | Режим польоту | FC |
| VSPD | Барометр | FC |
## Дивіться також
- [TBS Crossfire Manual](https://www.team-blacksheep.com/tbs-crossfire-manual.pdf)
- [ExpressLRS Documentation](https://www.expresslrs.org/quick-start/getting-started/)
- [FrSky Telemetry](../peripherals/frsky_telemetry.md)
- [Radio Control Setup](../config/radio.md)
- [Radio Control Systems](../getting_started/rc_transmitter_receiver.md)
+66
View File
@@ -0,0 +1,66 @@
# CUAV P8 Телеметрійне радіо
CUAV P8 Radio is a long range (>60km) and high data rate (375 Kbps) remote data transmission module for drones that works plug-and-play with PX4.
Він підтримує кілька режимів, таких як точка-точка, точка-багатоточка та релеєве спілкування.
![CUAV P8 Radio](../../assets/hardware/telemetry/cuav_p8_hero.png)
## Основні характеристики
- Long range: >60km (depending on the antenna and environment, up to 100 km).
- Підтримує режими точка-точка, точка-багатоточка та ретранслятор.
- До 2 Вт потужності (фіксована частота 2 Вт; стробування частотою 1 Вт)
- До 345 Кбіт / с швидкість передачі.
- Підтримує 12v~60V операційну напругу.
- Одиниця може працювати або як наземний модем станції, або як модем літака.
- Незалежне енергопостачання для більш стабільної операції
- USB порт Type-C, інтегрований USB до конвертера UART
## Де купити
- [CUAV store](https://www.cuav.net/en/p8-2/)
- [CUAV alibaba](https://www.alibaba.com/product-detail/Free-shipping-CUAV-UAV-P8-Radio_1600324379418.html?spm=a2747.manage.0.0.2dca71d2bY4B0M)
## Конфігурація PX4
CUAV P8 радіо є попередньо налаштованим (швидкість 57600, режим трансляції) для використання з PX4.
It should require no additional setup if connected to `TELEM1` OR `TELEM2`.
On some flight controllers, or if used with a different serial port, you may need to [configure the port for MAVLink communication](../peripherals/mavlink_peripherals.md).
:::tip
[P8 Configuration](https://doc.cuav.net/data-transmission/p8-radio/en/config.html) provides full information about radio configuration, if required.
:::
## Схема розташування виводів
![P8 pinouts](../../assets/hardware/telemetry/cuav_p8_pinouts.png)
### Порт даних
| pin | C-RTK GPS 6P | pin | Pixhawk стандартні контакти |
| --- | -------------------------- | --- | --------------------------- |
| 1 | 5V+(NC) | 1 | VCC |
| 2 | RX | 2 | TX |
| 3 | TX | 3 | RX |
| 4 | RTS | 4 | RTS |
| 5 | CTS | 5 | CTS |
| 6 | GND | 6 | GND |
## Підключення
![P8 wiring](../../assets/hardware/telemetry/cuav_p8_connect.png)
Connect the CUAV P8 Radio to the `TELEM1`/`TELEM2` interface of the flight controller and use a battery or BEC to power the module.
Необхідні кабелі включені в комплект.
:::tip
CUAV P8 Radio does not support power supply from the flight controller, it needs to be connected to a 12~60v battery or BEC.
:::
## Докладніше
[P8 manual](http://manual.cuav.net/data-transmission/p8-radio/p8-user-manual-en.pdf)
[CUAV P8 Radio](https://doc.cuav.net/data-transmission/p8-radio/en/) (Official Guide)
+165
View File
@@ -0,0 +1,165 @@
# Модуль WiFi ESP32
## Загальний огляд
ESP32 є легкодоступними модулями WiFi з присвяченими інтерфейсами UART, SPI та I2C, повним стеком TCP/IP та можливістю мікроконтролера.
They usually come without firmware, but _DroneBridge for ESP32_ can be installed to enable them as a transparent and bi-directional serial to WiFi bridge.
This allows them to be used as a [WiFi telemetry](../telemetry/telemetry_wifi.md) module with any Pixhawk series controller.
They can alternatively be used in a special ESP-NOW Mode that enables ranges of up to 1km+, albeit at lower data rates.
The typical range depends on the antenna and environment:
- WiFi-Modes: ~50m-200m
- ESP-NOW Modes: 300m-1km+
### WiFi Network
_DroneBridge for ESP32_ supports standard WiFi connections to an access point but can also operate as a standalone access point.
![DroneBridge for ESP32 connection concept using WiFi](../../assets/peripherals/telemetry/esp32/db_esp32_setup.png)
### ESP-NOW Network
The ESP-NOW mode offers a connectionless and encrypted alternative to traditional WiFi.
While the data rate is reduced to < 250 kbit/s the range is increased up to 1 km.
This mode has no limit on how many autopilot clients are connected.
Only channel capacity and processing capacity limit the number of clients.
![DroneBridge for ESP32 connection concept for ESP-NOW modes](../../assets/peripherals/telemetry/esp32/db_esp32_now_illustration.png)
:::info
ESP-NOW requires ESP32 devices on the GCS side as well as on the autopilot side.
:::
## Функції
- Bidirectional: serial-to-WiFi, serial-to-WiFi Long-Range (LR), serial-to-ESP-NOW link
- Support for MAVLink, MSP, LTM or any other payload using transparent option
- Affordable, Reliable & low latency
- Weight: < 8g
- Up to 150m range using standard WiFi
- Up to 1km of range using ESP-NOW or Wi-Fi LR Mode - sender & receiver must be ESP32 with LR-Mode enabled
- Fully encrypted in all modes including ESP-NOW broadcasts secured using AES-GCM 256 bit!
- Support for drone swarms of almost any size using ESP-NOW with its custom & encrypted broadcast mode
- Supported by: QGroundControl, Mission Planner, mwptools, impload etc.
- Easy to set up: Power connection + UART connection to flight controller
- Fully configurable through an easy-to-use web interface
- Parsing of LTM & MSPv2 for more reliable connection and less packet loss
- Parsing of MAVLink with the injection of radio status packets for the display of RSSI in the GCS
- Fully transparent telemetry down-link option
:::info
[You can find all the latest information on the current version of _DroneBridge for ESP32_ on the official website.](https://dronebridge.github.io/ESP32/)
:::
## Рекомендоване обладнання
_DroneBridge for ESP32_ can run on almost all ESP32 development boards.
Boards and modules with an external antenna connector are recommended since these will offer more range.
:::warning
Some ESP32 modules support 3.3V power supply input, while many flight controllers output at 5V (e.g. Pixhawk 4).
Вам потрібно буде перевірити сумісність та знизити напругу, якщо це потрібно.
:::
:::tip
The _DroneBridge for ESP32_ project recommends using [Officially Supported and Tested Boards](https://dronebridge.github.io/ESP32/).
These are small, low in price, have Pixhawk-standard port for connecting to Pixhawk flight controllers, and come with _DroneBridge for ESP32_ firmware pre-installed.
:::
Other ESP32 Boards that have been tested with versions of _DroneBridge for ESP32_ (but receive no official support):
- [ESP32-C3-DevKitM-1](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c3/esp32-c3-devkitm-1/index.html)
- [ESP32-S3-DevKitC-1](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-devkitc-1/index.html)
- [NodeMCU ESP32S](https://www.waveshare.com/nodemcu-32s.htm)
## Installing/Updating the Firmware
An [easy-to-use online flashing tool](https://dronebridge.github.io/ESP32/install.html) is available on the official website.
Use a Chrome-based browser, connect your ESP32 via USB to your computer, and click flash!
For more detailed flashing instructions see [DroneBridge for ESP32 > Installation](https://dronebridge.gitbook.io/docs/dronebridge-for-esp32/installation) (DroneBridge Docs).
## Підключення
When using one of the official boards with a Pixhawk flight controller it is as simple as plugging the provided cable from `TELEM1` on the ESP32 to the `TELEM1` or `TELEM2` port on the FC.
For ESP boards that don't have a `TELEM` port you need to manually wire to a serial port on the FC (e.g. `TELEM1` or `TELEM2`).
The diagram below provides an outline of how you would wire up the connections.
![Example for wiring an ESP32 to the TELEM port](../../assets/peripherals/telemetry/esp32/pixhawk_wiring.png)
- Connect UART of ESP32 to a UART of your autopilot (ie. `TELEM1` or `TELEM2` port).
Make sure the voltage levels match!
- RX до TX
- GND до GND
- Stable 3.3V or 5V power supply to the ESP32 (depending on the available inputs of your ESP32 and capabilities of the autopilot)
- Set the autopilot port to MAVLINK 1 or 2 protocol.
::: info
- Follow the ESP32 board manufacturer recommendations on power supply.
Деякі плати можуть мати проблеми, якщо вони одночасно підключені до джерела живлення 5 В та мають підключений кабель USB до USB/серійного мосту (роз'єм USB плати розробника ESP32).
- Деякі виробники ESP32 DevKits використовують неправильні мітки для контактів на своїх продуктах.
Make sure that the PINs on your board are labelled correctly if you encounter issues.
:::
## Configuring PX4
Configure the Flight controller port that is wired to the ESP32 to have MAVLink set as the protocol and to have the same baud rate as the ESP32.
The Pixhawk `TELEM1` and `TELEM2` ports are configured for [MAVLink by default](../peripherals/mavlink_peripherals.md#default-mavlink-ports) but you will still need to set the rates.
For `TELEM1` you might set the values like this:
- `SER_TEL1_BAUD`: 115200 8N1
- `MAV_0_RATE`: 24000 (can be increased optionally)
For more information, and using other ports, see [MAVLink Peripherals](../peripherals/mavlink_peripherals.md) and [Serial Port Configuration](../peripherals/serial_configuration.md)
## Налаштування DroneBridge для ESP32
Once _DroneBridge for ESP32_ is flashed it initially will provide a Wifi access point that you can connect to.
Once connected you can access the configuration page using your browser. The address of the configuration page is `http://dronebridge.local` or `192.168.2.1`.
![DroneBridge for ESP32 Webinterface](../../assets/peripherals/telemetry/esp32/dbesp32_webinterface.png)
The _DroneBridge for ESP32_ default configuration should work for connecting to PX4 "out of the box".
For the Official HW1.x Boards the configuration is: `UART TX Pin: 5`, `UART RX Pin: 4`, `UART RTS Pin: 6`, `UART CTS Pin: 7`
Єдине налаштування, яке може бути потрібним, - це забезпечення відповідності швидкостей передачі ESP32 та контролера польоту.
Вам слід змінити ці налаштування, якщо ви хочете використовувати різні контакти на ESP32, іншу конфігурацію WiFi або налаштувати розмір пакета.
A lower packet size means more overhead and load on the system, less latency, and faster recovery from a lost packet.
### Supported Modes
| **MavLink Index** | **DroneBridge for ESP32 Mode** | **Encryption** | **Description** | **Notes** |
| ----------------- | ------------------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | WiFi Access Point Mode | WPA2 PSK | ESP32 launches classic WiFi access point using 802.11b rates | Any WiFi device can connect |
| 2 | WiFi Client Mode | min. WEP | ESP32 connects to an existing WiFi access point. LR Mode supported | Encryption defined by access point. Multiple drones can connect to one AP and GCS. 802.11b rates |
| 3 | WiFi Access Point Mode LR | WPA2 PSK | ESP32 launches WiFi access point mode using espressifs LR mode | Only ESP32 LR Mode enabled devices can detect and connect to the access point. Data rate is reduced to 0.25Mbit. Range is greatly increased. |
| 4 | ESP-NOW LR Mode AIR | AES256-GCM | ESP32 is able to receive ESP-NOW broadcast packets from any GCS in the area and forwards them to the UART. Broadcasts to all GND stations in the area. | Connectionless protocol. Data rate is reduced to 0.25Mbit. Range is greatly increased compared to WiFi modes. Custom encryption mode for ESP-NOW broadcasts and protocol. |
| 5 | ESP-NOW LR Mode GND | AES256-GCM | ESP32 is able to receive ESP-NOW broadcast packets from any drone in the area and forwards them to the UART. Broadcasts to all AIR stations in the area. | Connectionless protocol. Data rate is reduced to 0.25Mbit. Range greatly increased compared to WiFi modes. Custom encryption mode for ESP-NOW broadcasts and protocol. |
When changing the mode using a GCS and the MavLink parameter protocol instead of the web interface, the `MavLink Index` is the number associated with the parameter `SYS_ESP32_MODE`.
## Configuring the Ground Control Station
QGroundControl should auto-detect the connection and no further actions should be necessary (_DroneBridge for ESP32_ automatically forwards data from all connected WiFi devices via UDP to port 14550).
Доступні наступні параметри модулів:
- UDP unicast on port `14550` to all connected devices.
- TCP on port `5760`
### REST API
DroneBridge for ESP32 offers a REST API that allows you to read and write configuration options.
For more information see: [DroneBridge for ESP32 > Developer & API Documentation](https://dronebridge.gitbook.io/docs/dronebridge-for-esp32/developer-and-api-documentation).
## Усунення проблем
See [Troubleshooting & Help](https://dronebridge.gitbook.io/docs/dronebridge-for-esp32/troubleshooting-help) (DroneBridge Docs).
+173
View File
@@ -0,0 +1,173 @@
# Модуль WiFi ESP8266
ESP8266 та його клони - це недорогі та легко доступні модулі Wi-Fi з повним стеком TCP/IP та можливістю мікроконтролера.
Вони можуть використовуватись з будь-яким контролером Pixhawk.
:::tip
ESP8266 is the _defacto_ default WiFi module for use with [Pixracer](../flight_controller/pixracer.md) (and is usually bundled with it).
:::
## Де купити
Модуль ESP8266 легко доступний від ряду постачальників.
Нижче наведено перелік кількох виконавців.
Більшість модулів підтримують тільки 3.3 V у той час як деякі контролери польоту (наприклад, Pixhawk 4) вивід на 5V (вам потрібно перевірити сумісність і виконати зниження напруги при необхідності).
Модулі, що приймають постачання 3.3V:
- [WRL-17146](https://www.sparkfun.com/products/13678) (Sparkfun)
- [AI Cloud](https://us.gearbest.com/boards-shields/pp_009604906563.html) - discontinued (GearBeast)
Модулі, що приймають постачання 5.3V:
- [AI Thinker](https://www.banggood.com/Wireless-Wifi-to-Uart-Telemetry-Module-With-Antenna-for-Mini-APM-Flight-Controller-p-1065339.html) (Banggood)
- [AlphaUAVLink](https://www.banggood.com/MAVLink-Wifi-Bridge-2_4G-Wireless-Wifi-Telemetry-Module-with-Antenna-for-Pixhawk-APM-Flight-Controller-p-1428590.html) (Banggood)
- [Kahuna](https://www.beyondrobotix.com/products/kahuna?utm_source=px4-esp8266-docs) (Beyond Robotix)
A plug and play ESP8266 module.
The Kahuna comes with a cable to connect directly to the Pixhawk-standard `TELEM1` or `TELEM2` ports.
It is pre-flashed with the latest firmware, and has a u.fl connector for an external antenna.
At most you may need to set the baud rate parameter, which for `TELEM1` is `SER_TEL1_BAUD = 57600 (57600 8N1)`.
The [User Guide](https://docs.google.com/document/d/1VyOsp9_q6dIAdYdWuDFcWoqqrNy_vbFMANubZA3Uz5g/edit?pli=1\&tab=t.0) include WiFi setup and other relevant information.
![Kahuna ESP8266 WiFi Module](../../assets/peripherals/telemetry/esp8266/beyond_robotics_kahuna_esp8266.png)
## Pixhawk/PX4 Setup & Configuration {#px4_config}
:::tip
You _may_ first need to update the radio with PX4-compatible ESP8266 firmware ([see below](#esp8266-flashing-firmware-advanced)).
Інструкції по виготовленню повинні пояснити, чи це потрібно.
:::
Підключіть свій ESP8266 до вашого польотного контролера серії Pixhawk (наприклад, Pixracer) на будь-якому вільному UART.
Підключіть контролер польоту до вашої наземної станції через USB (так як WiFi ще не повністю налаштований).
Використання Від _QGroundControl_:
- [Load recent PX4 firmware onto the flight controller](../config/firmware.md).
- [Configure the serial port](../peripherals/serial_configuration.md) used to connect the ESP8266.
Не забудьте встановити швидкість передачі даних на 921600, щоб відповідати значенню, встановленому для ESP8266.
- [Configure MAVLink](../peripherals/mavlink_peripherals.md) on the corresponding serial port in order to receive telemetry and transmit commands over the ESP8266.
Після того, як ви налаштували послідовний порт керування польотом для підключення до радіо, ви можете від'єднати фізичне USB-підключення між наземною станцією та транспортним засобом.
## Підключення через ESP8266 до QGC
Модуль надає точку доступу WiFi, яку ваш комп'ютер земної станції може використовувати для підключення до літального апарату.
:::info
The settings for the ESP8266 hotspot should be provided with the board (e.g. typically printed on the reverse side of the board or on the packaging).
Типові налаштування заводської мережі:
- **SSID:** PixRacer
- **Password:** pixracer
- **WiFi Channel:** 11
- **UART speed:** 921600
Інші модулі можуть використовувати налаштування, подібні до цього:
- **SSID:** IFFRC_xxxxxxxx
- **Password:** 12345678
- **IP:** 192.168.4.1
- **Port:** 6789 (TCP)
Приклади дошок від AlphaUILink та DOITING показані нижче:
<img src="../../assets/peripherals/telemetry/esp8266/alpha_uavlink_back.jpg" width="250px" alt="AlphaUAVLink - Back"/> <img src="../../assets/peripherals/telemetry/esp8266/alpha_uavlink_front.jpg" width="250px" alt="AlphaUAVLink - Front"/> <img src="../../assets/peripherals/telemetry/esp8266/doiting_eps_12f_back.jpg" width="250px" alt="DOITING EPS 12F - Back"/> <img src="../../assets/peripherals/telemetry/esp8266/doiting_eps_12f_front.jpg" width="250px" alt="DOITING EPS 12F - Front"/>
:::
On your wifi-enabled _QGroundControl_ ground station computer/tablet, find and connect to the open wireless network for your ESP8266.
On a Windows computer the connection settings for a network with name **Pixracer** and default password **pixracer** point will look like this:
![Windows Network Setup: Connection](../../assets/peripherals/pixracer_network_setup_connection_windows.png)
![Windows Network Setup: Security](../../assets/peripherals/pixracer_network_setup_security_windows.png)
_QGroundControl_ will automatically connect to the vehicle when the ground station computer is attached to a WiFi access point named "Pixracer".
Якщо ви використовуєте модуль з будь-яким іншим ім'ям WiFi, вам потрібно вручну налаштувати підключення WiFi QGroundControl, як показано в наступному розділі.
## Налаштувати QGC з нестандартними WiFi підключеннями
_QGroundControl_ will automatically connect to the vehicle when the ground station computer is attached to the "Pixracer" WiFi access point.
Для будь-якого іншого імені точки доступу вам потрібно буде вручну створити спеціальне комунікаційне посилання:
1. Go to [Application Settings > Comm Links](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/settings_view/settings_view.html)
2. Додайте нове підключення з відповідними налаштуваннями.
3. Select the new connection, and click **Connect**.
4. Автомобіль тепер повинен підключатися
## Перевірити
Тепер ви повинні бачити рух HUD на вашому комп'ютері QGC через бездротове з'єднання і мати можливість переглядати панель підсумків для моста WiFi ESP8266 (як показано нижче).
![QGC Summary showing Wifi Bridge](../../assets/qgc/summary/wifi_bridge.png)
:::tip
If you have any problem connecting, see [QGC Usage Problems](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/troubleshooting/qgc_usage.html).
:::
## Прошивка/прошивка ESP8266 (розширений)
Модулі ESP8266 від різних виробників можуть не мати встановленого відповідного прошивкового забезпечення ESP8266 наперед.
Інструкції нижче пояснюють, як налаштувати та запустити тести локально.
### Готові бінарні файли
[MavLink ESP8266 Firmware V 1.2.2](http://www.grubba.com/mavesp8266/firmware-1.2.2.bin)
### Побудувати з Джерел
The [firmware repository](https://github.com/dogmaphobic/mavesp8266) contains instructions and all the tools needed for building and flashing the ESP8266 firmware.
### Оновлення прошивки OTA
If you have firmware 1.0.4 or greater installed, you can do the update using the ESP's _Over The Air Update_ feature.
Just connect to its AP WiFi link and browse to: `http://192.168.4.1/update`.
Потім ви можете вибрати файл прошивки, який ви завантажили вище, та завантажити його на модуль WiFi.
:::tip
This is the easiest way to update firmware!
:::
### Прошивка прошивки ESP8266
Before flashing, make sure you boot the ESP8266 in _Flash Mode_ as described below.
If you cloned the [MavESP8266](https://github.com/dogmaphobic/mavesp8266) repository, you can build and flash the firmware using the provided [PlatformIO](http://platformio.org) tools and environment.
If you downloaded the pre-built firmware above, download the [esptool](https://github.com/espressif/esptool) utility and use the command line below:
```sh
esptool.py --baud 921600 --port /dev/your_serial_port write_flash 0x00000 firmware_xxxxx.bin
```
Де:
- **firmware_xxxxx.bin** is the firmware you downloaded above
- **your_serial_port** is the name of the serial port where the ESP8266 is connected to (`/dev/cu.usbmodem` for example)
### Проводка для Прошивання Програмного Забезпечення
:::warning
Most ESP8266 modules support 3.3 volts (only), while some flight controllers (e.g. Pixhawk 4) output at 5V.
Перевірте сумісність та знизьте напругу, якщо це потрібно.
:::
There are various methods for setting the ESP8266 into _Flash Mode_ but not all USB/UART adapters provide all the necessary pins for automatic mode switching.
In order to boot the ESP8266 in _Flash Mode_, the GPIO-0 pin must be set low (GND) and the CH_PD pin must be set high (VCC).
Ось як виглядає моя власна налаштування:
![esp8266 flashing rig](../../assets/hardware/telemetry/esp8266_flashing_rig.jpg)
Я побудував кабель, де RX, TX, VCC та GND правильно підключені безпосередньо від адаптера FTDI до ESP8266.
З ESP8266 я залишив дві проводи, підключені до GPIO-0 та CH_PD вільними, щоб я міг завантажити його або зазвичай, або в режимі флеш, підключивши їх до GND та VCC відповідно.
#### ESP8266 (ESP-01) Pinout
![esp8266 wifi module pinout](../../assets/hardware/telemetry/esp8266_pinout.jpg)
#### Діаграма миготіння за допомогою адаптера USB/UART FTDI
![esp8266 flashing](../../assets/hardware/telemetry/esp8266_flashing_ftdi.jpg)
@@ -0,0 +1,158 @@
# Holybro Microhard P900 Радіо
The [Holybro Microhard P900 Radio](https://holybro.com/products/microhard-radio) integrates the [Microhard Pico Serial](http://microhardcorp.com/P900.php) P900 RF module, which is capable of delivering high-performance wireless serial communications in robust and secure mesh, point-to-point or point-to-multipoint topologies.
Він дозволяє комунікацію MAVLink між радіо на транспортному засобі та GCS.
Цей радіопередавач працює у діапазоні частот 902-928 МГц ISM, використовуючи технологію розподіленого спектра з переходом по частоті (FHSS), що забезпечує надійний бездротовий асинхронний передачу даних між більшістю типів обладнання, яке використовує послідовний інтерфейс.
Радіопередавач може бути налаштований як основний координатор, вторинний координатор, резервний координатор або віддалений в мережевій топології меш, або як майстер(master,), ретранслятор(repeater) або віддалений в топології точка-точка(PP) або точка-багатоточка (PMP).
Ця універсальність дуже зручна для користувача.
This radio is configured using AT commands through the data port or using _PicoConfig_ application through the diagnosis port.
Потужність передачі програмно вибирається від 100 мВт до 1 Вт, з дальністю до 40 миль.
Одне радіо земної станції може бути використано для зв'язку з кількома транспортними засобами за допомогою точка-багатоточної або мережевої топології меш.
Транспортні засоби повинні мати різні ідентифікатори MAVLINK.
![Holybro Microhard Radio](../../assets/hardware/telemetry/holybro_microhard.jpg)
## Функції
- USB порт Type-C, інтегрований USB до конвертера UART
- 6-position JST-GH connector, can be directly connected to the TELEM port on various Pixhawk-standard flight controllers such [Pixhawk 4](../flight_controller/pixhawk4.md) & [Pixhawk 5X](../flight_controller/pixhawk5x.md)
- Високовольтний BEC на борту, Підтримка живлення напругою DC7~35V
- UART transmission & Three-stage RSSI LED indicator
- Передача в межах громадського, ліцензійно-вільного діапазону радіочастот
- Прозорий, низькій затримкою швидкості зв'язку до 276 Кбіт/с
- Підтримує потужну операцію із справжньою мережею Mesh з автоматичним маршрутизуванням
- 32 біти CRC, вибіркове перетранслювання та корекція помилок вперед
- Окремий порт діагностики, прозора віддалена діагностика та онлайн контроль мережі
## Де купити
- [Holybro Microhard P900 Telemetry Radio (100mW - 1W)](https://holybro.com/products/microhard-radio)
## Специфікація
<img src="../../assets/hardware/telemetry/holybro_microhard_spec.png" width="500px" title="Holybro Microhard P900 Diagnosis" />
## З'єднання
#### Транспортний радіопередавач
This radio comes with a 6-Pin JST GH cable that can be connected to the `TELEM1` port on flight controllers that are compliant with the Pixhawk connector standard.
Радіопередавач повинен окремо живитися через кабель живлення з 4-контактним роз'ємом JST-GH XT30 (7-35VDC).
#### Радіо наземної станції
У цього радіопередавача є внутрішній конвертер USB в UART, земний радіопередавач може бути підключений до земної станції через USB C. Радіопередавач повинен окремо живитися через кабель живлення XT30 (7-35VDC).
## Налаштування/Конфігурація
Радіопередавачі Holybro Microhard P900 налаштовані на режим роботи точка-точка та швидкість передачі даних 57600 бод в заводських умовах.
This allows them to connect to the PX4 `TELEM1` port and _QGroundControl_ **without any further configuration**.
:::info
You can use a different baud rate, mode or flight controller port.
Єдине "вимога" - земний радіопередавач, повітряний радіопередавач, PX4 та QGroundControl повинні мати однакову швидкість передачі даних.
:::
[Microhard Serial Telemetry Radios > Configuration](../telemetry/microhard_serial.md#configuration) explains how to configure the radios, _QGroundControl_, and PX4.
In order to configure the radios using the _PicoConfig_ application (as described in the link above) it must be connected through the diagnostic port:
<img src="../../assets/hardware/telemetry/holybro_microhard_uart converter.png" width="500px" title="Holybro Microhard P900 Diagnosis" />
Діагностичний порт використовує роз'єм JST SH з 4 позиціями.
If you use _PicoConfig_ application or special diagnostic commands to config the radio, you should connect to this port.
Діагностичний порт сумісний з логічним рівнем напруги 3,3 В.
Для підключення радіопередавача до комп'ютера потрібна плата USB-серійного перетворювача.
You can purchase a [Holybro UART to USB Converter](https://holybro.com/products/uart-to-usb-converter).
_Pico Config_ will automatically detect and connect to the configuration port.
Налаштуйте параметри так, щоб швидкість передачі даних відповідала PX4 (та земній станції).
Holding the **Config** button while powering-up the radio will boot the unit into COMMAND mode: the default serial interface will be active and temporarily set to operate at its default serial settings of 9600/8/N/1.
Зверніть увагу, що також можна налаштувати радіоприймачі за допомогою команд AT в порту.
### Конфігурація за замовчуванням
The default radio configuration as shipped is shown in _PicoConfig_ below (you may need to reconfigure them as shown after firmware update or resetting the radio).
<img src="../../assets/hardware/telemetry/holybro_pico_config.png" width="400px" title="Holybro Pico Config" />
<img src="../../assets/hardware/telemetry/holybro_pico_config1.png" width="400px" title="Holybro Pico Config" />
У режимах роботи «точка-точка» для забезпечення мережевої синхронізації системи має бути головний пристрій, тому один радіоприймач має бути налаштований на головний PP, а інший — на віддалений PP.
## Індикатор стану
<img src="../../assets/hardware/telemetry/holybro_microhard_leds.png" width="600px" title="Holybro Pico Config" />
Радіо P900 має 6 світлодіодів статусу: три з них сині, два помаранчеві, а один зелений.
Інтерпретація різних станів світлодіодів LEDs:
- Power LED(green)
- Цей світлодіод буде світитися, коли радіо P900 підключено до джерела живлення (7-35VDC).
- TX LED (orange)
- Коли підсвічується, цей світлодіод вказує на те, що радіо передає дані повітрям.
- RX LED (orange)
- Цей світлодіод показує, що радіо синхронізовано і отримано дійсні пакети.
- RSSI LEDs (3x Blue)
- По мірі збільшення отриманої сили сигналу, починаючи з найлівішого, кількість активних
- RSSI LEDs
increases. Сила сигналу обчислюється на основі останніх чотирьох отриманих пакетів з правильним CRC. Значення RSSI повідомляється в S123.
<img src="../../assets/hardware/telemetry/holybro_microhard_led_status.png" width="600px" title="Holybro Pico Config" />
<img src="../../assets/hardware/telemetry/holybro_microhard_rssi.png" width="600px" title="Holybro Pico Config" />
### Схема розташування виводів
#### Порт діагностики
| Pin | Сигнал | Напруга |
| ---------------------------- | ------ | --------------------- |
| 1 | NC | -- |
| 2 (black) | RX | +3.3V |
| 3 (black) | TX | +3.3V |
| 4 (black) | GND | GND |
#### Порт даних
| Pin | Сигнал | Напруга |
| ---------------------------- | ------ | --------------------- |
| 1 (red) | NC | -- |
| 2 (black) | RX | +3.3V |
| 3 (black) | TX | +3.3V |
| 4 (black) | CTS | +3.3V |
| 5 (black) | RTS | +3.3V |
| 6 (black) | GND | GND |
#### Порт живлення
| Pin | Сигнал | Напруга |
| ---------------------------- | ------ | ------- |
| 1(red) | BAT+ | 7-35V |
| 2 (red) | BAT+ | 7-35V |
| 3 (black) | BAT- | GND |
| 4 (black) | BAT- | GND |
<img src="../../assets/hardware/telemetry/holybro_microhard_pinout.jpg" width="600px" title="Holybro Pico Config" />
### Розміри
<img src="../../assets/hardware/telemetry/holybro_microhard_dimension.png" width="600px" title="Holybro Pico Config" />
### Споживання електроенергії
- Напруга живлення: DC7~35V від 4-контактного роз'єму JST-GH до XT30 (включено)
- Передавати поточний: 200 мА / 7 В при 20 дБм
- 350мА/7В при 27дБм
- 800 мА/7V при 30 дБм
- Отримуваний струм: 100 мА
- Вага: 42 г (без антени)
## Подальша інформація
- [Microhard Radio](https://docs.holybro.com/telemetry-radio/microhard-radio) (docs.holybro.com)
- [Holybro Microhard P900 Downloads](https://docs.holybro.com/telemetry-radio/microhard-radio/download) (Manuals, and other docs) (Holybro)
+73
View File
@@ -0,0 +1,73 @@
# HolyBro Телеметричне радіо
This Holybro [SiK](../telemetry/sik_radio.md) Telemetry Radio is a small, light and inexpensive open source "plug-and-play" radio platform to connect your Autopilot Flight Controller and Ground Station.
This radio is "plug-and-play" with all flight controllers running PX4 that have a JST-GH 6 Pin Connector TELEM port ([Pixhawk Connector Standard](https://github.com/pixhawk/Pixhawk-Standards)).
Це надає найлегший спосіб налаштування телеметрійного з'єднання між вашим контролером польоту та наземною станцією.
It uses open source firmware that has been specially designed to work well with MAVLink packets and to be integrated with the QGroundControl & PX4 Autopilot.
Вони, як правило, дозволяють межі краще, ніж 300 "поза коробкою" (діапазон можна поширити на кілька кілометрів із використанням патч-антени на землі).
Радіоприймач може бути 915 МГц (США), або 433 МГц з кроком (ЄС, Азія, Африка Океанія).
Зверніть увагу, що регіони, зазначені вище, є орієнтовними, і вам слід перевірити правила для вашої країни.
<img src="../../assets/hardware/telemetry/holybro_sik_radio_v3.png" width="600px" title="Sik Telemetry Radio" />
## Де купити
- [Holybro SiK Telemetry Radio V3](https://holybro.com/collections/telemetry-radios/products/sik-telemetry-radio-v3)
## Функції
- Відкрите програмне забезпечення SiK
- Plug-n-play для стандартного контролера польоту Pixhawk
- Найлегший спосіб підключити ваш автопілот та наземну станцію
- Можливість взаємозамінності радіо на повітрі та на землі
- Порт Micro-USB (кабель адаптера Type-C включено)
- 6-позиційний роз'єм JST-GH
## Специфікація
- Максимальна вихідна потужність 100 мВт (налаштовувана) -117 дБм чутливість прийому
- РП-SMA роз'єм
- Двосторонній повний дуплексний зв'язок через адаптивний інтерфейс TDM UART
- Прозоре послідовне посилання
- Формування протоколу MAVLink
- Частотно-перестроювана розподілена спектральна модуляція (FHSS) Налаштований цикл роботи
- Корекція помилок виправляє до 25% помилок бітів Відкрите програмне забезпечення SIK
- Configurable through Mission Planner & APM Planner
- FT230X USB на BASIC UART IC
## Стан індикатора світлодіодів
Радіоприймачі мають 2 індикатори стану, один червоний і один зелений.
Інтерпретація різних станів світлодіодів:
- Зелений світлодіод мигає - пошук іншого радіо
- Зелений світлодіод постійно горить - з'єднання встановлено з іншим радіо
- Червоний світлодіод мигає - передача даних
- Червоний світлодіод постійний - у режимі оновлення прошивки
<img src="../../assets/hardware/telemetry/holybro_sik_telemetry_label.jpg" width="500px" title="Pixhawk5x Upright Image" />
## Підключення до Політного Контролера
Use the 6 pin JST-GH connector that come with the radio to connect the radio to your flight controller's `TELEM1` port (`TELEM2` can also be used but the default recommendation is `TELEM1`).
## Підключення до ПК або Наземної станції
Підключення радіо до вашого ПК з Windows або станції землі є настільки простим, як підключення кабелю USB мікро/типу-C (адаптер Type-C включений до радіо) до вашого ПК/станції землі.
The necessary drivers should be installed automatically and the radio will appear as a new “USB Serial Port” in the Windows Device Manager under Ports (COM & LPT).
Випадаючий список вибору порту COM планувальника місій також повинен містити той самий новий порт COM.
## Пакет включає
- Радіомодулі з антенами \*2
- Мікро-USB для USB-кабелю \*1
- Кабель-переходник Micro-USB на Micro-USB OTG \*1
- Адаптер Micro USB до Type C
- Кабель JST-GH-6P до кабелю JST-GH-6P \*1 (для Pixhawk Standard FC)
- JST-GH-6P до Molex DF12 6P (для Pix32, Pixhawk 2.4.6, тощо)
<img src="../../assets/hardware/telemetry/holybro_sik_radio_v3_include.png" width="600px" title="Sik Telemetry Radio" />
+28
View File
@@ -0,0 +1,28 @@
# Holybro XBP9X Телеметрійне радіо (Припинено)
Радіо Holybro XBP9X можна легко налаштувати за допомогою безкоштовного програмного забезпечення XCTU від Digi або через спрощені набори команд AT або API від Digi.
Радіо забезпечує безпеку, надійну доставку критичних даних між пристроями з 256-бітним шифруванням AES.
![Holybro XBP9X Radio](../../assets/hardware/telemetry/holybro-xbp9x.jpg)
З лінійно-видимим радіодоступом RF до 65 миль/100 км та високою здатністю блокування втручань, радіостанції ідеально підходять для застосувань, які вимагають поєднання дальності, резервування даних та надійності даних.
**Features:**
- USB порт Type-C, інтегрований USB до конвертера UART
- 6-позиційний роз'єм JST-GH, може бути підключений безпосередньо до контролера польоту pixhawk4
- Високовольтний BEC на борту, Підтримка живлення напругою DC7~35V
- Може бути живлений через USB або контролер польоту в режимі передавача потужністю 100 мВт
- Індикатор світлодіода передачі UART
- Триетапний індикатор RSSI світлодіодом
- 256-бітне шифрування AES для безпечних даних
- Топологія мережі DigiMesh для забезпечення резерву та надійності
- Повністю сертифікований для використання в неліцензованому діапазоні 900 МГц
## Де купити
Припинено (більше недоступно в Holybro).
## Характеристики
![Holybro XBP9X Radio](../../assets/hardware/telemetry/holybro-xbp9x-spec.png)
+36
View File
@@ -0,0 +1,36 @@
# Телеметричні радіо/модеми
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 підтримує ряд типів телеметрійних радіозон:
- [SiK Radio](../telemetry/sik_radio.md) based firmware (more generally, any radio with a UART interface should work).
- [RFD900 Telemetry Radio](../telemetry/rfd900_telemetry.md)
- [HolyBro SiK Telemetry Radio](../telemetry/holybro_sik_radio.md)
- <del>_HKPilot Телеметрійне радіо_</del> (Припинено)
- <del>_3DR телеметрія радіо_</del> (припинено)
- [Telemetry Wifi](../telemetry/telemetry_wifi.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 Серійне телеметрійне радіо
- [CUAV P8 Telemetry Radio](../telemetry/cuav_p8_radio.md)
- XBee Серійне Телеметрійне Радіо
- [HolyBro XBP9X Telemetry Radio](../telemetry/holybro_xbp9x_radio.md) (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).
Телеметрія по WiFi зазвичай має менший радіус дії, вищі швидкості передачі даних і спрощує підтримку FPV/відеопотоків.
Однією з переваг WiFi-радіо є те, що вам потрібно придбати лише один радіоприймач для вашого транспортного засобу (за умови, що земна станція вже має WiFi).
:::info
PX4 does not support connecting an LTE USB module to the flight controller (and sending MAVLink traffic via the Internet).
Однак ви можете підключити модуль LTE до компаньйонного комп'ютера і використовувати його для маршрутизації трафіку MAVLink від контролера польоту.
For more information see: [Companion Computer Peripherals > Data Telephony](../companion_computer/companion_computer_peripherals.md#data-telephony-lte).
:::
## Дозволені частоти
Діапазони радіочастот, дозволені для використання з дронами, відрізняються між континентами, регіонами, країнами, а навіть штатами.Вам слід вибрати телеметричне радіо, яке використовує діапазон частот, дозволений у тих областях, де ви плануєте використовувати дрона.
Low power [SiK radios](../telemetry/sik_radio.md), such as the [Holybro Telemetry Radio](../telemetry/holybro_sik_radio.md), are often available in 915 MHz and 433 MHz variants.Хоча вам слід перевірити діючі закони у своїй країні/штаті, загалом кажучи, 915 МГц можна використовувати у США, тоді як 433 МГц можна використовувати в ЄС, Африці, Океанії та більшості Азії.
+72
View File
@@ -0,0 +1,72 @@
# Microhard Serial Telemetry Radios
[Microhard Pico Serial Radios](http://microhardcorp.com/P900.php) integrate the [Microhard Pico Serial](http://microhardcorp.com/P900.php) P900 RF module.
Це відносно невеликий за розміром та недорогий радіопередавач, який підтримує такі режими як точка-точка, точка-багатоточка та мережеві режими.
Він має налаштований вихідну потужність та також може бути налаштований на використання корекції помилок передачі.
Радіопередавачі також можна замовити з підтримкою безпечних/шифрованих каналів, хоча це підлягає обмеженням на експорт.
Manufacturers typically default-configure the radios in peer-to-peer mode and match the baud rate expected by PX4 and _QGroundControl_ (57600 baud).
This allows plug and play telemetry when the radios are connected to the usual telemetry ports on a Pixhawk flight controllers (`TELEM1` or `TELEM2`) along with auto-detection of the connection in _QGroundControl_.
Кілька виробників пропонують рішення на основі цих радіопродуктів:
- [ARK Electron Microhard Serial Telemetry Radio](../telemetry/ark_microhard_serial.md)
- [Holybro Microhard P900 Telemetry Radio](../telemetry/holybro_microhard_p900_radio.md)
## Компроміси щодо дальності передачі
Дальність передачі радіо залежить від кількох факторів, включаючи: швидкість передачі даних, вихідну потужність, режим, включено корекцію помилок передачі, включено шифрування, використання антени тощо.
Вибір цих параметрів є компромісом:
- збільшення швидкості передачі даних зменшує дальність радіопередачі.
- збільшення потужності радіо збільшує дальність, але зменшує час польоту.
- точка-багатоточка означає можливість однієї земної станції, яка спілкується з кількома транспортними засобами, але збільшує пропускну спроможність каналу.
- мережеві конфігурації надають подібний зручність і вартість.
Максимальна заявлена дальність в специфікаціях становить приблизно 60 км.
ARK Electron пропонує приблизно 8 км дальності з вихідною потужністю, встановленою на рівні 1 Вт та використанням налаштувань за замовчуванням.
## Налаштування
For convenience, radios are usually default-configured so that they can be used with PX4 and _QGroundControl_ out of the box.
Розробники можуть змінювати конфігурацію.
The only "requirement" is that the: ground radio, air radio, PX4, and _QGroundControl_ must all be set to use the **same** baud rate (and of course each MAVLink system must have a unique System ID).
### Конфігурація PX4
PX4 is configured to use `TELEM1` for telemetry radios, with a default baud rate of 57600.
You can configure PX4 to use any other free serial port a different baud rate, by following the instructions in [MAVLink Peripherals](../peripherals/mavlink_peripherals.md).
### Налаштування QGroundControl
QGroundControl автоматично виявляє послідовне зв'язку телеметрії з швидкістю передачі даних 57600.
Для будь-якого іншого тарифу вам потрібно додати послідовне з'єднання, яке встановлює тариф, який був використаний.
See [Application Settings > Comms Links](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/settings_view/settings_view.html).
### Конфігурація радіо
Microhard serial radios are configured using the _PicoConfig_ application (Windows only).
This can be downloaded here: [PicoConfig-1.7.zip](https://arkelectron.com/wp-content/uploads/2021/04/PicoConfig-1.7.zip) (ARK Electron) or [picoconfig-1-10](https://docs.holybro.com/telemetry-radio/microhard-radio/download) (Holybro).
У режимах роботи «точка-точка» для забезпечення мережевої синхронізації системи має бути головний пристрій, тому один радіоприймач має бути налаштований на головний PP, а інший — на віддалений PP.
The screen shots below show the default radio configuration settings for connecting to PX4 and _QGroundControl_.
<img src="../../assets/hardware/telemetry/holybro_pico_config.png" width="400px" title="Holybro Pico Config" />
<img src="../../assets/hardware/telemetry/holybro_pico_config1.png" width="400px" title="Holybro Pico Config" />
The [Pico Series P900.Operating Manual.v1.8.7](https://github.com/PX4/PX4-user_guide/raw/main/assets/hardware/telemetry/Pico-Series-P900.Operating-Manual.v1.8.7.pdf) has additional information on radio configuration (including mesh and multipoint modes).
### Режими Mesh та Multipoint
Підтримуються режими Mesh та point to multi-point, але всі транспортні засоби повинні мати унікальний ідентифікатор Mavlink.
Додатково:
- На найвищій швидкості зв'язку, без FEC, ми можемо мати 201 дрона в одній мережі, що передає 80 байт один раз на секунду.
- Ви можете мати кілька мереж, які працюють разом одночасно без взаємного втручання за допомогою "спільно розташованих систем".
Наприклад, для розгортання більше ніж 500 транспортних засобів вам знадобиться розгорнути три координатори мережі P900, кожен з яких обслуговуватиме до 201 дронів у відповідних локальних мережах.
+22
View File
@@ -0,0 +1,22 @@
# Дальній телеметр RFD900
[jDrones](http://store.jDrones.com) and [RFDesign](http://rfdesign.com.au/) offer _long-range_ [SiK](../telemetry/sik_radio.md)-compatible telemetry radios.
Радіостанції забезпечують надійне підключення на відстанях більше 5 км звичайними антенами (і було повідомлено про досягнення набагато більших відстаней).
![jDrones Long Range Telemetry](../../assets/hardware/telemetry/jdrones_long_range_uav_telemetry_rf900set02_2.jpg)
:::tip
_jDrones_ have productized _RFDesign_ modems (added a casing with power management, filtering and other electronics inside, along with cables to connect to popular flight controllers, and individually validated antennas).
The first such modem was the _RFD900_, but both _RFDesign_ and _jDrones_ have since iterated to new versions.
:::
The _jDrones_ radios have a JST-GH connector, and come with cables for: _JST-GH to JST-GH_ and _JST-GH to DF-13_. They can therefore be used in a "plug-n-play" way with most [Pixhawk Series](../flight_controller/pixhawk_series.md) controllers (you might have to change/use an appropriate connector for some "non-standard" boards).
Є кілька доступних версій:
- [jD-RF900Plus Longrange (900Mhz)](http://store.jdrones.com/jD_RD900Plus_Telemetry_Bundle_p/rf900set02.htm) (USA)
- [jD-RF868Plus Longrange (868Mhz)](http://store.jdrones.com/jD_RD868Plus_Telemetry_Bundle_p/rf868set02.htm) (Europe)
- [store.rfdesign.com.au](https://store.rfdesign.com.au/radio-modems/):
- [RFD 900+ Modem](https://store.rfdesign.com.au/rfd-900p-modem/)
- [RFD 868x Modem (EU)](https://store.rfdesign.com.au/rfd868x-eu-hs-8517-62-00-90/)
- [RFD900x](https://store.rfdesign.com.au/rfd-900x-modem-hs-8517-62-00-90/)
+37
View File
@@ -0,0 +1,37 @@
# SiK Radio
[SiK radio](https://github.com/LorenzMeier/SiK) is a collection of firmware and tools for telemetry radios.
PX4 is protocol-compatible with radios that use _SiK_.
SiK Radios often come with appropriate connectors/cables allowing them to be directly connected to [Pixhawk Series](../flight_controller/pixhawk_series.md) controllers
(in some cases you may need to obtain an appropriate cable/connector).
Зазвичай вам знадобиться пара пристроїв: один для транспортного засобу та один для наземної станції.
Апаратне забезпечення для радіо SiK можна придбати у різних виробників/магазинів у варіантах, які підтримують різні діапазони та форм-фактори.
![SiK Radio](../../assets/hardware/telemetry/holybro_sik_radio.jpg)
## Постачальники
- [RFD900 Telemetry Radio](../telemetry/rfd900_telemetry.md)
- [Holybro Telemetry Radio](../telemetry/holybro_sik_radio.md)
- <del>_HKPilot Телеметрійне радіо_</del> (Припинено)
- <del>_3DR телеметрія радіо_</del> (припинено)
## Налаштування/Конфігурація
Підземне радіо, орієнтоване на станції підключено через USB (по суті plug-n-play).
The vehicle-based radio is connected to the flight-controller's `TELEM1` port, and typically requires no further configuration.
## Оновлення прошивки
Hardware sourced from most [vendors](#vendors) should come pre-configured with the latest firmware.
Можливо, вам знадобиться оновити старе обладнання новим мікропрограмним забезпеченням, наприклад, щоб отримати підтримку MAVLink 2.
You can update the radio firmware using _QGroundControl_: [QGroundControl User Guide > Loading Firmware](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/setup_view/firmware.html).
## Розширене налаштування/конфігурація
The Development section has [additional information](../data_links/sik_radio.md) about building firmware and AT-command based configuration.
Це не повинно вимагатися особам, які не є розробниками.
+13
View File
@@ -0,0 +1,13 @@
# WiFi Телеметрійне радіо
WiFi telemetry enables MAVLink communication between a WiFi radio on a vehicle and a GCS.\
WiFi typically offers shorter range than a normal telemetry radio, but supports higher data rates, and makes it easier to support FPV/video feeds.
Зазвичай для транспортного засобу потрібен лише один радіоприймач (з умовою, що наземна станція вже має WiFi).
PX4 підтримує телеметрію через UDP та Wifi. Він транслює сигнал серцебиття на порт 14550 за адресою 255.255.255.255, доки не отримає перший сигнал серцебиття від земної станції керування, після чого він буде надсилати дані лише на цю земну станцію керування.
Сумісні модулі телеметрії WiFi включають в себе:
- [ESP8266 WiFi Module](../telemetry/esp8266_wifi_module.md)
- [ESP32 WiFi Module](../telemetry/esp32_wifi_module.md)
- [3DR Telemetry Wifi](../telemetry/3dr_telemetry_wifi.md) (Discontinued)