User's Manual UPS control system
Table Of Contents
- Apcupsd User's Manual
- Release Notes
- How To Use This Manual
- Basic User's Guide
- Planning Your Installation
- Building and Installing apcupsd
- After Installation
- Configuration Examples
- Testing Apcupsd
- Troubleshooting Your Installation
- Monitoring and Tuning your UPS
- Maintaining Your UPS
- Frequently-Asked Questions
- Apcupsd Bugs
- Advanced topics
- Customizing Event Handling
- Master/Slave Configurations
- Controlling Multiple UPSes on one Machine
- Support for SNMP UPSes
- Alternate Ways To Run The Network Information Server
- apcupsd System Logging
- Installation: Windows
- Windows Version of apcupsd
- Installation: Serial-Line UPSes
- Overview of Serial-Interface UPSes
- Connecting a Serial-Line UPS to a USB Port
- Connecting a APC USB UPS to either a PC USB or Serial Port
- Cables
- Smart-Custom Cable for SmartUPSes
- Smart Signalling Cable for BackUPS CS Models
- Voltage-Signalling Cable for "dumb" UPSes
- Other APC Cables that apcupsd Supports
- Voltage Signalling Features Supported by Apcupsd for Various Cables
- Voltage Signalling
- Back-UPS Office 500 signals
- Analyses of APC Cables
- Win32 Implementation Restrictions for Simple UPSes
- Internal Apcupsd Actions for Simple Cables
- RS232 Wiring and Signal Conventions
- Pin Assignment for the Serial Port (RS-232C), 25-pin and 9-pin, Female End
- Ioctl to RS232 Correspondence
- Testing Serial-Line UPSes
- Troubleshooting Serial Line communications
- Recalibrating the UPS Runtime
- DATA Logging
- Technical Reference
- Configuration Directive Reference
- apcupsd Status Logging
- Shutown Sequence and its Discontents
- APC smart protocol
- Apcupsd --- RPM Packaging FAQ
- Credits
- Kernel Config
If all there things check out and you still can’t see the UPS, something is
more seriously wrong than this manual can cover – find expert help. If you
are unable to list USB devices or drivers, you kernel may not be USB-capable
and that needs to be fixed. Please check if your kernel has the three patches
listed in the <apcupsd-source>/examples directory. Each of the files ends
with the name .patch, and at the current writing they are:
linux-2.4.20-killpower.patch
linux-2.4.20-USB-reject.patch
linux-2.6.0-USB-queue-overflow.patch
For example, RedHat 9 and/or pre-2.4.22 kernels are known to need the
linux-2.4.20-USB-reject.patch for APC SmartUPS XL series devices.
There are also a few email files that you can consult in the examples directory
for additional information and details.
Finally, check your Kernel Config. You will find more information about it
at:
Kernel Config.
KNOWN ISSUES WITH BSD USB
The BSD USB driver for apcupsd is BETA software and has some known
issues.
- FreeBSD lockups: Some users have experienced lockups (apcupsd stops
responding) on FreeBSD systems. In at least one case this problem was
worked around by disabling pthreads (—disable-pthreads flag to configure).
The problem seems to be caused by a FreeBSD kernel bug.
- FreeBSD kernel panics if USB cable is unplugged while apcupsd is running.
This is another kernel bug and is most easily worked around by not hot-
unplugging the UPS while apcupsd is running.
PLATFORMS & VERSIONS
The new (beta) FreeBSD USB driver supports FreeBSD, OpenBSD and
NetBSD. (Thanks go to the *BSD developers who kept a nearly identical
interface across all three platforms.)
The driver has been tested with the following platform versions:
FreeBSD-5.3 (Primary development platform)
28










