1. Flipper Zero GPIO: qué aporta y qué no

La cabecera superior de Flipper Zero convierte el dispositivo en una plataforma de exploración de hardware: puedes trabajar con señales digitales, consolas serie, buses de periféricos, depuración y módulos externos. No es, sin embargo, un puerto «plug and play» donde cualquier placa pueda conectarse sin comprobar tensión, corriente, pinout y protocolo.

Según la documentación oficial de GPIO y módulos, la cabecera tiene 18 posiciones físicas; las especificaciones técnicas indican 13 líneas I/O disponibles al usuario. La plataforma usa un STM32WB55 y niveles lógicos CMOS de 3,3 V. La misma documentación indica que el dispositivo puede utilizarse como conversor USB para UART/SPI/I²C, aunque la aplicación GPIO visible documenta específicamente control manual, USB-UART y la activación del riel de 5 V.

Ownership de esta guía

Esta URL explica GPIO, buses y módulos. Para funciones globales de NFC, RFID, Sub-GHz, infrarrojos o BadUSB, vuelve a la guía principal de Flipper Zero. Si tu duda es qué hardware elegir en lugar de Flipper, deriva a alternativas a Flipper Zero.

Todo ejemplo de depuración, consola serie o análisis de dispositivos debe hacerse sobre hardware propio o expresamente autorizado. Tener acceso físico a una cabecera no implica autorización para extraer datos, modificar firmware o eludir controles.

2. Cabecera GPIO, pinout y microcontrolador STM32WB55

GPIO significa General Purpose Input/Output. Una misma patilla del microcontrolador puede asumir distintas funciones según su configuración: entrada digital, salida, función alternativa de un periférico como UART/SPI/I²C, ADC, PWM o interfaz de depuración. Por eso el número físico del conector no equivale a una función fija universal.

Las especificaciones oficiales de Flipper Zero identifican el MCU como STM32WB55RG, con Cortex-M4 para la aplicación y Cortex-M0+ para radio. Las líneas del conector externo llegan al microcontrolador a través de resistencias y cuentan con protección ESD, pero eso no convierte el puerto en tolerante a cualquier tensión o conexión.

DatoValor/documentación actualImplicación práctica
Cabecera superior18 posiciones físicasIncluye I/O, alimentación y masa; no son 18 GPIO independientes.
I/O disponibles13 líneas para el usuarioConsulta siempre el pinout actual antes de cablear.
Nivel lógico3,3 V CMOSNo confundas una línea de señal con el riel de alimentación de 5 V.
MCUSTM32WB55RGLas funciones alternativas dependen del MCU, firmware y recurso reservado.
SWD usado por DevboardPin 10 SWCLK / pin 12 SWDIOLa placa oficial los utiliza para depuración del propio Flipper.

Cuando necesites una función concreta, usa el diagrama oficial y la documentación de firmware como fuente de verdad. Copiar un esquema de Arduino, ESP8266 u otra revisión de placa es una forma fácil de invertir señales o aplicar un voltaje incorrecto.

3. 3,3 V, 5 V, corriente y seguridad eléctrica

La distinción más importante es alimentación ≠ nivel lógico. Flipper Zero dispone de rieles de alimentación de 3,3 V y 5 V, pero las señales digitales del STM32WB55 trabajan a 3,3 V. La ficha técnica actual indica entradas de 5 V tolerantes en el contexto documentado por ST; eso no significa que una salida produzca 5 V ni que puedas inyectar 5 V en cualquier punto sin comprobar pin, modo y condiciones.

  • 3,3 V (pin 9): la documentación oficial indica salida habilitada por defecto y carga máxima de 1,2 A. El riel comparte alimentación con la microSD y puede deshabilitarse temporalmente durante ciertas operaciones de firmware/montaje.
  • 5 V (pin 1): puede alimentarse desde batería o USB. Con batería, la salida no está habilitada por defecto; se activa desde GPIO → 5V on GPIO. Máximo documentado: 1,2 A.
  • I/O: cada pin puede suministrar hasta 20 mA según la documentación de usuario. No uses un GPIO como fuente directa para motores, relés u otras cargas de potencia.
  • Consumo total: Flipper advierte que el consumo asociado a I/O no debe superar 5 W o la protección de batería puede provocar apagado.
  • GND común: dos equipos que intercambian señales eléctricas necesitan una referencia común, salvo que exista aislamiento diseñado para evitarla.
