La idea
El equipo empieza a diseñar una herramienta portátil que reúna interfaces de hardware en un dispositivo autónomo y divertido.
HARDWARE HACKING // EXPERIENCIA INTERACTIVA
Flipper Zero:
del mito al laboratorio.
Una guía visual para entender qué hay dentro, qué puede hacer de verdad y cómo pasar de usuario a creador de aplicaciones.
13capítulos
8tecnologías
1app real
SUB-GHZ
NFC
GPIO
Imagen oficial · Flipper Devices
Desliza para explorar↓
01
ORÍGENES // DE IDEA A PLATAFORMA
No nació como “un control para hackear todo”.
Nació como una multiherramienta abierta y cotidiana para explorar protocolos digitales y radio, con una mascota que convierte el aprendizaje en juego.
La comunidad
La campaña pública valida el concepto: hardware abierto, pantalla monocroma, mascota y un ecosistema pensado para crecer.
Flipper en manos reales
Comienzan las entregas a usuarios. El firmware, la documentación y las aplicaciones comunitarias maduran rápidamente.
Firmware 1.0
Flipper Devices publica la primera versión mayor estable después de años de mejoras continuas.
Flipper One
La empresa abre el desarrollo de una nueva multiherramienta Linux. Sigue en prototipo y sus especificaciones pueden cambiar.
KICKSTARTER // 30 JUL — 29 AGO 2020
$4,882,784 recaudados sobre una meta de $60,00037,987 patrocinadores validaron en 30 días una idea que parecía de nicho. La cifra histórica correcta corresponde a patrocinadores de Kickstarter, no a “80,000 unidades del primer lote”.
¿QUIÉN LO USA?
No existe un único perfil de usuario.
PentestersAuditoría físicaRF e IoTCTFFirmwareDesarrollo de appsEducaciónElectrónica DIY
Su valor común es reducir la distancia entre observar un protocolo y tocarlo: pantalla, controles, almacenamiento y hardware especializado funcionan sin depender de una computadora durante cada práctica.
PERSONA // FUNDADOR Y CREADOR
Pavlo “Pavel” Zhovner
Pavlo Zhovner es un entusiasta del hardware y la seguridad originario de Odesa, Ucrania. Fundó Flipper Devices y concibió Flipper Zero junto con Alex Kulagin y un equipo multidisciplinario de ingeniería, diseño y firmware.
Su perfil profesional utiliza Pavlo, la forma ucraniana del nombre; el blog oficial de Flipper publica sus artículos como Pavel Zhovner. Actualmente vive y trabaja en Londres.
ARCHIVO // ANTES DEL PRODUCTO FINAL
El Flipper que conocemos nació después de muchas pruebas.
Los primeros conceptos exploraron otras proporciones, ubicación de pantalla, botones y volumen interno. El prototipo funcional ya mostraba la pantalla naranja, la cruceta y la mascota, pero todavía estaba lejos de la carcasa producida en serie.
La documentación oficial de 2020 identifica la primera placa pública como F1B1C0.0 y explica que el hardware y el firmware atravesaron varias iteraciones. Ver registro del prototipo ↗
PASAPORTETu delfín digitalEscritorio → pulsa Derecha
Ajustes → Passport
Ajustes → Passport
MASCOTA VIRTUAL // APRENDER TAMBIÉN ES JUGAR
El delfín cambia contigo.
No es solamente una animación. El firmware oficial convierte el uso habitual de NFC, RFID, Sub-GHz, infrarrojo, iButton, BadUSB y U2F en experiencia para la mascota. En su pasaporte puedes consultar nombre, estado de ánimo, nivel y progreso.
CAPTURAR / VER +1 XPEMULAR GUARDADO +2 XPLEER Y GUARDAR hasta +3 XPBADUSB / U2F +3 XP
Límites oficiales: hasta 20 XP diarios por aplicación y 140 XP totales al día. El ánimo depende de cuánto interactúas con el equipo; Happy Mode puede mantenerlo feliz. Los firmwares comunitarios pueden modificar niveles, animaciones y reglas.
Cómo funciona la mascota · documentación oficial ↗02
ANATOMÍA // LO QUE REALMENTE LLEVAS
Pequeño por fuera. Especializado por dentro.
CC1101Sub-GHz
ST25R3916NFC 13.56 MHz
STM32WB55MCU + Bluetooth
125 kHzRFID LF
LCD128 × 64Monocroma, visible al sol
Datos técnicos consultados el 20 de agosto de 2026. Ficha oficial ↗
HARDWARE INTERNO // MAPA COMPLETO
La carcasa une cuatro capas.
La vista exterior oculta una placa principal, una placa de antenas, batería, pantalla, controles y conectores. Esta es la ficha que faltaba para leer el equipo de arriba hacia abajo.
Cortex‑M4 a 64 MHz para aplicaciones y Cortex‑M0+ dedicado a la radio Bluetooth; 256 KB SRAM y 1 MB de flash interna.
Un sistema de tiempo real diseñado para hardware embebido, no un Linux de escritorio. Las apps FAP amplían el firmware desde la microSD.
Guarda bases de datos, señales, llaves, remotos, payloads, recursos y aplicaciones externas. Una tarjeta de 16–32 GB suele ser suficiente.
USB HID/serie/U2F; 18 pines con UART, SPI e I²C; y contactos 1‑Wire para Dallas, Cyfral y Metakom.
PRIMEROS 15 MINUTOS // CONTROLES Y PREPARACIÓN
Antes de capturar nada, aprende a volver.
El D‑pad siempre conserva la misma lógica básica; los atajos del escritorio pueden variar o personalizarse según firmware.
↑UP←LEFTOKCONFIRMAR→RIGHT↓DOWN↩BACK
- FLECHAS
- Navegan menús, teclados y valores.
- OK
- Confirma; desde Desktop abre Main Menu.
- BACK
- Vuelve, cancela o sale de una app.
- UP EN DESKTOP
- Abre Lock Menu: bloqueo, silencio y Dummy Mode.
- ATAJOS
- Direcciones configurables abren Archive, Passport o apps favoritas.
- INFO
- Mantén DOWN para ver datos del dispositivo.
No viene incluida. Es necesaria para el uso normal y para guardar bases, capturas y FAP; 16–32 GB de buena calidad suele bastar.
Usa qFlipper por USB o Flipper Mobile por Bluetooth. Así partes de bases, API y correcciones recientes.
Realiza un reinicio normal sin borrar tus archivos. BACK durante 30 segundos fuerza un reinicio de hardware.
Permite control remoto, actualización OTA, sincronización de archivos y acceso al catálogo desde Android o iOS.
03
TECNOLOGÍAS // UNA POR UNA
Ocho interfaces. Ocho reglas distintas.
Selecciona una tecnología. La pregunta correcta no es “¿hackea?”, sino “¿qué protocolo habla, a qué distancia y con qué límites?”.
300–928 MHz · según región
Sub-GHz
Radio para analizar mandos, sensores y otros dispositivos de corto alcance que operan por debajo de 1 GHz.
SÍ PUEDE
Analizar señales compatibles, guardar muestras y reproducir protocolos de código fijo permitidos por hardware y región.
NO SIGNIFICA
Que pueda predecir rolling codes, descifrar cualquier mando o transmitir en toda frecuencia.
Ejemplo de taller
Comparar una señal fija virtual con otra de código cambiante en el emulador.
Probar simulación →04
GPIO // EL FLIPPER QUE PUEDE CRECER
Un puerto. Todo un ecosistema de hardware.
El conector superior no es decoración: permite sumar microcontroladores, radios, buses industriales, sensores y prototipos. Elige un módulo para descubrir qué agrega y qué software necesita.
El encabezado expone pines de energía y E/S conectados al STM32WB55.
Que exista un riel de 5 V no convierte las entradas y salidas en lógica de 5 V.
El Flipper puede controlar módulos, puentear interfaces y ejecutar apps que entiendan cada periférico.
Especialmente con módulos de carga capacitiva alta: protege la microSD y la alimentación del equipo.
DESARROLLO // WI-FI
WiFi Developer Board
La placa oficial basada en ESP32-S2 nació para actualizar y depurar firmware de forma inalámbrica o por USB. También es una plataforma programable para proyectos Wi-Fi.
- CHIP PRINCIPAL
- ESP32-S2-WROVER
- ENLACE
- UART · SWD · USB
- SOFTWARE CLAVE
- Black Magic Probe
PARA APRENDER
Depuración en circuito, consola serial, firmware de ESP32 y comunicación entre dos microcontroladores.
NECESITA
Firmware compatible en la placa y, para funciones especiales, una app compañera en el Flipper.
Importante: WiFi Dev Board y Marauder no son sinónimos. Marauder es firmware comunitario que puede instalarse en hardware ESP32 compatible; no es la función oficial predeterminada de la placa.
Documentación oficial ↗Amplían 2.4 GHz, Sub-GHz o geolocalización según chip, antena, región y aplicación.
Añaden potencia infrarroja, medición o control físico; cada circuito exige alimentación y niveles correctos.
Permiten diseñar una expansión propia con los planos mecánicos y el pinout publicados por Flipper.
Las placas “todo en uno” integran varios chips, pero un selector, el pinout y el firmware determinan cuál funciona.
PRUEBAS REALES // LABORATORIO DE ROGER
Del pin a la pantalla: GPIO funcionando de verdad.
Estas fotografías y el video no son renders de fabricante: documentan pequeñas pruebas realizadas con el Flipper del taller, módulos conectados al encabezado GPIO y aplicaciones capaces de conversar con ellos.
Material propio del taller · pruebas GPIO realizadas y fotografiadas por Roger Arana ↗
05
MITOS Y VERDADES // TOCA PARA REVELAR
TikTok muestra el efecto. Aquí vemos el protocolo.
Abre cada tarjeta para descubrir qué parte es real, cuál está exagerada y qué control técnico cambia el resultado.
06
COMPARATIVA // LA HERRAMIENTA SEGÚN EL VECTOR
Una navaja suiza que reúne múltiples vectores en un solo bolsillo.
La comparación no busca declarar un ganador. Las herramientas especializadas resuelven un vector concreto; Flipper Zero es singular porque integra radio, credenciales, infrarrojo, USB, GPIO, pantalla, almacenamiento y aplicaciones en una sola experiencia autónoma.
MULTIHERRAMIENTA
Flipper Zero
La herramienta que permite pasar de una tecnología a otra sin cambiar de equipo.
Vectores integrados7+
Listo de bolsilloMuy alto
- DESTACA EN
- Sub-GHz, RFID, NFC, IR, iButton, GPIO y USB desde una sola interfaz.
- APORTA A LA MESA
- Permite enseñar conceptos, prototipar y llevar un laboratorio portátil sin computadora.
- RELACIÓN CON FLIPPER
- Es el centro multipropósito; los demás equipos amplían un área concreta del laboratorio.
| Dispositivo | Vector principal | Qué trae integrado | Qué necesita para cubrir más | Papel en el laboratorio |
|---|---|---|---|---|
| Flipper Zero | Multiprotocolo | Sub-GHz, NFC, RFID LF, IR, BLE, iButton, USB y GPIO | Sus módulos GPIO amplían Wi-Fi, 2.4 GHz, CAN, cámaras y sensores | La navaja suiza y punto de unión |
| USB Rubber Ducky | Automatización HID | USB + DuckyScript | Otros dispositivos para radio, tarjetas o GPIO | Ejemplo especializado de una función que Flipper también incorpora |
| WiFi Pineapple | Wi-Fi 802.11 | Radios Wi-Fi, Linux e interfaz web | Hardware adicional para RFID, Sub-GHz, IR o iButton | Estación dedicada que acompaña la demostración Wi-Fi |
| Chameleon Ultra | RFID/NFC | 125 kHz + ISO14443A | Equipos separados para los demás vectores | Amplía el bloque de credenciales y tarjetas |
| Ubertooth One | Bluetooth 2.4 GHz | Captura y experimentación Bluetooth | Computadora y herramientas para análisis; otros radios para más vectores | Complementa el BLE integrado del Flipper |
| YubiKey 5 NFC | Identidad y autenticación | FIDO2, U2F, PIV, OTP y NFC | No pretende cubrir radio ni prototipado | Contrasta exploración con protección de identidades |
| ESP32 | Wi-Fi/BLE y desarrollo | Microcontrolador y radios según la placa | Pantalla, batería, botones, almacenamiento y módulos externos | Motor flexible detrás de muchas expansiones GPIO |
| M5Stack + Bruce | Wi-Fi/BLE programable | ESP32, pantalla y controles según el modelo | CC1101, nRF24, RFID, IR u otros módulos según la función | Plataforma modular que muestra cuánto integra Flipper de fábrica |
| Electronic Cats Minino | Redes IoT multiprotocolo | ESP32‑C6, Wi‑Fi 6, BLE, Zigbee, Thread, Matter, GPS, OLED y microSD | Hardware aparte para Sub‑GHz, RFID LF, NFC, iButton o IR | Navaja especializada en radio IoT y captura PCAP |
| ESP32 Marauder | Laboratorio Wi‑Fi | Wi‑Fi y controles según la placa que ejecute el firmware | Flipper, pantalla, GPS, SD o periféricos según el montaje | Firmware especializado que también puede vivir en un módulo del Flipper |
La idea central: llevar todas estas herramientas permite mostrar especialidades distintas, pero solo Flipper Zero ofrece una ruta continua entre tantos vectores desde el mismo menú, la misma pantalla y el mismo dispositivo.
07
FIRMWARES // DIFERENCIAS SIN FANATISMOS
El hardware es el mismo. La experiencia cambia.
La elección depende de estabilidad, personalización, apps incluidas y cuánto quieres alejarte del soporte oficial.
RECOMENDADO PARA EMPEZAR
Official
La referencia mantenida por Flipper Devices: documentación, recuperación, API pública y comportamiento esperado parten de aquí.
- Versión estable consultada: 1.4.3
- Actualización por qFlipper, app móvil o paquete oficial
- Base más clara para aprender y diagnosticar fallos
- Compatibilidad de catálogo y límites regionales mantenidos por el fabricante
- Menos apps comunitarias preinstaladas y personalización más conservadora
PERSONALIZACIÓN
Momentum
Firmware comunitario basado en Official, con aportes de Unleashed y una capa muy extensa de personalización; continúa el trabajo de Xtreme.
- Última versión consultada: mntm-012
- Asset Packs, temas, iconos, fuentes, keybinds y nombre personalizable
- Más apps, parsers, protocolos y administración de archivos desde el equipo
- Sistema de niveles ampliado hasta 30 y ajustes avanzados de interfaz
- Equipo del taller: mntm-012 · API 87.1
RADIO + CALIDAD DE VIDA
Unleashed
Fork comunitario de Official orientado a nuevas funciones, mejoras de componentes y experimentación, manteniendo compatibilidad declarada con la API y apps oficiales.
- Última versión consultada: unlshd-092
- Más protocolos y opciones para Sub-GHz
- Canales estables y builds de desarrollo separados
- Web Installer, qUnleashed y herramientas complementarias
- Menos orientado a temas visuales que Momentum
EXPERIMENTACIÓN
RogueMaster
Distribución comunitaria que agrega proyectos, juegos, plugins, assets y cambios procedentes de múltiples ramas del ecosistema.
- Última release pública consultada: RM0819-2255-b3dd8981
- La colección preintegrada más extensa de esta comparación
- Variantes, plugins, juegos y assets con cambios frecuentes
- Útil para explorar mucho contenido sin instalarlo uno por uno
- Más tamaño y más variables cuando una app o función falla
| Si priorizas… | Official | Momentum | Unleashed | RogueMaster |
|---|---|---|---|---|
| Documentación y soporte del fabricante | Referencia | Comunidad | Comunidad | Comunidad |
| Personalizar interfaz y controles | Básico | Muy amplio | Intermedio | Amplio por variantes |
| Apps y contenido preintegrado | Catálogo aparte | Amplio y seleccionado | Ampliado | Muy amplio |
| Protocolos y opciones Sub-GHz | Región y soporte oficial | Opciones extendidas | Foco destacado | Hereda y agrega cambios |
| Diagnóstico sencillo | Menos variables | Más ajustes | Más ajustes | Más componentes |
| Perfil recomendado | Primera vez, clase y desarrollo base | Uso diario personalizado | Radio y experimentación | Exploración de plugins y variantes |
Procesador, memoria, pantalla, antenas y límites eléctricos siguen siendo los del mismo Flipper Zero.
Menús, apps incluidas, protocolos, configuraciones, animaciones, herramientas y ritmo de actualización.
Anota versión, API y región; crea un backup con qFlipper y conserva tus archivos de la microSD.
El binario debe coincidir con la API del firmware instalado; el mismo código fuente puede recompilarse para otro SDK.
La app no declara “para Momentum” o “para Official” como una etiqueta mágica.
Un archivo .fap incluye la API que necesita. El cargador comprueba la versión mayor de API y el hardware objetivo. Si usas APIs exclusivas de un firmware comunitario, documenta firmware, versión y API probados; si usas APIs públicas comunes, recompila contra el SDK del firmware de destino.
Versiones consultadas el 24 de agosto de 2026 en las páginas de releases enlazadas. Una versión nueva puede cambiar etiquetas, API y funciones.
08
EN DESARROLLO ACTIVO · DATOS PRELIMINARES
FLIPPER ONE // LO CONFIRMADO
Ya no es un rumor.
Pero tampoco está a la venta.
Flipper One es una multiherramienta Linux portátil de nueva escala. Combina un SoC potente con un microcontrolador de bajo consumo para que los botones y la pantalla sigan disponibles incluso cuando Linux está apagado.
CPU8 núcleos4× A72 + 4× A53
MEMORIA8 GBLPDDR5
ALMACENAMIENTO64 GBUFS 2.2
CONECTIVIDADWi-Fi 6E2×2 + Bluetooth 5.2
PANTALLA256 × 14464 niveles de gris
BATERÍA7000 mAh**todavía no final
No es “un Zero más rápido”. Por arquitectura y puertos apunta a redes, Linux, expansión M.2 y automatización avanzada. Lo razonable es verlo como complemento de Flipper Zero, no como reemplazo confirmado.
LAYER ZERO vs LAYER ONEDos herramientas distintas que se complementan.Flipper Zero se centra en protocolos de acceso directo; Flipper One amplía el trabajo hacia redes IP y Linux.
Ver comparación oficial ↗FLIPPER OS // LINUX SIN MIEDO A ROMPERLO
No es otra distribución.
Es la capa que organiza Debian.
Flipper OS se plantea como un administrador de perfiles e instantáneas sobre un sistema Debian estándar. Linux conserva sus paquetes, tutoriales y acceso directo al hardware; la capa Flipper permite cambiar de personalidad, experimentar y volver a un estado conocido sin reinstalar todo.
PERFILES DE ARRANQUEUn mismo equipo.
Un mismo equipo.
Cinco personalidades.
Cada perfil puede llevar su propio kernel y sistema raíz. /home, registros y caché se comparten para no duplicar los datos personales. Btrfs usa copy-on-write: crear una instantánea o clonar un perfil toma segundos y solo consume espacio cuando algo cambia.
Arranque mínimo para rescate, mantenimiento o una base limpia.
NAT, DHCP, punto de acceso, cliente y gateway VPN.
Puente Ethernet transparente, captura PCAP y espejo en vivo.
Entorno gráfico Linux conectado a pantalla por HDMI o DisplayPort.
Perfil de sala para pantalla, audio y aplicaciones multimedia.
ELIGE EN BOOT MENU→CLONA UN PERFIL→EXPERIMENTA→CREA SNAPSHOT→RESTAURA SI ALGO FALLA
¿QUÉ HARÁ? // CASOS DOCUMENTADOS
De multiherramienta a laboratorio Linux de bolsillo.
Router Wi-Fi 6
Compartir Ethernet o USB mediante NAT y DHCP, mientras trabaja como cliente y punto de acceso incluso en bandas distintas.
Gateway VPN
Perfiles para WireGuard, IKEv2 u OpenVPN con una ruta de salida controlada y protección prevista contra fugas DNS e IPv6.
Sniffer Ethernet
Insertarse como puente transparente, guardar PCAP o reflejar el tráfico hacia Wireshark y tcpdump para analizarlo.
Descubrir una LAN
Observar primero de forma pasiva y después consultar capas, hosts y servicios con pruebas activas elegidas por el usuario.
USB ↔ red
Presentarse ante una computadora como adaptador Wi-Fi o Ethernet y controlar el enlace desde su propia interfaz.
GPIO, M.2 y pantalla
Ejecutar Linux, conectar periféricos, usar aceleración de IA y llevar la salida a una pantalla externa cuando el proyecto lo necesite.
DOCUMENTADO HOY
- Base Debian y perfiles seleccionables al arrancar
- Snapshots Btrfs y clonación copy-on-write
- Arquitectura dual RK3576 + RP2350
- Documentación y sistema de construcción públicos
TODAVÍA EN DESARROLLO
- Mecanismo definitivo para actualizaciones atómicas
- Catálogo y forma final de compartir perfiles
- Carcasa, detalles de hardware y batería definitivos
- Precio, fecha de venta y especificación comercial final
La lectura correcta: son objetivos y diseños publicados por Flipper Devices, no promesas inmutables. El prototipo actual no está a la venta y el proyecto sigue abierto a cambios.
09
DESARROLLO // DE CERO A .FAP
Vamos a construir APP FIT-XVII.
Una app real, pequeña y replicable: presenta cuatro tecnologías, responde a los botones y enseña un dato rápido. El mismo código de esta guía fue compilado, instalado y probado en el Flipper del taller.
01Flipper ZeroCargado, con microSD y cable USB-C de datos.
02ComputadoraWindows, macOS o Linux. No necesitas un IDE pesado.
03Python + pipSe usan una vez para instalar uFBT.
py --version
py -m pip install --upgrade ufbt
mkdir APP_FIT_XVII
cd APP_FIT_XVII
ufbt updateEmpezamos sin asumir que sabes programar.
Código fuente es el texto que una persona puede leer. Compilar significa traducirlo al formato que el Flipper ejecuta. El resultado será un archivo .fap, parecido al ejecutable de una app.
uFBT descarga el kit de desarrollo correcto y se encarga de compilar. Puedes escribir los dos archivos del proyecto con VS Code, Notepad++ o cualquier editor de texto plano.
- El cable debe transportar datos, no solamente cargar.
- La microSD debe estar instalada y reconocida.
- Ejecuta los comandos dentro de la carpeta del proyecto.
- Conserva los nombres exactamente como aparecen.
OK inicia.
Back sale.
Las flechas recorren NFC, RFID LF, Sub-GHz y GPIO.
OK abre una explicación. OK o Back regresa.
Primero decide qué NO hará.
APP FIT-XVII no lee radios, no guarda archivos y no necesita módulos. Solo dibuja texto y escucha botones; por eso cada asistente puede entenderla durante el taller.
Las tres pantallas forman una máquina de estados: el botón cambia el estado y la app vuelve a dibujar. Esa misma idea sirve después para menús mucho más grandes.
- Puedo decir qué hace en una frase.
- Puedo probarla sin accesorios.
- Cada botón tiene una respuesta visible.
APP_FIT_XVII/
├── application.fam metadatos de compilación
├── app_fit_xvii.c toda la app
├── assets/
│ ├── icon.pbm dibujo editable
│ └── icon.png 10×10, 1 bit
├── docs/
│ └── GUIA_PARA_PRINCIPIANTES.md
├── README.md
└── LICENSE
Solo dos archivos hacen que compile.
application.fam describe la app. app_fit_xvii.c contiene lo que dibuja y lo que ocurre con cada botón. El icono permite reconocerla en el menú.
- README
- Explica objetivo, controles, instalación y compatibilidad.
- Guía
- Desarma el ejemplo paso a paso para repetirlo.
- LICENSE
- Permite estudiar, modificar y compartir el código.
- FAP
- Es el binario final que se copia a la microSD.
No necesitas un archivo .h, SceneManager ni carpetas complejas para comenzar.
App(
appid="app_fit_xvii",
name="APP FIT-XVII",
apptype=FlipperAppType.EXTERNAL,
entry_point="app_fit_xvii_app",
requires=["gui"],
stack_size=2 * 1024,
order=10,
fap_category="Tools",
fap_icon="assets/icon.png",
fap_author="Roger Arana",
fap_description="Mini laboratorio interactivo para el taller FIT XVII",
fap_version="1.0",
)Es la ficha de identidad.
appid es el nombre técnico y no debe repetirse. name aparece en pantalla. entry_point debe coincidir exactamente con la función principal del archivo C.
- apptype
- EXTERNAL crea una app instalable.
- requires
- Servicios del firmware que utilizará.
- stack_size
- Memoria para ejecutar funciones locales.
- category
- Carpeta del menú Apps.
- fap_icon
- PNG monocromo de 10 × 10 píxeles.
- versión y autor
- Identifican la entrega del proyecto.
Si cambias el nombre visible, no tienes que renombrar el archivo ni el punto de entrada.
Permite usar pantalla, botones, colas y funciones del firmware.
En vez de recordar 0, 1 y 2 usamos Splash, Cards y Tip.
Agrupa variables relacionadas, como los cinco textos de una tarjeta.
Cada función dibuja, navega o procesa una responsabilidad pequeña.
No duplica toda la app: permite acceder al mismo estado desde callbacks.
Es una función que el sistema llama cuando debe dibujar o recibe un botón.
El ciclo espera eventos hasta que el usuario decide salir.
Reserva memoria al comenzar y la devuelve antes de terminar.
Lee el programa como una receta.
Primero se declaran las herramientas y los moldes. Después se escriben funciones pequeñas. Finalmente, la función principal crea la app, conecta la pantalla y los botones, espera eventos y limpia los recursos.
AppFitXvii* app puede leerse como “una referencia al estado de APP FIT-XVII”. La flecha app->screen significa “entra a ese estado y consulta su pantalla actual”.
No necesitas memorizar C para entender este ejemplo. Sigue el recorrido: dato → estado → evento → nuevo estado → redibujar.
#include <furi.h>
#include <gui/canvas.h>
#include <gui/gui.h>
#include <gui/view_port.h>
#include <input/input.h>
typedef enum {
AppFitScreenSplash,
AppFitScreenCards,
AppFitScreenTip,
} AppFitScreen;
typedef struct {
const char* title;
const char* line1;
const char* line2;
const char* tip1;
const char* tip2;
} AppFitTopic;
static const AppFitTopic app_fit_topics[] = {
{"NFC", "13.56 MHz", "Tarjetas y telefonos",
"Leer no significa", "clonar pagos."},
{"RFID LF", "125 kHz", "Tags de proximidad",
"NFC y RFID LF usan", "frecuencias distintas."},
{"SUB-GHZ", "Mandos y sensores", "Depende de la region",
"Codigo fijo no es", "rolling code."},
{"GPIO", "UART / SPI / I2C", "Modulos externos",
"Sus pines logicos", "trabajan a 3.3 V."},
};Los datos están separados de la pantalla.
El enum pone nombre a los tres estados. El struct define el molde de una tarjeta y el arreglo contiene cuatro tarjetas concretas.
C no necesita una base de datos para esto. Cada texto vive en el programa y topic_index indica cuál se muestra.
Los textos no llevan tildes porque la fuente básica del Flipper no contiene todos los caracteres de español.
static void app_fit_draw_callback(
Canvas* canvas, void* context) {
furi_assert(context);
AppFitXvii* app = context;
canvas_clear(canvas);
canvas_draw_frame(canvas, 0, 0, 128, 64);
if(app->screen == AppFitScreenSplash) {
app_fit_draw_splash(canvas);
} else if(app->screen == AppFitScreenCards) {
app_fit_draw_card(canvas, app);
} else {
app_fit_draw_tip(canvas, app);
}
}La pantalla es un Canvas de 128 × 64.
El callback no decide qué botón se pulsó. Solo mira el estado actual y dibuja la pantalla correspondiente.
canvas_clear borra el fotograma anterior. canvas_draw_frame crea el borde. Las funciones auxiliares dibujan título, textos, contador y ayuda inferior.
Separar dibujo y botones evita convertir la función principal en un bloque imposible de explicar.
if(app->screen == AppFitScreenCards) {
if((event.key == InputKeyLeft) ||
(event.key == InputKeyUp)) {
app_fit_previous_topic(app);
} else if((event.key == InputKeyRight) ||
(event.key == InputKeyDown)) {
app_fit_next_topic(app);
} else if(event.key == InputKeyOk) {
app->screen = AppFitScreenTip;
} else if(event.key == InputKeyBack) {
app->screen = AppFitScreenSplash;
}
}
view_port_update(app->view_port);Botón → cambio → redibujar.
Izquierda y arriba llaman a “anterior”. Derecha y abajo llaman a “siguiente”. Así todas las flechas hacen algo predecible y el contador visible mantiene el contexto.
OK cambia al estado del dato; Back vuelve a la portada. Al final, view_port_update pide al firmware dibujar otra vez.
Los eventos llegan por una FuriMessageQueue; la pantalla nunca espera dentro del callback.
Cargando el código fuente completo…Este es el archivo real completo.
No es pseudocódigo ni un fragmento: la página carga el mismo app_fit_xvii.c incluido en el proyecto descargable y compilado para el taller.
- Includes: habilitan APIs del firmware y C estándar.
- Tipos y datos: describen pantallas, tarjetas y estado.
- Dibujo: tres funciones producen los 128 × 64 píxeles.
- Entrada: el callback guarda pulsaciones en una cola.
- Navegación: anterior y siguiente hacen el recorrido circular.
- Entry point: reserva recursos, ejecuta el ciclo y limpia.
Los comentarios que empiezan con /* son explicaciones para humanos. El compilador los ignora, por lo que puedes copiar todo el bloque sin retirarlos.
# 1. Instalar uFBT una sola vez
py -m pip install --upgrade ufbt
# 2. Entrar al proyecto y obtener el SDK
cd APP_FIT_XVII
ufbt update
# 3. Compilar
ufbt
# 4. Compilar, copiar y abrir por USB
ufbt launch FLIP_PORT=COM3
# Resultado verificado en el taller:
# APPCHK Target: 7, API: 87.1
# /ext/apps/Tools/app_fit_xvii.fapUn comando crea; otro instala.
ufbt produce dist/app_fit_xvii.fap. ufbt launch vuelve a compilar, copia el archivo a la microSD y lo abre.
Alternativa visual: abre qFlipper, entra a la microSD y copia el FAP dentro de /ext/apps/Tools/. Después, en el dispositivo abre Apps → Tools → APP FIT-XVII.
En Windows, revisa el puerto en el Administrador de dispositivos. Si qFlipper está abierto y ocupa COM3, ciérralo antes de ejecutar el comando.
Prueba física realizada: el archivo de 4.100 bytes quedó persistente y el cargador confirmó “APP FIT-XVII is running”.
ufbt --version.APP_FIT_XVII y verifica que allí estén el manifest y el archivo C.entry_point del manifest y app_fit_xvii_app del código deben coincidir carácter por carácter.ufbt update con el SDK de tu firmware y recompila el código.Tools y ruta /ext/apps/Tools/.app->screen y que después se ejecuta view_port_update.El error también enseña dónde mirar.
Lee siempre la primera línea que contiene Error, no solamente la última. Divide el diagnóstico en tres capas: herramienta —uFBT y Python—, proyecto —nombres y código— y dispositivo —puerto, microSD, firmware y API—.
Antes de cambiar muchas cosas, vuelve a ejecutar ufbt. Si compila, el código está bien; si ufbt launch falla después, el problema suele estar en la conexión o compatibilidad.
// Agrega este bloque al final de
// app_fit_topics[] antes de };
{
.title = "BLUETOOTH",
.line1 = "2.4 GHz",
.line2 = "Enlace con el movil",
.tip1 = "La radio BLE vive",
.tip2 = "en el STM32WB55.",
},
// Guarda y repite:
// ufbt
// ufbt launch FLIP_PORT=COM3El reto de un minuto.
- Copia el bloque Bluetooth.
- Pégalo dentro del arreglo.
- Guarda y vuelve a compilar.
- Comprueba que ahora aparece “1/5”.
No debes cambiar la navegación: COUNT_OF(app_fit_topics) cuenta automáticamente cuántas tarjetas existen y mantiene el recorrido circular.
Después prueba a cambiar el texto de portada o crear tu propia quinta tecnología.
SDK usadoMomentum mntm-012
crea →APP FIT-XVIITarget 7 · API 87.1
abre →Flipper del tallerRogerf5
El código y el FAP no son lo mismo.
El código fuente puede recompilarse para distintos firmwares. El FAP descargable de este taller fue construido para Flipper Zero target 7 con Momentum mntm-012 y API 87.1.
Si tu equipo lo rechaza por API, no cambies bytes a mano: actualiza uFBT con el SDK de tu firmware y recompila el mismo código.
APP FIT-XVII usa únicamente APIs GUI públicas; eso hace sencillo recompilarla para Official, Momentum u otro firmware compatible.
COMPILACIÓN VERIFICADAAPP FIT-XVII v1.0Flipper Zero · target 7 · Momentum mntm-012 · API 87.1 · 4.100 bytes
Descargar proyecto ZIP ↓
Ver código C completo ↓
Abrir guía paso a paso ↗
Descargar FAP probado ↓
10
CASO REAL // MAYAN DECODER
De una idea cultural a Flipper Lab.
Mayan Decoder convierte números decimales de 0 a 9999 en numeración maya de base 20 usando concha, puntos y barras. Es pequeña, visual y perfecta para aprender el ciclo completo.
Una conversión clara
Decimal → base 20 → símbolos mayas apilados verticalmente.
Canvas directo
La app dibuja pirámide, concha, puntos y barras sin imágenes pesadas.
Dos velocidades
Flechas para ajustar; OK abre un editor de cuatro dígitos.
4.9 KiB
Una app pequeña, probada en hardware y publicada para instalar.
App(
appid="mayan_decoder",
name="Mayan Decoder",
apptype=FlipperAppType.EXTERNAL,
entry_point="mayan_decoder_app",
stack_size=2 * 1024,
requires=["gui"],
fap_category="Tools",
fap_icon="assets/icon.png",
fap_author="Roger F5",
fap_version="1.1",
)LO QUE ENSEÑA
Una buena primera app resuelve una sola cosa.
- Entrada con D-pad y Back
- Eventos mediante
FuriMessageQueue - Dibujo con
Canvas - ViewPort y ciclo de limpieza
- Icono, capturas, changelog y licencia
11
GIT + FLIPPER LAB // PUBLICACIÓN REAL
El catálogo no recibe tu código: recibe un manifiesto.
Tu fuente vive en un repositorio público de GitHub. El catálogo oficial fija un commit exacto, construye el paquete y lo expone en Flipper Lab después de revisión y merge.
Repositorio de la app
Código, application.fam, licencia, README, changelog, icono y capturas.
Commit inmutable
Publica una versión y copia el SHA de ese estado exacto.
commit_sha: a1b2c3…Manifest del catálogo
Crea applications/Tools/mi_app/manifest.yml en tu fork.
PR, CI y revisión
El bundle se valida. Tras aprobación y merge, la app aparece en el catálogo.
Flipper LabGit de la app
git init -b main
git add application.fam mi_app.c README.md LICENSE
git add assets screenshots docs
git commit -m "Release Mi App v1.0"
git remote add origin https://github.com/USUARIO/mi_app.git
git push -u origin main
git rev-parse HEADmanifest.yml del catálogo
sourcecode:
type: git
location:
origin: https://github.com/USUARIO/mi_app
commit_sha: COPIA_EL_SHA_COMPLETO
short_description: Una frase clara
description: |
Qué hace la app y cómo se usa.
changelog: "@docs/changelog.md"
author: "Tu nombre"
screenshots:
- screenshots/ss0.pngFork, validación y pull request
git clone https://github.com/USUARIO/flipper-application-catalog.git
cd flipper-application-catalog
git remote add upstream https://github.com/flipperdevices/flipper-application-catalog.git
git switch -c USUARIO/mi_app_1.0
# Coloca manifest.yml en applications/Tools/mi_app/
python tools/bundle.py --nolint applications/Tools/mi_app/manifest.yml bundle.zip
git add applications/Tools/mi_app/manifest.yml
git commit -m "Add Mi App v1.0"
git push -u origin USUARIO/mi_app_1.0
gh pr create --repo flipperdevices/flipper-application-catalogChecklist que evita devoluciones
Requisitos basados en la guía vigente del Flipper Apps Catalog ↗.
AHORA TE TOCA // SIN NECESITAR HARDWARE
La teoría se recuerda.
La interfaz se aprende usándola.
Abre el Flipper virtual, navega su menú inspirado en Momentum y completa prácticas con señales, tarjetas y periféricos totalmente simulados.
Entrar al emuladorSin instalaciónFunciona offlineProgreso localHardware simulado
FUENTES // PARA SEGUIR APRENDIENDO
Información abierta y verificable.
Historia y equipo
Pavel Zhovner · blog oficialPavlo Zhovner · perfil profesionalPrimer prototipo documentadoSede global en LondresFlipper Zero y Flipper One
Especificaciones de Flipper ZeroControles y reinicioDesktop, atajos y Dummy ModePrimer inicio y microSDMascota, XP y nivelesFirmware OfficialFirmware MomentumFirmware UnleashedFirmware RogueMasterDocumentación de Flipper OneArquitectura de Flipper OSPerfiles y snapshots BtrfsCasos de uso de Flipper OneArquitectura de FlipCTLArquitectura CPU + MCUDispositivos comparados
USB Rubber DuckyWiFi PineappleChameleon UltraUbertooth OneYubiKey 5 NFCESP32M5StackFirmware BruceElectronic Cats MininoESP32 MarauderMódulos y GPIO
GPIO y módulos oficialesVideo Game ModuleESP32 Marauder para FlipperElectronic Cats Flipper Add-OnsAWOK Dual C5 TouchFeberis ProESP32 Camera SuiteMaterial del taller
Clases de Hardware Hacking de Roger AranaClase3.pdf · páginas 2–7 y 17–18 integradas y contrastadasCampaña histórica de KickstarterCatálogo oficial de aplicacionesAPP FIT-XVII · proyecto completoAPP FIT-XVII · guía para principiantesMayan DecoderMayan Decoder en Flipper LabEmulador didáctico webContenido revisado el 24 de agosto de 2026. Flipper Zero y Flipper One son marcas de Flipper Devices Inc. Este es un proyecto educativo independiente.