Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

29 Commits

Repository files navigation

Mini-Box.com UPS Status and Configuration Tool

Mini-Box.com produces several high quality intelligent Uninterruptible Power Supplies. This is a tool to report status information and configure these UPS models.

Supported models

  • OpenUPS: 6-30V Intelligent Uninterruptible Power Supply
  • OpenUPS2: 11-24V Intelligent DC-DC Uninterruptible Power Supply using LiFePO4 or 13-24V using Li-Ion (see manual)
  • NUC-UPS: 6-38V Intelligent Automotive grade Uninterruptible Power Supply
  • DCDC-USB: Intelligent buck-boost DC-DC converter with USB interface
  • DCDC-USB-200: Intelligent buck-boost DC-DC converter with USB interface

Warning

The flash storage on these devices have limited write cycles (should be considered < 100.000) so it's not advisable to keep writing the configuration periodically on a timer.

Comparison table

FeatureOpenUPSOpenUPS2NUC-UPS
Picture
Input Voltage6-30V11-24V6-38
Output Voltage5-24V (programable)12V*12V
ArchitectureBuck/BoostBoostBuck/Boost
Max Power6A5A5A
Battery ChemistryLi-Ion, Li-Po, LIFEPO4, Lead AcidLiFePO4, Li-Ion**Li-Ion
Battery ChargerMultiple chemistry charger3 state charger3 state charger
Battery balancingYesYesYes
USB InterfaceYesYesYes
SMBUSSlaveSlave-
Coulomb counting (fuel gauge)YesYesYes
Temperature monitoringOn boardFor each cellFor each cell
Battery designExternal removableOnboard removableOnboard removable
FootprintCustom2.5" drive footprint2.5" drive footprint
Windows compatibleYesYesYes
Linux compatibleYesYesYes
Motherboard ON/OFF pulse controlYesYesYes
Deep Sleep power consumption<50uA1uA5uA
AvailabilityLong lifeLong lifeNew product

Notes:

* If V(in) > V(out) then V(out) is unregulated (Vin=vout)
* If V(in) < V(out) then V(out) is 12V regulated
** Li-Ion chemistry supported with hardware modification, consult manual.

Documentation

These devices allow advanced configuration which can be quite complex. It's recommended to read the documentation using the links below before attempting to configure these UPSes.

Install from prebuilt binary

$ sudo snap install openups --edge

Get it from the Snap Store

(Don't have snapd installed?)

Install from source

$ git clone https://github.com/mini-box/ups.git
$ cd ups
$ cmake .
$ sudo make install

Using

For all commands below replace device name with the name of the device you want to control eg: openups, openups2, nucups

  • Show help, supported devices and supported commands per device:

     $ openups -h
    
  • Show status and configuration:

     $ sudo openups -t <device name>
    
  • Show only status

     $ sudo openups -t <device name> -s
    
  • Export current configuration variables from device to file

     $ sudo openups -t <device name> -o <file name>
    
  • Import configuration from file to device. Warning: it will restart your UPS and in certain cases the device connected to it !

     $ sudo openups -t <device name> -i <file name>
    
  • For configuration variables you can add -c switch on command line to output a detailed description for each variable. Example: 6. UPS_INIT_DELAY_TOUT: 1 # [s] Initial delay before starting the UPS. Default is 1 sec.

  • Some devices accept commands to set for example the output voltage:

     $ sudo openups -t dcdcusb -e set_vout:11.5 -s
    

Troubleshooting

There might be issues with apparmor/SELinux that won't allow access to raw usb devices. For the snap binary this can be solved by:

 $ sudo snap connect openups:raw-usb

Network UPS Tools

For remote management or shutdown configuration it's also possible to use Network UPS Tools. Open UPS and Open UPS 2 are already integrated in latest version so installation should be straight forward on different Linux flavors. For more details on custom installations and configuration for our UPS products on Network UPS Tools see these links:

About

Linux Status and Configuration application for Mini-Box.com Open UPS, Open UPS 2 and NUC UPS

Topics

Resources

Stars

64 stars

Watchers

6 watching

Forks

Contributors

Languages