Русская редакционная адаптация WARPfly на основе руководства Oscar Liang по Blackbox.
Blackbox — бортовой регистратор Betaflight. Он сохраняет команды пилота, показания гироскопа, расчёт PID-регулятора, выходы моторов и служебные параметры. По такому логу можно увидеть то, что невозможно надёжно определить на слух: частоту вибрации, задержку реакции, насыщение моторов или момент появления сбоя. Blackbox особенно полезен для диагностики, но не требует начинать с агрессивного ручного тюнинга.
Где хранится лог
Полётный контроллер может иметь встроенную flash-память или слот microSD. Flash не требует карты и обычно удобна для коротких записей, но её объём ограничен. SD даёт больше места, однако карта должна быть совместимой и достаточно быстрой. Тип устройства выбирается в разделе Blackbox; если пункт недоступен, сначала проверь спецификацию контроллера и целевую прошивку.
По умолчанию запись обычно начинается при арминге и завершается после дизарма. Перед важным тестом очисти старую память или убедись, что свободного места достаточно. Не форматируй карту неизвестным способом: требования к файловой системе и процедуре подготовки нужно сверять с документацией установленной версии Betaflight.
Частота записи
Чем выше logging rate, тем больше деталей и размер файла. Для общего анализа PID часто достаточно порядка 1 кГц. При исследовании шума и фильтров используют более высокую частоту, если контроллер, гироскоп и накопитель справляются без пропусков. Некоторые гироскопы имеют нестандартную внутреннюю частоту, поэтому максимальное значение не обязательно будет круглым числом.
Не выбирай самый большой rate автоматически. Переполненная память, медленная SD-карта или лишняя нагрузка дают повреждённый либо короткий лог. Начни с настройки по умолчанию актуальной прошивки, запиши тест и проверь, что файл открывается без ошибок. Debug mode включают только под конкретный вопрос, потому что он меняет набор дополнительных данных.
Как записать полезный тест
- Проверь крепление полётного контроллера, пропеллеры, моторы и отсутствие люфта в раме.
- Убедись, что память доступна, дата конфигурации сохранена, а Blackbox включён.
- Выбери открытое безопасное место и спокойную погоду.
- Запиши короткий обычный полёт: висение, прямые участки, несколько плавных и резких движений по каждой оси.
- Для анализа шума добавь короткое увеличение газа, не удерживая аппарат долго на опасном режиме.
- Дизармься, отключи аккумулятор и скачай лог до изменения настроек.
Меняй только один параметр между сравниваемыми полётами. Если одновременно изменить PID, фильтры, пропеллеры и аккумулятор, определить причину результата будет почти невозможно. Записывай температуру, ветер, конфигурацию и заметки пилота рядом с каждым файлом.
Открытие в Blackbox Explorer
Лог просматривают в совместимой версии Betaflight Blackbox Explorer. Вместе с файлом полезно сохранить diff или backup настроек: график без контекста прошивки и конфигурации быстро теряет ценность. После загрузки сначала проверь, что временная шкала непрерывна и все основные поля присутствуют.
Для первого разбора достаточно четырёх групп сигналов:
- Setpoint — что попросил пилот стиками.
- Gyro — как аппарат реально вращался.
- PID sum и составляющие P, I, D, FF — как регулятор пытался устранить ошибку.
- Motor outputs — какие команды получили моторы и достигли ли они предела.
В хорошо управляемом аппарате gyro следует за setpoint без длительного отставания и избыточного звона. Короткие расхождения во время манёвра нормальны. Повторяющиеся высокочастотные колебания, сильный отскок после остановки или мотор, долго упирающийся в максимум, требуют отдельного расследования.
Спектральный анализ и шум
Спектр показывает, на каких частотах сосредоточена энергия вибраций. Полосы, меняющиеся вместе с оборотами, часто связаны с моторами и пропеллерами; постоянная частота может указывать на резонанс конструкции или электронику. Но красивый график не заменяет осмотр. Сначала исключают погнутый вал, повреждённый пропеллер, ослабленный винт, касание проводом гироскопа и треснувшую раму.
Фильтры защищают регулятор от шума ценой задержки. Их ослабление без понимания спектра может перегреть моторы. Усиление фильтрации способно скрыть механическую проблему и ухудшить управление. Работай небольшими шагами и после каждого изменения проверяй температуру моторов коротким полётом.
Типичные ошибки анализа
- Сравнивать логи разных прошивок и сборок как равные.
- Делать вывод по одному случайному участку с ударом ветра.
- Тюнить PID до устранения механических дефектов.
- Использовать старое руководство с полями, которых уже нет в текущей версии.
- Забывать, что насыщение моторов ограничивает возможности любого регулятора.
Blackbox не выдаёт готовый диагноз. Он превращает ощущение «коптер летит странно» в проверяемую последовательность: команда, реальная реакция, действие регулятора и ответ моторов.
Для начала достаточно корректно включить запись, получить один чистый лог и научиться сопоставлять setpoint с gyro. Только после этого имеет смысл переходить к спектру, debug-полям и точному тюнингу. При обновлении Betaflight сверяй названия параметров и поддерживаемые частоты с документацией установленной ветки.
Материал подготовлен редакцией WARPfly как самостоятельная русская адаптация темы Oscar Liang и сверен с официальной документацией Betaflight. Иллюстрация Oscar Liang используется с разрешения и обязательной подписью источника.