Fonctions de transmission

Les fonctions de transmission comprennent des fonctions copie, ping, e-mail et FTP.

FPWEB_COPY_DT

Cette fonction copie les données (registres DT/WI) d’une source vers une destination.

Cette fonction peut être appelée continuellement.

Si la destination est un automate, veillez à écrire vers la zone de données définie pour éviter les erreurs d’exécution du programme dans l’automate de destination.

Les zones de la mémoire interne du FP-I4C ("INTERNE") peuvent également être une destination. C’est particulièrement utile pour collecter des données de sources différentes et pour les rendre disponibles dans des pages HTML ou pour les transmettre à l’enregistrement des données (data logger).

Appel

FPWEB_COPY_DT(source interface, source station number, source DT/WI address, target interface, target station number, target DT/WI address, number of DTs/WIs);

Résultat

La fonction renvoie 0 en cas de succès ou -1 en cas d’erreur.

Exemple

FPWEB_COPY_DT("RS232", 1, 10, "INTERN", 1, 50, 30);

Paramètres

source interface

Nom de l’interface de communication du dispositif source

  • "RS232"

  • "RS232_L" : code fonction 0x04 [input register] au lieu de 0x03 [holding register], pour Modbus uniquement ; si elle est utilisée pour d’autres protocoles, elle est traitée en tant que "RS232".

  • "RS485"

  • "RS485_L" : code fonction 0x04 [input register] au lieu de 0x03 [holding register], pour Modbus uniquement ; si elle est utilisée pour d’autres protocoles, elle est traitée en tant que "RS485".

  • "USB"

  • "ETHERNET" : communication via Modbus/TCP

  • "ETHERNET_L" : code fonction 0x04 [input register] au lieu de 0x03 [holding register], uniquement pour Modbus/TCP.

  • "INTERN" : INTERNE correspond aux zones de la mémoire interne.

source station number

Numéro de station du dispositif source

  • 1–99 : toutes les interfaces

  • 100–247 : adresses supplémentaires pour ETHERNET

  • 0 : multicast (interfaces série)

source DT/WI address

Adresse de départ DT dans l’automate source ou adresse de départ WI dans le FP-I4C

La plage d’adresses DT valide dépend du type d’automate et du protocole utilisés. La plage d’adresses WI est de 0 à 33120.

target interface

Nom de l’interface de communication du dispositif de destination

  • "RS232"

  • "RS485"

  • "USB"

  • "ETHERNET" : communication via Modbus/TCP

  • "INTERN" : INTERNE correspond aux zones de la mémoire interne.

target station number

Numéro de station du dispositif de destination

  • 1–99 : toutes les interfaces

  • 100–247 : adresses supplémentaires pour ETHERNET

  • 0 : multicast (interfaces série)

target DT/WI address

Adresse de départ DT dans l’automate de destination ou adresse de départ WI dans le FP-I4C

La plage d’adresses DT valide dépend du type d’automate et du protocole utilisés. La plage d’adresses WI est de 0 à 33120.

number of DTs/WIs

Nombre de registres à copier

L’intervalle valide dépend du type d’automate et du protocole utilisés. Pour le FP-I4C, l’intervalle est de 1 à 33121.

FPWEB_EMAIL

Cette fonction contrôle la transmission active d’e-mails, de manière identique à la fonction client e-mail contrôlée par un automate.

Utilisez cette fonction uniquement si vous avez besoin de paramètres supplémentaires qui ne peuvent pas être définis sur la page Script.

Cette fonction peut être appelée continuellement.

La transmission commence dès que l’heure spécifiée est atteinte et si le fichier à envoyer est disponible.

Appel

FPWEB_EMAIL(file format, rename text, splitting mode, time, cycle, number of retries, file number);

Résultat

Nombre de fichiers transmis ou 0 si aucun fichier ne doit être transmis

Paramètres

file format

