diff --git a/docs/uk/SUMMARY.md b/docs/uk/SUMMARY.md index 8217225a0b..59a0844b23 100644 --- a/docs/uk/SUMMARY.md +++ b/docs/uk/SUMMARY.md @@ -739,6 +739,7 @@ - [Магнітометр](modules/modules_driver_magnetometer.md) - [Оптичний потік](modules/modules_driver_optical_flow.md) - [Датчик швидкості обертання](modules/modules_driver_rpm_sensor.md) + - [Radio Control](modules/modules_driver_radio_control.md) - [Транспондер](modules/modules_driver_transponder.md) - [Естіматори](modules/modules_estimator.md) - [Симуляції](modules/modules_simulation.md) diff --git a/docs/uk/debug/failure_injection.md b/docs/uk/debug/failure_injection.md index 65cd6e3506..2cfc45ccad 100644 --- a/docs/uk/debug/failure_injection.md +++ b/docs/uk/debug/failure_injection.md @@ -61,7 +61,7 @@ failure [-i ] - _instance number_ (optional): Instance number of affected sensor. 0 (за замовчуванням) вказує на всі сенсори вказаного типу. -### Приклад +### Example Щоб симулювати втрату сигналу RC без вимкнення вашого пульта керування RC: diff --git a/docs/uk/modules/modules_autotune.md b/docs/uk/modules/modules_autotune.md index 17b4b5fac2..b11ba1bc53 100644 --- a/docs/uk/modules/modules_autotune.md +++ b/docs/uk/modules/modules_autotune.md @@ -6,9 +6,7 @@ Source: [modules/fw_autotune_attitude_control](https://github.com/PX4/PX4-Autopi ### Опис - - -### Використання +### Usage {#fw_autotune_attitude_control_usage} ``` fw_autotune_attitude_control [arguments...] @@ -27,9 +25,7 @@ Source: [modules/mc_autotune_attitude_control](https://github.com/PX4/PX4-Autopi ### Опис - - -### Використання +### Usage {#mc_autotune_attitude_control_usage} ``` mc_autotune_attitude_control [arguments...] diff --git a/docs/uk/modules/modules_command.md b/docs/uk/modules/modules_command.md index 97b9c45610..f7e8f84f0b 100644 --- a/docs/uk/modules/modules_command.md +++ b/docs/uk/modules/modules_command.md @@ -8,9 +8,7 @@ Source: [systemcmds/actuator_test](https://github.com/PX4/PX4-Autopilot/tree/mai ПОПЕРЕДЖЕННЯ: перед використанням цієї команди приберіть усі пропелери. - - -### Використання +### Usage {#actuator_test_usage} ``` actuator_test [arguments...] @@ -34,9 +32,9 @@ actuator_test [arguments...] Source: [systemcmds/bl_update](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/bl_update) -Utility to flash the bootloader from a file +Utility to flash the bootloader from a file -### Використання +### Usage {#bl_update_usage} ``` bl_update [arguments...] @@ -50,9 +48,9 @@ bl_update [arguments...] Source: [systemcmds/bsondump](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/bsondump) -Utility to read BSON from a file and print or output document size. +Utility to read BSON from a file and print or output document size. -### Використання +### Usage {#bsondump_usage} ``` bsondump [arguments...] @@ -63,9 +61,9 @@ bsondump [arguments...] Source: [systemcmds/dumpfile](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/dumpfile) -Утиліта для роботи з файлами дампу. Виводить розмір та вміст файлу у бінарному режимі (не замінюйте LF на CR LF) до stdout. +Dump file utility. Prints file size and contents in binary mode (don't replace LF with CR LF) to stdout. -### Використання +### Usage {#dumpfile_usage} ``` dumpfile [arguments...] @@ -78,17 +76,15 @@ Source: [systemcmds/dyn](https://github.com/PX4/PX4-Autopilot/tree/main/src/syst ### Опис -Завантажує та запускає динамічний модуль PX4, який не було скомпільовано у бінарний файл PX4. +Load and run a dynamic PX4 module, which was not compiled into the PX4 binary. -### Приклад +### Example ``` dyn ./hello.px4mod start ``` - - -### Використання +### Usage {#dyn_usage} ``` dyn [arguments...] @@ -102,21 +98,19 @@ Source: [systemcmds/failure](https://github.com/PX4/PX4-Autopilot/tree/main/src/ ### Опис -Впроваджує збої в систему. +Inject failures into system. ### Імплементація -Ця системна команда надсилає транспортному засобу команду через uORB, щоб спровокувати збій. +This system command sends a vehicle command over uORB to trigger failure. ### Приклади -Перевірити failsafe GPS, зупинивши GPS: +Test the GPS failsafe by stopping GPS: failure gps off - - -### Використання +### Usage {#failure_usage} ``` failure [arguments...] @@ -135,7 +129,7 @@ Source: [systemcmds/gpio](https://github.com/PX4/PX4-Autopilot/tree/main/src/sys ### Опис -Ця команда використовується для читання та запису GPIO +This command is used to read and write GPIOs ``` gpio read / [PULLDOWN|PULLUP] [--force] @@ -144,7 +138,7 @@ gpio write / [PUSHPULL|OPENDRAIN] [--force] ### Приклади -Зчитати значення на port H pin 4 налаштований як імпульс, і це високо +Read the value on port H pin 4 configured as pullup, and it is high ``` gpio read H4 PULLUP @@ -152,21 +146,19 @@ gpio read H4 PULLUP 1 OK -Встановіть вихідне значення на виводі порту E на високий рівень +Set the output value on Port E pin 7 to high ``` gpio write E7 1 --force ``` -Встановіть вихідне значення на пристрої /dev/gpio1 на високе значення +Set the output value on device /dev/gpio1 to high ``` gpio write /dev/gpio1 1 ``` - - -### Використання +### Usage {#gpio_usage} ``` gpio [arguments...] @@ -186,13 +178,11 @@ gpio [arguments...] Source: [systemcmds/hardfault_log](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/hardfault_log) -Утиліта апаратного збою +Hardfault utility -Використовується у сценаріях запуску для обробки апаратних збоїв +Used in startup scripts to handle hardfaults - - -### Використання +### Usage {#hardfault_log_usage} ``` hardfault_log [arguments...] @@ -219,9 +209,9 @@ hardfault_log [arguments...] Source: [systemcmds/hist](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/hist) -Інструмент командного рядка для відображення історії повідомлень px4. Немає аргументів. +Command-line tool to show the px4 message history. There are no arguments. -### Використання +### Usage {#hist_usage} ``` hist [arguments...] @@ -231,9 +221,9 @@ hist [arguments...] Source: [systemcmds/i2cdetect](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/i2cdetect) -Utility to scan for I2C devices on a particular bus. +Utility to scan for I2C devices on a particular bus. -### Використання +### Usage {#i2cdetect_usage} ``` i2cdetect [arguments...] @@ -249,23 +239,21 @@ Source: [systemcmds/led_control](https://github.com/PX4/PX4-Autopilot/tree/main/ Command-line tool to control & test the (external) LED's. -Щоб скористатися ним, переконайтеся, що запущено драйвер, який обробляє тему led_control uorb. +To use it make sure there's a driver running, which handles the led_control uorb topic. -Існують різні пріоритети, наприклад, один модуль може встановити колір з низьким пріоритетом, а інший -модуль може блимати N разів з високим пріоритетом, і світлодіоди автоматично повертаються до стану з низьким пріоритетом -після блимання. The `reset` command can also be used to return to a lower priority. +There are different priorities, such that for example one module can set a color with low priority, and another +module can blink N times with high priority, and the LED's automatically return to the lower priority state +after the blinking. The `reset` command can also be used to return to a lower priority. ### Приклади -Блимання першого світлодіода 5 разів синім кольором: +Blink the first LED 5 times in blue: ``` led_control blink -c blue -l 0 -n 5 ``` - - -### Використання +### Usage {#led_control_usage} ``` led_control [arguments...] @@ -301,13 +289,11 @@ led_control [arguments...] Source: [systemcmds/topic_listener](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/topic_listener) -Утиліта для прослуховування тем uORB та виводу даних у консоль. +Utility to listen on uORB topics and print the data to the console. -Із прослуховування можна вийти в будь-який момент, натиснувши Ctrl+C, Esc або Q. +The listener can be exited any time by pressing Ctrl+C, Esc, or Q. - - -### Використання +### Usage {#listener_usage} ``` listener [arguments...] @@ -325,9 +311,9 @@ listener [arguments...] Source: [systemcmds/mft](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/mft) -Utility interact with the manifest +Utility interact with the manifest -### Використання +### Usage {#mfd_usage} ``` mfd [arguments...] @@ -339,9 +325,9 @@ mfd [arguments...] Source: [systemcmds/mft_cfg](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/mft_cfg) -Tool to set and get manifest configuration +Tool to set and get manifest configuration -### Використання +### Usage {#mft_cfg_usage} ``` mft_cfg [arguments...] @@ -360,9 +346,9 @@ mft_cfg [arguments...] Source: [systemcmds/mtd](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/mtd) -Utility to mount and test partitions (based on FRAM/EEPROM storage as defined by the board) +Utility to mount and test partitions (based on FRAM/EEPROM storage as defined by the board) -### Використання +### Usage {#mtd_usage} ``` mtd [arguments...] @@ -388,14 +374,12 @@ mtd [arguments...] Source: [systemcmds/nshterm](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/nshterm) -Запуск оболонки NSH на заданому порту. +Start an NSH shell on a given port. -Раніше це використовувалося для запуску оболонки на послідовному порту USB. -Тепер там працює mavlink, і можна використовувати оболонку поверх mavlink. +This was previously used to start a shell on the USB serial port. +Now there runs mavlink, and it is possible to use a shell over mavlink. - - -### Використання +### Usage {#nshterm_usage} ``` nshterm [arguments...] @@ -408,23 +392,24 @@ Source: [systemcmds/param](https://github.com/PX4/PX4-Autopilot/tree/main/src/sy ### Опис -Команда для доступу до параметрів і маніпулювання ними через оболонку або скрипт. +Command to access and manipulate parameters via shell or script. -Це використовується, наприклад, у сценарії запуску для встановлення специфічних для планера параметрів. +This is used for example in the startup script to set airframe-specific parameters. -Parameters are automatically saved when changed, eg. with `param set`. Зазвичай вони зберігаються на FRAM -або на SD-карту. `param select` can be used to change the storage location for subsequent saves (this will +Parameters are automatically saved when changed, eg. with `param set`. They are typically stored to FRAM +or to the SD card. `param select` can be used to change the storage location for subsequent saves (this will need to be (re-)configured on every boot). If the FLASH-based backend is enabled (which is done at compile time, e.g. for the Intel Aero or Omnibus), `param select` has no effect and the default is always the FLASH backend. However `param save/load ` can still be used to write to/read from files. -Кожен параметр має прапорець «використано», який встановлюється при його зчитуванні під час завантаження. Він використовується для відображення лише релевантних параметрів на наземну станцію керування. +Each parameter has a 'used' flag, which is set when it's read during boot. It is used to only show relevant +parameters to a ground control station. ### Приклади -Змініть планер і переконайтеся, що завантажені параметри планера за замовчуванням: +Change the airframe and make sure the airframe's default parameters are loaded: ``` param set SYS_AUTOSTART 4001 @@ -432,9 +417,7 @@ param set SYS_AUTOCONFIG 1 reboot ``` - - -### Використання +### Usage {#param_usage} ``` param [arguments...] @@ -509,12 +492,10 @@ Source: [modules/payload_deliverer](https://github.com/PX4/PX4-Autopilot/tree/ma ### Опис -Керує доставкою вантажу за допомогою захвату або лебідки з відповідним налаштуванням тайм-ауту / датчиком зворотнього зв'язку, -та повертає результат доставки як підтвердження внутрішньо +Handles payload delivery with either Gripper or a Winch with an appropriate timeout / feedback sensor setting, +and communicates back the delivery result as an acknowledgement internally - - -### Використання +### Usage {#payload_deliverer_usage} ``` payload_deliverer [arguments...] @@ -536,9 +517,9 @@ payload_deliverer [arguments...] Source: [systemcmds/perf](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/perf) -Tool to print performance counters +Tool to print performance counters -### Використання +### Usage {#perf_usage} ``` perf [arguments...] @@ -553,9 +534,9 @@ perf [arguments...] Source: [systemcmds/reboot](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/reboot) -Reboot the system +Reboot the system -### Використання +### Usage {#reboot_usage} ``` reboot [arguments...] @@ -568,9 +549,9 @@ reboot [arguments...] Source: [systemcmds/sd_bench](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/sd_bench) -Test the speed of an SD Card +Test the speed of an SD Card -### Використання +### Usage {#sd_bench_usage} ``` sd_bench [arguments...] @@ -591,9 +572,9 @@ sd_bench [arguments...] Source: [systemcmds/sd_stress](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/sd_stress) -Test operations on an SD Card +Test operations on an SD Card -### Використання +### Usage {#sd_stress_usage} ``` sd_stress [arguments...] @@ -607,13 +588,11 @@ sd_stress [arguments...] Source: [systemcmds/serial_passthru](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/serial_passthru) -Передає дані з одного пристрою на інший. +Pass data from one device to another. -Це може бути використано для використання u-center, підключеного до USB з GPS через послідовний порт. +This can be used to use u-center connected to USB with a GPS on a serial port. - - -### Використання +### Usage {#serial_passthru_usage} ``` serial_passthru [arguments...] @@ -632,20 +611,18 @@ Source: [systemcmds/system_time](https://github.com/PX4/PX4-Autopilot/tree/main/ ### Опис -Інструмент командного рядка для встановлення та отримання системного часу. +Command-line tool to set and get system time. ### Приклади -Встановіть системний час і прочитайте його назад +Set the system time and read it back ``` system_time set 1600775044 system_time get ``` - - -### Використання +### Usage {#system_time_usage} ``` system_time [arguments...] @@ -659,9 +636,9 @@ system_time [arguments...] Source: [systemcmds/top](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/top) -Monitor running processes and their CPU, stack usage, priority and state +Monitor running processes and their CPU, stack usage, priority and state -### Використання +### Usage {#top_usage} ``` top [arguments...] @@ -672,10 +649,10 @@ top [arguments...] Source: [systemcmds/usb_connected](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/usb_connected) -Утиліта для перевірки підключення USB. Раніше використовувався в стартових скриптах. -Значення 0 означає, що USB підключено, 1 - ні. +Utility to check if USB is connected. Was previously used in startup scripts. +A return value of 0 means USB is connected, 1 otherwise. -### Використання +### Usage {#usb_connected_usage} ``` usb_connected [arguments...] @@ -685,9 +662,9 @@ usb_connected [arguments...] Source: [systemcmds/ver](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/ver) -Tool to print various version information +Tool to print various version information -### Використання +### Usage {#ver_usage} ``` ver [arguments...] diff --git a/docs/uk/modules/modules_communication.md b/docs/uk/modules/modules_communication.md index 50021d207d..e1d4fcebe4 100644 --- a/docs/uk/modules/modules_communication.md +++ b/docs/uk/modules/modules_communication.md @@ -4,9 +4,9 @@ Source: [drivers/telemetry/frsky_telemetry](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/telemetry/frsky_telemetry) -Підтримка FrSky Telemetry. Автоматичне визначення протоколу D або S.PORT. +Підтримка FrSky Telemetry. Автоматичне визначення протоколу D або S.PORT. -### Використання +### Usage {#frsky_telemetry_usage} ``` frsky_telemetry [arguments...] @@ -64,9 +64,7 @@ mavlink start -u 14556 -r 1000000 mavlink stream -u 14556 -s HIGHRES_IMU -r 50 ``` - - -### Використання +### Usage {#mavlink_usage} ``` mavlink [arguments...] @@ -129,31 +127,29 @@ Source: [systemcmds/uorb](https://github.com/PX4/PX4-Autopilot/tree/main/src/sys ### Опис -uORB - це внутрішня система обміну повідомленнями pub-sub, яка використовується для комунікації між модулями. +uORB is the internal pub-sub messaging system, used for communication between modules. ### Імплементація -Реалізація є асинхронною та безблоковою, тобто видавець не чекає на підписника і навпаки. -Це досягається завдяки наявності окремого буфера між публікатором і підписником. +The implementation is asynchronous and lock-free, ie. a publisher does not wait for a subscriber and vice versa. +This is achieved by having a separate buffer between a publisher and a subscriber. -Код оптимізовано для мінімізації використання пам'яті та затримок при обміні повідомленнями. +The code is optimized to minimize the memory footprint and the latency to exchange messages. -Messages are defined in the `/msg` directory. Вони перетворюються в код C/C++ під час збірки. +Messages are defined in the `/msg` directory. They are converted into C/C++ code at build-time. -Якщо ви компілюєте з ORB_USE_PUBLISHER_RULES, файл з правилами публікації uORB можна використовувати для налаштування того, яким -модулям дозволено публікувати які теми. Це використовується для загальносистемного відтворення. +If compiled with ORB_USE_PUBLISHER_RULES, a file with uORB publication rules can be used to configure which +modules are allowed to publish which topics. This is used for system-wide replay. ### Приклади -Відстежуйте показники публікацій тем. Besides `top`, this is an important command for general system inspection: +Monitor topic publication rates. Besides `top`, this is an important command for general system inspection: ``` uorb top ``` - - -### Використання +### Usage {#uorb_usage} ``` uorb [arguments...] diff --git a/docs/uk/modules/modules_controller.md b/docs/uk/modules/modules_controller.md index cbfdbd4177..6ae0e1a0b1 100644 --- a/docs/uk/modules/modules_controller.md +++ b/docs/uk/modules/modules_controller.md @@ -16,9 +16,7 @@ Currently it is feeding the `manual_control_setpoint` topic directly to the actu Щоб зменшити затримку керування, модуль безпосередньо опитує тему гіроскопа, опубліковану драйвером IMU. - - -### Використання +### Usage {#airship_att_control_usage} ``` airship_att_control [arguments...] @@ -36,12 +34,10 @@ Source: [modules/control_allocator](https://github.com/PX4/PX4-Autopilot/tree/ma ### Опис -Це реалізує розподіл управління. Він приймає задані значення крутного моменту та тяги -як вхідні та вихідні повідомлення про задані значення привода. +This implements control allocation. It takes torque and thrust setpoints +as inputs and outputs actuator setpoint messages. - - -### Використання +### Usage {#control_allocator_usage} ``` control_allocator [arguments...] @@ -59,12 +55,10 @@ Source: [modules/flight_mode_manager](https://github.com/PX4/PX4-Autopilot/tree/ ### Опис -Це реалізує генерацію заданого значення для всіх режимів. Він приймає поточний стан режиму транспортного засобу як вхідні дані -і виводить задані значення для контролерів. +This implements the setpoint generation for all modes. It takes the current mode state of the vehicle as input +and outputs setpoints for controllers. - - -### Використання +### Usage {#flight_mode_manager_usage} ``` flight_mode_manager [arguments...] @@ -82,11 +76,9 @@ Source: [modules/fw_att_control](https://github.com/PX4/PX4-Autopilot/tree/main/ ### Опис -fw_att_control - регулятор положення фіксованого крила. +fw_att_control is the fixed wing attitude controller. - - -### Використання +### Usage {#fw_att_control_usage} ``` fw_att_control [arguments...] @@ -105,11 +97,9 @@ Source: [modules/fw_pos_control](https://github.com/PX4/PX4-Autopilot/tree/main/ ### Опис -fw_pos_control - контролер положення фіксованого крила. +fw_pos_control is the fixed-wing position controller. - - -### Використання +### Usage {#fw_pos_control_usage} ``` fw_pos_control [arguments...] @@ -128,11 +118,9 @@ Source: [modules/fw_rate_control](https://github.com/PX4/PX4-Autopilot/tree/main ### Опис -fw_rate_control - регулятор швидкості фіксованого крила. +fw_rate_control is the fixed-wing rate controller. - - -### Використання +### Usage {#fw_rate_control_usage} ``` fw_rate_control [arguments...] @@ -151,21 +139,19 @@ Source: [modules/mc_att_control](https://github.com/PX4/PX4-Autopilot/tree/main/ ### Опис -Це реалізує контролер положення мультикоптера. It takes attitude +This implements the multicopter attitude controller. It takes attitude setpoints (`vehicle_attitude_setpoint`) as inputs and outputs a rate setpoint. -Контролер має P цикл для кутової похибки +The controller has a P loop for angular error -Публікація, що документує реалізоване кватерніонне керування положенням: +Publication documenting the implemented Quaternion Attitude Control: Nonlinear Quadrocopter Attitude Control (2013) by Dario Brescianini, Markus Hehn and Raffaello D'Andrea Institute for Dynamic Systems and Control (IDSC), ETH Zurich https://www.research-collection.ethz.ch/bitstream/handle/20.500.11850/154099/eth-7387-01.pdf - - -### Використання +### Usage {#mc_att_control_usage} ``` mc_att_control [arguments...] @@ -184,16 +170,14 @@ Source: [modules/mc_pos_control](https://github.com/PX4/PX4-Autopilot/tree/main/ ### Опис -Контролер має два контури: P цикл для помилки положення і PID цикл для помилки швидкості. -Виходом контролера швидкості є вектор тяги, який розділяється на напрямок тяги -(тобто матрицю обертання для орієнтації мультикоптера) та скаляр тяги (тобто саму тягу мультикоптера). +The controller has two loops: a P loop for position error and a PID loop for velocity error. +Output of the velocity controller is thrust vector that is split to thrust direction +(i.e. rotation matrix for multicopter orientation) and thrust scalar (i.e. multicopter thrust itself). -Контролер не використовує кути Ейлера для своєї роботи, вони генеруються лише для більш зручного керування та -логування. +The controller doesn't use Euler angles for its work, they are generated only for more human-friendly control and +logging. - - -### Використання +### Usage {#mc_pos_control_usage} ``` mc_pos_control [arguments...] @@ -212,14 +196,12 @@ Source: [modules/mc_rate_control](https://github.com/PX4/PX4-Autopilot/tree/main ### Опис -Це реалізує мультикоптерний регулятор швидкості. It takes rate setpoints (in acro mode +This implements the multicopter rate controller. It takes rate setpoints (in acro mode via `manual_control_setpoint` topic) as inputs and outputs actuator control messages. -Контролер має PID-цикл для компенсації похибки кутової швидкості. +The controller has a PID loop for angular rate error. - - -### Використання +### Usage {#mc_rate_control_usage} ``` mc_rate_control [arguments...] @@ -238,9 +220,9 @@ Source: [modules/navigator](https://github.com/PX4/PX4-Autopilot/tree/main/src/m ### Опис -Модуль відповідає за автономні режими польоту. Це включає місії (читайте з dataman), -взліт та RTL. -Він також відповідає за перевірку порушень геозони. +Module that is responsible for autonomous flight modes. This includes missions (read from dataman), +takeoff and RTL. +It is also responsible for geofence violation checking. ### Імплементація @@ -250,9 +232,7 @@ The member `_navigation_mode` contains the current active mode. Navigator publishes position setpoint triplets (`position_setpoint_triplet_s`), which are then used by the position controller. - - -### Використання +### Usage {#navigator_usage} ``` navigator [arguments...] @@ -276,9 +256,7 @@ Source: [modules/rover_ackermann](https://github.com/PX4/PX4-Autopilot/tree/main Rover ackermann module. - - -### Використання +### Usage {#rover_ackermann_usage} ``` rover_ackermann [arguments...] @@ -298,9 +276,7 @@ Source: [modules/rover_differential](https://github.com/PX4/PX4-Autopilot/tree/m Rover differential module. - - -### Використання +### Usage {#rover_differential_usage} ``` rover_differential [arguments...] @@ -320,9 +296,7 @@ Source: [modules/rover_mecanum](https://github.com/PX4/PX4-Autopilot/tree/main/s Rover mecanum module. - - -### Використання +### Usage {#rover_mecanum_usage} ``` rover_mecanum [arguments...] @@ -340,21 +314,21 @@ Source: [modules/rover_pos_control](https://github.com/PX4/PX4-Autopilot/tree/ma ### Опис -Контролює положення ровера за допомогою L1 контролера. +Controls the position of a ground rover using an L1 controller. Publishes `vehicle_thrust_setpoint (only in x) and vehicle_torque_setpoint (only yaw)` messages at IMU_GYRO_RATEMAX. ### Імплементація -Наразі ця реалізація підтримує лише декілька режимів: +Currently, this implementation supports only a few modes: -- Повна ручна: Throttle та yaw контроль передається безпосередньо на актуатори -- Автоматична місія: Ровер виконує місії -- Loiter: Ровер буде рухатися в межах радіусу очікування, а потім вимкне двигуни +- Full manual: Throttle and yaw controls are passed directly through to the actuators +- Auto mission: The rover runs missions +- Loiter: The rover will navigate to within the loiter radius, then stop the motors ### Приклади -Приклад використання CLI: +CLI usage example: ``` rover_pos_control start @@ -362,9 +336,7 @@ rover_pos_control status rover_pos_control stop ``` - - -### Використання +### Usage {#rover_pos_control_usage} ``` rover_pos_control [arguments...] @@ -387,9 +359,7 @@ It takes torque and thrust setpoints as inputs and outputs actuator setpoint messages. ``` - - -### Використання +### Usage {#spacecraft_usage} ``` spacecraft [arguments...] @@ -407,20 +377,20 @@ Source: [modules/uuv_att_control](https://github.com/PX4/PX4-Autopilot/tree/main ### Опис -Контролює положення безпілотного підводного апарату (UUV). +Controls the attitude of an unmanned underwater vehicle (UUV). Publishes `vehicle_thrust_setpont` and `vehicle_torque_setpoint` messages at a constant 250Hz. ### Імплементація -Наразі ця реалізація підтримує лише декілька режимів: +Currently, this implementation supports only a few modes: -- Повна ручна: Roll, pitch, yaw, та throttle контроль передається безпосередньо до актуаторів -- Автоматична місія: UUV виконує місії +- Full manual: Roll, pitch, yaw, and throttle controls are passed directly through to the actuators +- Auto mission: The uuv runs missions ### Приклади -Приклад використання CLI: +CLI usage example: ``` uuv_att_control start @@ -428,9 +398,7 @@ uuv_att_control status uuv_att_control stop ``` - - -### Використання +### Usage {#uuv_att_control_usage} ``` uuv_att_control [arguments...] @@ -448,19 +416,19 @@ Source: [modules/uuv_pos_control](https://github.com/PX4/PX4-Autopilot/tree/main ### Опис -Контролює положення безпілотного підводного апарату (UUV). +Controls the attitude of an unmanned underwater vehicle (UUV). Publishes `attitude_setpoint` messages. ### Імплементація -Наразі ця реалізація підтримує лише декілька режимів: +Currently, this implementation supports only a few modes: -- Повна ручна: Roll, pitch, yaw, та throttle контроль передається безпосередньо до актуаторів -- Автоматична місія: UUV виконує місії +- Full manual: Roll, pitch, yaw, and throttle controls are passed directly through to the actuators +- Auto mission: The uuv runs missions ### Приклади -Приклад використання CLI: +CLI usage example: ``` uuv_pos_control start @@ -468,9 +436,7 @@ uuv_pos_control status uuv_pos_control stop ``` - - -### Використання +### Usage {#uuv_pos_control_usage} ``` uuv_pos_control [arguments...] @@ -488,11 +454,9 @@ Source: [modules/vtol_att_control](https://github.com/PX4/PX4-Autopilot/tree/mai ### Опис -fw_att_control - регулятор положення фіксованого крила. +fw_att_control is the fixed wing attitude controller. - - -### Використання +### Usage {#vtol_att_control_usage} ``` vtol_att_control [arguments...] diff --git a/docs/uk/modules/modules_driver.md b/docs/uk/modules/modules_driver.md index 9542c16fc4..59002c651e 100644 --- a/docs/uk/modules/modules_driver.md +++ b/docs/uk/modules/modules_driver.md @@ -3,23 +3,22 @@ Підкатегорії: - [Airspeed Sensor](modules_driver_airspeed_sensor.md) -- [Transponder](modules_driver_transponder.md) -- [Imu](modules_driver_imu.md) -- [Rpm Sensor](modules_driver_rpm_sensor.md) -- [Magnetometer](modules_driver_magnetometer.md) +- [Baro](modules_driver_baro.md) - [Camera](modules_driver_camera.md) - [Distance Sensor](modules_driver_distance_sensor.md) -- [Optical Flow](modules_driver_optical_flow.md) +- [Imu](modules_driver_imu.md) - [Ins](modules_driver_ins.md) -- [Baro](modules_driver_baro.md) +- [Magnetometer](modules_driver_magnetometer.md) +- [Optical Flow](modules_driver_optical_flow.md) +- [Radio Control](modules_driver_radio_control.md) +- [Rpm Sensor](modules_driver_rpm_sensor.md) +- [Transponder](modules_driver_transponder.md) ## MCP23009 Source: [drivers/gpio/mcp23009](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/gpio/mcp23009) - - -### Використання +### Usage {#MCP23009_usage} ``` MCP23009 [arguments...] @@ -53,11 +52,9 @@ Source: [drivers/adc/board_adc](https://github.com/PX4/PX4-Autopilot/tree/main/s ### Опис -ADC драйвер. +ADC driver. - - -### Використання +### Usage {#adc_usage} ``` adc [arguments...] @@ -87,11 +84,9 @@ such as [PilotPi](../flight_controller/raspberry_pi_pilotpi.md) or [CUAV Nora](. It is enabled/disabled using the [ADC_ADS1115_EN](../advanced_config/parameter_reference.md#ADC_ADS1115_EN) parameter, and is disabled by default. -Якщо увімкнено, внутрішні ADC не використовуються. +If enabled, internal ADCs are not used. - - -### Використання +### Usage {#ads1115_usage} ``` ads1115 [arguments...] @@ -117,13 +112,11 @@ Source: [drivers/osd/atxxxx](https://github.com/PX4/PX4-Autopilot/tree/main/src/ ### Опис -Наприклад, OSD драйвер для мікросхеми ATXXXX, яка встановлена на платі OmnibusF4SD. +OSD driver for the ATXXXX chip that is mounted on the OmnibusF4SD board for example. -Його можна увімкнути за допомогою параметра OSD_ATXXXX_CFG. +It can be enabled with the OSD_ATXXXX_CFG parameter. - - -### Використання +### Usage {#atxxxx_usage} ``` atxxxx [arguments...] @@ -149,20 +142,18 @@ Source: [drivers/smart_battery/batmon](https://github.com/PX4/PX4-Autopilot/tree ### Опис -Драйвер для зв'язку SMBUS зі смарт-батареєю з підтримкою BatMon -Інформація про налаштування/використання: https://rotoye.com/batmon-tutorial/ +Driver for SMBUS Communication with BatMon enabled smart-battery +Setup/usage information: https://rotoye.com/batmon-tutorial/ ### Приклади -Почати з адреси 0x0B, на шині 4 +To start at address 0x0B, on bus 4 ``` batmon start -X -a 11 -b 4 ``` - - -### Використання +### Usage {#batmon_usage} ``` batmon [arguments...] @@ -194,19 +185,17 @@ Source: [drivers/batt_smbus](https://github.com/PX4/PX4-Autopilot/tree/main/src/ ### Опис -Розумний драйвер акумулятора для BQ40Z50 палива IC. +Smart battery driver for the BQ40Z50 fuel gauge IC. ### Приклади -Записати у прошивку для встановлення параметрів. address, number_of_bytes, byte0, ... , byteN +To write to flash to set parameters. address, number_of_bytes, byte0, ... , byteN ``` batt_smbus -X write_flash 19069 2 27 0 ``` - - -### Використання +### Usage {#batt_smbus_usage} ``` batt_smbus [arguments...] @@ -247,9 +236,7 @@ batt_smbus [arguments...] Source: [drivers/telemetry/bst](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/telemetry/bst) - - -### Використання +### Usage {#bst_usage} ``` bst [arguments...] @@ -269,62 +256,36 @@ bst [arguments...] status print status info ``` -## crsf_rc - -Source: [drivers/rc/crsf_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/crsf_rc) - -### Опис - -Цей модуль парсить uplink протокол CRSF RC і генерує дані CRSF downlink телеметрії - - - -### Використання - -``` -crsf_rc [arguments...] - Commands: - start - [-d ] RC device - values: , default: /dev/ttyS3 - - stop - - status print status info -``` - ## dshot Source: [drivers/dshot](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/dshot) ### Опис -Це драйвер виводу DShot. Він схожий на драйвер fmu і може бути використаний як заміна -використовувати DShot як протокол зв'язку ESC замість PWM. +This is the DShot output driver. It is similar to the fmu driver, and can be used as drop-in replacement +to use DShot as ESC communication protocol instead of PWM. -Під час запуску модуль намагається зайняти всі доступні піни для виходу DShot. -Він пропускає всі піни, які вже використовуються (наприклад, модулем запуску камери). +On startup, the module tries to occupy all available pins for DShot output. +It skips all pins already in use (e.g. by a camera trigger module). -Він підтримує: +It supports: - DShot150, DShot300, DShot600 -- телеметрія через окремий UART та публікація у вигляді повідомлення esc_status -- надсилання команд DShot через CLI +- telemetry via separate UART and publishing as esc_status message +- sending DShot commands via CLI ### Приклади -Постійно реверсує двигун 1: +Permanently reverse motor 1: ``` dshot reverse -m 1 dshot save -m 1 ``` -Після збереження змінений напрямок буде вважатися нормальним. Щоб розвернути назад, повторіть ті ж самі команди. +After saving, the reversed direction will be regarded as the normal one. So to reverse again repeat the same commands. - - -### Використання +### Usage {#dshot_usage} ``` dshot [arguments...] @@ -372,41 +333,13 @@ dshot [arguments...] status print status info ``` -## dsm_rc - -Source: [drivers/rc/dsm_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/dsm_rc) - -### Опис - -This module does Spektrum DSM RC input parsing. - - - -### Використання - -``` -dsm_rc [arguments...] - Commands: - start - [-d ] RC device - values: , default: /dev/ttyS3 - - bind Send a DSM bind command (module must be running) - - stop - - status print status info -``` - ## fake_gps Source: [examples/fake_gps](https://github.com/PX4/PX4-Autopilot/tree/main/src/examples/fake_gps) ### Опис - - -### Використання +### Usage {#fake_gps_usage} ``` fake_gps [arguments...] @@ -424,9 +357,7 @@ Source: [examples/fake_imu](https://github.com/PX4/PX4-Autopilot/tree/main/src/e ### Опис - - -### Використання +### Usage {#fake_imu_usage} ``` fake_imu [arguments...] @@ -445,11 +376,9 @@ Source: [examples/fake_magnetometer](https://github.com/PX4/PX4-Autopilot/tree/m ### Опис Publish the earth magnetic field as a fake magnetometer (sensor_mag). -Потребує vehicle_attitude та vehicle_gps_position. +Requires vehicle_attitude and vehicle_gps_position. - - -### Використання +### Usage {#fake_magnetometer_usage} ``` fake_magnetometer [arguments...] @@ -467,14 +396,14 @@ Source: [drivers/wind_sensor/ft_technologies](https://github.com/PX4/PX4-Autopil ### Опис -Драйвер послідовної шини для цифрового датчика вітру FT Technologies FT742. Цей драйвер потрібен для роботи разом з -з модулем передачі сигналу RS485 на UART. +Serial bus driver for the FT Technologies Digital Wind Sensor FT742. This driver is required to operate alongside +a RS485 to UART signal transfer module. -Більшість плат налаштовано на увімкнення/запуск драйвера на вказаному UART за допомогою параметра SENS_FTX_CFG. +Most boards are configured to enable/start the driver on a specified UART using the SENS_FTX_CFG parameter. ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` ft_technologies_serial start -d /dev/ttyS1 @@ -486,9 +415,7 @@ Stop driver ft_technologies_serial stop ``` - - -### Використання +### Usage {#ft_technologies_serial_usage} ``` ft_technologies_serial [arguments...] @@ -499,51 +426,26 @@ ft_technologies_serial [arguments...] stop Stop driver ``` -## ghst_rc - -Source: [drivers/rc/ghst_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/ghst_rc) - -### Опис - -This module does Ghost (GHST) RC input parsing. - - - -### Використання - -``` -ghst_rc [arguments...] - Commands: - start - [-d ] RC device - values: , default: /dev/ttyS3 - - stop - - status print status info -``` - ## gimbal Source: [modules/gimbal](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/gimbal) ### Опис -Водій керування монтажем / гімбалю. Він відображає кілька різних методів введення (наприклад, RC або MAVLink) на налаштований вивід (наприклад, AUX канали або MAVLink). +Mount/gimbal Gimbal control driver. It maps several different input methods (eg. RC or MAVLink) to a configured +output (eg. AUX channels or MAVLink). Documentation how to use it is on the [gimbal_control](https://docs.px4.io/main/en/advanced/gimbal_control.html) page. ### Приклади -Перевірте вихідні дані, встановивши кути (всі пропущені вісі установлені на 0): +Test the output by setting a angles (all omitted axes are set to 0): ``` gimbal test pitch -45 yaw 30 ``` - - -### Використання +### Usage {#gimbal_usage} ``` gimbal [arguments...] @@ -572,35 +474,33 @@ Source: [drivers/gps](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers ### Опис -Модуль GPS-драйвера, який здійснює зв'язок з пристроєм і публікує позицію через uORB. -Він підтримує кілька протоколів (постачальників пристроїв) і за замовчуванням автоматично вибирає правильний. +GPS driver module that handles the communication with the device and publishes the position via uORB. +It supports multiple protocols (device vendors) and by default automatically selects the correct one. -The module supports a secondary GPS device, specified via `-e` parameter. Позиція буде опублікована -на другому екземплярі теми uORB, але наразі вона не використовується рештою системи (однак -дані будуть зареєстровані, щоб їх можна було використовувати для порівняння). +The module supports a secondary GPS device, specified via `-e` parameter. The position will be published +on the second uORB topic instance, but it's currently not used by the rest of the system (however the +data will be logged, so that it can be used for comparisons). ### Імплементація -Для кожного пристрою існує потік, який опитує дані. Класи протоколу GPS реалізовано з функцією зворотного виклику -щоб їх можна було використовувати і в інших проектах (наприклад, QGroundControl також використовує їх). +There is a thread for each device polling for data. The GPS protocol classes are implemented with callbacks +so that they can be used in other projects as well (eg. QGroundControl uses them too). ### Приклади -Запуск 2 GPS-пристроїв (основний GPS на /dev/ttyS3 і додатковий на /dev/ttyS4): +Starting 2 GPS devices (the main GPS on /dev/ttyS3 and the secondary on /dev/ttyS4): ``` gps start -d /dev/ttyS3 -e /dev/ttyS4 ``` -Ініціюйте гарячий перезапуск GPS-пристрою +Initiate warm restart of GPS device ``` gps reset warm ``` - - -### Використання +### Usage {#gps_usage} ``` gps [arguments...] @@ -635,9 +535,7 @@ Source: [modules/simulation/gz_bridge](https://github.com/PX4/PX4-Autopilot/tree ### Опис - - -### Використання +### Usage {#gz_bridge_usage} ``` gz_bridge [arguments...] @@ -657,19 +555,18 @@ Source: [drivers/power_monitor/ina220](https://github.com/PX4/PX4-Autopilot/tree ### Опис -Драйвер для монітора живлення INA220. +Driver for the INA220 power monitor. -Кілька екземплярів цього драйвера можуть працювати одночасно, якщо кожен екземпляр має окрему адресу шини АБО I2C. +Multiple instances of this driver can run simultaneously, if each instance has a separate bus OR I2C address. -Наприклад, один екземпляр може працювати на шині 2, адреса 0x41, а інший - на шині 2, адреса 0x43. +For example, one instance can run on Bus 2, address 0x41, and one can run on Bus 2, address 0x43. -Якщо модуль INA220 не має живлення, то за замовчуванням ініціалізація драйвера не відбудеться. Щоб змінити це, використовуйте -прапор -f. Якщо цей прапорець встановлено, то у разі невдалої ініціалізації драйвер буде повторювати спроби ініціалізації -кожні 0.5 секунди. Якщо цей прапорець встановлено, ви можете підключити батарею після запуску драйвера, і він буде працювати. Якщо цей прапорець не встановлено, перед запуском драйвера необхідно підключити батарею. +If the INA220 module is not powered, then by default, initialization of the driver will fail. To change this, use +the -f flag. If this flag is set, then if initialization fails, the driver will keep trying to initialize again +every 0.5 seconds. With this flag set, you can plug in a battery after the driver starts, and it will work. Without +this flag set, the battery must be plugged in before starting the driver. - - -### Використання +### Usage {#ina220_usage} ``` ina220 [arguments...] @@ -700,19 +597,18 @@ Source: [drivers/power_monitor/ina226](https://github.com/PX4/PX4-Autopilot/tree ### Опис -Драйвер для монітора живлення INA226. +Driver for the INA226 power monitor. -Кілька екземплярів цього драйвера можуть працювати одночасно, якщо кожен екземпляр має окрему адресу шини АБО I2C. +Multiple instances of this driver can run simultaneously, if each instance has a separate bus OR I2C address. -Наприклад, один екземпляр може працювати на шині 2, адреса 0x41, а інший - на шині 2, адреса 0x43. +For example, one instance can run on Bus 2, address 0x41, and one can run on Bus 2, address 0x43. -Якщо модуль INA226 не живиться, то за замовчуванням ініціалізація драйвера не відбудеться. Щоб змінити це, використовуйте -прапор -f. Якщо цей прапорець встановлено, то у разі невдалої ініціалізації драйвер буде повторювати спроби ініціалізації -кожні 0.5 секунди. Якщо цей прапорець встановлено, ви можете підключити батарею після запуску драйвера, і він буде працювати. Якщо цей прапорець не встановлено, перед запуском драйвера необхідно підключити батарею. +If the INA226 module is not powered, then by default, initialization of the driver will fail. To change this, use +the -f flag. If this flag is set, then if initialization fails, the driver will keep trying to initialize again +every 0.5 seconds. With this flag set, you can plug in a battery after the driver starts, and it will work. Without +this flag set, the battery must be plugged in before starting the driver. - - -### Використання +### Usage {#ina226_usage} ``` ina226 [arguments...] @@ -741,19 +637,18 @@ Source: [drivers/power_monitor/ina228](https://github.com/PX4/PX4-Autopilot/tree ### Опис -Драйвер для монітора живлення INA228. +Driver for the INA228 power monitor. -Кілька екземплярів цього драйвера можуть працювати одночасно, якщо кожен екземпляр має окрему адресу шини АБО I2C. +Multiple instances of this driver can run simultaneously, if each instance has a separate bus OR I2C address. -Наприклад, один екземпляр може працювати на шині 2, адреса 0x41, а інший - на шині 2, адреса 0x43. +For example, one instance can run on Bus 2, address 0x45, and one can run on Bus 2, address 0x45. -Якщо модуль INA228 не має живлення, то за замовчуванням ініціалізація драйвера не відбудеться. Щоб змінити це, використовуйте -прапор -f. Якщо цей прапорець встановлено, то у разі невдалої ініціалізації драйвер буде повторювати спроби ініціалізації -кожні 0.5 секунди. Якщо цей прапорець встановлено, ви можете підключити батарею після запуску драйвера, і він буде працювати. Якщо цей прапорець не встановлено, перед запуском драйвера необхідно підключити батарею. +If the INA228 module is not powered, then by default, initialization of the driver will fail. To change this, use +the -f flag. If this flag is set, then if initialization fails, the driver will keep trying to initialize again +every 0.5 seconds. With this flag set, you can plug in a battery after the driver starts, and it will work. Without +this flag set, the battery must be plugged in before starting the driver. - - -### Використання +### Usage {#ina228_usage} ``` ina228 [arguments...] @@ -782,19 +677,18 @@ Source: [drivers/power_monitor/ina238](https://github.com/PX4/PX4-Autopilot/tree ### Опис -Драйвер для монітора потужності INA238. +Driver for the INA238 power monitor. -Кілька екземплярів цього драйвера можуть працювати одночасно, якщо кожен екземпляр має окрему адресу шини АБО I2C. +Multiple instances of this driver can run simultaneously, if each instance has a separate bus OR I2C address. -Наприклад, один екземпляр може працювати на шині 2, адреса 0x41, а інший - на шині 2, адреса 0x43. +For example, one instance can run on Bus 2, address 0x45, and one can run on Bus 2, address 0x45. -Якщо модуль INA238 не заснується, то за замовчуванням ініціалізація драйвера не вдасться. Щоб змінити це, використовуйте -прапор -f. Якщо цей прапорець встановлено, то у разі невдалої ініціалізації драйвер буде повторювати спроби ініціалізації -кожні 0.5 секунди. Якщо цей прапорець встановлено, ви можете підключити батарею після запуску драйвера, і він буде працювати. Якщо цей прапорець не встановлено, перед запуском драйвера необхідно підключити батарею. +If the INA238 module is not powered, then by default, initialization of the driver will fail. To change this, use +the -f flag. If this flag is set, then if initialization fails, the driver will keep trying to initialize again +every 0.5 seconds. With this flag set, you can plug in a battery after the driver starts, and it will work. Without +this flag set, the battery must be plugged in before starting the driver. - - -### Використання +### Usage {#ina238_usage} ``` ina238 [arguments...] @@ -823,13 +717,11 @@ Source: [drivers/telemetry/iridiumsbd](https://github.com/PX4/PX4-Autopilot/tree ### Опис -Драйвер IridiumSBD. +IridiumSBD driver. -Створює віртуальний послідовний порт, який інший модуль може використовувати для зв'язку (наприклад, mavlink). +Creates a virtual serial port that another module can use for communication (e.g. mavlink). - - -### Використання +### Usage {#iridiumsbd_usage} ``` iridiumsbd [arguments...] @@ -851,9 +743,7 @@ iridiumsbd [arguments...] Source: [drivers/irlock](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/irlock) - - -### Використання +### Usage {#irlock_usage} ``` irlock [arguments...] @@ -879,11 +769,9 @@ Source: [drivers/linux_pwm_out](https://github.com/PX4/PX4-Autopilot/tree/main/s ### Опис -Драйвер виведення Linux PWM з реалізацією бекенду специфічного для плати. +Linux PWM output driver with board-specific backend implementation. - - -### Використання +### Usage {#linux_pwm_out_usage} ``` linux_pwm_out [arguments...] @@ -899,9 +787,7 @@ linux_pwm_out [arguments...] Source: [drivers/magnetometer/lsm303agr](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/lsm303agr) - - -### Використання +### Usage {#lsm303agr_usage} ``` lsm303agr [arguments...] @@ -929,23 +815,21 @@ Source: [drivers/osd/msp_osd](https://github.com/PX4/PX4-Autopilot/tree/main/src ### Опис -Потік телеметрії MSP +MSP telemetry streamer ### Імплементація -Перетворює повідомлення uORB на пакети телеметрії MSP +Converts uORB messages to MSP telemetry packets ### Приклади -Приклад використання CLI: +CLI usage example: ``` msp_osd ``` - - -### Використання +### Usage {#msp_osd_usage} ``` msp_osd [arguments...] @@ -961,21 +845,19 @@ Source: [drivers/lights/neopixel](https://github.com/PX4/PX4-Autopilot/tree/main ### Опис -Цей модуль відповідає за взаємодію з Neopixel Serial LED +This module is responsible for driving interfasing to the Neopixel Serial LED ### Приклади -Зазвичай починається з: +It is typically started with: ``` neopixel -n 8 ``` -Привести всі доступні світлодіоди в дію. +To drive all available leds. - - -### Використання +### Usage {#newpixel_usage} ``` newpixel [arguments...] @@ -989,9 +871,7 @@ newpixel [arguments...] Source: [drivers/optical_flow/paa3905](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/optical_flow/paa3905) - - -### Використання +### Usage {#paa3905_usage} ``` paa3905 [arguments...] @@ -1017,9 +897,7 @@ paa3905 [arguments...] Source: [drivers/optical_flow/paw3902](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/optical_flow/paw3902) - - -### Використання +### Usage {#paw3902_usage} ``` paw3902 [arguments...] @@ -1047,25 +925,23 @@ Source: [drivers/pca9685_pwm_out](https://github.com/PX4/PX4-Autopilot/tree/main ### Опис -Це пристрій виводу керування PWM PCA9685. +This is a PCA9685 PWM output driver. -Він працює на робочій черзі I2C, яка є асинхронною з контрольною петлею FC, -витягує останній результат змішування та записує їх в PCA9685 у відповідних мітках планування. +It runs on I2C workqueue which is asynchronous with FC control loop, +fetching the latest mixing result and write them to PCA9685 at its scheduling ticks. -Воно може виконувати повний вихід 12 біт у режимі циклу керування, а також може виводити цінний ширину імпульсу -що може бути прийнято більшістю ESCs та серводвигунами. +It can do full 12bits output as duty-cycle mode, while also able to output precious pulse width +that can be accepted by most ESCs and servos. ### Приклади -Зазвичай починається з: +It is typically started with: ``` pca9685_pwm_out start -a 0x40 -b 1 ``` - - -### Використання +### Usage {#pca9685_pwm_out_usage} ``` pca9685_pwm_out [arguments...] @@ -1087,11 +963,9 @@ Source: [drivers/power_monitor/pm_selector_auterion](https://github.com/PX4/PX4- ### Опис -Драйвер для запуску та автоматичного виявлення різних датчиків потужності. +Driver for starting and auto-detecting different power monitors. - - -### Використання +### Usage {#pm_selector_auterion_usage} ``` pm_selector_auterion [arguments...] @@ -1107,9 +981,7 @@ pm_selector_auterion [arguments...] Source: [drivers/optical_flow/pmw3901](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/optical_flow/pmw3901) - - -### Використання +### Usage {#pmw3901_usage} ``` pmw3901 [arguments...] @@ -1137,11 +1009,9 @@ Source: [drivers/pps_capture](https://github.com/PX4/PX4-Autopilot/tree/main/src ### Опис -Це реалізує захоплення інформації PPS з модуля GNSS та розраховує відхилення між PPS та годинником реального часу. +This implements capturing PPS information from the GNSS module and calculates the drift between PPS and Real-time clock. - - -### Використання +### Usage {#pps_capture_usage} ``` pps_capture [arguments...] @@ -1159,13 +1029,11 @@ Source: [drivers/pwm_out](https://github.com/PX4/PX4-Autopilot/tree/main/src/dri ### Опис -Цей модуль відповідає за виведення пінів. Для плат без окремого IO-чіпа -(наприклад, Pixracer), використовуються головні канали. На платах з IO-чіпом (наприклад, Pixhawk) використовуються AUX-канали, а -для основних використовується драйвер px4io. +This module is responsible for driving the output pins. For boards without a separate IO chip +(eg. Pixracer), it uses the main channels. On boards with an IO chip (eg. Pixhawk), it uses the AUX channels, and the +px4io driver is used for main ones. - - -### Використання +### Usage {#pwm_out_usage} ``` pwm_out [arguments...] @@ -1183,17 +1051,15 @@ Source: [modules/simulation/pwm_out_sim](https://github.com/PX4/PX4-Autopilot/tr ### Опис -Драйвер для імітованих вихідних сигналів ШІМ. +Driver for simulated PWM outputs. Its only function is to take `actuator_control` uORB messages, mix them with any loaded mixer and output the result to the `actuator_output` uORB topic. -Воно використовується в SITL та HITL. +It is used in SITL and HITL. - - -### Використання +### Usage {#pwm_out_sim_usage} ``` pwm_out_sim [arguments...] @@ -1211,9 +1077,7 @@ pwm_out_sim [arguments...] Source: [drivers/optical_flow/px4flow](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/optical_flow/px4flow) - - -### Використання +### Usage {#px4flow_usage} ``` px4flow [arguments...] @@ -1239,11 +1103,9 @@ Source: [drivers/px4io](https://github.com/PX4/PX4-Autopilot/tree/main/src/drive ### Опис -Драйвер виводу, що зв'язується з вводовим ко-процесором. +Output driver communicating with the IO co-processor. - - -### Використання +### Usage {#px4io_usage} ``` px4io [arguments...] @@ -1277,46 +1139,11 @@ px4io [arguments...] status print status info ``` -## rc_input - -Source: [drivers/rc_input](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc_input) - -### Опис - -Цей модуль робить аналіз введення RC та автоматичний вибір методу. Підтримувані методи: - -- PPM -- SBUS -- DSM -- SUMD -- ST24 -- TBS Crossfire (CRSF) - - - -### Використання - -``` -rc_input [arguments...] - Commands: - start - [-d ] RC device - values: , default: /dev/ttyS3 - - bind Send a DSM bind command (module must be running) - - stop - - status print status info -``` - ## rgbled Source: [drivers/lights/rgbled_ncp5623c](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/lights/rgbled_ncp5623c) - - -### Використання +### Usage {#rgbled_usage} ``` rgbled [arguments...] @@ -1342,9 +1169,7 @@ rgbled [arguments...] Source: [drivers/lights/rgbled_is31fl3195](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/lights/rgbled_is31fl3195) - - -### Використання +### Usage {#rgbled_is31fl3195_usage} ``` rgbled_is31fl3195 [arguments...] @@ -1378,11 +1203,9 @@ Driver for [LP5562](https://www.ti.com/product/LP5562) LED driver connected via This used in some GPS modules by Holybro for [PX4 status notification](../getting_started/led_meanings.md) -Водій включений за замовчуванням у вбудованому програмному забезпеченні (ключ KConfig DRIVERS_LIGHTS_RGBLED_LP5562) і завжди увімкнено. +The driver is included by default in firmware (KConfig key DRIVERS_LIGHTS_RGBLED_LP5562) and is always enabled. - - -### Використання +### Usage {#rgbled_lp5562_usage} ``` rgbled_lp5562 [arguments...] @@ -1411,21 +1234,19 @@ Source: [drivers/roboclaw](https://github.com/PX4/PX4-Autopilot/tree/main/src/dr ### Опис This driver communicates over UART with the [Roboclaw motor driver](https://www.basicmicro.com/motor-controller). -Вона виконує дві задачі: +It performs two tasks: -- Контролюйте двигуни на основі інтерфейсу виведення. +- Control the motors based on the OutputModuleInterface. - Read the wheel encoders and publish the raw data in the `wheel_encoders` uORB topic -Для використання цього драйвера Roboclaw повинен бути переведений у режим Packet Serial (див. документацію за посиланням), а -UART-порт вашого контролера польоту повинен бути підключений до Roboclaw, як показано в документації. +In order to use this driver, the Roboclaw should be put into Packet Serial mode (see the linked documentation), and +your flight controller's UART port should be connected to the Roboclaw as shown in the documentation. The driver needs to be enabled using the parameter `RBCLW_SER_CFG`, the baudrate needs to be set correctly and the address `RBCLW_ADDRESS` needs to match the ESC configuration. The command to start this driver is: `$ roboclaw start ` - - -### Використання +### Usage {#roboclaw_usage} ``` roboclaw [arguments...] @@ -1441,9 +1262,7 @@ roboclaw [arguments...] Source: [drivers/rpm_capture](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rpm_capture) - - -### Використання +### Usage {#rpm_capture_usage} ``` rpm_capture [arguments...] @@ -1461,12 +1280,10 @@ Source: [drivers/safety_button](https://github.com/PX4/PX4-Autopilot/tree/main/s ### Опис -Цей модуль відповідає за кнопку безпеки. -Натискання кнопки безпеки 3 рази швидко спричинить запит на синхронізацію GCS. +This module is responsible for the safety button. +Pressing the safety button 3 times quickly will trigger a GCS pairing request. - - -### Використання +### Usage {#safety_button_usage} ``` safety_button [arguments...] @@ -1478,30 +1295,6 @@ safety_button [arguments...] status print status info ``` -## sbus_rc - -Source: [drivers/rc/sbus_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/sbus_rc) - -### Опис - -This module does SBUS RC input parsing. - - - -### Використання - -``` -sbus_rc [arguments...] - Commands: - start - [-d ] RC device - values: , default: /dev/ttyS3 - - stop - - status print status info -``` - ## septentrio Source: [drivers/gnss/septentrio](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/gnss/septentrio) @@ -1535,9 +1328,7 @@ Perform warm reset of the receivers: gps reset warm ``` - - -### Використання +### Usage {#septentrio_usage} ``` septentrio [arguments...] @@ -1566,39 +1357,37 @@ Source: [drivers/hygrometer/sht3x](https://github.com/PX4/PX4-Autopilot/tree/mai ### Опис -Драйвер датчика температури і вологості SHT3x від Senserion. +SHT3x Temperature and Humidity Sensor Driver by Senserion. ### Приклади -Приклад використання CLI: +CLI usage example: ``` sht3x start -X ``` -Запустіть драйвер датчика на зовнішньому шині +Start the sensor driver on the external bus ``` sht3x status ``` -Статус драйвера друку +Print driver status ``` sht3x values ``` -Друкувати останні виміряні значення +Print last measured values ``` sht3x reset ``` -Ініціалізувати датчик, скинути прапорці +Reinitialize senzor, reset flags - - -### Використання +### Usage {#sht3x_usage} ``` sht3x [arguments...] @@ -1629,23 +1418,23 @@ Source: [drivers/tap_esc](https://github.com/PX4/PX4-Autopilot/tree/main/src/dri ### Опис -Цей модуль керує апаратним забезпеченням TAP_ESC через UART. Він слухає теми управління дією, робить змішування та записує вихідні ШІМ сигнали. +This module controls the TAP_ESC hardware via UART. It listens on the +actuator_controls topics, does the mixing and writes the PWM outputs. ### Імплементація -На даний момент модуль реалізований лише у вигляді версії з потоками, що означає, що він працює у власному потоці, а не в черзі завдань. +Currently the module is implemented as a threaded version only, meaning that it +runs in its own thread instead of on the work queue. -### Приклад +### Example -Модуль зазвичай починається з: +The module is typically started with: ``` tap_esc start -d /dev/ttyS2 -n <1-8> ``` - - -### Використання +### Usage {#tap_esc_usage} ``` tap_esc [arguments...] @@ -1663,11 +1452,9 @@ Source: [drivers/tone_alarm](https://github.com/PX4/PX4-Autopilot/tree/main/src/ ### Опис -Цей модуль відповідає за сигнал тривоги. +This module is responsible for the tone alarm. - - -### Використання +### Usage {#tone_alarm_usage} ``` tone_alarm [arguments...] @@ -1685,20 +1472,18 @@ Source: [drivers/uwb/uwb_sr150](https://github.com/PX4/PX4-Autopilot/tree/main/s ### Опис -Драйвер для системи позиціонування NXP UWB_SR150 UWB. This driver publishes a `uwb_distance` message +Driver for NXP UWB_SR150 UWB positioning system. This driver publishes a `uwb_distance` message whenever the UWB_SR150 has a position measurement available. -### Приклад +### Example -Запустіть драйвер з вказаним пристроєм: +Start the driver with a given device: ``` uwb start -d /dev/ttyS2 ``` - - -### Використання +### Usage {#uwb_usage} ``` uwb [arguments...] @@ -1718,9 +1503,7 @@ uwb [arguments...] Source: [drivers/actuators/vertiq_io](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/actuators/vertiq_io) - - -### Використання +### Usage {#vertiq_io_usage} ``` vertiq_io [arguments...] @@ -1739,13 +1522,11 @@ Source: [drivers/voxl2_io](https://github.com/PX4/PX4-Autopilot/tree/main/src/dr ### Опис -Цей модуль відповідає за виведення пінів. Для плат без окремого IO-чіпа -(наприклад, Pixracer), використовуються головні канали. На платах з IO-чіпом (наприклад, Pixhawk) використовуються AUX-канали, а -для основних використовується драйвер px4io. +This module is responsible for driving the output pins. For boards without a separate IO chip +(eg. Pixracer), it uses the main channels. On boards with an IO chip (eg. Pixhawk), it uses the AUX channels, and the +px4io driver is used for main ones. - - -### Використання +### Usage {#voxl2_io_usage} ``` voxl2_io [arguments...] @@ -1771,23 +1552,21 @@ Source: [drivers/actuators/voxl_esc](https://github.com/PX4/PX4-Autopilot/tree/m ### Опис -Цей модуль відповідає за кнопку безпеки... +This module is responsible for... ### Імплементація -За замовчуванням модуль працює в черзі роботи з зворотнім викликом за темою управління актуаторами uORB. +By default the module runs on a work queue with a callback on the uORB actuator_controls topic. ### Приклади -Зазвичай починається з: +It is typically started with: ``` todo ``` - - -### Використання +### Usage {#voxl_esc_usage} ``` voxl_esc [arguments...] @@ -1834,9 +1613,7 @@ voxl_esc [arguments...] Source: [drivers/power_monitor/voxlpm](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/power_monitor/voxlpm) - - -### Використання +### Usage {#voxlpm_usage} ``` voxlpm [arguments...] @@ -1866,9 +1643,7 @@ Source: [modules/zenoh](https://github.com/PX4/PX4-Autopilot/tree/main/src/modul Zenoh demo bridge - - -### Використання +### Usage {#zenoh_usage} ``` zenoh [arguments...] diff --git a/docs/uk/modules/modules_driver_airspeed_sensor.md b/docs/uk/modules/modules_driver_airspeed_sensor.md index b79118e323..b8a1c7a92d 100644 --- a/docs/uk/modules/modules_driver_airspeed_sensor.md +++ b/docs/uk/modules/modules_driver_airspeed_sensor.md @@ -13,9 +13,7 @@ TE підключається через I2C. or in default.px4board with adding the line: "CONFIG_DRIVERS_DIFFERENTIAL_PRESSURE_ASP5033=y" It can be enabled with the "SENS_EN_ASP5033" parameter set to 1. - - -### Використання +### Usage {#asp5033_usage} ``` asp5033 [arguments...] @@ -39,9 +37,7 @@ asp5033 [arguments...] Source: [drivers/differential_pressure/auav](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/differential_pressure/auav) - - -### Використання +### Usage {#auav_usage} ``` auav [arguments...] @@ -67,9 +63,7 @@ auav [arguments...] Source: [drivers/differential_pressure/ets](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/differential_pressure/ets) - - -### Використання +### Usage {#ets_airspeed_usage} ``` ets_airspeed [arguments...] @@ -93,9 +87,7 @@ ets_airspeed [arguments...] Source: [drivers/differential_pressure/ms4515](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/differential_pressure/ms4515) - - -### Використання +### Usage {#ms4515_usage} ``` ms4515 [arguments...] @@ -119,9 +111,7 @@ ms4515 [arguments...] Source: [drivers/differential_pressure/ms4525do](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/differential_pressure/ms4525do) - - -### Використання +### Usage {#ms4525do_usage} ``` ms4525do [arguments...] @@ -145,9 +135,7 @@ ms4525do [arguments...] Source: [drivers/differential_pressure/ms5525dso](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/differential_pressure/ms5525dso) - - -### Використання +### Usage {#ms5525dso_usage} ``` ms5525dso [arguments...] @@ -171,9 +159,7 @@ ms5525dso [arguments...] Source: [drivers/differential_pressure/sdp3x](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/differential_pressure/sdp3x) - - -### Використання +### Usage {#sdp3x_usage} ``` sdp3x [arguments...] diff --git a/docs/uk/modules/modules_driver_baro.md b/docs/uk/modules/modules_driver_baro.md index ebb42a90ee..8d2a83f4f3 100644 --- a/docs/uk/modules/modules_driver_baro.md +++ b/docs/uk/modules/modules_driver_baro.md @@ -4,9 +4,7 @@ Source: [drivers/barometer/bmp280](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/bmp280) - - -### Використання +### Usage {#bmp280_usage} ``` bmp280 [arguments...] @@ -42,9 +40,7 @@ bmp280 [arguments...] Source: [drivers/barometer/bmp388](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/bmp388) - - -### Використання +### Usage {#bmp388_usage} ``` bmp388 [arguments...] @@ -72,9 +68,7 @@ bmp388 [arguments...] Source: [drivers/barometer/bmp581](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/bmp581) - - -### Використання +### Usage {#bmp581_usage} ``` bmp581 [arguments...] @@ -102,9 +96,7 @@ bmp581 [arguments...] Source: [drivers/barometer/dps310](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/dps310) - - -### Використання +### Usage {#dps310_usage} ``` dps310 [arguments...] @@ -140,9 +132,7 @@ dps310 [arguments...] Source: [drivers/barometer/invensense/icp101xx](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/invensense/icp101xx) - - -### Використання +### Usage {#icp101xx_usage} ``` icp101xx [arguments...] @@ -166,9 +156,7 @@ icp101xx [arguments...] Source: [drivers/barometer/invensense/icp201xx](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/invensense/icp201xx) - - -### Використання +### Usage {#icp201xx_usage} ``` icp201xx [arguments...] @@ -192,9 +180,7 @@ icp201xx [arguments...] Source: [drivers/barometer/lps22hb](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/lps22hb) - - -### Використання +### Usage {#lps22hb_usage} ``` lps22hb [arguments...] @@ -220,9 +206,7 @@ lps22hb [arguments...] Source: [drivers/barometer/lps25h](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/lps25h) - - -### Використання +### Usage {#lps25h_usage} ``` lps25h [arguments...] @@ -248,9 +232,7 @@ lps25h [arguments...] Source: [drivers/barometer/lps33hw](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/lps33hw) - - -### Використання +### Usage {#lps33hw_usage} ``` lps33hw [arguments...] @@ -279,9 +261,7 @@ lps33hw [arguments...] Source: [drivers/barometer/maiertek/mpc2520](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/maiertek/mpc2520) - - -### Використання +### Usage {#mpc2520_usage} ``` mpc2520 [arguments...] @@ -305,9 +285,7 @@ mpc2520 [arguments...] Source: [drivers/barometer/mpl3115a2](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/mpl3115a2) - - -### Використання +### Usage {#mpl3115a2_usage} ``` mpl3115a2 [arguments...] @@ -331,9 +309,7 @@ mpl3115a2 [arguments...] Source: [drivers/barometer/ms5611](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/ms5611) - - -### Використання +### Usage {#ms5611_usage} ``` ms5611 [arguments...] @@ -369,9 +345,7 @@ ms5611 [arguments...] Source: [drivers/barometer/ms5837](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/ms5837) - - -### Використання +### Usage {#ms5837_usage} ``` ms5837 [arguments...] @@ -393,9 +367,7 @@ ms5837 [arguments...] Source: [drivers/barometer/goertek/spa06](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/goertek/spa06) - - -### Використання +### Usage {#spa06_usage} ``` spa06 [arguments...] @@ -431,9 +403,7 @@ spa06 [arguments...] Source: [drivers/barometer/goertek/spl06](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer/goertek/spl06) - - -### Використання +### Usage {#spl06_usage} ``` spl06 [arguments...] diff --git a/docs/uk/modules/modules_driver_camera.md b/docs/uk/modules/modules_driver_camera.md index bc558b51a6..b7afb329ba 100644 --- a/docs/uk/modules/modules_driver_camera.md +++ b/docs/uk/modules/modules_driver_camera.md @@ -34,9 +34,7 @@ The driver is configured using [Camera Trigger parameters](../advanced_config/pa [Setup/usage information](../camera/index.md). - - -### Використання +### Usage {#camera_trigger_usage} ``` camera_trigger [arguments...] diff --git a/docs/uk/modules/modules_driver_distance_sensor.md b/docs/uk/modules/modules_driver_distance_sensor.md index 830d0bd8c1..2901b4afc1 100644 --- a/docs/uk/modules/modules_driver_distance_sensor.md +++ b/docs/uk/modules/modules_driver_distance_sensor.md @@ -10,7 +10,7 @@ Source: [drivers/distance_sensor/broadcom/afbrs50](https://github.com/PX4/PX4-Au ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` afbrs50 start @@ -22,9 +22,7 @@ Stop driver afbrs50 stop ``` - - -### Використання +### Usage {#afbrs50_usage} ``` afbrs50 [arguments...] @@ -43,9 +41,7 @@ afbrs50 [arguments...] Source: [drivers/distance_sensor/gy_us42](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/distance_sensor/gy_us42) - - -### Використання +### Usage {#gy_us42_usage} ``` gy_us42 [arguments...] @@ -71,15 +67,15 @@ Source: [drivers/distance_sensor/leddar_one](https://github.com/PX4/PX4-Autopilo ### Опис -Драйвер послідовної шини для LiDAR LeddarOne. +Serial bus driver for the LeddarOne LiDAR. -Більшість плат налаштовано на ввімкнення/запуск драйвера на вказаному UART за допомогою параметра SENS_LEDDAR1_CFG. +Most boards are configured to enable/start the driver on a specified UART using the SENS_LEDDAR1_CFG parameter. -Інформація про налаштування/використання: https://docs.px4.io/main/en/sensor/leddar_one.html +Setup/usage information: https://docs.px4.io/main/en/sensor/leddar_one.html ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` leddar_one start -d /dev/ttyS1 @@ -91,9 +87,7 @@ Stop driver leddar_one stop ``` - - -### Використання +### Usage {#leddar_one_usage} ``` leddar_one [arguments...] @@ -112,13 +106,11 @@ Source: [drivers/distance_sensor/lightware_laser_i2c](https://github.com/PX4/PX4 ### Опис -Драйвер шини I2C для LIDAR-далекомірів Lightware серії SFxx: SF10/a, SF10/b, SF10/c, SF11/c, SF/LW20. +I2C bus driver for Lightware SFxx series LIDAR rangefinders: SF10/a, SF10/b, SF10/c, SF11/c, SF/LW20. -Інформація про налаштування/використання: https://docs.px4.io/main/en/sensor/sfxx_lidar.html +Setup/usage information: https://docs.px4.io/main/en/sensor/sfxx_lidar.html - - -### Використання +### Usage {#lightware_laser_i2c_usage} ``` lightware_laser_i2c [arguments...] @@ -146,15 +138,15 @@ Source: [drivers/distance_sensor/lightware_laser_serial](https://github.com/PX4/ ### Опис -Драйвер послідовної шини для лазерних далекомірів LightWare SF02/F, SF10/a, SF10/b, SF10/c, SF11/c. +Serial bus driver for the LightWare SF02/F, SF10/a, SF10/b, SF10/c, SF11/c Laser rangefinders. -Більшість плат налаштовано на увімкнення/запуск драйвера на вказаному UART за допомогою параметра SENS_SF0X_CFG. +Most boards are configured to enable/start the driver on a specified UART using the SENS_SF0X_CFG parameter. -Інформація про налаштування/використання: https://docs.px4.io/main/en/sensor/sfxx_lidar.html +Setup/usage information: https://docs.px4.io/main/en/sensor/sfxx_lidar.html ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` lightware_laser_serial start -d /dev/ttyS1 @@ -166,9 +158,7 @@ Stop driver lightware_laser_serial stop ``` - - -### Використання +### Usage {#lightware_laser_serial_usage} ``` lightware_laser_serial [arguments...] @@ -187,11 +177,11 @@ Source: [drivers/distance_sensor/lightware_sf45_serial](https://github.com/PX4/P ### Опис -Драйвер послідовної шини для лазерного далекоміра Lightware SF45/b. +Serial bus driver for the Lightware SF45/b Laser rangefinder. ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` lightware_sf45_serial start -d /dev/ttyS1 @@ -203,9 +193,7 @@ Stop driver lightware_sf45_serial stop ``` - - -### Використання +### Usage {#lightware_sf45_serial_usage} ``` lightware_sf45_serial [arguments...] @@ -224,13 +212,11 @@ Source: [drivers/distance_sensor/ll40ls_pwm](https://github.com/PX4/PX4-Autopilo PWM driver for LidarLite rangefinders. -Датчик/драйвер має бути увімкнений за допомогою параметра SENS_EN_LL40LS. +The sensor/driver must be enabled using the parameter SENS_EN_LL40LS. -Інформація про налаштування/використання: https://docs.px4.io/main/en/sensor/lidar_lite.html +Setup/usage information: https://docs.px4.io/main/en/sensor/lidar_lite.html - - -### Використання +### Usage {#ll40ls_usage} ``` ll40ls [arguments...] @@ -248,9 +234,7 @@ ll40ls [arguments...] Source: [drivers/distance_sensor/mappydot](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/distance_sensor/mappydot) - - -### Використання +### Usage {#mappydot_usage} ``` mappydot [arguments...] @@ -272,9 +256,7 @@ mappydot [arguments...] Source: [drivers/distance_sensor/mb12xx](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/distance_sensor/mb12xx) - - -### Використання +### Usage {#mb12xx_usage} ``` mb12xx [arguments...] @@ -302,19 +284,17 @@ Source: [drivers/distance_sensor/pga460](https://github.com/PX4/PX4-Autopilot/tr ### Опис -Драйвер ультразвукового далекоміра, який здійснює зв'язок з пристроєм і публікує відстань через uORB. +Ultrasonic range finder driver that handles the communication with the device and publishes the distance via uORB. ### Імплементація -Цей драйвер реалізовано як завдання NuttX. Ця реалізація була обрана через необхідність опитування на повідомлення -через UART, що не підтримується у work_queue. Цей драйвер безперервно вимірює дальність коли він -працює. На рівні драйверів реалізовано простий алгоритм виявлення хибних показань, що має на меті покращити -якість даних, що публікуються. Драйвер взагалі не публікуватиме дані, якщо вважатиме, що дані датчика -недійсними або нестабільними. +This driver is implemented as a NuttX task. This Implementation was chosen due to the need for polling on a message +via UART, which is not supported in the work_queue. This driver continuously takes range measurements while it is +running. A simple algorithm to detect false readings is implemented at the driver levelin an attemptto improve +the quality of data that is being published. The driver will not publish data at all if it deems the sensor data +to be invalid or unstable. - - -### Використання +### Usage {#pga460_usage} ``` pga460 [arguments...] @@ -333,9 +313,7 @@ pga460 [arguments...] Source: [drivers/distance_sensor/srf02](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/distance_sensor/srf02) - - -### Використання +### Usage {#srf02_usage} ``` srf02 [arguments...] @@ -363,13 +341,11 @@ Source: [drivers/distance_sensor/srf05](https://github.com/PX4/PX4-Autopilot/tre ### Опис -Драйвер для далекомірів HY-SRF05 / HC-SR05 та HC-SR04. +Driver for HY-SRF05 / HC-SR05 and HC-SR04 rangefinders. -Датчик/драйвер потрібно увімкнути за допомогою параметра SENS_EN_HXSRX0X. +The sensor/driver must be enabled using the parameter SENS_EN_HXSRX0X. - - -### Використання +### Usage {#srf05_usage} ``` srf05 [arguments...] @@ -393,15 +369,13 @@ Source: [drivers/distance_sensor/teraranger](https://github.com/PX4/PX4-Autopilo ### Опис -Драйвер шини I2C для далекомірів TeraRanger. +I2C bus driver for TeraRanger rangefinders. -Датчик/драйвер має бути увімкнений за допомогою параметра SENS_EN_TRANGER. +The sensor/driver must be enabled using the parameter SENS_EN_TRANGER. -Інформація про налаштування/використання: https://docs.px4.io/main/en/sensor/rangefinders.html#teraranger-rangefinders +Setup/usage information: https://docs.px4.io/main/en/sensor/rangefinders.html#teraranger-rangefinders - - -### Використання +### Usage {#teraranger_usage} ``` teraranger [arguments...] @@ -427,9 +401,7 @@ teraranger [arguments...] Source: [drivers/distance_sensor/tf02pro](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/distance_sensor/tf02pro) - - -### Використання +### Usage {#tf02pro_usage} ``` tf02pro [arguments...] @@ -457,15 +429,15 @@ Source: [drivers/distance_sensor/tfmini](https://github.com/PX4/PX4-Autopilot/tr ### Опис -Серійний драйвер шини для Benewake TFmini LiDAR. +Serial bus driver for the Benewake TFmini LiDAR. -Більшість плат налаштовано на ввімкнення/вимкнення драйвера на вказаному UART за допомогою параметра SENS_TFMINI_CFG. +Most boards are configured to enable/start the driver on a specified UART using the SENS_TFMINI_CFG parameter. -Інформація про налаштування/використання: https://docs.px4.io/main/en/sensor/tfmini.html +Setup/usage information: https://docs.px4.io/main/en/sensor/tfmini.html ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` tfmini start -d /dev/ttyS1 @@ -477,9 +449,7 @@ Stop driver tfmini stop ``` - - -### Використання +### Usage {#tfmini_usage} ``` tfmini [arguments...] @@ -502,13 +472,13 @@ Source: [drivers/distance_sensor/ulanding_radar](https://github.com/PX4/PX4-Auto ### Опис -Серійний драйвер шини для радара Aerotenna uLanding. +Serial bus driver for the Aerotenna uLanding radar. Setup/usage information: https://docs.px4.io/main/en/sensor/ulanding_radar.html ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` ulanding_radar start -d /dev/ttyS1 @@ -520,9 +490,7 @@ Stop driver ulanding_radar stop ``` - - -### Використання +### Usage {#ulanding_radar_usage} ``` ulanding_radar [arguments...] @@ -540,9 +508,7 @@ ulanding_radar [arguments...] Source: [drivers/distance_sensor/vl53l0x](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/distance_sensor/vl53l0x) - - -### Використання +### Usage {#vl53l0x_usage} ``` vl53l0x [arguments...] @@ -568,9 +534,7 @@ vl53l0x [arguments...] Source: [drivers/distance_sensor/vl53l1x](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/distance_sensor/vl53l1x) - - -### Використання +### Usage {#vl53l1x_usage} ``` vl53l1x [arguments...] diff --git a/docs/uk/modules/modules_driver_imu.md b/docs/uk/modules/modules_driver_imu.md index e3a738693a..ed5da8d8ea 100644 --- a/docs/uk/modules/modules_driver_imu.md +++ b/docs/uk/modules/modules_driver_imu.md @@ -4,9 +4,7 @@ Source: [drivers/imu/analog_devices/adis16448](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/analog_devices/adis16448) - - -### Використання +### Usage {#adis16448_usage} ``` adis16448 [arguments...] @@ -32,9 +30,7 @@ adis16448 [arguments...] Source: [drivers/imu/analog_devices/adis16470](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/analog_devices/adis16470) - - -### Використання +### Usage {#adis16470_usage} ``` adis16470 [arguments...] @@ -60,9 +56,7 @@ adis16470 [arguments...] Source: [drivers/imu/analog_devices/adis16477](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/analog_devices/adis16477) - - -### Використання +### Usage {#adis16477_usage} ``` adis16477 [arguments...] @@ -88,9 +82,7 @@ adis16477 [arguments...] Source: [drivers/imu/analog_devices/adis16497](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/analog_devices/adis16497) - - -### Використання +### Usage {#adis16497_usage} ``` adis16497 [arguments...] @@ -116,9 +108,7 @@ adis16497 [arguments...] Source: [drivers/imu/analog_devices/adis16507](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/analog_devices/adis16507) - - -### Використання +### Usage {#adis16507_usage} ``` adis16507 [arguments...] @@ -144,9 +134,7 @@ adis16507 [arguments...] Source: [drivers/imu/bosch/bmi055](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/bosch/bmi055) - - -### Використання +### Usage {#bmi055_usage} ``` bmi055 [arguments...] @@ -174,9 +162,7 @@ bmi055 [arguments...] Source: [drivers/imu/bosch/bmi085](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/bosch/bmi085) - - -### Використання +### Usage {#bmi085_usage} ``` bmi085 [arguments...] @@ -204,9 +190,7 @@ bmi085 [arguments...] Source: [drivers/imu/bosch/bmi088](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/bosch/bmi088) - - -### Використання +### Usage {#bmi088_usage} ``` bmi088 [arguments...] @@ -234,9 +218,7 @@ bmi088 [arguments...] Source: [drivers/imu/bosch/bmi088_i2c](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/bosch/bmi088_i2c) - - -### Використання +### Usage {#bmi088_i2c_usage} ``` bmi088_i2c [arguments...] @@ -264,9 +246,7 @@ bmi088_i2c [arguments...] Source: [drivers/imu/bosch/bmi270](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/bosch/bmi270) - - -### Використання +### Usage {#bmi270_usage} ``` bmi270 [arguments...] @@ -292,9 +272,7 @@ bmi270 [arguments...] Source: [drivers/imu/nxp/fxas21002c](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/nxp/fxas21002c) - - -### Використання +### Usage {#fxas21002c_usage} ``` fxas21002c [arguments...] @@ -328,9 +306,7 @@ fxas21002c [arguments...] Source: [drivers/imu/nxp/fxos8701cq](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/nxp/fxos8701cq) - - -### Використання +### Usage {#fxos8701cq_usage} ``` fxos8701cq [arguments...] @@ -364,9 +340,7 @@ fxos8701cq [arguments...] Source: [drivers/imu/invensense/iam20680hp](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/iam20680hp) - - -### Використання +### Usage {#iam20680hp_usage} ``` iam20680hp [arguments...] @@ -392,9 +366,7 @@ iam20680hp [arguments...] Source: [drivers/imu/invensense/icm20602](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm20602) - - -### Використання +### Usage {#icm20602_usage} ``` icm20602 [arguments...] @@ -420,9 +392,7 @@ icm20602 [arguments...] Source: [drivers/imu/invensense/icm20608g](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm20608g) - - -### Використання +### Usage {#icm20608g_usage} ``` icm20608g [arguments...] @@ -448,9 +418,7 @@ icm20608g [arguments...] Source: [drivers/imu/invensense/icm20649](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm20649) - - -### Використання +### Usage {#icm20649_usage} ``` icm20649 [arguments...] @@ -476,9 +444,7 @@ icm20649 [arguments...] Source: [drivers/imu/invensense/icm20689](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm20689) - - -### Використання +### Usage {#icm20689_usage} ``` icm20689 [arguments...] @@ -504,9 +470,7 @@ icm20689 [arguments...] Source: [drivers/imu/invensense/icm20948](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm20948) - - -### Використання +### Usage {#icm20948_usage} ``` icm20948 [arguments...] @@ -533,9 +497,7 @@ icm20948 [arguments...] Source: [drivers/imu/invensense/icm20948](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm20948) - - -### Використання +### Usage {#icm20948_i2c_passthrough_usage} ``` icm20948_i2c_passthrough [arguments...] @@ -559,9 +521,7 @@ icm20948_i2c_passthrough [arguments...] Source: [drivers/imu/invensense/icm40609d](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm40609d) - - -### Використання +### Usage {#icm40609d_usage} ``` icm40609d [arguments...] @@ -587,9 +547,7 @@ icm40609d [arguments...] Source: [drivers/imu/invensense/icm42605](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm42605) - - -### Використання +### Usage {#icm42605_usage} ``` icm42605 [arguments...] @@ -615,9 +573,7 @@ icm42605 [arguments...] Source: [drivers/imu/invensense/icm42670p](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm42670p) - - -### Використання +### Usage {#icm42670p_usage} ``` icm42670p [arguments...] @@ -643,9 +599,7 @@ icm42670p [arguments...] Source: [drivers/imu/invensense/icm42688p](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm42688p) - - -### Використання +### Usage {#icm42688p_usage} ``` icm42688p [arguments...] @@ -674,9 +628,7 @@ icm42688p [arguments...] Source: [drivers/imu/invensense/icm45686](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/icm45686) - - -### Використання +### Usage {#icm45686_usage} ``` icm45686 [arguments...] @@ -704,9 +656,7 @@ icm45686 [arguments...] Source: [drivers/imu/invensense/iim42652](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/iim42652) - - -### Використання +### Usage {#iim42652_usage} ``` iim42652 [arguments...] @@ -734,9 +684,7 @@ iim42652 [arguments...] Source: [drivers/imu/invensense/iim42653](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/iim42653) - - -### Використання +### Usage {#iim42653_usage} ``` iim42653 [arguments...] @@ -764,9 +712,7 @@ iim42653 [arguments...] Source: [drivers/imu/st/l3gd20](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/st/l3gd20) - - -### Використання +### Usage {#l3gd20_usage} ``` l3gd20 [arguments...] @@ -796,9 +742,7 @@ l3gd20 [arguments...] Source: [drivers/imu/st/lsm303d](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/st/lsm303d) - - -### Використання +### Usage {#lsm303d_usage} ``` lsm303d [arguments...] @@ -824,9 +768,7 @@ lsm303d [arguments...] Source: [drivers/imu/st/lsm9ds1](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/st/lsm9ds1) - - -### Використання +### Usage {#lsm9ds1_usage} ``` lsm9ds1 [arguments...] @@ -852,9 +794,7 @@ lsm9ds1 [arguments...] Source: [drivers/imu/invensense/mpu6000](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/mpu6000) - - -### Використання +### Usage {#mpu6000_usage} ``` mpu6000 [arguments...] @@ -880,9 +820,7 @@ mpu6000 [arguments...] Source: [drivers/imu/invensense/mpu9250](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/mpu9250) - - -### Використання +### Usage {#mpu9250_usage} ``` mpu9250 [arguments...] @@ -909,9 +847,7 @@ mpu9250 [arguments...] Source: [drivers/imu/invensense/mpu9250](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/mpu9250) - - -### Використання +### Usage {#mpu9250_i2c_usage} ``` mpu9250_i2c [arguments...] @@ -937,9 +873,7 @@ mpu9250_i2c [arguments...] Source: [drivers/imu/invensense/mpu6500](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/invensense/mpu6500) - - -### Використання +### Usage {#mpu9520_usage} ``` mpu9520 [arguments...] @@ -965,9 +899,7 @@ mpu9520 [arguments...] Source: [drivers/imu/murata/sch16t](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/imu/murata/sch16t) - - -### Використання +### Usage {#sch16t_usage} ``` sch16t [arguments...] diff --git a/docs/uk/modules/modules_driver_ins.md b/docs/uk/modules/modules_driver_ins.md index 2ad7c55bb9..0ada484050 100644 --- a/docs/uk/modules/modules_driver_ins.md +++ b/docs/uk/modules/modules_driver_ins.md @@ -14,7 +14,7 @@ Source: [drivers/ins/vectornav](https://github.com/PX4/PX4-Autopilot/tree/main/s ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` vectornav start -d /dev/ttyS1 @@ -26,9 +26,7 @@ Stop driver vectornav stop ``` - - -### Використання +### Usage {#vectornav_usage} ``` vectornav [arguments...] diff --git a/docs/uk/modules/modules_driver_magnetometer.md b/docs/uk/modules/modules_driver_magnetometer.md index cb3b36031e..8d527cfa4e 100644 --- a/docs/uk/modules/modules_driver_magnetometer.md +++ b/docs/uk/modules/modules_driver_magnetometer.md @@ -4,9 +4,7 @@ Source: [drivers/magnetometer/akm/ak09916](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/akm/ak09916) - - -### Використання +### Usage {#ak09916_usage} ``` ak09916 [arguments...] @@ -32,9 +30,7 @@ ak09916 [arguments...] Source: [drivers/magnetometer/akm/ak8963](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/akm/ak8963) - - -### Використання +### Usage {#ak8963_usage} ``` ak8963 [arguments...] @@ -60,9 +56,7 @@ ak8963 [arguments...] Source: [drivers/magnetometer/bosch/bmm150](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/bosch/bmm150) - - -### Використання +### Usage {#bmm150_usage} ``` bmm150 [arguments...] @@ -88,9 +82,7 @@ bmm150 [arguments...] Source: [drivers/magnetometer/bosch/bmm350](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/bosch/bmm350) - - -### Використання +### Usage {#bmm350_usage} ``` bmm350 [arguments...] @@ -116,9 +108,7 @@ bmm350 [arguments...] Source: [drivers/magnetometer/hmc5883](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/hmc5883) - - -### Використання +### Usage {#hmc5883_usage} ``` hmc5883 [arguments...] @@ -147,9 +137,7 @@ hmc5883 [arguments...] Source: [drivers/magnetometer/st/iis2mdc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/st/iis2mdc) - - -### Використання +### Usage {#iis2mdc_usage} ``` iis2mdc [arguments...] @@ -173,9 +161,7 @@ iis2mdc [arguments...] Source: [drivers/magnetometer/isentek/ist8308](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/isentek/ist8308) - - -### Використання +### Usage {#ist8308_usage} ``` ist8308 [arguments...] @@ -201,9 +187,7 @@ ist8308 [arguments...] Source: [drivers/magnetometer/isentek/ist8310](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/isentek/ist8310) - - -### Використання +### Usage {#ist8310_usage} ``` ist8310 [arguments...] @@ -229,9 +213,7 @@ ist8310 [arguments...] Source: [drivers/magnetometer/lis3mdl](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/lis3mdl) - - -### Використання +### Usage {#lis3mdl_usage} ``` lis3mdl [arguments...] @@ -263,9 +245,7 @@ lis3mdl [arguments...] Source: [drivers/magnetometer/lsm9ds1_mag](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/lsm9ds1_mag) - - -### Використання +### Usage {#lsm9ds1_mag_usage} ``` lsm9ds1_mag [arguments...] @@ -291,9 +271,7 @@ lsm9ds1_mag [arguments...] Source: [drivers/magnetometer/memsic/mmc5983ma](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/memsic/mmc5983ma) - - -### Використання +### Usage {#mmc5983ma_usage} ``` mmc5983ma [arguments...] @@ -325,9 +303,7 @@ mmc5983ma [arguments...] Source: [drivers/magnetometer/qmc5883l](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/qmc5883l) - - -### Використання +### Usage {#qmc5883l_usage} ``` qmc5883l [arguments...] @@ -353,9 +329,7 @@ qmc5883l [arguments...] Source: [drivers/magnetometer/rm3100](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/rm3100) - - -### Використання +### Usage {#rm3100_usage} ``` rm3100 [arguments...] @@ -383,9 +357,7 @@ rm3100 [arguments...] Source: [drivers/magnetometer/vtrantech/vcm1193l](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/magnetometer/vtrantech/vcm1193l) - - -### Використання +### Usage {#vcm1193l_usage} ``` vcm1193l [arguments...] diff --git a/docs/uk/modules/modules_driver_optical_flow.md b/docs/uk/modules/modules_driver_optical_flow.md index 65eee76928..70a182d3d1 100644 --- a/docs/uk/modules/modules_driver_optical_flow.md +++ b/docs/uk/modules/modules_driver_optical_flow.md @@ -14,7 +14,7 @@ Source: [drivers/optical_flow/thoneflow](https://github.com/PX4/PX4-Autopilot/tr ### Приклади -Спроба запустити драйвер на вказаному послідовному пристрої. +Attempt to start driver on a specified serial device. ``` thoneflow start -d /dev/ttyS1 @@ -26,9 +26,7 @@ Stop driver thoneflow stop ``` - - -### Використання +### Usage {#thoneflow_usage} ``` thoneflow [arguments...] diff --git a/docs/uk/modules/modules_driver_radio_control.md b/docs/uk/modules/modules_driver_radio_control.md new file mode 100644 index 0000000000..473c70c11f --- /dev/null +++ b/docs/uk/modules/modules_driver_radio_control.md @@ -0,0 +1,122 @@ +# Modules Reference: Radio Control (Driver) + +## crsf_rc + +Source: [drivers/rc/crsf_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/crsf_rc) + +### Опис + +This module parses the CRSF RC uplink protocol and generates CRSF downlink telemetry data + +### Usage {#crsf_rc_usage} + +``` +crsf_rc [arguments...] + Commands: + start + [-d ] RC device + values: , default: /dev/ttyS3 + + stop + + status print status info +``` + +## dsm_rc + +Source: [drivers/rc/dsm_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/dsm_rc) + +### Опис + +This module does Spektrum DSM RC input parsing. + +### Usage {#dsm_rc_usage} + +``` +dsm_rc [arguments...] + Commands: + start + [-d ] RC device + values: , default: /dev/ttyS3 + + bind Send a DSM bind command (module must be running) + + stop + + status print status info +``` + +## ghst_rc + +Source: [drivers/rc/ghst_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/ghst_rc) + +### Опис + +This module does Ghost (GHST) RC input parsing. + +### Usage {#ghst_rc_usage} + +``` +ghst_rc [arguments...] + Commands: + start + [-d ] RC device + values: , default: /dev/ttyS3 + + stop + + status print status info +``` + +## rc_input + +Source: [drivers/rc_input](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc_input) + +### Опис + +This module does the RC input parsing and auto-selecting the method. Supported methods are: + +- PPM +- SBUS +- DSM +- SUMD +- ST24 +- TBS Crossfire (CRSF) + +### Usage {#rc_input_usage} + +``` +rc_input [arguments...] + Commands: + start + [-d ] RC device + values: , default: /dev/ttyS3 + + bind Send a DSM bind command (module must be running) + + stop + + status print status info +``` + +## sbus_rc + +Source: [drivers/rc/sbus_rc](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rc/sbus_rc) + +### Опис + +This module does SBUS RC input parsing. + +### Usage {#sbus_rc_usage} + +``` +sbus_rc [arguments...] + Commands: + start + [-d ] RC device + values: , default: /dev/ttyS3 + + stop + + status print status info +``` diff --git a/docs/uk/modules/modules_driver_rpm_sensor.md b/docs/uk/modules/modules_driver_rpm_sensor.md index f014eb0c20..b4d7b95243 100644 --- a/docs/uk/modules/modules_driver_rpm_sensor.md +++ b/docs/uk/modules/modules_driver_rpm_sensor.md @@ -4,9 +4,7 @@ Source: [drivers/rpm/pcf8583](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/rpm/pcf8583) - - -### Використання +### Usage {#pcf8583_usage} ``` pcf8583 [arguments...] diff --git a/docs/uk/modules/modules_driver_transponder.md b/docs/uk/modules/modules_driver_transponder.md index 931cd83cf6..783fb4dfd3 100644 --- a/docs/uk/modules/modules_driver_transponder.md +++ b/docs/uk/modules/modules_driver_transponder.md @@ -24,9 +24,7 @@ Set the Squawk Code $ sagetech_mxs squawk 1200 ``` - - -### Використання +### Usage {#sagetech_mxs_usage} ``` sagetech_mxs [arguments...] diff --git a/docs/uk/modules/modules_estimator.md b/docs/uk/modules/modules_estimator.md index 555d96202b..af7d898ee6 100644 --- a/docs/uk/modules/modules_estimator.md +++ b/docs/uk/modules/modules_estimator.md @@ -8,9 +8,7 @@ Source: [modules/attitude_estimator_q](https://github.com/PX4/PX4-Autopilot/tree Оцінювач висоти q. - - -### Використання +### Usage {#AttitudeEstimatorQ_usage} ``` AttitudeEstimatorQ [arguments...] @@ -34,9 +32,7 @@ Source: [modules/airspeed_selector](https://github.com/PX4/PX4-Autopilot/tree/ma оцінки масштабного коефіцієнта від IAS до CAS, вона запускає кілька оцінювачів вітру а також публікує їх. - - -### Використання +### Usage {#airspeed_estimator_usage} ``` airspeed_estimator [arguments...] @@ -61,9 +57,7 @@ The documentation can be found on the [ECL/EKF Overview & Tuning](https://docs.p ekf2 can be started in replay mode (`-r`): in this mode, it does not access the system time, but only uses the timestamps from the sensor topics. - - -### Використання +### Usage {#ekf2_usage} ``` ekf2 [arguments...] @@ -88,9 +82,7 @@ Source: [modules/local_position_estimator](https://github.com/PX4/PX4-Autopilot/ Оцінювач відношення та позиції за допомогою розширеного фільтра Калмана. - - -### Використання +### Usage {#local_position_estimator_usage} ``` local_position_estimator [arguments...] @@ -108,9 +100,7 @@ Source: [modules/mc_hover_thrust_estimator](https://github.com/PX4/PX4-Autopilot ### Опис - - -### Використання +### Usage {#mc_hover_thrust_estimator_usage} ``` mc_hover_thrust_estimator [arguments...] diff --git a/docs/uk/modules/modules_simulation.md b/docs/uk/modules/modules_simulation.md index 39a108a70a..990145fcb6 100644 --- a/docs/uk/modules/modules_simulation.md +++ b/docs/uk/modules/modules_simulation.md @@ -16,9 +16,7 @@ Source: [modules/simulation/simulator_sih](https://github.com/PX4/PX4-Autopilot/ Симулятор реалізує рівняння руху за допомогою матричної алгебри.Використовується кватерніонне представлення для орієнтації.Для інтегрування використовується пряма схема Ейлера.Більшість змінних оголошуються глобальними в файлі .hpp, щоб уникнути переповнення стеку. - - -### Використання +### Usage {#simulator_sih_usage} ``` simulator_sih [arguments...] diff --git a/docs/uk/modules/modules_system.md b/docs/uk/modules/modules_system.md index 723a9a246c..f0f23b9ff7 100644 --- a/docs/uk/modules/modules_system.md +++ b/docs/uk/modules/modules_system.md @@ -6,9 +6,7 @@ Source: [modules/simulation/battery_simulator](https://github.com/PX4/PX4-Autopi ### Опис - - -### Використання +### Usage {#battery_simulator_usage} ``` battery_simulator [arguments...] @@ -26,17 +24,15 @@ Source: [modules/battery_status](https://github.com/PX4/PX4-Autopilot/tree/main/ ### Опис -Надана функціональність включає в себе: +The provided functionality includes: - Read the output from the ADC driver (via ioctl interface) and publish `battery_status`. ### Імплементація -Він запускається у власній темі і проводить опитування на поточну обрану тему гіроскопа. +It runs in its own thread and polls on the currently selected gyro topic. - - -### Використання +### Usage {#battery_status_usage} ``` battery_status [arguments...] @@ -74,9 +70,7 @@ It discards topics from the `camera_trigger` module if camera capture is enabled For the topics that are not discarded it creates a `CameraCapture` topic with the timestamp information from the `CameraTrigger` and position information from the vehicle. - - -### Використання +### Usage {#camera_feedback_usage} ``` camera_feedback [arguments...] @@ -94,14 +88,12 @@ Source: [drivers/cdcacm_autostart](https://github.com/PX4/PX4-Autopilot/tree/mai ### Опис -Цей модуль прослуховує USB і автоматично налаштовує протокол в залежності від отриманих байтів. -Підтримувані протоколи: MAVLink, nsh та ublox послідовний прохід. Якщо параметр SYS_USB_AUTO=2 -модуль буде намагатися запустити mavlink лише тоді, коли буде виявлено USB VBUS. В іншому випадку він буде обертатися -і продовжувати перевіряти VBUS та запускати mavlink, як тільки він виявиться. +This module listens on USB and auto-configures the protocol depending on the bytes received. +The supported protocols are: MAVLink, nsh, and ublox serial passthrough. If the parameter SYS_USB_AUTO=2 +the module will only try to start mavlink as long as the USB VBUS is detected. Otherwise it will spin +and continue to check for VBUS and start mavlink once it is detected. - - -### Використання +### Usage {#cdcacm_autostart_usage} ``` cdcacm_autostart [arguments...] @@ -119,11 +111,9 @@ Source: [modules/commander](https://github.com/PX4/PX4-Autopilot/tree/main/src/m ### Опис -Модуль командира містить машину станів для перемикання режимів та аварійної поведінки. +The commander module contains the state machine for mode switching and failsafe behavior. - - -### Використання +### Usage {#commander_usage} ``` commander [arguments...] @@ -177,22 +167,20 @@ Source: [modules/dataman](https://github.com/PX4/PX4-Autopilot/tree/main/src/mod ### Опис -Модуль для забезпечення постійного сховища для решти системи у вигляді простої бази даних через C API. +Module to provide persistent storage for the rest of the system in form of a simple database through a C API. Multiple backends are supported depending on the board: -- файл (наприклад, на SD-карті) -- Оперативна пам'ять (очевидно, що вона не є постійною) +- a file (eg. on the SD card) +- RAM (this is obviously not persistent) -Використовується для зберігання структурованих даних різних типів: маршрутні точки місії, стан місії та полігони геозони. -Кожен тип має певний тип і фіксовану максимальну кількість елементів зберігання, щоб забезпечити швидкий випадковий доступ. +It is used to store structured data of different types: mission waypoints, mission state and geofence polygons. +Each type has a specific type and a fixed maximum amount of storage items, so that fast random access is possible. ### Імплементація -Читання і запис одного елемента завжди атомарні. +Reading and writing a single item is always atomic. - - -### Використання +### Usage {#dataman_usage} ``` dataman [arguments...] @@ -216,20 +204,18 @@ Source: [systemcmds/dmesg](https://github.com/PX4/PX4-Autopilot/tree/main/src/sy ### Опис -Інструмент командного рядка для показу повідомлень консолі завантаження. -Зауважте, що вивід з робочих черг NuttX та syslog не перехоплюється. +Command-line tool to show bootup console messages. +Note that output from NuttX's work queues and syslog are not captured. ### Приклади -Продовжує друкувати всі повідомлення у фоновому режимі: +Keep printing all messages in the background: ``` dmesg -f & ``` - - -### Використання +### Usage {#dmesg_usage} ``` dmesg [arguments...] @@ -243,11 +229,9 @@ Source: [modules/esc_battery](https://github.com/PX4/PX4-Autopilot/tree/main/src ### Опис -Це реалізує використання інформації зі статусу ESC і публікує її як стан батареї. +This implements using information from the ESC status and publish it as battery status. - - -### Використання +### Usage {#esc_battery_usage} ``` esc_battery [arguments...] @@ -265,11 +249,9 @@ Source: [modules/gyro_calibration](https://github.com/PX4/PX4-Autopilot/tree/mai ### Опис -Просте онлайн-калібрування гіроскопа. +Simple online gyroscope calibration. - - -### Використання +### Usage {#gyro_calibration_usage} ``` gyro_calibration [arguments...] @@ -287,9 +269,7 @@ Source: [modules/gyro_fft](https://github.com/PX4/PX4-Autopilot/tree/main/src/mo ### Опис - - -### Використання +### Usage {#gyro_fft_usage} ``` gyro_fft [arguments...] @@ -307,13 +287,11 @@ Source: [drivers/heater](https://github.com/PX4/PX4-Autopilot/tree/main/src/driv ### Опис -Фоновий процес, що періодично запускається в робочій черзі LP для регулювання температури IMU на заданому рівні. +Background process running periodically on the LP work queue to regulate IMU temperature at a setpoint. -Це завдання можна запустити під час завантаження зі скриптів запуску, встановивши SENS_EN_THERMAL, або через CLI. +This task can be started at boot from the startup scripts by setting SENS_EN_THERMAL or via CLI. - - -### Використання +### Usage {#heater_usage} ``` heater [arguments...] @@ -331,11 +309,9 @@ Source: [systemcmds/i2c_launcher](https://github.com/PX4/PX4-Autopilot/tree/main ### Опис -Демон, який запускає драйвери на основі виявлених пристроїв I2C. +Daemon that starts drivers based on found I2C devices. - - -### Використання +### Usage {#i2c_launcher_usage} ``` i2c_launcher [arguments...] @@ -401,9 +377,7 @@ The architecture is as shown below: - - -### Використання +### Usage {#internal_combustion_engine_control_usage} ``` internal_combustion_engine_control [arguments...] @@ -427,26 +401,25 @@ states, such as commanded thrust, arming state and vehicle motion. ### Імплементація -Кожен тип реалізовано у власному класі зі спільним базовим класом. Базовий клас підтримує стан (landed, -maybe_landed, ground_contact). Кожен можливий стан реалізується в похідних класах. Гістерезис та фіксований -пріоритет кожного внутрішнього стану визначає фактичний стан land_detector. +Every type is implemented in its own class with a common base class. The base class maintains a state (landed, +maybe_landed, ground_contact). Each possible state is implemented in the derived classes. A hysteresis and a fixed +priority of each internal state determines the actual land_detector state. -#### Мультикоптер Land Detector +#### Multicopter Land Detector **ground_contact**: thrust setpoint and velocity in z-direction must be below a defined threshold for time -GROUND_CONTACT_TRIGGER_TIME_US. При виявленні контакту з землею регулятор положення вимикає задане значення тяги -у тілі x та y. +GROUND_CONTACT_TRIGGER_TIME_US. When ground_contact is detected, the position controller turns off the thrust setpoint +in body x and y. **maybe_landed**: it requires ground_contact together with a tighter thrust setpoint threshold and no velocity in the -horizontal direction. Час спрацьовування визначається параметром MAYBE_LAND_TRIGGER_TIME. Коли виявляється maybe_landed, контролер положення встановлює задане значення тяги на нуль. +horizontal direction. The trigger time is defined by MAYBE_LAND_TRIGGER_TIME. When maybe_landed is detected, the +position controller sets the thrust setpoint to zero. **landed**: it requires maybe_landed to be true for time LAND_DETECTOR_TRIGGER_TIME_US. -Модуль періодично запускається у черзі робіт HP. +The module runs periodically on the HP work queue. - - -### Використання +### Usage {#land_detector_usage} ``` land_detector [arguments...] @@ -468,12 +441,10 @@ Source: [modules/load_mon](https://github.com/PX4/PX4-Autopilot/tree/main/src/mo Background process running periodically on the low priority work queue to calculate the CPU load and RAM usage and publish the `cpuload` topic. -У NuttX він також перевіряє використання стеку кожним процесом, і якщо воно падає нижче 300 байт, виводиться попередження, -яке також буде показано у файлі логу. +On NuttX it also checks the stack usage of each process and if it falls below 300 bytes, a warning is output, +which will also appear in the log file. - - -### Використання +### Usage {#load_mon_usage} ``` load_mon [arguments...] @@ -492,46 +463,47 @@ Source: [modules/logger](https://github.com/PX4/PX4-Autopilot/tree/main/src/modu ### Опис System logger which logs a configurable set of uORB topics and system printf messages -(`PX4_WARN` and `PX4_ERR`) to ULog files. Вони можуть бути використані для оцінки продуктивності системи та польоту, -налаштування, відтворення та аналізу збоїв. +(`PX4_WARN` and `PX4_ERR`) to ULog files. These can be used for system and flight performance evaluation, +tuning, replay and crash analysis. -Він підтримує 2 бекенди: +It supports 2 backends: -- Файли: запис файлів ULog до файлової системи (SD-карта) -- MAVLink: передача даних ULog через MAVLink клієнту (клієнт повинен це підтримувати) +- Files: write ULog files to the file system (SD card) +- MAVLink: stream ULog data via MAVLink to a client (the client must support this) -Обидва бекенди можуть бути активовані та використовуватися одночасно. +Both backends can be enabled and used at the same time. -Файловий бекенд підтримує 2 типи логів: повний (звичайний лог) і журнал місій. Журнал місії - це скорочений файл ulog, який можна використовувати, наприклад, для географічних міток або управління транспортним засобом. Його можна увімкнути та налаштувати за допомогою параметра SDLOG_MISSION. -Звичайний журнал завжди є підмножиною журналу місій. +The file backend supports 2 types of log files: full (the normal log) and a mission +log. The mission log is a reduced ulog file and can be used for example for geotagging or +vehicle management. It can be enabled and configured via SDLOG_MISSION parameter. +The normal log is always a superset of the mission log. ### Імплементація -Реалізація використовує два потоки: +The implementation uses two threads: - The main thread, running at a fixed rate (or polling on a topic if started with -p) and checking for data updates -- Потік запису, що записує дані у файл +- The writer thread, writing data to the file -Між ними знаходиться буфер запису з конфігурованим розміром (і ще один буфер фіксованого розміру для журналу місій). Він повинен бути великим, щоб уникнути втрати даних. +In between there is a write buffer with configurable size (and another fixed-size buffer for +the mission log). It should be large to avoid dropouts. ### Приклади -Типове використання для початку ведення журналу негайно: +Typical usage to start logging immediately: ``` logger start -e -t ``` -Або якщо вже працює: +Or if already running: ``` logger on ``` - - -### Використання +### Usage {#logger_usage} ``` logger [arguments...] @@ -572,11 +544,9 @@ Source: [modules/mag_bias_estimator](https://github.com/PX4/PX4-Autopilot/tree/m ### Опис -Онлайн-оцінювач похибки магнітометра. +Online magnetometer bias estimator. - - -### Використання +### Usage {#mag_bias_estimator_usage} ``` mag_bias_estimator [arguments...] @@ -594,11 +564,9 @@ Source: [modules/manual_control](https://github.com/PX4/PX4-Autopilot/tree/main/ ### Опис -Модуль споживає вхідні дані вручним керуванням, публікуючи одну установку керування вручну. +Module consuming manual_control_inputs publishing one manual_control_setpoint. - - -### Використання +### Usage {#manual_control_usage} ``` manual_control [arguments...] @@ -617,9 +585,9 @@ Source: [systemcmds/netman](https://github.com/PX4/PX4-Autopilot/tree/main/src/s ### Опис Network configuration manager saves the network settings in non-volatile -memory. On boot the `update` option will be run. Якщо конфігурація мережі -не існує. Значення за замовчуванням буде збережено в неплавучій пам'яті та -система перезавантажена. +memory. On boot the `update` option will be run. If a network configuration +does not exist. The default setting will be saved in non-volatile and the +system rebooted. #### update @@ -631,8 +599,8 @@ deletes the file and reboots the system. #### save The `save` option will save settings from non-volatile memory to a file named -`net.cfg` on the SD Card filesystem for editing. Використовуйте це, щоб відредагувати налаштування. -Збереження не негайно застосовує мережеві налаштування; користувач повинен перезавантажити стек польоту. +`net.cfg` on the SD Card filesystem for editing. Use this to edit the settings. +Save does not immediately apply the network settings; the user must reboot the flight stack. By contrast, the `update` command is run by the start-up script, commits the settings to non-volatile memory, and reboots the flight controller (which will then use the new settings). @@ -643,12 +611,10 @@ The `show` option will display the network settings in `net.cfg` to the console. ### Приклади $ netman save # Save the parameters to the SD card. -$ netman show # відображення поточних налаштувань. -$ netman update -i eth0 # зробити оновлення +$ netman show # display current settings. +$ netman update -i eth0 # do an update - - -### Використання +### Usage {#netman_usage} ``` netman [arguments...] @@ -669,11 +635,9 @@ Source: [drivers/pwm_input](https://github.com/PX4/PX4-Autopilot/tree/main/src/d ### Опис -Вимірює вхід PWM на AUX5 (або MAIN5) через таймер захоплення ISR та публікує через повідомлення uORB 'pwm_input'. +Measures the PWM input on AUX5 (or MAIN5) via a timer capture ISR and publishes via the uORB 'pwm_input\` message. - - -### Використання +### Usage {#pwm_input_usage} ``` pwm_input [arguments...] @@ -697,11 +661,9 @@ and then publish as `rc_channels` and `manual_control_input`. ### Імплементація -Щоб зменшити затримку управління, модуль запланований на опублікування введення_управління. +To reduce control latency, the module is scheduled on input_rc publications. - - -### Використання +### Usage {#rc_update_usage} ``` rc_update [arguments...] @@ -719,7 +681,7 @@ Source: [modules/replay](https://github.com/PX4/PX4-Autopilot/tree/main/src/modu ### Опис -Цей модуль використовується для відтворення файлів ULog. +This module is used to replay ULog files. There are 2 environment variables used for configuration: `replay`, which must be set to an ULog file name - it's the log file to be replayed. The second is the mode, specified via `replay_mode`: @@ -729,16 +691,14 @@ the log file to be replayed. The second is the mode, specified via `replay_mode` - Generic otherwise: this can be used to replay any module(s), but the replay will be done with the same speed as the log was recorded. -Модуль зазвичай використовується разом з правилами видавця uORB, щоб вказати, які повідомлення потрібно відтворити. -Модуль відтворення просто опублікує всі повідомлення, які знаходяться в журналі. Це також застосовує параметри з -журналу. +The module is typically used together with uORB publisher rules, to specify which messages should be replayed. +The replay module will just publish all messages that are found in the log. It also applies the parameters from +the log. The replay procedure is documented on the [System-wide Replay](https://docs.px4.io/main/en/debug/system_wide_replay.html) page. - - -### Використання +### Usage {#replay_usage} ``` replay [arguments...] @@ -760,14 +720,12 @@ Source: [modules/events](https://github.com/PX4/PX4-Autopilot/tree/main/src/modu ### Опис -Фоновий процес, що періодично виконується в черзі завдань LP для виконання рутинних завдань. -Зараз він відповідає лише за сигнал тривоги на втрату RC. +Background process running periodically on the LP work queue to perform housekeeping tasks. +It is currently only responsible for tone alarm on RC Loss. -Завдання можна почати через CLI або теми uORB (vehicle_command з MAVLink тощо). +The tasks can be started via CLI or uORB topics (vehicle_command from MAVLink, etc.). - - -### Використання +### Usage {#send_event_usage} ``` send_event [arguments...] @@ -787,9 +745,7 @@ Source: [modules/simulation/sensor_agp_sim](https://github.com/PX4/PX4-Autopilot Module to simulate auxiliary global position measurements with optional failure modes for SIH simulation. - - -### Використання +### Usage {#sensor_agp_sim_usage} ``` sensor_agp_sim [arguments...] @@ -807,9 +763,7 @@ Source: [modules/simulation/sensor_airspeed_sim](https://github.com/PX4/PX4-Auto ### Опис - - -### Використання +### Usage {#sensor_arispeed_sim_usage} ``` sensor_arispeed_sim [arguments...] @@ -827,9 +781,7 @@ Source: [modules/simulation/sensor_baro_sim](https://github.com/PX4/PX4-Autopilo ### Опис - - -### Використання +### Usage {#sensor_baro_sim_usage} ``` sensor_baro_sim [arguments...] @@ -847,9 +799,7 @@ Source: [modules/simulation/sensor_gps_sim](https://github.com/PX4/PX4-Autopilot ### Опис - - -### Використання +### Usage {#sensor_gps_sim_usage} ``` sensor_gps_sim [arguments...] @@ -867,9 +817,7 @@ Source: [modules/simulation/sensor_mag_sim](https://github.com/PX4/PX4-Autopilot ### Опис - - -### Використання +### Usage {#sensor_mag_sim_usage} ``` sensor_mag_sim [arguments...] @@ -887,26 +835,25 @@ Source: [modules/sensors](https://github.com/PX4/PX4-Autopilot/tree/main/src/mod ### Опис -Модуль сенсорів є центральним у всій системі. Він отримує вихід низького рівня від драйверів, перетворює його в більш придатну форму і публікує його для решти системи. +The sensors module is central to the whole system. It takes low-level output from drivers, turns +it into a more usable form, and publishes it for the rest of the system. -Надана функціональність включає в себе: +The provided functionality includes: - Read the output from the sensor drivers (`SensorGyro`, etc.). - Якщо існують кілька екземплярів того самого типу, виконуйте голосування та обробку аварійної ситуації. - Потім застосуйте обертання дошки та калібрування температури (якщо ввімкнено). And finally publish the data; one of the + If there are multiple of the same type, do voting and failover handling. + Then apply the board rotation and temperature calibration (if enabled). And finally publish the data; one of the topics is `SensorCombined`, used by many parts of the system. - Make sure the sensor drivers get the updated calibration parameters (scale & offset) when the parameters change or - on startup. Драйвери сенсора використовують інтерфейс ioctl для оновлення параметрів. For this to work properly, the + on startup. The sensor drivers use the ioctl interface for parameter updates. For this to work properly, the sensor drivers must already be running when `sensors` is started. - Do sensor consistency checks and publish the `SensorsStatusImu` topic. ### Імплементація -Він запускається у власній темі і проводить опитування на поточну обрану тему гіроскопа. +It runs in its own thread and polls on the currently selected gyro topic. - - -### Використання +### Usage {#sensors_usage} ``` sensors [arguments...] @@ -925,9 +872,7 @@ Source: [modules/simulation/system_power_simulator](https://github.com/PX4/PX4-A ### Опис - - -### Використання +### Usage {#system_power_simulation_usage} ``` system_power_simulation [arguments...] @@ -945,11 +890,9 @@ Source: [drivers/tattu_can](https://github.com/PX4/PX4-Autopilot/tree/main/src/d ### Опис -Драйвер для зчитування даних з розумної батареї Tattu 12S 16000mAh. +Driver for reading data from the Tattu 12S 16000mAh smart battery. - - -### Використання +### Usage {#tattu_can_usage} ``` tattu_can [arguments...] @@ -967,14 +910,13 @@ Source: [modules/temperature_compensation](https://github.com/PX4/PX4-Autopilot/ ### Опис -Модуль компенсації температури дозволяє всім гіроскопам, акселерометрам та барометрам у системі бути температурно компенсованими. Модуль відстежує дані, які надходять від датчиків та оновлює пов'язану тему sensor_correction -кожного разу, коли виявляється зміна температури. Модуль також може бути налаштований для виконання обчислення коефіцієнта -наступного завантаження, що дозволяє обчислити калібрувальні коефіцієнти теплової калібрації під час -циклу температури автомобіля. +The temperature compensation module allows all of the gyro(s), accel(s), and baro(s) in the system to be temperature +compensated. The module monitors the data coming from the sensors and updates the associated sensor_correction topic +whenever a change in temperature is detected. The module can also be configured to perform the coeffecient calculation +routine at next boot, which allows the thermal calibration coeffecients to be calculated while the vehicle undergoes +a temperature cycle. - - -### Використання +### Usage {#temperature_compensation_usage} ``` temperature_compensation [arguments...] @@ -1004,9 +946,7 @@ Writes the RTC time cyclically to a file and reloads this value on startup. This allows monotonic time on systems that only have a software RTC (that is not battery powered). Explicitly setting the time backwards (e.g. via system_time) is still possible. - - -### Використання +### Usage {#time_persistor_usage} ``` time_persistor [arguments...] @@ -1026,23 +966,21 @@ Source: [systemcmds/tune_control](https://github.com/PX4/PX4-Autopilot/tree/main Command-line tool to control & test the (external) tunes. -Мелодії використовуються для надання слухових сповіщень та попереджень (наприклад, коли система озброєна, отримує позицію блокування тощо). -Інструмент вимагає, щоб був запущений драйвер, який може керувати темою управління tune_control uorb. +Tunes are used to provide audible notification and warnings (e.g. when the system arms, gets position lock, etc.). +The tool requires that a driver is running that can handle the tune_control uorb topic. -Інформацію про формат мелодії та попередньо визначені системні мелодії можна знайти тут: +Information about the tune format and predefined system tunes can be found here: https://github.com/PX4/PX4-Autopilot/blob/main/src/lib/tunes/tune_definition.desc ### Приклади -Грайте системний мелодію #2: +Play system tune #2: ``` tune_control play -t 2 ``` - - -### Використання +### Usage {#tune_control_usage} ``` tune_control [arguments...] @@ -1069,7 +1007,7 @@ Source: [modules/uxrce_dds_client](https://github.com/PX4/PX4-Autopilot/tree/mai ### Опис -Клієнт UXRCE-DDS використовується для спілкування з агентом за допомогою тем uORB через послідовний або UDP. +UXRCE-DDS Client used to communicate uORB topics with an Agent over serial or UDP. ### Приклади @@ -1078,9 +1016,7 @@ uxrce_dds_client start -t serial -d /dev/ttyS3 -b 921600 uxrce_dds_client start -t udp -h 127.0.0.1 -p 15555 ``` - - -### Використання +### Usage {#uxrce_dds_client_usage} ``` uxrce_dds_client [arguments...] @@ -1109,11 +1045,9 @@ Source: [systemcmds/work_queue](https://github.com/PX4/PX4-Autopilot/tree/main/s ### Опис -Інструмент командного рядка для відображення статусу черги роботи. +Command-line tool to show work queue status. - - -### Використання +### Usage {#work_queue_usage} ``` work_queue [arguments...] diff --git a/docs/uk/modules/modules_template.md b/docs/uk/modules/modules_template.md index da38f46e12..a02a7276ee 100644 --- a/docs/uk/modules/modules_template.md +++ b/docs/uk/modules/modules_template.md @@ -16,15 +16,13 @@ Source: [templates/template_module](https://github.com/PX4/PX4-Autopilot/tree/ma ### Приклади -Приклад використання CLI: +CLI usage example: ``` module start -f -p 42 ``` - - -### Використання +### Usage {#module_usage} ``` module [arguments...] @@ -47,9 +45,7 @@ Source: [examples/work_item](https://github.com/PX4/PX4-Autopilot/tree/main/src/ Приклад простого модуля, який виконується з черги завдань. - - -### Використання +### Usage {#work_item_example_usage} ``` work_item_example [arguments...] diff --git a/docs/uk/sim_sih/index.md b/docs/uk/sim_sih/index.md index bb3b9ceac7..c6e4f60611 100644 --- a/docs/uk/sim_sih/index.md +++ b/docs/uk/sim_sih/index.md @@ -58,6 +58,7 @@ To set up/start SIH: 2. Відкрийте QGroundControl і зачекайте, поки контролер польоту також завантажиться та підключиться. 3. Open [Vehicle Setup > Airframe](../config/airframe.md) then select the desired frame: - [SIH Quadcopter X](../airframes/airframe_reference.md#copter_simulation_sih_quadcopter_x) + - SIH Hexacopter X currently only has an airframe for SITL to safe flash so on flight control hardware it has to be manually configured equivalently. - [SIH plane AERT](../airframes/airframe_reference.md#plane_simulation_sih_plane_aert) - [SIH Tailsitter Duo](../airframes/airframe_reference.md#vtol_simulation_sih_tailsitter_duo) - [SIH Standard VTOL QuadPlane](../airframes/airframe_reference.md#vtol_simulation_sih_standard_vtol_quadplane) @@ -116,25 +117,31 @@ In this case you don't need the flight controller hardware. 1. Install the [PX4 Development toolchain](../dev_setup/dev_env.md). 2. Виконайте відповідну команду make для кожного типу транспортного засобу (в корені репозиторію PX4-Autopilot): - - квадротор: + - Quadcopter ```sh make px4_sitl sihsim_quadx ``` - - Закріплені крила (літаки): + - Hexacopter + + ```sh + make px4_sitl sihsim_hex + ``` + + - Fixed-wing (plane) ```sh make px4_sitl sihsim_airplane ``` - - XVert VTOL tailsitter: + - XVert VTOL tailsitter ```sh make px4_sitl sihsim_xvert ``` - - Standard VTOL: + - Standard VTOL ```sh make px4_sitl sihsim_standard_vtol @@ -235,9 +242,10 @@ For specific examples see the `_sihsim_` airframes in [ROMFS/px4fmu_common/init. Динамічні моделі для різних транспортних засобів: -- Quadrotor: [pdf report](https://github.com/PX4/PX4-user_guide/raw/main/assets/simulation/SIH_dynamic_model.pdf). -- Fixed-wing: Inspired by the PhD thesis: "Dynamics modeling of agile fixed-wing unmanned aerial vehicles." Khan, Waqas, під керівництвом Nahon, Meyer, Університет Макгілла, докторська дисертація, 2016. -- Tailsitter: Inspired by the master's thesis: "Modeling and control of a flying wing tailsitter unmanned aerial vehicle." Chiappinelli, Romain, під керівництвом Nahon, Meyer, Університет Макгілла, магістерська робота, 2018. +- Quadcopter: [pdf report](https://github.com/PX4/PX4-user_guide/raw/main/assets/simulation/SIH_dynamic_model.pdf). +- Hexacopter: Equivalent to the Quadcopter but with a symmetric hexacopter x actuation setup. +- Fixed-wing: Inspired by the PhD thesis: "Dynamics modeling of agile fixed-wing unmanned aerial vehicles." Khan, Waqas, supervised by Nahon, Meyer, McGill University, PhD thesis, 2016. +- Tailsitter: Inspired by the master's thesis: "Modeling and control of a flying wing tailsitter unmanned aerial vehicle." Chiappinelli, Romain, supervised by Nahon, Meyer, McGill University, Masters thesis, 2018. ## Відео diff --git a/docs/uk/simulation/community_supported_simulators.md b/docs/uk/simulation/community_supported_simulators.md index 08509b5c96..8f6035c53a 100644 --- a/docs/uk/simulation/community_supported_simulators.md +++ b/docs/uk/simulation/community_supported_simulators.md @@ -12,10 +12,10 @@ These simulators are not maintained, tested, or supported, by the core developme Інструменти мають різний рівень підтримки своїми спільнотами (деякі добре підтримують, інші - ні). Питання про ці інструменти повинні порушуватися на [форумах для обговорення](../contribute/support.md#forums-and-chat) -| Симулятор | Опис | -| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [FlightGear](../sim_flightgear/README.md) |

