NUTDRV_QX(8) NUT Manual NUTDRV_QX(8) (NAME) nutdrv_qx - QX NUT (SYNOPSIS) nutdrv_qx -h nutdrv_qx -a UPS_NAME [OPTIONS] nutdrv_qx . nutupsdrv(8) . (SUPPORTED HARDWARE) Mega System Technologies, Inc. . NUT Megatec Q* Megatec Qx . nutdrv_qx Armac Blazer Energy Sistem Fenton Technologies General Electric Gtec Hunnox Masterguard Mustek Powercool Voltronic Power SKE ( ) . : Viewpower voltronic* mecer . protocol ( Qx) subdriver ( USB ) . subdrivers nutdrv_qx . Qx / nutdrv_qx . ups.conf(5) . NUT . . USB . (EXTRA ARGUMENTS) . (ups.conf(5) ): ondelay = ( ). . ( ) . ups.delay.start ( -k upsdrvctl(8) shutdown FSD upsmon(8) ): ups.delay.start upsrw(8) . offdelay = ( ). ( ) ( ) . . ups.delay.shutdown ( -k upsdrvctl(8) shutdown FSD upsmon(8) ): ups.delay.shutdown upsrw(8) . stayoff stayoff ups.conf(5) FSD shutdown.stayoff ups.delay.shutdown ( ) ( ) shutdown.return ups.delay.shutdown ups.delay.start ( ). protocol = . : bestups, gtec, hunnox, innovart31, innovart33, innovatae, masterguard, mecer, megatec, megatec/old, mustek, q1, q2, q6, voltronic, voltronic-axpert, voltronic-qs, voltronic-qs-hex zinto. --help protocol . q1 mecer, megatec zinto novendor/norating ( ) . pollfreq = ( ) . pollinterval ups.status ( ups.conf(5)). ( ) . battery.charge battery.runtime : default.battery.voltage.high = . battery.charge ( ). default.battery.voltage.low = . battery.charge ( ). default.battery.voltage.nominal = , override.battery.voltage.nominal = ( ) . override.battery.packs = <<>> ( battery_voltage_reports_one_pack ). battery.voltage.nominal 24 battery.voltage 2 battery.packs 12 . . <<>> battery.charge battery.runtime ( runtimecal) . battery_voltage_reports_one_pack ( override.battery.packs ). ( : ablerex, masterguard voltronic-qs-hex) battery.voltage battery.packs battery.voltage . battery.charge battery.runtime -- . runtimecal = ,,, (). . . : runtimecal = 240,100,720,50 . . ( ). chargetime = . ( ) . runtimecal . idleload = . . runtimecal . BESTUPS, INNOVART31, INNOVART33, INNOVATAE, MECER, MEGATEC, MEGATEC/OLD, MUSTEK, Q1, Q2, Q6, VOLTRONIC-QS, VOLTRONIC-QS-HEX, ZINTO ignoresab << >> (Shutdown Active) ( ups.status FSD ... ). << >> . MECER, MEGATEC, MEGATEC/OLD, MUSTEK, ZINTO ondelay 0..599940 . offdelay 12..600 . norating (Rating) . . novendor . . BESTUPS ondelay 60..599940 . offdelay 12..5940 . pins_shutdown_mode = DB9 ( EPS-0059 Best Power) [0..6]. MASTERGUARD slave_addr = (claim) (slave address) (ups.id) . USB . ups.id ( upsrw(8)) slave_addr . INNOVART31, INNOVART33, INNOVATAE, Q1, Q2, Q6 ondelay 0..599940 . offdelay 12..600 . Q2, Q6 nooutstats WA . . VOLTRONIC-QS, VOLTRONIC-QS-HEX ondelay 60..599940 . offdelay 12..540 . VOLTRONIC-AXPERT NUT . reset_to_default bypass_alarm (!) (Bypass) [/] battery_alarm (!) [/] VOLTRONIC voltronic . . ondelay 0..599940 . offdelay 12..5940 . battery_number = [1..9]. . output_phase_angle = [000, 120, 180, 240]. reset_to_default . ( (Standby) ) : ups.start.auto battery.protection battery.energysave ups.start.battery outlet.0.switchable input.transfer.high input.transfer.low input.frequency.high input.frequency.low. ( : enabled disabled ): alarm_control = (!) [enabled/disabled]. beeper.enable beeper.disable . bypass_alarm = (!) (Bypass) [enabled/disabled]. battery_alarm = (!) [enabled/disabled]. bypass_when_off = [enabled/disabled]. (AC) . bypass_forbidding = [enabled/disabled]. . converter_mode = [enabled/disabled]. . . eco_mode = (ECO) [enabled/disabled]. / . PFC . bypass.start bypass.stop . advanced_eco_mode = [enabled/disabled]. / . PFC . battery_open_status_check = [enabled/disabled]. . site_fault_detection = [enabled/disabled]. . constant_phase_angle = ( ) [enabled/disabled]. limited_runtime_on_battery = [enabled/disabled]. / . reset_to_default . AC ( ). . max_bypass_volt = (). min_bypass_volt = (). max_bypass_freq = (). min_bypass_freq = (). P31 P31 . work_range_type = P31 [Appliance/UPS]. (TESTING) . . . . testing . cablepower = DTR RTS (normal). DTR RTS (reverse) DTR RTS (both) DTR RTS (none) . USB port = NUT. auto USB . /dev/usb/hiddev0 API libusb . ( ). port . vendor product vendorid productid serial bus device . allow_duplicates ( !) vendorid = regex, productid = regex, vendor = regex, product = regex, serial = regex USB . ( regex(7) ) vendor/product/serial ( ) vendorid productid . lsusb(8) NUT -DD . : o -x vendor="Foo.Corporation.*" o -x vendorid="051d*" (APC) o -x product=".*(Smart|Back)-?UPS.*" bus = regex . USB . ( bus="002" bus="00[2-3]") /sys/bus/usb/devices lsusb(8) . ( USB) . device = regex . USB . ( device="001" device="00[1-2]") /sys/bus/usb/devices lsusb(8) . . busport = regex . libusb device USB -- . USB lsusb -tv . NUT ( ) NUT . allow_duplicates . ( VID:PID ) . "Resource busy" -- . ! ! . ! usb_set_altinterface = bAlternateSetting usb_set_altinterface() USB 0 () . usb_config_index, usb_hid_rep_index, usb_hid_desc_index, usb_hid_ep_in, usb_hid_ep_out (Endpoint) 0 ( ). . usb_hid_desc_index wDescriptorLength ( ) lsusb . LIBUSB_DEBUG = _ NUT USB NUT ( DEBUG_MIN ups.conf(5) driver.debug) LibUSB . LIBUSB_DEBUG LIBUSB_DEBUG NUT ( nut.conf(5) ) 4 (" ") . : o https://libusb.sourceforge.io/api-1.0 o https://libusb.sourceforge.io/api-1.0/group__libusb__lib.html subdriver = USB . : ablerex, armac, cypress, fabula, fuji, gtec, hunnox, ippon, krauler, phoenix, phoenixtec, sgs snr. --help subdriver . vendorid productid . langid_fix = (language ID) krauler. (LDLC Dynamix ) . (0x409 0x4095) NUT (HCL) . noscanlangid langid . (IMPLEMENTATION NOTES) armac Armac "PowerManagerII" Armac : "2004 Richcomm Technologies, Inc. Dec 27 2005 ver 1.1." . Richcomm -- richcomm_usb. fabula megatec test.battery . shutdown.return ups.delay.start/ondelay . gtec Gtec USB ( Gtec ZP120N) . ups.conf : [gtec-ups] driver = "nutdrv_qx" port = "auto" subdriver = "gtec" protocol = "gtec" ( blazer_usb(8)) : o "Q1" . o . . o "Q4" . Q1 . o USB USB . nutdrv_qx blazer_usb . o : . hunnox fabula . fuji megatec shutdown.stayoff load.off . shutdown.return ups.delay.start/ondelay . krauler megatec : shutdown.return shutdown.stayoff load.off. snr megatec : shutdown.return shutdown.stayoff load.off. (UPS COMMANDS) (upscmd(8) ): beeper.toggle ( ). load.on ( ). load.off ( ). shutdown.return . ups.delay.start ups.delay.shutdown . shutdown.stayoff ( ). ups.delay.shutdown . shutdown.stop . test.battery.start.deep ( ). test.battery.start.quick ( ). test.battery.stop ( ). BESTUPS, INNOVART31, INNOVART33, INNOVATAE, MECER, MEGATEC, MEGATEC/OLD, MUSTEK, Q1, Q2, Q6, ZINTO test.battery.start ( ) [60..5940]. MASTERGUARD clear.fault.record / beeper.enable . beeper.disable . test.battery.start.low . << >> << >> . << >> . Masterguard A1000 A2000 . test.battery.start ( ) [0..5940]. ( ) ( ) . bypass.start bypass.stop VOLTRONIC POWER P98 ( MECER) test.battery.start ( ) [12..5940]. ( ) ( ) . VOLTRONIC voltronic . . beeper.enable . beeper.disable . test.battery.start [12..5940]. ( ) ( ) . outlet.1.load.off . outlet.1.load.on . outlet.2.load.off . outlet.2.load.on . outlet.3.load.off . outlet.3.load.on . outlet.4.load.off . outlet.4.load.on . bypass.start (ECO Mode). bypass.stop (ECO Mode). (BATTERY CHARGE GUESSTIMATION) battery.charge battery.runtime . battery.voltage.high battery.voltage.low ups.conf(5) runtimecal . . . battery.voltage - battery.voltage.low battery.charge = ------------------------------------------ x 100 % battery.voltage.high - battery.voltage.low ( ) . runtimecal . . 0% ( ) . ( runtimecal). . . ( ). ups.conf(5) . NUT battery.charge battery.runtime . MEGATEC (NOTES FOR THE PREVIOUS USER OF MEGATEC DRIVERS) megatec nutdrv_qx nutdrv_qx . megatec ups.conf(5) : battvolts default.battery.voltage.high default.battery.voltage.low . dtr rts cablepower . ignoreoff . BLAZER (NOTES FOR THE PREVIOUS USER OF BLAZER DRIVERS) blazer nutdrv_qx nutdrv_qx . blazer ups.conf(5) : ondelay blazer nutdrv_qx . : test.battery.start blazer nutdrv_qx . BESTUPS (NOTES FOR THE PREVIOUS USER OF BESTUPS DRIVER) bestups nutdrv_qx nutdrv_qx . bestups ups.conf(5) : nombattvolt, battvoltmult . ID . VOLTRONIC (NOTES FOR THE PREVIOUS USER OF VOLTRONIC DRIVERS) voltronic nutdrv_qx nutdrv_qx . voltronic ups.conf(5) : ondelay voltronic nutdrv_qx . blazer ( ) . battnumb battery_number . upsrw(8) NUT -- . battpacks -> battery.packs [1..99]. . battlow -> battery.voltage.low . . auto_reboot -> ups.start.auto [enabled/disabled]. AC . battery_protection -> battery.protection [enabled/disabled]. energy_saving -> battery.energysave [enabled/disabled]. . cold_start -> ups.start.battery [enabled/disabled]. AC . outlet_control -> outlet.0.switchable [enabled/disabled]. ( outlet.{1,2,3,4}.delay.shutdown) . . max_eco_volt -> input.transfer.high (). AC ( ). min_eco_volt -> input.transfer.low (). AC ( ). max_eco_freq -> input.frequency.high (). AC ( ). min_eco_freq -> input.frequency.low (). AC ( ). outlet1_delay -> outlet.1.delay.shutdown [0..59940] (). outlet2_delay -> outlet.2.delay.shutdown [0..59940] (). outlet3_delay -> outlet.3.delay.shutdown [0..59940] (). outlet4_delay -> outlet.4.delay.shutdown [0..59940] (). batt_type -> battery.type ( P31) [Li/Flooded/AGM]. (KNOWN PROBLEMS) . . . load.off shutdown.stayoff . . ( enabled disabled ). beeper.toggle . . MASTERGUARD <<>> A ( A700/1000/2000/3000 - ) E ( E60/100/200) E A . VOLTRONIC-AXPERT Voltronic Power Axpert P30 ( ) . NUT ( experimental. ). NUT . VOLTRONIC-QS load.off shutdown.stayoff ( ) . shutdown.return ondelay : o ( ) load.off/shutdown.stayoff load.on/shutdown.stop o load.off/shutdown.stayoff AC ( ) o shutdown.return . VOLTRONIC-QS-HEX shutdown.return load.off shutdown.stayoff . ( VOLTRONIC) (UPS WARNINGS (VOLTRONIC PROTOCOL)) voltronic (bit1bit2...bit63bit64) . ups.alarm ups.alarms . ( ). . voltronic +---+-----------------------------------+ |# | | | | | +---+-----------------------------------+ |1 | | | | | +---+-----------------------------------+ |2 | | | | | +---+-----------------------------------+ |3 | | | | | +---+-----------------------------------+ |4 | | | | | +---+-----------------------------------+ |5 | | | | | | | | +---+-----------------------------------+ |6 | | | | | | | | | | | +---+-----------------------------------+ |7 | | | | | +---+-----------------------------------+ |8 | | | | | +---+-----------------------------------+ |9 | | | | | +---+-----------------------------------+ |10 | | +---+-----------------------------------+ |11 | EPO | | | | +---+-----------------------------------+ |12 | | | | | | | | +---+-----------------------------------+ |13 | | | | | +---+-----------------------------------+ |14 | | +---+-----------------------------------+ |15 | | | | | | | | +---+-----------------------------------+ |16 | L1 | | | | +---+-----------------------------------+ |17 | L2 | | | | +---+-----------------------------------+ |18 | L3 | | | | +---+-----------------------------------+ |19 | | | | PFC | | | L1 | +---+-----------------------------------+ |20 | | | | PFC | | | L1 | +---+-----------------------------------+ |21 | | | | PFC | | | L2 | +---+-----------------------------------+ |22 | | | | PFC | | | L2 | +---+-----------------------------------+ |23 | | | | PFC | | | L3 | +---+-----------------------------------+ |24 | | | | PFC | | | L3 | +---+-----------------------------------+ |25 | | | | | | | | | | CAN | +---+-----------------------------------+ |26 | | | | | | | | | | | +---+-----------------------------------+ |27 | | | | | | | | | | | | | | +---+-----------------------------------+ |28 | | | | | | | | | | | +---+-----------------------------------+ |29 | | | | | | | | | | | +---+-----------------------------------+ |30 | | | | | | | | | | | | | | +---+-----------------------------------+ |31 | | | | | | | | +---+-----------------------------------+ |32 | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |33 | AC | | | | | | | | | | | | | +---+-----------------------------------+ |34 | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |35 | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |36 | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |37 | | | | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |38 | | | | | | | | +---+-----------------------------------+ |39 | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |40 | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |41 | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |42 | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |43 | | | | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |44 | | | | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |45 | | | | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |46 | | | | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |47 | | | | | | | AC | | | | | | | | | | | | | +---+-----------------------------------+ |48 | | | | | | | AC | | | | | | | | | | | | | +---+-----------------------------------+ |49 | | | | | | | AC | | | | | | | | | | | | | +---+-----------------------------------+ |50 | | | | | | | AC | | | | | | | | | | | | | +---+-----------------------------------+ |51 | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |52 | | | | | | | | | | AC | +---+-----------------------------------+ |53 | | | | | | | | | | | | | | | | | | | | +---+-----------------------------------+ |54 | | | | | | | | | | | +---+-----------------------------------+ |55 | | | | | | | | +---+-----------------------------------+ |56 | | | | | +---+-----------------------------------+ |57 | | | | | | | | | | | +---+-----------------------------------+ |58 | !! | | | | | | | | | | +---+-----------------------------------+ |62 | | | | EEPROM | +---+-----------------------------------+ (AUTHORS) o Daniele Pezzini o Arnaud Quette o John Stamp o Peter Selinger o Arjen de Korte o Alexander Gordeev o Edgar Fuss (SEE ALSO) blazer_ser(8), blazer_usb(8), nutupsdrv(8), ups.conf(5), upsc(8), upscmd(8), upsdrvctl(8), upsmon(8), upsrw(8) : o NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5 o (HCL) NUT: https://www.networkupstools.org/stable-hcl.html Network UPS Tools 2.8.5 06/21/2026 NUTDRV_QX(8)