Host Ingest Daemon (luxd)

Host Ingest Daemon (luxd)

luxd is the official high-performance host ingest proxy and bridge for Pyintel Lux written in Rust.

---

1. Overview

luxd runs on a desktop host, gateway server, or Raspberry Pi. It captures raw 14-byte zero-copy binary frames from incoming hardware transports (Serial USB, UDP, WebSockets), decodes them against a compile-time symbols.json dictionary, and proxies telemetry to persistent storage or upstream monitoring stacks.

---

2. Capabilities & Architecture

• High-Throughput Ingest: Processes > 50,000 frames/sec on standard Linux hosts.
• Symbol De-tokenization: Translates 16-bit Symbol IDs into fully formatted strings, logs, and structured JSON using symbols.json.
• SQLite & Time-Series Storage: Writes incoming binary telemetry directly into localized SQLite / DuckDB databases.
• OTLP Bridge: Bridges incoming MCU binary telemetry directly into cloud-native OpenTelemetry collectors (OTLP/gRPC or OTLP/HTTP).
• Live WebSocket Server: Streams decoded telemetry directly to web dashboards in real time.

---

3. Command-Line Usage

# Start luxd reading from USB Serial on COM9
luxd --port COM9 --baud 115200 --dict symbols.json

# Start luxd listening on UDP port 8888 with WebSocket bridge enabled
luxd --udp 8888 --ws-port 9001 --dict symbols.json --db telemetry.db