Siemens SIMATIC NET PROFIBUS Manual de servicio descargar pdf (Pagina 66)

Description of the DP Functions, Data, and Error Codes

DP Base Programming Interface for CP 5613/CP 5614

C79000-G8976-C108-01

4.1 List of Functions of the CP 5613 and CP 5614

Conventions in the Text

In the descriptions in this chapter, the following conventions are used in the

function declaration:

Notation Meaning

// in The value is provided by the user program as input for the

function.

// out The value is returned to the user program by the function.

// inout The value must be initialized and is updated on completion

of the function.

Uniform Call Structure of the Functions of dp_base.dll

The functions have a uniform structure, as follows:

Error class = DP_... ( Job-defining parameter 1,

...

Job-defining parameter n,

DP_ERROR_T *error);

Each function returns one of the error classes described below. If an error occurs,

then depending on the error class, the DP_ERROR_T structure contains detailed

error information (see Section 4.4). How the error is evaluated and the function

DP_get_err_txt are explained in the sample programs supplied.

In the descriptions of the functions, the return values are described in tables as

shown below based on the example of the DP_start_cp function call:

If the return value is DP_OK, the function was executed successfully.

If the return value is not DP_OK and the error_code component in the

DP_ERROR_T error structure has the value

CI_RET_START_ALREADY_DONE, the CP has already been started using a

different database. Your user program should be able to react to such explicit

error codes.

In other situations, the error only occurs in exceptional cases.

1 2 ... 61 62 63 64 65 66 67 68 69 70 71 ... 237 238

Sin comentarios

Siemens SIMATIC NET PROFIBUS Manual de servicio Pagina 66