SIMATIC

S7ProSim V5.3 incl. SP1 Objeto COM

Manual del usuario

Edicin: 01/2005

Copyright y consignas de seguridad

Este manual contiene las informaciones necesarias para la seguridad personal, as como para la prevencin de daos materiales. Las seales que figuran a continuacin representan distintos grados de peligro:
Peligro Significa que, si no se adoptan las medidas preventivas adecuadas, se producir la muerte, o bien lesiones corporales graves o daos materiales considerables. Precaucin Significa que, si no se adoptan las medidas preventivas adecuadas, puede producirse la muerte, lesiones corporales graves o daos materiales considerables. Cuidado Junto con el smbolo de aviso, significa que, si no se adoptan las medidas preventivas adecuadas, pueden producirse lesiones corporales leves o moderadas. Cuidado Sin el smbolo de aviso, significa que, si no se adoptan las medidas preventivas adecuadas, pueden producirse daos materiales. Nota Sin el smbolo de aviso, significa que, si no se adoptan las medidas preventivas adecuadas, pueden producirse resultados o estados impredecibles.

Personal cualificado
La puesta en funcionamiento y el servicio del equipo slo deben ser llevados a cabo conforme a lo descrito en este manual. Slo est autorizado a intervenir en este equipo el personal cualificado. En el sentido del manual se trata de personas que disponen de los conocimientos tcnicos necesarios para poner en funcionamiento, conectar a tierra y marcar los aparatos, sistemas y circuitos de acuerdo con las normas estndar de seguridad.

Uso conforme
Considere lo siguiente:
Precaucin El equipo y los componentes del sistema slo se podrn utilizar para los casos de aplicacin previstos en el catlogo y en la descripcin tcnica, y slo con los equipos y componentes de proveniencia tercera recomendados y homologados por Siemens. El funcionamiento correcto y seguro del producto presupone un transporte, un almacenamiento, una instalacin y un montaje conforme a las prcticas de la buena ingeniera, as como un manejo y un mantenimiento rigurosos.

Marcas registradas
Siemens y SIMATIC son marcas registradas de SIEMENS AG. STEP 7 y S7son marcas registradas de SIEMENS AG. Microsoft , Windows , Windows 95 , Windows 98 , Windows NT , Windows ME y Windows 2000 son marcas registradas de Microsoft Corporation. ActiveX es una marca registrada de Microsoft Corporation.
Copyright Siemens Energy & Automation, Inc. 2005 Reservados todos los derechos La divulgacin y reproduccin de este documento, as como el uso y la comunicacin de su contenido, no estn autorizados, a no ser que se obtenga el consentimiento expreso para ello. Los infractores quedan obligados a la indemnizacin de los daos. Se reservan todos los derechos, en particular para el caso de concesin de patentes o de modelos de utilidad. Exencin de responsabilidad Hemos probado el contenido de esta publicacin con la concordancia descrita para el hardware y el software. Sin embargo, es posible que se den algunas desviaciones que nos impiden tomar garanta completa de esta concordancia. El contenido de esta publicacin est sometido a revisiones regularmente y en caso necesario se incluyen las correcciones en la siguiente edicin. Agradecemos sugerencias.

Siemens Energy & Automation, PCbA One Internet Plaza Johnson City, TN 37602-4991, USA

Siemens Energy & Automation, Inc. 2005

Sujeto a cambios sin previo aviso.

Prlogo
S7ProSim ofrece un acceso programtico a la interfaz de simulacin de procesos de S7-PLCSIM. S7ProSim permite escribir programas para realizar tareas tales como cambiar la posicin del selector de modo del PLC simulado, ejecutar un solo ciclo del programa de control, leer o escribir valores de/en el PLC y muchas otras funciones ms. Destinatarios El manual est dirigido a ingenieros, programadores y tcnicos de instalacin que dispongan de conocimientos sobre los sistemas de automatizacin S7 y que tengan experiencia en la programacin con Visual Basic (6.0 o .NET), o bien Visual C++ (6.0 o .NET). Objeto del manual Este documento describe las caractersticas y el funcionamiento de S7ProSim V5.3, , incluyendo el Service Pack 1. Manuales complementarios Encontrar ms informacin en la Ayuda en pantalla de STEP 7 y S7-PLCSIM, as como en los manuales indicados a continuacin: Programar con STEP 7. Este manual proporciona informaciones bsicas sobre cmo disear y crear programas de control. Utilice este manual si desea crear un programa de control con el software de automatizacin STEP 7. Software de sistema para SIMATIC S7-300/400 Funciones estndar y funciones de sistema. En este manual se describen las funciones del sistema, los bloques de organizacin y las funciones estndar para desarrollar un programa de control. STEP 7 Introduccin y ejercicios prcticos Getting Started. Este manual explica cmo utilizar el software de automatizacin STEP 7, ofreciendo una panormica de los procedimientos utilizados para configurar un PLC y para desarrollar programas de control. S7-PLCSIM Comprobar el programa de la CPU S7. En este manual se describe la interfaz de usuario y el funcionamiento de S7-PLCSIM, el simulador de PLCs S7.

Para encontrar estos y otros manuales ms, elija los comandos Inicio > Simatic > Documentacin a partir del men Inicio del PC en el que est instalado STEP 7.

Asistencia tcnica
Si tiene preguntas tcnicas, si necesita informacin sobre los cursillos de entrenamiento en relacin con este producto, o bien para efectuar pedidos, dirjase por favor a su representante de Siemens ms prximo.. Norteamrica y Suramrica Telfono: +1 (800) 333-7421 Fax: +1 (423) 262-2200 simatic.hotline@siemens.com Europa y frica Asia y regin del Pacfico

Telfono: +49 (0) 180 5050 222 Telfono: +86 10 64 75 75 75 Fax: +49 (0) 180 5050 223 adsupport@siemens.com Fax: +86 10 64 74 74 74 adsupport.asia@siemens.com

iii

