Skip to content
⚠
Автоматичний переклад

Цю сторінку перекладено автоматично з англійської, тож вона може містити помилки або технічні неточності. Якщо сумніваєтесь — звіряйтеся з англійською чи російською версією. English · Русский

Помітили помилку? Будемо вдячні за виправлення.

Розробка ​

Цей розділ — для тих, хто хоче вийти за межі звичайного користування 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, без ПК

Написання застосунків ​

СторінкаЩо дає
Перший застосунок на CuFBT, шаблон застосунку, «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-модулі лише в Unleashedsubghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — їх немає ні в стоковій прошивці, ні в офіційній документації

Робота з пристроєм ​

СторінкаЩо дає
Командний рядок (CLI)Підключення через USB-serial; усі команди CLI з аргументами
OTA-оновленняЯк працює оновлювач, поля маніфесту, коди помилок [XX-YY], збірка пакетів
Формат tar + heatshrinkКонтейнер .tar.hs, у якому лежать ресурси пакетів оновлення
Апаратна частинаТехнічні характеристики, схеми, 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. Лише для освітнього та законного використання.