
Description of the DP Functions, Data, and Error Codes
DP Base Programming Interface for CP 5613/CP 5614
104
C79000-G8976-C108-01
Parameters
Name Description
user_handle User handle assigned with the DP_open call.
Request
Pointer to DP-V1 structure DPC1_REQ_S with entries for the
event mechanism.
typedef struct DPC1_REQ_S
{
DPR_WORD order_id; // in
DPR_DWORD c_ref; // reserved
union
{
DP_DS_READ_T dp_ds_read;
DP_DS_WRITE_T dp_ds_write;
DP_ALARM_ACK_T dp_alarm_ack;
DP_ENABLE_EVT_T dp_enable_evt;
DP_GET_CFG_T dp_get_cfg;
}req;
} DPC1_REQ_T;
The order_id is a job identifier assigned by the user program.
The identifier is returned unchanged in the asynchronous
confirmation and can be used to identify the job to which the
confirmation belongs.
Here, the c_ref element is reserved.
In the "req" union, only the "dp_enable_event" variant is
relevant and is described below.
error
Address of a structure provided by the user program of the
type DP_ERROR_T. If an error occurred, the structure
contains details for troubleshooting (see Section 4.4).
Structure of the request->req.dp_enable_evt Structure Element
typedef struct DP_ENABLE_EVT_S
{
DPR_DWORD selector; // in
DPR_BYTE mst_state; // in
DPR_BYTE event [DPR_MAX_SLAVE_ADDR]; // out
DPR_BYTE mst_event; // out
DPR_BYTE new_mst_state; // out
} DP_ENABLE_EVT_T;
Comentarios a estos manuales