Contenido
Resumen breve de S7ProSim ............................................................................. 1
Agregar un objeto COM S7ProSim al proyecto ............................................................. 1 Utilizar S7ProSim para programar una interfaz con S7-PLCSIM .................................. 2

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

Eventos................................................................................................................ 35
ConnectionError........................................................................................................... 36 PauseStateChanged.................................................................................................... 37 PLCSimStateChanged................................................................................................. 38 ScanFinished ............................................................................................................... 39 ScanModeChanged ..................................................................................................... 40

Definiciones de tipo ........................................................................................... 41

CPURunMode.............................................................................................................. 42 ImageDataTypeConstants ........................................................................................... 43 PauseStateConstants .................................................................................................. 44

PointDataTypeConstants............................................................................................. 45 RestartSwitchPosition.................................................................................................. 46 ScanModeConstants ................................................................................................... 47 tagPauseState ............................................................................................................. 48

Cdigos de error ................................................................................................ 49

vi

Resumen breve de S7ProSim

S7ProSim es un objeto COM que ofrece un acceso programtico a la interfaz de simulacin de procesos de S7-PLCSIM. S7ProSim puede utilizarse en cualquier aplicacin que acepte objetos COM para establecer una conexin con una simulacin de procesos de S7-PLCSIM. Este documento electrnico describe cmo agregar S7ProSim a una aplicacin, as como las funciones, la interfaz y las operaciones de S7ProSim, incluyendo definiciones de objetos de software de los mtodos y eventos.

Agregar un objeto COM S7ProSim al proyecto

Para utilizar un objeto COM S7ProSim en el proyecto es preciso agregar una referencia a dicho objeto. Los pasos necesarios para agregar una referencia a un objeto COM de S7ProSim dependen del entorno de programacin. Por ejemplo, en Microsoft Visual Basic (6.0 o .NET), deber seguir los pasos indicados a continuacin: 1. Elija el comando de men Proyecto > Referencias o Proyecto > Agregar referencia. 2. En el cuadro de dilogo "Referencias", active la casilla de verificacin correspondiente a "Siemens S7ProSim COM Object". (En Visual Basic .NET, est seleccin se efecta en la ficha "COM" del cuadro de dilogo "Referencias"). 3. Haga clic en "Aceptar". Tras haber agregado la referencia al proyecto, puede utilizar el Examinador de objetos para examinar los mtodos y eventos del objeto COM S7ProSim. En el Examinador de objetos, seleccione "S7PROSIMLib" en la lista desplegable de bibliotecas. La clase S7ProSim contiene los mtodos y eventos que pueden utilizarse para programar una interfaz con S7-PLCSIM. En Microsoft Visual Studio C++ V6.0 o en Microsoft Visual C++ .NET, siga los procedimientos necesarios en ese entorno de programacin para agregar un objeto COM.

Resumen breve de S7ProSim

Utilizar S7ProSim para programar una interfaz con S7-PLCSIM

Para utilizar S7ProSim con objeto de programar funciones en el PLC simulado en S7-PLCSIM deber realizar las tareas siguientes: Incorporar el objeto COM S7ProSim de Siemens en el proyecto. Agregar una referencia del proyecto para S7ProSim. Ejemplo: Visual Basic 6.0
Option Explicit Private WithEvents S7ProSim As S7PROSIMLib.S7ProSim ... Private Sub Form_Load() Set S7ProSim1 = New S7PROSIMLIB.S7ProSim ... End Sub

Ejemplo: Visual Basic .NET

Private WithEvents S7ProSim As New S7PROSIMLib.S7ProSim

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

Controladores para los de eventos de S7ProSim. Se necesitan controladores para todos los eventos de S7ProSim. En cada controlador de eventos es posible insertar cualquier cdigo personalizado para la aplicacin. Ejemplo: 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 "Connection Error" End Sub

Resumen breve de S7ProSim

Private Sub S7ProSim1_ScanModeChanged(ByVal NewState As String) DoEvents ... End Sub

Nota La llamada a "DoEvents" no es necesaria en Visual Basic .NET. Agregue botones de comando, cuadros de texto u otros objetos a su aplicacin segn sea necesario para acceder a los diversos mtodos de S7ProSim. Programe el cdigo para cada controlador de botones de comando, a fin de llamar a los mtodos de S7ProSim y ajustar los valores correspondientes para los cuadros de texto deseados.

Mtodos
BeginScanNotify Connect Continue Disconnect EndScanNotify ExecuteNmsScan Registra a S7ProSim para devoluciones de llamadas del PLC. Los eventos ScanFinished y PLCSimStateChanged se enviarn cuando stos ocurran. Conecta S7ProSim con S7-PLCSIM. Contina una simulacin que ha sido detenida. Desconecta S7ProSim de S7-PLCSIM. Elimina S7ProSim del registro para devoluciones de llamadas del PLC. Los eventos ScanFinished y PLCSimStateChanged no se envan. Obliga a S7-PLCSIM a ejecutar ciclos durante un tiempo determinado (Nms), sin esperar a que culmine la ejecucin del ciclo actual. Si se habilita la notificacin, el programa recibir un aviso cuando S7-PLCSIM haya finalizado los ciclos. Obliga a S7-PLCSIM a ejecutar un nmero determinado de ciclos sin esperar a que culmine la ejecucin del ciclo actual. Si se habilita la notificacin, el programa recibir un aviso cuando S7PLCSIM haya finalizado los ciclos. Obliga a S7-PLCSIM a ejecutar un ciclo individual sin esperar a que culmine la ejecucin del ciclo actual. Si se habilita la notificacin, el programa recibir un aviso cuando S7-PLCSIM haya finalizado el ciclo. Devuelve el estado de pausa actual de S7-PLCSIM. Devuelve el modo de ciclo de S7-PLCSIM. Obtiene la configuracin de arranque (rearranque, rearranque completo o arranque en fro) de S7-PLCSIM. Devuelve una cadena que contiene la posicin actual del selector de modo de S7-PLCSIM (RUN, RUN-P o STOP). Activa un valor booleano para determinar si S7-PLCSIM debe cargar datos de E/S de periferia cuando se inicie en el estado HotStart. Para que S7-PLCSIM pueda arrancar y cargar E/S de periferia, el usuario deber llamar a HotStartWithSavedValues con el valor TRUE, guardar el programa del PLC ( SavePLC), y ajustar el estado de arranque de S7-PLCSIM HotStart ( SetStartUpSwitch). S7-PLCSIM cargar las E/S de periferia durante el arranque. Detiene una simulacin. Lee un bit, un byte, una palabra o una palabra doble del rea de memoria DB de S7-PLCSIM. Lee un bit, un byte, una palabra o una palabra doble del rea de memoria de marcas (M) de S7-PLCSIM. Lee elementos de la imagen de salidas de periferia (rea de memoria PQ) de S7-PLCSIM. Lee un bit en particular (Boolean), un byte (Byte), una palabra de 16 bits (Integer) o una palabra de 32 bits (Long) del rea de las salidas perifricas (PQ). Guarda en un archivo los datos actuales del PLC simulado. Los datos que se almacenan incluyen el programa, la configuracin de hardware, la posicin del selector de modo que indica la subventana "CPU", el tipo de ciclo (continuo o individual), el estado de E/S, los valores de los temporizadores, las direcciones simblicas y el estado de la alimentacin ("on" u "off").

