Devantech dS2824 User manual

dS2824 dS2824 User Manual v4.09
dS2824
dS2824
User Manual Version 4.09
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 1

dS2824 dS2824 User Manual v4.09
Table of Contents
Do umentation history.................................................................................................................4
A qui k look...............................................................................................................................5
Introdu tion...............................................................................................................................6
Getting started...........................................................................................................................7
Lo ating the IP Address...............................................................................................8
Configuring the dS2824.............................................................................................................10
Status page.............................................................................................................11
Network page...........................................................................................................12
TCP/IP page.............................................................................................................13
Webpage se urity.....................................................................................................15
Configuring relays.....................................................................................................17
Relay automation.....................................................................................................18
Input/Output onfiguration........................................................................................21
Conne ting I/O to Virtual Relays.........................................................................................22
Pinging remote ma hines...........................................................................................23
Repeat Time....................................................................................................................23
Attempts.........................................................................................................................23
Delay..............................................................................................................................24
Ping Time........................................................................................................................24
Rebooting the target ma hine.............................................................................................24
Email notifi ations....................................................................................................25
Peer to Peer.............................................................................................................26
Sequen er...............................................................................................................27
Sequen er ommands.......................................................................................................28
K Outputs........................................................................................................................29
Sequen er Examples.........................................................................................................29
S hedules................................................................................................................34
Counter/Timers........................................................................................................36
The appli ation page..................................................................................................................39
Appli ation page se urity...........................................................................................40
A essing your webpage from the internet...................................................................41
Boolean equations.....................................................................................................................42
TCP/IP ommand sets................................................................................................................44
ASCII ommand set..................................................................................................44
Binary ommand set.................................................................................................46
AES binary ommand set...........................................................................................49
Modbus ommands...................................................................................................51
Fun tion 01 (0x01) Read Coils............................................................................................51
Fun tion 04 (0x04) Read Input Registers..............................................................................51
Fun tion 05 (0x05) Write Single Coil....................................................................................52
Fun tion 15 (0x0F) Write Multiple Coils................................................................................52
Error ode 1.....................................................................................................................52
Error ode 2.....................................................................................................................52
Error ode 3.....................................................................................................................52
Modbus Gateway......................................................................................................52
Loading the appli ation firmware.................................................................................................53
Erasing old onfiguration settings...............................................................................55
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 2

dS2824 dS2824 User Manual v4.09
dS2824 hardware......................................................................................................................56
LED indi ation..........................................................................................................57
Power supply...........................................................................................................57
Operating temperature..............................................................................................57
Power relays............................................................................................................58
Analogue/Digital flexible I/O's....................................................................................59
Conne tion examples.................................................................................................................59
Temperatue sensor...........................................................................................................60
Power supply input voltage................................................................................................60
Analogue hannels............................................................................................................60
Serial port onne tions..............................................................................................62
dS2824 dimensions...................................................................................................................63
Notes...................................................................................................................................... 64
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 3

dS2824 dS2824 User Manual v4.09
Documentation history
v4.01 Major update to the underlying dS ript, now with fun tions and lo al variables.
Added “From Address” for easymail emails.
v4.02 Bug fixes for the underlying dS ript.
v4.03 Editor update, added support for multiple editor tabs.
Compiler update, added support for multiple files in proje t.
Compiler update, added support for #ifdef, #else, #endif
v4.04 TCP server so ket now transmits keepalives when onne tions be ome dormant
for 10 se onds. 6 una knowledged pa kets at 10 se ond intervals will result in
port losure.
V4.05 Added phone app support (IO Network 2 on the App stores). Fixed bug that aused
intermittent module not found error on firmware update.
V4.06 Added system reboot button to onfig status s reen.
dS ript updated to support dS2832. See dS ript-v4.xx manual.
V4.07 Added new features:
Ping Used to ping other ma hines to he k if responding.
Sequen er Added a 120 step, 12 output sequen er
v4.08 Added display of MAC address to network onfiguration page.
Bugfix – NTP (Real time lo k) startup failed under some ir umstan es.
Renamed ommand “ ounters” to “set ounters”.
V4.09 Added 3 new ommands to Binary and AES Binary ommand set, to
ontrol all relays in one ommand. Set all, set sele ted and lear sele ted.
Note: If you have a ustom app based on app-dSxxxx-v4-07 or earlier, you will need to re-
name the “ ounters” ommand to “set ounters” for it to ompile with this version.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 4