Симулятор який надає фізично та візуально реалістичні симуляції. Зокрема він може моделювати багато погодних умов, включаючи грози, сніг, дощ та град, а також може симулювати температурні режими та різні типи атмосферних течій. [Симуляція кількох засобів](../sim_flightgear/multi_vehicle.md) також підтримується.

Рухомі засоби, що підтримуються: Літак, Автожир, Ровер

| -| [JMAVSim](../sim_jmavsim/index.md) |

A simple multirotor/quad simulator. This was previously part of the PX4 development toolchain but was removed in favour of [Gazebo](../sim_gazebo_gz/index.md).

Supported Vehicles: Quad

| -| [JSBSim](../sim_jsbsim/README.md) |

Симулятор, який надає моделі просунутої динаміки польоту. Він може використовуватися для моделювання реалістичної динаміки польоту, заснованої на даних з аеродинамічної труби.

Рухомі засоби, що підтримуються: Літак, Квадрокоптер, Гексакоптер

| -| [AirSim](../sim_airsim/README.md) |

Міжплатформовий симулятор який надає фізично та візуально реалістичні симуляції. Цей симулятор ресурсомісткий та потребує значно потужніший комп'ютер ніж інші описані тут симулятори.

Рухомі засоби, що підтримуються: Iris (модель мультиротора та налаштування для PX4 квадрокоптера в конфігурації "X").