ExecuteNScans

ExecuteSingleScan

GetPauseState GetScanMode GetStartUpSwitch GetState HotStartWithSavedValues

Pause ReadDataBlockValue ReadFlagValue ReadOutputImage ReadOutputPoint

SavePLC

Mtodos SetScanMode SetStartUpSwitch SetState StartPLCSim WriteDataBlockValue WriteFlagValue WriteInputImage Ajusta el modo de ciclo de S7-PLCSIM. Ajusta el tipo de arranque (rearranque, rearranque completo o arranque en fro) de S7-PLCSIM. Ajusta la posicin actual del selector de modo de S7-PLCSIM (RUN, RUN-P o STOP). Inicia S7-PLCSIM con el archivo indicado de simulacin del PLC (guardado en una llamada anterior a SavePLC). Escribe un bit, un byte, una palabra o una palabra doble en el rea de memoria DB de S7-PLCSIM. Escribe un bit, un byte, una palabra o una palabra doble en el rea de memoria de marcas (M) de S7-PLCSIM. Escribe elementos en la imagen de entradas de periferia (rea de memoria PI) de S7-PLCSIM, comenzando en el StartIndex de los datos a los que seala pData. Escribe un bit en particular (Boolean), un byte (Byte), una palabra de 16 bits (Integer) o una palabra de 32 bits (Long) del Data Variant en el rea de las entradas de periferia (PI).

WriteInputPoint

Mtodos

BeginScanNotify
STDMETHOD(CS7ProSim::BeginScanNotify)()

Descripcin
Registra a S7ProSim para devoluciones de llamadas del PLC. Los eventos ScanFinished y PLCSimStateChanged se enviarn cuando stos ocurran.

Parmetros
Ninguno

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTCONNECTED PS_E_POWEROFF Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040211 : S7ProSim no est conectado a S7-PLCSIM 0x80040212 : S7-PLCSIM est desconectado

Uso en Visual Basic

Mtodos

Connect
STDMETHOD(CS7ProSim::Connect)()

Descripcin
Conecta S7ProSim con S7-PLCSIM.

Parmetros
Ninguno

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTCONNECTED PS_E_POWEROFF Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040211 : S7ProSim no est conectado a S7-PLCSIM 0x80040212 : S7-PLCSIM est desconectado

Uso en Visual Basic

Mtodos

Continue
STDMETHOD(CS7ProSim::Continue)()

Descripcin
Contina una simulacin que ha sido detenida.

Parmetros
Ninguno

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

Mtodos

Disconnect
STDMETHOD(CS7ProSim::Disconnect)()

Descripcin
Desconecta S7ProSim de S7-PLCSIM.

Parmetros
Ninguno

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_POWEROFF Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040212 : S7-PLCSIM est desconectado

Uso en Visual Basic

10

Mtodos

EndScanNotify
STDMETHOD(CS7ProSim::EndScanNotify)()

Descripcin
Elimina S7ProSim del registro para devoluciones de llamadas del PLC. Los eventos ScanFinished y PLCSimStateChanged no se envan.

Parmetros
Ninguno

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTCONNECTED PS_E_POWEROFF Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040211 : S7ProSim no est conectado a S7-PLCSIM 0x80040212 : S7-PLCSIM est desconectado 0x80040209 : S7ProSim no est registrado para devoluciones de PS_E_NOTREGISTERED llamadas de S7-PLCSIM

Uso en Visual Basic

11

Mtodos

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

Descripcin
Obliga a S7-PLCSIM a ejecutar ciclos durante un tiempo determinado (Nms), sin esperar a que culmine la ejecucin del ciclo actual. Si se habilita la notificacin, el programa recibir un aviso cuando S7-PLCSIM haya finalizado los ciclos. Para poder utilizar este mtodo, S7-PLCSIM deber estar en modo de ciclo individual.

Parmetros
MsNumber Tiempo (en milisegundos) durante el que deben ejecutarse los ciclos del programa.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTSINGLESCAN PS_E_PLCNOTRUNNING PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x8004020A : S7-PLCSIM no est en modo de ciclo individual 0x8004020E : S7-PLCSIM no se est ejecutando 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

12

Mtodos

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

Descripcin
Obliga a S7-PLCSIM a ejecutar un nmero determinado de ciclos sin esperar a que culmine la ejecucin del ciclo actual. Si se habilita la notificacin, el programa recibir un aviso cuando S7PLCSIM haya finalizado los ciclos. Para poder utilizar este mtodo, S7-PLCSIM deber estar en modo de ciclo individual.

