TS-1400

TS-1400

Released March 2013
Product Page
Documentation
FTP Path
Relays
External Interfaces
2x RJ45 Modbus
Power Requirements
24V
Operates between 0.435W-9.75W
Operating Temperature
-40C
85C
Mechanical
164mm x 112mm
Height 58mm (with relays)
Weight 467g

Overview

The TS-1400 is a modbus peripheral device which features 6x 24VDC 30A relays.

Getting Started

Using TS-ARM Products

Our TS-ARM products use Debian Linux which can use Modbus to communicate with the TS-1400. We have created a patch to libmodbus to allow guaranteed timing which is available here. For ARMEL(EABI) compatible systems we have debian package here.

To install this on a board, connect it to the internet and run these commands:

wget ftp://ftp.embeddedarm.com/ts-modbus/libmodbus_3.0.3-1_armel.deb
dpkg -i libmodbus_3.0.3-1_armel.deb

This package includes both the library and the supporting headers needed for building libmodbus compatible examples. For other platforms other than OABI ARM you can use the sources provided by the libmodbus project.

Example Code

This code uses the patched libmodbus for xuart support communicating at 9600, 8n1, and with the default modbus address 247:

// TS-1400 Coil-toggle example.
// Written by Michael D Peters for Technologic Systems, Inc.
// Copyright March 22, 2013
//
// This code assumes six relays on a TS-1400 that is configured
// in legacy mode, 9600 baud, 8, N, 1, Device address 0xAC.
//
// This code assumes the use of the Technologic Systems XUART
// controller, xuartctl, and the appropriately modified version
// of Libmodbus.  Patch files available near here:
// http://forum.embeddedarm.com/
//
// These settings are modifiable in the #define block below.
//
// This program demonstrates both methods of setting coils on
// the TS-1400.
// First by setting coils using the holding register address.
// Second by setting individual coils using the write coil command.

#include <stdio.h>
#include <stdlib.h>
#include <modbus.h>
#include <errno.h>

#define DEVICE_ID 0xf7
#define SPEED 9600
#define PORT "127.0.0.1:7350"
#define RELAY_REGISTER 0x40

modbus_t *mb;

int main(int argc, char* argv[])
{
	int c = 0;

	// modbus setup
	mb = modbus_new_rtu(PORT, SPEED, 'N', 8, 1);
	if(!mb){
		fprintf(stderr, "Unable to open bus at port %s.\n", PORT);
		return 0;
	}

	modbus_set_debug(mb, (argc > 1));
	modbus_set_slave(mb, DEVICE_ID);
	modbus_connect(mb);

	// Demo functions
	printf("Ticking relay pattern...\n");
	c = set_multiple_relays();
	if(c == -1){
		return 0; // error output by function.
	}

	printf("Ticking individual relays...\n");
	c= set_single_relay();
	if(c == -1){
		return 0; // error output by function.
	}

	return 0;
}

// throws relays in a 24 position countup -- that's 64 iterations.
// returns -1 and prints stderr if there was a problem, 
// returns 1 if no trouble was detected.
int set_multiple_relays()
{
	uint16_t c = 0;
	int d = 0;
	for(c = 0; c < 64; c++){
		d = modbus_write_register(mb, RELAY_REGISTER, c);
		usleep(100000);
		if(d == -1){
			fprintf(stderr, "Problem with write.  Error %d: %s", 
				errno, modbus_strerror(errno));
			return -1;
		}
	}
	return 1;
}

// Throws relays individually using the write relay modbus command.
// Throws each relay on and then off in sequence.
// Returns -1 if error condition and writes an error to stderr.  Returns 1 otherwise.
int set_single_relay()
{
	int c = 0;
	int d = 0;
	d = modbus_write_register(mb, RELAY_REGISTER, 0);
	while(c<6){
		d = modbus_write_bit(mb, c, 0xffff);
		usleep(1000000);
		d = modbus_write_bit(mb, c++, 0x0);
		if(d == -1){
			fprintf(stderr, "Problem with write.  Error %d:  %s", 
				errno, modbus_strerror(errno));
			return d;
		}
	}
	return 1;
}

To compile and run this as test.c:

gcc `pkg-config --libs --cflags libmodbus` test.c -o test
./test

Power Requirements

The TS-1400 requires 0.435W under normal operation, and approximately 1.6W for each active relay.

Features

TS Modbus Support

When using all Technologic Systems Modbus devices we include functionality to create an arbitrary chain of stock peripherals to automatically enumerate all connected devices, configure them, and generate an I/O map of all connected devices.

TS Modbus Autoconfiguration

The autoconfiguration works by using the optional mode pin on the RJ45 connector as designated in the MODBUS-2W standard. Technologic Systems uses this to indicate if it is a TS device. If it is asserted (low) to a TS device, then it will allow access to the #Holding Registers at address 0xf7.

This will identify the TS Modbus device model, set the first device in the chain to the user specified slave address (default is 0x10), and assert the mode line to the next port to enumerate the next device. The next device address is incremented by 1, and the process is repeated until no slave responds to a read query (timeout)indicats that no additional devices are connected to the bus chain. At this point the last device in the chain is configured to enable bus termination on the RS485 link, and all devices have their bit rates set to the user selected bit rate (default is 9600).

Register Interface

Holding Registers

