4.2. Guidelines for Implementing Fax

Follow these guidelines to implement fax capability in your application.

Table 10. Guidelines for Creating Fax Applications

Step	Action
1.	Open a channel for voice and a channel for fax. Open a network channel if applicable.
2.	If your system configuration uses the SCbus assign time slot routing for SCbus. The program flow for these system configurations is given in Section 2.8. System Configuration Models on page 17.
3.	Set the initial state of the fax channel using fx_initstat( ). Following T.30 protocol, the caller is initially set to be the transmitter of a fax and the called station is initially set to be the receiver of a fax.
4.	Configure your fax device channel using fx_setparm( ). Several parameters are available to define values such as:   fax header   transmit and receive baud rate   retransmission count   preferred data transmission encoding scheme (over the phone line)   subaddress fax routing information
5.	When sending a fax, define a DF_IOTT table entry for each document (raw, TIFF/F and ASCII) to be transmitted. This table entry provides a description of the fax data to be transmitted and includes information such as the type of data, number of pages, width, resolution, and Phase D continuation values. You can use the fx_setiott( ) function to initialize the DF_IOTT structure.
6.	When sending ASCII documents, you can further describe the ASCII data using the DF_ASCIIDATA structure. If you do not use this data structure, certain default values are assumed for your ASCII document.
7.	Set up the call by using voice API functions; that is, dial the number, wait for rings and so on.
8.	Initiate send fax or receive fax on the channel using fx_sendfax( ), fx_rcv( ) or fx_rcv2( ). Send fax convenience functions can also be used instead of fx_sendfax( ).
9.	After the send fax and receive fax functions are completed, use the voice API functions to disconnect the call.
10.	At the end of the application, close the open channels.

Details on these guidelines are provided later in this chapter. For information on voice functionality, see the Voice Software Reference.

Click here to contact Dialogic Customer Engineering