60
SIMATIC S7ProSim V5.3 incluant SP1 Objet COM Guide de l'utilisateur Edition : 01/2005 A5E00425514-01

S7ProSim V5.3 incluant SP1 Objet COM - legins69.free.frlegins69.free.fr/automatisme/PL7Pro/prosim_f.pdf · iii Préface S7ProSim fournit un accès par programme à l'interface de

  • Upload
    lediep

  • View
    221

  • Download
    0

Embed Size (px)

Citation preview

SIMATIC

S7ProSim V5.3 incluant SP1

Objet COM

Guide de l'utilisateur

Edition : 01/2005

A5E00425514-01

Copyright et conseils de sécurité Ce manuel donne des consignes que vous devez respecter pour votre propre sécurité ainsi que pour éviter des dommages matériels. Elles sont mises en évidence par un triangle d'avertissement et sont présentées, selon le risque encouru, de la façon suivante :

Danger signifie que la non-application des mesures de sécurité appropriées conduit à la mort ou à des lésions corporelles graves.

Attention signifie que la non-application des mesures de sécurité appropriées peut conduire à la mort ou à des lésions corporelles graves.

Avertissement Utilisé avec le symbole de mise en garde, signifie que la non-application des mesures de sécurité appropriées peut conduire à des lésions corporelles légères.

Avertissement Utilisé sans le symbole de mise en garde, signifie que la non-application des mesures de sécurité appropriées peut conduire à un dommage matériel.

Nota Utilisé sans le symbole de mise en garde, signale une situation potentielle pouvant entraîner un résultat ou un état non désiré.

Personnel qualifié La mise en service et l'utilisation de l'appareil ou du système ne doivent être effectuées que conformément au manuel. Seules des personnes qualifiées sont autorisées à effectuer des interventions sur l'appareil. Il s'agit de personnes qui ont l'autorisation de mettre en service, de mettre à la terre et de repérer des appareils, systèmes et circuits électriques conformément aux règles de sécurité en vigueur.

Utilisation conforme aux dispositions Tenez compte des points suivants :

Attention L'appareil ne doit être utilisé que pour les applications spécifiées dans le catalogue ou dans la description technique, et exclusivement avec des périphériques et composants recommandés par Siemens.

Le transport, le stockage, le montage, la mise en service ainsi que l'utilisation et la maintenance adéquats du produit sont les conditions indispensables pour garantir son fonctionnement correct et sûr.

Marques de fabrique Siemens® et SIMATIC® sont des marques déposées par SIEMENS AG. STEP 7™ et S7™ sont des marques de SIEMENS AG. Microsoft ®, Windows ®, Windows 95 ®, Windows 98 ®, Windows NT ®, Windows ME ® et Windows 2000 ® sont des marques déposées par Microsoft Corporation. ActiveX™ est une marque de Microsoft Corporation.

Copyright Siemens Energy & Automation, Inc. 2005 Tous droits réservés Toute communication ou reproduction de ce support d'information, toute exploitation ou communication de son contenu sont interdites, sauf autorisation expresse. Tout manquement à cette règle est illicite et expose son auteur au versement de dommages et intérêts. Tous nos droits sont réservés, notamment pour le cas de la délivrance d'un brevet ou celui de l'enregistrement d'un modèle d'utilité.

Exclusion de responsabilité Nous avons vérifié la conformité du contenu du présent manuel avec le matériel et le logiciel qui y sont décrits. Or des divergences n'étant pas exclues, nous ne pouvons pas nous porter garants pour la conformité intégrale. Si l'usage de ce manuel devait révéler des erreurs, nous en tiendrons compte et apporterons les corrections nécessaires dès la prochaine édition. Veuillez nous faire part de vos suggestions.

Siemens Energy & Automation, PCbA One Internet Plaza Johnson City, TN 37602-4991, Etats-Unis d'Amérique

© Siemens Energy & Automation, Inc. 2005 Nous nous réservons le droit de modifier les caractéristiques techniques.

iii

Préface S7ProSim fournit un accès par programme à l'interface de simulation d'AP de S7-PLCSIM. Avec S7ProSim, vous pouvez écrire du logiciel pour exécuter des tâches comme changer la position du commutateur à clé de l'AP de simulation, exécuter le programme cycle par cycle, écrire ou lire les valeurs de l'automate, etc.

Groupe cible

Ce manuel est destiné aux ingénieurs, aux programmeurs et au personnel de maintenance expérimentés connaissant les automates programmables (AP) S7 et la conception de logiciels dans Visual Basic (6.0 ou .NET) ou Visual C++ (6.0 ou .NET).

Objet

Ce document décrit les caractéristiques et le fonctionnement de S7ProSim V5.3 incluant SP1.

Autres manuels

Vous trouverez des informations supplémentaires dans l'aide en ligne de STEP 7 et de S7-PLCSIM, ainsi que dans les manuels suivants :

• Manuel Programmer avec STEP 7. Ce manuel fournit des informations de base sur la conception et la programmation de programmes de commande. Servez-vous de ce manuel pour créer un programme de commande avec le logiciel d'automatisation STEP 7.

• Manuel de référence Logiciel système pour SIMATIC S7-300/400, Fonctions standard et fonctions système. Ce manuel décrit les fonctions système, les blocs d'organisation et les fonctions standard que vous utilisez lors de la conception d'un programme de commande.

• Manuel STEP 7, Getting Started. Ce manuel explique comment utiliser le logiciel d'automatisation STEP 7. Il présente les procédures utilisées pour configurer un AP et pour concevoir des programmes de commande.

• S7-PLCSIM - Tester le programme de votre CPU S7. Ce manuel explique l'interface utilisateur et le fonctionnement de S7-PLCSIM, l'application de simulation d'automates S7.

Pour trouver ces manuels ou d'autres manuels, sélectionnez la commande Démarrer > Simatic > Documentation dans le menu Démarrer de l'ordinateur où est installé STEP 7.

Aide supplémentaire Adressez-vous à votre agence Siemens si certaines de vos questions techniques restent sans réponse, si vous désirez passer une commande ou si vous voulez connaître les offres de formation.

Amérique du Nord et du Sud Europe et Afrique Asie et région du Pacifique

Téléphone : +1 (800) 333-7421 Téléphone : +49 (0) 180 5050 222 Téléphone : +86 10 64 75 75 75

