About Qcontrol

Qcontrol is a daemon and command line tool which controls the various peripherals that are present on many embedded NAS devices. It supports any peripheral which is driven by either serial port of GPIO, including lights, fans, LCDs and watchdogs. Although it primarily supports QNAP TS devices it is designed to be modular and adding support for other devices should be easy.

Qcontrol is configured using the LUA programming language which gives it lots of flexibility.

Supported devices

  • QNAP TS-109, TS-109 II, TS-209 and TS-209 II (ts209)
  • QNAP TS-409 and TS-409U (ts409)
  • QNAP TS-110, TS-119, TS-210, TS-219 and TS-219P (ts219)
  • QNAP TS-410, TS-410U, TS-419P and TS-419U (ts41x)
  • Synology Diskstation and Rackstation (synology)

Download

qcontrol can be downloaded using git from the git repository or as a tarball from releases page.

Installation

In addition to a C compiler and standard libraries to build and run qcontrol you will need:

To build just type make.

Your Linux kernel should have the KEYBOARD_GPIO and INPUT_EVDEV configuration options enabled.

Reporting Bugs

Please report bugs in the Debian bug tracker.

If you are running Debian then you can run:

$ reportbug qcontrol

If you are not running Debian please send a mail to submit@bugs.debian.org. You must include at the top of the mail:

Package: qcontrol
Version: <version>
Tags: upstream

Replacing <version> with the version of qcontrol you are using. Follow this with a blank line and then a description of the issue etc as normal.

For more information on reporting bugs to the Debian bug tracker please see http://www.debian.org/Bugs/Reporting.

Releases

Releases are also announced on the qcontrol stream of my blog.

  • Fix for kernels which have permissions 0200 (write-only) on gpio export device.
  • Updates to systemd unit files.
  • Update to README for (not so) new homepage (thanks to Martin Michlmayr).
  • Add a configuration option in the examples to handle QNAP devices which lack a fan (Debian bug #712841, thanks to Martin Michlmayr for the patch and to Axel Sommerfeldt).
Download: tar (sig)   tar.gz (sig)   tar.xz (sig)
Posted Sun May 27 11:00:11 2018
  • Update list of supported devices (Martin Michlmayr, via Debian bug #788911).
  • Update examples to handle varying gpio-keys node name.
  • Improvements to option parsing and help messages (Arnaud, see also Debian bug #804767).
Download: tar (sig)   tar.gz (sig)   tar.xz (sig)
Posted Sun Oct 30 13:57:00 2016
  • Correct argument handling for system-status command
Download: tar (sig)   tar.gz (sig)   tar.xz (sig)
Posted Fri Apr 11 17:04:15 2014
  • Reduce spaminess of temperature control (Debian bug #727150).
  • Support for enabling/disabling RTC on ts219 and ts41x. Patch from Michael Stapelberg (Debian bug #732768).
  • Support for Synology Diskstation and Rackstation NASes. Patch from Ben Peddell.
  • Return correct result from direct command invocation (Debian bug #617439).
  • Fix ts41x LCD detection.
  • Improved command line argument parsing.
  • Lots of internal refactoring and cleanups.
Download: tar (sig)   tar.gz (sig)   tar.xz (sig)
Posted Fri Apr 11 11:57:46 2014
  • Fix memory corruption bug (Debian bug #708376).
  • Ignore code 0x43 from PIC, avoid spamming log.
  • Implement hysteresis for fan speed (Arno via Debian bug #709095).
  • Support for systemd socket activation and added systemd service files (both from Michael Stapelberg).
Download: tar (sig)   tar.gz (sig)   tar.xz (sig)
Posted Sun Sep 29 19:01:12 2013
  • Add build targets to enable static linking (Original patch by Frans Pop).
  • Wake-on-Lan and EUP control (by Michael Stapelberg).
  • Updated example configurations (based on Debian package).
  • Support loading configuration snippets from a directory (Ian Campbell,).
  • Various other bug fixes.
Download: tar (sig)   tar.gz (sig)   tar.xz (sig)
Posted Sun May 12 19:10:18 2013

First release by new maintainer. This is a rollup of some changes which were made in the old upstream SVN repository but never released and some patches which had been made in the Debian packaging. What's here corresponds to the Debian 0.4.2+svn-r40-3 package.

The 0.4.2 release was untagged in SVN, but corresponds to r14, new stuff since then includes:

  • Support for more hardware (TS-119, TS-219, TS-41x, all by Martin Michlmayr)
  • Support auto power on feature (by Martin Michlmayr)
  • Support for the A125 LCD on TS-419P devices (by Bernhard R. Link)
  • Support for a daemon mode, including syslog (Byron Bradley)
  • Support for disabling the watchdog on TS-219P II and TS-419P II (Helmut Pozimski)
  • Various other fixes (Loïc Minier, Martin, Bernhard, Byron)

As well as the change of maintainer I think the addition of the daemon mode warrants the bump to 0.5.0.

Download: tar (sig)   tar.gz (sig)   tar.xz (sig)
Posted Sat May 4 16:13:57 2013