FieldServer Driver

FS-8700-124

Toshiba UPS

 

Description

The serial TIC UPS driver allows the ProtoNode to transfer data to and from devices over RS-232 using TIC UPS protocol.  The ProtoNode can emulate a Client.

This driver is intended for use with Toshiba models UPS.

It is intended to do the following:

• · Read information from the UPS such as battery life, voltages etc.  This will be done in user mode on the UPS.
• · Write information and commands such as shutdown commands to the UPS.
• · Advanced options such as reading/writing EEPROM is not supported.  No date/time reads or writes will be supported.  No string type commands will be supported.

 

The driver has both Server and Client implementations.  The Server will only be for emulation and test purposes and will never be implemented by the customer.  As such, a complete Server will not be implemented.

 

ProtoNode Mode	Nodes	Comments
Client	1	As the Toshiba protocol only allows for 1:1 communication at this stage, only 1 Client is allowed per RS-232 port.
Server	1	The Server only serves for emulation purposes.  It will have a static address as per Toshiba spec.

Formal Driver Type

Serial

Client Only

Compatibility Matrix

FieldServer Model	Compatible with this driver
ProtoNode	Yes

Connection Information

Connection type:	RS-232
Baud Rates:	1200; 2400; 4800; 9600 Baud
Data Bits:	7
Stop Bits:	1
Parity:	Even
Multidrop Capability	No

Devices tested

Device	Tested (FACTORY, SITE)
TIC UPS model 1600	FACTORY

Connection configurations

Connection Notes

• The cable connecting a ProtoNode to the UPS should be a NULL modem cable.
• Note that no hardware handshaking is supported.
• The connector to the UPS is a DB9 male connector.

Communications functions – Supported functions at a glance:

User mode commands:

• · Read operations as stated below.
• · Monitoring read commands
• · No commands that return a string will be supported.
• · No date/time commands supported at this time.

 

Maintenance mode commands:

• · Limited set of write commands.
• · E&F commands not supported.
• · Date/time commands not supported.
• · String commands not supported.

 

Read Operations supported

ProtoNode as a Client	ProtoNode as a Server	Description
ALARM	ALARM	Alarm data
BC	BC	Battery current
BECR	BECR	Battery estimated charge remaining
BEMR	BEMR	Battery estimated minutes remaining
BLR	BLR	Battery life remaining
BPV1	BPV1	Bypass voltage phase 1
BPV2	BPV2	Bypass voltage phase 2
BPV3	BPV3	Bypass voltage phase 3
BPC	BPC	Bypass current
BPFREQ	BPFREQ	Bypass frequency
BRHT	BRHT	Battery rated holding time
BT	BT	Battery temperature
BVP	BVP	Battery voltage percentage
DCBV	DCBV	DC bus voltage
FAULT	FAULT	Fault data
IC1	IC1	Input current phase 1
IC2	IC2	Input current phase 2
IC3	IC3	Input current phase 3
IFRQ	IFRQ	Input frequency
IV1	IV1	Input voltage phase 1
IV2	IV2	Input voltage phase 2
IV3	IV3	Input voltage phase 3
OC1	OC1	Output current phase 1
OC2	OC2	Output current phase 2
OC3	OC3	Output current phase 3
OFRQ	OFRQ	Output frequency
OLP1	OLP1	Output load percent phase 1
OLP2	OLP2	Output load percent phase 2
OLP3	OLP3	Output load percent phase 3
OV1	OV1	Output voltage phase 1
OV2	OV2	Output voltage phase 2
OV3	OV3	Output voltage phase 3
SOB	SOB	Seconds on battery
SAD	SAD	Shutdown after delay

 

	FAULT COMMAND	ALARM COMMAND	STATUS COMMAND
Bit #	Function	Function	Function
Bit 23	Not used	Not used
Bit 22	1	1
Bit 21:	Input over current	Low battery voltage
Bit 20:	DC over current	Battery replacement alarm
Bit 19:	DC bus over voltage	Parallel running mode
Bit 18:	DC bus under voltage	0
Bit 17:	Phase rotation error	0
Bit 16:	DC Bus imbalance	UPS lifetime alarm
Bit 15:	Not used	Not used
Bit 14:	1	1
Bit 13:	EEPROM error	Asynchronous operation
Bit 12:	Battery or charger circuit fault	Ambient overheat
Bit 11:	Battery overheat	Overload accumulation started
Bit 10:	UPS overheat	0
Bit 9:	0	0
Bit 8:	Fuse has opened	0
Bit 7:	Not used	Not used	Not used
Bit 6:	1	1	1
Bit 5:	Inverter over current	Countdown started for shutdown	UPS fault detected
Bit 4:	UPS overload	0	Input voltage out of spec
Bit 3:	Inverter overload	0	Low battery voltage detected
Bit 2:	Inverter under voltage	0	UPS output from bypass
Bit 1:	Overload 110% load	0	UPS output from inverter
Bit 0:	Inverter over voltage	0	UPS input and output voltage sync

 

 

Commands Supported by Different Models

1600:	1800	4200	G8000 & G8000MM
ALARM	ALARM	BC	BC
BC	BC	BPV1	BECR
BEMR	BECR	BPV2	BPV1
BLR	BEMR	BPV3	BPV2
BPV1	BLR	BPC	BPV3
BPC	BPV1	BPFREQ	BPC
BPFREQ	BPC	BRHT	BPFREQ
BRHT	BPFREQ	BVP	BRHT
BT	BRHT	DCBV	BVP
BVP	BT	FAULT	DCBV
FAULT	BVP	IC1	FAULT
IC1	DCBV	IC2	IC1
IFRQ	FAULT	IC3	IC2
IV1	IC1	IFRQ	IC3
OC1	IFRQ	IV1	IFRQ
OFRQ	IV1	IV2	IV1
OLP1	OC1	IV3	IV2
OV1	OFRQ	OC1	IV3
SAD	OLP1	OC2	OC1
STATUS	OV1	OC3	OC2
	SOB	OFRQ	OC3
	SAD	OLP1	OFRQ
	STATUS	OLP2	OLP1
		OLP3	OLP2
		OV1	OLP3
		OV2	OV1
		OV3	OV2
		SAD	OV3
		STATUS	STATUS

 

Write (Control) Operations supported

ProtoNode as a Client	ProtoNode as a Server	Description
SAD	SAD	Shutdown after delay.
BTEST		Battery Test[1]

 

ProtoNode as a Client	ProtoNode as a Server
The following models support the listed commands 1600: SAD BTEST 1800: SAD BTEST 4200: SAD BTEST G8000 and G8000MM:	The following models support the listed commands 1600: SAD 1800: SAD 4200: SAD G8000 and G8000MM:

Unsupported Functions and Data Types

Function	Reason
Programming messages	ProtoNode is a data transfer device, and as such, programming messages are not required
All date and time functions	Other protocols don’t support date and time functions.
All string commands: Type form Serial number Manufacturer Software version	Other protocols don’t support any strings being read or written.
All E & F commands	Other protocols don’t support any functions as these.