Télécopie : +1 (423) 262-2200 Télécopie : +49 (0) 180 5050 223 Télécopie : +86 10 64 74 74 74

[email protected] [email protected] [email protected]

v

Sommaire Présentation de S7ProSim .................................................................................. 1

Ajout d'un objet COM S7ProSim à votre projet.............................................................. 1 Programmation d'une interface vers S7-PLCSIM à l'aide de S7ProSim ....................... 2

Méthodes............................................................................................................... 3 BeginScanNotify ............................................................................................................ 5 Connect ......................................................................................................................... 6 Continue ........................................................................................................................ 7 Disconnect ..................................................................................................................... 8 EndScanNotify ............................................................................................................... 9 ExecuteNmsScan ........................................................................................................ 10 ExecuteNScans ........................................................................................................... 11 ExecuteSingleScan...................................................................................................... 12 GetPauseState ............................................................................................................ 13 GetScanMode.............................................................................................................. 14 GetStartUpSwitch ........................................................................................................ 15 GetState....................................................................................................................... 16 HotStartWithSavedValues ........................................................................................... 17 Pause........................................................................................................................... 18 ReadDataBlockValue................................................................................................... 19 ReadFlagValue ............................................................................................................ 20 ReadOutputImage ....................................................................................................... 21 ReadOutputPoint ......................................................................................................... 22 SavePLC...................................................................................................................... 23 SetScanMode .............................................................................................................. 24 SetStartUpSwitch......................................................................................................... 25 SetState....................................................................................................................... 26 StartPLCSim................................................................................................................ 27 WriteDataBlockValue................................................................................................... 28 WriteFlagValue ............................................................................................................ 29 WriteInputImage .......................................................................................................... 30 WriteInputPoint ............................................................................................................ 31

Evénements ........................................................................................................ 33 ConnectionError........................................................................................................... 34 PauseStateChanged.................................................................................................... 35 PLCSimStateChanged................................................................................................. 36 ScanFinished............................................................................................................... 37 ScanModeChanged..................................................................................................... 38

Définitions de types ........................................................................................... 39 CPURunMode.............................................................................................................. 40 ImageDataTypeConstants ........................................................................................... 41 PauseStateConstants .................................................................................................. 42 PointDataTypeConstants............................................................................................. 43

Sommaire

vi

RestartSwitchPosition.................................................................................................. 44 ScanModeConstants ................................................................................................... 45 tagPauseState ............................................................................................................. 46

Codes d'erreur .................................................................................................... 47

1

Présentation de S7ProSim S7ProSim fournit un objet COM qui donne accès par programme à l'interface de simulation de processus de S7-PLCSIM. Vous pouvez utiliser S7ProSim dans toute application qui peut accepter que des objets COM soient reliés à une simulation de processus S7-PLCSIM.

Ce document en ligne décrit comment ajouter S7ProSim à une application, ainsi que les caractéristiques, interface et fonctionnements de S7ProSim, notamment les définitions objets logicielles des méthodes et des événements.

Ajout d'un objet COM S7ProSim à votre projet Pour ajouter un objet COM S7ProSim dans votre projet, vous insérez une référence à cet objet. Les étapes nécessaires pour ajouter une référence de projet dépendent de votre environnement de programmation. Dans Microsoft Visual Basic (6.0 ou .NET) par exemple, vous devez exécuter les étapes suivantes pour ajouter une référence d'objet COM S7ProSim :

1. Sélectionnez la commande Projet > Références ou Projet > Ajouter référence.

2. Dans la boîte de dialogue Références, cochez la case pour l'objet COM S7ProSim Siemens. Dans Visual Basic .NET, cette option se situe dans l'onglet COM de la boîte de dialogue Références.

3. Cliquez sur OK.

Une fois que vous avez ajouté la référence de projet, vous pouvez utiliser le navigateur d'objets pour examiner les méthodes et les événements de l'objet COM S7ProSim. Dans le navigateur d'objets, sélectionnez S7PROSIMLib dans la liste déroulante des bibliothèques. La classe S7ProSim contient les méthodes et les événements que vous pouvez utiliser pour programmer une interface vers S7-PLCSIM.

Dans Microsoft Visual Studio C++ V6.0 ou dans Microsoft Visual C++ .NET, suivez les procédures d'ajout d'objet COM qui sont pertinentes pour l'environnement de programmation concerné.

Présentation de S7ProSim

2

Programmation d'une interface vers S7-PLCSIM à l'aide de S7ProSim Vous devez exécuter les tâches suivantes pour faire fonctionner l'automate de simulation S7-PLCSIM de manière programmée à l'aide de S7ProSim :

• Inclure l'objet COM Siemens S7ProSim dans le projet.

• Ajouter une déclaration pour S7ProSim à votre projet.

Exemple : Visual Basic 6.0 Option Explicit Private WithEvents S7ProSim As S7PROSIMLib.S7ProSim ... Private Sub Form_Load() Set S7ProSim1 = New S7PROSIMLIB.S7ProSim ... End Sub

Exemple : Visual Basic .NET Private WithEvents S7ProSim As New S7PROSIMLib.S7ProSim

Exemple : C# using S7PROSIMLib; ... private S7ProSim ps;

• Gestionnaires d'événements de programme pour les événements S7ProSim . Les gestionnaires d'événements sont nécessaires pour chaque événement S7ProSim. Vous pouvez insérer, à l'intérieur de chaque gestionnaire d'événement, du code personnalisé pour votre application.

Exemple : Visual Basic 6.0 Private Sub S7ProSim1_PauseStateChanged(ByVal NewState As String) DoEvents ... End Sub Private Sub S7ProSim1_ScanFinished(ByVal ScanInfo As Variant) DoEvents ... End Sub Private Sub S7ProSim1_PLCSimStateChanged(ByVal NewState As String) DoEvents ... End Sub Private Sub S7ProSim1_ConnectionError(ByVal ControlEngine As String, ByVal error As Long) DoEvents MsgBox "Erreur de connexion" End Sub Private Sub S7ProSim1_ScanModeChanged(ByVal NewState As String) DoEvents ... End Sub

Remarque Dans Visual Basic .NET, l'appel "DoEvents" n'est pas nécessaire.

