FP_FTP_SET_CONNECTION

Paramètres du serveur pour une connexion FTP

Cette instruction FP définit les paramètres du serveur pour une connexion au client FTP spécifié dans l’unité centrale selon les paramètres configurés.

Paramètres

Entrée

sServer (STRING)

Adresse du serveur (paramètre requis)

Mot-clé : SV

Valeurs : SV0–SV3 (Serveur 0–Serveur 3)
Adresse IP ou nom d’hôte (paramètre requis).
- Adresse IP
  
  Pour une adresse IP, spécifiez le mot clé IPv4 ou IPv6 au début.
  
  Syntaxe pour IPv4 : par ex. 'IPv4=111.122.133.144'
  
  Syntaxe pour IPv6 : par ex. 'IPv6=1111:122:2:1555:0:0:1888'
  
  Notez bien que pour les adresses IPv4, il y a des restrictions d’intervalle. Lorsqu’une adresse IP est spécifiée avec une instruction, il n’y a pas d’erreur d’opération mais la sortie bError passe à TRUE.
- Nom d’hôte
  
  Mot-clé : HOST
  
  Syntaxe : par ex. 'HOST=FTP.pidsx.com'
Numéro de port (paramètre optionnel)

Mot-clé : 'PORT'

Syntaxe : 'PORT=xxxxx'

Valeurs : 1–65535 (par défaut : 21)
Type de connexion (paramètre optionnel)

Mot-clé : OPEN

Syntaxe : 'OPEN=xxxx'

Valeurs : act (actif), pasv (passif) (par défaut : act)
Identification SSL3/TSL1 (paramètre optionnel)

Spécifier si l’identification SSL3/TSL1 doit être utilisée.

Mots-clés :
- SSL : Utiliser SSL3/TLS1
- NON : SSL3/TLS1 non utilisé (par défaut)

Exemples :

Connexion au serveur FTP numéro 0 avec l’adresse IP 192.255.2.10, numéro de port 21, type de connexion actif, avec identification SSL3/TLS1 : 'SV0,IPv4=192.255.2.10,PORT=21,OPEN=act,SSL'
Connexion au serveur FTP numéro 1 avec l’adresse IP 1111:1222::1555:0:0:1888, numéro de port omis (par défaut : 21), type de connexion omis (par défaut : actif), avec identification SSL3/TLS1 : 'SV1,IPv6=1111:1222::1555:0:0:1888,SSL'
Connexion au serveur FTP numéro 2 avec le nom d’hôte FTP.pidsx.com, numéro de port 28, type de connexion passif sans identification SSL3/TLS1 : 'SV2,HOST=FTP.pidsx.com,PORT=28,OPEN=pasv,NON'

sLogin (STRING)

Définir les données de connexion

Nom d’utilisateur (32 caractères max.)

Mot-clé : USER

Syntaxe : 'USER=xxx' (par défaut : root). Utiliser 'USER=' pour supprimer le nom d’utilisateur.
Mot de passe (32 caractères max., lettres minuscules et majuscules autorisées)

Mot-clé : PASS

Syntaxe : 'PASS=passwd' (par défaut : root). Utiliser 'PASS=' pour supprimer le mot de passe.

Pour ce paramètre, deux mots-clés supplémentaires sont disponibles :

INITIAL : Réinitialise le nom d’utilisateur et le mot de passe aux paramètres par défaut "root" et "root".
KEEP : Garde les paramètres d’ouverture de session actuels.

Exemples :

Entrer "Admin" comme nom d’utilisateur et "Panasonic" comme mot de passe : 'USER=Admin,PASS=Panasonic'
Entrer "Supervisor" comme nom d’utilisateur et supprimer le mot de passe : 'USER=Supervisor,PASS='
Supprimer le nom d’utilisateur et le mot de passe : 'USER=,PASS='
Réinitialiser le nom d’utilisateur et le mot de passe aux paramètres par défaut : 'INITIAL'
Garder le nom d’utilisateur et le mot de passe actuels : 'KEEP'

sCommunication (STRING)

Définir les paramètres de communication si nécessaire.

Délai d’attente de connexion

Mot-clé : TOUT

Syntaxe : 'TOUT=xxx' (par défaut : 60 secondes)

