CAI Networks WebControl PLC User Manual

Download

WebControl

Programmable Logic

Controller

User Guide

Version: 3.2.17f

Hardware Version: 2.2.2

Firmware Version: 3.02.17f5

Firmware datastamp: 10/15/2013

Doc last modified: 11/1/2013

WebControlTM PLC User Guide Version 3.02.17f

Table of Contents

1 Introduction .......................................................................................................... 1

1.1 Scope ............................................................................................................ 1

1.2 Table of Definitions ....................................................................................... 1

2 WebControl

2.1 Power Supply Inputs ..................................................................................... 2

2.2 TTL Output Port ............................................................................................ 2

2.3 AUX Input Port .............................................................................................. 3

2.4 1-Wire Sensor Input ...................................................................................... 3

2.5 Humidity Sensor Input .................................................................................. 3

3 WebControl

3.1 Network Settings ........................................................................................... 5

3.2 Access Settings ............................................................................................ 6

3.3 I/O Setup ....................................................................................................... 8

I/O ................................................................................................. 2

PLC Web GUI Configuration ........................................................ 5

3.4 X10 RF Control ........................................................................................... 10

3.5 Output Control ............................................................................................ 11

3.6 Notification Setup ........................................................................................ 12

3.7 General Setup ............................................................................................. 15

3.8 Reset Setup ................................................................................................ 16

4 AUX System Inputs ............................................................................................ 17

4.1 Digital Inputs ............................................................................................... 17

4.2 Analog Inputs .............................................................................................. 18

4.3 DS1822/DS18B20 1 Wire Temperature Sensors ....................................... 18

4.4 Honeywell 4000 Series Relative Humidity Sensor ...................................... 19

4.5 Timers ......................................................................................................... 19

4.6 Direct Query System Inputs and Outputs ................................................... 20

5 Real Time Clock ................................................................................................. 21

5.1 Network Requirements to Use the NTP ...................................................... 21

5.2 Realtime Clock Use DS2417 ...................................................................... 21

6 WebControl

PLC Programming ...................................................................... 22

6.1 The Basics of PLC Programming ............................................................... 22

6.2 WebControl

6.3 WebControl

6.4 WebControl

PLC Instructions .................................................................. 23

PLC I/O Identifiers .............................................................. 27

PLC Examples ........................................................................ 30

6.4.1 Example 1 Set Output based on condition .......................................... 30

6.4.2 Example 2: Flash TTL output ............................................................. 31

WebControlTM PLC User Guide Version 3.02.17f

6.4.3 Example 3: Push Button Input Control Output ..................................... 32

6.4.4 Example 4: Send EMAIL ..................................................................... 32

6.4.5 Example 5, Parallel I/O ........................................................................ 33

6.4.6 Example 6, Sequential I/O ................................................................... 34

6.4.7 Example 7, Traffic Lights ..................................................................... 35

6.4.8 Example 8, Time based Control .......................................................... 36

6.4.9 Example 9, Battery Charger ................................................................ 39

6.4.10 Example 10, RFID reader and browser Control .................................. 40

6.4.11 Example 11, Bitwise Operation ........................................................... 41

6.4.12 Example 12, Angle Calculation ............................................................ 41

6.4.13 Example 13, Non-Blocking Delay ........................................................ 42

6.4.14 Example 14, Your Examples ............................................................... 42

7 WebControl

PLC FAQ .................................................................................... 45

7.1 Login and Configuration .............................................................................. 45

7.2 Temperature Sensor Support ..................................................................... 45

7.3 Turn on/off TTL output from another programming language ..................... 46

7.4 External Analog Chip DS2450 .................................................................... 47

7.5 Power Supply Requirement ........................................................................ 47

WebControlTM PLC User Guide Version 3.02.17f

Table of Figures

Figure 1.0 WebControlTM PCB inputs and outputs diagram ........................................ 2

Figure 2.0 WebControl

Figure 3.0 WebControl

Figure 4.0 WebControl