• Ajoutez des boutons de commande, des boîtes de texte et d'autres objets à votre application selon vos besoins pour accéder aux diverses méthodes S7ProSim. Programmez le code pour chaque gestionnaire de bouton de commande pour l'appel de méthodes S7ProSim et définissez les valeurs correspondantes pour les boîtes de texte en fonction de votre application.

3

Méthodes BeginScanNotify Enregistre S7ProSim pour des rappels de l'automate Control

Engine. L'événement ScanFinished et l'événement PLCSimStateChanged seront envoyés lorsqu'ils se produisent.

Connect Connecte S7ProSim à S7-PLCSIM.

Continue Poursuit une simulation qui a été suspendue.

Disconnect Déconnecte S7ProSim de S7-PLCSIM.

EndScanNotify Annule l'enregistrement de S7ProSim pour des rappels de l'automate Control Engine. Les événements ScanFinished etPLCSimStateChanged ne seront pas envoyés.

ExecuteNmsScan Force S7-PLCSIM à exécuter des cycles pendant une durée indiquée (Nms) et n'attend pas que l'exécution du cycle en cours soit achevée. Si la notification de cycle est activée, le programme sera averti lorsque S7-PLCSIM aura terminé les cycles.

ExecuteNScans Force S7-PLCSIM à exécuter un nombre défini de cycles sans attendre que l'exécution du cycle en cours s'achève. Si la notification de cycle est activée, le programme sera averti lorsque S7-PLCSIM aura terminé les cycles.

ExecuteSingleScan Force S7-PLCSIM à exécuter un cycle sans attendre que l'exécution du cycle en cours s'achève. Si la notification de cycle est activée, le programme sera averti lorsque S7-PLCSIM aura terminé le cycle.

GetPauseState Renvoie l'état Pause en cours de S7-PLCSIM.

GetScanMode Renvoie le mode d'exécution de S7-PLCSIM.

GetStartUpSwitch Fournit le paramétrage de mise en route (redémarrage, démarrage à chaud ou démarrage à froid) pour S7-PLCSIM.

GetState Renvoie une chaîne contenant la position en cours du commutateur à clé de S7-PLCSIM (position RUN, RUN-P ou STOP).

HotStartWithSavedValues Définit une valeur booléenne déterminant si S7-PLCSIM doit charger la périphérie d'E/S sauvegardée lors d'une mise en route à l'état de redémarrage HotStart. Pour que S7-PLCSIM démarre et charge la périphérie d'E/S, l'utilisateur doit appeler HotStartWithSavedValues avec la valeur TRUE, enregistrer le programme AP ( SavePLC) et définir l'état de mise en route pour S7-PLCSIM à redémarrage HotStart ( SetStartUpSwitch). Lors de son redémarrage, S7-PLCSIM chargera la périphérie d'E/S.

Pause Suspend une simulation.

ReadDataBlockValue Lit un bit, un octet, un mot ou un double mot particulier dans la zone de mémoire DB de S7-PLCSIM.

ReadFlagValue Lit un bit, un octet, un mot ou un double mot particulier dans la zone des mémentos M de S7-PLCSIM.

ReadOutputImage Lit des éléments dans la périphérie de sortie (zone de mémoire PA) de S7-PLCSIM.

ReadOutputPoint Lit un bit (Boolean), un octet (Byte), un mot (Integer) ou un double mot (Long) spécifique de la périphérie de sortie (zone PA).

Méthodes

4

SavePLC Enregistre les données en cours de l'AP de simulation dans un fichier.

Les données sauvegardées comprennent le programme, la configuration matérielle, la position du commutateur à clé indiquée par la fenêtre CPU, le mode d'exécution (cycle continu ou cycle unique), l'état des E/S, les valeurs des temporisations, les adresses symboliques, ainsi que le paramétrage de l'alimentation (sous tension ou hors tension).

SetScanMode Définit le mode d'exécution pour S7-PLCSIM.

SetStartUpSwitch Définit le type de démarrage (redémarrage, démarrage à chaud ou démarrage à froid) à utiliser lors de la mise en route de S7-PLCSIM .

SetState Définit la position en cours du commutateur à clé de S7-PLCSIM (RUN, RUN-P ou STOP).

