nut/drivers/apcsmart_tabs.c

/* apcsmart_tabs.c - common tables for APC smart protocol units
 *
 * Copyright (C) 1999  Russell Kroll <rkroll@exploits.org>
 *           (C) 2000  Nigel Metheringham <Nigel.Metheringham@Intechnology.co.uk>
 *           (C) 2011+ Michal Soltys <soltys@ziu.info>
 *
 * 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
 */

#include "apcsmart_tabs.h"

/* APC_MULTI variables *must* be listed in order of preference */
apc_vartab_t apc_vartab[] = {
/* name cmd flags   regex   nlen0   cnt */
	{ "ups.temperature",		'C',	APC_POLL|APC_F_CELSIUS, NULL, 0, 0 },
	{ "ups.load",			'P',	APC_POLL|APC_F_PERCENT, NULL, 0, 0 },
	{ "ups.test.interval",		'E',	APC_F_HOURS, NULL, 0, 0 },
	{ "ups.test.result",		'X',	APC_POLL, NULL, 0, 0 },
	{ "ups.delay.start",		'r',	APC_F_SECONDS, NULL, 0, 0 },
	{ "ups.delay.shutdown",		'p',	APC_F_SECONDS, NULL, 0, 0 },
	{ "ups.id",			'c',	APC_STRING, NULL, 0, 0 },
	{ "ups.contacts",		'i',	APC_POLL|APC_F_HEX, NULL, 0, 0 },
	{ "ups.display.language",	'\014', 0, NULL, 0, 0 },
	{ "input.voltage",		'L',	APC_POLL|APC_F_VOLT, NULL, 0, 0 },
	{ "input.frequency",		'F',	APC_POLL|APC_F_DEC, NULL, 0, 0 },
	{ "input.sensitivity",		's',	0, NULL, 0, 0 },
	{ "input.quality",		'9',	APC_POLL|APC_F_HEX, NULL, 0, 0 },
	{ "input.transfer.low",		'l',	APC_F_VOLT, NULL, 0, 0 },
	{ "input.transfer.high",	'u',	APC_F_VOLT, NULL, 0, 0 },
	{ "input.transfer.reason",	'G',	APC_POLL|APC_F_REASON, NULL, 0, 0 },
	{ "input.voltage.maximum",	'M',	APC_POLL|APC_F_VOLT, NULL, 0, 0 },
	{ "input.voltage.minimum",	'N',	APC_POLL|APC_F_VOLT, NULL, 0, 0 },
	{ "output.current",		'/',	APC_POLL|APC_F_AMP, NULL, 0, 0 },
	{ "output.voltage",		'O',	APC_POLL|APC_F_VOLT, NULL, 0, 0 },
	{ "output.voltage.nominal",	'o',	APC_F_VOLT, NULL, 0, 0 },
	{ "ambient.humidity",		'h',	APC_POLL|APC_F_PERCENT, NULL, 0, 0 },
	{ "ambient.0.humidity",		'H',	APC_POLL|APC_PACK|APC_F_PERCENT, NULL, 0, 0 },
	{ "ambient.0.humidity.high",	'{',	APC_POLL|APC_PACK|APC_F_PERCENT, NULL, 0, 0 },
	{ "ambient.0.humidity.low",	'}',	APC_POLL|APC_PACK|APC_F_PERCENT, NULL, 0, 0 },
	{ "ambient.temperature",	't',	APC_POLL|APC_F_CELSIUS, NULL, 0, 0 },
	{ "ambient.0.temperature",	'T',	APC_MULTI|APC_POLL|APC_PACK|APC_F_CELSIUS, "^[0-9]{2}\\.[0-9]{2}$", 0, 0 },
	{ "ambient.0.temperature.high",	'[',	APC_POLL|APC_PACK|APC_F_CELSIUS, NULL, 0, 0 },
	{ "ambient.0.temperature.low",	']',	APC_POLL|APC_PACK|APC_F_CELSIUS, NULL, 0, 0 },
	{ "battery.date",		'x',	APC_STRING, NULL, 0, 0 },
	{ "battery.charge",		'f',	APC_POLL|APC_F_PERCENT, NULL, 0, 0 },
	{ "battery.charge.restart",	'e',	APC_F_PERCENT, NULL, 0, 0 },
	{ "battery.voltage",		'B',	APC_POLL|APC_F_VOLT, NULL, 0, 0 },
	{ "battery.voltage.nominal",	'g',	0, NULL, 0, 0 },
	{ "battery.runtime",		'j',	APC_POLL|APC_F_MINUTES, NULL, 0, 0 },
	{ "battery.runtime.low",	'q',	APC_F_MINUTES, NULL, 0, 0 },
	{ "battery.packs",		'>',	APC_F_DEC, NULL, 0, 0 },
	{ "battery.packs.bad",		'<',	APC_F_DEC, NULL, 0, 0 },
	{ "battery.alarm.threshold",	'k', 0, NULL, 0, 0 },
	{ "device.uptime",		'T',	APC_MULTI|APC_POLL|APC_F_HOURS, "^[0-9]{3}\\.[0-9]{1}$", 0, 0 },
	{ "ups.serial",			'n', 0, NULL, 0, 0 },
	{ "ups.mfr.date",		'm', 0, NULL, 0, 0 },
	{ "ups.model",			'\001', 0, NULL, 0, 0 },
	{ "ups.firmware.aux",		'v', 0, NULL, 0, 0 },
	{ "ups.firmware",		'b',	APC_MULTI, "^[[:alnum:]]+\\.[[:alnum:]]+\\.[[:alnum:]]+$", 0, 0 },
	{ "ups.firmware",		'V',	APC_MULTI, NULL, 0, 0 },

	{ NULL, 0, 0, NULL, 0, 0 }
	/* todo:

	   I = alarm enable (hex field) - split into alarm.n.enable
	   J = alarm status (hex field) - split into alarm.n.status

	0x15 = output voltage selection (APC_F_VOLT)
	0x5C = load power (APC_POLL|APC_F_PERCENT)

	 */
};

