wireview-hwmon

Linux hwmon driver and daemon for the Thermal Grizzly WireView Pro II power monitor. Exposes voltage, current, power, and temperature sensor data through the standard Linux hwmon subsystem.

Works standalone or alongside the wireview-linux GUI application. When both are used together, the app reads sensor data from hwmon and sends commands through the daemon's Unix socket - giving you full app functionality plus system-wide sensor integration.

How it works

WireView Pro II (USB) → wireviewd (serial) → kernel module → /sys/class/hwmon/ → monitoring tools
                                 └─────────→ HTTP /sensors (opt-in) → LAN: other hosts, the GUI app, wireviewctl top

wireview_hwmon.ko - Kernel module that creates a virtual hwmon device
wireviewd - Userspace daemon that reads the device over serial, feeds the kernel module, and (opt-in) publishes readings + accepts authenticated commands over the LAN
wireviewctl - CLI tool for querying sensors, sending commands, and a top live monitor

Installation

Ubuntu 24.04 / 26.04 (PPA)

sudo add-apt-repository ppa:sparvoli/wireview-hwmon
sudo apt update
sudo apt install wireview-hwmon wireview-hwmon-dkms

This installs the daemon, CLI tool, kernel module (via DKMS), systemd service, and udev rules. The module auto-rebuilds on kernel updates and the daemon starts automatically.

Ubuntu / Debian (.deb packages)

Pre-built .deb packages are available on the Releases page. Download and install:

sudo apt install ./wireview-hwmon_1.4.0_amd64.deb ./wireview-hwmon-dkms_1.4.0_all.deb

Fedora (COPR)

sudo dnf copr enable emaspa/wireview-linux
sudo dnf install wireview-hwmon wireview-hwmon-dkms
sudo systemctl enable --now wireviewd

The same COPR repo also provides the WireView GUI (wireview-linux). The DKMS module pulls kernel-devel for your running kernel and rebuilds automatically on kernel updates.

Fedora (.rpm packages)

Pre-built .rpm packages are on the Releases page (one set works on Fedora 42-44):

sudo dnf install ./wireview-hwmon-1.4.0-1.x86_64.rpm ./wireview-hwmon-dkms-1.4.0-1.noarch.rpm
sudo systemctl enable --now wireviewd

Arch / CachyOS / EndeavourOS (AUR)

paru -S wireview-hwmon wireview-hwmon-dkms   # or: yay -S
sudo systemctl enable --now wireviewd

DKMS needs the matching kernel headers (linux-headers, linux-cachyos-headers, …) installed; the module then rebuilds automatically on kernel updates.

Immutable / atomic distros (Bazzite, Silverblue, Kinoite) are not supported for the kernel module - DKMS doesn't fit rpm-ostree. On those, run the WireView GUI Flatpak in direct-serial mode, which doesn't need this module.

Build from source

Requirements

Linux with kernel headers (linux-headers-$(uname -r))
A Thermal Grizzly WireView Pro II device connected via USB
gcc and make

Build

git clone https://github.com/emaspa/wireview-hwmon.git
cd wireview-hwmon
make

This builds the kernel module (wireview_hwmon.ko), the daemon (wireviewd), and the CLI tool (wireviewctl).

Quick start

# Install udev rules (serial port access + hwmon device permissions)
sudo cp 99-wireview-hwmon.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger

# Load the kernel module
sudo insmod wireview_hwmon.ko

# Run the daemon
sudo ./wireviewd

# In another terminal, check sensor data
sensors wireview-isa-0000

Install (persistent)

sudo make install  # installs module, daemon, udev rules, and systemd service

# Auto-load module on boot
echo wireview_hwmon | sudo tee /etc/modules-load.d/wireview-hwmon.conf

# Enable and start the daemon service
sudo systemctl enable --now wireviewd

# Load the module now (or reboot)
sudo modprobe wireview_hwmon

# Verify
sensors wireview-isa-0000

After rebooting, both the module and daemon will start automatically.

Secure Boot

If Secure Boot is enabled, the kernel will refuse to load unsigned modules (Key was rejected by service). You have two options:

Option 1: Disable Secure Boot (easiest)

Reboot, enter BIOS/UEFI settings, disable Secure Boot, then boot back in and load the module normally.

Option 2: Sign the module (keeps Secure Boot enabled)

# Generate a signing key (one-time)
sudo mkdir -p /var/lib/shim-signed/mok
sudo openssl req -new -x509 -newkey rsa:2048 \
  -keyout /var/lib/shim-signed/mok/MOK.priv \
  -outform DER -out /var/lib/shim-signed/mok/MOK.der \
  -nodes -days 36500 -subj "/CN=Local Module Signing/"

# Enroll the key (requires reboot to confirm in MokManager)
sudo mokutil --import /var/lib/shim-signed/mok/MOK.der

# Reboot - MokManager will prompt you to enroll the key

# After reboot, sign the module
sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 \
  /var/lib/shim-signed/mok/MOK.priv \
  /var/lib/shim-signed/mok/MOK.der \
  /lib/modules/$(uname -r)/updates/wireview_hwmon.ko

# Now it loads
sudo modprobe wireview_hwmon

You only need to generate and enroll the key once. After a kernel update, re-sign the module or rebuild with sudo make install and sign again.

Uninstall

sudo make uninstall

Daemon options

wireviewd [-i interval_ms] [-d /dev/ttyACMx]

  -i  Poll interval in milliseconds (default: 1000)
  -d  Serial device path (default: auto-detect)

Exposed sensors

Sensor	hwmon attribute	Unit
Pin 1-6 Voltage	`in0_input` - `in5_input`	millivolts
Average Voltage	`in6_input`	millivolts
Supply Voltage (Vdd)	`in7_input`	millivolts
Pin 1-6 Current	`curr1_input` - `curr6_input`	milliamps
Total Current	`curr7_input`	milliamps
Total Power	`power1_input`	microwatts
Pin 1-6 Power	`power2_input` - `power7_input`	microwatts
Onboard Temp In	`temp1_input`	millidegrees C
Onboard Temp Out	`temp2_input`	millidegrees C
External Temp 1	`temp3_input`	millidegrees C
External Temp 2	`temp4_input`	millidegrees C
Fan Duty	`fan1_input`	% (0-100)
Fault Status	`intrusion0_alarm` (`intrusion0_label`)	0/1
Fault Log	`intrusion1_alarm` (`intrusion1_label`)	0/1
Fault Status (raw)	`fault_status_raw`	bitmask
Fault Log (raw)	`fault_log_raw`	bitmask
PSU Capability	`psu_cap`	enum (0-4)

All voltage, current, power, and temperature channels also expose _label attributes for tool-friendly names.

Example `sensors` output

wireview-isa-0000
Adapter: ISA adapter
Pin 1:       +12.12 V
Pin 2:       +12.13 V
Pin 3:       +12.11 V
Pin 4:       +12.12 V
Pin 5:       +12.11 V
Pin 6:       +12.12 V
Average:     +12.12 V
Vdd:          +3.30 V
Pin 1:        5.23 A
Pin 2:        5.45 A
Pin 3:        5.12 A
Pin 4:        5.34 A
Pin 5:        5.56 A
Pin 6:        5.43 A
Total:       32.13 A
Total:      384.50 W
Pin 1:       63.40 W
Pin 2:       66.11 W
Pin 3:       62.01 W
Pin 4:       64.68 W
Pin 5:       67.33 W
Pin 6:       65.82 W
Onboard In:  +45.3°C
Onboard Out: +42.1°C
External 1:  +38.7°C
External 2:    N/A
fan1:           75
Fault Status:  ALARM
Fault Log:     OK

CLI tool

wireviewctl lets you query sensor data and send device commands from the terminal or scripts.

wireviewctl <command> [args]

Commands (require wireviewd running):
  info              Show device firmware, UID, and build info
  clear-faults      Clear all fault status and log
  read-config       Read device config (hex to stdout)
  write-config FILE Write device config (hex from file)
  screen CMD        Change display (main|simple|current|temp|status|same|pause|resume)
  nvm CMD           NVM operation (load|store|reset|load-cal|store-cal|load-cal-factory|store-cal-factory)
  build             Show firmware build string
  bootloader        Enter DFU bootloader mode