Parmetros
NScanNumber Nmero de ciclos a ejecutar

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTSINGLESCAN PS_E_PLCNOTRUNNING PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x8004020A : S7-PLCSIM no est en modo de ciclo individual 0x8004020E : S7-PLCSIM no se est ejecutando 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

13

Mtodos

ExecuteSingleScan
STDMETHOD(CS7ProSim::ExecuteSingleScan)()

Descripcin
Obliga a S7-PLCSIM a ejecutar un ciclo individual sin esperar a que culmine la ejecucin del ciclo actual. Si se habilita la notificacin, el programa recibir un aviso cuando S7-PLCSIM haya finalizado el ciclo. Para poder utilizar este mtodo, S7-PLCSIM deber estar en modo de ciclo individual.

Parmetros
Ninguno

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_PLCNOTRUNNING PS_E_NOTSINGLESCAN Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x8004020E : S7-PLCSIM no se est ejecutando 0x8004020A : S7-PLCSIM no est en modo de ciclo individual 0x8004020C : S7-PLCSIM no ha podido activar el modo de ciclo PS_E_MODENOTPOSSIBLE indicado

Uso en Visual Basic

14

Mtodos

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

Descripcin
Devuelve el estado de pausa actual de S7-PLCSIM.

Parmetros
pVal Puntero al estado devuelto de S7-PLCSIM que es una de las PauseStateConstants

Notas
Si se llama desde Visual Basic, el estado de pausa se devuelve en el valor de retorno de la funcin y no hay pVal parameter. Si se llama desde C++, el estado se devuelve en el valor de retorno al que seala pVal.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

15

Mtodos

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

Descripcin
Devuelve el modo de ciclo de S7-PLCSIM.

Parmetros
pVal Puntero al modo de ciclo devuelto. El modo de ciclo devuelto es una de las ScanModeConstants

Notas
Si se llama desde Visual Basic, el modo de ciclo se devuelve en el valor de retorno de la funcin y no hay pVal parameter. Si se llama desde C++, el estado se devuelve en el valor de retorno al que seala pVal.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

16

Mtodos

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

Descripcin
Obtiene la configuracin de arranque (rearranque, rearranque completo o arranque en fro) de S7PLCSIM.

Parmetros
pPos Puntero al valor de posicin de arranque de S7-PLCSIM que es una de las RestartSwitchPosition

Notas
Si se llama desde Visual Basic, la posicin del interruptor de arranque se devuelve en el valor de retorno de la funcin y no hay pPos. Si se llama desde C++, el estado se devuelve en el valor de retorno al que seala pPos.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

17

Mtodos

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

Descripcin
Devuelve una cadena que contiene la posicin actual del selector de modo de S7-PLCSIM (RUN, RUN-P o STOP).

Parmetros
pVal Puntero al valor devuelto de la posicin del selector de modo de S7-PLCSIM.

Notas
Si se llama desde Visual Basic, el estado se devuelve en el valor de retorno de la funcin y no hay pVal parameter. Si se llama desde C++, el estado se devuelve en el valor de retorno al que seala pVal.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL E_INVALID_STATE PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x00008002 : Estado no vlido 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

18

Mtodos

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

Descripcin
Activa un valor booleano para determinar si S7-PLCSIM debe cargar datos de E/S de periferia cuando se inicie en el estado HotStart. Para que S7-PLCSIM pueda arrancar y cargar E/S de periferia, el usuario deber llamar a HotStartWithSavedValues con el valor TRUE, guardar el programa del PLC (SavePLC) y ajustar el estado de arranque de S7-PLCSIM HotStart (SetStartUpSwitch). S7-PLCSIM cargar las E/S de periferia durante el arranque.

Parmetros
val El valor TRUE indica que S7-PLCSIM debe cargar datos de las E/S de periferia durante el rearranque. El valor FALSE indica que no debe hacerlo.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

19

Mtodos

Pause
STDMETHOD(CS7ProSim::Pause)()

Descripcin
Detiene una simulacin.

Parmetros
Ninguno

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

20

Mtodos

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

Descripcin
Lee un bit, un byte, una palabra o una palabra doble del rea de memoria DB de S7-PLCSIM.

Parmetros
BlockNumber Nmero del bloque de datos a leer. Los valores vlidos de BlockNumber dependen de la CPU. Posicin del byte inicial en el bloque de datos a leer. Los valores vlidos de ByteIndex dependen de la CPU. Posicin del bit inicial en el bloque de datos a leer (si se lee un valor (de bit) booleano). Los valores vlidos de BitIndex estn comprendidos entre 0 y 7. Tipo de datos a leer. DataType debe ser una de las PointDataTypeConstants. Puntero al espacio del valor devuelto. Es preciso asignar y liberar esta rea de memoria en la aplicacin de usuario.

ByteIndex

BitIndex

DataType

pData

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTCONNECTED PS_E_POWEROFF PS_E_BADTYPE PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040211 : S7ProSim no est conectado a S7-PLCSIM 0x80040212 : S7-PLCSIM est desconectado 0x80040206 : Tipo de datos no vlido 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el ndice del PS_E_BADBYTECOUNT byte inicial indicado PS_E_READFAILED 0x80040203 : Ha fallado la operacin de lectura

Uso en Visual Basic

21

Mtodos

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

Descripcin
Lee un bit, un byte, una palabra o una palabra doble del rea de memoria de marcas (M) de S7PLCSIM.

Parmetros
ByteIndex Representa la posicin del byte inicial en la memoria M a leer. Los valores vlidos de ByteIndex dependen de la CPU. Representa la posicin del byte inicial en la memoria M a leer (si se lee un valor (de bit) booleano). Los valores vlidos de BitIndex estn comprendidos entre 0 y 7. Representa el tipo de datos a leer. DataType debe ser una de las PointDataTypeConstants. Puntero al espacio del valor devuelto. Es preciso asignar y liberar esta rea de memoria en la aplicacin de usuario.

BitIndex

DataType

