#include <v29rx.h>

Public Attributes
int	bit_rate
	The bit rate of the modem. Valid values are 4800, 7200 and 9600.
span_put_bit_func_t	put_bit
	The callback function used to put each bit received.
void *	put_bit_user_data
	A user specified opaque pointer passed to the put_bit routine.
span_modem_status_func_t	status_handler
	The callback function used to report modem status changes.
void *	status_user_data
	A user specified opaque pointer passed to the status function.
qam_report_handler_t	qam_report
	A callback function which may be enabled to report every symbol's constellation position.
void *	qam_user_data
	A user specified opaque pointer passed to the qam_report callback routine.
float	agc_scaling
	The scaling factor assessed by the AGC algorithm.
float	agc_scaling_save
	The previous value of agc_scaling, needed to reuse old training.
float	eq_delta
	The current delta factor for updating the equalizer coefficients.
complexf_t	eq_coeff [33]
	The adaptive equalizer coefficients.
complexf_t	eq_coeff_save [33]
	A saved set of adaptive equalizer coefficients for use after restarts.
complexf_t	eq_buf [33]
	The equalizer signal buffer.
float	training_error
	A measure of how much mismatch there is between the real constellation, and the decoded symbol positions.
float	carrier_track_p
	The proportional part of the carrier tracking filter.
float	carrier_track_i
	The integral part of the carrier tracking filter.
float	rrc_filter [27]
	The root raised cosine (RRC) pulse shaping filter buffer.
godard_ted_state_t	godard
int	rrc_filter_step
	Current offset into the RRC pulse shaping filter buffer.
uint32_t	scramble_reg
	The register for the data scrambler.
uint8_t	training_scramble_reg
	The register for the training scrambler.
int	training_cd
	The current step in the table of CD constellation positions.
bool	old_train
	True if the previous trained values are to be reused.
int	training_stage
	The section of the training data we are currently in.
int	training_count
	A count of how far through the current training step we are.
int16_t	last_sample
	The value of the last signal sample, using the a simple HPF for signal power estimation.
int	signal_present
	>0 if a signal above the minimum is present. It may or may not be a V.29 signal.
int	carrier_drop_pending
	Whether or not a carrier drop was detected and the signal delivery is pending.
int	low_samples
	A count of the current consecutive samples below the carrier off threshold.
int16_t	high_sample
	A highest magnitude sample seen.
uint32_t	carrier_phase
	The current phase of the carrier (i.e. the DDS parameter).
int32_t	carrier_phase_rate
	The update rate for the phase of the carrier (i.e. the DDS increment).
int32_t	carrier_phase_rate_save
	The carrier update rate saved for reuse when using short training.
power_meter_t	power
	A power meter, to measure the HPF'ed signal power in the channel.
int32_t	carrier_on_power
	The power meter level at which carrier on is declared.
int32_t	carrier_off_power
	The power meter level at which carrier off is declared.
int	eq_step
	Current read offset into the equalizer buffer.
int	eq_put_step
	Current write offset into the equalizer buffer.
int	eq_skip
	Symbol counter to the next equalizer update.
int	baud_half
	The current half of the baud.
int32_t	last_angles [2]
	The previous symbol phase angles for the coarse carrier aquisition step.
int32_t	diff_angles [16]
	History list of phase angle differences for the coarse carrier aquisition step.
int	constellation_state
	The position of the current symbol in the constellation, used for differential decoding.
logging_state_t	logging
	Error and flow logging control.

Detailed Description

V.29 modem receive side descriptor. This defines the working state for a single instance of a V.29 modem receiver.

Member Data Documentation

◆ agc_scaling

float v29_rx_state_s::agc_scaling

The scaling factor assessed by the AGC algorithm.

Referenced by v29_rx(), and v29_rx_restart().

◆ agc_scaling_save

float v29_rx_state_s::agc_scaling_save

The previous value of agc_scaling, needed to reuse old training.

Referenced by v29_rx(), and v29_rx_restart().

◆ baud_half

int v29_rx_state_s::baud_half

The current half of the baud.

Referenced by v29_rx_restart().

◆ bit_rate

int v29_rx_state_s::bit_rate

The bit rate of the modem. Valid values are 4800, 7200 and 9600.

Referenced by v29_rx_restart().

◆ carrier_drop_pending

int v29_rx_state_s::carrier_drop_pending

Whether or not a carrier drop was detected and the signal delivery is pending.

Referenced by v29_rx_restart().

◆ carrier_off_power

int32_t v29_rx_state_s::carrier_off_power

The power meter level at which carrier off is declared.

Referenced by v29_rx_set_signal_cutoff().

◆ carrier_on_power

int32_t v29_rx_state_s::carrier_on_power

The power meter level at which carrier on is declared.

Referenced by v29_rx_set_signal_cutoff().

◆ carrier_phase

uint32_t v29_rx_state_s::carrier_phase

The current phase of the carrier (i.e. the DDS parameter).

Referenced by v29_rx(), v29_rx_fillin(), and v29_rx_restart().

◆ carrier_phase_rate

int32_t v29_rx_state_s::carrier_phase_rate

The update rate for the phase of the carrier (i.e. the DDS increment).

Referenced by v29_rx(), v29_rx_carrier_frequency(), v29_rx_fillin(), and v29_rx_restart().

◆ carrier_phase_rate_save

int32_t v29_rx_state_s::carrier_phase_rate_save

The carrier update rate saved for reuse when using short training.

Referenced by v29_rx_restart().

◆ carrier_track_i

