Devantech Ds378 User manual

dS378

dS378 User Manual v2.19

dS378

User Manual Version 2.19

www.pishrobot.com

dS378

dS378 User Manual v2.19

Table of Contents

Do umentation history....................................................................................................3

A qui k look...................................................................................................................4

Introdu tion..................................................................................................................5

Getting started...............................................................................................................6

Configuring the dS378....................................................................................................8

Status page...............................................................................................................9

Network page...........................................................................................................10

TCP/IP page.............................................................................................................11

Webpage se urity.....................................................................................................12

Naming relays..........................................................................................................14

Relay automation.....................................................................................................15

Naming I/O's...........................................................................................................16

Email notifi ations....................................................................................................17

Peer to Peer.............................................................................................................18

S hedules................................................................................................................19

Counter/Timers........................................................................................................21

The appli ation page.....................................................................................................24

Appli ation page se urity...........................................................................................25

A essing your webpage from the internet...................................................................26

Boolean equations........................................................................................................27

TCP/IP ommand sets...................................................................................................29

ASCII ommand set..................................................................................................29

Binary ommand set.................................................................................................31

AES binary ommand set...........................................................................................33

Modbus ommands...................................................................................................35

Fun tion 01 (0x01) Read Coils................................................................................35

Fun tion 04 (0x04) Read Input Registers.................................................................35

Fun tion 05 (0x05) Write Single Coil.......................................................................35

Error ode 1.........................................................................................................36

Error ode 2.........................................................................................................36

Error ode 3.........................................................................................................36

Loading the appli ation firmware....................................................................................37

dS378 hardware...........................................................................................................39

LED indi ation..........................................................................................................40

Power supply...........................................................................................................40

Operating temperature..............................................................................................40

Power relays............................................................................................................41

Analogue/Digital flexible I/O's....................................................................................42

Conne tion examples................................................................................................42

Serial port onne tions..............................................................................................44

dS378 dimensions........................................................................................................45

Notes..........................................................................................................................46

www.pishrobot.com

dS378

dS378 User Manual v2.19

Documentation history

V2.18 First release of separate dS378 manual

V2.19 Added new features:

Peer to Peer Use events to ontrol relays on another dSxxxx module.

S hedules Create regular timed events

Counters Count input transitions or se onds

www.pishrobot.com

dS378

dS378 User Manual v2.19

A quick look

Ethernet onne ted module, 10/100Mb auto negotiated.

Relays – 8 x 16Amp 250Va C/O.

I/O – 7 x flexible I/O's NPN output, Volt free input or 10-bit analogue input.

Power – 12VDC 1Amp supply required. 2.1mm enter positive.

Conne tions – S rew Terminals for N/O N/C and Common onta ts

PCB size – 156mm x 84mm

Controlled graphi ally by se ure webpage or optionally one of ASCII, Binary or Modbus

ommand sets over TCP/IP.

Email notifi ations – 8 sele table notifi ations, up to 100 emails/hour max.

Peer to Peer – Control relays on other modules.

S hedules – Able to s hedule events based on time of day/week

Counter/Timers – Count or time events. 20 ounts/se ond Max.

Also available when optionally programming in dS ript are two TTL level serial ports and an

RS485 serial port.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Introduction

The dS378 is an Ethernet onne ted relay module featuring 8 hannels of 16Amp 250Va

relays. Ea h relay has both normally open (NO) and normally losed (NC) as well as the

ommon available on three terminals.

In addition to the relays, the dS378 has 7 flexible I/O hannels whi h may be individually

onfigured to be:

1. NPN transistor output.

2. A tive low input with pull-up (allows dire t onne tion of volt free onta ts).

3. A tive low input without pull ups (easy to onne t logi level inputs).

4. Analogue inputs (0v-3.3v input range).

The dS378 requires a 12v 1Amp power supply su h as this one:

http://www.robot-ele troni s. o.uk/universal-12vd .html

The dS378 has four built in ontrol methods.

Primary ontrol method is graphi ally by using its built in se ure website.

Se ondary ontrol may be one of:

ASCII - type in ommands via a program su h as PuTTY.

Binary - Command set using binary odes

Modbus – Fun tions 1, 4 and 5 supported

And if you should wish to modify the supplied firmware – you an.

Behind the s enes there is dS ript, a powerful multi-threaded operating system and

programming language. The supplied firmware is written in dS ript as well as HTML, CSS and

Javas ript on the webpages and the full sour e is in the separately down-loadable dS ript

pa kage.

You do not need to use dS ript at all, but its great to know its there - just in ase you do.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Getting started

Start by plugging in the Ethernet able to onne t the module to your network, and the 12v

ja k plug from your adapter. Swit h on and the first thing you will note is that the blue LED will

