Skip to content

Commit

Permalink
Merge pull request #638 from marianojan/hunnox-hnx850
Browse files Browse the repository at this point in the history
  • Loading branch information
jimklimov committed Apr 20, 2021
2 parents 8877335 + 9872276 commit 169b637
Show file tree
Hide file tree
Showing 6 changed files with 410 additions and 19 deletions.
12 changes: 9 additions & 3 deletions docs/man/nutdrv_qx.txt
Expand Up @@ -17,7 +17,7 @@ For information about the core driver, see linkman:nutupsdrv[8].
SUPPORTED HARDWARE
------------------

The *nutdrv_qx* driver is known to work with various UPSes from 'Blazer', 'Energy Sistem', 'Fenton Technologies', 'General Electric', 'Mustek', 'Voltronic Power' (rebranded by many, many - have I said many? - others.. Long story short: if your UPS came with a software called 'Viewpower', chances are high that it works with this driver with one of the <<_extra_arguments,'voltronic*' protocols or with the 'mecer' one>>) and many others.
The *nutdrv_qx* driver is known to work with various UPSes from 'Blazer', 'Energy Sistem', 'Fenton Technologies', 'General Electric', 'Hunnox', 'Mustek', 'Powercool', 'Voltronic Power' (rebranded by many, many - have I said many? - others.. Long story short: if your UPS came with a software called 'Viewpower', chances are high that it works with this driver with one of the <<_extra_arguments,'voltronic*' protocols or with the 'mecer' one>>) and many others.

The <<_internet_resources,NUT compatibility table>> lists all the known supported models.
Keep in mind, however, that other models not listed there may also be supported, but haven't been tested.
Expand Down Expand Up @@ -52,7 +52,7 @@ If you set stayoff in linkman:ups.conf[5] when FSD arises the UPS will call a *s