Valeurs : 30-300 secondes
Nombre d’essais

Mot-clé : RTRY

Syntaxe : 'RTRY=x' (par défaut : 3 fois)

Valeurs : 0–3
Intervalle entre les essais

Mot-clé : RTTM

Syntaxe : 'RTTM=xxxxx' (par défaut : 600 secondes)

Valeurs : 10-86400 secondes

La valeur est spécifiée par unité de 10 secondes. Elle est arrondie à la dizaine inférieure.

Exemple : Lorsque vous spécifiez 38 secondes, la valeur définie sera 30 secondes.

Pour ce paramètre, deux mots-clés supplémentaires sont disponibles :

INITIAL : Réinitialise le délai d’attente de connexion, le nombre d’essais et l’intervalle entre les essais aux paramètres par défaut.
KEEP : Garde les paramètres de communication actuels.

Exemples :

Définir le type de connexion : 30 secondes, nombre d’essais : 2, intervalle entre les essais : 500 secondes : 'TOUT=30,RTRY=2,RTTM=500'
Définir le type de connexion : 270 secondes, pas d’essais, intervalle entre les essais : 4900 secondes : 'TOUT=270,RTRY=0,RTTM=4900'
Définir le type de connexion. 30 secondes, nombre d’essais : 25, intervalle entre les essais : inchangé : 'TOUT=30,RTRY=25'
Définir le temps d’attente : inchangé, nombre d’essais : 25, intervalle entre les essais : 3000 secondes : ',RTRY=25,RTTM=3000'
Réinitialiser aux paramètres par défaut (temps d’attente : 60 secondes, nombre d’essais : 3, intervalle entre les essais : 600 secondes) : 'INITIAL'
Garder tous les paramètres actuels : 'KEEP'

Sortie

bError (BOOL)

Devient TRUE dans les conditions suivantes :

Si le temps d’attente de connexion est dépassé.
Si une adresse IP est invalide.

Lorsqu’une erreur apparaît, utilisez la variable système sys_iEthernetConnectionErrorCode pour connaître le numéro de code d’erreur.

Remarques

Les mots-clés doivent être séparés par une virgule, par ex. 'NAME=abcd,FROM=sender@server.com'
Le nombre de caractères des données STRING ne doit pas être supérieur à 256.
Cette instruction n’est pas disponible dans les programmes d’interruption.
Des caractères en lettres majuscules et minuscules peuvent être utilisés pour les opérandes pour lesquels une constante de caractères peut être spécifiée. "Abcd", "ABCD" et "abcd" sont synonymes, par contre, les noms de fichiers sont sensibles à la casse.
Avant d’exécuter l’instruction, vérifiez que sys_bIsEthernetInitializing est FALSE. sys_bIsEthernetInitializing passe à TRUE lorsque l’instruction est exécutée. Lorsque l’instruction est exécutée alors que sys_bIsEthernetInitializing est TRUE, une erreur apparaît.
L’instruction ne peut être exécutée que lorsque le drapeau de requête de transfert pour la configuration de transfert spécifiée ou le numéro nLogID spécifié est FALSE. Lorsque le drapeau de requête de transfert est TRUE, une erreur d’opération apparaît.
Lorsque l’instruction a été exécutée avec succès, les variables système sys_bIsCarry et sys_iEthernetConnectionErrorCode sont réinitialisées.
Lorsqu’une erreur apparaît, utilisez la variable système sys_iEthernetConnectionErrorCode pour connaître le numéro de code d’erreur.

Drapeaux d’erreur

sys_bIsOperationErrorHold (passe à TRUE et reste TRUE)

Si une valeur spécifiée pour un paramètre est en dehors de l’intervalle autorisé.
Si le même mot-clé est spécifié plusieurs fois.
Si le drapeau de requête de transfert pour la configuration de transfert spécifiée est "TRUE : Requête de transfert" lorsque l’instruction est exécutée.
Si le drapeau de requête de transfert pour un numéro nLogID spécifié est TRUE, par ex. si sys_blsLog0DataRecordingActive est TRUE.
Si les numéros de serveurs ne sont pas spécifiés dans l’ordre croissant.
Si l’instruction est exécutée dans un programme d’interruption.
Si le nombre de caractères des données STRING est supérieur à 256.

