spandsp  0.0.6
t38_core.c File Reference
#include <inttypes.h>
#include <stdlib.h>
#include <stdio.h>
#include <fcntl.h>
#include <time.h>
#include <string.h>
#include "floating_fudge.h"
#include <assert.h>
#include <memory.h>
#include <tiffio.h>
#include "spandsp/telephony.h"
#include "spandsp/logging.h"
#include "spandsp/bit_operations.h"
#include "spandsp/t38_core.h"
#include "spandsp/private/logging.h"
#include "spandsp/private/t38_core.h"

Macros

#define ACCEPTABLE_SEQ_NO_OFFSET   2000
 

Functions

const char * t38_indicator_to_str (int indicator)
 Convert the code for an indicator to a short text name. More...
 
const char * t38_data_type_to_str (int data_type)
 Convert the code for a type of data to a short text name. More...
 
const char * t38_field_type_to_str (int field_type)
 Convert the code for a type of data field to a short text name. More...
 
const char * t38_cm_profile_to_str (int profile)
 Convert the code for a CM profile code to text description. More...
 
const char * t38_jm_to_str (const uint8_t *data, int len)
 Convert a JM message code to text description. More...
 
int t38_v34rate_to_bps (const uint8_t *data, int len)
 Convert a V34rate message to an actual bit rate. More...
 
int t38_core_rx_ifp_stream (t38_core_state_t *s, const uint8_t *buf, int len, uint16_t log_seq_no)
 
int t38_core_rx_ifp_packet (t38_core_state_t *s, const uint8_t *buf, int len, uint16_t seq_no)
 
int t38_core_send_indicator (t38_core_state_t *s, int indicator)
 Send an indicator packet. More...
 
int t38_core_send_flags_delay (t38_core_state_t *s, int indicator)
 Find the delay to allow for HDLC flags after sending an indicator. More...
 
int t38_core_send_training_delay (t38_core_state_t *s, int indicator)
 Find the delay to allow for modem training after sending an indicator. More...
 
int t38_core_send_data (t38_core_state_t *s, int data_type, int field_type, const uint8_t field[], int field_len, int category)
 Send a data packet. More...
 
int t38_core_send_data_multi_field (t38_core_state_t *s, int data_type, const t38_data_field_t field[], int fields, int category)
 Send a data packet. More...
 
void t38_set_data_rate_management_method (t38_core_state_t *s, int method)
 
void t38_set_data_transport_protocol (t38_core_state_t *s, int data_transport_protocol)
 
void t38_set_fill_bit_removal (t38_core_state_t *s, int fill_bit_removal)
 
void t38_set_mmr_transcoding (t38_core_state_t *s, int mmr_transcoding)
 
void t38_set_jbig_transcoding (t38_core_state_t *s, int jbig_transcoding)
 
void t38_set_max_buffer_size (t38_core_state_t *s, int max_buffer_size)
 
void t38_set_max_datagram_size (t38_core_state_t *s, int max_datagram_size)
 
void t38_set_t38_version (t38_core_state_t *s, int t38_version)
 
void t38_set_sequence_number_handling (t38_core_state_t *s, int check)
 
void t38_set_pace_transmission (t38_core_state_t *s, int pace_transmission)
 
void t38_set_tep_handling (t38_core_state_t *s, int allow_for_tep)
 
void t38_set_redundancy_control (t38_core_state_t *s, int category, int setting)
 Send a data packet. More...
 
void t38_set_fastest_image_data_rate (t38_core_state_t *s, int max_rate)
 
int t38_get_fastest_image_data_rate (t38_core_state_t *s)
 
logging_state_tt38_core_get_logging_state (t38_core_state_t *s)
 Get a pointer to the logging context associated with a T.38 context. More...
 
int t38_core_restart (t38_core_state_t *s)
 Restart a T.38 core context. More...
 
t38_core_state_tt38_core_init (t38_core_state_t *s, t38_rx_indicator_handler_t *rx_indicator_handler, t38_rx_data_handler_t *rx_data_handler, t38_rx_missing_handler_t *rx_missing_handler, void *rx_user_data, t38_tx_packet_handler_t *tx_packet_handler, void *tx_packet_user_data)
 Initialise a T.38 core context. More...
 
int t38_core_release (t38_core_state_t *s)
 Release a signaling tone transmitter context. More...
 
int t38_core_free (t38_core_state_t *s)
 Free a signaling tone transmitter context. More...
 

Function Documentation

◆ t38_cm_profile_to_str()

const char* t38_cm_profile_to_str ( int  profile)

Convert the code for a CM profile code to text description.

Parameters
profileThe profile code from a CM message.
Returns
A pointer to a short text description of the profile.

◆ t38_core_free()

