---
description: HDMI Tester CLI Simulator Workflow
---

This workflow explains how to use the `simulator.py` tool to test the HDMI Head Unit logic without physical hardware.

### Prerequisites
1. Ensure the Web UI is running:
   ```bash
   npm run dev
   ```
2. (Optional) Create a virtual environment and install requirements:
   ```bash
   pip install requests
   ```

### 1. Register a New Device
// turbo
Run this command to send the initial registration request to the server:
```bash
python3 firmware/simulator.py register
```
After running this, go to the [Admin Panel](http://localhost:3000/admin) to enroll the device.

### 2. Send a Mock Test Result
// turbo
Once the device is enrolled, you can send a mock HDMI test:
```bash
python3 firmware/simulator.py test
```

### 3. Switch Modes & Slots
// turbo
Toggle between DEV and PROD modes, or swap A/B slots:
```bash
python3 firmware/simulator.py mode-prod
python3 firmware/simulator.py swap
```

### 4. Continuous Simulation Loop
// turbo
To keep the device alive and reporting periodically:
```bash
python3 firmware/simulator.py loop
```