sensor connections ............................................................. 3

PLC system status .............................................................. 5

PLC Network configurable .................................................. 6

Figure 5.0 I/O setup .................................................................................................... 8

Figure 6.0 WebControl

Figure 7.0 WebControl

X10RF Control .................................................................. 10

Output Control .................................................................. 11

email setup ....................................................................... 13

Figure 8.0 Network defaults ...................................................................................... 15

Figure 9.0 WebControl

Figure 10.0 WebControl

J12 Input pins ................................................................... 17

Temperature sensor assignments .................................. 18

Figure 11.0 DS2417 layout ....................................................................................... 21

WebControlTM PLC User Guide Version 3.02.17f

1 Introduction

This document provides an overview of the technical aspects of using WebControlTM

PLC. It describes the inputs and outputs offered by the PLC version of the

WebControl

found in chapter 6 of this document. Function, usage and syntax as well as many

examples are provided there to help you get started. WebControl

from the earlier WebControl

flexibility in I/O control; but in return, expects user to learn programming concepts

and write an assembly like PLC program. A PLC program has the ability to read

write and compare values of the available inputs, outputs, variables and timers. With

a PLC program loaded and running, WebControl

without a network connection. The PLC programming module and programming

guide are provided for a learn-on-your own experience. Assistance in writing or

debugging PLC code is not provided as part of the regular technical support for

WebControl

hardware and firmware. The WebControl PLC Programming Guide is

PLC is different

BRE. The PLC version of firmware provides greater

PLC can operate on its own,

PLC configuration.

1.1 Scope

The scope of this document is to be a guide for configuring and using the features

provided by WebControl

. The reader is expected to be technically competent in all

the technical areas within this document, and is strongly advised to use this

document alongside the other reference material listed in the reference section.

1.2 Table of Definitions

The following table is a list of definitions used though out the document.

Definition

HTTP Hypertext transfer protocol DNS Domain name server SMTP Simple mail transport protocol SNTP Simple network time protocol 1-wire Special bidirectional serial data bus from Maxim RH Relative humidity NetBios Human readable name used as an alternative to an IP address for

IP Internet protocol DHCP Dynamic host configuration protocol ROM Read only memory PLC Programmable Logic Controller

Description

accessing the server on a network. E.g. http://WebControlTM

WebControlTM PLC User Guide Version 3.02.17f

2 WebControlTM I/O

The current hardware version of WebControlTM is equipped with a number of inputs and outputs; these are shown in below in figure 1.0.

Figure 1.0 WebControl

PCB inputs and outputs diagram

2.1 Power Supply Inputs

The DC power supply input is the electrical supply to the board. The recommended input voltage is 9V DC. Any voltage greater than 12V applied to this input may require adding heatsink to regulator, otherwise it may overheat.

2.2 TTL Output Port

The TTL logic level output port has 8 TTL outputs that can each be set or cleared using web GUI command codes, or by setting up a PLC using the available inputs, variables, and timers, so that the particular output is set when a particular condition is met. The maximum current that can be sourced or sinked by one of these outputs at a time is 20mA or 100mA for the whole board. TTL 0 level defined as 0-2V and TTL 1 level is define 3-5V with TTL 0 almost 0V and TTL 1 almost 5V depending on the

WebControlTM PLC User Guide Version 3.02.17f

load. TTL output current is capable to drive standard solid state relay, but will not be able to drive those coil based relays. Be aware of the current requirements of the circuits/loads attached to these outputs. Damage will occur to the board if too much current is allowed.

2.3 AUX Input Port

The AUX input connector offers digital and analog inputs that can be monitored or programmed to set a single TTL output or several TTL outputs. Three analog inputs are available, each have an input range of 0 to 10Vdc. Eight digital inputs are available and use TTL input levels (labeled as J12AUX in Figure 1) shows the layout of this port in more detail. The

matching connector for this port is TYCO ELECTRONICS - 1658622-3 .

(0 and 5Vdc). The AUX Input Port pin out diagram