pData

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTCONNECTED PS_E_POWEROFF PS_E_BADTYPE PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040211 : S7ProSim no est conectado a S7-PLCSIM 0x80040212 : S7-PLCSIM est desconectado 0x80040206 : Tipo de datos no vlido 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el ndice del PS_E_BADBYTECOUNT byte inicial indicado PS_E_READFAILED 0x80040203 : Ha fallado la operacin de lectura

Uso en Visual Basic

22

Mtodos

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

Descripcin
Lee elementos de la imagen de salidas de periferia (rea de memoria PQ) de S7-PLCSIM.

Parmetros
StartIndex Representa la posicin del byte inicial en el bfer de imagen de las salidas de periferia a leer. Los valores vlidos de StartIndex dependen de la CPU. Representa el nmero de bytes, palabras o palabras dobles a leer del bfer de imagen. Los valores vlidos de ElementsToRead dependen de la CPU. Representa el tipo de datos a leer. El valor de DataType debe ser una de las ImageDataTypeConstants. Puntero al espacio de los elementos devueltos. Los valores vlidos de los datos dependen de ElementsToRead. Es preciso asignar y liberar esta rea de memoria en la aplicacin de usuario.

ElementsToRead

DataType

pData

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el PS_E_BADBYTECOUNT ndice del byte inicial indicado PS_E_READFAILED 0x80040203 : Ha fallado la operacin de lectura PS_E_BADTYPE 0x80040206 : Tipo de datos no vlido PS_E_NOTALLREADSWORKED 0x8004020F : Han fallado todas las operaciones de lectura PS_E_NOTCONNECTED 0x80040211 : S7ProSim no est conectado a S7-PLCSIM PS_E_POWEROFF 0x80040212 : S7-PLCSIM est desconectado

Uso en Visual Basic

23

Mtodos

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

Descripcin
Lee un bit en particular (Boolean), un byte (Byte), una palabra de 16 bits (Integer) o una palabra de 32 bits (Long) del rea de las salidas perifricas (PQ).

Parmetros
ByteIndex Representa la posicin del byte inicial en el bfer de imagen de la periferia a leer. Los valores vlidos de ByteIndex dependen de la CPU. Representa la posicin del bit (en bytes) en el bfer de imagen de la periferia a leer. Los valores vlidos estn comprendidos entre 0 y 7. Una de las PointDataTypeConstants Puntero a los datos a leer. Los valores vlidos de Data dependen del tipo de datos.

BitIndex

DataType pData

Notas
Si el parmetro DataType es un S7_Bit, ByteIndex y BitIndex debern tener ndices vlidos. Si se ejecuta correctamente, el mtodo devolver el bit indicado en pData y su tipo de datos Variant ser booleano. Si el parmetro DataType es S7_Byte, S7_Word o S7_DoubleWord, ByteIndex deber tener un ndice vlido (BitIndex se ignorar). Si se ejecuta correctamente, el mtodo devolver el valor en pData. El tipo de datos de Variant es Byte, Integer, o Long, dependiendo de DataType.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el ndice del PS_E_BADBYTECOUNT byte inicial indicado PS_E_READFAILED 0x80040203 : Ha fallado la operacin de lectura PS_E_BADBITNDX 0x80040205 : ndice de bit no vlido PS_E_BADTYPE 0x80040206 : Tipo de datos no vlido PS_E_NOTCONNECTED 0x80040211 : S7ProSim no est conectado a S7-PLCSIM PS_E_POWEROFF 0x80040212 : S7-PLCSIM est desconectado

Uso en Visual Basic

24

Mtodos

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

Descripcin
Guarda en un archivo los datos actuales del PLC simulado. Los datos que se almacenan incluyen el programa, la configuracin de hardware, la posicin del selector de modo que indica la subventana "CPU", el tipo de ciclo (continuo o individual), el estado de E/S, los valores de los temporizadores, las direcciones simblicas y el estado de la alimentacin ("on" u "off").

Parmetros
FileName Nombre del archivo en el que deben guardarse los datos del PLC simulado

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK STG_E_CANTSAVE PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80030103 : Imposible guardar 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

25

Mtodos

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

Descripcin
Ajusta el modo de ciclo de S7-PLCSIM.

Parmetros
newVal Modo de ciclo a ajustar en S7-PLCSIM. El modo de ciclo debe ser una de las ScanModeConstants

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

26

Mtodos

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

Descripcin
Ajusta el tipo de arranque (rearranque, rearranque completo o arranque en fro) de S7-PLCSIM.

Parmetros
postion Valor de la posicin de arranque de S7-PLCSIM a ajustar

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

27

Mtodos

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

Descripcin
Ajusta la posicin actual del selector de modo de S7-PLCSIM (RUN, RUN-P o STOP).

Parmetros
newVal Valor de la posicin del selector de modo de S7-PLCSIM a ajustar

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL E_INVALID_STATE PS_E_NOTCONNECTED Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x00008002 : Estado no vlido 0x80040211 : S7ProSim no est conectado a S7-PLCSIM

Uso en Visual Basic

28

Mtodos

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

Descripcin
Inicia S7-PLCSIM con el archivo indicado de simulacin del PLC (guardado en una llamada anterior a SavePLC).

Parmetros
plcFile Nombre del archivo con el que debe iniciarse S7-PLCSIM

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado

Uso en Visual Basic

29

Mtodos

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

Descripcin
Escribe un bit, un byte, una palabra o una palabra doble en el rea de memoria DB de S7-PLCSIM.

Parmetros
BlockNumber Representa el nmero del bloque de datos a escribir. Los valores vlidos de BlockNumber dependen de la CPU. Representa la posicin del byte inicial en el bloque de datos a escribir. Los valores vlidos de ByteIndex dependen de la CPU. Representa la posicin del bit inicial en el bloque de datos a escribir (si se escribe un valor (de bit) booleano). Los valores vlidos de BitIndex estn comprendidos entre 0 y 7. Puntero al espacio que contiene los datos a escribir. Es preciso asignar y liberar esta rea de memoria en la aplicacin de usuario.