Commands (require wireview_hwmon module):
  sensors           Show all sensor readings from hwmon sysfs

Monitor:
  top [--host H[:port][,H2...]]... [--interval MS]
                    Live dashboard: local device + remote hosts (q to quit)

Examples

# Show device info
wireviewctl info

# Read all sensors (scriptable key: value format)
wireviewctl sensors

# Live dashboard of this host and remotes (q to quit) - see "LAN monitoring" below
wireviewctl top --host 192.168.1.50

# Switch to simple display
wireviewctl screen simple

# Back up and restore config
wireviewctl read-config > config.hex
wireviewctl write-config config.hex

# Store config to NVM
wireviewctl nvm store

# Use in scripts
POWER=$(wireviewctl sensors | grep total_power_uw | cut -d' ' -f2)
echo "Total power: $((POWER / 1000000)) W"

Daemon socket

The daemon listens on a Unix socket at /run/wireviewd.sock, allowing external programs (including the wireview-linux app) to send commands to the device without direct serial access. Supported commands:

Command	Description
GET_DEVICE_INFO	Query firmware version, config version, UID, build string
CLEAR_FAULTS	Clear fault status and/or fault log
READ_CONFIG	Read the device configuration
WRITE_CONFIG	Write a new device configuration
SCREEN_CMD	Send a screen command (change display page)
NVM_CMD	Send an NVM command (store/recall configuration)
READ_BUILD	Read the firmware build string
ENTER_BOOTLOADER	Restart the device into DFU bootloader mode

The socket uses a binary protocol: request [type:u8][len:u16 LE][payload], response [status:u8][len:u16 LE][payload].

Notes

When used with the wireview-linux app, the daemon handles the serial port and the app communicates through hwmon (sensors) and the daemon socket (commands). Both can run simultaneously.
When used standalone (without the app), the daemon owns the serial port exclusively.
If the device is disconnected, the daemon will wait and reconnect automatically.
Sensor readings become stale (report N/A) if no data is received for 5 seconds.

LAN monitoring (remote access)

The daemon can publish its readings over the LAN and accept authenticated commands, so you can monitor and control WireViews on other machines - from the GUI app, from wireviewctl top, or from any HTTP client. It is off by default: no port is opened unless you enable it.

Endpoints (port 9876 by default)

GET /sensors - JSON snapshot of the device (per-pin V/I, power, temps, faults, fan duty, PSU cap, firmware build). Open, read-only; the same endpoint the GUI app and wireviewctl top consume.
GET /config - the device's current configuration, so a remote editor can load it.
POST /command - write commands (screen / NVM / clear-faults / writeConfig). Authenticated (see below); the firmware bootloader is never reachable over the network.

Enabling it

Edit /etc/wireview/config (a documented reference is created on first install):

remote_enabled=1        # open the listener (default 0 = off)
port=9876               # listener port (default)
secret=your-passphrase  # shared secret for authenticated remote writes (empty = reads only)
log_days=14             # audit-log retention in days

Then sudo systemctl restart wireviewd. Reads stay open; writes require the secret.

Security model

Opt-in - nothing is exposed unless remote_enabled=1.
Writes are signed with HMAC-SHA256. Each POST /command carries a timestamp, nonce, and signature over the body using the shared secret, so the secret never travels on the wire and replays are rejected (±30 s window). An empty secret disables writes (the daemon answers 403).
Flood protection - request-size cap and bounded handling.
Audit log (below). No TLS: this is built for a trusted LAN - the HMAC keeps the secret off the wire, but anyone on the LAN can read /sensors while the listener is on.

`wireviewctl top` - live monitor

A btop-style terminal dashboard of every WireView, local and remote:

wireviewctl top                                  # local device only
wireviewctl top --host 192.168.1.50              # add a remote host
wireviewctl top --host 192.168.1.50:9876,nas     # several (comma/space list, host[:port])
wireviewctl top --interval 500                    # refresh every 500 ms

