Розробка
Цей розділ — для тих, хто хоче вийти за межі звичайного користування Flipper: зібрати прошивку Unleashed з початкового коду, написати власні застосунки на C або JavaScript, налагодити їх на справжньому пристрої, поспілкуватися з пристроєм через командний рядок або розібратися, як насправді працюють оновлення та апаратна частина.
Unleashed
Unleashed — це форк офіційної прошивки, який залишається повністю сумісним з офіційним API та застосунками. Майже все з офіційної документації для розробників застосовне без змін. Основне, що варто пам’ятати:
- клонуйте
https://github.com/DarkFlippers/unleashed-firmware, а не офіційний репозиторій; - коли збираєте застосунки за допомогою uFBT, вказуйте йому SDK Unleashed (
--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 у застосунках | Діалоги, ViewPort, Views і Scenes, модулі представлень |
| Налагодження застосунків | SWD-зонди, налагодження у VS Code, сигнали налагодження Furi HAL |
| FuriHalBus API | Як правильно вмикати та вимикати периферію MCU, карта каналів DMA |
| JavaScript на Flipper | Пишіть скрипти на JavaScript замість C (окрема група сторінок) |
| JS-модулі лише в Unleashed | subghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — їх немає ні в стоковій прошивці, ні в офіційній документації |
Робота з пристроєм
| Сторінка | Що дає |
|---|---|
| Командний рядок (CLI) | Підключення через USB-serial; усі команди CLI з аргументами |
| OTA-оновлення | Як працює оновлювач, поля маніфесту, коди помилок [XX-YY], збірка пакетів |
| Формат tar + heatshrink | Контейнер .tar.hs, у якому лежать ресурси пакетів оновлення |
| Апаратна частина | Технічні характеристики, схеми, 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 — його варто прочитати.