2.4 1-Wire Sensor Input

The 1-wire sensor port allows up to eight Maxim DS1822/DS18B20/DS18S20 1-wire temperature sensors to be connected. It also allows one Maxim DS2417 real time clock, and one DS2450 4 channel A/D converter. The temperature and analog input can be displayed via the HTTP browser and can be used as inputs to the PLC engine to control the TTL output port. Since hardware revision 2.2.2 uses 5V to power 1wire bus, there is no need for any external power to the sensors. Please note if more than one DS2450 is attached to 1-wire bus, only the first one will be used by the firmware. If more than 10 1-wire devices attached to the bus, only the first 10 will be used.

2.5 Humidity Sensor Input

The current WebControlTM hardware has been designed to use the Honeywell 4000 series relative humidity sensor devices. Using any other humidity sensor without careful consideration may result in malfunction of this feature. The RH sensor can be used to display relative humidity via HTTP or be used to control the TTL outputs as an input in the PLC engine.

Figure 2.0 WebControl

connections

Please make sure the temp sensor and humidity sensor connected similar to this picture. Reverse the polarity may cause damage to the board.

sensor

WebControlTM PLC User Guide Version 3.02.17f

3 WebControlTM PLC Web GUI Configuration

To access WebControlTM PLC, connect WebControl

to the local network and power

supply. The default IP address will be 192.168.1.15. Be aware that once you enable

DHCP in your WebControl network settings page, you will need to check your DHCP

server log for which IP address DHCP assigned to the board. You need to know and

understand the network you attaching this hardware to in order to know where to look

for DHCP server logs. For home networks, DHCP serving is commonly enabled at

the router. Each WebControl

PLC board has a unique MAC address. Look in the

DHCP log to find the matching MAC address, then you can find the IP address

DHCP assigned to the hardware. From a computer connected to the same network,

start a web browser, and point to that IP address: for example: http://ww.xx.yy.zz

when the web page loads, you will be prompt for login. The default user ID and

password is: “admin/password”, all in lower case. You will see this page once

logged in:

Figure 3.0 WebControl

PLC system status

3.1 Network Settings

These are the basic settings that need to be configured in order for WebControlTM to

work successfully on a network. It may be necessary to connect the board directly to

a PC and access it using its default IP address before connecting directly to a live

WebControlTM PLC User Guide Version 3.02.17f

network in order to configure it correctly. Figure 4.0 shows the Network settings

WebControl

has.

Figure 4.0 WebControl

PLC Network configurable

3.1.1 NTP Server Settings

This version changed from previous versions by reduced Allowed Limits host IP

address from eight to four. In addition, it added NTP Server section to allow user to

enter his local NTP server’s IP address to overwrite the default pool.ntp.org resolved

IP address. By default NTP server field should be 0.0.0.0, so that WebControl

will

use pool.ntp.org as the Network Time Protocol server.

3.1.2 Access Settings

For security purpose, you can decide your own user name and password. For being

used over Internet, you may also set the access list, so that only host in the list can

WebControlTM PLC User Guide Version 3.02.17f

access the WebControlTM board over the network. Please note that if any entry is

0.0.0.0, all IP addresses can access it.

WebControlTM PLC User Guide Version 3.02.17f

3.2 I/O Setup

WebControlTM PLC allows users to directly from browser control each output, or

through the PLC logic to control the TTL output. For flexibility, user can decide if the

TTL input or out to be inverted between logic 0 and logic 1. To use PLC logic, first

user must check the “Global PLC enable” to start the PLC engine. Then for each

TTL output, user can decide if the PLC control will be applicable.

Figure 5.0 I/O setup

WebControl

PLC allows user using browser to directly control the output state. If a

command line utility or third party control software used, you will need to enable the

Browser Control for that TTL output, also may need to go to network configuration to

disable the Web login (see figure 4.0).

The inverted state will be remembered in EEPROM even after power loss. The invert

state will be restored upon power resumed.

