Gw XML setup: Difference between revisions

Revision as of 09:58, 22 December 2011

Element: Setup

The XML setup starts with the tag Setup. The entire setup is contained in this element.

All id attributes must be unique!

This element contains:

Element: Device
- At least one element of this type.
Attribute: device
- If more than one Device element available. This attribute specifies the id of the Device to use as current setup.

 <Setup device="Telem-Gw6-1">
 	<Device id="Telem-Gw6-1" />
 	<Device id="Gw1" />
 	<Device id="Gw2" />
 </Setup>

Element: Device

This element contains setup for a specific device. This might be Gw itself or some substation device or SCADA device.

This element contains:

Element: Channel
Element: Protocol
Element: Objects
Element: Interfaces
Attribute: id
- Used for element identification

Child elements of Device when used as GW device

 <Device id="Telem-Gw6-1">
 	<Channel />
 	<Interfaces />
 </Device>

Child elements of Device when used as the device we're connecting to.

 <Device id="DI-24T-1">
 	<Protocol />
 	<Objects />
 </Device>

Element: Channel

This element contains:

Element: Port
- If more than one Port is specified, they are for redundancy.
Element: Device
Element: Objects

 <Channel id="DI-24T-1">
 	<Port />
 	<Device />
 	<Objects />
 </Channel>

Element: Protocol

 <Protocol comment="protocol8" id="prot_8_0">
 	<Address />
 	<CommunicationDelay unit="millisecond">0</CommunicationDelay>
 	<PollingTimeout unit="millisecond">500</PollingTimeout>
 	<TimeSync />
 	<TimeoutRemoveCount>5</TimeoutRemoveCount>
 	<TimeoutRemoveTime unit="second">20</TimeoutRemoveTime>
 	<ReplaceTime>false</ReplaceTime>
 	<GeneralInterrogationForwarding>false</GeneralInterrogationForwarding>
 	<Type SubVersion="0" isMaster="false">IEC101UnBalanced</Type>
 </Protocol>

Element: TimeSync

Timesync interval and correction setup

 <TimeSync isEnabled="true">
 	<Interval unit="second">30</Interval>
 	<Correction />
 </TimeSync>

Element: Correction

Possible timesync correction types:

Absolute
- Timesync message shall always be modified by this amount.
ConnectionSpeed
- Baudrate based(only when using serial port)

 <Correction>
 	<Absolute enabled="true" unit="millisecond">0</Absolute>
 	<ConnectionSpeed enabled="true"/>
 </Correction>

Element: Address

This element can refer to protocol address or some specific object address.

Address for protocol

This elements contents depend on the protocol selected

Iec-10x

 <Address>
 	<LinkAddress>1</LinkAddress>
 	<LinkAddressLength>1</LinkAddressLength>
 	<AsduAddress>1</AsduAddress>
 	<AsduAddressLength>2</AsduAddressLength>
 	<ObjectAddressLength>2</ObjectAddressLength>
 </Address>

MODBUS

Value: integer

 <Address>2</Address>

IEC62056-21

Value: string

Can be empty if only one device on channel.

 <Address id="0.0.0">addr123</Address>

If this Address element contains attribute id, It shall be used for device verification.

Address of object

Iec-10x

Value: integer

 <Address index="0">10</Address>

attribute index is unnecessary if value==0

IEC61580/IEC62056-21

Value: string

 <Address>5.3.5</Address>

Other

Other protocols might have additional fields.

Element: Port

 <Port>
        <Buffer id="inBuffer"/>
        <Buffer id="outBuffer"/>
        <IoBuffer in="inBuffer" out="outBuffer"/>
 </Port>

Port data forwarding

It is possible to send data from one port to another.

To do that, port1's input buffer is the same as port2's outputbuffer and vice versa.

 <Port id="port1">
        <Buffer id="portBufferIn"/>
        <Buffer id="portBufferOut"/>
        <IoBuffer in="portBufferIn" out="portBufferOut"/>
 </Port>
 <Port id="port2">
        <IoBuffer in="portBufferOut" out="portBufferIn"/>
 </Port>

