bpm_get_raw_tbt_data_c

	status.i4.v = bpm_get_raw_tbt_data_c(detector.ch.d, max_turns.i4.v,
					     data.g.v, time_stamps.u4a.r,
					     num_turns.i4.r, filter_data.i4.v,
					     time.u4.r, readout_spec.g.v,
					     metadata.g.v)

	This routine retrieves raw BPM turn by turn data for the machine last
	requested by a call to bpm_machine_c.

	detector	ASCII detector name (BPM_TBT_NAME_LEN characters)
	max_turns	maximum number of turns to return
	data		returned raw turn by turn position data
			(BPM_TEVATRON -> array of structures of type
					 BPM_TEVATRON_IQ_DATA,
			 BPM_TEV_DEVL -> array of structures of type
					 BPM_TEVATRON_IQ_DATA,
			 BPM_MAIN_INJECTOR -> array of structures of type
					      BPM_MI_IQ_DATA,
			 BPM_MI_DEVL -> array of structures of type
					BPM_MI_IQ_DATA,
			 BPM_RECYCLER -> array of structures of type
					 BPM_RECYCLER_IQ_DATA)
			(A value of NULL can be passed if this information
			 is not needed.)
	time_stamps	returned turn by turn time stamps in microseconds
			since cycle reset
	num_turns	returned number of valid turns
	filter_data	filter data flag
			(TRUE -> filter out or mark bad data,
			 FALSE -> return data as it is)
	time		timestamp in clinks when the data was taken
			(A value of NULL may be passed if this value is
			 not desired.)
	readout_spec	readout specification
			(BPM_TEVATRON -> structure of type
					 BPM_TEVATRON_READOUT_SPEC,
			 BPM_TEV_DEVL -> structure of type
					 BPM_TEVATRON_READOUT_SPEC,
			 BPM_MAIN_INJECTOR -> structure of type
					      BPM_MI_READOUT_SPEC,
			 BPM_MI_DEVL -> structure of type
					BPM_MI_READOUT_SPEC,
			 BPM_RECYCLER -> structure of type
					 BPM_RECYCLER_READOUT_SPEC)
			(A value of NULL can be passed for this argument.)
	metadata	returned metadata structure
			(BPM_TEVATRON -> structure of type
					 BPM_TEVATRON_METADATA,
			 BPM_TEV_DEVL -> structure of type
					 BPM_TEVATRON_METADATA,
			 BPM_MAIN_INJECTOR -> structure of type
					      BPM_MI_METADATA,
			 BPM_MI_DEVL -> structure of type
					BPM_MI_METADATA,
			 BPM_RECYCLER -> structure of type
					 BPM_RECYCLER_METADATA)
			(A value of NULL may be passed if this value is
			 not desired.)

	This function returns ACNET status values as follows:

	OK			success
	CBS_NOTYET		not supported for the currently selected
				machine
	CBS_INVARG		invalid detector requested
	CBS_NODAT		no turns are available
	CBS_CORRUPT		raw data from BPM is corrupt
	otherwise		other ACNET error

	This function requires the following include files:

	ul_cbsaux/bpmuti.h, acnet_errors_h

	Related functions:

	bpm_machine_c, bpm_get_tbt_data_c, bpm_get_tbt_intensity_c,
	bpm_data_source_c, bpm_get_tbt_names, bpm_get_tbt_crates_and_channels,
	bpm_enable_tbt_trigger_c, bpm_get_tbt_timing_c, bpm_set_tbt_timing_c,
	bpm_get_global_tbt_timing_c, bpm_set_global_tbt_timing_c,
	bpm_is_tbt_trigger_enabled

	C/C++ usage:

	static const char	detector[BPM_TBT_NAME_LEN+1] = "HE11";
	int	status;
	int	max_turns = BPM_NUM_TBT_VALUES;
	int	num_turns;
	int	filter_data = TRUE;
	unsigned int	time_stamps[BPM_NUM_TBT_VALUES];
	unsigned int	time;
	void	*readout_spec = (void *) NULL;
	void	*metadata = (void *) NULL;
	BPM_TEVATRON_IQ_DATA	data[BPM_NUM_TBT_VALUES];

	status = bpm_get_raw_tbt_data_c(detector,max_turns,(void *) data,
					time_stamps,&num_turns,filter_data,
					&time,readout_spec,metadata);