int t38_core_free ( t38_core_state_t s)

Free a signaling tone transmitter context.

Free a signaling tone transmitter context.

Parameters
sThe T.38 context.
Returns
0 for OK

◆ t38_core_get_logging_state()

logging_state_t* t38_core_get_logging_state ( t38_core_state_t s)

Get a pointer to the logging context associated with a T.38 context.

Get a pointer to the logging context associated with a T.38 context.

Parameters
sThe T.38 context.
Returns
A pointer to the logging context, or NULL.

References t38_core_state_s::logging.

◆ t38_core_init()

t38_core_state_t* t38_core_init ( t38_core_state_t s,
t38_rx_indicator_handler_t *  rx_indicator_handler,
t38_rx_data_handler_t *  rx_data_handler,
t38_rx_missing_handler_t *  rx_missing_handler,
void *  rx_user_data,
t38_tx_packet_handler_t *  tx_packet_handler,
void *  tx_packet_user_data 
)

Initialise a T.38 core context.

Initialise a T.38 core context.

Parameters
sThe T.38 context.
rx_indicator_handlerReceive indicator handling routine.
rx_data_handlerReceive data packet handling routine.
rx_rx_missing_handlerMissing receive packet handling routine.
rx_packet_user_dataAn opaque pointer passed to the rx packet handling routines.
tx_packet_handlerPacket transmit handling routine.
tx_packet_user_dataAn opaque pointer passed to the tx_packet_handler.
Returns
A pointer to the T.38 context, or NULL if there was a problem.

◆ t38_core_release()

int t38_core_release ( t38_core_state_t s)

Release a signaling tone transmitter context.

Release a signaling tone transmitter context.

Parameters
sThe T.38 context.
Returns
0 for OK

◆ t38_core_restart()

int t38_core_restart ( t38_core_state_t s)

Restart a T.38 core context.

Restart a T.38 core context.

Parameters
sThe T.38 context.
Returns
0 for OK, else -1.

References t38_core_state_s::current_rx_data_type, t38_core_state_s::current_rx_field_type, t38_core_state_s::current_rx_indicator, t38_core_state_s::current_tx_indicator, and t38_core_state_s::rx_expected_seq_no.

◆ t38_core_send_data()

int t38_core_send_data ( t38_core_state_t s,
int  data_type,
int  field_type,
const uint8_t  field[],
int  field_len,
int  category 
)

Send a data packet.

Parameters
sThe T.38 context.
data_typeThe packet's data type.
field_typeThe packet's field type.
fieldThe message data content for the packet.
field_lenThe length of the message data, in bytes.
categoryThe category of the packet being sent. This should be one of the values defined for t38_packet_categories_e.
Returns
0 for OK, else -1

◆ t38_core_send_data_multi_field()

int t38_core_send_data_multi_field ( t38_core_state_t s,
int  data_type,
const t38_data_field_t  field[],
int  fields,
int  category 
)

Send a data packet.

Parameters
sThe T.38 context.
data_typeThe packet's data type.
fieldThe list of fields.
fieldsThe number of fields in the list.
categoryThe category of the packet being sent. This should be one of the values defined for t38_packet_categories_e.
Returns
0 for OK, else -1

◆ t38_core_send_flags_delay()

int t38_core_send_flags_delay ( t38_core_state_t s,
int  indicator 
)

Find the delay to allow for HDLC flags after sending an indicator.

Parameters
sThe T.38 context.
indicatorThe indicator to check.
Returns
The delay to allow for initial HDLC flags after this indicator is sent.

References t38_core_state_s::pace_transmission.

◆ t38_core_send_indicator()

int t38_core_send_indicator ( t38_core_state_t s,
int  indicator 
)

Send an indicator packet.

Parameters
sThe T.38 context.
indicatorThe indicator to send.
Returns
The delay to allow after this indicator is sent.

◆ t38_core_send_training_delay()

int t38_core_send_training_delay ( t38_core_state_t s,
int  indicator 
)

Find the delay to allow for modem training after sending an indicator.

Parameters
sThe T.38 context.
indicatorThe indicator to check.
Returns
The delay to allow for modem training after this indicator is sent.

References t38_core_state_s::pace_transmission.

◆ t38_data_type_to_str()

const char* t38_data_type_to_str ( int  data_type)

Convert the code for a type of data to a short text name.

Parameters
data_typeThe data type.
Returns
A pointer to a short text name for the data type.

◆ t38_field_type_to_str()

const char* t38_field_type_to_str ( int  field_type)

Convert the code for a type of data field to a short text name.

Parameters
field_typeThe field type.
Returns
A pointer to a short text name for the field type.

◆ t38_indicator_to_str()

const char* t38_indicator_to_str ( int  indicator)

Convert the code for an indicator to a short text name.

