Appendix A API Command Reference
NetScan User’s Manual A-15
*T - Time Stamping
TYPE
System
EXECUTION
Immediate
SYNTAX
*Tstate
Specify whether or not time stamping will be enabled. Valid options for
state are: 0 - Disable time stamping (default), 1 - Enable absolute time
stamping, and 2 - Enable relative time stamping.
DESCRIPTION
The Time Stamping (*T) command, when enabled, will append a time/date time stamp to each s can being sent
by the unit to the controller:
If absolute time stamping is enabled, the format is HH:MM:SS.MIL, MM/DD/YY
where MIL = milliseconds.
If relative time stamping is enabled, the format is ±HH:MM:SS.MIL, DDDDDDD
where MIL = milliseconds and DDDDDDD = days.
In the relative mode, the time stamps are relative to the trigger sc an which i s time stamped
+00:00:00.000,0000000. This implies that the pre-trigger scans are negative (-) and post trigger scans
are positive (+). Refer to the Time Stamping section of Appendix C for details.
Note: Relative time stamping will not be valid if you attempt to use it in conjunction with continuous, gap-free
acquisitions with two timebases. In addition, time stamping i s not valid in burst mode.
Note: If the output format is binary instead of ASCII, the time stamp is returned as ten eight-bit bytes in 2h
(2-hexidecimal) digit format. Examples for absolute and relative time s t amp formats are provided below.
Note that the 2h digit format can not be printed.
EXAMPLE
PRINT#1,"*T1X"
‘ Enable absolute time stamping
PRINT#1,"*T2X"
‘ Enable relative time stamping
PRINT#1,"*T0X"
‘ Disable time stamping
Format Examples of Absolute and Relative Time Stamping
Absolute Time Stamping
ASCII and 2h Digit Examples for:
3 p.m., 2 min & 5 secs. after hour; July 9, 1997
ASCII format: 15:02:05.000, 07/09/97
Relative Time Stamping
ASCII and 2h Digit Examples for:
14 hours, 30 minutes, 10 days
ASCII format: +14:30:00.000, 00000010
ASCII
2h
Time Increment
ASCII
2h
Time Increment
15
0F
Hour
14
0E
Hour
02
02
Minute
30
1E
Minute
05
05
Second
00
00
Second
000
00
Milliseconds (for ASCII)
000
00
Milliseconds (for ASCII)
00
Microseconds (for 2h digit)
00
Microseconds (for 2h digit)
00
(low high)
00
(low high)
00
00
07
07
Month
00000010
0A
Day
09
09
Day
00
(low high)
97
61
Year
00