• 7.5.1. ATFX_CHTYPE( )
• 7.5.2. ATFX_RESLN( )
• 7.5.3. ATFX_WIDTH( )
• 7.5.4. fx_setparm( )

7.5. Fax API Enhancements

Enhancements to the R4 Fax API for DM3 boards are described in the following topics.

7.5.1. ATFX_CHTYPE( )

The ATFX_CHTYPE( ) function returns the following new value for a fax channel device on a DM3 board: DFS_FAXDM3.

You cannot use ATFX_CHTYPE( ) to determine if a channel device has fax capabilities, because its dev parameter requires a fax device handle previously obtained from fx_open( ). If fx_open( ) succeeds, this means that the channel device is already fax-capable. The ATFX_CHTYPE( ) function only identifies the hardware on which the fax-capable channel device sits. If the hardware is DM3, then this function returns DFS_FAXDM3.

For more information on fax device handling, see sections 2.3.6. Getting, Using, and Closing Device Handles in a DM3 Flexible Routing Configuration and 7.1. Fax Device Information.

7.5.2. ATFX_RESLN( )

On DM3 boards, the data provided by the ATFX_RESLN( ) function is updated each time the fax transfer completes Phase B (rather than Phase D) of the T.30 protocol. By enabling the Phase B event, you can issue ATFX_RESLN( ) when the TFX_PHASEB event occurs.

7.5.3. ATFX_WIDTH( )

On DM3 boards, the data provided by the ATFX_WIDTH( ) function is updated each time the fax transfer completes Phase B (rather than Phase D) of the T.30 protocol. By enabling the Phase B event, you can issue ATFX_WIDTH( ) when the TFX_PHASEB event occurs.

7.5.4. fx_setparm( )

On DM3 boards, the default for the FC_SENDCONT parameter is DFC_AUTO, rather than DFC_EOM on SpringWare boards.

On DM3 boards, the FC_RXCODING parameter supports the following new value, DF_MR, in addition to DF_MH and DF_MMR. Note that DF_MR is not supported on SpringWare boards.

On DM3 boards, the FC_TXCODING parameter supports the following new values, DF_JPEG_GREY and DF_JPEG_COLOR, in addition to DF_MH, DF_MR, DF_MMR, and DF_ECM. DF_JPEG_GREY and DF_JPEG_COLOR are not supported on SpringWare boards. DF_ECM is automatically implied with DF_MMR, DF_JPEG_GREY and DF_JPEG_COLOR settings.

Click here to contact Dialogic Customer Engineering