ByteIndex

BitIndex

pData

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTCONNECTED PS_E_POWEROFF PS_E_BADTYPE PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040211 : S7ProSim no est conectado a S7-PLCSIM 0x80040212 : S7-PLCSIM est desconectado 0x80040206 : Tipo de datos no vlido 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el ndice del PS_E_BADBYTECOUNT byte inicial indicado PS_E_WRITEFAILED 0x80040204 : Ha fallado la operacin de escritura

Uso en Visual Basic

30

Mtodos

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

Descripcin
Escribe un bit, un byte, una palabra o una palabra doble en el rea de memoria de marcas (M) de S7PLCSIM.

Parmetros
ByteIndex Representa la posicin del byte inicial en la memoria M a escribir. Los valores vlidos de ByteIndex dependen de la CPU. Representa la posicin del bit inicial en el byte de la memoria M a escribir (si se escribe un valor (de bit) booleano). Los valores vlidos de BitIndex estn comprendidos entre 0 y 7. Puntero al espacio que contiene los datos a escribir. Es preciso asignar y liberar esta rea de memoria en la aplicacin de usuario.

BitIndex

pData

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_NOTCONNECTED PS_E_POWEROFF PS_E_BADTYPE PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040211 : S7ProSim no est conectado a S7-PLCSIM 0x80040212 : S7-PLCSIM est desconectado 0x80040206 : Tipo de datos no vlido 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el ndice del PS_E_BADBYTECOUNT byte inicial indicado PS_E_WRITEFAILED 0x80040204 : Ha fallado la operacin de escritura

Uso en Visual Basic

31

Mtodos

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

Descripcin
Escribe elementos en la imagen de las entradas de la periferia (rea de memoria PI) de S7-PLCSIM, comenzando en el StartIndex de los datos a los que seala pData.

Parmetros
StartIndex Representa la posicin del byte inicial en el bfer de imagen de las entradas de periferia a escribir. Los valores vlidos de StartIndex dependen de la CPU. Puntero a los datos de S7-PLCSIM a escribir. Los valores vlidos de data dependen de la CPU. Es preciso asignar y liberar esta rea de memoria en la aplicacin de usuario.

pData

Notas
El tipo de elementos a escribir es determinado por el tipo de elementos de Data. Todos los elementos deben pertenecer a un mismo tipo de datos. Un array Byte escribe bytes, un array Integer escribe palabras y un array Long escribe palabras dobles. Los valores escritos sern datos no procesados, por lo que el mtodo no los interpretar ni los convertir de manera alguna. El nmero de elementos escritos depende del tamao del array al que seala Data.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el PS_E_BADBYTECOUNT ndice del byte inicial indicado PS_E_WRITEFAILED 0x80040204 : Ha fallado la operacin de escritura PS_E_BADTYPE 0x80040206 : Tipo de datos no vlido PS_E_NOTALLWRITESWORKED 0x80040210 : Han fallado todas las operaciones de escritura PS_E_NOTCONNECTED 0x80040211 : S7ProSim no est conectado a S7-PLCSIM PS_E_POWEROFF 0x80040212 : S7-PLCSIM est desconectado

Uso en Visual Basic

32

Mtodos

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

Descripcin
Escribe un bit en particular (Boolean), un byte (Byte), una palabra de 16 bits (Integer) o una palabra de 32 bits (Long) del Data Variant en el rea de las entradas de periferia (PI).

Parmetros
ByteIndex Representa la posicin del byte inicial en el bfer de imagen de las entradas de periferia a escribir. Los valores vlidos de ByteIndex dependen de la CPU. Representa la posicin del bit (en bytes) en el bfer de imagen de la periferia a escribir. Los valores vlidos estn comprendidos entre 0 y 7. Puntero a los datos a escribir. Los valores vlidos de Data dependen del tipo de datos.

BitIndex

pData

Notas
Si el tipo de datos es booleano, ByteIndex y BitIndex debern tener ndices vlidos. Si se ejecuta correctamente, el mtodo escribir el bit indicado en pData. Si el tipo de datos indicado es Byte, Integer o Long, ByteIndex deber tener un ndice vlido (BitIndex se ignorar). Si se ejecuta correctamente, el mtodo escribir los elementos en pData.

Tratamiento de errores
Los errores se devuelven en el evento ConnectionError y no en la llamada a la funcin.

Valor de retorno
Valor S_OK E_FAIL PS_E_BADBYTENDX Significado 0x00000000 : Cdigo de xito 0x80004005 : Error no especificado 0x80040201 : ndice de byte no vlido 0x80040202 : El tamao del array de datos no es vlido para el ndice del PS_E_BADBYTECOUNT byte inicial indicado PS_E_WRITEFAILED 0x80040204 : Ha fallado la operacin de escritura PS_E_BADBITNDX 0x80040205 : ndice de bit no vlido PS_E_BADTYPE 0x80040206 : Tipo de datos no vlido PS_E_NOTCONNECTED 0x80040211 : S7ProSim no est conectado a S7-PLCSIM PS_E_POWEROFF 0x80040212 : S7-PLCSIM est desconectado

Uso en Visual Basic

33

Eventos
Se genera si no es posible establecer una conexin con el control engine o cuando ocurre un error al llamar a un mtodo de S7ProSim. Se genera al detectarse un cambio de estado de Pause/Continue.

ConnectionError

PauseStateChanged

Se genera al detectarse un nuevo estado del selector de modos de PLCSimStateChanged operacin del PLC. Se genera cuando se ejecuta un ciclo individual. ScanFinished Se genera cuando se detecta un cambio de ScanMode. ScanModeChanged

35

Eventos

ConnectionError
HRESULT ConnectionError(BSTR ControlEngine, long Error)

Descripcin
Se genera si no es posible establecer una conexin con el control engine o cuando ocurre un error al llamar a un mtodo de S7ProSim.

