Crestron Diagnostic Tool

What Is This Tool?

The Crestron Diagnostic Tool is a Windows desktop application built for AV professionals who work with Crestron control systems. It connects to a Crestron processor over the network, discovers every device on the system, scans each one for issues, and presents the results in a clean, color-coded interface.

Instead of manually SSH-ing into a processor, running a dozen console commands, and interpreting raw text output — this tool does all of that automatically and shows you exactly what's wrong, why, and what to do about it.

System Requirements

• OS: Windows 10 or Windows 11 (64-bit)
• Network: Must be on the same network as the Crestron processor (LAN or VPN)
• Crestron: CP3, CP3N, MC3, MC4-R, or any SSH-accessible Crestron processor
• No installation required — standalone EXE, just double-click and run

Getting Started

1. Launch the Application

Double-click CrestronDiag.exe. The app opens windowed and is ready to use immediately — no setup or configuration required.

2. Enter Connection Details

In the left panel you'll see the credential form:

Tip: If your processor uses the default Crestron credentials, just enter the IP and leave everything else as admin with a blank password.

3. Start the Scan

Click 🔍 Start Network Scan. The tool will:

1. Connect to the processor via SSH
2. Run diagnostic commands to gather system data
3. Discover all connected devices (DM switchers, touch panels, amplifiers, RF gateways, Cresnet buses)
4. Scan each discovered device individually
5. Analyze all data and identify issues

A purple progress bar appears in the bottom status bar while scanning is in progress. The status bar also shows real-time updates as each device is scanned.

Scanning typically takes 30–90 seconds depending on the number of devices and network speed.

4. Stop a Scan

Click ■ Stop at any time to cancel the scan. Devices that were already scanned will still be visible.

Understanding the Device List

As devices are discovered, they appear in the left panel list. Each device card shows:

• Colored dot — health status at a glance
• Device name — hostname or IP
• Device type — Processor, DM Switcher, Touch Panel, etc.
• Health badge — HEALTHY / WARNINGS / ISSUES

Health Badge Colors

Viewing Device Details

Click any device in the left panel to open its detail view on the right. The detail panel has four tabs:

📋 Overview

High-level device information:

• IP address, model, firmware version
• For processors: program name, CPU load, RAM usage
• For DM switchers: card count, endpoint count
• For touch panels: RAM usage, gateway connection status
• For amplifiers: amplifier status summary

⚠ Issues

A prioritized list of everything wrong with the device:

• RED (HIGH) — Critical issues. Address immediately.
• AMBER (MEDIUM) — Warnings. Should be reviewed.
• GREEN (LOW) — Minor notes or informational items.

Each issue shows a severity badge, a title (what the problem is), detail (more context), and a recommended action (what to do to fix it).

🖥 Hardware

Device-specific hardware inventory:

• Processor: RF devices, Cresnet devices, IP table
• DM Switcher: endpoint cards with firmware, link status, and magnetics
• RF Gateway: full list of paired RF devices with signal strength
• Cresnet Bus: all Cresnet-connected devices

📜 Logs

Raw error log output from the device console. Useful for deep troubleshooting or sharing with Crestron support.

Device Actions

↺ Reboot Device

Sends a reboot command to the selected device. A confirmation dialog appears before the reboot is executed. Use with caution in live environments.

🔧 Update Firmware (PUF)

Opens the firmware update dialog. You can:

1. Browse for a .puf firmware file
2. Analyze — checks the file and shows what will be updated
3. Update Firmware — uploads the file via SFTP and runs pufexec on the device

Note: Firmware updates will cause a device restart. Coordinate with the site before running updates on live systems.

Common Issues & Tips

"Scanning…" never completes for a device

• The device may be offline or unreachable
• Check that the device IP is accessible from your machine
• Verify the username/password for that device type
• Some older devices may not support all diagnostic commands — this is normal

Scan shows devices but no detail data

• Most detail data requires a successful SSH connection
• Check credentials — wrong password will show the device but not its data
• Virtual devices (RF Gateway, Cresnet Bus) show hardware data from the processor, not a direct connection

Authentication popup appears during scan

• Some devices require separate credentials from the main processor
• Enter the correct username and password when prompted, or click Skip to continue without scanning that device

App crashes or shows a red error in the detail panel

• Note the error text and report it — it helps us improve the tool
• Try clicking a different device to confirm the issue is device-specific

Supported Device Types

Privacy & Security

• No data is sent to the internet. All scanning is direct network communication between your computer and the Crestron devices.
• Credentials are held in memory only and never stored to disk.
• The application does not require internet access to function.

About FridayForge

FridayForge builds professional-grade tools for AV integrators and Crestron programmers.

• Website: fridayforge.com
• Store: fridayforge.net/store
• Support: Contact us through the store

© 2026 FridayForge. All rights reserved.