diff --git a/docs/uk/advanced/gimbal_control.md b/docs/uk/advanced/gimbal_control.md index e84370ba74..c0ffaf1441 100644 --- a/docs/uk/advanced/gimbal_control.md +++ b/docs/uk/advanced/gimbal_control.md @@ -23,6 +23,9 @@ PX4 приймає вхідний сигнал і маршрутизує/пер If you select `Auto (0)`, the gimbal will automatically select either RC or MAVLink input based on the latest input. Зверніть увагу, що для автоматичного перемикання з MAVLink на RC потрібен великий рух ручкою! +To hold a fixed attitude that the pilot cannot control (e.g. for RF/Satellite receiver stabilization), set `MNT_MODE_IN` to `Fixed attitude (5)`. +See [Fixed Attitude Gimbal](#fixed-attitude-gimbal) below. + Вихід налаштовується за допомогою параметра [MNT_MODE_OUT](../advanced_config/parameter_reference.md#MNT_MODE_OUT). Усталеним налаштування виходу PXM є (`AUX (0)`). Якщо ваш гімбал підтримує [Протокол гімбала MAVLink v2](https://mavlink.io/en/services/gimbal_v2.html), ви повинні замість цього вибрати `Протокол гімбала MAVLink v2 (2)`. @@ -77,6 +80,20 @@ Gimbal також можна контролювати шляхом підклю The PWM values to use for the disarmed, maximum, center and minimum values can be determined in the same way as other servo, using the [Actuator Test sliders](../config/actuators.md#actuator-testing) to confirm that each slider moves the appropriate axis, and changing the values so that the gimbal is in the appropriate position at the disarmed, low, center and high position in the slider. Значення також можуть бути наведені у документації гімбала. +## Fixed Attitude Gimbal + +A fixed-attitude gimbal holds a constant world-frame attitude and cannot be controlled by the pilot. +This is useful for stabilizing a payload that must keep pointing in a fixed direction regardless of vehicle motion, such as an RF or satellite receiver antenna. + +To enable it, set [MNT_MODE_IN](../advanced_config/parameter_reference.md#MNT_MODE_IN) to `Fixed attitude (5)` and reboot. +In this mode no RC or MAVLink input is created, so the attitude cannot be commanded from a transmitter or ground station. + +The gimbal holds roll and yaw level (roll at 0, yaw at north), and pitch at the angle set in [MNT_FIXED_PITCH](../advanced_config/parameter_reference.md#MNT_FIXED_PITCH) (in degrees, world frame). + +Because the setpoint is in the world frame, stabilization against vehicle motion must be enabled with [MNT_DO_STAB](../advanced_config/parameter_reference.md#MNT_DO_STAB): + +- Set `MNT_DO_STAB` to `Stabilize all axis (1)` for the typical servo (AUX) gimbal. + ## Gimbal Control in Missions [Gimbal Manager commands](https://mavlink.io/en/services/gimbal_v2.html#gimbal-manager-messages) may be used in missions if supported by the vehicle type. diff --git a/docs/uk/dev_setup/dev_env_windows_wsl.md b/docs/uk/dev_setup/dev_env_windows_wsl.md index f5f6d8e2e0..c612019771 100644 --- a/docs/uk/dev_setup/dev_env_windows_wsl.md +++ b/docs/uk/dev_setup/dev_env_windows_wsl.md @@ -22,18 +22,21 @@ The [Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/ - Build any simulator or hardware target supported by [Ubuntu Development Environment](../dev_setup/dev_env_linux_ubuntu.md) in the WSL Shell. (Ubuntu є платформою розробки PX4, яка підтримується та протестована найкраще). +- [Update firmware](#flash-a-flight-control-board) on a real vehicle _using the command line_. - Debug code in [Visual Studio Code](dev_env_windows_wsl.md#visual-studio-code-integration) running on Windows. - Monitor a _simulation_ using _QGroundControl for Linux_ running in WSL. QGC для Linux автоматично під'єднується до симуляції. _QGroundControl for Windows_ is additionally required if you need to: -- [Update firmware](#flash-a-flight-control-board) on a real vehicle. +- [Update firmware](#flash-a-flight-control-board) using the QGC UI. - Спостерігати за справжнім засобом. Note that you can also use it to monitor a simulation, but you must manually [connect to the simulation running in WSL](#qgroundcontrol-on-windows). -:::info -Connecting to an USB device from within WSL is not natively supported, however it can still be achieved by using the [USBIPD-WIN](https://learn.microsoft.com/en-us/windows/wsl/connect-usb) project. With this you can automatically upload firmware from the command line in WSL using the [`upload`](../dev_setup/building_px4.md#uploading-firmware-flashing-the-board) function. +:::tip +Connecting to an USB device from within WSL is not natively supported, but can be enabled via [USBIPD-WIN](https://learn.microsoft.com/en-us/windows/wsl/connect-usb). + +From PX4 v1.18, you can upload PX4 firmware over USB from the WSL command line using the [`upload`](../dev_setup/building_px4.md#uploading-firmware-flashing-the-board) target (this uses the Windows Python interpreter on WSL to access the flight controller through the Windows COM port). ::: :::info @@ -229,7 +232,7 @@ VS Code на Windows добре інтегрований з WSL. ## QGroundControl Для підключення до запущеної симуляції, ви можете запустити QGroundControl або в WSL або у Windows. -If you need to [flash a flight control board](#flash-a-flight-control-board) with new firmware you can only do this from the QGroundControl for Windows. +If you want to flash a flight control board using the QGroundControl GUI, you _must_ use QGroundControl for Windows. ### QGroundControl у WSL @@ -292,38 +295,40 @@ You will have to update the WSL comm link in QGC every time WSL restarts (becaus ## Прошивка плати керування польотом -Flashing a custom built PX4 binary has to be done using [QGroundControl for Windows](#qgroundcontrol-on-windows). +Custom PX4 firmware built in WSL can be uploaded directly from the WSL command line using the [`upload`](../dev_setup/building_px4.md#uploading-firmware-flashing-the-board) target. :::info WSL2 does not natively offer direct access to serial/USB devices like Pixhawk flight controllers connected to your computer. -That means you can't connect QGC running inside WSL2 to a flight controller to install firmware, or use the `upload` command to [upload firmware as it is built](../dev_setup/building_px4.md#uploading-firmware-flashing-the-board). -Instead you connect [QGroundControl for Windows](#qgroundcontrol-on-windows) to PX4 running in WSL2 and to the Flight controller in order to upload the firmware. +The PX4 `upload` target works around this by using the Windows Python interpreter from WSL to access the flight controller through the Windows COM port. ::: -Зробіть наступні кроки для прошивки вашого бінарного файлу, зібраного у WSL: +To flash your custom binary from WSL: -1. If you haven't already built the binary in WSL e.g. with a [WSL shell](dev_env_windows_wsl.md#opening-a-wsl-shell) and by running: +1. Connect the flight controller to your computer with a USB cable. +2. Open a [WSL shell](dev_env_windows_wsl.md#opening-a-wsl-shell), switch to the PX4 repository, and specify `upload` after your make target: ```sh cd ~/PX4-Autopilot - make px4_fmu-v5 + make px4_fmu-v5 upload ``` ::: tip + This builds `px4_fmu-v5`. Use the correct `make` target for your board. - `px4_fmu-v5` can be used for a Pixhawk 4 board. ::: -2. Detach the USB cable of your Pixhawk board from the computer if it was connected. +You can also flash a custom binary built in WSL using [QGroundControl for Windows](#qgroundcontrol-on-windows): -3. Open QGC and navigate to **Q > Vehicle Setup > Firmware**. +1. Detach the USB cable of your Pixhawk board from the computer if it was connected. -4. Plug your Pixhawk board via USB +2. Open QGC and navigate to **Q > Vehicle Setup > Firmware**. -5. Once connected select "PX4 Flight Stack", check **Advanced settings** and choose _Custom firmware file ..._ from the drop down below. +3. Plug your Pixhawk board via USB -6. Continue and select the firmware binary you just built in WSL. +4. Once connected select "PX4 Flight Stack", check **Advanced settings** and choose _Custom firmware file ..._ from the drop down below. + +5. Continue and select the firmware binary you just built in WSL. У відкритому діалозі знайдіть розташування "Linux" з іконкою пінгвіна на лівій панелі. Зазвичай, вона в самому низу. @@ -334,7 +339,7 @@ Instead you connect [QGroundControl for Windows](#qgroundcontrol-on-windows) to ::: -7. Почніть прошивку. +6. Почніть прошивку. For more information see [Installing PX4 Main, Beta or Custom Firmware (Loading Firmware)](../config/firmware.md#installing-px4-main-beta-or-custom-firmware).