Events File

Child elements of InputLineEventFile root element

XML elements

Attributes

Content

Number of occurrences

Description

Verbose/VB
Concise/CS

Immediate

EMPTY

0/1

Syntax that the driver uses to generate this XML file. By default, the driver uses the verbose syntax.

QueueSize/QS

Immediate

PCDATA

0/1

Capacity of the events queue.

Count/C

Immediate

ReadOnly

PCDATA

0/1

Number of events in this file.

High/H
Low/L
Disconnected/D

 

EMPTY

Any

State of the input line after the transition causing the event.

Child elements of High, Low, Disconnected elements

XML elements

Attributes

Content

Number of occurrences

Description

Index/IX

ReadOnly

PCDATA

1

The unique index of the event.

TimeStamp/TS

ReadOnly

PCDATA

0/1

Local time counter value at event time.

Acknowledge/ACK

Immediate

WriteOnly

EMPTY

0/1

Acknowledges the event and removes it from the events file.

XML File Examples

<root>/inputlines/line*/events.xml – Read operation – Verbose mode – No events

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE InputLineEventFile SYSTEM "events.dtd">
<InputLineEventFile version="1.0">
    <Verbose Immediate="true"/>
    <QueueSize Immediate="true">10</QueueSize>
    <Count ReadOnly="true" Immediate="true">0</Count>
</InputLineEventFile>

<root>/inputlines/line*/events.xml – Read operation – Verbose mode – Two events

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE InputLineEventFile SYSTEM "events.dtd">
<InputLineEventFile version="1.0">
    <Count>2</Count>
    <High>
        <Index>0</Index>
        <TimeStamp>2132154654</TimeStamp>
    </High>
    <Low>
        <Index>1</Index>
        <TimeStamp>4442154654</TimeStamp>
    </Low>
</InputLineEventFile>

<root>/inputlines/line*/events.xml – Write operation – Acknowledge the High event of Index 0

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE InputLineEventFile SYSTEM "events.dtd">
<InputLineEventFile version="1.0">
    <High>
        <Index>0</Index>
        <Acknowledge/>
    </High>
</InputLineEventFile>