ahp_xc.h

 
#ifndef _AHP_XC_H
#define _AHP_XC_H
 
#ifdef  __cplusplus
extern "C" {
#endif
#ifdef _WIN32
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT extern
#endif
 
#include <unistd.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
 
#ifndef AHP_DEBUG
#define AHP_DEBUG
#define AHP_DEBUG_INFO 0
#define AHP_DEBUG_ERROR 1
#define AHP_DEBUG_WARNING 2
#define AHP_DEBUG_DEBUG 3
DLL_EXPORT void ahp_set_debug_level(int32_t value);
DLL_EXPORT int32_t ahp_get_debug_level();
DLL_EXPORT void ahp_set_app_name(char* name);
DLL_EXPORT char* ahp_get_app_name();
DLL_EXPORT void ahp_set_stdout(FILE *f);
DLL_EXPORT void ahp_set_stderr(FILE *f);
#endif
 
#define AHP_XC_VERSION 0x138
#define XC_BASE_RATE ((int)57600)
#define XC_HIGH_RATE ((int)230400)
#define AHP_XC_PLL_FREQUENCY 400000000
#define AHP_XC_LEDS_MASK 0x3
 
typedef enum {
HAS_CROSSCORRELATOR = 1,
HAS_LEDS = 2,
HAS_PSU = 4,
HAS_CUMULATIVE_ONLY = 8
} xc_header_flags;
 
typedef enum {
    R_BASE = 0,
    R_BASEX2 = 1,
    R_BASEX4 = 2,
    R_BASEX8 = 3,
    R_BASEX16 = 4,
} baud_rate;
 
typedef enum {
CLEAR = 0,
SET_INDEX = 1,
SET_LEDS = 2,
SET_BAUD_RATE = 3,
SET_VOLTAGE = 4,
SET_DELAY = 8,
ENABLE_TEST = 12,
ENABLE_CAPTURE = 13
} xc_cmd;
 
typedef enum {
CAP_NONE = 0,
CAP_ENABLE = 1,
CAP_EXT_CLK = 2,
CAP_RESET_TIMESTAMP = 4,
CAP_EXTRA_CMD = 8,
CAP_ALL = 0xf,
} xc_capture_flags;
 
typedef enum {
TEST_NONE = 0,
SCAN_AUTO = 1<<1,
SCAN_CROSS = 1<<2,
TEST_BCM = 1<<3,
TEST_STEP = 7<<5,
TEST_ALL = 0xf,
} xc_test_flags;
 
typedef struct {
double lag;
int64_t real;
int64_t imaginary;
uint64_t counts;
double magnitude;
double phase;
} ahp_xc_correlation;
 
typedef struct {
double lag;
uint64_t lag_size;
ahp_xc_correlation *correlations;
} ahp_xc_sample;
 
typedef struct {
double timestamp;
uint64_t n_lines;
uint64_t n_baselines;
uint64_t tau;
uint64_t bps;
uint64_t cross_lag;
uint64_t auto_lag;
uint64_t* counts;
ahp_xc_sample* autocorrelations;
ahp_xc_sample* crosscorrelations;
void *lock;
const char* buf;
} ahp_xc_packet;
 
DLL_EXPORT double* ahp_xc_get_2d_projection(double alt, double az, double *baseline);
DLL_EXPORT uint64_t ahp_xc_max_threads(uint64_t value);
 
DLL_EXPORT int32_t ahp_xc_connect(const char *port, int32_t high_rate);
 
DLL_EXPORT int32_t ahp_xc_connect_fd(int32_t fd);
 
DLL_EXPORT int32_t ahp_xc_get_fd();
 
DLL_EXPORT void ahp_xc_disconnect(void);
 
DLL_EXPORT uint32_t ahp_xc_is_connected(void);
 
DLL_EXPORT uint32_t ahp_xc_is_detected(void);
 
DLL_EXPORT int32_t ahp_xc_get_baudrate(void);
 
DLL_EXPORT void ahp_xc_set_baudrate(baud_rate rate);
 
DLL_EXPORT void ahp_xc_set_correlation_order(uint32_t order);
 
DLL_EXPORT int32_t ahp_xc_get_correlation_order();
DLL_EXPORT int32_t ahp_xc_get_properties(void);
 
DLL_EXPORT char* ahp_xc_get_header(void);
 
DLL_EXPORT uint32_t ahp_xc_get_bps(void);
 
DLL_EXPORT uint32_t ahp_xc_get_nlines(void);
 
DLL_EXPORT uint32_t ahp_xc_get_nbaselines(void);
 
DLL_EXPORT int32_t ahp_xc_get_crosscorrelation_index(int32_t *lines, int32_t order);
 
DLL_EXPORT int32_t ahp_xc_get_line_index(int32_t idx, int32_t order);
 
DLL_EXPORT uint32_t ahp_xc_get_nbaseprisms(int32_t order);
 
DLL_EXPORT uint32_t ahp_xc_get_delaysize(void);
 
DLL_EXPORT uint32_t ahp_xc_get_autocorrelator_lagsize(void);
 
DLL_EXPORT uint32_t ahp_xc_get_crosscorrelator_lagsize(void);
 
DLL_EXPORT double ahp_xc_get_frequency(void);
 
DLL_EXPORT double ahp_xc_get_sampletime(void);
 
DLL_EXPORT double ahp_xc_get_packettime(void);
 
DLL_EXPORT uint32_t ahp_xc_get_packetsize(void);
 
DLL_EXPORT void ahp_xc_enable_intensity_crosscorrelator(int32_t enable);
 
DLL_EXPORT int32_t ahp_xc_intensity_crosscorrelator_enabled();
 
DLL_EXPORT void ahp_xc_enable_crosscorrelator(int32_t enable);
 
DLL_EXPORT int32_t ahp_xc_has_crosscorrelator(void);
 
DLL_EXPORT int32_t ahp_xc_has_psu(void);
 
DLL_EXPORT int32_t ahp_xc_has_leds(void);
 
DLL_EXPORT int32_t ahp_xc_has_cumulative_only();
 
DLL_EXPORT ahp_xc_packet *ahp_xc_alloc_packet(void);
 
DLL_EXPORT ahp_xc_packet *ahp_xc_copy_packet(ahp_xc_packet *packet);
 
DLL_EXPORT void ahp_xc_free_packet(ahp_xc_packet *packet);
 
DLL_EXPORT ahp_xc_sample *ahp_xc_alloc_samples(uint64_t nlines, size_t size);
 
DLL_EXPORT ahp_xc_sample *ahp_xc_copy_samples(ahp_xc_sample* src, uint64_t nlines, size_t size);
 
DLL_EXPORT void ahp_xc_free_samples(uint64_t nlines, ahp_xc_sample *samples);
 
DLL_EXPORT int32_t ahp_xc_get_packet(ahp_xc_packet *packet);
 
DLL_EXPORT void ahp_xc_start_autocorrelation_scan(uint32_t index, off_t start, size_t size, size_t step);
 
DLL_EXPORT void ahp_xc_end_autocorrelation_scan(uint32_t index);
 
DLL_EXPORT int32_t ahp_xc_scan_autocorrelations(uint32_t nlines, uint32_t *indexes, ahp_xc_sample **autocorrelations, off_t *starts, size_t *sizes, size_t *steps, int32_t *interrupt, double *percent);
 
DLL_EXPORT void ahp_xc_start_crosscorrelation_scan(uint32_t index, off_t start, size_t size, size_t step);
 
DLL_EXPORT void ahp_xc_end_crosscorrelation_scan(uint32_t index);
 
DLL_EXPORT int32_t ahp_xc_scan_crosscorrelations(uint32_t index1, uint32_t index2, ahp_xc_sample **crosscorrelations, off_t start1, size_t size1, off_t start2, size_t size2, size_t step, int32_t *interrupt, double *percent);
 
DLL_EXPORT int32_t ahp_xc_set_capture_flags(xc_capture_flags flags);
 
DLL_EXPORT xc_capture_flags ahp_xc_get_capture_flags();
 
DLL_EXPORT void ahp_xc_set_leds(uint32_t index, int32_t leds);
 
DLL_EXPORT void ahp_xc_set_channel_cross(uint32_t index, off_t value, size_t size, size_t step);
 
DLL_EXPORT void ahp_xc_set_channel_auto(uint32_t index, off_t value, size_t size, size_t step);
 
DLL_EXPORT void ahp_xc_set_frequency_divider(unsigned char value);
 
DLL_EXPORT void ahp_xc_set_voltage(uint32_t index, unsigned char value);
 
DLL_EXPORT void ahp_xc_set_test_flags(uint32_t index, int32_t test);
 
DLL_EXPORT unsigned char ahp_xc_get_test_flags(uint32_t index);
 
DLL_EXPORT unsigned char ahp_xc_get_leds(uint32_t index);
 
DLL_EXPORT void ahp_xc_select_input(uint32_t index);
 
DLL_EXPORT uint32_t ahp_xc_current_input();
 
DLL_EXPORT int32_t ahp_xc_send_command(xc_cmd cmd, unsigned char value);
 
DLL_EXPORT inline uint32_t ahp_xc_get_version(void) { return AHP_XC_VERSION; }
 
#ifdef __cplusplus
} // extern "C"
#endif
 
#endif //_AHP_XC_H