nut-debian/drivers/oneac.h
2012-08-12 23:39:31 +02:00

184 lines
6.4 KiB
C

/* oneac.h - Driver for Oneac UPS using the Advanced Interface.
*
* Copyright (C)
* 2003 by Eric Lawson <elawson@inficad.com>
* 2012 by Bill Elliot <bill@wreassoc.com>
*
* This program was sponsored by MGE UPS SYSTEMS, and now Eaton
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
/*misc stuff*/
#define ENDCHAR '\r'
#define IGNCHARS "\n"
#define COMMAND_END "\r\n"
#define DEFAULT_BAT_TEST_TIME "02"
/*Information requests -- EG level */
#define GET_ALL '%'
#define GETALL_EG_RESP_SIZE 22
#define GETALL_RESP_SIZE 48
#define GET_MFR 'M'
#define GET_FAMILY 'F'
#define GET_VERSION 'N'
#define GET_ON_INVERTER 'G'
#define GET_BATLOW 'K'
#define GET_STATUS 'X'
#define GET_LAST_XFER 'W'
#define GET_INVERTER_RDY 'I'
#define GET_SHUTDOWN 'O'
#define GET_TEST_TIME 'Q'
#define GET_NOM_FREQ 'H'
/*Information requests -- ON level (EG plus these) */
#define GET_NOM_VOLTAGE 'V'
#define GET_DISPLAY_CODE 'D'
#define GET_CONDITION_CODE 'C'
#define GET_PERCENT_LOAD 'P'
#define GET_PERCENT_BAT_REM 'T'
#define GET_INPUT_LINE_VOLT 'L'
#define GET_MIN_INPUT_VOLT 'A'
#define GET_MAX_INPUT_VOLT 'E'
#define GET_OUTPUT_VOLT 'S'
#define GET_BOOSTING 'B'
#define GET_SHUTDOWN_RESP_SIZE 3
/*Information requests -- OZ/OB level (ON plus these) */
#define GETX_ALL_1 '&'
#define GETX_ALL1_RESP_SIZE 79
#define GETX_OUTSOURCE 'a'
#define GETX_FRONTDISP 'b'
#define GETX_INT_TEMP 'g' /* Degrees C */
#define GETX_BATT_STAT 'h' /* Unknown(1), Normal, Low, Depleted */
#define GETX_BATT_CHG_PERC 'i' /* 0 - 100 */
#define GETX_EST_MIN_REM 'j'
#define GETX_ONBATT_TIME 'k' /* In seconds */
#define GETX_BATT_VOLTS 'l' /* Read as xxx.x */
#define GETX_INP_FREQ 'p'
#define GETX_MIN_IN_VOLTS 'q'
#define GETX_MAX_IN_VOLTS 'r'
#define GETX_IN_VOLTS 's'
#define GETX_IN_WATTS 'u'
#define GETX_OUT_VOLTS 'v'
#define GETX_OUT_WATTS 'x'
#define GETX_OUT_LOAD_PERC 'y'
#define GETX_OUT_FREQ 'z'
#define GETX_ALL_2 '^'
#define GETX_ALL2_RESP_SIZE 92
#define GETX_MODEL 'J'
#define GETX_FW_REV 'U' /* Read as xx.x */
#define GETX_SERIAL_NUM 'Y'
#define GETX_MAN_DATE '$' /* yymmdd */
#define GETX_BATT_REPLACED '+' /* yymmdd */
#define GETX_DATE_RESP_SIZE 6
/* FIXME: Both of the following constants are unused, and the first is not
* valid C syntax (breaks LLVM). */
#if 0
#define GETX_UNIT_KVA '''' /* Read as xxx.xx */
#define GETX_UNIT_WATTS "''" /* 2-character string request */
#endif
#define GETX_LOW_OUT_ALLOW '[' /* Tap up or inverter at this point */
#define GETX_HI_OUT_ALLOW ']' /* Tap down or inverter at this point */
#define GETX_NOTIFY_DELAY ',' /* Secs of delay for power fail alert */
#define GETX_ALLOW_RESP_SIZE 3
#define GETX_LOW_BATT_TIME '"' /* Low batt alarm at xx minutes */
#define GETX_RESTART_DLY '_' /* Restart delay */
#define GETX_RESTART_COUNT "_?" /* Returns actual counter value */
#define GETX_RSTRT_RESP_SIZE 4
/*Other requests */
#define GETX_SHUTDOWN '}' /* Shutdown counter (..... for none) */
#define GETX_SHUTDOWN_RESP_SIZE 5
#define GETX_BATT_TEST_DAYS "\x02\x1A" /* Days between battery tests */
#define GETX_BUZZER_WHAT "\x07?" /* What is buzzer state */
#define GETX_AUTO_START "<?" /* Restart type */
#define GETX_ALLOW_RANGE "[=?" /* Responds with min,max,spread */
#define GETX_RANGE_RESP_SIZE 10
/*Control functions (All levels) */
#define SIM_PWR_FAIL "\x02\x15" /*^B^U 15 second battery test*/
#define SHUTDOWN "\x0f\x06" /*^O^F (a letter O)*/
#define RESET_MIN_MAX 'R'
#define BAT_TEST_PREFIX "\x02" /*^B needs 2 more chars. minutes*/
#define DELAYED_SHUTDOWN_PREFIX 'Z' /* EG/ON needs 3 more chars. seconds */
/* ON96 needs 1 to 5 chars. of seconds */
/*Control functions (ON96) */
#define TEST_INDICATORS "\x09\x14" /*^I^T flashed LEDs and beeper */
#define TEST_BATT_DEEP "\x02\x04" /*^B^D runs until low batt */
#define TEST_BATT_DEAD "\x02\x12" /*^B^R run until battery dead */
#define TEST_ABORT '\x01' /* Abort any running test */
#define REBOOT_LOAD "\x12@" /*^R@xxx needs 3 chars of secs */
#define SETX_BUZZER_PREFIX '\x07' /*^G needs one more character */
#define SETX_OUT_ALLOW "[=" /* [=lll,hhh */
#define SETX_BUZZER_OFF "\x070" /*^G0 disables buzzer */
#define SETX_BUZZER_ON "\x071" /*^G1 enables buzzer */
#define SETX_BUZZER_MUTE "\x072" /*^G2 mutes current conditions */
#define SETX_BATT_TEST_DAYS "\x02\x1A=" /* Needs 0 - 129 days, 0 is disable */
#define SETX_LOWBATT_AT "\"=" /* Low batt at (max 99) */
#define SETX_RESTART_DELAY "_=" /* _=xxxx, up to 9999 seconds */
#define SETX_AUTO_START '<' /* <0 / <1 for auto / manual */
#define SETX_BATTERY_DATE "+=" /* Set battery replace date */
#define DONT_UNDERSTAND '*'
#define CANT_COMPLY '#'
#define NO_VALUE_YET '.'
#define HIGH_COUNT '+' /* Shutdown counter > 999 on OZ */
#define MIN_ALLOW_FW "1.9" /* At or above provides output allow range */
/*responses*/
#define FAMILY_EG "EG" /* 3 tri-color LEDs and big ON/OFF on front */
#define FAMILY_ON "ON" /* Serial port avail only on interface card */
#define FAMILY_OZ "OZ" /* DB-25 std., plus interface slot */
#define FAMILY_OB "OB" /* Lg. cab with removable modules */
#define FAMILY_SIZE 2
#define YES 'Y'
#define NO 'N'
#define V230AC '2'
#define V120AC '1'
#define XFER_BLACKOUT 'B'
#define XFER_LOW_VOLT 'L'
#define XFER_HI_VOLT 'H'
#define BUZZER_ENABLED '1'
#define BUZZER_DISABLED '0'
#define BUZZER_MUTED '2'
/*front panel alarm codes*/
#define CODE_BREAKER_OPEN "c1" /*input circuit breaker open*/
#define CODE_BAT_FUSE_OPEN "c2" /*battery not connected. Open fuse?*/
#define CODE_TOO_HOT "c3" /*UPS too hot*/
#define CODE_CHARGING "c4" /*recharging battery pack*/
#define CODE_LOW_BAT_CAP "c5" /*batteries getting too old*/
#define CODE_OVERLOAD "c8" /*"slight" overload*/
#define CODE_GROSS_OVLE "c9" /*gross overload 1 minute to power off*/
#define CODE_CHRGR_FUSE_OPEN "u1" /*battery charger fuse probably open*/