FreeBSD Manual Pages
RAGTECH(8) NUT Manual RAGTECH(8) NAME ragtech - Driver for Ragtech UPS units (USB CDC-ACM) SYNOPSIS ragtech -h ragtech -a UPS_NAME [OPTIONS] Note This man page only documents the hardware-specific features of the ragtech driver. For information about the core driver, see nutups- drv(8). SUPPORTED HARDWARE Targets Ragtech UPSes that expose a USB CDC-ACM serial interface (USB VID 0x04D8, PID 0x000A -- Microchip PIC with CDC firmware). The device shows up under Linux as /dev/ttyACM*. Validated end-to-end against the Ragtech Easy 2000 TI (model id 16 in the family-10 device table). The other 19 models in the same table -- Easy 600/700/900/1200/1300/1400/1600/1800/2000/2200 in both TI (115 V) and M2 (220 V) variants, also sold under the NEP, TORO, INNERGIE and OneUP brands in Brazil -- share the same wire protocol and register layout and are ex- pected to work; please report results. This driver is experimental. Polling, status decoding and the shut- down.stayoff / shutdown.stop instant commands have been verified on hard- ware; shutdown.return and test.battery.start.deep are implemented but not yet verified end-to-end (see the allow_shutdown note below). The beeper-control wire encoding has not been reverse-engineered yet. EXTRA ARGUMENTS This driver supports the following options in the ups.conf: iout_calib=number Per-unit output current calibration constant. If omitted (default), the driver reads the value from register 0xF3 at startup. Set this only to override a wrong factory-stored calibration. allow_shutdown Enable the shutdown.return, shutdown.stayoff, shutdown.stop and test.battery.start.deep instant commands. Disabled by default for safety: the Easy 2000 TI firmware does not auto-restart after a coordi- nated shutdown, so an upsmon-driven shutdown on low battery will leave the UPS (and everything plugged into it) powered off until someone presses the physical power button. Only set this flag if you have an out-of-band way to power the UPS back up, or if you are deliberately running a UPS that should stay off after a critical- battery event. With this flag unset, upsdrv_shutdown logs the refusal and exits with failure instead of cutting the output. CAVEATS The serial control lines DTR and RTS are forced low by the driver immedi- ately after opening the port. Non-zero levels on either line are inter- preted by the UPS as a remote shutdown signal -- never run this driver alongside other software that toggles those lines on the same device node. Replies are framed by a 0xAA start byte and have no checksum; the driver re-synchronizes by scanning for the start byte after any short read. AUTHOR juslex SEE ALSO nutupsdrv(8), ups.conf(5) Internet resources: * The NUT (Network UPS Tools) home page: https://www.networkupstools.org/ * Reverse-engineering reference: https://github.com/an- tunesls/UPS_ESP32_tinySrv Network UPS Tools 2.8.5. 08/04/2026 RAGTECH(8)
NAME | SYNOPSIS | SUPPORTED HARDWARE | EXTRA ARGUMENTS | CAVEATS | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ragtech&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>