| -| [Simulation-In-Hardware](../sim_sih/README.md) (SIH) |

Альтернатива симуляції HITL, яка пропонує важку симуляцію в реальному часі безпосередньо на обладнанні автопілота. Цей симулятор реалізований на C++ у вигляді модуля PX4 безпосередньо в [коді](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulator_sih) прошивки.

Supported Vehicles: Plane, Quad, Tailsitter, Standard VTOL

| +| Симулятор | Опис | +| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [Simulation-In-Hardware](../sim_sih/README.md) (SIH) |

A simulator implemented in C++ as a PX4 module directly in the Firmware [code](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/simulator_sih). It can be ran in SITL directly on the computer or as an alternative to HITL offering a hard real-time simulation directly on the hardware autopilot.

Supported Vehicles: Quad, Hexa, Plane, Tailsitter, Standard VTOL

| +| [FlightGear](../sim_flightgear/README.md) |

Симулятор який надає фізично та візуально реалістичні симуляції. Зокрема він може моделювати багато погодних умов, включаючи грози, сніг, дощ та град, а також може симулювати температурні режими та різні типи атмосферних течій. [Симуляція кількох засобів](../sim_flightgear/multi_vehicle.md) також підтримується.

Рухомі засоби, що підтримуються: Літак, Автожир, Ровер

| +| [JMAVSim](../sim_jmavsim/index.md) |

A simple multirotor/quad simulator. This was previously part of the PX4 development toolchain but was removed in favour of [Gazebo](../sim_gazebo_gz/index.md).

Supported Vehicles: Quad

| +| [JSBSim](../sim_jsbsim/README.md) |

Симулятор, який надає моделі просунутої динаміки польоту. Він може використовуватися для моделювання реалістичної динаміки польоту, заснованої на даних з аеродинамічної труби.

Рухомі засоби, що підтримуються: Літак, Квадрокоптер, Гексакоптер

| +| [AirSim](../sim_airsim/README.md) |

Міжплатформовий симулятор який надає фізично та візуально реалістичні симуляції. Цей симулятор ресурсомісткий та потребує значно потужніший комп'ютер ніж інші описані тут симулятори.

Рухомі засоби, що підтримуються: Iris (модель мультиротора та налаштування для PX4 квадрокоптера в конфігурації "X").

|