*protocol =* 'string'::
Skip autodetection of the protocol to use and only use the one specified.
Supported values: 'bestups', 'mecer', 'megatec', 'megatec/old', 'mustek', 'q1', 'voltronic', 'voltronic-qs', 'voltronic-qs-hex' and 'zinto'.
Supported values: 'bestups', 'hunnox', 'mecer', 'megatec', 'megatec/old', 'mustek', 'q1', 'voltronic', 'voltronic-qs', 'voltronic-qs-hex' and 'zinto'.
+
Note that if you end up using the 'q1' protocol, you may want to give a try to the 'mecer', 'megatec' and 'zinto' ones setting the <<old-blazer-protocols-options,*novendor*/*norating* flags>> (only one, or both).

Expand Down Expand Up @@ -324,14 +324,17 @@ The argument is a regular expression that must match the bus name where the UPS

*subdriver =* 'string'::
Select a serial-over-USB subdriver to use.
You have a choice between *cypress*, *fabula*, *fuji*, *ippon*, *krauler*, *phoenix* and *sgs*.
You have a choice between *cypress*, *fabula*, *fuji*, *hunnox*, *ippon*, *krauler*, *phoenix* and *sgs*.
When using this option, it is mandatory to also specify the *vendorid* and *productid*.

*langid_fix =* 'value'::
Apply the language ID workaround to the *krauler* subdriver.
This is mandatory for some devices to work (LDLC, Dynamix and others).
You must provide *value* (+0x409+ or +0x4095+), according to your device entry in NUT hardware compatibility list (HCL).

*noscanlangid*::
If this flag is set, don't autoscan valid range for langid.


IMPLEMENTATION NOTES
^^^^^^^^^^^^^^^^^^^^
Expand All @@ -340,6 +343,9 @@ IMPLEMENTATION NOTES
This subdriver, meant to be used with the 'megatec' protocol, does *not* support the various *test.battery* commands.
Plus, the *shutdown.return* command ignores the values set in 'ups.delay.start'/*ondelay* and makes the UPS turn on the load as soon as power is back.

*'hunnox' subdriver*::
This protocol subdriver is closely related to 'fabula' one, with a few tweaks for devices not directly supported by that driver.

*'fuji' subdriver*::
This subdriver, meant to be used with the 'megatec' protocol, does *not* support the *shutdown.stayoff* and *load.off* commands.
Plus, the *shutdown.return* command ignores the values set in 'ups.delay.start'/*ondelay* and makes the UPS turn on the load as soon as power is back.
Expand Down
7 changes: 6 additions & 1 deletion docs/nut.dict
@@ -1,4 +1,4 @@
personal_ws-1.1 en 2537 utf-8
personal_ws-1.1 en 2542 utf-8
AAS
ACFAIL
ACFREQ
Expand Down Expand Up @@ -401,6 +401,7 @@ Hlavinka
Holger
Hoogervorst
Hough
Hunnox
Hurd
Håvard
IANA
Expand Down Expand Up @@ -802,6 +803,7 @@ PowerVault
PowerWalker
PowerWare
Powerchute
Powercool
Powervar
Powerwell
Prachi
Expand Down Expand Up @@ -1269,6 +1271,7 @@ automessage
autoreconf
autorestart
autosaving
autoscan
autostart
autowidth
auxdata
Expand Down Expand Up @@ -1661,6 +1664,7 @@ http
httpd
https
huawei
hunnox
iBox
iDowell
iManufacturer
Expand Down Expand Up @@ -1948,6 +1952,7 @@ nomdcvolts
nomfrequency
noout
norating
noscanlangid
notAfter
notifyme
notifytype
Expand Down
5 changes: 3 additions & 2 deletions drivers/Makefile.am
Expand Up @@ -263,7 +263,8 @@ endif
NUTDRV_QX_SUBDRIVERS = nutdrv_qx_bestups.c nutdrv_qx_blazer-common.c \
nutdrv_qx_mecer.c nutdrv_qx_megatec.c nutdrv_qx_megatec-old.c \
nutdrv_qx_mustek.c nutdrv_qx_q1.c nutdrv_qx_voltronic.c \
nutdrv_qx_voltronic-qs.c nutdrv_qx_voltronic-qs-hex.c nutdrv_qx_zinto.c
nutdrv_qx_voltronic-qs.c nutdrv_qx_voltronic-qs-hex.c nutdrv_qx_zinto.c \
nutdrv_qx_hunnox.c
nutdrv_qx_SOURCES += $(NUTDRV_QX_SUBDRIVERS)

# ----------------------------------------------------------------------
Expand All @@ -282,7 +283,7 @@ dist_noinst_HEADERS = apc-mib.h apc-hid.h baytech-mib.h bcmxcp.h bcmxcp_ser.h \
upshandler.h usb-common.h usbhid-ups.h powercom-hid.h compaq-mib.h idowell-hid.h \
apcsmart.h apcsmart_tabs.h apcsmart-old.h apcupsd-ups.h cyberpower-mib.h riello.h openups-hid.h \
delta_ups-mib.h nutdrv_qx.h nutdrv_qx_bestups.h nutdrv_qx_blazer-common.h nutdrv_qx_mecer.h \
nutdrv_qx_megatec.h nutdrv_qx_megatec-old.h nutdrv_qx_mustek.h nutdrv_qx_q1.h \
nutdrv_qx_megatec.h nutdrv_qx_megatec-old.h nutdrv_qx_mustek.h nutdrv_qx_q1.h nutdrv_qx_hunnox.h \
nutdrv_qx_voltronic.h nutdrv_qx_voltronic-qs.h nutdrv_qx_voltronic-qs-hex.h nutdrv_qx_zinto.h \
xppc-mib.h huawei-mib.h eaton-ats16-nmc-mib.h eaton-ats16-nm2-mib.h apc-ats-mib.h raritan-px2-mib.h eaton-ats30-mib.h \
apc-pdu-mib.h eaton-pdu-genesis2-mib.h eaton-pdu-marlin-mib.h \
Expand Down

0 comments on commit 169b637

Please sign in to comment.