Antes de cablear

Mide primero con multímetro. Si no conoces la tensión lógica del dispositivo objetivo, no conectes TX/RX, SDA/SCL o señales equivalentes «por probar». Usa conversión de nivel o aislamiento cuando el diseño lo requiera y respeta límites de corriente.

4. UART: consola serie y USB-UART Bridge

UART es una comunicación serie asíncrona. En una conexión básica necesitas TX, RX y una referencia común de masa. Normalmente se cruza TX del equipo A con RX del equipo B; además, ambos extremos deben acordar parámetros como velocidad, bits de datos, paridad y bits de parada.

Para los módulos de expansión, la documentación oficial identifica USART en pin 13 (TX) y pin 14 (RX), y una alternativa LPUART en pin 15 (TX) y pin 16 (RX). No extrapoles estos números a cualquier aplicación sin comprobar el pinout actual y qué periférico ha reservado el firmware.

La aplicación GPIO stock incluye USB-UART Bridge: el ordenador se conecta al Flipper por USB y este actúa como puente hacia una interfaz serie externa. Es útil para depurar tus propias placas, leer logs o trabajar con consolas de desarrollo autorizadas.

PC por USB
   │
   ▼
Flipper Zero — USB-UART Bridge
   │ TX/RX + GND
   ▼
Placa o microcontrolador de laboratorio

Si ves caracteres incoherentes, no asumas «cifrado»: revisa primero velocidad, formato de trama, masa común y nivel lógico.

5. SPI: reloj, datos y selección de periféricos

SPI es un bus síncrono que suele usar una línea de reloj, datos en ambos sentidos y una señal de selección por periférico. Es frecuente en memorias, pantallas, sensores y radios. Su ventaja práctica es el control explícito del reloj y una transferencia eficiente; su coste es usar más líneas que I²C.

La documentación de Flipper incluye SPI entre las capacidades de conversión/expansión de la plataforma y el firmware expone APIs para el periférico SPI. La asignación concreta de pines y la disponibilidad del bus pueden depender de la aplicación y de recursos que el sistema esté utilizando, así que no cablees un periférico basándote solo en una tabla genérica de Internet.

En un laboratorio seguro, un analizador lógico permite comprobar reloj, polaridad/fase, selección de chip y dirección de datos sin asumir que el problema está en el software.

6. I²C: dos líneas, direcciones y resistencias pull-up

I²C utiliza normalmente SDA (datos) y SCL (reloj) y permite que varios dispositivos compartan el bus mediante direcciones. Las líneas suelen ser de drenador abierto/colector abierto y necesitan resistencias pull-up apropiadas para la tensión del bus.

Dos errores frecuentes son asumir que cualquier módulo usa 3,3 V en las señales porque se alimenta a 3,3 V, o conectar varias placas que ya incluyen pull-ups fuertes sin revisar la resistencia equivalente. Antes de conectar un sensor, confirma en su hoja de datos tensión, dirección, pull-ups y velocidad soportada.

Flipper Zero puede trabajar con I²C mediante firmware/APIs apropiadas, pero no conviene presentar una pareja de pines fija como universal: la función alternativa y el recurso disponible dependen del contexto de firmware. Usa el pinout y la documentación de la aplicación que vayas a ejecutar.

7. UART vs SPI vs I²C: qué problema resuelve cada bus

BusSincronizaciónLíneas típicasModelo habitualUso didáctico
UARTAsíncronaTX, RX, GNDPunto a puntoLogs, consola serie, comunicación entre dos equipos.
SPISíncronaSCK, MOSI, MISO, CS + GNDControlador + periféricosMemorias, pantallas, sensores rápidos.
I²CSíncronaSDA, SCL + GNDBus direccionadoSensores y periféricos compartiendo dos señales.

La tabla es una simplificación pedagógica, no una especificación completa. Antes de diseñar un circuito, consulta la hoja de datos del componente y la implementación de firmware.

8. Qué ofrece el firmware stock y qué requiere código

En el firmware oficial, la aplicación GPIO permite:

  • usar USB-UART Bridge;
  • activar/desactivar la alimentación de 5 V;
  • probar manualmente varias líneas GPIO expuestas por la aplicación.

