9.8.5 Setting Line Device Configuration in Asynchronous Mode

The Global Call RTCM allows the customer application to retrieve or change the default configuration of a line device in asynchronous mode. Asynchronous mode is generally suggested to be used in either of the following cases:

• The request is to update parameters that are call related and the channel is not at the NULL state
• The target type is GCTGT_FIRMWARE_CHAN or GCTGT_FIRMWARE_NETIF (that is, the parameters are maintained in firmware).

Figure 40 shows the procedure for setting line device configuration in asynchronous mode.

Figure 40. Setting Line Device Configuration in Asynchronous Mode

The procedure for setting the configuration of a Line Device in asynchronous mode is as follows:

1. The channel has an active call. Create the target object data (that is, a GC_PARM_BLK data structure) with the appropriate set ID, parm ID, value size, and value buffer by calling the Global Call utility functions. See the Global Call API Library Reference for more information.
2. Call the gc_SetConfigData( ) function with:
   target_type = GCTGT_CCLIB_NETIF, GCTGT_PROTOCOL_NETIF, GCTGT_FIRMWARE_NETIF, GCTGT_CCLIB_CAHN, GCTGT_PROTCOOL_CHAN, or GCTGT_FIRMWARE_CHAN
   target_id = Global Call line device ID
   time_out = 0
   mode = EV_ASYNC
   update condition = GCUPATE_ATNULL
3. Call the gc_ResetLineDev( ) function to enforce the line to the NULL state.
4. If the gc_ResetLineDev( ) function is successful, a GCEV_RESETLINE event is received. If the gc_SetConfigData( ) function is successful, a GCEV_SETCONFIGDATA event is received. If the GCEV_SETCONFIGDATA_FAIL event is received, call the gc_ResultInfo( ) function to find the error and correct it.

Click here to contact Telecom Support Resources