Перейти к содержимому
1

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.0, 5.5) и при подготовке занятий Задачи 2 (статьи 2.1–2.8), Задачи 3 (метеовводные — статьи 3.6, 3.7) и дополнительных сценариев Модуля 5 (статья 5.2). Рекомендуемое время изучения — около 30 минут; далее библиотека используется как справочник.

Версия имеет значение. В ArduPilot 4.7 параметры спутникового позиционирования перенесены в группу с индексом экземпляра: SIM_GPS1_ENABLE, SIM_GPS1_NUMSATS, SIM_GPS1_GLTCH и далее по списку раздела 3.2; прежние имена SIM_GPS_NUMSATS, SIM_GPS_GLITCH и подобные, а также отдельные параметры SIM_GPS_DISABLE, SIM_GPS2_DISABLE удалены. Профиль учебного аппарата собирается по статье 0.4 — там же таблица переименований единиц СИ версии 4.7.
↑ К оглавлению

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.52.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 до 5002.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.5).
↑ К оглавлению

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. Сборка сценария из библиотеки

  1. Выберите строку упражнения в таблице статьи 6.1.
  2. Найдите в разделах 3 и 5.2 параметры, соответствующие вводным сценария.
  3. Установите дозировку: начальное значение (деградация) и конечное (отказ).
  4. Запишите профиль в карточку сценария (форма — статьи 2.0, 6.3): параметры, значения, время подачи, ожидаемая реакция, критерий.

Элемент 2. Проверка вводной до занятия

  1. Запустите SITL с учебным профилем (статья 0.4); выполните тестовый вылет.
  2. Подайте вводную; убедитесь, что признак отказа виден в телеметрии и в журнале.
  3. Проверьте, что отказная логика аппарата настроена (параметры RTL, посадки, геозоны — статьи 1.1.06, 2.2, 2.3).
  4. Верните параметры к норме; сохраните профиль сценария.
Признак готовой библиотеки. Любой сценарий Задач 2 и 3 собирается из разделов 3 и 5.2 без обращения к документации в течение занятия; каждый профиль проверен тестовым вылетом и записан в карточку; время реакции курсантов измеряется по журналу относительно времени подачи параметра.
↑ К оглавлению

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. Ступень 1 (деградация): SIM_GPS1_NUMSATS 6; признак — снижение точности, предупреждение наземной станции.
  2. Ступень 2 (потеря фиксации): SIM_GPS1_NUMSATS 4 и SIM_GPS1_LCKTIME 20; ожидаемая реакция — переход к режиму без позиционирования по отказной логике (статьи 1.1.07, 2.3).
  3. Ступень 3 (помехи): SIM_GPS1_JAM 1; возврат фиксации после выключения — SIM_GPS1_JAM 0 и восстановление числа спутников до 12.
  4. Каждая ступень подаётся не ранее завершения процедуры предыдущей; время подачи фиксируется для разбора (статья 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, при котором снос на том же участке достигнет половины длины участка (предел для учебного сценария).

Решение.

  1. Снос без коррекции (статья 3.1): \( 5 / 12 \cdot 100 = 41{,}7\ \text{метра} \) — около 42 метров.
  2. Угол сноса: \( \arcsin(5/12) = 24{,}6^\circ \).
  3. Условие сноса 50 метров на 100 метрах пути: составляющая ветра \( v_w \), при которой \( v_w / 12 \cdot 100 = 50 \); отсюда \( v_w = 6\ \text{метров в секунду} \).
  4. Проверка по дозировке: 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 минут (усиленная дозировка).

Решение.

  1. Время достижения порога: \( 3 / 0{,}3 = 10\ \text{минут} \); с учётом времени на сравнение источников — около 7,7 минуты по опорному примеру статьи 4.3 (дрейф обнаруживается раньше формального порога по тенденции).
  2. Дозировка «5 минут до порога»: требуемая скорость дрейфа \( 3 / 5 = 0{,}6\ \text{метра в минуту} \); в единицах параметра (метры в секунду): \( 0{,}6 / 60 = 0{,}01 \).
  3. Проверка: значение 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. Источники

  1. Исходный код ветки 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
  2. Исходный код ветки 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.
  3. Исходный код ветки 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.
  4. ArduPilot Dev Wiki, «Using SITL for ArduPilot Testing» — порядок работы с параметрами имитации; MAVProxy, команда param set. ardupilot.org/dev/docs
  5. Примечания к релизам ArduPilot 4.7 — переименования параметров в единицах СИ; удаление старых имён группы SIM_GPS. discuss.ardupilot.org
  6. Страницы продуктов Liftoff, Uncrashed, TRYP FPV, Ukrainian Fight Drone Simulator в магазине Steam — средства настройки условий полёта. store.steampowered.com
  7. Статьи настоящего курса: 2.0 (методика имитации отказов), 2.1–2.8 (сценарии отказов), 3.6 (метеовводные маршрута), 4.2–4.3 (нормативы и разбор по журналу).
  8. Статьи настоящего курса: 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