The same method allows creation of a local loopback.

 <Port id="portLoopback">
        <Buffer id="portBuffer"/>
        <IoBuffer in="portBuffer" out="portBuffer"/>
 </Port>

Serial port

 <Port class="SerialPortSetup">
 	<BaudRate>9600</BaudRate>
 	<DataBits>8</DataBits>
 	<StopBits>1</StopBits>
 	<Parity>none</Parity>
 	<FlowControl>none</FlowControl>
 </Port>

TCP/IP server

 <Port class="TcpIpServerSetup">
 	<PortNumber>80</PortNumber>
 	<ClientIpMask>0.0.0.0</ClientIpMask>
 	<Interface>eth0</Interface>
 </Port>

Element: ClientIpMask

Defines who is allowed to connect with us. More than one possible.

TCP/IP client

 <Port class="TcpIpClientSetup" name="16">
 	<PortNumber>502</PortNumber>
 	<IpAddress>10.0.0.89</IpAddress>
 	<Interface>eth0</Interface>
 </Port>

Virtual port

They are ports 3-5 on GW6.

 <Port class="VirtualPortSetup">
 	<Port class="SerialPortSetup">
 	      <BaudRate>9600</BaudRate>
 	      <DataBits>8</DataBits>
 	      <StopBits>1</StopBits>
 	      <Parity>none</Parity>
 	      <FlowControl>none</FlowControl>
 	</Port>
 </Port>

Element: Objects

Element: Object

Depending on protocol the object belongs to (master/slave), has different child elements.

Possible child elements:

Address
Buffer
Filter
MxValue

Attribute: type

Defines object type.

Possible values:

DI
AI
CN
DO
AO

Element: MxValue

Defines the object for current/latest value.

Child elements define default value, flags and time tag.

 <MxValue id="DI_6_value">
 	<Value>0</Value>
 	<BitMask>
 		<Bit>Invalid</Bit>
 		<Bit>NotTopical</Bit>
 	</BitMask>
 </MxValue>

Element: Filter

Defines what is going to happen to the incoming measured value.

Filters can be daisy chained. To achieve different outcomes.

When an event is received, it is sent to it's filter. After the filter does what it's supposed to do, it will pass the event to the Next Filter

 <Filter class="Change">
 	<Filter class="Proxy" />
 </Filter>

AddToBuffer

AddToBuffer may have more than one Target.

Target is a Buffer object.

 <Filter class="AddToBuffer">
 	<Target ref="DI_0_7_buf"/>
 	<Target ref="DI_1_7_buf"/>
 	<Target ref="DI_2_7_buf"/>
 	<Target ref="DI_3_7_buf"/>
 	<Target ref="DI_4_7_buf"/>
 </Filter>

Assert

Passes event to the next filter only if specified target(MxValue) == false.

Possible use cases:

Respond negatively to control commands
Signal blocking

 <Filter class="Assert">
 	<Ref>DI_7_value<Ref/>
 </Filter>

Change

Detects change in Digital measurments value and status bits.

Deadband

Used to detect change in analog and counter values

 <Filter class="Deadband">
         <Type>X</Type>
         [...]
 </Filter>

Type
- Default is Deadband1, if Deadband1 then Type is unnecessary

Integral

New deadband type, not implemented.

Absolute

This deadband is used for counter values.

f = abs( new_value - current_value ) > Threshold

Threshold
- Integer value
- If value=0; then no need for filter

<Filter class="Deadband">
 <Type>Absolute</Type>
 <Threshold>X</Threshold>
</Filter>

Deadband1

This is the legacy GW6 deadband mode This deadband is used for analog values.

if( (new_value < Critical.min) || (new_value > Critical.max) )
{
    current_threshold = Threshold2
}
else 
{
    current_threshold = Threshold1
}

if ( new_value.is_normalized )
    calculated_threshold = current_threshold / 100
else
    calculated_threshold = (Scale.max - Scale.min) * current_threshold / 100

f = abs( new_value - current_value ) > calculated_threshold

