EventResponse

The EventResponse element is used to configure which events activate the response.

Events can be added in two ways:

  • Add individual events using the Event element by using the Name attribute.

  • Add all events configured for a different event response using the PropagatingEventResponse element.

See also

Event response

Explanation of the general concept of event responses and their purpose in the motion software.

Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<Controller Name="Arcas 5EG-0">
  <AxisControl Name="X" Template="LogicalAxisControlStandard3rdOrderTemplate">
    <EventResponse Name="ErrorResponse">
      <Events>
        <Event Name="Watchdog"/>
        <Event Name="SampleOverload"/>
      </Events>
    </EventResponse>
  </AxisControl>

  <AxisControl Name="Y" Template="LogicalAxisControlStandard3rdOrderTemplate">
    <EventResponse Name="QuickStopErrorResponse">
      <Events>
        <Event Name="Y/TrajectoryInterpolator/DemandPositionLimitExceeded"/>
      </Events>
    </EventResponse>
  </AxisControl>

  <AxisControlGroup Name="XY-group" Template="AxisControlGroupTemplate">
    <AxisControl Name="X"/>
    <AxisControl Name="Y"/>

    <EventResponse Name="ErrorResponse">
      <PropagatingEventResponses>
        <PropagatingEventResponse Name="X/ErrorResponse"/>
        <PropagatingEventResponse Name="Y/QuickStopErrorResponse"/>
      </PropagatingEventResponses>
    </EventResponse>
  </AxisControlGroup>
</Controller>

XML schema

EventResponseType

Complex type EventResponseType
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<xs:complexType name="EventResponseType">
  <xs:choice minOccurs="0" maxOccurs="unbounded">
    <xs:element name="Event" type="NamedReferenceType"/> <!-- Deprecated -->
    <xs:element name="Events" type="RegisteredEventsType"/>
    <xs:element name="PropagatingEventResponses" type="PropagatingEventResponsesType"/>
    <xs:element name="Signal" type="SignalType"/>
    <xs:element name="Variant" type="EventResponseVariantType"/>
    <xs:element name="NamedMutation" type="NamedMutationType"/>
  </xs:choice>
  <xs:attribute name="Name" type="xs:string" use="required"/>
</xs:complexType>

Attribute

Description

Name

Used to specify the event response, which is required to be defined or modified.
Complex type EventResponseVariantType
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
<xs:complexType name="EventResponseVariantType">
  <xs:complexContent>
    <xs:extension base="BaseVariantType">
      <xs:choice minOccurs="0" maxOccurs="unbounded">
        <xs:element name="Event" type="NamedReferenceType"/> <!-- Deprecated -->
        <xs:element name="Events" type="RegisteredEventsType"/>
        <xs:element name="PropagatingEventResponses" type="PropagatingEventResponsesType"/>
        <xs:element name="Signal" type="SignalType"/>
        <xs:element name="Variant" type="EventResponseVariantType"/>
        <xs:element name="NamedMutation" type="NamedMutationType"/>
      </xs:choice>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Deprecated since version 3.70.0:

  • Specifying an Event element directly within EventResponse to add the event to the response.

  • Specifying an EventResponse element without child elements results in the removal of all existing events from the response event collection.

RegisteredEventsType

Complex type RegisteredEventsType
1
2
3
4
5
<xs:complexType name="RegisteredEventsType">
  <xs:choice minOccurs="0" maxOccurs="unbounded">
    <xs:element name="Event" type="NamedReferenceType"/>
  </xs:choice>
</xs:complexType>

Note

Specifying an empty Events element within an EventResponse element removes all previously configured events from the event response.

PropagatingEventResponsesType

Complex type PropagatingEventResponsesType
1
2
3
4
5
<xs:complexType name="PropagatingEventResponsesType">
  <xs:choice minOccurs="0" maxOccurs="unbounded">
    <xs:element name="PropagatingEventResponse" type="NamedReferenceType"/>
  </xs:choice>
</xs:complexType>

Note

Configuring a PropagatingEventResponse on an EventResponse means that any trigger of the PropagatingEventResponse is propagated to the EventResponse on which it is configured.

Note

Specifying an empty PropagatingEventResponses element within an EventResponse element removes all previously configured propagating event responses from the event response.