/* Copyright (c) 2013-2024, Youssef Touil Copyright (c) 2013-2017, Ian Gilmour Copyright (c) 2013-2017, Benjamin Vernoux Copyright (c) 2013, Michael Ossmann Copyright (c) 2012, Jared Boone All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of Airspy HF+ nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef __AIRSPYHF_H__ #define __AIRSPYHF_H__ #include #include #include #include #include #include "libusb.h" #include #include #define AIRSPYHF_VERSION "1.8.0" #define AIRSPYHF_VER_MAJOR 1 #define AIRSPYHF_VER_MINOR 8 #define AIRSPYHF_VER_REVISION 0 #define AIRSPYHF_ENDPOINT_IN (1) #if defined(_WIN32) && !defined(STATIC_AIRSPYHFPLUS) #define ADD_EXPORTS /* You should define ADD_EXPORTS *only* when building the DLL. */ #ifdef ADD_EXPORTS #define ADDAPI __declspec(dllexport) #else #define ADDAPI __declspec(dllimport) #endif /* Define calling convention in one place, for convenience. */ #define ADDCALL __cdecl #else /* _WIN32 not defined. */ /* Define with no value on non-Windows OSes. */ #define ADDAPI #define ADDCALL #endif #ifdef __cplusplus extern "C" { #endif #define RAW_BUFFER_COUNT (8) enum airspyhf_error { AIRSPYHF_SUCCESS = 0, AIRSPYHF_ERROR = -1, AIRSPYHF_UNSUPPORTED = -2 }; typedef struct { float re; float im; } airspyhf_complex_float_t; typedef struct { uint32_t part_id; uint32_t serial_no[4]; } airspyhf_read_partid_serialno_t; enum airspyhf_board_id { AIRSPYHF_BOARD_ID_UNKNOWN_AIRSPYHF = 0, AIRSPYHF_BOARD_ID_AIRSPYHF_REV_A = 1, AIRSPYHF_BOARD_ID_AIRSPYHF_DISCOVERY_REV_A = 2, AIRSPYHF_BOARD_ID_INVALID = 0xFF, }; #pragma pack(push,1) typedef struct { int16_t im; int16_t re; } airspyhf_complex_int16_t; #pragma pack(pop) typedef struct airspyhf_device airspyhf_device_t; typedef struct { airspyhf_device_t* device; void* ctx; airspyhf_complex_float_t* samples; int sample_count; uint64_t dropped_samples; } airspyhf_transfer_t; typedef struct { uint32_t major_version; uint32_t minor_version; uint32_t revision; } airspyhf_lib_version_t; #define MAX_NAME_STRING_SIZE (64) #define MAX_VERSION_STRING_SIZE MAX_NAME_STRING_SIZE typedef int (*airspyhf_sample_block_cb_fn) (airspyhf_transfer_t* transfer_fn); typedef struct airspyhf_device { libusb_context* usb_context; libusb_device_handle* usb_device; struct libusb_transfer** transfers; airspyhf_sample_block_cb_fn callback; pthread_t transfer_thread; pthread_t consumer_thread; bool transfer_thread_running; bool consumer_thread_running; pthread_cond_t consumer_cv; pthread_mutex_t consumer_mp; uint32_t supported_samplerate_count; uint32_t *supported_samplerates; uint8_t *samplerate_architectures; uint32_t supported_att_step_count; float *supported_att_steps; volatile uint32_t current_samplerate; volatile double freq_hz; volatile uint32_t freq_khz; volatile double freq_delta_hz; volatile double freq_shift; volatile int32_t calibration_ppb; volatile int32_t calibration_vctcxo; volatile uint32_t frontend_options; volatile float optimal_point; uint8_t enable_dsp; uint8_t is_low_if; float filter_gain; airspyhf_complex_float_t vec; struct iq_balancer_t *iq_balancer; volatile int32_t iq_balancer_eval_skip; uint32_t transfer_count; int32_t transfer_live; uint32_t buffer_size; uint32_t dropped_buffers; uint32_t dropped_buffers_queue[RAW_BUFFER_COUNT]; airspyhf_complex_int16_t *received_samples_queue[RAW_BUFFER_COUNT]; volatile bool streaming; volatile bool stop_requested; volatile int received_samples_queue_head; volatile int received_samples_queue_tail; volatile int received_buffer_count; airspyhf_complex_float_t *output_buffer; void* ctx; } airspyhf_device_t; extern ADDAPI void ADDCALL airspyhf_lib_version(airspyhf_lib_version_t* lib_version); extern ADDAPI int ADDCALL airspyhf_list_devices(uint64_t *serials, int count); extern ADDAPI int ADDCALL airspyhf_open(airspyhf_device_t** device); extern ADDAPI int ADDCALL airspyhf_open_sn(airspyhf_device_t** device, uint64_t serial_number); extern ADDAPI int ADDCALL airspyhf_open_fd(airspyhf_device_t** device, int fd); extern ADDAPI int ADDCALL airspyhf_close(airspyhf_device_t* device); extern ADDAPI int ADDCALL airspyhf_get_output_size(airspyhf_device_t* device); /* Returns the number of IQ samples to expect in the callback */ extern ADDAPI int ADDCALL airspyhf_start(airspyhf_device_t* device, airspyhf_sample_block_cb_fn callback, void* ctx); extern ADDAPI int ADDCALL airspyhf_stop(airspyhf_device_t* device); extern ADDAPI int ADDCALL airspyhf_is_streaming(airspyhf_device_t* device); extern ADDAPI int ADDCALL airspyhf_is_low_if(airspyhf_device_t* device); /* Tells if the current sample rate is Zero-IF (0) or Low-IF (1) */ extern ADDAPI int ADDCALL airspyhf_set_freq(airspyhf_device_t* device, const uint32_t freq_hz); extern ADDAPI int ADDCALL airspyhf_set_freq_double(airspyhf_device_t* device, const double freq_hz); extern ADDAPI int ADDCALL airspyhf_set_lib_dsp(airspyhf_device_t* device, const uint8_t flag); /* Enables/Disables the IQ Correction, IF shift and Fine Tuning. */ extern ADDAPI int ADDCALL airspyhf_get_samplerates(airspyhf_device_t* device, uint32_t* buffer, const uint32_t len); extern ADDAPI int ADDCALL airspyhf_set_samplerate(airspyhf_device_t* device, uint32_t samplerate); extern ADDAPI int ADDCALL airspyhf_set_att(airspyhf_device_t* device, float value); extern ADDAPI int ADDCALL airspyhf_get_att_steps(airspyhf_device_t* device, void* buffer, const uint32_t len); extern ADDAPI int ADDCALL airspyhf_set_bias_tee(airspyhf_device_t* device, int8_t value); extern ADDAPI int ADDCALL airspyhf_get_bias_tee_count(airspyhf_device_t* device, int32_t* count); extern ADDAPI int ADDCALL airspyhf_get_bias_tee_name(airspyhf_device_t* device, int32_t index, char* version, uint8_t length); extern ADDAPI int ADDCALL airspyhf_get_calibration(airspyhf_device_t* device, int32_t* ppb); extern ADDAPI int ADDCALL airspyhf_set_calibration(airspyhf_device_t* device, int32_t ppb); extern ADDAPI int ADDCALL airspyhf_get_vctcxo_calibration(airspyhf_device_t* device, uint16_t* vc); extern ADDAPI int ADDCALL airspyhf_set_vctcxo_calibration(airspyhf_device_t* device, uint16_t vc); extern ADDAPI int ADDCALL airspyhf_get_frontend_options(airspyhf_device_t* device, uint32_t* flags); extern ADDAPI int ADDCALL airspyhf_set_frontend_options(airspyhf_device_t* device, uint32_t flags); extern ADDAPI int ADDCALL airspyhf_set_optimal_iq_correction_point(airspyhf_device_t* device, float w); extern ADDAPI int ADDCALL airspyhf_iq_balancer_configure(airspyhf_device_t* device, int buffers_to_skip, int fft_integration, int fft_overlap, int correlation_integration); extern ADDAPI int ADDCALL airspyhf_flash_configuration(airspyhf_device_t* device); /* streaming needs to be stopped */ extern ADDAPI int ADDCALL airspyhf_board_partid_serialno_read(airspyhf_device_t* device, airspyhf_read_partid_serialno_t* read_partid_serialno); extern ADDAPI int ADDCALL airspyhf_version_string_read(airspyhf_device_t* device, char* version, uint8_t length); // Legacy stuff for backward compatibility typedef enum { AIRSPYHF_USER_OUTPUT_0 = 0, AIRSPYHF_USER_OUTPUT_1 = 1, AIRSPYHF_USER_OUTPUT_2 = 2, AIRSPYHF_USER_OUTPUT_3 = 3 } airspyhf_user_output_t; typedef enum { AIRSPYHF_USER_OUTPUT_LOW = 0, AIRSPYHF_USER_OUTPUT_HIGH = 1 } airspyhf_user_output_state_t; #define airspyhf_flash_calibration airspyhf_flash_configuration extern ADDAPI int ADDCALL airspyhf_set_user_output(airspyhf_device_t* device, airspyhf_user_output_t pin, airspyhf_user_output_state_t value); extern ADDAPI int ADDCALL airspyhf_set_hf_agc(airspyhf_device_t* device, uint8_t flag); /* 0 = off, 1 = on */ extern ADDAPI int ADDCALL airspyhf_set_hf_agc_threshold(airspyhf_device_t* device, uint8_t flag); /* when agc on: 0 = low, 1 = high */ extern ADDAPI int ADDCALL airspyhf_set_hf_att(airspyhf_device_t* device, uint8_t att_index); /* Possible values: 0..8 Range: 0..48 dB Attenuation with 6 dB steps */ extern ADDAPI int ADDCALL airspyhf_set_hf_lna(airspyhf_device_t* device, uint8_t flag); /* 0 or 1: 1 to activate LNA (alias PreAmp): 1 = +6 dB gain - compensated in digital */ #ifdef __cplusplus } #endif #endif//__AIRSPYHF_H__