float v29_rx_state_s::carrier_track_i

The integral part of the carrier tracking filter.

Referenced by v29_rx_restart().

◆ carrier_track_p

float v29_rx_state_s::carrier_track_p

The proportional part of the carrier tracking filter.

Referenced by v29_rx_restart().

◆ constellation_state

int v29_rx_state_s::constellation_state

The position of the current symbol in the constellation, used for differential decoding.

Referenced by v29_rx_restart().

◆ diff_angles

int32_t v29_rx_state_s::diff_angles[16]

History list of phase angle differences for the coarse carrier aquisition step.

Referenced by v29_rx_restart().

◆ eq_coeff

complexf_t v29_rx_state_s::eq_coeff[33]

The adaptive equalizer coefficients.

Referenced by v29_rx_equalizer_state().

◆ eq_put_step

int v29_rx_state_s::eq_put_step

Current write offset into the equalizer buffer.

Referenced by v29_rx(), and v29_rx_fillin().

◆ eq_skip

int v29_rx_state_s::eq_skip

Symbol counter to the next equalizer update.

Referenced by v29_rx_restart().

◆ high_sample

int16_t v29_rx_state_s::high_sample

A highest magnitude sample seen.

Referenced by v29_rx_restart().

◆ last_sample

int16_t v29_rx_state_s::last_sample

The value of the last signal sample, using the a simple HPF for signal power estimation.

Referenced by v29_rx_restart().

◆ logging

logging_state_t v29_rx_state_s::logging

Error and flow logging control.

Referenced by v29_rx_fillin(), v29_rx_get_logging_state(), and v29_rx_init().

◆ low_samples

int v29_rx_state_s::low_samples

A count of the current consecutive samples below the carrier off threshold.

Referenced by v29_rx_restart().

◆ old_train

bool v29_rx_state_s::old_train

True if the previous trained values are to be reused.

Referenced by v29_rx_restart().

◆ power

power_meter_t v29_rx_state_s::power

A power meter, to measure the HPF'ed signal power in the channel.

Referenced by v29_rx_restart(), and v29_rx_signal_power().

◆ put_bit

span_put_bit_func_t v29_rx_state_s::put_bit

The callback function used to put each bit received.

Referenced by v29_rx_init(), and v29_rx_set_put_bit().

◆ put_bit_user_data

void* v29_rx_state_s::put_bit_user_data

A user specified opaque pointer passed to the put_bit routine.

Referenced by v29_rx_init(), and v29_rx_set_put_bit().

◆ qam_report

qam_report_handler_t v29_rx_state_s::qam_report

A callback function which may be enabled to report every symbol's constellation position.

Referenced by v29_rx_set_qam_report_handler().

◆ qam_user_data

void* v29_rx_state_s::qam_user_data

A user specified opaque pointer passed to the qam_report callback routine.

Referenced by v29_rx_set_qam_report_handler().

◆ rrc_filter

float v29_rx_state_s::rrc_filter[27]

The root raised cosine (RRC) pulse shaping filter buffer.

Referenced by v29_rx(), and v29_rx_restart().

◆ rrc_filter_step

int v29_rx_state_s::rrc_filter_step

Current offset into the RRC pulse shaping filter buffer.

Referenced by v29_rx(), and v29_rx_restart().

◆ scramble_reg

uint32_t v29_rx_state_s::scramble_reg

The register for the data scrambler.

Referenced by v29_rx_restart().

◆ signal_present

int v29_rx_state_s::signal_present

>0 if a signal above the minimum is present. It may or may not be a V.29 signal.

Referenced by v29_rx_fillin(), and v29_rx_restart().

◆ status_handler

span_modem_status_func_t v29_rx_state_s::status_handler

The callback function used to report modem status changes.

Referenced by v29_rx_set_modem_status_handler().

◆ status_user_data

void* v29_rx_state_s::status_user_data

A user specified opaque pointer passed to the status function.

Referenced by v29_rx_set_modem_status_handler().

◆ training_cd

int v29_rx_state_s::training_cd

The current step in the table of CD constellation positions.

Referenced by v29_rx_restart().

◆ training_count

int v29_rx_state_s::training_count

A count of how far through the current training step we are.

Referenced by v29_rx_restart().

◆ training_scramble_reg

uint8_t v29_rx_state_s::training_scramble_reg

The register for the training scrambler.

Referenced by v29_rx_restart().

◆ training_stage

int v29_rx_state_s::training_stage

The section of the training data we are currently in.

Referenced by v29_rx(), v29_rx_fillin(), and v29_rx_restart().

The documentation for this struct was generated from the following file:

private/v29rx.h

Public Attributes

Detailed Description

Member Data Documentation

◆ agc_scaling

◆ agc_scaling_save

◆ baud_half

◆ bit_rate

◆ carrier_drop_pending

◆ carrier_off_power

◆ carrier_on_power

◆ carrier_phase

◆ carrier_phase_rate

◆ carrier_phase_rate_save

◆ carrier_track_i

◆ carrier_track_p

◆ constellation_state

◆ diff_angles

◆ eq_coeff

◆ eq_put_step

◆ eq_skip

◆ high_sample

◆ last_sample

◆ logging

◆ low_samples

◆ old_train

◆ power

◆ put_bit

◆ put_bit_user_data

◆ qam_report

◆ qam_user_data

◆ rrc_filter

◆ rrc_filter_step

◆ scramble_reg

◆ signal_present

◆ status_handler

◆ status_user_data

◆ training_cd

◆ training_count

◆ training_scramble_reg

◆ training_stage