You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/uk/config/_autotune.md
+54-46Lines changed: 54 additions & 46 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,15 +98,23 @@ The RC sticks cannot be used during autotuning (moving the sticks will stop the
98
98
4. Дрон спочатку почне виконувати швидкі рухи кочення, а потім рухи тангажу та рухи курсу.
99
99
The progress is shown in the progress bar, next to the _Autotune_ button.
100
100
101
-
5. <divstyle="display: inline;"v-if="$frontmatter.frame === 'Multicopter'">Manually land and disarm to apply the new tuning parameters.
102
-
Takeoff carefully and manually test that the vehicle is stable.</div><divv-else-if="$frontmatter.frame === 'Plane'">The tuning will be immediately/automatically be applied and tested in flight (by default).
103
-
PX4 will then run a 4 second test and revert the new tuning if a problem is detected.</div>
5. The tuning will be immediately/automatically be applied and tested in flight (by default).
109
+
PX4 will then run a 4 second test and revert the new tuning if a problem is detected.
110
+
111
+
</div>
104
112
105
113
:::warning
106
114
If any strong oscillations occur, land immediately and follow the instructions in the [Troubleshooting](#troubleshooting) section below.
107
115
:::
108
116
109
-
Додаткові примітки:
117
+
Additional notes:
110
118
111
119
<divv-if="$frontmatter.frame === 'Multicopter'">
112
120
@@ -117,7 +125,7 @@ If any strong oscillations occur, land immediately and follow the instructions i
117
125
<divv-else-if="$frontmatter.frame === 'Plane'">
118
126
119
127
- Autotuning can also be run in [Altitude mode](../flight_modes_fw/altitude.md) or [Position mode](../flight_modes_fw/position.md).
120
-
Проте виконання тесту під час прямого польоту потребує більшої безпечної зони для налаштування і не дає значно кращого результату налаштування.
128
+
However running the test while flying straight requires a larger safe area for tuning, and does not give a significantly better tuning result.
121
129
122
130
</div>
123
131
@@ -150,22 +158,22 @@ Fast oscillations (more than 1 oscillation per second): this is because the gain
150
158
151
159
</div>
152
160
153
-
### Послідовність автоматичної настройки не вдається
161
+
### The auto-tuning sequence fails
154
162
155
-
Якщо безпілотник не рухався достатньо під час автоматичного налаштування, алгоритм ідентифікації системи може мати проблеми з визначенням правильних коефіцієнтів.
163
+
If the drone was not moving enough during auto-tuning, the system identification algorithm might have issues to find the correct coefficients.
156
164
157
165
Increase the <divstyle="display: inline;"v-if="$frontmatter.frame === 'Multicopter'">[MC_AT_SYSID_AMP](../advanced_config/parameter_reference.md#MC_AT_SYSID_AMP)</div><divstyle="display: inline;"v-else-if="$frontmatter.frame === 'Plane'">[FW_AT_SYSID_AMP](../advanced_config/parameter_reference.md#FW_AT_SYSID_AMP)</div> parameter by steps of 1 and trigger the auto-tune again.
158
166
159
-
### Дрон коливається після автоналагодження
167
+
### The drone oscillates after auto-tuning
160
168
161
-
Через вплив ефектів, які не враховані в математичній моделі, такі як затримки, насичення, швидкість наростання, гнучкість конструкції, коефіцієнт підсилення петлі може бути занадто великим.
169
+
Due to effects not included in the mathematical model such as delays, saturation, slew-rate, airframe flexibility, the loop gain can be too high.
162
170
To fix this, follow the same steps described [when the drone oscillates in the pre-tuning test](#drone-oscillates-when-performing-the-pre-tuning-test).
163
171
164
-
### Я все ще не можу зрозуміти, як це працює
172
+
### I still can't get it to work
165
173
166
174
Attempt manual tuning using the guides listed in [See also](#see-also) below.
167
175
168
-
## Необов'язкова Конфігурація
176
+
## Optional Configuration
169
177
170
178
### Apply Tuning when In-Air/Landed
171
179
@@ -183,13 +191,13 @@ This behaviour can be configured using the [FW_AT_APPLY](../advanced_config/para
183
191
</div>
184
192
185
193
-`0`: the gains are not applied.
186
-
Це використовується для тестування, якщо користувач хоче перевірити результати автоналаштування алгоритму без прямого їх використання.
194
+
This is used for testing purposes if the user wants to inspect results of the auto-tuning algorithm without using them directly.
187
195
-`1`: apply the gains after disarm (default for multirotors).
188
-
Оператор може перевірити нове налаштування під час обережного зльоту.
196
+
The operator can then test the new tuning while taking-off carefully.
189
197
-`2`: apply immediately (default for fixed-wings).
190
-
Нове налаштування застосовується, перешкоди надсилаються контролеру, а стабільність контролюється протягом наступних 4 секунд.
191
-
Якщо керуюче коло нестійке, керуючі коефіцієнти негайно повертаються до свого попереднього значення.
192
-
Якщо тест пройшов успішно, пілот може використовувати нове налаштування.
198
+
The new tuning is applied, disturbances are sent to the controller and the stability is monitored during the next 4 seconds.
199
+
If the control loop is unstable, the control gains are immediately reverted back to their previous value.
200
+
If the test passes, the pilot can then use the new tuning.
193
201
194
202
<divv-if="$frontmatter.frame === 'Plane'">
195
203
@@ -199,7 +207,7 @@ A remote control switch can be configured to enable/disable autotune (in any mod
199
207
200
208
To map a switch:
201
209
202
-
1.Виберіть канал RC на вашому контролері для використання перемикача увімкнення / вимкнення автоналадки.
210
+
1.Select an RC channel on your controller to use for the autotune enable/disable switch.
203
211
2. Set [RC_MAP_AUX1](../advanced_config/parameter_reference.md#RC_MAP_AUX1) to match the RC channel for your switch (you can use any of `RC_MAP_AUX1` to `RC_MAP_AUX6`).
204
212
3. Set [FW_AT_MAN_AUX](../advanced_config/parameter_reference.md#FW_AT_MAN_AUX) to the selected channel (i.e. `1: Aux 1` if you mapped `RC_MAP_AUX1`).
205
213
@@ -217,75 +225,75 @@ Fixed-wing vehicles (only) can select which axes are tuned using the [FW_AT_AXES
217
225
218
226
</div>
219
227
220
-
## Розробники/SDKs
228
+
## Developers/SDKs
221
229
222
230
Autotuning is started using [MAV_CMD_DO_AUTOTUNE_ENABLE](https://mavlink.io/en/messages/common.html#MAV_CMD_DO_AUTOTUNE_ENABLE) MAVLink command.
223
231
224
232
At time of writing the message is resent at regular intervals to poll PX4 for progress: the `COMMAND_ACK` includes result that the operation is in progress, and also the progress as a percentage.
225
-
Операція завершується, коли прогрес досягає 100% або транспортний засіб приземляється і роззброюється.
233
+
The operation completes when the progress is 100% or the vehicle lands and disarms.
226
234
227
235
:::info
228
236
This is not a MAVLink-compliant implementation of a [command protocol long running command](https://mavlink.io/en/services/command.html#long_running_commands).
229
-
PX4 повинен транслювати прогрес, оскільки протокол не дозволяє опитування.
237
+
PX4 should stream progress as the protocol does not allow polling.
230
238
:::
231
239
232
-
Функція ще не підтримується MAVSDK.
240
+
The feature is not yet supported by MAVSDK.
233
241
234
242
## Background/Detail
235
243
236
244
PX4 uses [PID controllers](../flight_stack/controller_diagrams.md) (rate, attitude, velocity, and position) to calculate the outputs required to move a vehicle from its current estimated state to match a desired setpoint.
237
-
Контролери повинні бути добре налаштовані, щоб отримати найкращу продуктивність з автомобіля.
238
-
Зокрема, погано налаштований регулятор швидкості призводить до менш стабільного польоту у всіх режимах і потребує більше часу на відновлення після перешкод.
245
+
The controllers must be well tuned in order to get the best performance out of a vehicle.
246
+
In particular, a poorly tuned rate controller results in less stable flight in all modes, and takes longer to recover from disturbances.
239
247
240
248
Generally if you use a [frame configuration](../config/airframe.md) that is similar to your vehicle then the vehicle will be able to fly.
241
-
Однак, якщо конфігурація точно не відповідає вашому обладнанню, вам слід налаштувати регулятори швидкості та кута нахилу.
242
-
Налаштування контролерів швидкості та позиції менш важливе, оскільки вони менше піддаються динаміці транспортного засобу, і типова конфігурація налаштування для схожого аеродинамічного корпусу часто є достатньою.
249
+
However unless the configuration precisely matches your hardware you should tune the rate and attitude controllers.
250
+
Tuning the velocity and position controllers is less important because they are less affected by vehicle dynamics, and the default tuning configuration for a similar airframe is often sufficient.
243
251
244
-
Автоналаштування забезпечує автоматичний механізм для налаштування регуляторів швидкості та кута нахилу.
245
-
Це можна використовувати для налаштування літаків з фіксованим крилом та мультикоптерних транспортних засобів, а також літаків VTOL, коли літають як мультикоптерний транспортний засіб або з фіксованим крилом (перехід між режимами повинен бути налаштований вручну).
246
-
Теоретично це повинно працювати для інших типів транспортних засобів, які мають регулятор швидкості, але наразі підтримуються лише вищезазначені типи.
252
+
Autotuning provides an automatic mechanism to tune the rate and attitude controllers.
253
+
It can be used to tune fixed-wing and multicopter vehicles, and VTOL vehicles when flying as a multicopter or as a fixed-wing (transition between modes must be manually tuned).
254
+
In theory it should work for other vehicle types that have a rate controller, but currently only the above types are supported.
247
255
248
256
Automatic tuning works well for the multicopter and fixed-wing vehicle configurations supported by PX4, provided the frame is not too flexible
249
257
(see [below for more information](#does-autotuning-work-for-all-supported-airframes)).
250
258
251
259
The vehicle must be flying in an altitude-stabilized mode (such as [Altitude mode](../flight_modes_mc/altitude.md), [Hold mode](../flight_modes_mc/hold.md), or [Position mode](../flight_modes_mc/position.md)).
252
-
Стек польоту застосує невелике збурення до транспортного засобу в кожній з осей, а потім спробує розрахувати нові налаштувальні параметри.
253
-
Для літаків нове налаштування застосовується в повітрі за замовчуванням, після чого транспортний засіб перевіряє нові налаштування і повертає налаштування, якщо контролери нестабільні.
254
-
Для мультикоптера транспортний засіб приземляється і застосовує нові параметри налаштування після відбронювання; пілот повинен обережно злетіти і протестувати налаштування.
260
+
The flight stack will apply a small disturbance to the vehicle in each axis and then attempt to calculate the new tuning parameters.
261
+
For fixed-wing vehicles the new tuning is applied in-air by default, after which the vehicle tests the new settings and reverts the tuning if the controllers are not stable.
262
+
For multicopter, the vehicle lands and applies the new tuning parameters after disarming; the pilot is expected to then take off carefully and test the tuning.
255
263
256
264
The tuning process takes about 40 seconds ([between 19 and 70 seconds](#how-long-does-autotuning-take)).
257
265
The default behaviour can be configured using [parameters](#optional-configuration).
258
266
259
267
### Часто Запитувані Питання
260
268
261
-
#### Які типи кадрів підтримуються?
269
+
#### What frames types are supported?
262
270
263
-
Автоналаштування увімкнено для мультикоптерів, фіксованих крил та гібридних VTOL фіксованих крилових літаків.
271
+
Autotuning is enabled for multicopter, fixed-wing, and hybrid VTOL fixed-wing vehicles.
264
272
265
-
Хоча це ще не активовано для інших типів кадрів, в теорії його можна використовувати з будь-яким кадром, який використовує контролер швидкості.
273
+
While it is not yet enabled for other frame types, in theory it an be used with any frame that uses a rate controller.
266
274
267
-
#### Чи працює автоналадка для всіх підтримуваних конструкцій?
275
+
#### Does autotuning work for all supported airframes?
268
276
269
-
Математична модель, яку використовує автоналаштування для оцінки динаміки дрона, передбачає, що це лінійна система без зв'язку між осями (SISO) та з обмеженою складністю (2 полюси та 2 нулі).
270
-
Якщо справжній безпілотник занадто далеко від цих умов, модель не зможе відтворити реальну динаміку безпілотника.
277
+
The mathematical model used by autotuning to estimate the dynamics of the drone assumes this it is a linear system with no coupling between the axes (SISO), and with a limited complexity (2 poles and 2 zeros).
278
+
If the real drone is too far from those conditions, the model will not be able to represent the real dynamics of the drone.
271
279
272
-
На практиці, автоналаштування, як правило, добре працює для планерів та мультикоптерів, за умови, що рама не занадто гнучка.
280
+
In practise, autotuning generally works well for fixed-wing and multicopter, provided the frame is not too flexible.
273
281
274
-
#### Як довго триває автоналагодження?
282
+
#### How long does autotuning take?
275
283
276
-
Налаштування займає 5-20 секунд на вісь (припиняється, якщо налаштування не вдалося встановити за 20 секунд) + пауза 2 секунди між кожною віссю + 4 секунди тестування, якщо нові коефіцієнти застосовано у повітрі.
284
+
Tuning takes 5s-20s per axis (aborted if tuning could not be established in 20s) + 2s pause between each axis + 4s of testing if the new gains are applied in air.
277
285
278
-
Мультикоптер повинен налаштовувати всі три осі, і за замовчуванням не перевіряє нові виграші у повітрі.
286
+
A multicopter must tune all three axes, and by default does not test the new gains in-air.
279
287
Tuning will therefore take between 19s (`5 + 2 + 5 + 2 + 5`) and 64s (`20x3 + 2x2`).
280
288
281
-
За замовчуванням літак налагоджує всі три осі, а потім перевіряє нові коефіцієнти в повітрі.
289
+
By default a fixed-wing vehicle tunes all three axes and then tests the new gains in-air.
282
290
The range is therefore between 25s (`5 + 2 + 5 + 2 + 5 + 2 + 4`) and 70s (`20x3 + 3x2 + 4`).
283
291
284
-
Зверніть увагу, що вищезазначені налаштування є значеннями за замовчуванням.
285
-
Мультикоптер може вибрати проведення тестів в повітрі, а планер може вибрати не робити цього.
286
-
Додатково, літак з фіксованим крилом може вибрати налаштувати менше вісей.
292
+
Note however that the above settings are defaults.
293
+
A multicopter can choose to run the tests in air, and a fixed-wing can choose not to.
294
+
Further, a fixed-wing can choose to tune fewer axes.
287
295
288
-
За анекдотичними даними, зазвичай це займає близько 40 секунд для будь-якого засобу пересування.
296
+
Anecdotally, it usually takes around 40s for either vehicle.
289
297
290
298
<!--
291
299
#### How vigorous is the disturbance applied by tuning
0 commit comments