Para automatizar GPIO, el firmware actual incluye un motor JavaScript basado en mJS. El módulo oficial gpio permite configurar pines, leer/escribir valores, trabajar con entradas analógicas donde proceda, interrupciones y PWM en pines compatibles. Esto reduce la barrera de entrada, pero no elimina la necesidad de entender el circuito.

let eventLoop = require("event_loop");
let gpio = require("gpio");
let pin = gpio.get("pc3");
pin.init({ direction: "out", outMode: "push_pull" });
pin.write(true);

El ejemplo ilustra la API; antes de conectar una carga física, revisa corriente, tensión y pinout. Para desarrollo más profundo, las aplicaciones FAP y las APIs C/C++ del firmware ofrecen control de periféricos y recursos del sistema.

9. Expansion Module Protocol: cuándo un accesorio es más que “cables GPIO”

Flipper Devices documenta un Expansion Module Protocol para módulos inteligentes que se comunican por UART. El host debe tener habilitada la escucha de módulos; la comunicación se inicia desde el módulo y usa tramas con cabecera, contenido y checksum. El flujo incluye heartbeat, negociación de baud rate y respuestas de estado.

La documentación actual identifica las parejas USART 13/14 o LPUART 15/16 para este protocolo. Esto es distinto de conectar un sensor pasivo o manejar un LED: un módulo de expansión puede implementar una capa de protocolo para integrarse de forma más estructurada con Flipper.

Si diseñas tu propio accesorio, usa además los blueprints oficiales de módulos externos para geometría y las especificaciones actuales del protocolo para firmware.

10. Wi-Fi Developer Board oficial: qué es realmente

La Wi-Fi Developer Board oficial está basada en un ESP32-S2-WROVER. Su propósito documentado es aportar conectividad Wi-Fi para desarrollo, actualización y depuración: incorpora firmware con Black Magic Debug y DAPLink/CMSIS-DAP según el modo de conexión.

Para depurar el propio Flipper, la placa usa SWD: la documentación oficial identifica pin 10 como SWCLK y pin 12 como SWDIO. La placa puede conectarse al ordenador por USB o trabajar a través de Wi-Fi; el modo disponible de depuración depende de la conexión.

Conexión en frío recomendada por el fabricante

Flipper Devices indica apagar el Flipper antes de insertar el Wi-Fi Devboard. La razón documentada es que una carga capacitiva grande puede afectar al riel de 3,3 V compartido con la microSD y provocar corrupción de datos. Aquí sí existe una recomendación oficial específica; no debe generalizarse sin más a cada accesorio de terceros.

El Devboard no convierte por sí solo el firmware stock de Flipper Zero en una suite de auditoría Wi-Fi. Si tu objetivo es comprender 802.11, WPA2/WPA3 y seguridad inalámbrica, deriva a la guía de Wi-Fi para ciberseguridad.

11. ESP32, Arduino, Raspberry Pi y módulos de terceros

GPIO permite integrar múltiples plataformas, pero la compatibilidad debe evaluarse señal por señal:

  • ESP32: muchas placas trabajan con lógica de 3,3 V, pero revisa el modelo, la placa concreta y cómo están cableados sus conversores/reguladores.
  • Arduino: la familia es heterogénea. Un Uno clásico basado en ATmega328P suele usar 5 V, mientras otras placas usan 3,3 V. No trates “Arduino” como un nivel lógico único.
  • Raspberry Pi: los GPIO de modelos habituales son de 3,3 V, pero la SBC no es tolerante a 5 V en sus GPIO. La masa común y el pinout correcto siguen siendo imprescindibles.
  • Módulos comerciales o caseros: comprueba hoja de datos, corriente de arranque, regulación, pull-ups, sentido de señal y compatibilidad física.

Si la necesidad real es más RF, RFID especializado, SDR o una plataforma de propósito general, no fuerces el GPIO para resolverlo todo: compara Proxmark, HackRF, SDR, ESP32 y Raspberry Pi según la tarea.

12. Laboratorios seguros para aprender GPIO