If Threshold1=0 and Threshold2=0, do not add Deadband filter.
Element Scale
- Unneccessary when Scale.min=0 and Scale.max=0
Elements Critical and Threshold2
- These elements are unnecessary when Critical.min=0 and Critical.max=0

Example 1

Both Deadband1 and Deadband2 active

 <Filter class="Deadband">
  <Scale min="1" max="4" />
  <Threshold1>X</Threshold1>
  <Critical min="2" max="3" />
  <Threshold2>X</Threshold2>
 </Filter>

Example 2

Works only on normalized values

 <Filter class="Deadband">
  <Threshold1>X</Threshold1>
 </Filter>

Example 3

Works on normalized and floating point values

 <Filter class="Deadband">
  <Scale min="1" max="4" />
  <Threshold1>X</Threshold1>
 </Filter>

Fallback

Falls back to specified value.

Normalize

This filter is used for converting floating point value to normalized value.

This filter works only on floating point values. Normalized values shall be passed on without change

 <Filter class="Normalize">
 	<To>-1...1</To>
 	<Max>100</Max>
 	<Min>10</Min>
 </Filter>

Element To has two possible value: -1...1 or 0...1 and this selects the formula and overflow conditions being used.

Range -1...1

normalized_value=float_value/Max

overflow is set when normalized_value < -1 && normalized_value > 1

No element Min for this range

Range 0...1

normalized_value=(float_value-Min)/(Max-Min)

overflow is set when normalized_value < 0 && normalized_value > 1

Inversion

Inverts the passed digital value..

If-else

Input: digital value

This is not final!

<Filter class="IfElse">
<True>
    <Filter class="AddToBuffer">
      <Target ref="DO_device_output1_buf"/>  
    </Filter>
</True>
<False>
    <Filter class="AddToBuffer">
      <Target ref="DO_device_output2_buf"/>  
    </Filter>
</False>
</Filter>

OutputController

This filter is used with Formulas when output controlling is needed.

Count
- Default value if count not specified, 1
- Number of output commands
- Integer: 1...X ( X = uint32_t )
- String: inf ( infinity, if Count is not convertable to integer, then inifinity is used)
Retry
- time to wait before retry/next command
- default value if not specified, 5 seconds

<Filter class="OutputController">
  <Count>1</Count>
  <Retry unit="second">5</Retry>
  <Filter class="Assert">
    <Ref>DO_device_status</Ref>
    <Filter class="AddToBuffer">
      <Target ref="DO_device_output1_buf"/>  
    </Filter>
  </Filter>
</Filter>

Proxy

Proxy may have more than one next Filter.

 <Filter class="Proxy">
 	<Filter class="AddToBuffer" />
 	<Filter class="AddToBuffer" />
 	<Filter class="Fallback" />
 </Filter>

Scale

This filter works only on normalized values. Non-normalized(floating point) values shall be passed on without change

scaled_value=normalized_value*(Max-Min)+Min

 <Filter class="Scale">
 	<Max>100</Max>
 	<Min>10</Min>
 </Filter>

If element Min=0 then no need to define that element, value 0 is used as default for Min. Element Max must always exist. Element To is not used.

CsvLogger

??? kas teha filtrina või mõni muu lahendus?

UpdateValue

Target is a MxValue object.

 <Filter class="UpdateValue">
 	<Target ref="DI_7_value"/>
 </Filter>

Square

SquareRoot

Sine

Cosine

Tangent

Cotangent

f = 1 / tan(x)

Secant

f = 1 / cos(x)

Cosecant

f = 1 / sin(x)

log

log10

exp

Element: Buffer

Defines a buffer object, with depth.

 <Buffer id="DI_8_0_buf">
 	<Depth>10</Depth>
 </Buffer>

Element: Formula

Possible child elements:

Buffer
MxValue
Filter
Expression

Attribute: type - This defines the result type of formula. Possible choices DI, AI, CN

Element: Expression

Element name Expression may be abbreviated as Exp

Element name Operation may be abbreviated as O

Elements a and b are current expressions inputs.

