wireview-hwmon-unraid

Unraid plugin for the Thermal Grizzly WireView Pro II GPU power monitor.

Exposes real-time voltage, current, power, and temperature readings through the Linux hwmon subsystem, with a web GUI integrated into the Unraid dashboard.

Based on the wireview-hwmon project.

Requirements

• Unraid 7.2.3 or later
• Thermal Grizzly WireView Pro II connected via USB to the Unraid host (not passed through to a VM)

Installation

From Community Applications (recommended)

Search for WireView in the Unraid Community Applications plugin store.

Manual install

In the Unraid web UI, go to Plugins > Install Plugin and paste:

https://raw.githubusercontent.com/emaspa/wireview-hwmon-unraid/main/wireview-hwmon.plg

The plugin will automatically download the correct package for your kernel version.

What's included

Dashboard Tile

The plugin adds a movable tile to the Unraid dashboard showing live sensor readings organized into sections:

• Voltage - per-pin and average
• Current - per-pin and total
• Power - per-pin and total
• Temperature - onboard and external probes
• Status - fan duty, fault status/log, PSU capability

Data auto-refreshes every 2 seconds with color-coded status orbs (green/orange/red).

Settings Page

Under Settings > Utilities > WireView Pro II, the plugin provides:

• Daemon start/stop/restart controls
• Device info (firmware version, UID, build string)
• Full device configuration matching the WireView II Pro GUI app:
  • General - friendly name
  • Fan Control - mode (curve/fixed), temperature source, duty min/max, temp min/max
  • Protection Thresholds - OCP, wire OCP, OPP, temperature fault, current imbalance
  • Fault Response - per-fault-type enable/disable for display, buzzer, soft power, hard power
  • Display - backlight, theme, rotation, timeout mode, cycle screens
  • Measurement - current scale, power scale, averaging period, logging interval
• NVM controls (save/load/factory reset)
• Clear faults
• Network (LAN) - publish this server's WireView on the LAN and (with a secret) accept authenticated remote writes/config. See below.

Fault Alerts

A background monitor polls the device every 30 seconds and sends Unraid notifications on:

• Fault state transitions (alert when fault detected, normal when cleared)
• High temperature warnings (above 80°C)

LAN monitoring

The bundled daemon can publish this server's WireView on the LAN and accept authenticated commands, so the desktop app or another server can read it - and, with a secret, configure it remotely. It is off by default.

Configure it under Settings > WireView Pro II > Network (LAN):

• Enable LAN publishing - opens the listener so other instances can read this server's device via GET /sensors.
• Publish port - listener port (default 9876).
• Network secret - shared passphrase enabling HMAC-authenticated remote writes/config (empty = reads only; the secret never crosses the wire and replays are rejected).
• Audit log retention (days) and remote hosts for wireviewctl top.

Settings are stored on the flash drive (/boot/config/plugins/wireview-hwmon/) and re-applied to /etc/wireview/config on every boot, so they survive reboots even though /etc is tmpfs on Unraid. No TLS - this targets a trusted LAN. See wireview-hwmon for the full protocol and security details.

CLI usage

# Show device info
wireviewctl info

# Read device config (hex blob)
wireviewctl read-config

# Write device config from file
wireviewctl write-config /path/to/config.hex

# Save config to device NVM
wireviewctl nvm store

# Clear fault log
wireviewctl clear-faults

# Change on-device display
wireviewctl screen main
wireviewctl screen temp
wireviewctl screen pause
wireviewctl screen resume

# Update the device firmware to the bundled image over DFU (add -y for no
# prompt). Unofficial tool: flash at your own risk. Also works if the device
# is already stuck in bootloader mode.
wireviewctl flash

# Live dashboard (local + remote hosts; q to quit)
wireviewctl top
wireviewctl top --host 192.168.1.50

Supported Unraid versions

Pre-built packages cover Unraid 7.2.x, 7.3.0, 7.3.1, and 7.3.2 (kernels 6.12.54, 6.18.29, 6.18.33, and 6.18.38-Unraid). The plugin automatically downloads the package matching your running kernel.

Check the releases page for all available packages.

Building from source

The build system uses Docker to cross-compile the kernel module against Unraid kernel headers.

mkdir -p output cache
docker build -t wireview-builder --build-arg UNRAID_VERSION=7.3.2 build/
docker run --rm \
  -v "$(pwd):/src:ro" \
  -v "$(pwd)/output:/output" \
  -v "$(pwd)/cache:/cache" \
  -e UNRAID_VERSION=7.3.2 \
  -e PLUGIN_VERSION=0.15.1 \
  wireview-builder

The resulting .txz package will be in output/.

Troubleshooting

Plugin installs but no sensor data appears

• Ensure the WireView Pro II is connected directly to the Unraid host via USB, not passed through to a VM
• Check lsusb for vendor 0483 product 5740
• Check if the daemon is running: /etc/rc.d/rc.wireviewd status

"Failed to download package for kernel X.Y.Z-Unraid"

• Your Unraid kernel version may not have a pre-built package yet
• Check the releases page for supported versions
• You can build from source (see above)

Module fails to load

• Since 0.15.1 the installer and /etc/rc.d/rc.wireviewd print the actual modprobe error and recent kernel log lines on failure
• Run dmesg | tail -20 to check for errors
• Ensure the module matches your exact kernel: uname -r

License

GPL-2.0 - see LICENSE