Skip to content

Разработка ​

Этот раздел — для тех, кто хочет не только пользоваться Флиппером: собрать Unleashed Firmware из исходников, написать своё приложение на C или JavaScript, отлаживать его на реальном железе, работать с устройством через командную строку или разобраться, как устроены обновления и сама железка.

Unleashed

Unleashed — форк официальной прошивки, который остаётся полностью совместимым с официальным API и приложениями. Почти всё из официальной документации для разработчиков применимо как есть. Главное, что нужно помнить:

  • клонируйте https://github.com/DarkFlippers/unleashed-firmware вместо официального репозитория;
  • при сборке приложений через uFBT укажите ему Unleashed SDK (--index-url=https://up.unleashedflip.com/directory.json), иначе приложение соберётся под официальный SDK и может не запуститься (подробнее);
  • прошивка сообщает о себе как Unleashed, текущая версия API в ветке dev — 88.27.

Сборка прошивки ​

СтраницаЧто внутри
Сборка прошивкиКлонирование, сборка и прошивка Unleashed на Linux, macOS и Windows
Flipper Build Tool (fbt)Все цели, опции и переменные окружения fbt
Аппаратные таргетыКак targets/ и target.json описывают варианты железа (f7, f18)
Сборка приложений на AndroidКомпиляция .fap на телефоне через Termux + uFBT, без ПК

Написание приложений ​

СтраницаЧто внутри
Первое приложение на CuFBT, шаблон приложения, «Hello world» с диалогом, сборка и запуск
Манифесты приложений (.fam)Все поля application.fam, опции внешних приложений, приватные библиотеки
Furi APIАрхитектура железа и софта, ядро Furi, furi_assert / furi_check
GUI в приложенияхDialogs, ViewPort, Views и Scenes, view-модули
Отладка приложенийSWD-отладчики, отладка в VS Code, отладочные сигналы Furi HAL
FuriHalBus APIПравильное включение/выключение периферии MCU, карта каналов DMA
JavaScript на ФлиппереСкрипты на JavaScript вместо C (отдельная группа страниц)
JS-модули только для Unleashedsubghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — их нет ни в стоковой прошивке, ни в официальной документации

Работа с устройством ​

СтраницаЧто внутри
Командная строка (CLI)Подключение по USB-serial; все команды CLI с аргументами
OTA-обновленияКак работает апдейтер, поля манифеста, коды ошибок [XX-YY], сборка пакетов
Формат tar + heatshrinkКонтейнер .ths, в котором лежат ресурсы в пакетах обновления
ЖелезоХарактеристики, схемы, 3D-модели, чертежи модулей и девбордов

Тестирование ​

СтраницаЧто внутри
Юнит-тестыСборка и запуск приложения unit_tests на устройстве, добавление своих тестов
Интеграционное тестированиеРучной тест-план, по которому проверяют PR и релизы

Другие полезные ресурсы ​

Структура репозитория прошивки ​

ПапкаСодержимое
applicationsПриложения и сервисы прошивки
assetsРесурсы, используемые приложениями и сервисами
furiFuri Core: примитивы и хелперы уровня ОС
debugИнструменты отладки: плагины GDB, SVD-файл и т. п.
documentationИсходники документации и конфиги генератора
firmwareИсходный код прошивки
libСобственные и сторонние библиотеки, драйверы
site_sconsХелперы сборки
scriptsВспомогательные скрипты и Python-библиотеки
targetsОписания аппаратных таргетов (f7, f18)

Во многих папках есть свой ReadMe.md — их стоит почитать.

Проект не связан с Flipper Devices. Только для образовательного и законного использования.