async.c File Reference

#include <inttypes.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include "spandsp/telephony.h"
#include "spandsp/async.h"
#include "spandsp/private/async.h"

Functions
const char *	signal_status_to_str (int status)
	Convert a signal status to a short text description.
async_rx_state_t *	async_rx_init (async_rx_state_t *s, int data_bits, int parity, int stop_bits, int use_v14, put_byte_func_t put_byte, void *user_data)
	Initialise an asynchronous data receiver context.
int	async_rx_release (async_rx_state_t *s)
int	async_rx_free (async_rx_state_t *s)
	SPAN_DECLARE_NONSTD (void)
	Process a received HDLC frame.
async_tx_state_t *	async_tx_init (async_tx_state_t *s, int data_bits, int parity, int stop_bits, int use_v14, get_byte_func_t get_byte, void *user_data)
	Initialise an asynchronous data transmit context.
int	async_tx_release (async_tx_state_t *s)
int	async_tx_free (async_tx_state_t *s)
	SPAN_DECLARE_NONSTD (int)
	Get the next bit of a transmitted serial bit stream.

---

Detailed Description

---

Function Documentation

async_rx_state_t* async_rx_init	(	async_rx_state_t *	s,
		int	data_bits,
		int	parity_bits,
		int	stop_bits,
		int	use_v14,
		put_byte_func_t	put_byte,
		void *	user_data
	)

Initialise an asynchronous data receiver context.

Initialise an asynchronous data receiver context.

Parameters:

	s	The receiver context.
	data_bits	The number of data bits.
	parity_bits	The type of parity.
	stop_bits	The number of stop bits.
	use_v14	TRUE if V.14 rate adaption processing should be used.
	put_byte	The callback routine used to put the received data.
	user_data	An opaque pointer.

Returns:

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

async_tx_state_t* async_tx_init	(	async_tx_state_t *	s,
		int	data_bits,
		int	parity_bits,
		int	stop_bits,
		int	use_v14,
		get_byte_func_t	get_byte,
		void *	user_data
	)

Initialise an asynchronous data transmit context.

Initialise an asynchronous data transmit context.

Parameters:

	s	The transmitter context.
	data_bits	The number of data bit.
	parity_bits	The type of parity.
	stop_bits	The number of stop bits.
	use_v14	TRUE if V.14 rate adaption processing should be used.
	get_byte	The callback routine used to get the data to be transmitted.
	user_data	An opaque pointer.

Returns:

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

References ASYNC_PARITY_NONE.

Referenced by v18_init().

const char* signal_status_to_str

(

int

status

)

Convert a signal status to a short text description.

Convert a signal status to a short text description.

Parameters:

status

The modem signal status.

Returns:

A pointer to the description.

References SIG_STATUS_ABORT, SIG_STATUS_BREAK, SIG_STATUS_CARRIER_DOWN, SIG_STATUS_CARRIER_UP, SIG_STATUS_END_OF_DATA, SIG_STATUS_FRAMING_OK, SIG_STATUS_MODEM_RETRAIN_OCCURRED, SIG_STATUS_OCTET_REPORT, SIG_STATUS_POOR_SIGNAL_QUALITY, SIG_STATUS_SHUTDOWN_COMPLETE, SIG_STATUS_TRAINING_FAILED, SIG_STATUS_TRAINING_IN_PROGRESS, and SIG_STATUS_TRAINING_SUCCEEDED.

SPAN_DECLARE_NONSTD

(

int

)

Get the next bit of a transmitted serial bit stream.

Get the next bit of data from a T.38 rate adapting non-ECM buffer context.

Get a bit of received non-ECM image data.

Get the next bit of a transmitted serial bit stream.

Parameters:

user_data

An opaque point which must point to a transmitter context.

Returns:

the next bit, or PUTBIT_END_OF_DATA to indicate the data stream has ended.

SPAN_DECLARE_NONSTD

(

void

)

Process a received HDLC frame.

Process a received HDLC frame.

Parameters:

	user_data	The T.30 context.
	msg	The HDLC message.
	len	The length of the message, in octets.
	ok	TRUE if the frame was received without error.

References ASYNC_PARITY_ODD, async_rx_state_s::bitpos, async_rx_state_s::byte_in_progress, async_rx_state_s::data_bits, async_rx_state_s::framing_errors, async_rx_state_s::parity, async_rx_state_s::parity_bit, async_rx_state_s::parity_errors, async_rx_state_s::put_byte, SIG_STATUS_CARRIER_DOWN, SIG_STATUS_CARRIER_UP, SIG_STATUS_END_OF_DATA, SIG_STATUS_TRAINING_FAILED, SIG_STATUS_TRAINING_IN_PROGRESS, SIG_STATUS_TRAINING_SUCCEEDED, async_rx_state_s::use_v14, and async_rx_state_s::user_data.