X10 Enable will allow user to send X10RF commands through TTL port7 and TTL

port8. Those two ports will not be able to perform any other function, once X10 is

enabled.

WebControlTM PLC User Guide Version 3.02.17f

Counter Enable /Frequency Measurement Enable/TTL Input Enable are radio buttons

that you can only select one of them. Those functions sharing the same TTL1 input.

Please note the Counter is triggered at rising edge after the falling edge. If your

counting source TTL level was zero from start with, you may miss count by 1.

Frequency measurement is up to 2MHz.

WebControlTM PLC User Guide Version 3.02.17f

3.3 X10 RF Control

Figure 6.0 WebControl

X10RF Control

WebControl uses TTL7 and TTL8 to control X10RF devices. User must already

enabled X10RF function in the I/O Setup screen. An external RF transmitter must be

attached to the output port TTL7, TTL8, and ground. In the USA, the X10 RF

frequency is 310MHz, and in Europe, the frequency is 433 MHz WebControl can

send all 16 house codes and 16 unit codes, controlling total 256 devices.

X10 RF function is supported in the PLC programming also.

In PLC programming, PLC command is in the format:

X10 H U C

Where H is house code from 0-15, U is unit code, also from 0-15; C is one of

following four commands: 0 – Off, 1 – On, 2 – Bright, 3 – Dim. H,U,C can be

variables so that user can dynamically change the X10 operation in PLC logic.

If the X10 function enabled, TTL7 and TTL8 should not be used for controlling other

devices. Please note PLC logic uses 0-15 or 0-0xF for code, web GUI only use 0-F.

WebControlTM PLC User Guide Version 3.02.17f

3.4 Output Control

Figure 6.0 WebControl

Output Control

When click on each TTL output On or Off, the current state of the TTL output will

change. However, the display may or may not update depending on the “Web

pulling” enabled in the General Setup screen. If you did not enable the “Web Pulling”

to save the bandwidth, you will need to use browser refresh to see the output state

change. Please note “Save States” button will make WebControl store the state in

the EEPROM. When power lost and reapplied, the output will remember the states

being saved.

WebControlTM PLC User Guide Version 3.02.17f

3.5 Notification Setup

WebControlTM allows up to 8 different email notifications to be send from the PLC

program. Please note the port can be any number, but WebControl current hardware

cannot support SSL enabled email. Certain email servers like Gmail requires use

SSL enabled email client. WebControl does not support that. However, WebControl

does allow sending email out from port other than 25. Most local ISP provides the

non-SSL email server on port other than 25, for example, Yahoo email using port

587. Please contact your local ISP first to find out how to sending out non-SSL

encrypted email. For example, Yahoo email can be used:

SMTP Host = smtp.mail.yahoo.com Port 587

username = your-Yahoo-email-account,

password = your password used

From field = Your Yahoo mail

From firmware 3.02.16, user can specify different email address for different email

notification. So that different email can be send to different person for a different

event.

WebControl 3.02.16 firmware also allow HTTP GET to be used to set the VAR or

output state to another WebControl board, provided the other board does not enable

logic. If the security is concern, please set up allowed host in Network Setup screen.

This HTTP GET feature can also be used to send notification to the remote HTTP

server, given the remote server does have CGI logic to process the HTTP GET sent

from WebControl. User can specify up to 8 different URLs on each board. There are

three fields in each URL. The first field is IP address and port, in the format of

192.168.2.15:81 . The “:” is to separate the IP address and remote HTTP port. There

is no space. It is followed by virtual host name. The URI portion of the URL is a

string leading all the way to the value being set on the WebControl or remote HTTP

server. The last part of the URL is the Base64 encrypted use name and password.

This will allow one WebControl to set value in another WebControl with password

protected. If the other side does not require login, this field can be left blank.

For example, if you want to set a remote WebControl board VAR1 to value 1234, you

simple in the PLC logic calling:

WEBSET URL1 1234

+ 35 hidden pages

CAI Networks WebControl PLC User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual