forked from SixByNine/sigproc
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathbpphdr.h
332 lines (281 loc) · 13.6 KB
/
bpphdr.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
#ifndef BPP_HEADER_SIZE
#define BPP_HEADER_SIZE (1<<15)
#endif
#define MAXNUMCB 6
#define MAXREGS 8
#define NIBPERREG 4
#define MAXNUMDFB (2*MAXNUMCB)
#define MAX_NUM_LO_BOARDS MAXNUMCB
#define MAX_NUM_MF_BOARDS (2*MAX_NUM_LO_BOARDS)
#define FB_CHAN_PER_BRD 8
#define MAX_HARRIS_TAPS 256
#define MAXNUMCHAN (MAXNUMDFB*FB_CHAN_PER_BRD)
typedef struct {
/*
* Here are BPP header items
*/
char head[16]; /* Holds "NBPPSEARCH\0" */
long header_version; /* Version number which is different for each backend */
unsigned long scan_num; /* Scan number e.g. 31096001 = Obs 1 on day 310 of 1996 */
/* Changed to DDDYYYYSSS in Jan 2000 */
/* These doubles are all aligned on 8-byte boundaries */
double length_of_integration; /* if known in advance */
double samp_rate; /* Calculated from nbpp_sw ( in us despite name ) */
double ra_1950; /* Radians */
double dec_1950; /* Radians */
double tele_x; /* Carriage X position in m */
double tele_y; /* Carriage Y position in m */
double tele_z; /* Carriage Z position in m */
double tele_inc; /* Mirror inclination in deg */
double Fclk; /* Fast clock speed (Hz) */
double Har_Clk; /* Harris clock (H_deci_factor*bandwidth) */
double bandwidth; /* DSB channel bandwidth (== Sclk) */
double dfb_gain[MAXNUMDFB]; /* Gain that was applied to generate Harris coeffs */
/*
* AIB Configuration
*/
double aib_los[MAX_NUM_LO_BOARDS];
double mf_filt_width[MAX_NUM_MF_BOARDS];
double mf_atten[MAX_NUM_MF_BOARDS];
double rf_lo; /* LO frequency used in the receiver to generate the IF */
long bit_mode; /* 4 = 4-bit power, -4 = 4-bit voltage in direct mode */
long num_chans; /* Calculated number of 4-bit channels in each sample */
int lmst; /* LMST time in seconds since 0h */
char target_name[32]; /* Space for pulsar name or map name for survey */
char date[16]; /* UT date which will match the scan number */
char start_time[16]; /* UT time of the 1pps tick which started the obs*/
long scan_file_number; /* Which file number of the scan? */
long file_size; /* Size of this file */
long tape_num; /* Tape number */
long tape_file_number; /* File number on this tape */
char obs_group[16]; /* Who did the observation (mainly for future) */
int enabled_CBs; /* Bitmap of enabled CBs */
int mb_start_address; /* Real base (8-bit) address of first CB reg read */
int mb_end_address; /* Read end (8-bit) address of last CB reg read */
int mb_start_board; /* First board ID read */
int mb_end_board; /* last board ID read (MB can only read seq. boards) */
int mb_vme_mid_address; /* Value stored in VME_MID register (usu. 00) */
int mb_ack_enabled; /* Boolean, did we use ACK protocol? */
int start_from_ste; /* Boolean, am I starting with the STE counter? */
/*
* CB Registers
*/
int cb_sum_polarizations; /* Boolean, did the CBs sum pols on-board? */
int cb_direct_mode; /* Boolean, did we read the CBs in direct-mode? */
int cb_eprom_mode[MAXNUMCB]; /* Which EPROM table? (MAXNUMCB=6) */
int cb_accum_length; /* Contents of CB accum len regs (all CBs IDENTICAL) */
/* cb_accum_length is TOTAL accum length, not accum_len-1 */
/**
* TB Registers
*/
int tb_outs_reg; /* OUTS_REG, turns on/off analog supply and PLLs */
int tb_ste; /* Value stored in STE counter */
int tb_stc; /* This need to be read AFTER an integration!!! */
int H_deci_factor; /* Decimation factor */
int GenStat0, GenStat1, Ack_Reg; /* HW registers, for debugging */
/*
* DFB Registers
*/
/* These first three are the "logical" state of the DFBs */
int dfb_sram_length; /* Same for every board??? */
int ASYMMETRIC; /* Currently the same for all boards */
float dfb_sram_freqs[FB_CHAN_PER_BRD]; /* Filled in by setmixer_board (8) */
/* These three are for HW debugging, not to be used by analysis software */
int dfb_mixer_reg[MAXNUMDFB]; /* Set by set_dfb_mixer (MAXNUMDFB=12) */
int dfb_conf_reg[MAXNUMDFB]; /* Set by set_dfb_conf */
int dfb_sram_addr_msb[MAXNUMDFB]; /* Set by set_dfb_conf */
/* These are the ACTUAL Harris taps loaded into the DFBs */
int i_hcoef[MAX_HARRIS_TAPS]; /* MAX_HARRIS_TAPS=256 */
int q_hcoef[MAX_HARRIS_TAPS];
/*
* Hardware configuration
*/
int tb_id;
int cb_id[MAXNUMCB];
int dfb_id[MAXNUMDFB];
int aib_if_switch; /* Which IF input are we using? (Same for both Pols) */
/* matt add new stuff here */
/* Additional Hardware information, 97apr25 MRD */
int mb_rev, mb_serial;
int tb_rev, tb_serial;
int cb_rev[MAXNUMCB], cb_serial[MAXNUMCB];
int dfb_rev[MAXNUMDFB], dfb_serial[MAXNUMDFB];
int mb_xtal_freq;
int mf_serial[MAX_NUM_MF_BOARDS], mf_rev[MAX_NUM_MF_BOARDS];
int lo_serial[MAX_NUM_LO_BOARDS], lo_rev[MAX_NUM_LO_BOARDS];
int mb_long_ds0; /* lengthen DS0 on vme reads with ack enabled */
int dfb_sun_program[MAXNUMDFB]; /* Set by set_dfb_mode */
int dfb_eprom[MAXNUMDFB]; /* Set by set_dfb_mode */
int dfb_sram_addr[MAXNUMDFB]; /* rev 4 Set by set_dfb_conf */
int dfb_har_addr[MAXNUMDFB]; /* rev 4 Set by set_dfb_conf */
int dfb_clip_adc_neg8[MAXNUMDFB]; /* for use in DFB mixer table */
int dfb_shften_[MAXNUMDFB]; /* for low level Harris mode */
int dfb_fwd_[MAXNUMDFB]; /* for low level Harris mode */
int dfb_rvrs_[MAXNUMDFB]; /* for low level Harris mode */
int dfb_asymmetric[MAXNUMDFB]; /* what kind of taps to load ? */
double dfb_i_dc[MAXNUMDFB]; /* set when programming the Mixer SRAM*/
double dfb_q_dc[MAXNUMDFB]; /* set when programming the Mixer SRAM*/
double max_dfb_freq; /* used in picking decimations */
/*
* pre 97apr25 was 29780
* pre 97oct29 was 28844
* pre 98jan20 was 28836
*/
int aib_serial;
int aib_rev;
/*
* (long long) file_size and offset where added August 1999 to the
* source tree. Prior to this time, or when the production binaries
* where updated for a particular backend, these values will hold 0
* and you should use the (long) file_size above. Note, there was
* no equivalent offset number prior to ll_file_offset.
*/
long long ll_file_offset; /* Cummulative size of all of the previous */
/* files in this scan (Bytes) which can, */
/* e.g. be used to calculate the start time */
/* of this file. */
long long ll_file_size; /* Size of this particular file (Bytes). */
char quad_word_boundary_filler[8];
long double mjd_start; /* Start time (MJD) */
char filler[28788];
long BACKEND_TYPE;
long UPDATE_DONE;
long HEADER_TYPE;
} BPP_SEARCH_HEADER;
#define TIMING_TYPE 1 /* 2d array of unsigned longs */
#define TIMING_LONG_TYPE 1 /* 2d array of unsigned longs */
#define TIMING_FLOAT_TYPE 3 /* 2d array of floats */
typedef struct {
/* In this part, double=8bytes, long=4bytes, if not, fix it! */
char head[16]; /* Holds "NBPPTIME\0" */
long header_version; /* Version number which is different for each backend */
long scan_num; /* Scan number e.g. 31096001 = Obs 1 on day 310 of 1996 */
double psr_period;
double samp_rate; /* Sample rate in (us). Note, in the case */
/* of oversampling this is the integrated */
/* sample rate not the hardware rate. */
double psr_dm;
double length_of_integration; /* An estimate that does NOT take into */
/* account the doppler corrections to */
/* samp_rate. For true integration time, */
/* the polyco.dat entry appended on the end */
/* of the scan must be consulted. */
char psr_name[16];
long scan_file_number; /* Which file number of the scan? */
long stc; /* Unused, use stctime instead. */
long num_phase_bins;
long num_periods; /* exact number of pulse periods integrated */
long sizeof_polyco;
long oversample; /* How many hardware samples are integrated */
/* before accumulating in the pulse profile */
/* (note, a 0 should be interpreted as a 1). */
/* These doubles are all aligned on 8-byte boundaries */
double ra_1950; /* Radians */
double dec_1950; /* Radians */
double tele_x; /* Carriage X position in m */
double tele_y; /* Carriage Y position in m */
double tele_z; /* Carriage Z position in m */
double tele_inc; /* Mirror inclination in deg */
double Fclk; /* Fast clock speed (Hz) */
double Har_Clk; /* Harris clock (H_deci_factor*bandwidth) */
double bandwidth; /* DSB channel bandwidth (== Sclk) */
double dfb_gain[MAXNUMDFB]; /* Gain that was applied to generate Harris coeffs */
/*
* AIB Configuration
*/
double aib_los[MAX_NUM_LO_BOARDS];
double mf_filt_width[MAX_NUM_MF_BOARDS];
double mf_atten[MAX_NUM_MF_BOARDS];
double rf_lo; /* LO frequency used in the receiver to generate the IF */
long bit_mode; /* 4 = 4-bit power, -4 = 4-bit voltage in direct mode */
long num_chans; /* Calculated number of 4-bit channels in each sample */
int lmst; /* LMST time in seconds since 0h */
char target_name[32]; /* Space for pulsar name or map name for survey */
char date[16]; /* UT date which will match the scan number */
char start_time[16]; /* UT time of the 1pps tick which started the obs*/
long file_size; /* Size of this file */
long tape_num; /* Tape number */
long tape_file_number; /* File number on this tape */
char obs_group[16]; /* Who did the observation (mainly for future) */
int enabled_CBs; /* Bitmap of enabled CBs */
int mb_start_address; /* Real base (8-bit) address of first CB reg read */
int mb_end_address; /* Read end (8-bit) address of last CB reg read */
int mb_start_board; /* First board ID read */
int mb_end_board; /* last board ID read (MB can only read seq. boards) */
int mb_vme_mid_address; /* Value stored in VME_MID register (usu. 00) */
int mb_ack_enabled; /* Boolean, did we use ACK protocol? */
int start_from_ste; /* Boolean, am I starting with the STE counter? */
/*
* CB Registers
*/
int cb_sum_polarizations; /* Boolean, did the CBs sum pols on-board? */
int cb_direct_mode; /* Boolean, did we read the CBs in direct-mode? */
int cb_eprom_mode[MAXNUMCB]; /* Which EPROM table? (MAXNUMCB=6) */
int cb_accum_length; /* Contents of CB accum len regs (all CBs IDENTICAL) */
/* cb_accum_length is TOTAL accum length, not accum_len-1 */
/**
* TB Registers
*/
int tb_outs_reg; /* OUTS_REG, turns on/off analog supply and PLLs */
int tb_ste; /* Value stored in STE counter */
int tb_stc; /* This need to be read AFTER an integration!!! */
int H_deci_factor; /* Decimation factor */
int GenStat0, GenStat1, Ack_Reg; /* HW registers, for debugging */
/*
* DFB Registers
*/
/* These first three are the "logical" state of the DFBs */
int dfb_sram_length; /* Same for every board??? */
int ASYMMETRIC; /* Currently the same for all boards */
float dfb_sram_freqs[FB_CHAN_PER_BRD]; /* Filled in by setmixer_board (8) */
/* These three are for HW debugging, not to be used by analysis software */
int dfb_mixer_reg[MAXNUMDFB]; /* Set by set_dfb_mixer (MAXNUMDFB=12) */
int dfb_conf_reg[MAXNUMDFB]; /* Set by set_dfb_conf */
int dfb_sram_addr_msb[MAXNUMDFB]; /* Set by set_dfb_conf */
/* These are the ACTUAL Harris taps loaded into the DFBs */
int i_hcoef[MAX_HARRIS_TAPS]; /* MAX_HARRIS_TAPS=256 */
int q_hcoef[MAX_HARRIS_TAPS];
/*
* Hardware configuration
*/
int tb_id;
int cb_id[MAXNUMCB];
int dfb_id[MAXNUMDFB];
int aib_if_switch; /* Which IF input are we using? (Same for both Pols) */
/* matt add new stuff here */
/* Additional Hardware information, 97apr25 MRD */
int mb_rev, mb_serial;
int tb_rev, tb_serial;
int cb_rev[MAXNUMCB], cb_serial[MAXNUMCB];
int dfb_rev[MAXNUMDFB], dfb_serial[MAXNUMDFB];
int mb_xtal_freq;
int mf_serial[MAX_NUM_MF_BOARDS], mf_rev[MAX_NUM_MF_BOARDS];
int lo_serial[MAX_NUM_LO_BOARDS], lo_rev[MAX_NUM_LO_BOARDS];
int mb_long_ds0; /* lengthen DS0 on vme reads with ack enabled */
int dfb_sun_program[MAXNUMDFB]; /* Set by set_dfb_mode */
int dfb_eprom[MAXNUMDFB]; /* Set by set_dfb_mode */
int dfb_sram_addr[MAXNUMDFB]; /* rev 4 Set by set_dfb_conf */
int dfb_har_addr[MAXNUMDFB]; /* rev 4 Set by set_dfb_conf */
int dfb_clip_adc_neg8[MAXNUMDFB]; /* for use in DFB mixer table */
int dfb_shften_[MAXNUMDFB]; /* for low level Harris mode */
int dfb_fwd_[MAXNUMDFB]; /* for low level Harris mode */
int dfb_rvrs_[MAXNUMDFB]; /* for low level Harris mode */
int dfb_asymmetric[MAXNUMDFB]; /* what kind of taps to load ? */
double dfb_i_dc[MAXNUMDFB]; /* set when programming the Mixer SRAM*/
double dfb_q_dc[MAXNUMDFB]; /* set when programming the Mixer SRAM*/
double max_dfb_freq; /* used in picking decimations */
int aib_serial;
int aib_rev;
double tick_offset; /* delay from 1sec tick to start time (usec) */
double startup_latency; /* estimated (by Matt?) time delay through */
/* system (usec) */
double initial_phase_offset; /* Time offset to correct start time */
/* from first sample at an arbitrary */
/* phase to the start time of the */
/* first folded phase bin (sec). */
double stctime; /* STC counter converted to sec. */
char filler[28746];
long BACKEND_TYPE;
long UPDATE_DONE;
long HEADER_TYPE;
} BPP_TIMING_HEADER;