sys_bIsOperationErrorNonHold (passe à TRUE pendant un cycle)

Si une valeur spécifiée pour un paramètre est en dehors de l’intervalle autorisé.
Si le même mot-clé est spécifié plusieurs fois.
Si le drapeau de requête de transfert pour la configuration de transfert spécifiée est "TRUE : Requête de transfert" lorsque l’instruction est exécutée.
Si le drapeau de requête de transfert pour un numéro nLogID spécifié est TRUE, par ex. si sys_blsLog0DataRecordingActive est TRUE.
Si les numéros de serveurs ne sont pas spécifiés dans l’ordre croissant.
Si l’instruction est exécutée dans un programme d’interruption.
Si le nombre de caractères des données STRING est supérieur à 256.

sys_bIsCarry (passe à TRUE pendant un cycle)

Si l’instruction est exécutée avec une adresse IP incorrecte, sys_iEthernetConnectionErrorCode est définie sur "1 : Adresse IP spécifiée incorrecte".
Si l’instruction est exécutée pendant l’initialisation d’Ethernet, sys_iEthernetConnectionErrorCode est définie sur "11 : initialisation Ethernet en cours".

Thèmes apparentés

sys_iEthernetConnectionErrorCode

Exemple

En-tête du POU

Toutes les variables d’entrée et de sortie utilisées pour programmer cette fonction ont été déclarées dans l’en-tête du POU. Le même en-tête de POU est utilisé pour tous les langages de programmation.

	VAR
		bError: BOOL:=FALSE;
		wErrorCode: WORD:=0;
		bSetConnectionOK: BOOL:=FALSE;
		bSetConnectionError: BOOL:=FALSE;
		bSetConnection: BOOL:=FALSE;
	END_VAR

Corps du POU

Lorsque bSetConnection passe de FALSE à TRUE et lorsque sys_bIsEthernetInitializing est FALSE, l’instruction est exécutée.

Corps en LD

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 9 ;
        NETWORK_BODY
B(B_CONTACT,,bSetConnection,5,1,7,3,R);
B(B_CONTACT,,sys_bIsEthernetInitializing,16,1,18,3,N);
B(B_VARIN,,'SV0~IPv4=192.168.178.64~PORT=21~OPEN=pasv~NON',21,5,23,7,);
B(B_VARIN,,'USER=user~PASS=user',21,6,23,8,);
B(B_VARIN,,'TOUT=30~RTRY=0~RTTM=120',21,7,23,9,);
B(B_VAROUT,,bSetConnectionError,36,5,38,7,);
B(B_F,FP_FTP_SET_CONNECTION!,,23,3,36,9,,?DEN?DsServer?DsLogin?DsCommunication?AENO?CbError);
L(7,2,16,2);
L(1,2,5,2);
L(18,2,18,5);
L(18,5,23,5);
L(1,0,1,9);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bSetConnectionError,6,1,8,3,);
B(B_F,E_MOVE!,,25,0,31,4,,?DEN?D?AENO?C);
B(B_VARIN,,sys_iEthernetConnectionErrorCode,23,2,25,4,);
B(B_VAROUT,,wErrorCode,31,2,33,4,);
L(8,2,25,2);
L(1,2,6,2);
L(1,0,1,4);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 3 ;
        NETWORK_BODY
B(B_CONTACT,,bError,6,1,8,3,N);
B(B_COIL,,bSetConnectionOK,28,1,30,3,);
L(8,2,28,2);
L(1,2,6,2);
L(1,0,1,3);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Corps en ST

If DF(bSetConnection) AND NOT sys_bIsEthernetInitializing then
    FP_FTP_SET_CONNECTION(sServer := 'SV0,IPv4=192.168.178.64,PORT=21,OPEN=pasv,NON',
                          sLogin := 'USER=user,PASS=user',
                          sCommunication := 'TOUT=30,RTRY=0,RTTM=120', 
                    bError => bSetConnectionError);
End_if;
If (bSetConnectionError) then
    wErrorCode := sys_iEthernetConnectionErrorCode;
End_if;
If NOT bError then
    bSetConnectionOK := TRUE;
End_if;