Operation	operand count	example	description
and	∞, a₁ a₂ ... a_n	a₁ ∧ a₂ ∧ a_n
or	∞, a₁ a₂ ... a_n	a₁ ∨ a₂ ∨ a_n
add	∞, a₁ a₂ ... a_n	a₁ + a₂ + a_n
sub	∞, a₁ a₂ ... a_n	a₁ − a₂ − a_n
not	1, a	!a
sqr	1, a	a²
sqrt	1, a	√a
sin	1, a	sin(a)
cos	1, a	cos(a)
tan	1, a	tan(a)
arcsin	1, a	arcsin(a)
arccos	1, a	arccos(a)
arctan	1, a	arctan(a)
log	1, a	log_e(a)	The natural logarithm is the base-e logarithm, the inverse of the natural exponential function (exp)
log10	1, a	log₁₀(a)	Returns the common (base-10) logarithm of x
exp	1, a	exp(a)	Returns the base-e exponential function of x, which is the e number raised to the power x.
mul	2, a b	a*b
div	2, a b	a/b
pow	2, a b	a^b
xor	2, a b	a⊕b
eq	2, a b	a = b	Check equality
lt	2, a b	a < b	Less than
gt	2, a b	a > b	Greater than

example 1: or

f = a₁ ∨ a₂

<Expression>
    <Operation>or<Operation/>
    <a>Buffer</a>
    <a>MxValue</a>
    <Filter />
</Expression>

example 2: power

f = a^b

 <Expression>
    <Operation>pow<Operation/>
    <a>Buffer</a>
    <b>Buffer</b>
    <Filter/>
 </Expression>

Formula example 1

f = @1 or @2

 <Formula type="DI" id="DI_f0" comment="Virtual1 OK">
      <MxValue id="DI_f0_value"/>
      <Buffer id="DI_f0_0_0_buf" /> <!-- @1 -->
      <Buffer id="DI_f0_0_1_buf" /> <!-- @2 -->
      <Expression>                  <!-- @1 or @2 -->
          <O>or<O/>
          <a>DI_f0_0_0_buf</a>
          <a>DI_f0_0_1_buf</a>
          <Filter ref="DI_f0_filter" />
      </Expression>
      <Filter id="DI_f0_filter" class="Change">  <!-- result filter -->
          <Filter class="UpdateValue">
              <Target ref="DI_f0_value"/>
              <Filter class="AddToBuffer" />
          </Filter>
      </Filter>
 </Formula>

DI_f0_0_0_buf and DI_f0_0_1_buf are inputs to formula.

Formula example 2

f = (@1 + @2) / (@3 + @4)

 <Formula type="DI" id="DI_f0" comment="formula example 2, f = (@1 + @2) / (@3 + @4)">
    <MxValue id="DI_f0_value"/>  <!-- This variable holds the latest value of formula -->
    <Buffer id="DI_f0_1_buf" />  <!-- @1 -->
    <Buffer id="DI_f0_2_buf" />  <!-- @2 -->
    <Buffer id="DI_f0_3_buf" />  <!-- @3 -->
    <Buffer id="DI_f0_4_buf" />  <!-- @4 -->
    <Buffer id="DI_f0_t1_buf" /> <!-- temporary result of @1 + @2 -->
    <Buffer id="DI_f0_t2_buf" /> <!-- temporary result of @2 + @3 -->
    <Expression>                 <!-- @1 + @2 -->
        <O>add</O>
        <a>DI_f0_1_buf</a>       <!-- @1 -->
        <a>DI_f0_2_buf</a>       <!-- @2 -->
        <Filter class="AddToBuffer">
            <Target ref="DI_f0_t1_buf"/>
        </Filter>
    </Expression>
    <Expression>                 <!-- @3 + @4 -->
        <O>add</O>
        <a>DI_f0_3_buf</a>       <!-- @3 -->
        <a>DI_f0_4_buf</a>       <!-- @4 -->
        <Filter class="AddToBuffer">
            <Target ref="DI_f0_t2_buf"/>
        </Filter>
    </Expression>
    <Expression>                 <!-- f = (@1 + @2) / (@3 + @4) -->
        <O>div</O>
        <a>DI_f0_t1_buf</a>      <!-- @1 + @2 -->
        <a>DI_f0_t2_buf</a>      <!-- @3 + @4 -->
        <Filter ref="di_f0_filter" />
    </Expression>
    <Filter id="di_f0_filter" class="AddToBuffer"> <!-- result filter -->
        <Target ref="DI_SCADA_buf"/>
    </Filter>
 </Formula>

