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
FreeBSD-4.11
NetBSD-2.0
NetBSD-1.6.2
OpenBSD-3.6
FreeBSD-5.3 has had the most testing since it is the primary platform on
which the driver is developed. The other platforms and versions have had
somewhat less testing. The only architecture tested so far (on any platform)
is i386, althought there is no reason to think it will not work on other archs.
If you run the driver on a new platform version or architecture, please report
your experience to the apcupsd-users mailing list.
KERNEL CONFIGURATION
You will need to rebuild your kernel in order to disable the uhid driver.
uhid is not sufficient for apcupsd at this time and we need to prevent it
from grabbing the UPS device. You should disable the following devices in
your kernel config file (comment them out):
FreeBSD (you WILL NOT lose use of USB keyboard and mouse): uhid
NetBSD (you WILL lose use of USB keyboard and mouse): uhidev, ums,
wsmouse, ukbd, wskbd, uhid
OpenBSD (you WILL lose use of USB keyboard and mouse): uhidev, ums,
wsmouse, ukbd, wskbd, uhid
For detailed information on rebuilding your kernel, consult these references:
FreeBSD:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
NetBSD:
http://www.netbsd.org/guide/en/chap-kernel.html
OpenBSD:
http://www.openbsd.org/faq/faq5.html#Building
CHECKING UPS IS RECOGNIZED BY THE KERNEL
After building a properly configured kernel, reboot into that kernel and
plug in your UPS USB cable. You should see a dmesg log message like the
following:
ugen0: American Power Conversion Back-UPS RS 1500 FW:8.g6 .D USB
FW:g6, rev 1.10/1.06, addr 2
29










