NAME

       pemmican-mon - pemmican-mon - Monitor PMIC notifications at runtime

SYNOPSIS

          usage: pemmican-mon [-h] [--help-all] [--help-gapplication]
                              [--gapplication-service]

OPTIONS

       -h, --help
              show the help message and exit

       --help-all
              show all available help options and exit

       --help-gapplication
              show help options specific to GLib.Application and exit

       --gapplication-service
              run the application in GApplication service mode (for DBus service files)

USAGE

       pemmican-mon  is  intended  to  be  a background service, launched as a user-slice systemd service by the
       "graphical-session" target. It monitors udev for power supply related events, reporting those of interest
       via   the   freedesktop   notification   service    <https://specifications.freedesktop.org/notification-
       spec/latest/>.

       Power  supply  undervolt (typically reported in the event the supply drops below 4.8V) is likely the most
       important event the application warns about. If you wish to suppress this warning for  your  user,  touch
       the  file  ~/.config/pemmican/undervolt.inhibit.  If you wish to suppress this warning system-wide, touch
       the file /etc/xdg/pemmican/undervolt.inhibit.

       WARNING:
          It is strongly recommended that any such notice is heeded, as brownout is very likely to lead  to  any
          manner of other (hard to predict or replicate) issues up to and including data corruption.

          Put simply, suppressing this warning is probably a very bad idea!

       USB  over-current  is  the  other  event  the  application  will warn about. This occurs when peripherals
       attached to the USB ports attempt to draw more current that permitted. If the Pi 5 is being supplied by a
       PSU that did not negotiate a 5A feed at boot time, the USB ports will be limited in their supply and this
       warning is more likely.

       If   you   wish   to   suppress   this   warning   for   your   individual   user,   touch    the    file
       ~/.config/pemmican/overcurrent.inhibit.     To     suppress     this     warning    system-wide,    touch
       /etc/xdg/pemmican/overcurrent.inhibit.

ENVIRONMENT

       Because the notifications generated by this application are capable of launching a web-browser  (via  the
       "More  Information"  action),  the  script  will  also  bail  with  an error in the event that DISPLAY or
       WAYLAND_DISPLAY are not found in the environment at startup.

SEE ALSO

       pemmican-cli(1), pemmican-reset(1)

       The   freedesktop   notifications   specification   <https://specifications.freedesktop.org/notification-
       spec/latest/>.

BUGS

       Please report bugs at: https://github.com/waveform80/pemmican/issues

AUTHOR

       Dave Jones

COPYRIGHT

       2023-2024 Dave Jones

1.0.3                                             Mar 08, 2024                                   PEMMICAN-MON(1)