Formula example 3

Comparison with constant

f = @1 < 3,5

 <Formula type="DI" id="DI_f0" comment="Formula example 3, constant, f = @1 < 3,5">
      <MxValue id="DI_f0_value"/>   <!-- latest value of formula -->
      <Buffer id="AI_f0_0_0_buf" /> <!-- @1 -->
      <Expression>                  <!-- @1 < 3,5 -->
          <O>lt<O/>
          <a>AI_f0_0_0_buf</a>
          <b><MxValue>3.5</MxValue></b>
          <Filter ref="DI_f0_filter" />
      </Expression>
      <Filter id="DI_f0_filter" class="Change">  <!-- result filter -->
          <Filter class="UpdateValue">
              <Target ref="DI_f0_value"/>
              <Filter class="AddToBuffer" />
          </Filter>
      </Filter>
 </Formula>

Element: Interfaces

Network setup

Has at least one Interface element.

 <Interface name="eth0">
        <IpAddress>192.168.0.111</IpAddress>
        <Netmask>255.255.255.0</Netmask>
        <Gateway>192.168.0.1</Gateway>
 </Interface>

VLAN

Example with required elements.

 <Vlan interface="eth0">
     <VlanId>10</VlanId>
     <VlanIngressQos>4</VlanIngressQos>
     <VlanEgressQos>4</VlanEgressQos>
     <IpIngressQos>0</IpIngressQos>
     <IpEgressQos>0</IpEgressQos>
 </Vlan>

Example with additional elements from Interface

 <Vlan interface="eth0">
     <VlanId>131</VlanId>
     <VlanIngressQos>4</VlanIngressQos>
     <VlanEgressQos>4</VlanEgressQos>
     <IpIngressQos>0</IpIngressQos>
     <IpEgressQos>0</IpEgressQos>
     <IpAddress>172.18.0.11</IpAddress>
     <Netmask>255.255.255.0</Netmask>
     <Gateway>172.18.0.254</Gateway>
 </Vlan>

@@ Line 507: / Line 507: @@
   </Filter>
 </syntaxhighlight>
+===== Square =====
+===== SquareRoot =====
+===== Sine =====
+===== Cosine =====
+===== Tangent =====
+===== Cotangent =====
+ f = 1 / tan(x)
+===== Secant =====
+ f = 1 / cos(x)
+===== Cosecant =====
+ f = 1 / sin(x)
+===== log =====
+===== log10 =====
+===== exp =====
 ==== Element: Buffer ====

Gw XML setup: Difference between revisions

Revision as of 09:58, 22 December 2011

Element: Setup

Element: Device

Element: Channel

Element: Protocol

Element: TimeSync

Element: Correction

Element: Address

Address for protocol

Iec-10x

MODBUS

IEC62056-21

Address of object

Iec-10x

IEC61580/IEC62056-21

Other

Element: Port

Port data forwarding

Serial port

TCP/IP server

Element: ClientIpMask

TCP/IP client

Virtual port

Element: Objects

Element: Object

Attribute: type

Element: MxValue

Element: Filter

AddToBuffer

Assert

Change

Deadband

Integral

Absolute

Deadband1

Fallback

Normalize

Range -1...1

Range 0...1

Inversion

If-else

OutputController

Proxy

Scale

CsvLogger

UpdateValue

Square

SquareRoot

Sine

Cosine

Tangent

Cotangent

Secant

Cosecant

log

log10

exp

Element: Buffer

Element: Formula

Element: Expression

example 1: or

example 2: power

Formula example 1

Formula example 2

Formula example 3

Element: Interfaces

VLAN

Navigation menu

Search