🔬 Analyzer1

Analizador de protocolos — Arquitectura, interfaces y guia de implementacion · v4.0 · s18 · 2026-04-06

1. Vision y proposito

Analyzer1 es el instrumento de diagnostico de protocolos de la plataforma LRU. Captura, decodifica e inspecciona trafico de cualquier protocolo — desde MQTT IoT hasta ARINC 429 de avionica — con una interfaz unificada.

1.1 Triple vida

2. Arquitectura

2.1 ProtocolAdapter interface

interface ProtocolAdapter {
  readonly protocolId: string;
  readonly name: string;
  readonly family: ProtocolFamily; // 'aviation' | 'industrial' | 'iot'
  decode(raw: string | ArrayBuffer): DecodedFrame;
  inspect(raw: string | ArrayBuffer): string;
  canDecode(raw: string | ArrayBuffer): boolean;
}

2.2 Tap Points

2.3 CapturedFrame

interface CapturedFrame {
  id: number; timestamp: number; tapPointId: string;
  protocolId: string; direction: 'rx' | 'tx' | 'internal';
  raw: string; decoded?: DecodedFrame; size: number; starred?: boolean;
}

2.4 AnalyzerState

interface AnalyzerState {
  capturing: boolean; frames: CapturedFrame[]; maxFrames: number;
  selectedFrameId: number | null; activeTapPoints: string[];
  filter: string; autoScroll: boolean;
  stats: { totalFrames: number; framesPerSec: number; bytesTotal: number; };
}

3. Catalogo de protocolos

9 protocolos definidos, 3 implementados:

3.1 ARINC 429 s16

Decode 32-bit words: Label 8b bit-reversed, SDI 2b, Data 19b, SSM 2b, Parity 1b odd. Tabla A320_LABELS 22 labels con escala/offset/unidad/ATA. Simulador con Sim1 link via window.Sim1Debug.getValues().

3.2 MQTT s17

Parseo topics <red>/<id>/<dir>/<canal>, clasificacion 6 tipos (telemetry/rpc/status/command/event/unknown), deteccion unidades, meta cache getMqttMeta(). 3 dispositivos simulados (esp01 Air Data, esp02 Engine, esp03 Flight Control). Tap real via DebugBus + tap simulado.

3.3 WebSocket s18

Decode de frames WS intercambiados con Node-RED y servidores WebSocket. Clasificacion 8 tipos:

Simulador WebSocket

6 generadores en simulator.ts (182 lin): sensor relay (Sim1 link), status broadcast, _execCommand, system events, subscribe, ping/pong. Intervalo base 600ms.

Tap points

useWsTap: intercepta CommsManager con subscribe('*') filtrando channel.startsWith('ws') + captura publishes salientes via onPublish. Patron reutilizable para BLE (channel.startsWith('ble')).

useWsSimTap: WebSocketSimulator genera trafico sin servidor. Mismo patron que useMqttSimTap.

4. FrameInspector s16+s18

898 lineas. 3 branches de rendering segun protocolo, con componentes compartidos para IoT (MQTT + WS).

4.1 Branch ARINC 429

Binary view coloreada (32 bits, 5 campos), Octal view (labels octal), HexDump con bytes coloreados, campos decodificados con cross-highlight bidireccional.

4.2 Branch MQTT s18

Topic segmentado en cajas coloreadas por segmento. Badge tipo (telemetry/rpc/status/command/event). Campos organizados: Routing / Datos (barras magnitud) / Otros. JSON syntax highlight (keys cyan, strings verde, numbers ambar, booleans purpura). Deteccion timestamps → formato HH:MM:SS.mmm.

4.3 Branch WebSocket s18

Badge tipo coloreado (8 tipos WS). Topic segmentado si presente. Campos con colores semanticos: IDs cyan, IPs verde, commands rojo, status verde, booleans verde/rojo. JSON syntax highlight. Reutiliza componentes IoT compartidos.

4.4 Componentes compartidos IoT

5. AnalyzerBottomPanel s18 refactor

Refactorizado de monolito 673 lin a carpeta bottom/ con 10 ficheros (2235 lin). Orquestador delgado (171 lin). 6 tabs:

5.1 Waveform ARINC 429 s18 mejorada