dS2824 dS2824 User Manual v4.09
A quick look
Ethernet onne ted module, 10/100Mb auto negotiated.
Relays – 24 x 16Amp 250Va C/O.
I/O – 8 x flexible I/O's NPN output, Volt free input or 12-bit analogue input.
Power – 12VDC 1.5Amp supply required. 2.1mm enter positive.
Conne tions – S rew Terminals for N/O N/C and Common onta ts
PCB size – 249mm x 123mm
Controlled graphi ally by se ure webpage or optionally one of ASCII, Binary or Modbus om-
mand 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. 10 ounts/se ond Max.
Also available when optionally programming in dS ript is a TTL level serial port and an RS485
serial port.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 5

dS2824 dS2824 User Manual v4.09
Introduction
The dS2824 is an Ethernet onne ted relay module featuring 24 hannels of 16Amp 250Va re-
lays. 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 dS2824 has 8 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 12-bit inputs using a 4.096v referen e (0v-4.096v input range).
5. Analogue 12-bit inputs using a 5v referen e (0v-5v input range).
The dS2824 requires a 12v 1.5Amp power supply su h as this one:
http://www.robot-ele troni s. o.uk/universal-12vd .html
The dS2824 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, 5 and 15 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 program-
ming 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 sup-
port pa kage.
You do not need to use dS ript at all, but its great to know its there - just in ase you do.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 6

dS2824 dS2824 User Manual v4.09
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://dS2824/index.htm
You should now see the appli ation webpage and you an ontrol relays and I/O's.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 7

dS2824 dS2824 User Manual v4.09
Locating the IP Address
If you are not using a windows PC then you will need to find the IP address of the module.
The simplest method is onne t the module (Ethernet, USB then lastly, Power) and load up the
dS ript editor.
Go to Module Sele t Port and make sure the orre t serial port is sele ted as illustrated above.→
Now go to Module IP Address and the urrent IP address is displayed.→
Make sure the Ethernet is onne ted before you apply power. If you plug the Ethernet able in
after the power, the module will already have booted with a default IP address.
Alternatively, if you have a DHCP server on your network (your router is normally the DHCP
server) then the dS2824 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.9/index.htm
into your browser address bar and you should see the appli ation webpage shown on the pre-
vious page.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 8

dS2824 dS2824 User Manual v4.09
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
If you do not have a DHCP server the dS2824 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
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 9

dS2824 dS2824 User Manual v4.09
Configuring the dS2824
There are a set of onfiguration pages to get the dS2824 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 a-
ble 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.9/_ onfig.htm
(substituting your IP address)
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 10

dS2824 dS2824 User Manual v4.09
Status age
You should now see the following page:
This status page shows you the system and appli ation firmware revisions as well as the sup-
plied 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.
The system reboot button should be used with aution. If the module is at a remote site and
you hange the IP address, you may not be able to rea h it again.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 11

dS2824 dS2824 User Manual v4.09
Network age
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 mod-
ule 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.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 12

dS2824 dS2824 User Manual v4.09
TCP/IP age
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 test
appli ations written in C# and Java to demonstrate AES en ryption.
Phone App onfiqures the module for ontrol with our “IO network 2” app, available on
iTunes/Play store. Password is an 8 hara ter password used only with the App. Change this to
a password of your hoi e and use the same password on your phone.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 13

