Разработка
Этот раздел — для тех, кто хочет не только пользоваться Флиппером: собрать 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, без ПК |
Написание приложений
| Страница | Что внутри |
|---|---|
| Первое приложение на C | uFBT, шаблон приложения, «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-модули только для Unleashed | subghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — их нет ни в стоковой прошивке, ни в официальной документации |
Работа с устройством
| Страница | Что внутри |
|---|---|
| Командная строка (CLI) | Подключение по USB-serial; все команды CLI с аргументами |
| OTA-обновления | Как работает апдейтер, поля манифеста, коды ошибок [XX-YY], сборка пакетов |
| Формат tar + heatshrink | Контейнер .ths, в котором лежат ресурсы в пакетах обновления |
| Железо | Характеристики, схемы, 3D-модели, чертежи модулей и девбордов |
Тестирование
| Страница | Что внутри |
|---|---|
| Юнит-тесты | Сборка и запуск приложения unit_tests на устройстве, добавление своих тестов |
| Интеграционное тестирование | Ручной тест-план, по которому проверяют PR и релизы |
Другие полезные ресурсы
- Официальная документация для разработчиков (Doxygen): developer.flipper.net — там ищут API прошивки, которых нет в этой вики: системное программирование, разработка приложений, JavaScript, модули расширения, форматы файлов
- Настройка CLion — гайд от Savely Krasovsky
- Туториалы «Hello world!»: на английском (DroomOne), на русском (Павел Яковлев)
- Как написать своё приложение
Структура репозитория прошивки
| Папка | Содержимое |
|---|---|
applications | Приложения и сервисы прошивки |
assets | Ресурсы, используемые приложениями и сервисами |
furi | Furi Core: примитивы и хелперы уровня ОС |
debug | Инструменты отладки: плагины GDB, SVD-файл и т. п. |
documentation | Исходники документации и конфиги генератора |
firmware | Исходный код прошивки |
lib | Собственные и сторонние библиотеки, драйверы |
site_scons | Хелперы сборки |
scripts | Вспомогательные скрипты и Python-библиотеки |
targets | Описания аппаратных таргетов (f7, f18) |
Во многих папках есть свой ReadMe.md — их стоит почитать.
