Prosody data communications Protocols: V.17 tx

V.17 is an ITU-T standard modem.

This protocol implements the transmitter for V.17. Since it is only a transmitter, it only uses the output half of a channel.

API function behaviour

This should be read in conjunction with the generic data communications documentation.

smdc_channel_config()

You must use #include "smdc_v17.h" to get the appropriate declarations.

The protocol value is kSMDCProtocolV17tx.

The config_data pointer must point to one of these structs:

	typedef struct smdc_v17_config_parms {
		tSM_INT speed;
	} SMDC_V17_CONFIG_PARMS;

'speed' is the data rate in bits per second. This must be one of the standard speeds: 7200, 9600, 12000, or 14400.

This protocol can use these encodings: SYNC, ASYNC, HDLC.

The firmware modules v17tx, six2five and outchan must have been downloaded.

smdc_line_control()

The kSMDCLineCtlCmdSetPrefixSuffix command is supported by this protocol.

smdc_line_status()

smdc_tx_status()

[note] 'flow' is not useful since there is no flow control mechanism.

smdc_tx_control()

The only notification implemented is NotifyOnCapacity.

When setting the capacity, it is necessary to specify a value one greater than the value required. i.e. to get notified when space is available for at least 32 bytes, set the capacity to 33 or greater.

smdc_rx_status()

This function is not applicable since it only applies to the input half of a channel.

smdc_rx_control()

This function is not applicable since it only applies to the input half of a channel.

smdc_rx_data()

This function is not applicable since it only applies to the input half of a channel.

smdc_tx_data()