flash 3 times. This indi ates that the ontrol firmware is loaded on the module. (If the blue led

does not flash you will need to load in the control firmware. Don't worry, this is very easy to

do. Just go to the chapter on installing the firmware and follow the instructions there).

If you are using a Win7/8/10 PC, open your browser and into the address bar (not the sear h

bar) type:

http://dS378/index.htm

You should now see the appli ation webpage and you an ontrol relays and I/O's.

www.pishrobot.com

dS378

dS378 User Manual v2.19

If you are not using a windows PC then you will need to find the IP address of the module. If

you have a DHCP server on your network (your router is normally the DHCP server) then the

dS378 will get its IP address from that. Log on to your router and navigate to the LAN lient

list.

Above is the entry from our ASUS RT-N66U router. So now you type:

192.168.0.90/index.htm

into your browser address bar and you should see the appli ation webpage shown on the

previous page.

If you prefer, you an download a java program that will run on Windows, MAC or Linux, and

will list all of our modules that are onne ted to your LAN. Devante hModuleFinder.jar

www.pishrobot.com

dS378

dS378 User Manual v2.19

If you do not have a DHCP server the dS378 will use a default IP address of 192.168.0.123 so

make sure your PC is on the same subnet of 255.255.255.0 and its IP address is

192.168.0.xxx

Configuring the dS378

There are a set of onfiguration pages to get the dS378 operating as you want it. These pages