La siguiente secuencia es un modelo pedagógico propio de Achirou, no una ruta oficial de Flipper Devices. El objetivo es incrementar complejidad sin saltar directamente a hardware desconocido.

  1. Multímetro y pinout: identifica GND y verifica rieles de alimentación sin conectar ninguna carga externa.
  2. Salida digital: controla un LED con resistencia adecuada desde un pin soportado por la aplicación o API.
  3. Entrada digital: lee un pulsador con una configuración de pull-up/pull-down documentada.
  4. UART con placa propia: conecta una placa de desarrollo de 3,3 V, comparte GND y observa logs generados por un firmware que controles.
  5. I²C con sensor conocido: usa un módulo cuya hoja de datos y nivel lógico tengas verificados; identifica su dirección y comprueba el bus.
  6. Wi-Fi Devboard: actualiza la placa oficial y practica depuración del propio Flipper siguiendo la guía de Flipper Devices.

Un analizador lógico y un multímetro suelen aportar más aprendizaje que comprar muchos módulos. Aprende a medir antes de asumir.

13. Checklist antes de conectar cualquier hardware

  • ¿El dispositivo objetivo es tuyo o tienes autorización para trabajar sobre él?
  • ¿Has confirmado GND, VCC y nivel lógico con documentación y medición?
  • ¿Sabes qué pin transmite y cuál recibe?
  • ¿La carga cabe dentro de los límites del GPIO/riel o necesitas driver/alimentación externa?
  • ¿El módulo incorpora pull-ups, reguladores o conversores de nivel?
  • ¿La aplicación/firmware que usarás reserva ese periférico o esos pines?
  • ¿Has desconectado alimentación antes de recablear cuando el fabricante así lo recomienda?
  • ¿Tienes una copia de seguridad de datos importantes en la microSD?

Esta lista es una heurística de seguridad de laboratorio; no sustituye las hojas de datos, esquemas ni instrucciones del fabricante.

14. Preguntas frecuentes sobre Flipper Zero GPIO y módulos

¿Flipper Zero tiene 18 GPIO?

No. Tiene una cabecera física de 18 posiciones; las especificaciones oficiales indican 13 I/O disponibles al usuario. El resto de posiciones incluyen alimentación y masa.

¿Los GPIO trabajan a 3,3 V o 5 V?

La lógica del MCU es 3,3 V CMOS. La documentación habla de entradas tolerantes a 5 V en el contexto definido por ST, pero eso no convierte todas las conexiones en «lógica de 5 V». Las salidas lógicas siguen siendo de 3,3 V.

¿Hay salida de 5 V?

Sí. El pin 1 ofrece un riel de 5 V con máximo documentado de 1,2 A. Con batería se habilita desde GPIO → 5V on GPIO.

¿Puedo usar Flipper como USB-UART?

Sí. Es una función documentada de la aplicación GPIO oficial y resulta útil para consolas serie y placas de laboratorio compatibles.

¿Puede trabajar con SPI e I²C?

Sí. La documentación oficial incluye UART/SPI/I²C entre las capacidades de conversión y el firmware dispone de APIs para estos periféricos. No obstante, el flujo exacto y el pinout dependen de la aplicación/firmware; no los trates como un único modo de menú idéntico a USB-UART.

¿Qué pines usa UART para Expansion Modules?

La documentación actual del protocolo identifica USART en pines 13/14 (TX/RX) y LPUART en 15/16. Comprueba siempre la aplicación y el pinout vigente antes de cablear.

¿Qué es el Wi-Fi Developer Board?

Es una placa oficial basada en ESP32-S2-WROVER, diseñada para desarrollo, actualización y depuración. Flipper Devices documenta Black Magic y DAPLink según modo/conexión.

¿Debo apagar el Flipper antes de conectar el Wi-Fi Devboard?

Sí. El fabricante lo recomienda expresamente por el efecto que una carga capacitiva puede tener sobre el riel de 3,3 V compartido con la microSD.

¿Necesito programar en C?

No para empezar. El firmware actual incluye JavaScript y un módulo GPIO. C/C++ sigue siendo relevante cuando necesitas aplicaciones y control de bajo nivel más profundos.

¿GPIO puede dañar el dispositivo?

Sí, si aplicas tensiones/corrientes fuera de especificación o provocas cortocircuitos. La protección ESD y la tolerancia documentada no sustituyen una conexión eléctrica correcta.

15. Conclusión: GPIO enseña a verificar antes de conectar

El mayor valor de GPIO no es convertir Flipper Zero en «otra herramienta más», sino obligarte a entender tensión, referencia de masa, dirección de señal, protocolo, temporización y límites del hardware. Esa forma de razonar es transferible a microcontroladores, sistemas embebidos e investigación de hardware.

Para continuar sin solapar contenidos: