v8.c File Reference

#include <inttypes.h>
#include <stdlib.h>
#include <stdio.h>
#include <memory.h>
#include "floating_fudge.h"
#include "spandsp/telephony.h"
#include "spandsp/logging.h"
#include "spandsp/queue.h"
#include "spandsp/async.h"
#include "spandsp/complex.h"
#include "spandsp/dds.h"
#include "spandsp/tone_detect.h"
#include "spandsp/tone_generate.h"
#include "spandsp/super_tone_rx.h"
#include "spandsp/power_meter.h"
#include "spandsp/fsk.h"
#include "spandsp/modem_connect_tones.h"
#include "spandsp/v8.h"

Defines
#define	ms_to_samples(t)   (((t)*SAMPLE_RATE)/1000)
Enumerations
enum	{   V8_WAIT_1S, V8_CI, V8_CI_ON, V8_CI_OFF,   V8_HEARD_ANSAM, V8_CM_ON, V8_CJ_ON, V8_CM_WAIT,   V8_SIGC, V8_WAIT_200MS, V8_JM_ON, V8_SIGA,   V8_PARKED }
enum	{ V8_SYNC_UNKNOWN = 0, V8_SYNC_CI, V8_SYNC_CM_JM, V8_SYNC_V92 }
Functions
const char *	v8_call_function_to_str (int call_function)
const char *	v8_modulation_to_str (int modulation_scheme)
const char *	v8_protocol_to_str (int protocol)
const char *	v8_pstn_access_to_str (int pstn_access)
const char *	v8_pcm_modem_availability_to_str (int pcm_modem_availability)
void	v8_log_supported_modulations (v8_state_t *s, int modulation_schemes)
	Log the list of supported modulations.
int	v8_tx (v8_state_t *s, int16_t *amp, int max_len)
	Generate a block of V.8 audio samples.
int	v8_rx (v8_state_t *s, const int16_t *amp, int len)
	Process a block of received V.8 audio samples.
v8_state_t *	v8_init (v8_state_t *s, int caller, int available_modulations, v8_result_handler_t *result_handler, void *user_data)
	Initialise a V.8 context.
int	v8_release (v8_state_t *s)
	Release a V.8 context.
Variables
enum { ... }	v8_states_e
enum { ... }	v8_sync_types_e

---

Detailed Description

---

Function Documentation

v8_state_t* v8_init	(	v8_state_t *	s,
		int	caller,
		int	available_modulations,
		v8_result_handler_t *	result_handler,
		void *	user_data
	)

Initialise a V.8 context.

Initialise a V.8 context.

Parameters:

	s	The V.8 context.
	caller	TRUE if caller mode, else answerer mode.
	available_modulations	A bitwise list of the modulation schemes to be advertised as available here.
	result_handler	The callback routine used to handle the results of negotiation.
	user_data	An opaque pointer passed to the result_handler routine.

Returns:

A pointer to the V.8 context, or NULL if there was a problem.

References queue_init().

void v8_log_supported_modulations	(	v8_state_t *	s,
		int	modulation_schemes
	)

Log the list of supported modulations.

Log the list of supported modulations.

Parameters:

	s	The V.8 context.
	modulation_schemes	The list of supported modulations.

References span_log().

int v8_release

(

v8_state_t *

s

)

Release a V.8 context.

Release a V.8 context.

Parameters:

s

The V.8 context.

Returns:

0 for OK.

References queue_free().

int v8_rx	(	v8_state_t *	s,
		const int16_t *	amp,
		int	len
	)

Process a block of received V.8 audio samples.

Process a block of received V.8 audio samples.

Parameters:

	s	The V.8 context.
	amp	The audio sample buffer.
	len	The number of samples in the buffer.

References fsk_rx(), fsk_tx_init(), MODEM_CONNECT_TONES_ANS_PR, MODEM_CONNECT_TONES_ANSAM_PR, modem_connect_tones_rx(), modem_connect_tones_rx_get(), modem_connect_tones_rx_init(), modem_connect_tones_tx_init(), queue_empty(), queue_flush(), and queue_write().

int v8_tx	(	v8_state_t *	s,
		int16_t *	amp,
		int	max_len
	)

Generate a block of V.8 audio samples.

Generate a block of V.8 audio samples.

Parameters:

	s	The V.8 context.
	amp	The audio sample buffer.
	max_len	The number of samples to be generated.

Returns:

The number of samples actually generated.

References fsk_tx(), and modem_connect_tones_tx().