Format du nom du fichier source à envoyer entre guillemets

  • "DEFAULT_FORMAT" : Utilisez cette valeur si vous avez sélectionné un fichier de format défini par l’utilisateur.

  • Une chaîne de caractères et les variables suivantes :
    • %y (année abrégée avec deux caractères)
    • %Y (année complète avec quatre caractères)
    • %m (mois en nombre, 01–12)
    • %d (jour en nombre, 01–31)
    • %W (semaine du calendrier)
    • %j (jour de la semaine)
    • %H (heure)
    • %M (minute)
    • %S (seconde)
    • %F (nom du fichier d’enregistrement défini dans Data Logger > Fichiers d’enregistrement
    • %x (numéro de lot avec 5 digits, 0–65535)
    • %X (numéro de lot avec 10 digits, 0–4294967293)

    Sans la date, les numéros de lots ne peuvent pas être envoyés correctement.

Exemple : "AnyName%y%m%d_%H%M%S_TRG).CSV"

rename text

Extension du nom de fichier pour des fichiers transmis avec succès

  • Une chaîne de caractères (7 caractères max.)

  • Vide : L’extension du nom de fichier par défaut ".CS_" est utilisée.

  • "DELETE" : Le fichier est supprimé.

splitting mode

Informations relatives à la division des fichiers pour détecter les fichiers d’enregistrement actuellement actifs et pour éviter d’envoyer des fichiers d’enregistrement incomplets

  • "MINUTE"
  • "HOUR"
  • "DAY"
  • "WEEK"
  • "MONTH"
  • "YEAR"
  • "SPLIT_OFF"

Exemple : Pour "DAY", seuls les fichiers du jour précédant la date du jour seront envoyés.

Si file format="DEFAULT_FORMAT", le mode de division des fichiers paramétré dans le format de fichier défini par l’utilisateur est appliqué.

time

Heure de départ de la transmission après minuit en secondes.

0 : valeur par défaut (minuit)

Si la valeur définie est < 120s (ou 0 pour minuit), le système lance la transmission 120 secondes après minuit. Ceci permet d’éviter la transmission des données enregistrées à minuit.

Exemple : Pour une valeur de 43200, la première transmission de la journée est à 12:00.

cycle

Intervalle de transmission ou délai d’attente avant une nouvelle transmission en secondes. Si la différence de temps par rapport à la dernière transmission est plus courte que le cycle de transmission, la fonction s’arrête.

Cette valeur et celle de time déterminent le cycle de transmission.

60 : Valeur par défaut

Exemple : Pour une valeur de 60, la fonction essaie d’envoyer des fichiers toutes les minutes.

number of retries

Nombre d’essais maximum lorsque la transmission a échoué.

Lorsque le nombre d’essais maximum a été atteint, la fonction s’arrête.

file number

Numéro du fichier d’enregistrement

  • 0 à 15 : numéro du fichier

  • -1 : tous les fichiers d’enregistrement

Thèmes apparentés

FPWEB_FTP

Cette fonction contrôle la transmission FTPC active, de manière identique à la fonction FTPC contrôlée par un automate.

Utilisez cette fonction uniquement si vous avez besoin de paramètres supplémentaires qui ne peuvent pas être définis sur la page Script.

Cette fonction peut être appelée continuellement.

La transmission commence dès que l’heure spécifiée est atteinte et si le fichier à envoyer est disponible.

Appel

FPWEB_FTP(file format, rename text, splitting mode, time, cycle, number of retries, file number);

Résultat

Nombre de fichiers transmis ou 0 si aucun fichier ne doit être transmis

Paramètres

file format

Format du nom du fichier source à envoyer entre guillemets

  • "DEFAULT_FORMAT" : Utilisez cette valeur si vous avez sélectionné un fichier de format défini par l’utilisateur.

  • Une chaîne de caractères et les variables suivantes :
    • %y (année abrégée avec deux caractères)
    • %Y (année complète avec quatre caractères)
    • %m (mois en nombre, 01–12)
    • %d (jour en nombre, 01–31)
    • %W (semaine du calendrier)
    • %j (jour de la semaine)
    • %H (heure)
    • %M (minute)
    • %S (seconde)
    • %F (nom du fichier d’enregistrement défini dans Data Logger > Fichiers d’enregistrement
    • %x (numéro de lot avec 5 digits, 0–65535)
    • %X (numéro de lot avec 10 digits, 0–4294967293)

    Sans la date, les numéros de lots ne peuvent pas être envoyés correctement.

Exemple : "AnyName(%y%m%d_%H%M%S_TRG).CSV"

rename text

Extension du nom de fichier pour des fichiers transmis avec succès

  • Une chaîne de caractères (7 caractères max.)

  • Vide : L’extension du nom de fichier par défaut ".CS_" est utilisée.

  • "DELETE" : Le fichier est supprimé.

splitting mode

Informations relatives à la division des fichiers pour détecter les fichiers d’enregistrement actuellement actifs et pour éviter d’envoyer des fichiers d’enregistrement incomplets

  • "MINUTE"
  • "HOUR"
  • "DAY"
  • "WEEK"
  • "MONTH"
  • "YEAR"
  • "SPLIT_OFF"

Exemple : Pour "DAY", seuls les fichiers du jour précédant la date du jour seront envoyés.

Si file format="DEFAULT_FORMAT", le mode de division des fichiers paramétré dans le format de fichier défini par l’utilisateur est appliqué.

time

Heure de départ de la transmission après minuit en secondes.

0 : valeur par défaut (minuit)

Si la valeur définie est < 120s (ou 0 pour minuit), le système lance la transmission 120 secondes après minuit. Ceci permet d’éviter la transmission des données enregistrées à minuit.

Exemple : Pour une valeur de 43200, la première transmission de la journée est à 12:00.

cycle

Intervalle de transmission ou délai d’attente avant une nouvelle transmission en secondes. Si la différence de temps par rapport à la dernière transmission est plus courte que le cycle de transmission, la fonction s’arrête.

Cette valeur et celle de time déterminent le cycle de transmission.

60 : Valeur par défaut

Exemple : Pour une valeur de 60, la fonction essaie d’envoyer des fichiers toutes les minutes.

number of retries

Nombre d’essais maximum lorsque la transmission a échoué.

Lorsque le nombre d’essais maximum a été atteint, la fonction s’arrête.

file number

Numéro du fichier d’enregistrement

  • 0 à 15 : numéro du fichier

  • -1 : tous les fichiers d’enregistrement

Thèmes apparentés

FPWEB_PING

Cette fonction teste la communication avec d’autres dispositifs du réseau.

Le nombre d’appels ping et l’intervalle entre les pings influencent le fonctionnement du script (opération séquentielle).

Appel

FPWEB_PING(IP string, number of ping calls, ping interval);

Résultat

Nombre d’appels pings avec des réponses réussies

Exemple

DT[10] := FPWEB_ PING(“www.panasonic.com”, 3, 1000);

Paramètres

IP string

Adresse IP ou URL du dispositif à tester

number of ping calls

Nombre d’appels pings à envoyer

ping interval

Temps en secondes (valeur < 300) ou temps en ms (valeur >= 300) entre les appels pings