Skip to content
⚠
Traducción automática

Esta página se ha traducido automáticamente del inglés y puede contener errores o imprecisiones técnicas. Ante la duda, consulta la versión en inglés o en ruso. English · Русский

¿Has encontrado un fallo? Las correcciones son bienvenidas.

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-firmware en 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 Unleashed y la versión de API actual en dev es la 88.27.

Compilar el firmware ​

PáginaQué encontrarás
Compilar el firmwareClonar, 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 hardwareCómo describen targets/ y target.json las variantes de hardware (f7, f18)
Compilar apps en AndroidCompilar apps .fap en el móvil con Termux + uFBT, sin PC

Escribir apps ​

PáginaQué encontrarás
Tu primera app en CuFBT, 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 FuriArquitectura de hardware y software, el núcleo Furi, furi_assert / furi_check
GUI en las appsDiálogos, ViewPort, Views y Scenes, módulos de vista
Depurar appsSondas SWD, depuración en VS Code, señales de depuración del Furi HAL
API FuriHalBusActivar y desactivar correctamente los periféricos del MCU, mapa de canales DMA
JavaScript en el FlipperEscribir scripts en JavaScript en lugar de C (grupo de páginas aparte)
Módulos de JS solo de Unleashedsubghz, 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áginaQué encontrarás
Interfaz de línea de comandos (CLI)Conectarse por USB serie; todos los comandos de la CLI con sus argumentos
Actualizaciones OTACómo funciona el actualizador, campos del manifiesto, códigos de error [XX-YY], compilar paquetes
Formato tarball heatshrinkEl contenedor .tar.hs usado para los recursos en los paquetes de actualización
HardwareEspecificaciones técnicas, esquemas, modelos 3D, planos de módulos y devboards

Pruebas ​

PáginaQué encontrarás
Pruebas unitariasCompilar y ejecutar la app unit_tests en el dispositivo y añadir tus propias pruebas
Pruebas de integraciónEl plan de pruebas manual que se sigue antes de fusionar PR y publicar releases

Otros recursos útiles ​

Estructura del proyecto del repositorio del firmware ​

CarpetaContenido
applicationsAplicaciones y servicios usados en el firmware
assetsRecursos usados por las aplicaciones y los servicios
furiFuri Core: primitivas y utilidades a nivel de sistema operativo
debugHerramientas de depuración: plugins de GDB, archivo SVD, etc.
documentationFuentes de la documentación y configuración de los generadores
firmwareCódigo fuente del firmware
libBibliotecas propias y de terceros, controladores
site_sconsUtilidades de compilación
scriptsScripts auxiliares y bibliotecas de Python
targetsDefiniciones de los objetivos de hardware (f7, f18)

Muchas de estas carpetas tienen su propio ReadMe.md — vale la pena leerlos.

Sin afiliación con Flipper Devices. Solo para uso educativo y lícito.