dS2824 dS2824 User Manual v4.09
When sele ting the Modbus ommands, an additional set of onfiguration boxes are available.
These allow you to sele t the UID, normally you will leave this at the default of 1. The dS2824
will respond to ommands on this UID. If you send any other UID it will be treated as the ad-
dress of a Modbus module onne ted to the RS485 port. Commands to other UID’s will be on-
verted to Modbus RTU format and sent out on the RS485 port. Any responses will be onverted
ba k to Modbus/TCP format and returned to you.
The se ond box sele ts the baud rate of the Modbus RTU line and the third box sele ts even,
odd or no parity.
The Modbus ommand set implements fun tions 1, 4, 5 and 15.
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.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 14

dS2824 dS2824 User Manual v4.09
Web age 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 har-
a 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.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 15

dS2824 dS2824 User Manual v4.09
When the “Update Pending” light goes out, re-boot the module and go to
yourIP/_pw.htm
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
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 16

dS2824 dS2824 User Manual v4.09
Configuring relays
The next two tabs allow you to set the names of the 32 relays that will be displayed on the ap-
pli ation page.
Use the Relay No. box to sele t the relay to onfigure. There are 32 relays available. Relays 1-
24 are the physi al relays on the module. Relays 25-32 are virtual relays, they have no physi-
al presen e but otherwise behave the same as the real ones. I/O lines may be linked to vir-
tual relays to provide additional physi al outputs, see next se tion for details.
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 1 as “YardLights” and those 10 hara ters are a
omfortable size on a verti al phone s reen.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 17

dS2824 dS2824 User Manual v4.09
Relay automation
There are a set of ontrol boxes that provide for autonomous relay operation. If you just want
to ontrol the relays from the webpage or using one of the TCP/IP modes, then leave these
boxes blank.
Relay No. box
This sele ts the relay you wish to onfigure. There are 32 relays available. The first 24 relays
are the a tual relays on the module. Relays 25-32 are virtual relays. They have no physi al
presen e but otherwise behave identi ally to the real ones. They an provide additional pro-
essing and a larger ontrol surfa e to your appli ation.
Pulse/Follow box
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 box. Boolean equations are just simple
equations that evaluate to a 0 or 1.
For example Relay 1 is referred to a R1. Input1 is referred to as D1 (Digital 1). Analogue input
1 is referred to as A1.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 18

dS2824 dS2824 User Manual v4.09
Here's a very simple example:
Enter R2 into the Relay 1 Pulse/Follow box. This will make relay 1 opy whatever you do to Re-
lay 2. Try it!
Now hange it to !R1.
The ex lamation mark is read as “Not R1”. Now relay 1 will always be the opposite of relay 2.
Try it.
Boolean equations may be used for ontrolling relays and other obje ts su h as email.
See the “Boolean equation” se tion later in this manual for full do umentation.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 19

dS2824 dS2824 User Manual v4.09
Set Reset & Toggle boxes
When used, these three ontrols ontain boolean equations. The “Set Relay” box will set the
relay when the boolean equation be omes true. The other two boxes reset and toggle the relay
when the boolean equation be ome true.
This is important! The Set, Reset and Toggle ontrols are transitory (edge triggered) ontrols.
The relays are only affe ted at the moment the boolean equation be omes true. This differs
from the Follow box where the relay ontinuously follows the output state of the equation.
In the previous example where we pla ed R2 in relay 1’s Follow ontrol, relay one will always
be the same as relay 2. If relay 2 is off and we li k relay 1 (YardLights) nothing will happen.
However if we want relay1 to be ontrolled by relay 2 as above, and also want to be able to
toggle it on/off from the webpage, we an put R2 in the “Set Relay” box and !R2 in the “Reset
Relay” box.
Try it.
Power-up restore
When he ked, the relay is restored to the previous state it had when power was lost. If the
relay was on when power was lost or the module was turned off, then the relay will be turned
on when the module is powered up again.
Copyright © 2016-2021, Devante h Ltd.
All rights reserved. www.robot-ele troni s. o.uk 20