Uso en Visual Basic

36

Eventos

PauseStateChanged
HRESULT PauseStateChanged(BSTR NewState)

Descripcin
Se genera al detectarse un cambio de estado de Pause/Continue.

Uso en Visual Basic

37

Eventos

PLCSimStateChanged
HRESULT PLCSimStateChanged(BSTR NewState)

Descripcin
Se genera al detectarse un nuevo estado del selector de modos de operacin del PLC.

Uso en Visual Basic

38

Eventos

ScanFinished
HRESULT ScanFinished(VARIANT ScanInfo)

Descripcin
Se genera cuando se ejecuta un ciclo individual.

Uso en Visual Basic

39

Eventos

ScanModeChanged
HRESULT ScanModeChanged(BSTR NewState)

Descripcin
Se genera cuando se detecta un cambio de ScanMode.

Uso en Visual Basic

40

Definiciones de tipo
CPURunMode Constantes del estado de ciclo de la CPU en modo RUN

ImageDataTypeConstants Constantes del mtodo ReadOutputImage Constantes del estado de pausa PauseStateConstants PointDataTypeConstants RestartSwitchPosition ScanModeConstants tagPauseState Constantes del mtodo ReadOutputPoint Constantes de la posicin del interruptor de arranque en el panel frontal Constantes del modo de ciclo Constantes del estado de pausa

41

Definiciones de tipo

CPURunMode
enum CPURunMode { CONTINUOUS_SCAN, SINGLE_SCAN, SINGLE_STEP }

Descripcin
Constantes del estado de ciclo de la CPU en modo RUN

Miembros
CONTINUOUS_SCAN SINGLE_SCAN SINGLE_STEP

42

Definiciones de tipo

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

Descripcin
Constantes del mtodo ReadOutputImage

Miembros
S7Byte S7DoubleWord S7Word

43

Definiciones de tipo

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

Descripcin
Constantes del estado de pausa

Miembros
Disabled Paused Running

44

Definiciones de tipo

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

Descripcin
Constantes del mtodo ReadOutputPoint

Miembros
S7_Bit S7_Byte S7_DoubleWord S7_Word

45

Definiciones de tipo

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

Descripcin
Constantes de la posicin del interruptor de arranque en el panel frontal

Miembros
ColdStart HotStart Posicin de rearranque OB102 Posicin de rearranque OB101

WarmStart Posicin de rearranque OB100

46

Definiciones de tipo

ScanModeConstants
enum { SingleScan = 0, ContinuousScan = 1 }

Descripcin
Constantes del modo de ciclo

Miembros
ContinuousScan SingleScan

47

Definiciones de tipo

tagPauseState
enum tagPauseState { ENABLED_RUNNING, ENABLED_PAUSED, DISABLED }

Descripcin
Constantes del estado de pausa

Miembros
DISABLED ENABLED_PAUSED ENABLED_RUNNING

48

Cdigos de error
PS_E_BADBITNDX PS_E_BADBYTECOUNT PS_E_BADBYTENDX PS_E_BADTYPE PS_E_INVALIDCALLBACK PS_E_INVALIDDISPATCH PS_E_INVALIDINPUT PS_E_INVALIDSCANTYPE 0x80040205 : ndice de bit no vlido 0x80040202 : El tamao del array de datos no es vlido para el ndice del byte inicial indicado 0x80040201 : ndice de byte no vlido 0x80040206 : Tipo de datos no vlido 0x80040207 : Devolucin de llamada no vlida 0x80040208 : Distribucin no vlida 0x80040213 : Introduccin no vlida

0x8004020B : Tipo de de ciclo no vlido, debe ser una de las ScanModeConstants 0x8004020C : S7-PLCSIM no ha podido activar el modo PS_E_MODENOTPOSSIBLE de ciclo indicado 0x8004020F : Han fallado todas las operaciones de PS_E_NOTALLREADSWORKED lectura 0x80040210 : Han fallado todas las operaciones de PS_E_NOTALLWRITESWORKED escritura 0x80040211 : S7ProSim no est conectado a S7PS_E_NOTCONNECTED PLCSIM 0x8004020D : S7ProSim ya est registrado para la PS_E_NOTIFICATION_EXIST notificacin 0x80040209 : S7ProSim no est registrado para PS_E_NOTREGISTERED devoluciones de llamadas de S7-PLCSIM 0x8004020A : S7-PLCSIM no est en modo de ciclo PS_E_NOTSINGLESCAN individual PS_E_PLCNOTRUNNING PS_E_POWEROFF PS_E_READFAILED PS_E_WRITEFAILED E_FAIL E_INVALID_STATE S_OK STG_E_CANTSAVE 0x8004020E : S7-PLCSIM is not running 0x80040212 : S7-PLCSIM est desconectado 0x80040203 : Ha fallado la operacin de lectura 0x80040204 : Ha fallado la operacin de escritura 0x80004005 : Error no especificado 0x00008002 : Estado no vlido 0x00000000 : Cdigo de xito 0x80030103 : Imposible guardar

49

ndice-alfabtico
B
BeginScanNotify, 7

E
Ejecutar ciclo continuo GetScanMode, 16 ScanModeConstants, 47 SetScanMode, 26 Ejecutar ciclo individual ExecuteNmsScan, 12 ExecuteNScans, 13 ExecuteSingleScan, 14 GetScanMode, 16 ScanModeConstants, 47 SetScanMode, 26 EndScanNotify, 11 Escribir Entrada, 33 Imagen de las entradas, 32 Valores de marcas (memoria M), 31 Valores del bloque de datos (DB), 30 Estado de pausa Ajustar, 9, 20 Obtener, 15 Eventos ConnectionError, 36 PauseStateChanged, 37 PLCSimStateChanged, 38 ScanFinished, 39 ScanModeChanged, 40 Eventos, 35 ExecuteNmsScan, 12 ExecuteNScans, 13 ExecuteSingleScan, 14

