User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 118
Dialogic Corporation
See Section 1.42.1.5, “Sample Code for Getting and Setting CAS Signal Definitions and
CDP Variable Values”, on page 120, specifically the GetCASSignalDef( ) function, for
example code that demonstrates how to retrieve the definition of a CAS signal, in this case
the CAS_WINKREV signal.
Setting a CAS Signal Definition
The gc_SetConfigData( ) function with the following parameter values can be used to set
a new definition for a CAS signal in the DM3 firmware:
• target_type = GCTGT_PROTOCOL_SYSTEM
• target_id = PDK Protocol ID
• target_datap = GC_PARM_BLKP parameter pointer, as constructed by the utility
function gc_util_insert_parm_ref( ) for the CAS signal
• time_out = time interval (in seconds) during which the parameter value must be
updated. If the interval is exceeded, the update request is ignored. This parameter is
supported in synchronous mode only, and it is ignored when set to 0.
• update_cond = ignored for DM3 PDK protocols
• request_idp = pointer to the location for storing the request ID, output from Global
Call
• mode = EV_ASYNC for asynchronous execution or EV_SYNC for synchronous
execution. EV_ASYNC mode is recommended.
See Section 1.42.1.5, “Sample Code for Getting and Setting CAS Signal Definitions and
CDP Variable Values”, on page 120, specifically the SetCASSignalDef( ) function, for
example code that demonstrates how to change the definition of a CAS signal, in this case
the CAS_WINKREV signal.
1.42.1.4 Retrieving or Modifying CDP Variable Values
This feature enables the user to dynamically retrieve or modify parameter values defined
in DM3 PDK protocol country dependent parameter (CDP) files. Before the CDP variable
value can be retrieved or modified, the {set ID:parm ID} pair that identifies the CDP
variable in the firmware must be retrieved. The datatype of the corresponding CDP
variable value must also be retrieved. The following sections describe the operations
relating to CDP variable values that can be performed.
Obtaining the {Set ID:Parm ID} Pair for a CDP Variable
Each CDP variable in a DM3 PDK protocol has a unique {set ID:parm ID} pair, in which
the set ID represents the component that contains the parameter and parm ID represents
an internal ID within that component. The set ID is one of a predefined set of values in the
dm3cc_parm.h file, and the parm ID is assigned by the DM3 firmware at download time.
Before dynamically retrieving or modifying the value of a CDP variable in the DM3
firmware, the user must call the gc_QueryConfigData( ) function to obtain the
{set ID:parm ID} pair of the CDP variable using the parameter name obtained from the
CDP file.