Linux kernel platform driver for ASUSTOR NAS hardware (leds, buttons).
On many systems, ASUSTOR uses a mix of IT87 and CPU GPIOs to control leds and buttons. Adding support for more systems should be fairly trivial, but may require some reverse engineering to figure out which GPIOs are responsible for what.
WARNING: Changing GPIO input/outputs (as done by this module) without knowledge of their effects can be dangerous and lead to instability, corrupted data or a broken system. Use at your own risk.
Note: The following dependencies from the mainline linux kernel are required, if they're not included by your distribution you may need to compile them yourself (note that some modules are only required on specific ASUSTOR models):
gpio-ich (AS6)hwmon-vid (for the contained asustor-it87 module)it87 (AS6, AS61, AS62, AS66XX, AS67XX, AS54XX)
it87 called asustor-it87 which skips fan pwm sanity checks
and supports more variants of IT86XX and the IT87XX chips than the kernels it87 driver.
Support for timer-based blinking of up to two LEDs (only works on some models) has also been added.gpio-it87 called asustor-gpio-it87. The only change is supporting
the IT8625E chip that is used in several newer ASUSTOR devices.acpi_enforce_resources=lax to kernel boot arguments for full functionalitylm-sensors)pwm1example/fancontrol for an example /etc/fancontrol config for a AS62 systempwm1 etc should be in /sys/devices/platform/asustor_it87.*/hwmon/hwmon*/pwm3sudo dmidecode -s system-manufacturer and sudo dmidecode -s system-product-name):
/sys/class/leds/power:*)
git clone https://github.com/mafredri/asustor-platform-driver
cd asustor-platform-driver
make
sudo make installit87Note: This is probably not supported on all devices, only ones that use the IT8625E or IT8720F chips or similar.
Switch off that annoying blinking of the green status LED:
echo 0 | sudo tee /sys/devices/platform/asustor_it87.*/hwmon/hwmon*/gpled1_blinkYou can re-enable it with echo 47 | sudo tee ... because the status led is it87_gp47.
You can also make other GPIO LEDs blink by using their GP number instead of 47.
Note that this could even be done for two LEDs, as gpled2_blink also exists.
If you want the green status LED to be constantly on (without blinking),
the following should work, if gpled1_blink is still 47:
echo 11 | sudo tee /sys/devices/platform/asustor_it87.*/hwmon/hwmon*/gpled1_blink_freqOr, if you set gpled1_blink to 0 (or to another LED), you can switch on the status LED with:
echo 1 | sudo tee /sys/class/leds/green\:status/brightnessYou can also configure the blinking frequency to one of 11 supported modes, for example, set mode 3 with:
echo 3 | sudo tee /sys/devices/platform/asustor_it87.*/hwmon/hwmon*/gpled1_blink_freqThe following blinking frequency modes exist on the IT8625:
Other chips also support blinking control, but might support fewer modes. If blink frequency setting is supported at all, mode 11 (always on) should always work, and setting the other modes won't break anything, but might have differing frequencies than described above (and setting modes 8-10 will automatically set mode 0 instead).
Mode 11 for "always on" should always work, at least the bit set there was listed in all datasheets I checked (unfortunately, its function was never described in detail).
Linux allows controlling LEDs with "triggers", which means that they will blink on specific events. By default, the trigger is "none" (which means "always on") for most LEDs, but there are others that you may enable (likely in a script that's run after boot), for example:
# make green USB LED blink on USB traffic
echo usb-host > /sys/class/leds/green\:usb/trigger
# make LAN led light up if the first network link is up:
echo r8169-0-200:00:link > /sys/class/leds/blue\:lancat /sys/class/leds/green\:usb/trigger will list the available triggers, with the currently used
one being marked with square brackes (e.g. [none] kbd-scrolllock kbd-numlock kbd-capslock ...).
it87 and PWM polarityThis project includes a patched version of the it87 module that is part of mainline kernel (asustor-it87). It skips PWM sanity checks for the fan because ASUSTOR firmware correctly initializes fans in active low polarity and can be used straight with fancontrol or similar tools.
Note that it87 conflicts with asustor-it87, you may wish to add it87 to the module blocklist or explicitly load asustor-it87 instead.
You may want to use patches/001-ignore-pwm-polarity-it87.patch for the it87 kernel module if it complains about PWM polarity. In this case, it's possible to use fix_pwm_polarity=1, however, it may reverse the polarity which is unwanted (i.e. high is low, low is high). It works fine when left as configured by the firmware.
blue:power and red:power can be turned on simultaneously for a pink-ish tintgreen:status and red:status can be turned on simultaneously for a orange-ish tintIf you would like additional hardware to be supported, pull requests are more than welcome. Alternatively, you can install these prerequisites:
sudo apt-get install -y gpiodAnd then open an issue and attach outputs from the following commands:
sudo dmesg
sudo dmidecode -s system-manufacturer
sudo dmidecode -s system-product-name
sudo dmidecode -s bios-vendor
sudo dmidecode -s bios-version
sudo dmidecode -s bios-release-date
sudo dmidecode -s bios-revision
sudo gpioinfoNOTE: If gpioinfo does not return anything, you may need to figure out which (if any) gpio drivers to load. Also keep in mind that your distribution may not ship with all gpio- drivers, so you may need to compile them yourself.
disk-activity trigger always blinks all LEDs on activity from any diskDKMS installation to enable module auto-build with kernel upgrades.
sudo make dkms