C
Cargar archivo .plc guardado, 29 Cargar E/S de periferia durante el rearranque, 19 Ciclo Ajustar, 26 Obtener, 16 Cdigos de error, 49 ColdStart Ajustar, 27 ColdStart, 46 Connect, 8 ConnectionError, 36 Constantes definidas CPURunMode, 42 ImageDataTypeConstants, 43 PauseStateConstants, 44 PointDataTypeConstants, 45 RestartSwitchPosition, 46 ScanModeConstants, 47 tagPauseState, 48 Constantes definidas, 41 Continue, 9 Controladores de eventos, 2 CPURunMode, 42

D
Definiciones de tipo CPURunMode, 42 ImageDataTypeConstants, 43 PauseStateConstants, 44 PointDataTypeConstants, 45 RestartSwitchPosition, 46 ScanModeConstants, 47 tagPauseState, 48 Definiciones de tipo, 41 Disconnect, 10

G
GetPauseState, 15 GetScanMode, 16 GetStartUpSwitch, 17 GetState, 18 Guardar archivo .plc, 25

ndice alfabtico-1

ndice alfabtico

H
HotStart Ajustar, 19, 27 HotStart, 46 HotStartWithSavedValues, 19

SavePLC, 25 SetScanMode, 26 SetStartUpSwitch, 27 SetState, 28 StartPLCSim, 29 WriteDataBlockValue, 30 WriteFlagValue, 31 WriteInputImage, 32 WriteInputPoint, 33 Mtodos, 5 Mtodos de ejecucin de ciclos ExecuteNmsScan, 12 ExecuteNScans, 13 ExecuteSingleScan, 14 Mtodos de S7ProSim ReadDataBlockValue, 21 ReadFlagValue, 22 WriteDataBlockValue, 30 WriteFlagValue, 31

I
ImageDataTypeConstants, 43 Introduccin, 1

L
Leer Imagen de las salidas, 23 Salida, 24 Valores de marcas (memoria M), 22 Valores del bloque de datos (DB), 21

M
Marcas Escribir, 31 Leer, 22 Memoria de marcas (M) Escribir, 31 Leer, 22 Mtodos BeginScanNotify, 7 Connect, 8 Continue, 9 Disconnect, 10 EndScanNotify, 11 ExecuteNmsScan, 12 ExecuteNScans, 13 ExecuteSingleScan, 14 GetPauseState, 15 GetScanMode, 16 GetStartUpSwitch, 17 GetState, 18 HotStartWithSavedValues, 19 Pause, 20 ReadDataBlockValue, 21 ReadFlagValue, 22 ReadOutputImage, 23 ReadOutputPoint, 24

N
Notificacin de ciclo, 7, 11

O
Objeto COM S7ProSim de Siemens, agregar al proyecto, 1

P
Panormica, 1 Pause, 20 PauseStateConstants, 44 PauseStateChanged, 37 PLCSIM, iniciar, 29 PLCSimStateChanged, 38 PointDataTypeConstants, 45 Posicin del interruptor de arranque Ajustar, 27 Obtener, 17 Posicin del interruptor de arranque, 46 Posicin del selector de modo Ajustar, 28 Obtener, 18 Programar una interfaz de S7ProSim con S7PLCSIM, 2

ndice alfabtico-2

ndice alfabtico

R
ReadDataBlockValue, 21 ReadFlagValue, 22 ReadOutputImage, 23 ReadOutputPoint, 24 Referencias del proyecto, 1 RestartSwitchPosition, 46

Tipos enumerados CPURunMode, 42 ImageDataTypeConstants, 43 PauseStateConstants, 44 PointDataTypeConstants, 45 RestartSwitchPosition, 46 ScanModeConstants, 47 tagPauseState, 48 Tipos enumerados, 41

S
S7-PLCSIM, iniciar, 19, 29 S7ProSim Agregar a un proyecto VB, 1 Interfaz con S7-PLCSIM, programar, 2 Panormica, 1 SavePLC, 25 ScanFinished, 39 ScanModeConstants, 47 ScanModeChanged, 40 SetScanMode, 26 SetStartUpSwitch, 27 SetState, 28 StartPLCSim, 29

V
Valores de retorno, 49 Valores del bloque de datos (DB) Escribir, 30 Leer, 21 Visual Basic, agregar S7ProSim, 1

W
WarmStart Ajustar, 27 WarmStart, 46 WriteDataBlockValue, 30 WriteFlagValue, 31 WriteInputImage, 32 WriteInputPoint, 33

T
tagPauseState, 48

ndice alfabtico-3

Formulario de respuesta
Sus observaciones y sugerencias nos permiten mejorar la calidad y utilidad de nuestra documentacin. Por ello le rogamos que rellene el presente formulario y lo enve a Siemens. Por favor, responda a las siguientes preguntas adjudicando una puntuacin comprendida entre 1 (muy bien) y 5 (muy mal). Corresponde el contenido del manual a sus exigencias? Resulta fcil localizar las informaciones requeridas? Es comprensible el texto? Corresponde el nivel de los detalles tcnicos a sus exigencias? Qu opina de la calidad de las ilustraciones y tablas?

Comentarios adicionales: _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________ _____________________________________________________

Por favor, indique el ramo de la industria al que pertenece: Industria del automvil Industria qumica Industria elctrica Industria alimentaria Control e instrumentacin Industria mecnica Industria petroqumica Industria farmacutica Industria del plstico Industria papelera Industria textil Transportes Otros ___________________________

Srvase enviar el formulario de respuesta a: Siemens Energy & Automation, Inc. ATTN: Techmical Communications One Internet Plaza Johnson City TN USA 37604

Por favor, incluya las siguientes informaciones: Remitente Nombres y apellidos: ____________________________________________________ Cargo: ________________________________________________________________ Empresa:______________________________________________________________ Calle:_________________________________________________________________ CP y poblacin:_________________________________________________________ Pas: _________________________________________________________________ Telfono:______________________________________________________________