Blame bat/common.h

Packit 229ac0
/*
Packit 229ac0
 * Copyright (C) 2013-2015 Intel Corporation
Packit 229ac0
 *
Packit 229ac0
 * This program is free software; you can redistribute it and/or modify
Packit 229ac0
 * it under the terms of the GNU General Public License as published by
Packit 229ac0
 * the Free Software Foundation; either version 2 of the License, or
Packit 229ac0
 * (at your option) any later version.
Packit 229ac0
 *
Packit 229ac0
 * This program is distributed in the hope that it will be useful,
Packit 229ac0
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 229ac0
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit 229ac0
 * GNU General Public License for more details.
Packit 229ac0
 *
Packit 229ac0
 */
Packit 229ac0
Packit 229ac0
#define TEMP_RECORD_FILE_NAME		"/tmp/bat.wav.XXXXXX"
Packit 229ac0
#define DEFAULT_DEV_NAME		"default"
Packit 229ac0
Packit 229ac0
#define OPT_BASE			300
Packit 229ac0
#define OPT_LOG				(OPT_BASE + 1)
Packit 229ac0
#define OPT_READFILE			(OPT_BASE + 2)
Packit 229ac0
#define OPT_SAVEPLAY			(OPT_BASE + 3)
Packit 229ac0
#define OPT_LOCAL			(OPT_BASE + 4)
Packit 229ac0
#define OPT_STANDALONE			(OPT_BASE + 5)
Packit 229ac0
#define OPT_ROUNDTRIPLATENCY		(OPT_BASE + 6)
Packit 229ac0
#define OPT_SNRTHD_DB			(OPT_BASE + 7)
Packit 229ac0
#define OPT_SNRTHD_PC			(OPT_BASE + 8)
Packit 229ac0
Packit 229ac0
#define COMPOSE(a, b, c, d)		((a) | ((b)<<8) | ((c)<<16) | ((d)<<24))
Packit 229ac0
#define WAV_RIFF			COMPOSE('R', 'I', 'F', 'F')
Packit 229ac0
#define WAV_WAVE			COMPOSE('W', 'A', 'V', 'E')
Packit 229ac0
#define WAV_FMT				COMPOSE('f', 'm', 't', ' ')
Packit 229ac0
#define WAV_DATA			COMPOSE('d', 'a', 't', 'a')
Packit 229ac0
#define WAV_FORMAT_PCM			1	/* PCM WAVE file encoding */
Packit 229ac0
Packit 229ac0
#define MAX_CHANNELS			2
Packit 229ac0
#define MIN_CHANNELS			1
Packit 229ac0
#define MAX_PEAKS			10
Packit 229ac0
#define MAX_FRAMES			(10 * 1024 * 1024)
Packit 229ac0
/* Given in ms */
Packit 229ac0
#define CAPTURE_DELAY			500
Packit 229ac0
/* signal frequency should be less than samplerate * RATE_FACTOR */
Packit 229ac0
#define RATE_FACTOR			0.4
Packit 229ac0
/* valid range of samplerate: (1 - RATE_RANGE, 1 + RATE_RANGE) * samplerate */
Packit 229ac0
#define RATE_RANGE			0.05
Packit 229ac0
/* Given in us */
Packit 229ac0
#define MAX_BUFFERTIME			500000
Packit 229ac0
/* devide factor, was 4, changed to 8 to remove reduce capture overrun */
Packit 229ac0
#define DIV_BUFFERTIME			8
Packit 229ac0
/* margin to avoid sign inversion when generate sine wav */
Packit 229ac0
#define RANGE_FACTOR			0.95
Packit 229ac0
#define MAX_BUFFERSIZE			200000
Packit 229ac0
#define MIN_BUFFERSIZE			32
Packit 229ac0
#define MAX_PERIODSIZE			200000
Packit 229ac0
#define MIN_PERIODSIZE			32
Packit 229ac0
/* default period size for tinyalsa */
Packit 229ac0
#define TINYALSA_PERIODSIZE			1024
Packit 229ac0
Packit 229ac0
#define LATENCY_TEST_NUMBER			5
Packit 229ac0
#define LATENCY_TEST_TIME_LIMIT			25
Packit 229ac0
#define DIV_BUFFERSIZE			2
Packit 229ac0
Packit 229ac0
#define EBATBASE			1000
Packit 229ac0
#define ENOPEAK				(EBATBASE + 1)
Packit 229ac0
#define EONLYDC				(EBATBASE + 2)
Packit 229ac0
#define EBADPEAK			(EBATBASE + 3)
Packit 229ac0
Packit 229ac0
#define DC_THRESHOLD			7.01
Packit 229ac0
Packit 229ac0
/* tolerance of detected peak = max (DELTA_HZ, DELTA_RATE * target_freq).
Packit 229ac0
 * If DELTA_RATE is too high, BAT may not be able to recognize negative result;
Packit 229ac0
 * if too low, BAT may be too sensitive and results in uncecessary failure. */
Packit 229ac0
#define DELTA_RATE			0.005
Packit 229ac0
#define DELTA_HZ			1
Packit 229ac0
Packit 229ac0
#define FOUND_DC			(1<<1)
Packit 229ac0
#define FOUND_WRONG_PEAK		(1<<0)
Packit 229ac0
Packit 229ac0
/* Truncate sample frames to (1 << N), for faster FFT analysis process. The
Packit 229ac0
 * valid range of N is (SHIFT_MIN, SHIFT_MAX). When N increases, the analysis
Packit 229ac0
 * will be more time-consuming, and the result will be more accurate. */
Packit 229ac0
#define SHIFT_MAX			(sizeof(int) * 8 - 2)
Packit 229ac0
#define SHIFT_MIN			8
Packit 229ac0
Packit 229ac0
/* Define SNR range in dB.
Packit 229ac0
 * if the noise is equal to signal, SNR = 0.0dB;
Packit 229ac0
 * if the noise is zero, SNR is limited by RIFF wav data width:
Packit 229ac0
 *     8 bit  -->  20.0 * log10f (powf(2.0, 8.0))  = 48.16 dB
Packit 229ac0
 *    16 bit  -->  20.0 * log10f (powf(2.0, 16.0)) = 96.33 dB
Packit 229ac0
 *    24 bit  -->  20.0 * log10f (powf(2.0, 24.0)) = 144.49 dB
Packit 229ac0
 *    32 bit  -->  20.0 * log10f (powf(2.0, 32.0)) = 192.66 dB
Packit 229ac0
 * so define the SNR range (0.0, 200.0) dB, value out of range is invalid. */
