Skip to content

Commit f7a2a81

Browse files
authored
NEWS.adoc: move ragtech entry to post-2.8.5 release
Signed-off-by: Jim Klimov <jimklimov+nut@gmail.com>
1 parent 17ad28d commit f7a2a81

1 file changed

Lines changed: 29 additions & 31 deletions

File tree

NEWS.adoc

Lines changed: 29 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,35 @@ https://github.com/networkupstools/nut/milestone/13
7575
VP-1250-LCD) that return a 7-byte report instead of the standard 6 bytes,
7676
allowing the Megatec payload to be successfully reconstructed. [PR #3485]
7777

78+
- Introduced a new NUT driver named `ragtech` which provides support for the
79+
Ragtech "Easy Pro" family of line-interactive UPS units (also sold under
80+
the NEP, TORO, INNERGIE and OneUP brands in Brazil). Devices present a USB
81+
CDC-ACM serial interface (VID `0x04D8`, PID `0x000A`) and speak a proprietary
82+
6-byte register-access protocol with read/write/AND/OR opcodes; the driver
83+
covers the 20 models in the family-10 device table and was validated
84+
end-to-end against an Easy 2000 TI. Shutdown-related instant commands are
85+
opt-in via the `allow_shutdown` flag because the firmware does not
86+
auto-restart on mains return. [Initial PR #3447]
87+
* Put the CDC-ACM port into raw mode at startup. A freshly enumerated
88+
port defaults to canonical mode, where the kernel buffers the firmware's
89+
binary replies waiting for a newline that never arrives, so the first
90+
poll timed out as "no reply to initial status poll" unless the port had
91+
been set raw externally. [issue #3500]
92+
* Retry the initial status poll a few times before bailing out, so the
93+
driver starts cleanly under the stock systemd units when the device has
94+
only just enumerated at boot, instead of leaning on a fatal exit and a
95+
`Restart=on-failure` cycle. [issue #3500]
96+
* Drain the firmware's handshake reply before the first status poll.
97+
Some models (e.g. the Easy Pro 3200 VA GT) are half-duplex and dropped
98+
the read command that was sent while the handshake reply was still in
99+
flight. [issue #3500]
100+
* Compute `battery.charge` as `raw / 2.55` so a fully charged battery
101+
reports exactly 100 % instead of 100.2 %.
102+
* Added a `va` option to override the apparent-power rating when the
103+
firmware model id is shared between product lines, correcting
104+
`ups.power.nominal`, `ups.realpower.nominal` and the computed
105+
`ups.load`. [issue #3500]
106+
78107
- `richcomm_usb` driver updates:
79108
* Completed support for NUT standard USB configuration options, and fixed
80109
some problems possible when iterating devices. [issue #1768, PR #3477]
@@ -386,37 +415,6 @@ but the `nutshutdown` script would bail out quickly and quietly. [PR #3008]
386415
subdriver definition then). For consistency, these pointers are now
387416
assigned. [#1962]
388417
389-
- Introduced a new NUT driver named `ragtech` which provides support for the
390-
Ragtech "Easy Pro" family of line-interactive UPS units (also sold under
391-
the NEP, TORO, INNERGIE and OneUP brands in Brazil). Devices present a USB
392-
CDC-ACM serial interface (VID `0x04D8`, PID `0x000A`) and speak a proprietary
393-
6-byte register-access protocol with read/write/AND/OR opcodes; the driver
394-
covers the 20 models in the family-10 device table and was validated
395-
end-to-end against an Easy 2000 TI. Shutdown-related instant commands are
396-
opt-in via the `allow_shutdown` flag because the firmware does not
397-
auto-restart on mains return. [PR #3447]
398-
399-
- `ragtech` driver updates:
400-
* Put the CDC-ACM port into raw mode at startup. A freshly enumerated
401-
port defaults to canonical mode, where the kernel buffers the firmware's
402-
binary replies waiting for a newline that never arrives, so the first
403-
poll timed out as "no reply to initial status poll" unless the port had
404-
been set raw externally. [issue #3500]
405-
* Retry the initial status poll a few times before bailing out, so the
406-
driver starts cleanly under the stock systemd units when the device has
407-
only just enumerated at boot, instead of leaning on a fatal exit and a
408-
`Restart=on-failure` cycle. [issue #3500]
409-
* Drain the firmware's handshake reply before the first status poll.
410-
Some models (e.g. the Easy Pro 3200 VA GT) are half-duplex and dropped
411-
the read command that was sent while the handshake reply was still in
412-
flight. [issue #3500]
413-
* Compute `battery.charge` as `raw / 2.55` so a fully charged battery
414-
reports exactly 100 % instead of 100.2 %.
415-
* Added a `va` option to override the apparent-power rating when the
416-
firmware model id is shared between product lines, correcting
417-
`ups.power.nominal`, `ups.realpower.nominal` and the computed
418-
`ups.load`. [issue #3500]
419-
420418
- `riello_ser` and `riello_usb` driver updates:
421419
* Since the beginning, these drivers fenced availability of *either*
422420
`load.*` *or* `shutdown.return` instant commands based on current

0 commit comments

Comments
 (0)