Appendix A API Commands
ChartScan User’s Manual A-55
(1) The first parameter, start, defines the event that is to take place in order for the unit to begin acquiring
scans. This event is referred to as the Start Trigger. When the unit has recognized that a Start Trigger has been
encountered, it will begin acquiring scans at that point. The first of these scans, the Start Trigger scan, will be
time/date stamped for later reference. Also, when the Start Trigger is recognized, the Triggered Bit (02) of t he
Status Byte will be set and the TRIGGER light on the front panel will turn on.
Setting the start parameter to 0 will disable the acquiring of scan; this may be performed at any time during or
after an acquisition. The start parameter will automatically be set to 0 upon the termination of an acquisition
unless the re-arm flag is set to 1.
Note: If the trigger start event is level or alarm, at least one pre-trigger scan must be program med to initiate
scanning in order for the event to be recognized.
(2) The second parameter, stop, defines the event that is to take place in order for the unit to stop acquiring
scans. This event is referred to as the Stop Trigger. When the unit has recognized that a Stop Trigger has been
encountered, it will stop acquiring scans at that point (unless post-stop count is defined; see Y command). The
last scan collected, the Stop Trigger scan, will be time/date stamped for later reference. Also, when the Stop
Trigger is recognized, the Trigger Bit (02) of the Status Byte will be cleared and the TRIGGER light on the front
panel will turn off.
Setting the stop parameter to 0 will have the same effect as setting the stop parameter to 1 (Stop on Count)
with Post-Stop Count (Y) command set to 0. In both cases, the Start Trigger scan will be collected and the
acquisition immediately terminated.
(3) The third parameter, re-arm, determines if, after the initial acquisition, the acquisit ion should be re-enabled
automatically. If this parameter is set, then after the Stop Trigger is recognized and the ac quisition terminated a
new acquisition (with the same configuration) will be enabled automatically. In other words, after the termination
of the previous acquisition, the unit will immediately begin another acquisition of the same configuration.
Otherwise, if the parameter is not set, new acquisitions will remain disabled after the initial acquisition has
terminated.
(4) The fourth parameter, sync, determines if the Start Trigger should be synchronized with the internal Pre-
Trigger Scan Interval (I) command value. If the Pre-Trigger Count (Y) command is defined, this param eter will
be examined to determine if the Start Trigger should be synchronized with the internal Pre-Trigger Timebase
Interval. If so, then the Start Trigger, regardless of what point in time it occurred, will be synchronized with the
next occurrence of the Pre-Trigger Scan Interval “tick.” In other words, if the real Start Trigger occurs between
Pre-Trigger Scan Interval “ticks,” then the acquisition will not begin until the next “tick” of the Pre-Trigger Scan
Interval. Otherwise, the acquisition will begin as soon as the Start Trigger is encountered.
EXAMPLE
PRINT#1, “OUTPUT07; I12:00:00:0,
00:01:00.0X”
‘ Collect scans once every 12 hours then when Start
Trigger occurs collect them once every minute
PRINT#1, “OUTPUT07;Y100,10000,0X”
‘ Set pre-trigger count to 100, post-trigger count to 10000
and define no post-stop count
PRINT#1, “OUTPUT07;T1,7,0,1X”
‘ Start Trigger On (@) command, Stop Trigger on post-
trigger count (10000) and synchronize the Start
Trigger to the pre-trigger timebase interval
PRINT#1, “OUTPUT07;@X”
‘ Issue Start Trigger (acquisition may begin as much as 12
hours from now because we synchronized with pre-
trigger timebase interval)