User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-251
schedule.alarm[x].fractionalseconds
Example
Create an alarm to occur 60.25 seconds from current time in UTC seconds
sec,ns = os.time()
schedule.alarm[1].seconds = sec + 60
schedule.alarm[1].fractionalseconds = ns + 0.5
schedule.alarm[x].period
Attribute
The time, in seconds, between adjacent firings of the alarm.
Usage
schedule.alarm[x].period
Example
Set period of 0.5 seconds between firings of alarms after initial alarm
schedule.alarm[1].period = 0.5
schedule.alarm[x].ptpseconds
Attribute
The seconds portion of the alarm time in PTP seconds (see ptp.utcoffset).
Usage
schedule.alarm[x].ptpseconds [= seconds]
Remarks
1588 has too much resolution to represent in a single floating point value so the alarm
times are split into two values (seconds and fractional seconds).
Example
Create an alarm to occur 30 seconds from current time in PTP seconds.
sec,ns = ptp.time()
schedule.alarm[1].ptpseconds = sec + 30
schedule.alarm[x].repetition
Attribute
Specifies the number of times an alarm will repeat after the first alarm firing (the alarm
will fire a total of count+1 times). If 0 and period is non-zero, the alarm will fire
“forever”.
Once an alarm begins, the repetition will count down for each trigger generated. It will
end at zero (0). You must set this repetition back to some value if you intend to reissue
the alarm again. Otherwise, the alarm will either not fire (if period is zero) or will fire
“forever” (if period is non-zero).
Usage
schedule.alarm[x].repetition [= count]
Example
Set alarm to fire 10 times
schedule.alarm[1].repetition = 10
schedule.alarm[x].seconds
Attribute
The seconds portion of the alarm time in UTC seconds (see ptp.utcoffset).
Usage
schedule.alarm[x].seconds [= seconds]
Remarks
1588 has too much resolution to represent in a single floating point value so the alarm
times are split into two values (seconds and fractionalseconds).