6.2. Библиотека параметров имитации отказов: ArduPilot SIM_* версии 4.7, настройки ветра и физики в FPV-симуляторах #
Статья содержит сводную библиотеку параметров имитации отказов ArduPilot SITL версии 4.7 и настроек ветра и физики FPV-симуляторов (Liftoff, Uncrashed, TRYP FPV, UFDS). Это справочник инструктора для подготовки вводных: по каждому параметру указаны назначение, типичные значения сценариев и статья курса, к которой параметр относится. Библиотека дополняет методику статьи 2.0 (карточка сценария, порядок подачи вводных, критерии) и используется в строках таблицы соответствия статьи 6.1. Все имена параметров приведены по исходному коду ветки ArduPilot 4.7; для версии 4.7 действует правило: параметры спутникового позиционирования имеют индекс экземпляра (SIM_GPS1_*), старые имена группы SIM_GPS без индекса удалены. Нормативная основа: дополнительный справочный модуль курса тренажёрной подготовки.
Содержание
- 1. Цели упражнения и место в программе
- 2. Обозначения и глоссарий
- 3. Библиотека параметров ArduPilot SITL 4.7
- 4. Ограничения и предельные значения
- 5. Настройка тренажёров
- 6. Порядок выполнения упражнения
- 7. Типовые ошибки и их разбор
- 8. Практика: расчётные задачи (с решениями)
- 9. Критерии зачёта и чек-лист самопроверки
- 10. Источники
1. Цели упражнения и место в программе
Библиотека отвечает на три вопроса инструктора: каким параметром имитируется конкретный отказ, какие значения соответствуют учебной дозировке вводной и к какой статье курса относится сценарий. Материал используется при составлении карточек сценариев (статьи 2.0, 5.5) и при подготовке занятий Задачи 2 (статьи 2.1–2.8), Задачи 3 (метеовводные — статьи 3.6, 3.7) и дополнительных сценариев Модуля 5 (статья 5.2). Рекомендуемое время изучения — около 30 минут; далее библиотека используется как справочник.
2. Обозначения и глоссарий
| Термин | Определение |
|---|---|
| вводная | изменение условий полёта, подаваемое инструктором через параметры имитации (статья 2.0) |
| деградация | постепенное ухудшение показаний либо качества канала |
| скачок | мгновенное изменение показаний на фиктивную величину; параметры GLTCH |
| заморозка | прекращение обновления показаний при сохранении последнего значения; параметр SIM_BARO_FREEZE |
| дрейф | медленное монотонное смещение показаний; параметры DRIFT |
| дозировка вводной | подбор величины отказа под уровень курсанта: от узнаваемого признака к полному отказу |
| профиль сценария | совокупность значений параметров имитации, сохранённая в карточке сценария |
3. Библиотека параметров ArduPilot SITL 4.7
3.1. Ветер и атмосфера
| Параметр | Назначение | Типичные значения сценариев | Статьи курса |
|---|---|---|---|
| SIM_WIND_SPD | скорость ветра, метры в секунду | от 2 до 5 — Задача 1; от 5 до 8 — Задачи 2 и 3; свыше 8 — отказ от полёта | 1.1.05, 2.6, 3.0, 3.6 |
| SIM_WIND_DIR | направление ветра, градусы (откуда дует) | 0, 90, 180, 270 — продольный и боковой | 1.1.05, 3.1, 3.3 |
| SIM_WIND_TURB | турбулентность (порывистость), масштаб плотности шума | от 0 до 2 — порывы до 1–2 метров в секунду | 2.6, 3.6 |
| SIM_WIND_TC | постоянная времени изменения ветра, секунды | от 1 до 10 — плавность смены ветра | 3.6 |
| SIM_WIND_T, SIM_WIND_T_ALT, SIM_WIND_T_COEF | температура воздуха, высота её измерения и высотный коэффициент | по метеоусловиям сценария; холодная батарея — статья 2.5 | 2.5, 3.6 |
3.2. Спутниковое позиционирование: SIM_GPS1_*
| Параметр | Назначение | Типичные значения сценариев | Статьи курса |
|---|---|---|---|
| SIM_GPS1_ENABLE | включение экземпляра приёмника | 0 — полный отказ приёмника | 2.3 |
| SIM_GPS1_NUMSATS | число видимых спутников | от 10 до 12 — норма; от 5 до 7 — деградация; 4 и менее — потеря фиксации | 2.3, 5.2 |
| SIM_GPS1_LCKTIME | задержка фиксации после включения, секунды | от 0 до 30 — долгий набор спутников | 2.3, 2.8 |
| SIM_GPS1_GLTCH | смещение позиции скачком | от 5 до 50 метров — узнаваемый скачок | 2.3 |
| SIM_GPS1_JAM | имитация помех (подавления) спутникового сигнала | 1 — помехи включены | 2.3, 5.2 |
| SIM_GPS1_NOISE, SIM_GPS1_ACC | шум и декларируемая точность позиции | увеличение — деградация качества решения | 2.1, 2.3 |
| SIM_GPS1_VERR, SIM_GPS1_DRFTALT | ошибка вертикальной скорости и дрейф высоты приёмника | по сценарию рассогласования источников высоты | 2.1, 2.3 |
| SIM_GPS1_LAG_MS, SIM_GPS1_DELAY | задержка выдачи данных, миллисекунды | от 100 до 500 — «вялая» навигация | 2.1 |
| SIM_GPS1_HDG, SIM_GPS1_HDG_OFS | источник курса и его смещение | по сценариям рассогласования курса | 2.1, 3.3 |
| SIM_GPS1_TYPE, SIM_GPS1_HZ, SIM_GPS1_BYTELOS, SIM_GPS1_POS, SIM_GPS1_ALT_OFS, SIM_GPS1_OPTIONS | тип приёмника, частота обновления, потери байтов потока, смещение позиции площадки, смещение высоты, дополнительные опции | настройка профиля; вводные — BYTELOS (потери потока), ALT_OFS (смещение высоты) | 2.0, 2.3 |
3.3. Барометр: SIM_BARO_*
| Параметр | Назначение | Типичные значения сценариев | Статьи курса |
|---|---|---|---|
| SIM_BARO_COUNT | число имитируемых барометров | 2 — сценарии расхождения источников | 2.1 |
| SIM_BARO_RND | шум показаний высоты | от 0,1 до 2 — зашумлённая высота | 2.1 |
| SIM_BARO_DRIFT | дрейф показаний, метры в секунду (по модулю) | 0,005 — около 0,3 метра в минуту для задач на обнаружение | 2.1, 4.3 |
| SIM_BARO_GLITCH | скачок показаний высоты | от 5 до 50 метров | 2.1, 2.3 |
| SIM_BARO_FREEZE | заморозка показаний (1 — заморозить) | 1 — неизменная высота при реальном снижении либо наборе | 2.1 |
| SIM_BARO_DISABLE | отключение барометра | 1 — полный отказ | 2.1, 2.8 |
| SIM_BARO_DELAY | задержка выдачи показаний, миллисекунды | от 100 до 500 | 2.1 |
| SIM_BARO_WCF_* | поправки ветра и потока от винтов на барометр | настройка реалистичности; вводные — редко | 2.1 |
3.4. Магнитометр, вибрации, оптический поток
| Параметр | Назначение | Типичные значения сценариев | Статьи курса |
|---|---|---|---|
| SIM_MAG_RND | шум магнитометра | увеличение — нестабильный курс | 2.1 |
| SIM_MAG_MOT | влияние токов двигателей на магнитометр | по сценарию «курс смещается с увеличением тяги» | 2.1 |
| SIM_MAG_DELAY | задержка выдачи данных магнитометра | от 100 до 500 миллисекунд | 2.1 |
| SIM_MAG1_OFS (и экземпляры 2, 3) | смещения осей магнитометров | рассогласование экземпляров — сценарий выбора источника | 2.1 |
| SIM_VIB_FREQ, SIM_VIB_MOT_MAX, SIM_VIB_MASK, SIM_VIB_HMNC | частота вибраций, максимальные обороты имитации, маска осей, гармоники | вибрации до уровня срабатывания контроля (статьи 2.1, 4.3) | 2.1 |
| SIM_FLOW_ENABLE, SIM_FLOW_RATE, SIM_FLOW_RND, SIM_FLOW_DELAY | оптический поток: включение, частота, шум, задержка | отказ потока в помещении либо деградация над однотонной поверхностью | 2.1, 2.3 |
3.5. Силовая установка и канал управления
| Параметр | Назначение | Типичные значения сценариев | Статьи курса |
|---|---|---|---|
| SIM_ENGINE_FAIL | отказ двигателя (номер либо маска по схеме аппарата) | один двигатель многовинтовой схемы; для самолёта — полный отказ тяги | 2.4 |
| SIM_ENGINE_MUL | множитель тяги двигателей | 0 — отказ; 0,5 — частичная потеря тяги; переходные режимы конвертоплана (статья 5.4) | 2.4, 5.4 |
| SIM_RC_FAIL | отказ канала управления (потеря радиосвязи) | 1 — обрыв; сценарии постепенной деградации дополняются задержкой и потерями потока аппаратуры | 2.2, 5.2 |
| BATT_LOW_MAH, BATT_CRT_MAH, BATT_CAPACITY | пороги батареи (не имитация, но основа энергетических сценариев) | порог предупреждения 30 %, критический 20 % от ёмкости (модель статей 2.5, 3.0) | 1.2.06, 2.5, 3.0 |
| SIM_GPS_LOG_NUM | служебный параметр журнала имитации | не используется как вводная | — |
3.6. Настройки ветра и физики в FPV-симуляторах
| Симулятор | Средства имитации условий | Применение в курсе |
|---|---|---|
| Liftoff | настройка ветра (скорость, направление) в параметрах карты либо сеанса; выбор модели аппарата | упражнения 1.1.01–1.1.05, 1.1.08–1.1.09, 1.2.01, 1.2.03–1.2.05; ступени прогрессии 5.3 |
| Uncrashed | ветер и плотность среды в настройках заезда; трассы с фиксацией времени | точность посадки, трасса на время, призрак заезда (объективный контроль) |
| TRYP FPV | погодные условия крупных локаций (ветер, время суток) | рельеф (3.5), дальние маршруты и фристайл (5.3) |
| UFDS | режим Planner: погода, время суток, платформа и масса, полезная нагрузка, уровень помех каналов | сценарии статьи 5.2; помехи — аналог SIM_RC_FAIL и SIM_GPS1_JAM |
4. Ограничения и предельные значения
| Условие | Значение | Пояснение |
|---|---|---|
| дозировка вводной | от узнаваемого признака к полному отказу | статья 2.0: сначала деградация, затем отказ |
| вводных в первом вылете занятия | не более одной знакомой | статья 5.5 |
| подача вводной на взлёте и посадке | запрещена для курсантов Задачи 1; для Задачи 2 — по сценарию с оговоркой | фазы максимальной нагрузки |
| проверка вводной | до занятия, на тестовом вылете инструктора | элемент 2 раздела 6 |
| возврат параметров | после занятия профиль возвращается к учебному (статья 0.4) | исключение «застрявших» отказов |
| версия прошивки | 4.7 и новее; имена SIM_GPS1_* и SIM_BARO_* | раздел 1; статья 0.4 |
| фиксация в документах | профиль сценария записывается в карточку (статьи 2.0, 6.3) | воспроизводимость занятия |
5. Настройка тренажёров
5.1. Подача параметров через Mission Planner
Параметры имитации доступны в Mission Planner на вкладке
параметров (поиск по префиксу SIM_) либо в консоли MAVProxy
командой param set. Порядок подачи вводной:
установить значение параметра в полёте (большинство параметров
SIM_* применяются немедленно), зафиксировать время подачи
по журналу, наблюдать реакцию курсанта, после выполнения
процедуры вернуть значение к норме. Время подачи и возврата —
основа измерения времени реакции при разборе (статьи 4.2, 4.3;
опорный пример: обнаружение 7,8 секунды, классификация 11 секунд,
парирование 19 секунд).
5.2. Готовые наборы параметров по сценариям
| Сценарий (статья) | Набор параметров |
|---|---|
| Боковой ветер 5 метров в секунду (1.1.05) | SIM_WIND_SPD 5, SIM_WIND_DIR 90 |
| Порывы и сдвиг ветра (2.6) | SIM_WIND_SPD 6, SIM_WIND_TURB 1,5, SIM_WIND_TC 3; сдвиг — ступенчатое изменение SIM_WIND_SPD и SIM_WIND_DIR по высоте (SIM_WIND_T_ALT) |
| Деградация позиционирования (2.3) | SIM_GPS1_NUMSATS 6; затем 4; контроль перехода в режим без позиционирования |
| Скачок позиции (2.3) | SIM_GPS1_GLTCH 20 |
| Имитация помех навигации (2.3, 5.2) | SIM_GPS1_JAM 1 |
| Дрейф барометра (2.1, 4.3) | SIM_BARO_DRIFT 0,005 (около 0,3 метра в минуту) |
| Заморозка барометра (2.1) | SIM_BARO_FREEZE 1 |
| Потеря связи (2.2, 5.2) | SIM_RC_FAIL 1; возврат — 0; проверка отказной логики RTL либо посадки по настройке |
| Отказ двигателя (2.4) | SIM_ENGINE_FAIL по номеру; частичная потеря — SIM_ENGINE_MUL 0,5 |
| Отказ тяги самолёта либо конвертоплана (2.4, 5.4) | SIM_ENGINE_MUL 0 |
6. Порядок выполнения упражнения
Элемент 1. Сборка сценария из библиотеки
- Выберите строку упражнения в таблице статьи 6.1.
- Найдите в разделах 3 и 5.2 параметры, соответствующие вводным сценария.
- Установите дозировку: начальное значение (деградация) и конечное (отказ).
- Запишите профиль в карточку сценария (форма — статьи 2.0, 6.3): параметры, значения, время подачи, ожидаемая реакция, критерий.
Элемент 2. Проверка вводной до занятия
- Запустите SITL с учебным профилем (статья 0.4); выполните тестовый вылет.
- Подайте вводную; убедитесь, что признак отказа виден в телеметрии и в журнале.
- Проверьте, что отказная логика аппарата настроена (параметры RTL, посадки, геозоны — статьи 1.1.06, 2.2, 2.3).
- Верните параметры к норме; сохраните профиль сценария.
7. Типовые ошибки и их разбор
| Ошибка | Как выглядит | Механизм | Устранение |
|---|---|---|---|
| старые имена параметров | SIM_GPS_NUMSATS не находится; вводная не подана | профиль собран по версии до 4.7 | раздел 3.2: группа SIM_GPS1_*; статья 0.4 |
| вводная без дозировки | сразу полный отказ; курсант не успевает увидеть признак | ступень деградации пропущена | раздел 4: от признака к отказу; статьи 2.1–2.3 |
| вводная не проверена | параметр не применяется; занятие сорвано | тестовый вылет пропущен | элемент 2 раздела 6 |
| параметры не возвращены | на следующем занятии «странный» аппарат | профиль сценария остался в параметрах | возврат к учебному профилю (статья 0.4); сохранение профилей сценариев отдельно |
| время подачи не зафиксировано | время реакции нельзя измерить; оценка спорна | журнал не использован | статьи 4.2, 4.3: отметка времени подачи; разбор по журналу |
| смешение средств имитации | ветер «включён» в FPV-симуляторе, а критерий взят из сценария SITL | строка таблицы 6.1 не проверена | статьи 6.1, 3.6 настоящей статьи: соответствие тренажёра и средства |
8. Практика: расчётные задачи (с решениями)
Задачи решаются письменно при сборке первых сценариев. Значения округляются до десятых.
Задача 1. Набор параметров сценария отказа позиционирования
Условие. Собрать профиль сценария статьи 2.3 «деградация — потеря фиксации — помехи» для версии 4.7: указать параметры и значения каждой ступени и порядок подачи, если норма — 12 спутников, деградация — 6, потеря фиксации — 4 спутника с задержкой восстановления 20 секунд, помехи — до конца вылета.
Решение.
- Ступень 1 (деградация): SIM_GPS1_NUMSATS 6; признак — снижение точности, предупреждение наземной станции.
- Ступень 2 (потеря фиксации): SIM_GPS1_NUMSATS 4 и SIM_GPS1_LCKTIME 20; ожидаемая реакция — переход к режиму без позиционирования по отказной логике (статьи 1.1.07, 2.3).
- Ступень 3 (помехи): SIM_GPS1_JAM 1; возврат фиксации после выключения — SIM_GPS1_JAM 0 и восстановление числа спутников до 12.
- Каждая ступень подаётся не ранее завершения процедуры предыдущей; время подачи фиксируется для разбора (статья 4.3).
Ответ: профиль из трёх ступеней: NUMSATS 6, затем NUMSATS 4 с LCKTIME 20, затем JAM 1; порядок — по завершении процедуры предыдущей ступени.
Задача 2. Снос при имитируемом боковом ветре
Условие. Профиль сценария 1.1.05: SIM_WIND_SPD 5, SIM_WIND_DIR 90 (боковой); воздушная скорость аппарата 12 метров в секунду. Определить снос на участке 100 метров без коррекции, требуемый угол сноса и значение SIM_WIND_SPD, при котором снос на том же участке достигнет половины длины участка (предел для учебного сценария).
Решение.
- Снос без коррекции (статья 3.1): \( 5 / 12 \cdot 100 = 41{,}7\ \text{метра} \) — около 42 метров.
- Угол сноса: \( \arcsin(5/12) = 24{,}6^\circ \).
- Условие сноса 50 метров на 100 метрах пути: составляющая ветра \( v_w \), при которой \( v_w / 12 \cdot 100 = 50 \); отсюда \( v_w = 6\ \text{метров в секунду} \).
- Проверка по дозировке: 6 метров в секунду — верхняя граница сценариев Задачи 1 (до 5 метров в секунду); такой ветер переносится в сценарии Задач 2 и 3 (статьи 2.6, 3.6).
Ответ: снос 42 метра; угол сноса 24,6°; половина длины участка достигается при 6 метрах в секунду — за пределами дозировки Задачи 1.
Задача 3. Время обнаружения дрейфа барометра
Условие. Профиль сценария 2.1: SIM_BARO_DRIFT — дрейф около 0,3 метра в минуту. Порог обнаружения по расхождению с прочими источниками высоты — 3 метра. Определить время достижения порога и требуемое значение SIM_BARO_DRIFT, чтобы курсант обнаружил дрейф за 5 минут (усиленная дозировка).
Решение.
- Время достижения порога: \( 3 / 0{,}3 = 10\ \text{минут} \); с учётом времени на сравнение источников — около 7,7 минуты по опорному примеру статьи 4.3 (дрейф обнаруживается раньше формального порога по тенденции).
- Дозировка «5 минут до порога»: требуемая скорость дрейфа \( 3 / 5 = 0{,}6\ \text{метра в минуту} \); в единицах параметра (метры в секунду): \( 0{,}6 / 60 = 0{,}01 \).
- Проверка: значение SIM_BARO_DRIFT 0,01 вдвое больше базового 0,005 — дозировка усилена в два раза, что соответствует переходу от распознавания тенденции к явному признаку.
Ответ: порог достигается за 10 минут (обнаружение по тенденции — около 7,7 минуты); для порога за 5 минут — SIM_BARO_DRIFT 0,01.
9. Критерии зачёта и чек-лист самопроверки
| Проверка | Критерий | |
|---|---|---|
| Версия | профиль SITL — ArduPilot 4.7; используются имена SIM_GPS1_*, SIM_BARO_* | |
| Покрытие сценариев | для каждой строки Задач 2 и 3 таблицы статьи 6.1 есть набор параметров (раздел 5.2) | |
| Дозировка | каждая вводная имеет ступени: признак — деградация — отказ | |
| Проверка | каждый профиль проверен тестовым вылетом инструктора до занятия | |
| Карточки | профили записаны в карточки сценариев (статьи 2.0, 6.3) | |
| Возврат параметров | после занятий профиль возвращается к учебному (статья 0.4) | |
| FPV-симуляторы | для упражнений моторики указаны средства настройки ветра соответствующего симулятора (раздел 3.6) | |
| Задачи раздела 8 | решены письменно; значения параметров подтверждены |
10. Источники
- Исходный код ветки ArduPilot-4.7, libraries/SITL/SITL.cpp — параметры имитации: SIM_WIND_*, SIM_ENGINE_*, SIM_MAG_*, SIM_VIB_*, SIM_FLOW_*, SIM_RC_FAIL, SIM_BARO_COUNT, SIM_GPS_LOG_NUM. github.com/ArduPilot/ardupilot
- Исходный код ветки ArduPilot-4.7, libraries/SITL/SIM_GPS.cpp — группа параметров экземпляра приёмника SIM::GPSParms с префиксом SIM_GPS1_: ENABLE, LAG_MS, TYPE, BYTELOS, NUMSATS, GLTCH, HZ, DRFTALT, POS, NOISE, LCKTIME, ALT_OFS, HDG, ACC, VERR, JAM, HDG_OFS, OPTIONS.
- Исходный код ветки ArduPilot-4.7, libraries/SITL/SITL_Baro.cpp — параметры барометра: SIM_BARO_RND, SIM_BARO_DRIFT, SIM_BARO_DISABLE, SIM_BARO_GLITCH, SIM_BARO_FREEZE, SIM_BARO_DELAY, группа WCF.
- ArduPilot Dev Wiki, «Using SITL for ArduPilot Testing» — порядок работы с параметрами имитации; MAVProxy, команда param set. ardupilot.org/dev/docs
- Примечания к релизам ArduPilot 4.7 — переименования параметров в единицах СИ; удаление старых имён группы SIM_GPS. discuss.ardupilot.org
- Страницы продуктов Liftoff, Uncrashed, TRYP FPV, Ukrainian Fight Drone Simulator в магазине Steam — средства настройки условий полёта. store.steampowered.com
- Статьи настоящего курса: 2.0 (методика имитации отказов), 2.1–2.8 (сценарии отказов), 3.6 (метеовводные маршрута), 4.2–4.3 (нормативы и разбор по журналу).
- Статьи настоящего курса: 0.4 (профиль учебного аппарата, переименования 4.7), 1.1.05 (боковой ветер), 3.0–3.1 (бюджет, снос и угол сноса), 5.2 (сценарии UFDS и аналоги), 5.4 (отказ тяги конвертоплана), 6.1 (таблица соответствия), 6.3 (формы документов).
Проверено: 16.09.2026 по исходному коду ветки ArduPilot-4.7 и документации SITL. Значения параметров в колонке «типичные значения» — учебная дозировка настоящего курса, а не рекомендации разработчика; уточняются инструктором под уровень курсанта и профиль аппарата.
- мод. : Среда, 16 сентября 2026