DPS_open - Zusätzliche Funktionen des CP 5614

4.2 Zusätzliche Funktionen des CP 5614

4.2.2 DPS_open

Zweck

Mit dieser Funktion meldet sich ein DPS-Anwenderprogramm beim Treiber an und stellt die Slave-Parameter ein. Im Erfolgsfall gibt die Funktion ein User-Handle zu-rück. Das User-Handle muss bei allen weiteren Funktionsaufrufen verwendet wer-den.

Hinweis 1

Bei der Slave-Betriebsart DPS_SM_SIMPLE werden die Eingabedaten aus den Vorgabedaten für das Slave-Modul automatisch übernommen. Wenn der Slave nicht in der Betriebsart DPS_SM_SIMPLE betrieben wird, müssen nach der positi-ven Quittierung eines Konfigurationstelegramms die Eingabedaten des Slave-Moduls initialisiert (d. h. geschrieben) werden.

Syntax

DPR_DWORD DPS_open (

const DPR_STRING *cp_name, // in DPR_DWORD *user_handle, // out DPR_DWORD slave_mode, // in DPR_WORD station_addr, // in DPR_WORD addr_change, // in DPR_WORD pno_ident_nr, // in

DPR_WORD user_wd, // in

DPS_INIT_DATA_T *init_data, // in DPS_MAX_DATA_T *max_data, // in

DPR_WORD baud_rate, // in

DP_ERROR_T *error); // out

Programmierschnittstelle DP-Base für CP 5613/CP 5614

142 C79000-G8900-C139-04

Parameter

Name Beschreibung

cp_name Logischer Name eines CP 5614 (z. B. „CP_L2_1:“) user_handle Zeiger auf User-Handle-Variable - Im Erfolgsfall wird hier

das dem Anwenderprogramm zugeordnete User-Handle eingetragen.

slave_mode Einstellung der Slave-Betriebsart (die einzelnen Flags wer-den bitweise verknüpft):

• DPS_SM_SIMPLE Einfacher Slave mit auto-matischer Prüfung von Parametrier- und Konfigura-tionsdaten.

• DPS_SM_V1_ENABLE DP-V1-Dienste aktivieren

• DPS_SM_FREEZE_SUPP Freeze unterstützen

• DPS_SM_SYNC_SUPP Sync unterstützen

• DPS_SM_DYNAMIC Parametrier- und Konfigura-tionsdaten des Slaves wer-den dynamisch geprüft.

station_addr Stationsadresse des Slave

addr_change 1 bedeutet: Adressänderung über Bus erlauben.

0 bedeutet: Adressänderung über Bus nicht erlauben.

pno_ident_nr Von der PNO bei der Zertifizierung vergebene eindeutige Nummer für diesen Slave, z. B. 0x0008 für das Beispiel-anwenderprogramm. Diese Nummer wird im Intel-Format dargestellt.

user_wd Rechenformel:

User_wd*10ms = Überwachungszeit des Anwenderpro-gramms

Wenn in dieser Zeit der Watchdog nicht nachgetriggert wird verlässt der Slave den Zustand Produktivbetrieb (Data_Ex).

Mit 0 wird der Watchdog deaktiviert.

Ab welcher Software-Version diese Eigenschaft verfügbar ist, können Sie in der Versionstabelle im Kapitel 14.2 der In-stallationsanleitung nachlesen. Solange der Watchdog nicht realisiert ist, muss dieser Parameter mit 0 vorbelegt werden.

Fortsetzung der Tabelle auf der nächsten Seite

Fortsetzung der Tabelle von der letzten Seite

Name Beschreibung

init_data Zeiger auf eine Struktur mit Informationen über die erwei-terten Slave-Daten.

Typedef union DPS_INIT_DATA_S {

struct DPS_SIMPLE_S {

DPR_WORD user_prm_data_len; // in DPR_BYTE user_prm_data

[DPS_MAX_PDU_LEN]; // in DPR_WORD cfg_data_len; // in DPR_BYTE cfg_data[DPS_MAX_PDU_LEN];

// in }simple;

struct DPS_DYNAMIC_S {

DPR_WORD def_cfg_data_len; // in DPR_BYTE def_cfg_data

[DPS_MAX_PDU_LEN]; // in }dynamic;

}DPS_INIT_DATA_T

user_prm_data_len: Länge der vorgegebenen User-Parametrierdaten <= 237 Byte user_prm_data: vorgegebene

User-Parametrier-daten

cfg_data_len: Länge der vorgegebenen Konfi-gurationsdaten <= 244 Byte cfg_data: vorgegebene vorgegebenen

Konfigurationsdaten (Format sie-he Kap. 4.7.3)

def_cfg_data_len: Länge der Default-Konfigurations-daten <= 244 Byte

def_cfg_data: Default-Konfigurationsdaten Anmerkung:

Das erste User-Parametrierdaten-Byte ist für den Slave-Controller reserviert und wird bei der Überprüfung nicht berücksichtigt!

Im DP-V1-Modus sind die ersten 3 User-Parametrier-datenbytes reserviert und werden bei der Überprüfung nicht berücksichtigt!

Programmierschnittstelle DP-Base für CP 5613/CP 5614

144 C79000-G8900-C139-04

Fortsetzung der Tabelle von der letzten Seite

Name Beschreibung

max_data Zeiger auf eine Struktur mit den maximalen Pufferlängen für Eingabe- und Ausgabedaten, für User-Diagnose, für User-Parametrier- und Konfigurationsdaten und zuletzt für die User-Set-Slave-Adressdaten.

Typedef DPS_MAX_DATA_S {

DPR_BYTE max_input_data_len; // in DPR_BYTE max_output_data_len; // in DPR_BYTE max_user_diag_len; // in DPR_BYTE max_user_prm_data_len; // in DPR_BYTE max_cfg_data_len; // in DPR_BYTE max_user_ssa_data_len; // in }DPS_MAX_DATA_T

Anmerkung:

„max_user_ssa_data_len“ muss nicht ausgefüllt werden, falls addr_change mit 0 belegt ist.

Die Summe der Werte für max_input_data_len und max_output_data_len definiert die Länge des insgesamt zur Verfügung stehenden Datenpuffers für Ein- und Aus-gabedaten. Eine max_input_data_len von 0 schließt somit bei genügend großer max_output_data_len den Empfang von Daten nicht aus.

baud_rate Einzustellende Datenübertragungsgeschwindigkeit - Für den CP 5614 muss DPS_BD_AUTO_DETECT angegeben werden, da der CP 5614 über eine automatische Erken-nung der Datenübertragungsgeschwindigkeit verfügt.

error Adresse einer vom Anwenderprogramm bereitgestellten Struktur vom Typ DP_ERROR_T - Die Struktur enthält im Fehlerfall Details zur Fehlerursache (siehe Kapitel 4.4).

Return-Wert

Name Beschreibung

DP_OK Erfolgreicher Abschluss der Funktion.

DP_ ERROR_CI und error->error_code ==

CI_RET_OPEN_CP_NOT_

STARTED

CP ist nicht gestartet.

DP_ ERROR_EVENT_NET und error->error_code ==

DPS_RET_DOUBLE_OPEN

DPS_open wurde bereits durchgeführt.

DP_ ERROR_EVENT_NET und error->error_code ==

DPS_RET_NOT_OFFLINE

Das Slave-Modul ist nicht offline.