Parameters
indicatorThe type of indicator.
Returns
A pointer to a short text name for the indicator.

◆ t38_jm_to_str()

const char* t38_jm_to_str ( const uint8_t *  data,
int  len 
)

Convert a JM message code to text description.

Parameters
dataThe data field of the message.
lenThe length of the data field.
Returns
A pointer to a short text description of the profile.

◆ t38_set_data_rate_management_method()

void t38_set_data_rate_management_method ( t38_core_state_t s,
int  method 
)

Set the method to be used for data rate management, as per the T.38 spec.

Parameters
sThe T.38 context.
method1 for pass TCF across the T.38 link, 2 for handle TCF locally.

References t38_core_state_s::data_rate_management_method.

◆ t38_set_data_transport_protocol()

void t38_set_data_transport_protocol ( t38_core_state_t s,
int  data_transport_protocol 
)

Set the data transport protocol.

Parameters
sThe T.38 context.
data_transport_protocolUDPTL, RTP or TPKT.

References t38_core_state_s::data_transport_protocol.

◆ t38_set_fill_bit_removal()

void t38_set_fill_bit_removal ( t38_core_state_t s,
int  fill_bit_removal 
)

Set the non-ECM fill bit removal mode.

Parameters
sThe T.38 context.
fill_bit_removalTRUE to remove fill bits across the T.38 link, else FALSE.

References t38_core_state_s::fill_bit_removal.

◆ t38_set_jbig_transcoding()

void t38_set_jbig_transcoding ( t38_core_state_t s,
int  jbig_transcoding 
)

Set the JBIG transcoding mode.

Parameters
sThe T.38 context.
jbig_transcodingTRUE to transcode to JBIG across the T.38 link, else FALSE.

References t38_core_state_s::jbig_transcoding.

◆ t38_set_max_buffer_size()

void t38_set_max_buffer_size ( t38_core_state_t s,
int  max_buffer_size 
)

Set the maximum buffer size for received data at the far end.

Parameters
sThe T.38 context.
max_buffer_sizeThe maximum buffer size.

References t38_core_state_s::max_buffer_size.

◆ t38_set_max_datagram_size()

void t38_set_max_datagram_size ( t38_core_state_t s,
int  max_datagram_size 
)

Set the maximum size of an IFP packet that is acceptable by the far end.

Parameters
sThe T.38 context.
max_datagram_sizeThe maximum IFP packet length, in bytes.

References t38_core_state_s::max_datagram_size.

◆ t38_set_mmr_transcoding()

void t38_set_mmr_transcoding ( t38_core_state_t s,
int  mmr_transcoding 
)

Set the MMR transcoding mode.

Parameters
sThe T.38 context.
mmr_transcodingTRUE to transcode to MMR across the T.38 link, else FALSE.

References t38_core_state_s::mmr_transcoding.

◆ t38_set_redundancy_control()

void t38_set_redundancy_control ( t38_core_state_t s,
int  category,
int  setting 
)

Send a data packet.

Parameters
sThe T.38 context.
categoryThe category of the packet being sent. This should be one of the values defined for t38_packet_categories_e.
settingThe repeat count for the category. This should be at least one for all categories other an indicator packets. Zero is valid for indicator packets, as it suppresses the sending of indicator packets, as an application using TCP for the transport would require. As the setting is passed through to the transmission channel, additional information may be encoded in it, such as the redundancy depth for the particular packet category.

References t38_core_state_s::category_control.

Referenced by t31_set_t38_config().

◆ t38_set_sequence_number_handling()

void t38_set_sequence_number_handling ( t38_core_state_t s,
int  check 
)

Set the sequence number handling option.

Parameters
sThe T.38 context.
checkTRUE to check sequence numbers, and handle gaps reasonably. FALSE for no sequence number processing (e.g. for TPKT over TCP transport).

References t38_core_state_s::check_sequence_numbers.

◆ t38_set_t38_version()

void t38_set_t38_version ( t38_core_state_t s,
int  t38_version 
)

Set the T.38 version to be emulated.

Parameters
sThe T.38 context.
t38_versionVersion number, as in the T.38 spec.

◆ t38_set_tep_handling()

void t38_set_tep_handling ( t38_core_state_t s,
int  allow_for_tep 
)

Set the TEP handling option.

Parameters
sThe T.38 context.
allow_for_tepTRUE to allow for TEP playout, else FALSE.

References t38_core_state_s::allow_for_tep.

◆ t38_v34rate_to_bps()

int t38_v34rate_to_bps ( const uint8_t *  data,
int  len 
)

Convert a V34rate message to an actual bit rate.

Parameters
dataThe data field of the message.
lenThe length of the data field.
Returns
The bit rate, or -1 for a bad message.