Metadata-Version: 2.1
Name: DFRobotUPS
Version: 0.4.7
Summary: DFRobotUPS module
Home-page: https://github.com/mincebert/DFRobotUPS
Author: Robert Franklin
License: UNKNOWN
Project-URL: Bug Reports, https://github.com/mincebert/DFRobotUPS/issues
Project-URL: Source, https://github.com/mincebert/DFRobotUPS
Description: DFROBOTUPS MODULE
        =================
        
        It supports the DFRobotUPS HAT for the Raspberry Pi Zero (the more
        sophisticated version for other Pis has not be checked nor tested) and
        can retrieve information about the HAT itself, as well as dynamic data
        for the current SoC (State of Charge) and cell voltage.
        
        In addition, it can be run in a mode to poll the SoC and trigger a
        shutdown command when it falls below a specified level.
        
        This module contains can be used as a standalone utility or imported for
        use in other scripts.
        
        The module was developed and used under Python 3.9 on Raspberry PiOS
        11.9.
        
        The information to write the module was taken from the DFRobotUPS wiki
        at: https://wiki.dfrobot.com/UPS%20HAT%20for%20Raspberry%20Pi%20%20Zero%20%20SKU%3A%20DFR0528
        
        Command line options
        --------------------
        
        The command line options listed with `--help` are shown below:
        
        ```
        usage: DFRobotUPS [-h] [-s] [-p PERCENT] [-i INTERVAL] [-c CMD [ARG ...]]
                          [-a ADDR] [-b BUS] [-r RETRY] [-d] [-v]
        
        optional arguments:
          -h, --help            show this help message and exit
          -s, --shutdown        poll the battery SoC and initiate system shutdown when
                                level drops below the defined level; the default is
                                not to do this but display information about the UPS
                                HAT instead
          -p PERCENT, --percent PERCENT
                                State of Charge (SoC) percentage at which to trigger
                                shutdown shutdown (min: 5, max: 95, default: 7)
          -i INTERVAL, --interval INTERVAL
                                number of seconds between polls of the battery SoC
                                (min: 1, max: 600, default: 60)
          -c CMD [ARG ...], --cmd CMD [ARG ...]
                                command to run to trigger shutdown
          -a ADDR, --addr ADDR  I2C address for UPS HAT; can be specified in hex as
                                0xNN (default: 0x10)
          -b BUS, --bus BUS     I2C SMBus number for UPS HAT (default: 1)
          -r RETRY, --retry RETRY
                                number of times to try connecting to the UPS HAT
                                (default: 10)
          -d, --debug           increase debugging level (max: 2, default: 0)
          -v, --version         show program's version number and exit
        ```
        
        Author
        ------
        
        Robert Franklin <rcf@mince.net>, UK
        
Keywords: dfrobot ups shutdown power raspberrypi pios
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
