Embed Size (px)
Citation preview
© 2002 Eaton Corporation. All rights reserved.
Powerware CoreLogicTM
Software Development Toolkit
Product Overview
Rev 11/04
Introduction
•Finally, direct access to the UPS through a software interface that you control
•No more being forced to use manufacturer’s software
•Small, fast tools to get the information you need
•Ultra-reliable, industrial, mission critical code
Rev 11/04
FAQs
What is the Powerware CoreLogic™ Software Development Toolkit?The Powerware CoreLogic™ Software Development Toolkit (CoreLogic) is a family of integrator/developer tools and programs purchased on CD to assist in writing new software, integrating into existing customer software or create script or batch files to monitor and control Powerware UPSs.
Are there tools for IT? Do I need to be a programmer?The CoreLogic™ contains a number of simple (yet powerful) command line utility programs (for Windows, Linux, HP/UX, UNIX and more) which are ideally suited for script or batch file execution, or as immediate direct query tools (such as a “ping” or “telnet”). Perfect for the IT professional when you just need to go directly to the unit to retrieve status.
Can I use the toolkit to UPS-enable my own software?Yes. CoreLogic™ contains the powerful Powerware XCP Driver Library and API to quickly allow you to make your C/C++ program or embedded threads communicate with your Powerware UPS.
Rev 11/04
FAQs
Is there source code in the toolkit?The C-code source for the command line tools is included as examples of how to interface to the Powerware XCP Library API. Source for the API is not necessary and is not included.
Can I distribute or sell any program I write? Can I distribute the programs found in the toolkit?
No. CoreLogic™ is designed for internal (within the walls of your organization) use. The End User License Agreement specifically prohibits distribution of any of the CoreLogic components (including the library) outside of your company. Should you wish to distribute software or embedded programs created that includes the CoreLogic™ XCP Library or any of the CoreLogic tools, please contact us at [email protected] and inquire regarding a distribution license and the corresponding fee.
Rev 11/04
Industrial and Commercial Grade Applications Design
• Industry leading Powerware UPS hardware
• Now: Industry leading powerful, reliable Industrial Software Components
• Rapid Application Development (RAD) and System Integration
• Windows/Linux UPS API Libraries for USB, SERIAL and SNMP communications
• Powerful Tools for low-level command and control
• Licensed Software Technology• Source Available for Licensed Distribution
Rev 11/04
Powerware Powerware CorelogicCorelogic™™Software Development Toolkit CDSoftware Development Toolkit CD
•Raw tools for Linux and Windows Developers & IT for UPS monitoring & control
• Industry leading API Library•Set of utilities- with source•Multiple UPS/device monitoring program.
• Industrial-grade shutdown support•Compatible with all XCP protocol devices
•Small footprint, efficient fast library•Embedded processor/kernel friendly
•Designed for Developers & IT•Sales direct from web
(www.powerware.com/software/corelogic.asp)
•Powerware UPSs are the Integrator’s ChoiceTM
Rev 11/04
Toolkit Components
PAM (PArallel Monitoring) Program
•PAM User Guide
Command-line Tools•Command-line User Guides•Command-line source C-code
Industrial Computer Shutdown
•Industrial Shutdown•Controller•Shutdown Agent
UPS Communications Library
•Library API•Documentation
Rev 11/04
Command-Line ToolsPUPS (Powerware UPS Power Status)
•Can retrieve over-all status via USB, Serial, SNMP, Net XCP of multiple UPSs•Returns Exit/ErrorLevel code and/or verbose (readable) output•Source Code
PUPC (Powerware UPS Power Control)•Can energize/de-energize outlets, begin/retrieve battery tests•Returns Exit/ErrorLevel code and/or verbose (readable) output•Source Code
PUPD (Powerware UPS Power Discovery)•Searches the network or serial ports and returns found UPSs•Source Code
Rev 11/04
Command-Line ToolsSimple Windows™ Batch-File Application of the PUPS programREM ***********************************************REM ** Sample Windows CMD batch fileREM ***********************************************:top ; looping labelpwsleep 20 ; poll every 20 secpups 10.192.51.192 –s ; -s (use SNMP)If ERRORLEVEL 0 goto top ; if nominal, loopREM ***********************************************REM ** Non-nominal conditionREM ***********************************************If ERRORLEVEL 255 goto comErr ; 255 = comm errorREM ***********************************************REM ** Alert required. UPS in non-nominal condition.REM ***********************************************net send admin_station “UPS Alert Condition Detected”pwsleep 600 ; repeat every 10mingoto top ; if necessary.
Rev 11/04
Toolkit Components
PAM (PArallel Monitoring) Program
•PAM User Guide
Command-line Tools•Command-line User Guides•Command-line source C-code
Industrial Computer Shutdown
•Industrial Shutdown•Controller•Shutdown Agent
UPS Communications Library
•Library API•Documentation
Rev 11/04
PAMParallel Access Monitor (PAM)
• Designed for finite state high reliability operation- NO GUI.• Ideal for servers with redundant power supplies feeding from multiple UPSs.• Can retrieve UPS status via USB, Serial, SNMP, Net XCP from multiple UPSs or
same UPS in multiple ways for redundancy of communication methods• Unlimited communication inputs: N UPSs• Performs algebraic logic to determine one of three states:
• NOMINAL STATE• WATCH STATE• TRIGGER STATE
• Operation can be modeled by logic diagrams• Can retrieve external states to be used in algebraic state determination (for example,
state of a server’s power supply)• Designed for mission critical applications & embedding• Source code available for additional licensing fee
Rev 11/04
PAM
•Finite state machine operation –Logic Diagram
•Small in size (~70K), focused in function and large on performance.
•Multiple UPS monitoring- including redundant comms
• INI file defines PAM operation•This file defines the logic conditions for finite states.
Rev 11/04
PAM Example Application- Mission Critical Redundant Monitoring
Server #1
Server #2
Server #3
UPS #1
UPS #2
•PAM software would run on each of 3 servers.
•If running on battery on one UPS-situation OK.
•If the utility input of UPS#1 AND UPS#2 is gone and batteries are low, then begin graceful shutdown.
•Communications to UPSs could be network, or network AND USB for redundant communications, redundant power, and redundant power supplies.
Rev 11/04
Toolkit Components
PAM (PArallel Monitoring) Program
•PAM User Guide
Command-line Tools•Command-line User Guides•Command-line source C-code
Industrial Computer Shutdown
•Industrial Shutdown•Controller•Shutdown Agent
UPS Communications Library
•Library API•Documentation
Rev 11/04
Industrial Computer ShutdownSBC• Shutdown Broadcast Controller (SBC)• Command-line program (run to completion)• Can command remote agents to perform
computer shutdown (typically in the case of a low UPS battery)
• Can be ‘triggered’ from any program– including PAM
• Capable of handling thousands of SDAs• Multi-threaded design for each SDA to prevent
lock-up, guaranteed message delivery• Test mode• Windows O/S only
SDA• ShutDown Agent (SDA)• Receives commands from SBC• Many O/S supported.
Network
ComputerLoads
Power
“Embedded IndustrialSoftware/Firmware”
CoreLogic!
UPS
Rev 11/04
Toolkit Components
PAM (PArallel Monitoring) Program
•PAM User Guide
Command-line Tools•Command-line User Guides•Command-line source C-code
Industrial Computer Shutdown
•Industrial Shutdown•Controller•Shutdown Agent
UPS Communications Library
•Library API•Documentation
Rev 11/04
XCP Driver LibraryHigh Level API calls to:• Discover UPSs• Connect to UPSs• Is APIs• Get APIs• Set APIs• Disconnect from UPS• Available for wide O/S (Windows, Linux, Unix,
HP/UX, and more)• Connection modes:• SNMP• Powerware network XCP• Serial comms• USB comms• Dial-up• Advanced stream caching and O/S
independence for easy cross-compile
Rev 11/04
XCP Driver LibraryHigh Level API calls to:• Discover UPSs• Connect to UPSs• Is APIs• Get APIs• Set APIs• Disconnect from UPS• Available for wide O/S (Windows, Linux, Unix,
HP/UX, and more)• Connection modes:• SNMP• Powerware network XCP• Serial comms• USB comms• Dial-up• Advanced stream caching and O/S
independence for easy cross-compile
Rev 11/04
Corelogic™ Software Development Toolkit Summary
•Low-level power tools•Embed-able solution. Easily integrates with your system.
•Small in size. Focused in function & large on performance.
•Customizable -- does exactly what you want it to do and nothing more.
•Finite State Machine, Logic Diagram-able.
•Source can be compiled at lower Kernel level.
•Redundant Monitoring•Works with all UPSs supporting RFC 1628 SNMP & Powerware MIB.
•Mission Critical caliber -- No GUI crashes.
•N+X UPSs Monitoring & Control.•Source Code is available for additional licensing
•Reliable, Tested, Proven, Trusted.
•Powerware.