/*
 * APC commands mapped to NUT's instant commands
 * the format of extra values is matched by extended posix regex
 * APC_CMD_CUSTOM means that the instant command is handled by separate
 * function, thus the actual APC cmd in the table is ignored
 */
apc_cmdtab_t apc_cmdtab[] = {
	{ "shutdown.return",	"^[Aa][Tt]:[0-9]{1,3}$",
					APC_CMD_GRACEDOWN,	APC_NASTY },
	{ "shutdown.return",	"^([Cc][Ss]|)$",
					APC_CMD_SOFTDOWN,	APC_NASTY },
	{ "shutdown.stayoff",	NULL,	APC_CMD_SHUTDOWN,	APC_NASTY|APC_REPEAT },
	{ "load.off",		NULL,	APC_CMD_OFF,		APC_NASTY|APC_REPEAT },
	{ "load.on",		NULL,	APC_CMD_ON,		APC_REPEAT },
	{ "calibrate.start",	NULL,	APC_CMD_CALTOGGLE,	0 },
	{ "calibrate.stop",	NULL,	APC_CMD_CALTOGGLE,	0 },
	{ "test.panel.start",	NULL,	APC_CMD_FPTEST,		0 },
	{ "test.failure.start",	NULL,	APC_CMD_SIMPWF,		0 },
	{ "test.battery.start",	NULL,	APC_CMD_BTESTTOGGLE,	0 },
	{ "test.battery.stop",	NULL,	APC_CMD_BTESTTOGGLE,	0 },
	{ "bypass.start",	NULL,	APC_CMD_BYPTOGGLE,	0 },
	{ "bypass.stop",	NULL,	APC_CMD_BYPTOGGLE,	0 },

	{ NULL, NULL, 0, 0 }
};

/* compatibility with hardware that doesn't do APC_CMDSET ('a') */
apc_compattab_t apc_compattab[] = {
	/* APC Matrix */
	{ "0XI",	"@789ABCDEFGKLMNOPQRSTUVWXYZcefgjklmnopqrsuwxz/<>\\^\014\026", 0 },
	{ "0XM",	"@789ABCDEFGKLMNOPQRSTUVWXYZcefgjklmnopqrsuwxz/<>\\^\014\026", 0 },
	{ "0ZI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz/<>", 0 },
	{ "5UI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz/<>", 0 },
	{ "5ZM",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz/<>", 0 },
	/* APC600 */
	{ "6QD",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "6QI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "6TD",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "6TI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	/* SmartUPS 900 */
	{ "7QD",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "7QI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "7TD",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "7TI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	/* SmartUPS 600I */
	{ "6JI",	"@789ABCFGKLMNOPQSTUVWXYZfg", 0 },
	/* SmartUPS 900I */
	{ "7II",	"@79ABCEFGKLMNOPQRSUVWXYZcfg", 0 },
	/* SmartUPS 2000I */
	{ "9II",	"@79ABCEFGKLMNOPQRSUVWXYZcfg", 0 },
	{ "9GI",	"@79ABCEFGKLMNOPQRSUVWXYZcfg", 0 },
	/* SmartUPS 1250I */
	{ "8II",	"@79ABCEFGKLMNOPQRSUVWXYZcfg", 0 },
	{ "8GI",	"@79ABCEFGKLMNOPQRSUVWXYZfg", 0 },
	/* SmartUPS 1250 */
	{ "8QD",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "8QI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "8TD",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	{ "8TI",	"@79ABCDEFGKLMNOPQRSUVWXYZcefgjklmnopqrsuxz", 0 },
	/* CS 350 */
	{ "5.4.D",	"@\1ABPQRSUYbdfgjmnx9",	0 },
	/*
	 * certain set of UPSes returning voltage > 255V through 'b'; "set\1"
	 * is matched explicitly (fake key); among the UPS models - some old
	 * APC 600 ones
	 */
	{  "set\1",	"@789ABCFGKLMNOPQRSUVWXYZ", 0 },

	{ NULL, NULL, 0 }
};

upsdrv_info_t apc_tab_info = {
	"APC command table",
	APC_TABLE_VERSION,
	"Russell Kroll <rkroll@exploits.org>\n" \
	"Nigel Metheringham <Nigel.Metheringham@Intechnology.co.uk>\n" \
	"Michal Soltys <soltys@ziu.info>",
	DRV_STABLE,
	{ NULL }
};