Multi-word (hasta 4 consecutivas), timing real (toggle 100kb/12.5kb), gaps null (4 bit-periods), escala temporal µs, cursor de medida (click A + click B → delta µs).

5.2 MQTT Flow s17

Diagrama pub/sub: Publisher → Broker → Subscriber. Topic segmentado, badge tipo, barras valores numericos.

5.3 WebSocket Flow s18

Diagrama bidireccional PWA ↔ Node-RED. Badge WS en conexion. Badge tipo debajo. Node-RED con mini logo "N" y URL :1880. Topic segmentado si presente. Ping/pong con texto especial. Barras valores (timestamps excluidos).

5.4 Timeline s18 mejorada

Zoom scroll wheel (1x-20x), drag horizontal pan, mini-map con viewport, tooltips hover (protocolo, timestamp, summary, dir, size), agrupacion rafagas (<50ms), boton Reset.

5.5 Topic Constellation s18

Grafo SVG: nodos = segmentos unicos topics MQTT, aristas = padre/hijo. Tamano proporcional a frecuencia. Parpadeo reciente (<2s). Click filtra sub-arbol. Solo visible si hay frames MQTT.

5.6 Latency Analyzer s18

Histograma latencia inter-frame. Filtro por protocolo. 8 stats: Min, Max, Avg, Median, P95, σ, Jitter, Outliers. Lineas media (verde) y P95 (ambar). Barras rojas para outliers (>2σ). Alerta jitter >100ms.

5.7 Payload Diff s18

Frame seleccionado vs anterior/siguiente del mismo protocolo. Campos: same (gris), modified (amarillo+flecha), added (verde), removed (rojo tachado). Toggle prev/next.

5.8 Stats s17

Donut distribucion protocolos, barra TX/RX/Internal, avg payload size, sparkline throughput 20s, top 5 topics MQTT.

6. Estructura de ficheros

src/pages/Analyzer1/
├── index.ts                           — Re-export
├── Analyzer1.tsx                      — Shell + play por protocolo (s18, 392 lin)
├── Analyzer1Overlay.tsx               — Overlay arrastrable (portal)
├── FrameInspector.tsx                 — 3 branches A429/MQTT/WS (s18, 898 lin)
├── AnalyzerBottomPanel.tsx            — Orquestador 6 tabs (s18, 171 lin)
├── analyzer1.css                      — Estilos + MQTT/WS inspector (s18, 534 lin)
├── types.ts                           — ProtocolAdapter, TapPoint, Frame, State
├── bottom/                            — Visualizaciones BottomPanel (s18)
│   ├── index.ts                       — Barrel (13 lin)
│   ├── constants.ts                   — PROTO_COLORS, ARINC429_RANGES (42 lin)
│   ├── WaveformView.tsx               — Waveform A429 multi-word (280 lin)
│   ├── MqttFlowView.tsx               — MQTT pub/sub flow (121 lin)
│   ├── WsFlowView.tsx                 — WS bidireccional flow (202 lin)
│   ├── TimelineView.tsx               — Timeline zoom/pan/minimap (353 lin)
│   ├── StatsView.tsx                  — Donut + sparkline (216 lin)
│   ├── TopicConstellation.tsx         — Grafo topics MQTT (283 lin)
│   ├── LatencyAnalyzer.tsx            — Histograma latencia (251 lin)
│   └── PayloadDiff.tsx                — Diff side-by-side (274 lin)
└── protocols/
    ├── index.ts                       — Catalogo + registry (79 lin)
    ├── arinc429/
    │   ├── index.ts, adapter.ts (212), labels.ts (67), simulator.ts (151), tap.ts (69)
    ├── mqtt/
    │   ├── index.ts, adapter.ts (309), simulator.ts (224), tap.ts (167)
    └── websocket/                     — s18
        ├── index.ts (9), adapter.ts (302), simulator.ts (182), tap.ts (159)

7. Interfaz de usuario

8. Integracion con la plataforma

Analyzer1Provider en App.tsx. Ruta /Analyzer1. Panel analyzer en PanelGrid (panel 11). CSS vars --sim1-*. Los 3 simuladores leen de window.Sim1Debug.getValues() para reflejar valores reales de Sim1.

9. Roadmap

Completado

Pendiente

LRU Platform · Analyzer1 Architecture · lru_analyzer1_architecture_v4.0_s18.html · s18 · 2026-04-06