are all _ onfigx.htm, (that's a leading unders ore hara ter).

ie.

_ onfig.htm

_ onfig2.htm

Anything that starts with _ onfig is onsidered a spe ial name for onfiguration pages and an

only be seen if you have the the USB able plugged in and onne ted to your PC.

Why only if the USB able is plugged in?

Its an additional se urity measure. After you have onfigured and deployed the module, you

really don't want these onfiguration pages available for others to hange. So with the USB

able dis onne ted the _ onfig pages are not available. If you try to a ess them you just get

served a “not authorised” page instead.

So for now, you do want to look over the onfig pages. If you have a Win10, Linux or MAC PC,

you an go right ahead and plug in the USB able. These ma hines will install their own USB

drivers. We won't be sending anything to the board, its just the presen e of the USB

onne tion that enables the onfig pages to be served. If you have a Win7 or Win8 PC you will

need to install the drivers. (go to the chapter on installing the firmware and follow the

instructions there).

With the USB able onne ted, browse to:

192.168.0.90/_ onfig.htm

(substituting your IP address)

www.pishrobot.com

dS378

dS378 User Manual v2.19

Status page

You should now see the following page:

This status page shows you the system and appli ation firmware revisions as well as the

supplied voltage to the board and its internal temperature.

If you hover your mouse ursor over the menu buttons on the left, the help panel will give you

an overview of ea h one.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Net ork page

Noti e that everything below the Host Name is greyed out and an't be hanged. This is

be ause the “Enable DHCP” box is he ked and all the greyed out fields are supplied by the

DHCP server. Although a qui k way to get you onne ted, we really do not re ommend this as

the DHCP server an assign a different IP ea h time you power up. If you want to ontrol this

module from the internet while you are away from the premises then you will be setting up

port forwarding on your router whi h requires a fixed IP address.

So lets do that first.

Un he k the DHCP box and you an then set all the other fields. Noti e that the Red “Update

Pending” light omes on. It indi ates there are hanges whi h have not yet been written to the

flash memory. It will go off again 5 se onds after you stop hanging anything.

Choose an IP address for the module, something outside of the DHCP settings on your router

so it will not assign anything to that address.

The subnet mask, Gateway and DNS an all be left as the defaults.

Network hanges only take effe t after the next re-boot, so wait until the “Update Pending”

light goes out and give the reset button on the module a qui k press. The Green Led will light

and the Blue led will flash 3 times. You will now find the module at your new IP address. If the

Red led omes on after you press the reset button, its be ause you pressed it for too long (and

entered bootloader mode). Just have another go with the reset button for a bit less time.

Your browser won't know you have hanged the IP address so it will still be showing the old,

now dead page. Make sure you hange to your new IP address and load the page again.

www.pishrobot.com

dS378

dS378 User Manual v2.19

TCP/IP page

The TCP/IP tab allows you to sele t one of three ommand sets to ontrol the module. These

are independent of, and separate to the HTML webpage ontrol.

Cli king on one of the four he k boxes will sele t that ommand set. Only one ommand set

may be sele ted. You an disable all TCP/IP ommand sets by li king on an already sele ted

box.

The ASCII ommand set is text based. You an use any program that an send text over

TCP/IP. We use PuTTY in raw mode. The Binary ommand set operates in a similar way to our

ETHxxx range of boards (but uses different ommands), by sending binary ommands to the

module. AES Binary adds en ryption. Note the AES key MUST be 32 bytes long. We have a test

appli ations written in C# and Java to demonstrate AES en ryption. The Modbus ommand set

implements fun tions 1, 4 and 5.

When sele ting the Modbus ommand set, make sure you sele t port 502 whi h is the offi ial

port number for Modbus over TCP/IP.

A full des ription of the ommands is in the “Command Sets” se tion later in this manual.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Webpage security

Allows you to prevent unauthorised personnel from a essing the appli ation webpage or using

it to ontrol the module.

Leaving the Se urity Password blank will disable it and allow everyone to a ess the appli ation

page to ontrol the module.

To enable password prote tion enter a password into the Password box. You an use any

hara ters from the ASCII hara ter set from 0x20 to 0x7E ex ept “ (0x22). It may be up to

200 hara ters long and you don't have to memorise it, so make it a long one with plenty of

upper ase, lower ase, numbers and symbols.

A essing a spe ial webpage, _pw.htm, will install the password on your browser. To do this

make sure the Enable _pw.htm box is he ked.

When the “Update Pending” light goes out, re-boot the module and go to

yourIP/_pw.htm

www.pishrobot.com

dS378

dS378 User Manual v2.19

You will see something like this:

The password is now loaded on your browser. Do the same for any further browsers you want

to enable. When you have done un he k the “Enable _pw.htm” box to prevent anyone else

from loading the password. When the “Update Pending” light goes out re-boot the module

again.

The default port used by html webpages is 80. You an hange this if required. If you do so

then you will need to in lude the port number in the address.

If you hange the port to 2345 then the webpage will be at:

YourIP:2345/index.htm

For example:

192.168.0.123:2345/index.htm

www.pishrobot.com

dS378

dS378 User Manual v2.19

Naming relays

The next tab allows you to set the names of the 8 relays that will be displayed on the

appli ation page.

Names may be up to 20 hara ters long, but keep them shorter if you want to use a phone as

the ontroller. Here we have renamed relay 4 as “YardLights” and those 10 hara ters are

about the limit on a verti al Galaxy S6 s reen.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Relay automation

The box to the right of the relay name box is used to give a little automation to the relay.

Leave this blank (or zero) for normal operation, that is just toggling the relay on/off from the

button on the appli ation page.

If you pla e a number in this box then that is the pulse time for the relay in mS (1000mS = 1

se ond). The minimum value is 100mS. The maximum is 2147483647 (more than 24 days).

When the relay is toggled on timing begins and at the end of the time period the relay goes off

again. If the button is pressed again during timing then the timing is restarted.

The above example will turn off the yard lights after 30 minutes. 1800000 mS is 1800 se onds.

1800 se onds is 30 minutes.

It also possible to insert a boolean equation into the automation box. Boolean equations are

just simple equations that evaluate to a 0 or 1.

For example Relay 1 is referred to a R1. I/O1 is referred to as D1 (Digital 1). Analogue input 1

is referred to as A1.

Here's a very simple example:

Enter R1 into the Relay 2 automation box. This will make relay 2 opy whatever you do to

Relay 1. Try it!

Now hange it to !R1.

The ex lamation mark is read as “Not R1”. Now relay 2 will always be the opposite of relay 1.

Try it.

Boolean equations are used for ontrolling relays and also to trigger email notifi ations.

See the “Boolean equation” se tion later in this manual for full do umentation.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Naming I/O's

The I/O Names tab is used to assign meaningful names to the I/O terminals.

As with relay names these may be up to 20 hara ters long, but do he k it looks ok on a

mobile devi e or whatever you are using to ontrol the module.

The I/O types box allows you to sele t the type of I/O you want.

The two digital modes are the same ex ept for “Digital No-Pullup” the passive pullup resistor is

turned off and for “Digital With Pullup” it is turned on. The no-pullup option is useful for

onne ting to digital ir uits (3.3v or 5v) that supply the input voltage. The with pullup option

turns on a weak pull up to 12v (a tually nearer 7-8v be ause of the input design). This is

useful for dire tly onne ting volt free onta ts su h as relay onta ts or swit hes. They are

onne ted between the pin (P) and ground (0v).

To use as inputs, make sure the output drive is off or the NPN transistor will drive the output

low. The NPN transistor an sink about 100mA.

The analogue mode onverts the input voltage to a digital number in the range 0-1023 (10-bit

onversion). The input voltage range is 0-3.3v.

When you have hanged I/O types wait for the “Update Pending” light to go out and press the

reset button, as new I/O modes are set on power-up.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Email notifications

The final onfiguration tab is the Email tab for sending se ure, AES en rypted email

notifi ations from the module.

Up to eight (8) email notifi ations may be set up, sele ted by the eight radio buttons.

Setting up emails is qui k and easy. You just need the re ipients email address, a notifi ation

message whi h will be the email subje t line and the trigger event.

The trigger event uses the same boolean equation solver as the relay automation. So if you

want to trigger an email when digital input 1 (I/O1) be omes a tive, just enter D1.

The email message is automati ally filled in with useful information on the state of the relays,

I/O's et .

Boolean equations are used for ontrolling relays as well as triggering email notifi ations.

See the “Boolean equation” se tion later in this manual for full do umentation.

Note - Email notifi ations are limited to 100/hour.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Peer to Peer

This tab allows you to onfigure events on this module to ontrol relays on another.

Up to eight (8) Peer to Peer events may be set up, sele ted by the eight radio buttons.

Control of the target relay is by using the binary ommand set only. This an optionally use

AES en ryption. The Target module must be set to either Binary or AES Binary mode on its

TCP/IP tab, and this “Use AES” he kbox set to mat h.

The input box sele ts the event that will be used to ontrol the target relay. This an be as

simple as an input, or a omplex Boolean equation. See the “Boolean equation” se tion later in

this manual for full do umentation.

Target IP, Port & Relay No should be set to lo ate the target relay.

Target a tion determines how the relay will be ontrolled.

0 – No a tion, this Peer to Peer event is disabled.

1 – Follow Me, the relay will follow the input, (or the Boolean result of any equation here).

2 – Set Relay, the relay will be set by this event. You will need another P2P event to reset it.

3 – Reset Relay, the relay will be reset by this event. You will need another P2P event to set it.

4 – Toggle Relay, this will toggle the relay ea h time the event is triggered.

100+ - Pulse relay, Pulse times are in mS. (1000mS=1Se ond).

5-99 will have no a tion.

www.pishrobot.com

dS378

dS378 User Manual v2.19

Schedules

The s heduler an s hedule regular events. These an be on e or twi e daily with the two start

and stop times and an happen on any sele ted weekdays.

The S hedule No. is one of eight s hedules that an be set up. These are sele ted with the

eight radio buttons at the bottom of the s reen.

The target relay is the lo al relay that you want this s hedule to ontrol.

W/Days sele ts the days of the week you want this s hedule to ontrol the relay. When

highlighted in red, the weekday is a tive.

There are two sets of Start and Stop times for ea h of the eight s hedules. The relay is set

when the start time transitions from ina tive to a tive, ie. at the start time, and reset when

the stop time is rea hed. It is not held on or off. It an be hanged by other events in luding

the webpage buttons.

The urrent time originates from an internet time server. It is read only and annot be

hanged. Therefore you must have an internet onne tion for the s heduler to operate

orre tly.

www.pishrobot.com

dS378

dS378 User Manual v2.19

The timezone allows you to set the time for your lo ation.

For example;

GMT leave this at 0.

CET set this to 1.

PST set this to -8

IST set this to 5:30

Daylight saving time may be he ked if required. It advan es the time by 1 hour between the

last Sunday in Mar h and the last Sunday in O tober.

As well as ontrolling a relay dire tly, s hedules may also be used in the boolean equation

fields of other ontrols. A relay ould be ontrolled by pla ing S1 (for s hedule 1) in its

automation field.

www.pishrobot.com

Table of contents

Other Devantech Relay manuals

Devantech

Devantech dS3484 User manual

Devantech

Devantech ETH8020 Guide

Devantech

Devantech dS2832 User manual

Devantech

Devantech ESP32LR20 User manual

Devantech

Devantech dS2824 User manual

Devantech

Devantech ESP32LR42 User manual

Devantech

Devantech ESP32LR88 User manual

Devantech

Devantech dS2824 User manual

Devantech

Devantech ESP32SR88 User manual

Devantech

Devantech tcp184 User manual

Popular Relay manuals by other brands

Watts

Watts ProMelt Contactor Pro CP-50 Instructions for installing

Viking

Viking LSR-1 Technical practice

Bogen

Bogen VAR1 quick start guide

Rockwell Automation

Rockwell Automation Allen-Bradley GuardMaster MSR55P Back EMF... user manual

Seg

Seg MRU3-1 manual

Westinghouse

Westinghouse HKB Installation, operation & maintenance instructions

LEGRAND

LEGRAND Wattstopper LMRC-611-16M quick start guide

Westinghouse

Westinghouse KV-1 instructions

White Rodgers

White Rodgers 124 Service instructions

AJAX

AJAX WallSwitch user manual

Lovato

Lovato TMM1 NFC user manual

Allen-Bradley

Allen-Bradley 140G-N quick start guide

Siemens

Siemens 3MU8400 Series operating instructions

Vega

Vega VEGAMIP R61 operating instructions

Circutor

Circutor RGU-10 MT manual

Omron

Omron G9SA - datasheet

Sulzer

Sulzer ABS CA 461 installation guide

FIBARO

FIBARO FGS-212 user manual

Devantech dS378 User manual

Popular Relay manuals by other brands