Automatic T.38 negotiation for SIP Service Providers (kb3409)
The information in this article applies to:
- SwyxWare v6.02
This article describes how to configure SwyxLinkManager for automatic T.38 negotiation for SIP service providers. This will be supported with SwyxWare v6.02 MP1.
Automatic T.38 negotiation for SIP Service Providers
To use T.38 for the media streaming (i.e. the fax data transmission) the involved devices must agree to use this kind of transmission. This is done via the call control protocol. Inside SwyxWare there are different call control protocols in use, e.g. H.323 and SIP. It is necessary to interconnect all T.38 supporting devices inside a SwyxWare installation. These may be: SwyxFax Server, SwyxGate, SwyxServer, SwyxLinkManager and third party devices such as the AudioCodes terminal adapters. Each call control protocol uses its own mechanism to establish T.38 connections. Regarding H.323 the fax transmission is usually done this way:
- Connect via G.711 audio codec.
- Listen into G.711 audio stream and detect the CED tone of the called fax device.
- On detection of this tone switch to T.38 data transmission.
- Outgoing INVITE with T.38:
This will directly inform the receiving side that this is a fax call with T.38. The LinkManager will expect the answer "OK" in T.38.
- Outgoing INVITE with G.711:
This will inform the receiving side that it is a call with G.711. As soon as the receiving side accepts the call and detects a fax tone in the media streaming it will send a Re-INVITE suggesting the T.38 protocol. The Re-INVITE will be accepted at the LinkManager and a stream switch to T.38 is initiated so that this protocol is used for the fax call.
- Outgoing INVITE with G.711 and T.38:
This informs the receiving side that this is a call with G.711 or T.38. As answer the LinkManager accepts a direct OK concerning the suggested T.38 protocol or a Re-INVITE suggesting a stream switch from G.711 to T.38.
- Incoming INVITE with T.38:
The sending side directly informs the LinkManager that this is a fax call with T.38. The LinkManager will send back "OK" and uses T.38 for this connection.
- Incoming INVITE with G.711:
The remote side directly informs the LinkManager that it is a call with G.711. The LinkManager will send back a Re-INVITE which requests a stream switch to T.38 because the SwyxServer knows that the relevant user of this call requires T.38.
- Incoming INVITE with G.711 and T.38:
The sending side directly informs the LinkManager that this is a call with G.711 or T.38. The LinkManager can answer the INVITE in two different ways: It can directly use T.38 as protocol or it can send a Re-INVITE to request a stream switch to T.38. The way the LinkManager reacts can be configured for each trunk via the provider information stored in an XML file.
Configuring LinkManager for fax calls
The new LinkManager can be configured independently for each trunk (i.e. provider-specific) and for each direction (outgoing and incoming). This can be done within the XML files containing the provider profiles for the LinkManager. There are two new configuration parameters, one for outgoing and one for incoming fax calls. The parameters are defined in the ProviderProfiles.xsd file and can be configured in the ProviderProfiles.config file.
- “G711+T38” (this applies only to outgoing faxes).
It is important not to make any subsequent adjustments to the SIP settings of this trunk (customized trunk) via SwyxWare Administration. If necessary, please apply any modifications directly to the ProviderProfiles.config file.
Incoming fax calls
The SIP 200 OK answer always contains the T.38 codec (independent from IncomingFaxMethod parameter) (no stream switch).
The SIP 200 OK answer always contains the G.711 codec (independent from IncomingFaxMethod parameter) (stream switch).
The SIP 200 OK answer contains the T.38 codec (no stream switch).
The SIP 200 OK answer contains the G.711 codec (stream switch).
Outgoing fax calls
SIP INVITE with T.38 codec (no stream switch)
SIP INVITE with G.711µ dummy and G.711a dummy codec (stream switch)
SIP INVITE with G.711µ dummy, G.711a dummy and T.38 codec (stream switch possible)
Fax connection established, wait for fax data transmission
Wait for the provider’s SIP Re-INVITE message (with a T.38 codec). On receiving the Re-INVITE a SIP 200 OK message with the T.38 codec is sent to the provider. When the provider answers with a SIP ACK message the stream switch is complete and the fax data transmission can begin.