The interface to all Modbus peripheral devices consists of a set of 127 holding registers. These registers are used to configure the device operation, read and write input output parameters, as well as various settings used to configurable Modbus Address, Termination enable, Data Format, and Bit Rate. These settings are common to all of our Modbus peripherals and can be persisted in on-board flash memory.

NOTE: The device operates ONLY in Modbus RTU communications mode. Modbus ASCII is not presently supported.

Address (hex)	Address (dec)	Access	Description	Example Values
0x70	112	Read/Write	Modbus Mode	0 = ASCII (unimplemented), 1 = RTU
0x71	113	Read/Write	RS485 Bus Termination Enable	0 = Termination disabled, 1 = Termination enabled
0x72	114	Read/Write	Modbus Device Address	0-247 (0x00-0xf7) 0 = Broadcast
0x73	115	Read/Write	Modbus bit rate	Bit Rate
0x74	116	Read Only	Unit Model	e.g., 0x1400, 0x1700, 0x1800, etc
0x75	117	Read Only	Verilog Version	e.g., 1
0x76	118	Read Only	ZPU Version	e.g., 1
0x77	119	Read Only	Bus power Supply in millivolts	e.g., 23600
0x78	120	Read Only	Internal Temperature in 1/100th degree Celsius	e.g., 290
0x79	121	Read/Write	Reserved or model specific	Not applicable or model specific
0x7a	122	Read/Write	Reserved or model specific	Not applicable or model specific
0x7b	123	Read/Write	Reserved or model specific	Not applicable or model specific
0x7c	124	Read/Write	Reserved or model specific	Not applicable or model specific
0x7d	125	Read/Write	Write listed value to persist communications (Bit rate, Data format, Address, and Termination) parameters to internal nonvolatile storage:	0xFEED = Persist configuration, 0xDEAD = Erase configuration, 0xC0DE apply configuration without persistence. In all cases the value is set to zero when completed or 0xFA17 (FAIL) if error.
0x7e	126	Read/Write	Reserved or model specific	Not applicable or model specific

NOTE: All Read Only registers may be written; however, writing to certain registers (e.g., Unit Model) will overwrite the information that will not be refreshed until the unit is reset.

Baud Rate

The TS-1400 supports 15 speeds:

Value	Communication Bit Rate	Maximum CAT5 Cable Length
0	300	1200 meters
1	600	1200 meters
2	1200	1200 meters
3	2400	1200 meters
4	4800	1200 meters
5	9600	1200 meters
6	19.2K	1200 meters
7	38.4K	1200 meters
8	57.6K	1200 meters
9	115.2K	800 meters
10	230.4K	400 meters
11	460.8K	200 meters
12	1040K	100 meters
13	2080K	40 meters
14	4160K	20 meters

Operating Registers

Coil addresses correspond to the appropriate relay (coil 0 == CN1). Holding Register 0x40 is read/write and always reflects the current status of each coil in the first six bits: Holding Register 0x40 bit 0:5 == Coil Register 0... 5 == Physical Relay 1... 6.

Address (hex)	Address (dec)	Access	Description
COIL 0x0	0	Read/Write	Relay 0 (1 NO, 0 NC)
COIL 0x1	1	Read/Write	Relay 1 (1 NO, 0 NC)
COIL 0x2	2	Read/Write	Relay 2 (1 NO, 0 NC)
COIL 0x3	3	Read/Write	Relay 3 (1 NO, 0 NC)
COIL 0x4	4	Read/Write	Relay 4 (1 NO, 0 NC)
COIL 0x5	5	Read/Write	Relay 5 (1 NO, 0 NC)
COIL 0x6	6	Read/Write	Relay 6 (1 NO, 0 NC)
HOLDING 0x40	64	Read/Write	Bits 0:5 correspond with Relay 1-6

Connectors

2x RJ45

Both RJ45 ports, and all of our Modbus based devices are designed to be compatible with 2W-MODBUS RJ45 following this pinout:

Product Notes

FCC Advisory

This equipment generates, uses, and can radiate radio frequency energy and if not installed and used properly (that is, in strict accordance with the manufacturer's instructions), may cause interference to radio and television reception. It has been type tested and found to comply with the limits for a Class A digital device in accordance with the specifications in Part 15 of FCC Rules, which are designed to provide reasonable protection against such interference when operated in a commercial environment. Operation of this equipment in a residential area is likely to cause interference, in which case the owner will be required to correct the interference at his own expense.

If this equipment does cause interference, which can be determined by turning the unit on and off, the user is encouraged to try the following measures to correct the interference:

Reorient the receiving antenna. Relocate the unit with respect to the receiver. Plug the unit into a different outlet so that the unit and receiver are on different branch circuits. Ensure that mounting screws and connector attachment screws are tightly secured. Ensure that good quality, shielded, and grounded cables are used for all data communications. If necessary, the user should consult the dealer or an experienced radio/television technician for additional suggestions. The following booklets prepared by the Federal Communications Commission (FCC) may also prove helpful:

How to Identify and Resolve Radio-TV Interference Problems (Stock No. 004-000-000345-4) Interface Handbook (Stock No. 004-000-004505-7) These booklets may be purchased from the Superintendent of Documents, U.S. Government Printing Office, Washington, DC 20402.

Limited Warranty

See our Terms and Conditions for more details.