Packit 229ac0
#define SNR_DB_INVALID			-1.0
Packit 229ac0
#define SNR_DB_MIN			0.0
Packit 229ac0
#define SNR_DB_MAX			200.0
Packit 229ac0
Packit 229ac0
static inline bool snr_is_valid(float db)
Packit 229ac0
{
Packit 229ac0
	return (db > SNR_DB_MIN && db < SNR_DB_MAX);
Packit 229ac0
}
Packit 229ac0
Packit 229ac0
struct wav_header {
Packit 229ac0
	unsigned int magic; /* 'RIFF' */
Packit 229ac0
	unsigned int length; /* file len */
Packit 229ac0
	unsigned int type; /* 'WAVE' */
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct wav_chunk_header {
Packit 229ac0
	unsigned int type; /* 'data' */
Packit 229ac0
	unsigned int length; /* sample count */
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct wav_fmt {
Packit 229ac0
	unsigned int magic; /* 'FMT '*/
Packit 229ac0
	unsigned int fmt_size; /* 16 or 18 */
Packit 229ac0
	unsigned short format; /* see WAV_FMT_* */
Packit 229ac0
	unsigned short channels;
Packit 229ac0
	unsigned int sample_rate; /* Frequency of sample */
Packit 229ac0
	unsigned int bytes_p_second;
Packit 229ac0
	unsigned short blocks_align; /* sample size; 1 or 2 bytes */
Packit 229ac0
	unsigned short sample_length; /* 8, 12 or 16 bit */
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct chunk_fmt {
Packit 229ac0
	unsigned short format; /* see WAV_FMT_* */
Packit 229ac0
	unsigned short channels;
Packit 229ac0
	unsigned int sample_rate; /* Frequency of sample */
Packit 229ac0
	unsigned int bytes_p_second;
Packit 229ac0
	unsigned short blocks_align; /* sample size; 1 or 2 bytes */
Packit 229ac0
	unsigned short sample_length; /* 8, 12 or 16 bit */
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct wav_container {
Packit 229ac0
	struct wav_header header;
Packit 229ac0
	struct wav_fmt format;
Packit 229ac0
	struct wav_chunk_header chunk;
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct bat;
Packit 229ac0
Packit 229ac0
enum _bat_pcm_format {
Packit 229ac0
	BAT_PCM_FORMAT_UNKNOWN = -1,
Packit 229ac0
	BAT_PCM_FORMAT_S16_LE = 0,
Packit 229ac0
	BAT_PCM_FORMAT_S32_LE,
Packit 229ac0
	BAT_PCM_FORMAT_U8,
Packit 229ac0
	BAT_PCM_FORMAT_S24_3LE,
Packit 229ac0
	BAT_PCM_FORMAT_MAX
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
enum _bat_op_mode {
Packit 229ac0
	MODE_UNKNOWN = -1,
Packit 229ac0
	MODE_SINGLE = 0,
Packit 229ac0
	MODE_LOOPBACK,
Packit 229ac0
	MODE_LAST
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
enum latency_state {
Packit 229ac0
	LATENCY_STATE_COMPLETE_FAILURE = -1,
Packit 229ac0
	LATENCY_STATE_COMPLETE_SUCCESS = 0,
Packit 229ac0
	LATENCY_STATE_MEASURE_FOR_1_SECOND,
Packit 229ac0
	LATENCY_STATE_PLAY_AND_LISTEN,
Packit 229ac0
	LATENCY_STATE_WAITING,
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct pcm {
Packit 229ac0
	unsigned int card_tiny;
Packit 229ac0
	unsigned int device_tiny;
Packit 229ac0
	char *device;
Packit 229ac0
	char *file;
Packit 229ac0
	enum _bat_op_mode mode;
Packit 229ac0
	void *(*fct)(struct bat *);
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct sin_generator;
Packit 229ac0
Packit 229ac0
struct sin_generator {
Packit 229ac0
	double state_real;
Packit 229ac0
	double state_imag;
Packit 229ac0
	double phasor_real;
Packit 229ac0
	double phasor_imag;
Packit 229ac0
	float frequency;
Packit 229ac0
	float sample_rate;
Packit 229ac0
	float magnitude;
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct roundtrip_latency {
Packit 229ac0
	int number;
Packit 229ac0
	enum latency_state state;
Packit 229ac0
	float result[LATENCY_TEST_NUMBER];
Packit 229ac0
	int final_result;
Packit 229ac0
	int samples;
Packit 229ac0
	float sum;
Packit 229ac0
	int threshold;
Packit 229ac0
	int error;
Packit 229ac0
	bool is_capturing;
Packit 229ac0
	bool is_playing;
Packit 229ac0
	bool xrun_error;
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct noise_analyzer {
Packit 229ac0
	int nsamples;			/* number of sample */
Packit 229ac0
	float *source;			/* single-tone to be analyzed */
Packit 229ac0
	float *target;			/* target single-tone as standard */
Packit 229ac0
	float rms_tgt;			/* rms of target single-tone */
Packit 229ac0
	float snr_db;			/* snr in dB */
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct bat {
Packit 229ac0
	unsigned int rate;		/* sampling rate */
Packit 229ac0
	int channels;			/* nb of channels */
Packit 229ac0
	int frames;			/* nb of frames */
Packit 229ac0
	int frame_size;			/* size of frame */
Packit 229ac0
	int sample_size;		/* size of sample */
Packit 229ac0
	enum _bat_pcm_format format;	/* PCM format */
Packit 229ac0
	int buffer_size;		/* buffer size in frames */
Packit 229ac0
	int period_size;		/* period size in frames */
Packit 229ac0
Packit 229ac0
	float sigma_k;			/* threshold for peak detection */
Packit 229ac0
	float snr_thd_db;		/* threshold for noise detection (dB) */
Packit 229ac0
	float target_freq[MAX_CHANNELS];
Packit 229ac0
Packit 229ac0
	int sinus_duration;		/* number of frames for playback */
Packit 229ac0
	char *narg;			/* argument string of duration */
Packit 229ac0
	char *logarg;			/* path name of log file */
Packit 229ac0
	char *debugplay;		/* path name to store playback signal */
Packit 229ac0
	bool standalone;		/* enable to bypass analysis */
Packit 229ac0
	bool roundtriplatency;		/* enable round trip latency */
Packit 229ac0
Packit 229ac0
	struct pcm playback;
Packit 229ac0
	struct pcm capture;
Packit 229ac0
	struct roundtrip_latency latency;
Packit 229ac0
Packit 229ac0
	unsigned int periods_played;
Packit 229ac0
	unsigned int periods_total;
Packit 229ac0
	bool period_is_limited;
Packit 229ac0
Packit 229ac0
	FILE *fp;
Packit 229ac0
Packit 229ac0
	FILE *log;
Packit 229ac0
	FILE *err;
Packit 229ac0
Packit 229ac0
	void (*convert_sample_to_float)(void *, float *, int);
Packit 229ac0
	void (*convert_float_to_sample)(float *, void *, int, int);
Packit 229ac0
Packit 229ac0
	void *buf;			/* PCM Buffer */
Packit 229ac0
Packit 229ac0
	bool local;			/* true for internal test */
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
struct analyze {
Packit 229ac0
	void *buf;
Packit 229ac0
	float *in;
Packit 229ac0
	float *out;
Packit 229ac0
	float *mag;
Packit 229ac0
};
Packit 229ac0
Packit 229ac0
void prepare_wav_info(struct wav_container *, struct bat *);
Packit 229ac0
int read_wav_header(struct bat *, char *, FILE *, bool);
Packit 229ac0
int write_wav_header(FILE *, struct wav_container *, struct bat *);
Packit 229ac0
int update_wav_header(struct bat *, FILE *, int);
Packit 229ac0
int generate_input_data(struct bat *, void *, int, int);