IR Frame Generator

Cómo funciona

Pronto Hex no es el protocolo del badge: es el contenedor que describe la señal infrarroja, es decir la portadora y las duraciones alternadas de IR encendido y apagado. Dentro de esa señal viaja un comando PixMob.

1. Parámetros del efectocolor, envolvente, probabilidad, grupo
2. Comando lógico6 o 9 bytes; magic 0x80, checksum, flags, body
3. Sustitución + checksumtabla de 64 entradas; el checksum se calcula después
4. Serialización LSB-firstbit menos significativo de cada byte primero
5. Celda T ≈ 694 µsruns de unos y ceros
6. Runs MARK/SPACE a ≈38 kHzmodulación de la portadora
7. Pronto Hexcabecera más duraciones

Detalles que sorprenden

• El orden del color es G, R, B, no R, G, B.
• Solo se transmiten 6 bits por canal. Un 255 llega al badge como 252, y hay 64 niveles por canal en lugar de 256.
• Los colores no son índices de paleta. Es RGB directo cuantizado; la documentación del protocolo descartó la hipótesis inicial de paleta.
• El pulso visible de medio segundo no es la transmisión. La trama IR dura unos pocos milisegundos; la duración del destello la genera el propio badge.
• La sustitución no es cifrado. Es una tabla reversible y conocida que probablemente evita runs largos de bits iguales.
• El campo chance explica los efectos de chispeo: todos los badges reciben el mismo comando y solo una fracción aleatoria lo ejecuta.

Tabla de tiempos

Verificación

El codificador se comprueba en cada carga contra los vectores publicados en la documentación del protocolo: el comando conocido para rgb(0, 252, 192), su bitstream de 40 bits, la reversibilidad de la tabla y la reproducción exacta de una trama documentada.

Limitaciones

• El protocolo procede de análisis comunitario de firmware y pruebas físicas. No es una especificación oficial.
• Hay diferencias entre generaciones de hardware y firmware, y algunos badges conservan configuración previa en EEPROM.
• Varios campos siguen parcialmente investigados, entre ellos gsten y algunas ramas de sustain y release.
• El resultado visible depende de batería, LEDs, difusor y ambiente. Un RGB numérico no garantiza coincidencia exacta entre modelos.
• Los protocolos RF y BLE son distintos y esta herramienta no los cubre.
• Una trama correcta puede no funcionar si el emisor falla: intensidad IR, driver, polaridad o timing.

Uso aceptable

Esta herramienta existe para interoperar con hardware propio, documentar un protocolo y preservar conocimiento técnico. Ese es el único uso para el que se publica.

• Solo con dispositivos que poseas o para los que tengas permiso expreso de prueba.
• Nunca en eventos en directo. No la uses para interferir con espectáculos, equipamiento de recintos, personal técnico ni dispositivos de otras personas.
• El infrarrojo requiere línea de vista, pero un emisor potente puede alcanzar muchos dispositivos a la vez. La exposición de terceros no es hipotética.
• Nada se transmite solo. La página nunca emite señales: genera datos que tú decides qué hacer con ellos, y todo el cálculo ocurre en tu navegador.

Comandos deliberadamente no implementados

El protocolo documenta más comandos de los que esta herramienta genera. Se han dejado fuera a propósito los que escriben memoria persistente o alteran el estado interno de un dispositivo:

• Escritura de perfiles de color en EEPROM.
• Asignación y cambio de group id.
• Configuración persistente de repeat count, repeat delay y GST.
• Comandos de reset.

Los únicos campos que rozan estado guardado están en la sección Avanzado del generador, señalizados como tales.

Código abierto, licencias y atribución

Esta página es software libre, publicado bajo licencia MIT. El código fuente completo está disponible, sin build ni minificación: lo que se publica es exactamente lo que se lee. Puedes usarlo, modificarlo y redistribuirlo conservando el aviso de copyright, y las aportaciones son bienvenidas.

Repositorio y código fuente · Cómo contribuir

Este proyecto es una implementación independiente escrita a partir de documentación pública de protocolo; no contiene código copiado de otros proyectos, ni firmware extraído, ni volcados de memoria, ni binarios del fabricante. Aun así, el conocimiento del protocolo procede enteramente del trabajo de otras personas, publicado bajo licencia MIT.

• PixMob_IR — MIT, Copyright (c) 2024-2025 James Wang. De aquí proceden la tabla de sustitución, el checksum, los layouts de 6 y 9 bytes, los flags y las tablas de tiempos.
• pixmob-ir-reverse-engineering — MIT, Copyright (c) 2022 Dani Weidman. De aquí proceden la caracterización de la capa física y los valores P_PULSO publicados.
• El código propio de este repositorio se publica bajo licencia MIT.

Los avisos de licencia completos están en THIRD_PARTY_NOTICES.md.

Reclamaciones. Si representas a un titular de derechos y consideras que algo de este repositorio debe corregirse o retirarse, abre una issue en el repositorio y se atenderá. La intención es documentar e interoperar, no competir ni perjudicar a nadie.

Fuentes y créditos

Todo el conocimiento del protocolo procede del trabajo público de otras personas:

• Daniel Weidman — PixMob IR (and RF!) Reverse Engineering Project Investigación original del protocolo, publicada por sus autores: análisis de señal, timings y herramientas.
• jamesw343 — documentación del protocolo IR Fuente principal de layouts, flags, tabla de sustitución, checksum y serialización.
• jamesw343 — implementación de referencia Código derivado del análisis del microcontrolador.
• Patente US-10863607-B2 Contexto técnico y temporización nominal de 694.44 µs.
• FCC ID 2ADS4WASH Documentación pública del transmisor e infrarrojo de 940 nm.

PixMob es una marca de su titular (Eski Inc.), mencionada aquí de forma puramente descriptiva para identificar el hardware con el que este software pretende interoperar. Esta página no está afiliada, patrocinada ni respaldada por dicho titular, no usa sus logotipos ni su identidad visual, y se publica sin ánimo de lucro con fines de documentación, preservación y aprendizaje.