zopieux / qnapctl

Control QNAP TS-453 Pro hardware LEDs, LCD and react to button pushes.

qnapctl

A tiny system daemon to control and react to QNAP hardware, including:

• the panel LCD screen (toggle backlight and change displayed text)
• the panel LCD buttons, usually for navigating the LCD display
• the STATUS and USB LEDs
• the USB COPY button
• the disk ERROR LEDs

Also includes a demo program that makes use of the API exposed by the daemon.

Overview

Beware: this was developped and tested exclusively on the QNAP device I own, model TS-453 Pro. This code most likely won't work on different hardware.

TS-453 Pro features:

• an A125 LCD panel with a 2×16 char display, backlight and two control buttons
• a 4-disk bay, with activity and error LEDs for each of the 4 bays
• some extra LEDs: dual-color status (green & red), USB activity and network activity (this one sadly cannot be controlled)

qnapd

qnapd is a C++ (Qt) daemon that:

• reads from internal serial device /dev/ttyS1 to intercept LCD button presses (ENTER and SELECT)
• writes to internal serial device /dev/ttyS1 to toggle LCD backlight and change LCD text
• polls a raw I/O port to intercept USB COPY button presses
• writes to a few raw I/O ports to toggle the various front panel LEDs

The daemon receives orders and broadcasts events using the system DBus. The DBus API is self-documented in the XML interface.

qnapctl

qnapctl is a C++ (Qt) program that communicates with qnapd to provide a few basic features:

• blinks the green status LED faster or slower depending on load average
• blinks the red status LED when there are failed systemd services
• displays a few basic info on the LCD display eg. NIC IP addresses, using LCD buttons to navigate the various info

License

MIT, see LICENSE.

qnapctl's Issues

Do the I/O ports work on anything other than QTS?

Hi there, first of all, thank you for making this!

I myself have a QNAP TS-453D, with TrueNAS SCALE installed on it. I would like to make something like this, but for TrueNAS instead (since that's what I prefer, rather than QTS).

Looking at SIOPoller.cpp, there is kRegPort, how did you find out about this? (is this mapped in the BIOS? I've never done any of this, so I'd love to know.) And, is this valid, even though there's a different OS on it, or is this value purely for QTS? And is this the same for all of the ports, such as the portStatusLed and 0x91?