A high-performance orchestration platform designed for real-time monitoring and repair diagnostics of Console HDMI Ports (PS5, Xbox, Switch). This platform provides a "single pane of glass" view for large fleets of test nodes, offering sub-ms edge latency tracking and remote hardware orchestration for front-desk and technical staff.

🚀 Key Features

Port Telemetry: Real-time monitoring of active nodes, port diagnostic results, and system health.
Port Insights: Tactical spectral analysis of HDMI pins (DDC, CEC, TMDS) for board-level repair verification.
Retail & Enterprise Views: Simplified "Good/Bad" UI for front-desk staff and detailed telemetry for technicians.
Command Center: Enterprise-grade fleet management for device enrollment and environment orchestration.
Device Configuration:
- Remote renaming and identification.
- Multi-slot firmware management (A/B switching).
- Remote Power Controls (Reboot, Shutdown).
- Secure firmware binary deployment (.bin/.elf).
Premium UI/UX:
- High-contrast Light and Dark modes.
- Safari-optimized rendering and backdrop filters.
- Virtual Hardware Simulator: A web-based tactile OLED emulator for immediate testing.
- Fluid micro-animations and responsive layouts.

🛠 Tech Stack

Framework: Next.js 15 (App Router)
Database: Prisma with SQLite
Icons: Lucide React
Styling: Tailwind CSS with a custom CSS variable design system
Hardware Simulation: Python-based simulator for headless testing

🏁 Quick Start

1. Prerequisites

Ensure you have Node.js (v18+) and Python 3 installed.

2. Installation

# Clone the repository
git clone <repo-url>
cd hdmi-tester

# Install dependencies
npm install

3. Database Initialisation

npx prisma db push

4. Launch the Platform

npm run dev

Open http://localhost:3000 to access the dashboard.

🤖 Hardware Simulation

To test the platform without physical hardware, you can use either the interactive web emulator or the Python-based CLI simulator.

Web Simulator (Recommended)

Access the tactile OLED emulator directly in your browser: http://localhost:3000/simulator

Features: Real-time OLED display, keyboard shortcuts (R/T/S/B), and live system logs.

Python CLI Simulator

# Register a simulated device
python3 firmware/simulator.py register

# Interactive Orchestrator
python3 firmware/simulator.py

Simulator Commands:

Register / Sync: Connects the simulator to the mesh.
Report Test: Generates mock HDMI spectral data.
Swap Slot: Updates the active orchestration slot (A/B).
Automated Loop: Continuously reports telemetry.

🔌 API Overview

Device Interaction

POST /api/devices/register: Hardware enrollment.
PATCH /api/devices/[id]: Update device configuration (Name, Slot).
POST /api/devices/[id]/command: Remote power operations (Reboot, Shutdown).
POST /api/devices/[id]/firmware: Orchestrated firmware deployment.

Telemetry Reporting

POST /api/tests/report: Transmit spectral analysis results from hardware.
GET /api/dashboard/stats: Retrieve aggregate fleet metrics.

Built for precision. Orchestrated for scale.