From ce4b431de8be8385861bf159fe1a7fd980eb7001 Mon Sep 17 00:00:00 2001 From: DaRK AnGeL Date: Mon, 9 Sep 2024 10:55:14 +0300 Subject: [PATCH 01/12] Add Bypass and ECO Transfer values for future work on enable Eco mode for Eaton Signed-off-by: DaRK AnGeL --- drivers/mge-hid.c | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/drivers/mge-hid.c b/drivers/mge-hid.c index b174ac4d6b..3a940583ea 100644 --- a/drivers/mge-hid.c +++ b/drivers/mge-hid.c @@ -1404,11 +1404,17 @@ static hid_info_t mge_hid2nut[] = { "input.frequency.nominal", 0, 0, "UPS.Flow.[1].ConfigFrequency", NULL, "%.0f", HU_FLAG_STATIC, NULL }, /* same as "input.transfer.boost.low" */ { "input.transfer.low", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.LowVoltageTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.eco.low", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.LowVoltageEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.bypass.low", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.LowVoltageBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.boost.low", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.LowVoltageBoostTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.boost.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBoostTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.trim.low", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.LowVoltageBuckTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, /* same as "input.transfer.trim.high" */ { "input.transfer.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.eco.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.bypass.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.frequency.bypass.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.frequency.eco.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.trim.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBuckTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.sensitivity", ST_FLAG_RW | ST_FLAG_STRING, 10, "UPS.PowerConverter.Output.SensitivityMode", NULL, "%s", HU_FLAG_SEMI_STATIC, mge_sensitivity_info }, { "input.voltage.extended", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.ExtendedVoltageMode", NULL, "%s", HU_FLAG_SEMI_STATIC, yes_no_info }, From 744561245c6049e65fe29bb6d4c7c48a0952c34d Mon Sep 17 00:00:00 2001 From: DaRK AnGeL Date: Mon, 9 Sep 2024 11:44:48 +0300 Subject: [PATCH 02/12] change high to range in (input.transfer.frequency.bypass and input.transfer.frequency.eco) Signed-off-by: DaRK AnGeL --- drivers/mge-hid.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/drivers/mge-hid.c b/drivers/mge-hid.c index 3a940583ea..03323b7a99 100644 --- a/drivers/mge-hid.c +++ b/drivers/mge-hid.c @@ -1413,8 +1413,8 @@ static hid_info_t mge_hid2nut[] = { "input.transfer.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.eco.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.bypass.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, - { "input.transfer.frequency.bypass.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, - { "input.transfer.frequency.eco.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.frequency.bypass.range", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.frequency.eco.range", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.trim.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBuckTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.sensitivity", ST_FLAG_RW | ST_FLAG_STRING, 10, "UPS.PowerConverter.Output.SensitivityMode", NULL, "%s", HU_FLAG_SEMI_STATIC, mge_sensitivity_info }, { "input.voltage.extended", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.ExtendedVoltageMode", NULL, "%s", HU_FLAG_SEMI_STATIC, yes_no_info }, From bdf04068070822607bdbf5785205abd20a10f5bb Mon Sep 17 00:00:00 2001 From: DaRK AnGeL Date: Mon, 9 Sep 2024 16:06:13 +0300 Subject: [PATCH 03/12] add values description Signed-off-by: DaRK AnGeL --- data/cmdvartab | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/data/cmdvartab b/data/cmdvartab index 38d2b356dd..1ce427aec1 100644 --- a/data/cmdvartab +++ b/data/cmdvartab @@ -56,6 +56,12 @@ VARDESC input.voltage.nominal "Nominal input voltage (V)" VARDESC input.transfer.reason "Reason for last transfer to battery" VARDESC input.transfer.low "Low voltage transfer point (V)" VARDESC input.transfer.high "High voltage transfer point (V)" +VARDESC input.transfer.eco.low "Low voltage ECO transfer point (V)" +VARDESC input.transfer.bypass.low "Low voltage Bypass transfer point (V)" +VARDESC input.transfer.eco.high "High voltage ECO transfer point (V)" +VARDESC input.transfer.bypass.high "High voltage Bypass transfer point (V)" +VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (Hz)" +VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (Hz)" VARDESC input.transfer.low.min "smallest settable low voltage transfer point (V)" VARDESC input.transfer.low.max "greatest settable low voltage transfer point (V)" VARDESC input.transfer.high.min "smallest settable high voltage transfer point (V)" From 8a96f5264a6f8983bb207e4f4ffe99ab332cefa0 Mon Sep 17 00:00:00 2001 From: DaRK AnGeL Date: Wed, 11 Sep 2024 10:50:34 +0300 Subject: [PATCH 04/12] add missing values to nut vars + 'percent Hz' in cmdvartab Signed-off-by: DaRK AnGeL --- data/cmdvartab | 4 ++-- docs/nut-names.txt | 12 ++++++++++++ 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/data/cmdvartab b/data/cmdvartab index 1ce427aec1..534bb06b35 100644 --- a/data/cmdvartab +++ b/data/cmdvartab @@ -60,8 +60,8 @@ VARDESC input.transfer.eco.low "Low voltage ECO transfer point (V)" VARDESC input.transfer.bypass.low "Low voltage Bypass transfer point (V)" VARDESC input.transfer.eco.high "High voltage ECO transfer point (V)" VARDESC input.transfer.bypass.high "High voltage Bypass transfer point (V)" -VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (Hz)" -VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (Hz)" +VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (percent Hz)" +VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (percent Hz)" VARDESC input.transfer.low.min "smallest settable low voltage transfer point (V)" VARDESC input.transfer.low.max "greatest settable low voltage transfer point (V)" VARDESC input.transfer.high.min "smallest settable high voltage transfer point (V)" diff --git a/docs/nut-names.txt b/docs/nut-names.txt index 2149fccdbc..a8cf2f1db9 100644 --- a/docs/nut-names.txt +++ b/docs/nut-names.txt @@ -291,6 +291,18 @@ input: Incoming line/power information transfer point (V) | 230 | input.transfer.trim.high | High voltage trimming transfer point (V) | 240 +| input.transfer.eco.low | Low voltage ECO + transfer point (V) | 218 +| input.transfer.bypass.low | Low voltage Bypass + transfer point (V) | 184 +| input.transfer.eco.high | High voltage ECO + transfer point (V) | 241 +| input.transfer.bypass.high | High voltage Bypass + transfer point (V) | 264 +| input.transfer.frequency. | Frequency range Bypass + bypass.range transfer point (percent Hz) | 10 +| input.transfer.frequency. | Frequency range ECO transfer + eco.range point (percent Hz) | 5 | input.load | Load on (ePDU) input (percent of full) | 25 | input.realpower | Current sum value of all (ePDU) From b10801b46579d462c210b8757f6d5a810ea41b6a Mon Sep 17 00:00:00 2001 From: DaRK AnGeL Date: Thu, 12 Sep 2024 11:16:25 +0300 Subject: [PATCH 05/12] add hysteresys value + add nominal to freq range Signed-off-by: DaRK AnGeL --- data/cmdvartab | 5 +++-- docs/nut-names.txt | 9 ++++++--- drivers/mge-hid.c | 1 + 3 files changed, 10 insertions(+), 5 deletions(-) diff --git a/data/cmdvartab b/data/cmdvartab index 534bb06b35..1852ed283c 100644 --- a/data/cmdvartab +++ b/data/cmdvartab @@ -60,8 +60,9 @@ VARDESC input.transfer.eco.low "Low voltage ECO transfer point (V)" VARDESC input.transfer.bypass.low "Low voltage Bypass transfer point (V)" VARDESC input.transfer.eco.high "High voltage ECO transfer point (V)" VARDESC input.transfer.bypass.high "High voltage Bypass transfer point (V)" -VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (percent Hz)" -VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (percent Hz)" +VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (percent Hz) of nominal" +VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (percent Hz) of nominal" +VARDESC input.transfer.hysteresys "Hysteresys (threshold of switching to modes) Voltage Transfer point (V)" VARDESC input.transfer.low.min "smallest settable low voltage transfer point (V)" VARDESC input.transfer.low.max "greatest settable low voltage transfer point (V)" VARDESC input.transfer.high.min "smallest settable high voltage transfer point (V)" diff --git a/docs/nut-names.txt b/docs/nut-names.txt index a8cf2f1db9..90f0b77ebd 100644 --- a/docs/nut-names.txt +++ b/docs/nut-names.txt @@ -299,10 +299,13 @@ input: Incoming line/power information transfer point (V) | 241 | input.transfer.bypass.high | High voltage Bypass transfer point (V) | 264 -| input.transfer.frequency. | Frequency range Bypass - bypass.range transfer point (percent Hz) | 10 +| input.transfer.frequency. | Frequency range Bypass transfer + bypass.range point (percent Hz) of nominal | 10 | input.transfer.frequency. | Frequency range ECO transfer - eco.range point (percent Hz) | 5 + eco.range point (percent Hz) of nominal | 5 +| input.transfer.hysteresys | Hysteresys (threshold of + | switching to modes) voltage + | transfer point (V) | 10 | input.load | Load on (ePDU) input (percent of full) | 25 | input.realpower | Current sum value of all (ePDU) diff --git a/drivers/mge-hid.c b/drivers/mge-hid.c index 03323b7a99..edcdfeb2b4 100644 --- a/drivers/mge-hid.c +++ b/drivers/mge-hid.c @@ -1415,6 +1415,7 @@ static hid_info_t mge_hid2nut[] = { "input.transfer.bypass.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.frequency.bypass.range", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.frequency.eco.range", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.hysteresys", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HysteresysVoltageTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.trim.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBuckTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.sensitivity", ST_FLAG_RW | ST_FLAG_STRING, 10, "UPS.PowerConverter.Output.SensitivityMode", NULL, "%s", HU_FLAG_SEMI_STATIC, mge_sensitivity_info }, { "input.voltage.extended", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.ExtendedVoltageMode", NULL, "%s", HU_FLAG_SEMI_STATIC, yes_no_info }, From 92635de843c7ea99d16bc52914aa081d73d9f4e0 Mon Sep 17 00:00:00 2001 From: Jim Klimov Date: Thu, 12 Sep 2024 10:23:13 +0200 Subject: [PATCH 06/12] docs/nut-names.txt: fix asciidoc table markup and a bit of wording Signed-off-by: Jim Klimov --- docs/nut-names.txt | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/nut-names.txt b/docs/nut-names.txt index 90f0b77ebd..181bfec602 100644 --- a/docs/nut-names.txt +++ b/docs/nut-names.txt @@ -299,13 +299,13 @@ input: Incoming line/power information transfer point (V) | 241 | input.transfer.bypass.high | High voltage Bypass transfer point (V) | 264 -| input.transfer.frequency. | Frequency range Bypass transfer - bypass.range point (percent Hz) of nominal | 10 -| input.transfer.frequency. | Frequency range ECO transfer - eco.range point (percent Hz) of nominal | 5 +| input.transfer.frequency.bypass.range | Frequency range Bypass transfer + point (percent of nominal Hz) | 10 +| input.transfer.frequency.eco.range | Frequency range ECO transfer + point (percent of nominal Hz) | 5 | input.transfer.hysteresys | Hysteresys (threshold of - | switching to modes) voltage - | transfer point (V) | 10 + switching to modes) voltage + transfer point (V) | 10 | input.load | Load on (ePDU) input (percent of full) | 25 | input.realpower | Current sum value of all (ePDU) From 873963b1152d496077a8bbb81a30ffffbc281f07 Mon Sep 17 00:00:00 2001 From: Jim Klimov Date: Thu, 12 Sep 2024 10:24:07 +0200 Subject: [PATCH 07/12] data/cmdvartab: fix a bit of wording for "percent of nominal" Signed-off-by: Jim Klimov --- data/cmdvartab | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data/cmdvartab b/data/cmdvartab index 1852ed283c..5c6a72f39c 100644 --- a/data/cmdvartab +++ b/data/cmdvartab @@ -60,8 +60,8 @@ VARDESC input.transfer.eco.low "Low voltage ECO transfer point (V)" VARDESC input.transfer.bypass.low "Low voltage Bypass transfer point (V)" VARDESC input.transfer.eco.high "High voltage ECO transfer point (V)" VARDESC input.transfer.bypass.high "High voltage Bypass transfer point (V)" -VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (percent Hz) of nominal" -VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (percent Hz) of nominal" +VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (percent of nominal Hz)" +VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (percent of nominal Hz)" VARDESC input.transfer.hysteresys "Hysteresys (threshold of switching to modes) Voltage Transfer point (V)" VARDESC input.transfer.low.min "smallest settable low voltage transfer point (V)" VARDESC input.transfer.low.max "greatest settable low voltage transfer point (V)" From 4961a943ea0219c633ef2079f0ad0cb13668347b Mon Sep 17 00:00:00 2001 From: Jim Klimov Date: Thu, 12 Sep 2024 13:42:51 +0200 Subject: [PATCH 08/12] Typo fix (hysteresYs => hysteresIs) [#2620] Signed-off-by: Jim Klimov --- data/cmdvartab | 2 +- docs/nut-names.txt | 2 +- drivers/mge-hid.c | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/data/cmdvartab b/data/cmdvartab index 5c6a72f39c..8712bc4288 100644 --- a/data/cmdvartab +++ b/data/cmdvartab @@ -62,7 +62,7 @@ VARDESC input.transfer.eco.high "High voltage ECO transfer point (V)" VARDESC input.transfer.bypass.high "High voltage Bypass transfer point (V)" VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (percent of nominal Hz)" VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (percent of nominal Hz)" -VARDESC input.transfer.hysteresys "Hysteresys (threshold of switching to modes) Voltage Transfer point (V)" +VARDESC input.transfer.hysteresis "Hysteresis (threshold of switching to modes) Voltage Transfer point (V)" VARDESC input.transfer.low.min "smallest settable low voltage transfer point (V)" VARDESC input.transfer.low.max "greatest settable low voltage transfer point (V)" VARDESC input.transfer.high.min "smallest settable high voltage transfer point (V)" diff --git a/docs/nut-names.txt b/docs/nut-names.txt index 181bfec602..1e27edf75a 100644 --- a/docs/nut-names.txt +++ b/docs/nut-names.txt @@ -303,7 +303,7 @@ input: Incoming line/power information point (percent of nominal Hz) | 10 | input.transfer.frequency.eco.range | Frequency range ECO transfer point (percent of nominal Hz) | 5 -| input.transfer.hysteresys | Hysteresys (threshold of +| input.transfer.hysteresis | Hysteresis (threshold of switching to modes) voltage transfer point (V) | 10 | input.load | Load on (ePDU) input (percent diff --git a/drivers/mge-hid.c b/drivers/mge-hid.c index edcdfeb2b4..7357a1935e 100644 --- a/drivers/mge-hid.c +++ b/drivers/mge-hid.c @@ -995,7 +995,7 @@ static usage_lkp_t mge_usage_lkp[] = { { "DataValid", 0xffff0099 }, { "ToggleTimer", 0xffff009a }, { "BypassTransferDelay", 0xffff009b }, - { "HysteresysVoltageTransfer", 0xffff009c }, + { "HysteresisVoltageTransfer", 0xffff009c }, { "SlewRate", 0xffff009d }, /* 0xffff009e-0xffff009f => Reserved */ { "PDU", 0xffff00a0 }, @@ -1415,7 +1415,7 @@ static hid_info_t mge_hid2nut[] = { "input.transfer.bypass.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.frequency.bypass.range", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeBypassTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.frequency.eco.range", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.FrequencyRangeEcoTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, - { "input.transfer.hysteresys", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HysteresysVoltageTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, + { "input.transfer.hysteresis", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HysteresisVoltageTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.transfer.trim.high", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.HighVoltageBuckTransfer", NULL, "%.0f", HU_FLAG_SEMI_STATIC, NULL }, { "input.sensitivity", ST_FLAG_RW | ST_FLAG_STRING, 10, "UPS.PowerConverter.Output.SensitivityMode", NULL, "%s", HU_FLAG_SEMI_STATIC, mge_sensitivity_info }, { "input.voltage.extended", ST_FLAG_RW | ST_FLAG_STRING, 5, "UPS.PowerConverter.Output.ExtendedVoltageMode", NULL, "%s", HU_FLAG_SEMI_STATIC, yes_no_info }, From 734289779cede8f4d80b403742bf257f34d98305 Mon Sep 17 00:00:00 2001 From: Jim Klimov Date: Thu, 12 Sep 2024 13:43:24 +0200 Subject: [PATCH 09/12] drivers/mge-hid.c: bump sub-driver version due to added data points [#2620] Signed-off-by: Jim Klimov --- drivers/mge-hid.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/mge-hid.c b/drivers/mge-hid.c index 7357a1935e..5c9e6b33e4 100644 --- a/drivers/mge-hid.c +++ b/drivers/mge-hid.c @@ -50,7 +50,7 @@ # endif #endif -#define MGE_HID_VERSION "MGE HID 1.48" +#define MGE_HID_VERSION "MGE HID 1.49" /* (prev. MGE Office Protection Systems, prev. MGE UPS SYSTEMS) */ /* Eaton */ From e1080d609ca1e9ad7e9c647c281512fc7147fc11 Mon Sep 17 00:00:00 2001 From: Jim Klimov Date: Thu, 12 Sep 2024 13:45:37 +0200 Subject: [PATCH 10/12] docs/nut-names.txt: re-phrase input.transfer.hysteresis table description [#2620] Signed-off-by: Jim Klimov --- docs/nut-names.txt | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/nut-names.txt b/docs/nut-names.txt index 1e27edf75a..339706da78 100644 --- a/docs/nut-names.txt +++ b/docs/nut-names.txt @@ -303,9 +303,8 @@ input: Incoming line/power information point (percent of nominal Hz) | 10 | input.transfer.frequency.eco.range | Frequency range ECO transfer point (percent of nominal Hz) | 5 -| input.transfer.hysteresis | Hysteresis (threshold of - switching to modes) voltage - transfer point (V) | 10 +| input.transfer.hysteresis | Threshold of switching protection modes, + voltage transfer point (V) | 10 | input.load | Load on (ePDU) input (percent of full) | 25 | input.realpower | Current sum value of all (ePDU) From c9884ca102a7e34c1b34a73bdfb3456da89f4ef8 Mon Sep 17 00:00:00 2001 From: Jim Klimov Date: Thu, 12 Sep 2024 13:52:20 +0200 Subject: [PATCH 11/12] docs/nut-names.txt: document the Input Voltage Hysteresis concept [#2620] Signed-off-by: Jim Klimov --- docs/nut-names.txt | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/nut-names.txt b/docs/nut-names.txt index 339706da78..6c7dbd5b2c 100644 --- a/docs/nut-names.txt +++ b/docs/nut-names.txt @@ -319,6 +319,32 @@ input: Incoming line/power information sources (degrees) | 181 |================================================================================= +[NOTE] +.Input Voltage Hysteresis +====== +The input voltage hysteresis concept refers to a specific behavior related +to how some UPS models can handle changes in input voltage. + +When the UPS is running normally (powered by utility or generator), it +maintains a steady output voltage for your critical equipment. But what +if the input voltage "wiggles" a bit due to fluctuations or other minor +disturbances? + +Rapid switching between UPS protection modes (utility power to battery +and vice versa) can stress both the UPS and its connected devices. + +So, some UPS models set up thresholds: If the input voltage drops below +a certain "Low" level, the UPS won't immediately switch to battery mode. +Instead, it waits until it is sure the voltage stays consistently low +for a bit. Similarly, if the input voltage rises above another threshold +(the "High" level), the UPS won't rush back to normal mode. It waits for +stability. + +By introducing hysteresis, such an UPS avoids unnecessary toggling, ensuring +smoother transitions and better protection for your sensitive and expensive +gear. +====== + output: Outgoing power/inverter information ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From b8abfc1ab3298291de600400519609aa879c105d Mon Sep 17 00:00:00 2001 From: DaRK AnGeL <28630321+masterwishx@users.noreply.github.com> Date: Thu, 12 Sep 2024 20:16:56 +0300 Subject: [PATCH 12/12] Update cmdvartab --- data/cmdvartab | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/cmdvartab b/data/cmdvartab index 8712bc4288..78fdef4712 100644 --- a/data/cmdvartab +++ b/data/cmdvartab @@ -62,7 +62,7 @@ VARDESC input.transfer.eco.high "High voltage ECO transfer point (V)" VARDESC input.transfer.bypass.high "High voltage Bypass transfer point (V)" VARDESC input.transfer.frequency.bypass.range "Frequency range Bypass transfer point (percent of nominal Hz)" VARDESC input.transfer.frequency.eco.range "Frequency range ECO transfer point (percent of nominal Hz)" -VARDESC input.transfer.hysteresis "Hysteresis (threshold of switching to modes) Voltage Transfer point (V)" +VARDESC input.transfer.hysteresis "Threshold of switching protection modes, voltage transfer point (V)" VARDESC input.transfer.low.min "smallest settable low voltage transfer point (V)" VARDESC input.transfer.low.max "greatest settable low voltage transfer point (V)" VARDESC input.transfer.high.min "smallest settable high voltage transfer point (V)"