Desarrollo
Esta sección es para quien quiera ir más allá de usar el Flipper: compilar el firmware Unleashed desde el código fuente, escribir sus propias apps en C o JavaScript, depurarlas en hardware real, hablar con el dispositivo por línea de comandos o entender cómo funcionan por dentro las actualizaciones y el hardware.
Unleashed
Unleashed es un fork del firmware oficial que se mantiene totalmente compatible con la API y las apps oficiales. Casi todo lo que dice la documentación oficial para desarrolladores se aplica tal cual. Lo principal que hay que tener en cuenta:
- clona
https://github.com/DarkFlippers/unleashed-firmwareen lugar del repositorio oficial; - al compilar apps con uFBT, apúntalo al SDK de Unleashed (
--index-url=https://up.unleashedflip.com/directory.json); de lo contrario, tu app se compila contra el SDK oficial y puede negarse a cargar (detalles); - el origen del firmware se declara como
Unleashedy la versión de API actual endeves la 88.27.
Compilar el firmware
| Página | Qué encontrarás |
|---|---|
| Compilar el firmware | Clonar, compilar y flashear Unleashed en Linux, macOS y Windows |
| Flipper Build Tool (fbt) | Todos los targets, opciones y variables de entorno de fbt |
| Objetivos de hardware | Cómo describen targets/ y target.json las variantes de hardware (f7, f18) |
| Compilar apps en Android | Compilar apps .fap en el móvil con Termux + uFBT, sin PC |
Escribir apps
| Página | Qué encontrarás |
|---|---|
| Tu primera app en C | uFBT, plantilla de app, un «Hello world» con un diálogo, compilar y ejecutar |
| Manifiestos de app (.fam) | Todos los campos de application.fam, opciones de apps externas, bibliotecas privadas |
| API Furi | Arquitectura de hardware y software, el núcleo Furi, furi_assert / furi_check |
| GUI en las apps | Diálogos, ViewPort, Views y Scenes, módulos de vista |
| Depurar apps | Sondas SWD, depuración en VS Code, señales de depuración del Furi HAL |
| API FuriHalBus | Activar y desactivar correctamente los periféricos del MCU, mapa de canales DMA |
| JavaScript en el Flipper | Escribir scripts en JavaScript en lugar de C (grupo de páginas aparte) |
| Módulos de JS solo de Unleashed | subghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — no están en el firmware de serie ni en la documentación oficial |
Trabajar con el dispositivo
| Página | Qué encontrarás |
|---|---|
| Interfaz de línea de comandos (CLI) | Conectarse por USB serie; todos los comandos de la CLI con sus argumentos |
| Actualizaciones OTA | Cómo funciona el actualizador, campos del manifiesto, códigos de error [XX-YY], compilar paquetes |
| Formato tarball heatshrink | El contenedor .tar.hs usado para los recursos en los paquetes de actualización |
| Hardware | Especificaciones técnicas, esquemas, modelos 3D, planos de módulos y devboards |
Pruebas
| Página | Qué encontrarás |
|---|---|
| Pruebas unitarias | Compilar y ejecutar la app unit_tests en el dispositivo y añadir tus propias pruebas |
| Pruebas de integración | El plan de pruebas manual que se sigue antes de fusionar PR y publicar releases |
Otros recursos útiles
- Documentación oficial para desarrolladores (Doxygen): developer.flipper.net — ahí se buscan las APIs del firmware que esta wiki no cubre, con secciones de programación de sistema, desarrollo de apps, JavaScript, módulos de expansión y formatos de fichero
- Configuración de un workspace de CLion — guía de Savely Krasovsky
- Tutoriales de plugins «Hello world!»: en inglés (DroomOne), en ruso (Pavel Yakovlev)
- Cómo escribir tu propia app
Estructura del proyecto del repositorio del firmware
| Carpeta | Contenido |
|---|---|
applications | Aplicaciones y servicios usados en el firmware |
assets | Recursos usados por las aplicaciones y los servicios |
furi | Furi Core: primitivas y utilidades a nivel de sistema operativo |
debug | Herramientas de depuración: plugins de GDB, archivo SVD, etc. |
documentation | Fuentes de la documentación y configuración de los generadores |
firmware | Código fuente del firmware |
lib | Bibliotecas propias y de terceros, controladores |
site_scons | Utilidades de compilación |
scripts | Scripts auxiliares y bibliotecas de Python |
targets | Definiciones de los objetivos de hardware (f7, f18) |
Muchas de estas carpetas tienen su propio ReadMe.md — vale la pena leerlos.
