Newport XPS-Q8 - Page 142

XPS-Q8 Controller Motion Tutorial
An event is entirely composed of:
[Actor].[Category].Event Name, Parameter1, Parameter2, Parameter3,
Parameter4
Not all event names have a preceding actor and category, but all events have four
parameters, even though some parameters are not needed. For these parameters, it is
still required to use zero (0) as default.
To define an Event, use the function EventExtendedConfigurationTriggerSet().
Examples
EventExtendedConfigurationTriggerSet
(MyGroup.MyPositioner.SGamma.MotionStart, 0, 0, 0, 0)
In this case, the actor is a positioner (MyGroup.MyPositioner) and the event has a
category. The event happens when the next motion with the SGamma profiler on the
positioner MyGroup.MyPositioner starts. After the motion has started, the event is
removed.
EventExtendedConfigurationTriggerSet
(MyGroup.XYLineArc.ElementNumberStart, 5, 0, 0, 0)
In this case, the actor is a group (MyGroup) and the event has a category. The event
happens when the trajectory element number 5 on the next LineArc trajectory on this
group starts.
EventExtendedConfigurationTriggerSet
(GPIO2.ADC2.ADCHighLimit, 3, 0, 0, 0)
In this case, the actor is a GPIO name (GPIO2.ADC2) and the event has no category.
The event happens when the voltage on the GPIO.ADC2 exceeds 3 Volts.
It is also possible to link different events to an event configuration. The same function
EventExtendedConfigurationTriggerSet() is used, and the different events are just
separated by a comma. The event combination happens when all individual events
happen at the same time. It is comparable to a logic AND between the different events.
Examples
EventExtendedConfigurationTriggerSet (GPIO2.ADC2.ADCHighLimit,
3, 0, 0, 0, MyGroup.MyPositioner.SGamma.MotionState, 0, 0, 0, 0)
This event will happen when the voltage of the GPIO.ADC2 exceeds 3 Volts during a
SGamma motion of the MyGroup.MyPositioner.
EventExtendedConfigurationTriggerSet (Always, 0, 0, 0, 0,
MyGroup.MyPositioner.SGamma.MotionStart, 0, 0, 0, 0)
This event will happen during each SGamma motion starts of the positioner
MyGroup.MyPositioner. The addition of the event Always has the effect of keeping the
event after the next motion has been started (see differences compared to the first
example above).
The exact meaning of the different events and event parameters are as follows:
Always: Triggers an action ALWAYS, means at each servo cycle.
Event parameter 1 to 4 = 0 by default.
NOTE: This event is PERMANENT until the next reboot.
Call the EventExtendedRemove function to remove it.
Immediate: Triggers an action IMMEDIATELY, meaning once during
the very next servo cycle:
Event parameter 1 to 4 = 0 by default.
NOTE: This event is TEMPORARY.
Timer: Triggers an action every nth servo cycle, where n is defined
with the function TimerSet.
Event parameter 1 to 4 = 0 by default.
XPSDocumentation V1.4.x (EDH0301En1060 — 10/17) 130