niSync Read Trigger Time Stamp (VI)

Installed With: NI-Sync

Reads timestamps recorded on the internal software buffer for the specified terminal. You must call niSync Enable Time Stamp Trigger for this VI to return any timestamps.

Use the pull-down menu to select an instance of this VI.

niSync Read Trigger Time Stamp (Multiple)

Use this VI to return multiple timestamps into an array.

niSync Read Trigger Time Stamp (Multiple)

cio.gif

instrument handle specifies the instrument handle that you obtain from niSync Initialize.

cio.gif

terminal specifies the terminal that contains the trigger signal you would like to read timestamps from.

cdbl.gif

timeout specifies the time to wait, in seconds, for a timestamp to be generated. If the VI can't find any timestamps to read on the specified terminal, it returns a timeout error and stops the program. The default value is 10 seconds.

cu32.gif

number of timestamps specifies the number of timestamps to read. If there are fewer timestamps than you specify available before the timeout value elapses, the VI will return all the timestamps and detected edges it read before the timeout.

cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

instrument handle out returns the instrument handle that you obtain from niSync Initialize.

itimestamp.gif

time stamp out returns the oldest unread timestamp(s) detected on the specified trigger terminal. The timestamp is removed from the software buffer when it is read.

i1denum.gif

detected edges returns the detected trigger conditions of the read timestamps. The values are returned into an array whose size is equal to the number of timestamps read.

ierrcodeclst.gif

error out returns error conditions that occur after this node runs. This output provides standard error out functionality.

niSync Read Trigger Time Stamp (Single)

Reads a timestamp recorded on the internal software buffer for a specific terminal.

You must call Enable Time Stamp Trigger for this VI to return a timestamp.

Instance Details

niSync Read Trigger Time Stamp (Single)

cio.gif

instrument handle specifies the instrument handle that you obtain from niSync Initialize.

cio.gif

terminal specifies the terminal that contains the trigger signal you would like to read timestamps from.

cdbl.gif

timeout specifies the time to wait, in seconds, for a timestamp to be generated. If the VI can't find any timestamps to read on the specified terminal, it returns a timeout error and stops the program. The default value is 10 seconds.

cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

instrument handle out returns the instrument handle that you obtain from niSync Initialize.

itimestamp.gif

time stamp out returns the oldest unread timestamp(s) detected on the specified trigger terminal. The timestamp is removed from the software buffer when it is read.

ienum.gif

detected edge returns the detected trigger condition (either rising or falling) of the timestamp.

ierrcodeclst.gif

error out returns error conditions that occur after this node runs. This output provides standard error out functionality.

niSync Read Trigger Time Stamp (Single) Details

Troubleshooting a Full Buffer

If the buffer associated with terminal is full, timestamp and trigger timestamp operations are suspended and you receive Error -1074118582. This function continues to return previously generated timestamps, despite the overflow condition, until no timestamps are available. You can clear this error condition using Disable Time Stamp Trigger, or you can expand the size of the timestamp buffer using niSync Properties.