Each device gets a panel with colored power/current bar gauges (green/yellow/red by load), a per-pin Volts/Amps/Watts breakdown, temperatures, fan duty, and fault state. A two-device view (one local, one remote) looks like:

 WireView top  2 devices  14:22:07  refresh 1.0s  q to quit

╭─ local ─ WireView Pro II ─ fw3 ─ cap 600W
│ Power   ████████████████░░░░░░░░░░░░    372.4 W
│ Current █████████████████░░░░░░░░░░░     31.2 A
│ Pin          1       2       3       4       5       6
│ Volts    12.11   12.13   12.10   12.12   12.11   12.12
│ Amps      5.21    5.40    5.08    5.33    5.55    4.63
│ Watts     63.1    65.5    61.4    64.6    67.2    56.1
│ Temp   In 45.3° Out 42.1° E1 38.7° E2 --   Fan 75%  Faults none
╰─
╭─ 192.168.1.50 ─ WireView Pro II ─ fw3 ─ cap 450W
│ Power   ██████░░░░░░░░░░░░░░░░░░░░░░    118.6 W
│ Current ███████░░░░░░░░░░░░░░░░░░░░░      9.8 A
│ Pin          1       2       3       4       5       6
│ Volts    12.09   12.10   12.08   12.11   12.09   12.10
│ Amps      1.62    1.70    1.55    1.68    1.61    1.64
│ Watts     19.6    20.6    18.7    20.3    19.5    19.8
│ Temp   In 39.8° Out 36.2° E1 -- E2 --   Fan 40%  Faults none
╰─

(An unreachable host shows a single red offline line instead of stalling the view.)

Remote hosts can also be listed (one host[:port] per line) in /etc/wireview/hosts. The local device is read straight from hwmon sysfs; remotes via GET /sensors. Press q to quit.

Audit log

When the listener is enabled, command activity is recorded to a daily-rotating file in /var/log/wireview/ (retention from log_days):

2026-06-10T09:41:08 [INFO] wireviewd started; listener enabled, remote writes enabled, log retention 14 days
2026-06-10T09:41:12 [INFO] command from 192.168.1.20: op=screen -> executed
2026-06-10T09:41:15 [WARN] command from 192.168.1.33 rejected: bad signature

High-frequency /sensors polls are not logged.

Configuration files

File	Purpose
`/etc/wireview/config`	Daemon settings: `remote_enabled`, `port`, `secret`, `log_days`. Mode `600`. Read at (re)start. A commented reference is installed if none exists.
`/etc/wireview/hosts`	Optional remote-host list for `wireviewctl top` (one `host[:port]` per line).
`/var/log/wireview/`	Daily-rotating audit logs (created automatically when the listener is on).

License

GPL-2.0

Name		Name	Last commit message	Last commit date
Latest commit History 52 Commits
.github		.github
aur		aur
debian		debian
rpm		rpm
.gitignore		.gitignore
99-wireview-hwmon.rules		99-wireview-hwmon.rules
Makefile		Makefile
Makefile.dkms		Makefile.dkms
README.md		README.md
avahi-wireview.service		avahi-wireview.service
dkms.conf		dkms.conf
sha256.c		sha256.c
sha256.h		sha256.h
wireview-config.sample		wireview-config.sample
wireview_hwmon.c		wireview_hwmon.c
wireviewctl.c		wireviewctl.c
wireviewd.c		wireviewd.c
wireviewd.service		wireviewd.service

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

wireview-hwmon

How it works

Installation

Ubuntu 24.04 / 26.04 (PPA)

Ubuntu / Debian (.deb packages)

Fedora (COPR)

Fedora (.rpm packages)

Arch / CachyOS / EndeavourOS (AUR)

Build from source

Requirements

Build

Quick start

Install (persistent)

Secure Boot

Uninstall

Daemon options

Exposed sensors

Example sensors output

CLI tool

Examples

Daemon socket

Notes

LAN monitoring (remote access)

Endpoints (port 9876 by default)

Enabling it

Security model

wireviewctl top - live monitor

Audit log

Configuration files

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 7

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Example `sensors` output

`wireviewctl top` - live monitor

Packages