StartPLCSim Lance S7-PLCSIM avec le fichier de simulation AP indiqué (enregistré lors d'un appel précédent à SavePLC).

WriteDataBlockValue Ecrit un bit, un octet, un mot ou un double mot particulier dans la zone de mémoire DB de S7-PLCSIM.

WriteFlagValue Ecrit un bit, un octet, un mot ou un double mot particulier dans la zone des mémentos M de S7-PLCSIM.

WriteInputImage Ecrit des éléments dans la périphérie d'entrée (zone PE) de S7-PLCSIM, en commençant à la position StartIndex des données désignées par pData.

WriteInputPoint Ecrit un bit (Boolean), un octet (Byte), un mot (Integer) ou un double mot (Long) spécifique du paramètre Data (de type Variant) dans la périphérie d'entrée (zone PE).

Méthodes

5

BeginScanNotify STDMETHOD(CS7ProSim::BeginScanNotify)()

Description Enregistre S7ProSim pour des rappels de l'automate Control Engine. L'événement ScanFinished et l'événement PLCSimStateChanged seront envoyés lorsqu'ils se produisent.

Paramètres Néant

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

Utilisation Visual Basic

Méthodes

6

Connect STDMETHOD(CS7ProSim::Connect)()

Description Connecte S7ProSim à S7-PLCSIM.

Paramètres Néant

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

Utilisation Visual Basic

Méthodes

7

Continue STDMETHOD(CS7ProSim::Continue)()

Description Poursuit une simulation qui a été suspendue.

Paramètres Néant

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

8

Disconnect STDMETHOD(CS7ProSim::Disconnect)()

Description Déconnecte S7ProSim de S7-PLCSIM.

Paramètres Néant

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

Utilisation Visual Basic

Méthodes

9

EndScanNotify STDMETHOD(CS7ProSim::EndScanNotify)()

Description Annule l'enregistrement de S7ProSim pour des rappels de l'automate Control Engine. Les événements ScanFinished et PLCSimStateChanged ne seront pas envoyés.

Paramètres Néant

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

PS_E_NOTREGISTERED 0x80040209 : S7ProSim n'est pas enregistré pour des rappels de S7-PLCSIM.

Utilisation Visual Basic

Méthodes

10

ExecuteNmsScan STDMETHOD(CS7ProSim::ExecuteNmsScan)( long MsNumber)

Description Force S7-PLCSIM à exécuter des cycles pendant une durée indiquée (Nms) et n'attend pas que l'exécution du cycle en cours soit achevée. Si la notification de cycle est activée, le programme sera averti lorsque S7-PLCSIM aura terminé les cycles. S7-PLCSIM doit être en mode Cycle unique pour que vous puissiez utiliser cette méthode.

Paramètres

MsNumber Durée (en millisecondes) pendant laquelle les cycles doivent être exécutés.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTSINGLESCAN 0x8004020A : S7-PLCSIM n'est pas en mode d'exécution "cycle unique". PS_E_PLCNOTRUNNING 0x8004020E : S7-PLCSIM n'est pas en cours d'exécution. PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

11

ExecuteNScans STDMETHOD(CS7ProSim::ExecuteNScans)( long NScanNumber)

Description Force S7-PLCSIM à exécuter un nombre défini de cycles sans attendre que l'exécution du cycle en cours s'achève. Si la notification de cycle est activée, le programme sera averti lorsque S7-PLCSIM aura terminé les cycles. S7-PLCSIM doit être en mode Cycle unique pour que vous puissiez utiliser cette méthode.

Paramètres

NScanNumber Nombre de cycles à exécuter

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTSINGLESCAN 0x8004020A : S7-PLCSIM n'est pas en mode d'exécution "cycle unique". PS_E_PLCNOTRUNNING 0x8004020E : S7-PLCSIM n'est pas en cours d'exécution. PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

12

ExecuteSingleScan STDMETHOD(CS7ProSim::ExecuteSingleScan)()

Description Force S7-PLCSIM à exécuter un cycle sans attendre que l'exécution du cycle en cours s'achève. Si la notification de cycle est activée, le programme sera averti lorsque S7-PLCSIM aura terminé le cycle. S7-PLCSIM doit être en mode Cycle unique pour que vous puissiez utiliser cette méthode.

Paramètres Néant

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_PLCNOTRUNNING 0x8004020E : S7-PLCSIM n'est pas en cours d'exécution.

PS_E_NOTSINGLESCAN 0x8004020A : S7-PLCSIM n'est pas en mode d'exécution "cycle unique".

PS_E_MODENOTPOSSIBLE 0x8004020C : S7-PLCSIM n'a pas pu établir le mode d'exécution de cycle indiqué.

Utilisation Visual Basic

Méthodes

13

GetPauseState STDMETHOD(CS7ProSim::GetPauseState)( PauseStateConstants *pVal)

Description Renvoie l'état Pause en cours de S7-PLCSIM.

Paramètres

pVal Pointeur désignant l'état S7-PLCSIM renvoyé, qui est l'une des constantes PauseStateConstants

Remarques En cas d'appel depuis Visual Basic, l'état Pause est renvoyé dans le code retour de la fonction et il n'y a pas de paramètre pVal.

En cas d'appel depuis C++, l'état est renvoyé dans la valeur désignée par pVal.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

14

GetScanMode STDMETHOD(CS7ProSim::GetScanMode)( ScanModeConstants *pVal)

Description Renvoie le mode d'exécution de S7-PLCSIM.

Paramètres

pVal Pointeur désignant le mode d'exécution renvoyé. Le mode d'exécution renvoyé est l'une des constantes ScanModeConstants

Remarques En cas d'appel depuis Visual Basic, le mode d'exécution est renvoyé dans le code retour de la fonction et il n'y a pas de paramètre pVal.

En cas d'appel depuis C++, l'état est renvoyé dans la valeur désignée par pVal.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

15

GetStartUpSwitch STDMETHOD(CS7ProSim::GetStartUpSwitch)( RestartSwitchPosition *pPos)

Description Fournit le paramétrage de mise en route (redémarrage, démarrage à chaud ou démarrage à froid) pour S7-PLCSIM.

Paramètres

pPos Pointeur désignant la valeur de position du commutateur de mise en route de S7-PLCSIM, qui est l'un des paramétrages RestartSwitchPosition

Remarques En cas d'appel depuis Visual Basic, la position du commutateur est renvoyée dans le code retour de la fonction et il n'y a pas de paramètre pPos.

En cas d'appel depuis C++, la position est renvoyée dans la valeur désignée par pPos.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

16

GetState STDMETHOD(CS7ProSim::GetState)( BSTR *pVal)

Description Renvoie une chaîne contenant la position en cours du commutateur à clé de S7-PLCSIM (position RUN, RUN-P ou STOP).

Paramètres

pVal Pointeur désignant la valeur renvoyée de la position du commutateur à clé de S7-PLCSIM.

Remarques En cas d'appel depuis Visual Basic, l'état est renvoyé dans le code retour de la fonction et il n'y a pas de paramètre pVal.

En cas d'appel depuis C++, l'état est renvoyé dans la valeur désignée par pVal.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée E_INVALID_STATE 0x00008002 : Etat incorrect PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

17

HotStartWithSavedValues STDMETHOD(CS7ProSim::HotStartWithSavedValues)( BOOL val)

Description Définit une valeur booléenne déterminant si S7-PLCSIM doit charger la périphérie d'E/S sauvegardée lors d'une mise en route à l'état de redémarrage HotStart.

Pour que S7-PLCSIM démarre et charge la périphérie d'E/S, l'utilisateur doit appeler HotStartWithSavedValues avec la valeur TRUE, enregistrer le programme AP (SavePLC) et définir l'état de mise en route pour S7-PLCSIM à redémarrage HotStart (SetStartUpSwitch). Lors de son redémarrage, S7-PLCSIM chargera la périphérie d'E/S.

Paramètres

val La valeur TRUE signifie que S7-PLCSIM doit charger la périphérie d'E/S sauvegardée lors d'un redémarrage. La valeur FALSE signifie qu'il ne doit pas charger ces valeurs.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

18

Pause STDMETHOD(CS7ProSim::Pause)()

Description Suspend une simulation.

Paramètres Néant

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

19

ReadDataBlockValue STDMETHOD(CS7ProSim::ReadDataBlockValue)( long BlockNumber, long ByteIndex, long BitIndex, PointDataTypeConstants DataType, VARIANT* pData)

Description Lit un bit, un octet, un mot ou un double mot particulier dans la zone de mémoire DB de S7-PLCSIM.

Paramètres

BlockNumber Numéro de bloc de données à lire. Les valeurs correctes pour BlockNumber dépendent de la CPU.

ByteIndex Position d'octet de début dans le bloc de données à lire. Les valeurs correctes pour ByteIndex dépendent de la CPU.

BitIndex Position de bit de début dans le bloc de données à lire en cas de lecture d'une valeur booléenne (binaire). Les valeurs correctes pour BitIndex vont de 0 à 7.

DataType Type de données à lire. DataType doit avoir l'une des valeurs PointDataTypeConstants.

pData Pointeur désignant l'emplacement pour la valeur renvoyée. Vous devez affecter et libérer cette zone de mémoire dans votre application.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension. PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_READFAILED 0x80040203 : Echec de l'opération de lecture

Utilisation Visual Basic

Méthodes

20

ReadFlagValue STDMETHOD(CS7ProSim::ReadFlagValue)( long ByteIndex, long BitIndex, PointDataTypeConstants DataType, VARIANT* pData)

Description Lit un bit, un octet, un mot ou un double mot particulier dans la zone des mémentos (M) de S7-PLCSIM.

Paramètres

ByteIndex Représente la position d'octet de début à lire en mémoire M. Les valeurs correctes pour ByteIndex dépendent de la CPU.

BitIndex Représente la position de bit de début à lire dans l'octet de mémoire M, en cas de lecture d'une valeur (binaire) booléenne. Les valeurs correctes pour BitIndex vont de 0 à 7.

DataType Représente le type de données à lire. DataType doit avoir l'une des valeurs PointDataTypeConstants.

pData Pointeur désignant l'emplacement pour la valeur renvoyée. Vous devez affecter et libérer cette zone de mémoire dans votre application.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension. PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_READFAILED 0x80040203 : Echec de l'opération de lecture

Utilisation Visual Basic

Méthodes

21

ReadOutputImage STDMETHOD(CS7ProSim::ReadOutputImage)( long StartIndex, long ElementsToRead, ImageDataTypeConstants DataType, VARIANT* pData)

Description Lit des éléments dans la périphérie de sortie (zone de mémoire PA) de S7-PLCSIM.

Paramètres

StartIndex Représente la position d'octet de début à lire dans la périphérie de sortie. Les valeurs correctes pour StartIndex dépendent de la CPU.

ElementsToRead Représente le nombre d'octets, de mots ou de doubles mots à lire dans la périphérie de sortie. Les valeurs correctes pour ElementsToRead dépendent de la CPU.

DataType Représente le type de données à lire. La valeur DataType doit avoir l'une des valeurs ImageDataTypeConstants.

pData Pointeur désignant l'emplacement pour les éléments renvoyés. Les valeurs correctes pour data dépendent de ElementsToRead. Vous devez affecter et libérer cette zone de mémoire dans votre application.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_READFAILED 0x80040203 : Echec de l'opération de lecture PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_NOTALLREADSWORKED 0x8004020F : Toutes les opérations de lecture n'ont pas abouti. PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

Utilisation Visual Basic

Méthodes

22

ReadOutputPoint STDMETHOD(CS7ProSim::ReadOutputPoint)( long ByteIndex, long BitIndex, PointDataTypeConstants DataType, VARIANT* pData)

Description Lit un bit (Boolean), un octet (Byte), un mot (Integer) ou un double mot (Long) spécifique de la périphérie de sortie (zone PA).

Paramètres

ByteIndex Représente la position d'octet de début à lire dans la périphérie. Les valeurs correctes pour ByteIndex dépendent de la CPU.

BitIndex Représente la position de bit (en octets) à lire dans la périphérie. Les valeurs autorisées sont comprises entre 0 et 7.

DataType L'une des constantes PointDataTypeConstants

pData Pointeur désignant les données à lire. Les valeurs correctes pour Data dépendent du type de données.

Remarques Si le paramètre DataType est S7_Bit, alors ByteIndex et BitIndex doivent tous deux être définis à des indices corrects. En cas de succès, la méthode renvoie le bit donné dans pData et son type de données Variant est BOOL.

Si le paramètre DataType est S7_Byte, S7_Word ou S7_DoubleWord, alors ByteIndex doit être défini à un indice correct (BitIndex n'est pas pris en compte). En cas de succès, la méthode renvoie la valeur dans pData. Le type de données Variant est Byte, Integer ou Long, selon le paramètre DataType.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_READFAILED 0x80040203 : Echec de l'opération de lecture PS_E_BADBITNDX 0x80040205 : Indice de bit incorrect PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

Utilisation Visual Basic

Méthodes

23

SavePLC STDMETHOD(CS7ProSim::SavePLC)( BSTR FileName)

Description Enregistre les données en cours de l'AP de simulation dans un fichier.

Les données sauvegardées comprennent le programme, la configuration matérielle, la position du commutateur à clé indiquée par la fenêtre CPU, le mode d'exécution (cycle continu ou cycle unique), l'état des E/S, les valeurs des temporisations, les adresses symboliques, ainsi que le paramétrage de l'alimentation (sous tension ou hors tension).

Paramètres

FileName Nom du fichier dans lequel enregistrer les données de l'AP de simulation

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite STG_E_CANTSAVE 0x80030103 : Enregistrement impossible PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

24

SetScanMode STDMETHOD(CS7ProSim::SetScanMode)( ScanModeConstants newVal)

Description Définit le mode d'exécution pour S7-PLCSIM.

Paramètres

newVal Mode d'exécution à définir pour S7-PLCSIM. Le mode d'exécution doit être l'une des constantes ScanModeConstants

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

25

SetStartUpSwitch STDMETHOD(CS7ProSim::SetStartUpSwitch)( RestartSwitchPosition postion)

Description Définit le type de démarrage (redémarrage, démarrage à chaud ou démarrage à froid) à utiliser lors de la mise en route de S7-PLCSIM .

Paramètres

postion Valeur de la position du commutateur de mise en route de S7-PLCSIM à définir

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

26

SetState STDMETHOD(CS7ProSim::SetState)( BSTR newVal)

Description Définit la position en cours du commutateur à clé de S7-PLCSIM (RUN, RUN-P ou STOP).

Paramètres

newVal Valeur de la position du commutateur à clé de S7-PLCSIM à définir

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée E_INVALID_STATE 0x00008002 : Etat incorrect PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

Utilisation Visual Basic

Méthodes

27

StartPLCSim STDMETHOD(CS7ProSim::StartPLCSim)( BSTR plcFile)

Description Lance S7-PLCSIM avec le fichier de simulation AP indiqué (enregistré lors d'un appel précédent à SavePLC).

Paramètres

plcFile Nom du fichier avec lequel lancer S7-PLCSIM

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée

Utilisation Visual Basic

Méthodes

28

WriteDataBlockValue STDMETHOD(CS7ProSim::WriteDataBlockValue)( long BlockNumber, long ByteIndex, long BitIndex, const VARIANT* pData)

Description Ecrit un bit, un octet, un mot ou un double mot particulier dans la zone de mémoire DB de S7-PLCSIM.

Paramètres

BlockNumber Représente le numéro du bloc de données à écrire. Les valeurs correctes pour BlockNumber dépendent de la CPU.

ByteIndex Représente la position d'octet de début dans le bloc de données à écrire. Les valeurs correctes pour ByteIndex dépendent de la CPU.

BitIndex Représente la position de bit de début dans le bloc de données à écrire, en cas d'écriture d'une valeur booléenne (binaire). Les valeurs correctes pour BitIndex vont de 0 à 7.

pData Pointeur désignant l'emplacement contenant les données à écrire. Vous devez affecter et libérer cette zone de mémoire dans votre application.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension. PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_WRITEFAILED 0x80040204 : Echec de l'opération d'écriture

Utilisation Visual Basic

Méthodes

29

WriteFlagValue STDMETHOD(CS7ProSim::WriteFlagValue)( long ByteIndex, long BitIndex, const VARIANT* pData)

Description Ecrit un bit, un octet, un mot ou un double mot particulier dans la zone des mémentos (M) de S7-PLCSIM.

Paramètres

ByteIndex Représente la position d'octet de début dans la mémoire M à écrire. Les valeurs correctes pour ByteIndex dépendent de la CPU.

BitIndex Représente la position de bit de début dans l'octet de mémento à écrire, en cas d'écriture d'une valeur booléenne (binaire). Les valeurs correctes pour BitIndex vont de 0 à 7.

pData Pointeur désignant l'emplacement contenant les données à écrire. Vous devez affecter et libérer cette zone de mémoire dans votre application.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension. PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_WRITEFAILED 0x80040204 : Echec de l'opération d'écriture

Utilisation Visual Basic

Méthodes

30

WriteInputImage STDMETHOD(CS7ProSim::WriteInputImage)( long StartIndex, const VARIANT* pData)

Description Ecrit des éléments dans la périphérie d'entrée (zone de mémoire PE) de S7-PLCSIM, en commençant à la position StartIndex des données désignées par pData.

Paramètres

StartIndex Représente la position d'octet de début à écrire dans la périphérie d'entrée. Les valeurs correctes pour StartIndex dépendent de la CPU.

pData Pointeur désignant les données à écrire pour S7-PLCSIM. Les valeurs correctes pour les données dépendent de la CPU. Vous devez affecter et libérer cette zone de mémoire dans votre application.

Remarques Le type des éléments à écrire est déterminé par le type des éléments de pData. Tous les éléments doivent avoir le même type de données. Un tableau "Array of Byte" écrit des octets, un tableau "Array of Integer" écrit des mots et un tableau "Array of Long" écrit des doubles mots. Les valeurs écrites sont des valeurs brutes que la méthode n'interprète ni ne convertit en aucune façon. Le nombre d'éléments écrits est déterminé par la taille du tableau désigné par pData.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_WRITEFAILED 0x80040204 : Echec de l'opération d'écriture PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_NOTALLWRITESWORKED 0x80040210 : Toutes les opérations d'écriture n'ont pas abouti. PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

Utilisation Visual Basic

Méthodes

31

WriteInputPoint STDMETHOD(CS7ProSim::WriteInputPoint)( long ByteIndex, long BitIndex, const VARIANT* pData)

Description Ecrit un bit (Boolean), un octet (Byte), un mot (Integer) ou un double mot (Long) spécifique du paramètre Data (de type Variant) dans la périphérie d'entrée (zone PE).

Paramètres

ByteIndex Représente la position d'octet de début à écrire dans la périphérie d'entrée. Les valeurs correctes pour ByteIndex dépendent de la CPU.

BitIndex Représente la position de bit (en octets) à écrire dans la périphérie. Les valeurs autorisées sont comprises entre 0 et 7.

pData Pointeur désignant les données à écrire. Les valeurs correctes pour Data dépendent du type de données.

Remarques Si Boolean est indiqué comme type de données, alors ByteIndex et BitIndex doivent tous deux être définis à des indices corrects. En cas de succès, la méthode écrit le bit donné à la position pData.

Si Byte, Integer ou Long sont indiqués comme type de données, alors ByteIndex doit être défini à un indice correct (BitIndex n'est pas pris en compte). En cas de succès, la méthode écrit les éléments dans pData.

Traitement des erreurs Les erreurs sont renvoyées dans l'événement ConnectionError, et non dans l'appel de la fonction.

Codes retour Valeur Signification S_OK 0x00000000 : Réussite E_FAIL 0x80004005 : Erreur non précisée PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_WRITEFAILED 0x80040204 : Echec de l'opération d'écriture PS_E_BADBITNDX 0x80040205 : Indice de bit incorrect PS_E_BADTYPE 0x80040206 : Type de données incorrect PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM. PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

Utilisation Visual Basic

33

Evénements

ConnectionError Généré lorsque la connexion à l'automate Control Engine est impossible ou en cas d'erreur concernant l'appel de toute méthode S7ProSim.

PauseStateChanged Généré lorsqu'un changement d'état Pause/Poursuivre est détecté.

PLCSimStateChanged Généré lorsqu'un nouvel état du commutateur AP est détecté.

ScanFinished Généré lors de l'achèvement d'un cycle unique.

ScanModeChanged Généré lorsqu'un changement de mode d'exécution ScanMode est détecté

Evénements

34

ConnectionError HRESULT ConnectionError(BSTR ControlEngine, long Error)

Description Généré lorsque la connexion à l'automate Control Engine est impossible ou en cas d'erreur concernant l'appel de toute méthode S7ProSim.

Utilisation Visual Basic

Evénements

35

PauseStateChanged HRESULT PauseStateChanged(BSTR NewState)

Description Généré lorsqu'un changement d'état Pause/Poursuivre est détecté.

Utilisation Visual Basic

Evénements

36

PLCSimStateChanged HRESULT PLCSimStateChanged(BSTR NewState)

Description Généré lorsqu'un nouvel état du commutateur AP est détecté.

Utilisation Visual Basic

Evénements

37

ScanFinished HRESULT ScanFinished(VARIANT ScanInfo)

Description Généré lors de l'achèvement d'un cycle unique.

Utilisation Visual Basic

Evénements

38

ScanModeChanged HRESULT ScanModeChanged(BSTR NewState)

Description Généré lorsqu'un changement de mode d'exécution ScanMode est détecté

Utilisation Visual Basic

39

Définitions de types

CPURunMode Constantes pour l'état d'exécution de cycle de la CPU

ImageDataTypeConstants Constantes pour la méthode ReadOutputImage

PauseStateConstants Constantes pour l'état Pause

PointDataTypeConstants Constantes pour la méthode ReadOutputPoint

RestartSwitchPosition Constantes pour la position du commutateur de mise en route sur la face avant

ScanModeConstants Constantes pour le mode d'exécution

tagPauseState Constantes pour l'état Pause

Définitions de types

40

CPURunMode enum CPURunMode { CONTINUOUS_SCAN, SINGLE_SCAN, SINGLE_STEP }

Description Constantes pour l'état d'exécution de cycle de la CPU

Eléments CONTINUOUS_SCAN SINGLE_SCAN SINGLE_STEP

Définitions de types

41

ImageDataTypeConstants

enum { S7Byte = 2, S7Word = 3, S7DoubleWord = 4 }

Description Constantes pour la méthode ReadOutputImage

Eléments S7Byte S7DoubleWord S7Word

Définitions de types

42

PauseStateConstants

enum { Running = 0, Paused = 1, Disabled = 2 }

Description Constantes pour l'état Pause

Eléments Disabled Paused Running

Définitions de types

43

PointDataTypeConstants

enum { S7_Bit = 1, S7_Byte = 2, S7_Word = 3, S7_DoubleWord = 4 }

Description Constantes pour la méthode ReadOutputPoint

Eléments S7_Bit S7_Byte S7_DoubleWord S7_Word

Définitions de types

44

RestartSwitchPosition

enum { WarmStart = 0, HotStart = 1, ColdStart = 2 }

Description Constantes pour la position du commutateur de mise en route sur la face avant

Eléments

ColdStart Remise en route avec l'OB102

HotStart Remise en route avec l'OB101

WarmStart Remise en route avec l'OB100

Définitions de types

45

ScanModeConstants

enum { SingleScan = 0, ContinuousScan = 1 }

Description Constantes pour le mode d'exécution

Eléments ContinuousScan SingleScan

Définitions de types

46

tagPauseState enum tagPauseState { ENABLED_RUNNING, ENABLED_PAUSED, DISABLED }

Description Constantes pour l'état Pause

Eléments DISABLED ENABLED_PAUSED ENABLED_RUNNING

47

Codes d'erreur PS_E_BADBITNDX 0x80040205 : Indice de bit incorrect

PS_E_BADBYTECOUNT 0x80040202 : La taille du tableau de données est incorrecte pour l'indice d'octet de début indiqué.

PS_E_BADBYTENDX 0x80040201 : Indice d'octet incorrect

PS_E_BADTYPE 0x80040206 : Type de données incorrect

PS_E_INVALIDCALLBACK 0x80040207 : Rappel incorrect

PS_E_INVALIDDISPATCH 0x80040208 : Distribution incorrecte

PS_E_INVALIDINPUT 0x80040213 : Entrée incorrecte

PS_E_INVALIDSCANTYPE 0x8004020B : Mode d'exécution incorrect ; doit être l'une des constantes ScanModeConstants

PS_E_MODENOTPOSSIBLE 0x8004020C : S7-PLCSIM n'a pas pu établir le mode d'exécution de cycle indiqué.

PS_E_NOTALLREADSWORKED 0x8004020F : Toutes les opérations de lecture n'ont pas abouti.

PS_E_NOTALLWRITESWORKED0x80040210 : Toutes les opérations d'écriture n'ont pas abouti.

PS_E_NOTCONNECTED 0x80040211 : S7ProSim n'est pas connecté à S7-PLCSIM.

PS_E_NOTIFICATION_EXIST 0x8004020D : S7ProSim est déjà enregistré pour la notification

PS_E_NOTREGISTERED 0x80040209 : S7ProSim n'est pas enregistré pour des rappels de S7-PLCSIM.

PS_E_NOTSINGLESCAN 0x8004020A : S7-PLCSIM n'est pas en mode d'exécution "cycle unique".

PS_E_PLCNOTRUNNING 0x8004020E : S7-PLCSIM n'est pas en cours d'exécution.

PS_E_POWEROFF 0x80040212 : S7-PLCSIM est hors tension.

PS_E_READFAILED 0x80040203 : Echec de l'opération de lecture

PS_E_WRITEFAILED 0x80040204 : Echec de l'opération d'écriture

E_FAIL 0x80004005 : Erreur non précisée

E_INVALID_STATE 0x00008002 : Etat incorrect

S_OK 0x00000000 : Réussite

STG_E_CANTSAVE 0x80030103 : Enregistrement impossible

Index-1

Index B

BeginScanNotify, 5

C Chargement de la périphérie d'E/S au

redémarrage, 17

Chargement d'un fichier .plc enregistré, 27

Codes retour, 47

ColdStart

Paramétrage, 25

ColdStart, 44

Connect, 6

ConnectionError, 34

Constantes définies

CPURunMode, 40

ImageDataTypeConstants, 41

PauseStateConstants, 42

PointDataTypeConstants, 43

RestartSwitchPosition, 44

ScanModeConstants, 45

tagPauseState, 46

Constantes définies, 39

Continue, 7

CPURunMode, 40

D Définitions de types

CPURunMode, 40

ImageDataTypeConstants, 41

PauseStateConstants, 42

PointDataTypeConstants, 43

RestartSwitchPosition, 44

ScanModeConstants, 45

tagPauseState, 46

Définitions de types, 39

Disconnect, 8

E Ecriture

Entrée, 31

Mémento (zone de mémoire M), 29

Périphérie d'entrée, 30

Valeurs de blocs de données (DB), 28

EndScanNotify, 9

Enregistrement du fichier .plc, 23

Etat Pause

Paramétrage, 7, 18

Renvoi, 13

Evénements

ConnectionError, 34

PauseStateChanged, 35

PLCSimStateChanged, 36

ScanFinished, 37

ScanModeChanged, 38

Evénements, 33

ExecuteNmsScan, 10

ExecuteNScans, 11

ExecuteSingleScan, 12

Exécution de cycle continue

GetScanMode, 14

ScanModeConstants, 45

SetScanMode, 24

G Gestionnaires d'événements, 2

GetPauseState, 13

GetScanMode, 14

GetStartUpSwitch, 15

GetState, 16

H HotStart

Paramétrage, 17, 25

HotStart, 44

HotStartWithSavedValues, 17

I ImageDataTypeConstants, 41

Introduction, 1

L Lecture

Mémento (zone de mémoire M), 20

Périphérie de sortie, 21

Index

Index-2

Sortie, 22

Valeurs de blocs de données (DB), 19

M Mémento

Ecriture, 29

Lecture, 20

Méthodes

BeginScanNotify, 5

Connect, 6

Continue, 7

Disconnect, 8

EndScanNotify, 9

ExecuteNmsScan, 10

ExecuteNScans, 11

ExecuteSingleScan, 12

GetPauseState, 13

GetScanMode, 14

GetStartUpSwitch, 15

GetState, 16

HotStartWithSavedValues, 17

Pause, 18

ReadDataBlockValue, 19

ReadFlagValue, 20

ReadOutputImage, 21

ReadOutputPoint, 22

SavePLC, 23

SetScanMode, 24

SetStartUpSwitch, 25

SetState, 26

StartPLCSim, 27

WriteDataBlockValue, 28

WriteFlagValue, 29

WriteInputImage, 30

WriteInputPoint, 31

Méthodes, 3

Méthodes d'exécution de cycle

ExecuteNmsScan, 10

ExecuteNScans, 11

ExecuteSingleScan, 12

Méthodes S7ProSim Pro

ReadDataBlockValue, 19

ReadFlagValue, 20

WriteDataBlockValue, 28

WriteFlagValue, 29

Mode Cycle unique

ExecuteNmsScan, 10

ExecuteNScans, 11

ExecuteSingleScan, 12

GetScanMode, 14

ScanModeConstants, 45

SetScanMode, 24

Mode d'exécution de cycle

Paramétrage, 24

Renvoi, 14

N Notification de cycle, 5, 9

O Objet COM Siemens S7ProSim, ajout au

projet, 1

P Pause, 18

PauseStateChanged, 35

PauseStateConstants, 42

PLCSIM, démarrage, 27

PLCSimStateChanged, 36

PointDataTypeConstants, 43

Position du commutateur à clé

Paramétrage, 26

Renvoi, 16

Position du commutateur de mise en route

Paramétrage, 25

Renvoi, 15

Position du commutateur de mise en route, 44

Présentation, 1

Programmation d'une interface S7ProSim vers S7-PLCSIM, 2

Projet Visual Basic, ajout de S7ProSim, 1

R ReadDataBlockValue, 19

ReadFlagValue, 20

ReadOutputImage, 21

ReadOutputPoint, 22

Index

Index-3

Références de projet, 1

RestartSwitchPosition, 44

S S7-PLCSIM, démarrage, 17, 27

S7ProSim

Ajout à un projet VB, 1

Interface vers S7-PLCSIM, programmation, 2

Présentation, 1

SavePLC, 23

ScanFinished, 37

ScanModeChanged, 38

ScanModeConstants, 45

SetScanMode, 24

SetStartUpSwitch, 25

SetState, 26

StartPLCSim, 27

T tagPauseState, 46

Types énumérés

CPURunMode, 40

ImageDataTypeConstants, 41

PauseStateConstants, 42

PointDataTypeConstants, 43

RestartSwitchPosition, 44

ScanModeConstants, 45

tagPauseState, 46

Types énumérés, 39

V Valeurs de blocs de données (DB)

Ecriture, 28

Lecture, 19

W WarmStart

Paramétrage, 25

WarmStart, 44

WriteDataBlockValue, 28

WriteFlagValue, 29

WriteInputImage, 30

WriteInputPoint, 31

Z Zone M

Ecriture, 29

Lecture, 20

Remarques / suggestions Vos remarques et suggestions nous permettent d'améliorer la qualité générale de notre documentation. C'est pourquoi nous vous serions reconnaissants de compléter et de renvoyer ce formulaire à Siemens.

Répondez aux questions suivantes en attribuant une note comprise entre 1 pour très bien et 5 pour très mauvais.

Le contenu du manuel répond-il à votre attente ?

Les informations requises peuvent-elles facilement être trouvées ?

Le texte est-il compréhensible ?

Le niveau des détails techniques répond-il à votre attente ?

Quelle évaluation attribuez-vous aux figures et tableaux ?

Vos remarques et suggestions :

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

_____________________________________________________

Indiquez votre secteur industriel :

Industrie automobile

Industrie chimique

Industrie électrique

Industrie alimentaire

Contrôle/commande

Construction mécanique

Pétrochimie

Industrie pharmaceutique

Traitement des matières plastiques

Industrie du papier

Industrie textile

Transports

Autres ___________________________

Envoyez votre réponse à :

Siemens Energy & Automation, Inc.

A l'attention de :TECHNICAL COMMUNICATIONS

ONE INTERNET PLAZA

Johnson City TN 37604 Etats-Unis d'Amérique

Précisez les informations suivantes :

Expéditeur

Nom :_______________________________________________________________

Fonction :____________________________________________________________

Entreprise :___________________________________________________________

Rue :________________________________________________________________

Code postal et ville :____________________________________________________

Pays :_______________________________________________________________

Téléphone :___________________________________________________________