nubitek_email_first-steps_v1.5_es
Contents
1. apn direcci n de punto de acceso a la red GPRS Ejemplo si usa una tarjeta SIM de Vodafone Espa a introduzca airtelnet es user nombre de usuario para la conexi n GPRS Ejemplo si usa una tarjeta SIM de Vodafone Espa a introduzca vodafone passwd contrase a para la conexi n GPRS Ejemplo si usa una tarjeta SIM de Vodafone Espa a introduzca vodafone Importante los par metros de comunicaci n GPRS apn user Y passwd son propios de cada operador de tel fon a m vil Puede consultarlos f cilmente en su servicio de soporte t cnico Nubitek_Key escriba 0 que es la clave para pruebas Si ya tiene una clave definitiva para su m dem sela no necesita la de pruebas Si tiene dudas sobre las claves consulte el Ap ndice 2 de este manual Ready escriba 00 0 as sabr cuando se ha terminado de inicializar el sistema y puede empezar a enviar correos electr nicos Network 1 Email Manager 540 0 Email Manager Rea alrtelnet es Ready F 00 0 vodafone vodafone o Imagen 6 1 Llamada a la funci n Email_Manager Asigne memoria a la librer a como se indica en el cap tulo 5 Para este ejemplo puede usar el rango que aparecer por defecto de vBO a VB1000 Hasta aqu la configuraci n base el control general est listo para gestionar el env o de correos electr nicos Cualquier aplicaci n requiere que se realicen estos 3 pasos previos nu DI te K Pr2. 9 Nubitek Email v1 5 Send email Extra Settings write email f Email Manager Send 5M5 Imagen 4 3 Agregar librer a nu b1 te K Primeros pasos Manual de referencia r pida 7 14 email 5 Asignaci n de memoria a la librer a Una vez que empiece a usar las funciones de la librer a en su proyecto y siempre antes de cargarlo o compilarlo se debe asignar a la librer a un rango de memoria su gesti n interna requiere 1001 bytes en memoria V cuya ubicaci n puede definir el usuario Haga clic en Archivo gt Asignar memoria a libreria L STEP 7 Micro WIN Ejemplo_Web KOP SIMATIC Ea Edici n Ver CPU Test Herramientas Ventana Ayuda 4 Nuevo Ctrl N Abrir ctrl 0 p teji Guardar Ctri 5 T 2 1 41 5 5 L Guardar como Definir contrase a Importar Exportar Cargar en PG Cargar en CPU COMENTARIOS DEL Crear librer a A Agregar o quitar libreria Comentario de segme Asignar memoria a libreria Configurar p gina Imagen 5 1 Asignar memoria a librer a En la ventana que se abre seleccione la pesta a Nubitek Email si no tiene otras librerias instaladas ser la nica pestafia existente Pulse el bot n Proponer direcci n y MicroWIN indicar un rango de memoria libre Si por cualquier raz n se prefiere otro rango distinto basta con volver a pulsar sobre Proponer direcci n o escribir directamente la posici n de inicio
3. El proceso consta de dos pasos En el primero se da la orden de env o y se definen asunto y destinatarios En el segundo se genera el texto del email Llame a la funci n send email usando el contacto de llamada smo0 0 Network 2 540 0 Send email 10 0 ww E SUIS To Sendingf 110 1 Write H MOO ev B 21004 Subject Imagen 6 2 Llamada a la funci n Send_email Introduzca los siguientes par metros Send Condici n de envio del email Ponga la condici n de envio por ejemplo 10 0 seguida de un flanco de subida To 8VB2000 Esla direcci n de correo definida en el paso 5 CC no se usa en este ejemplo ponga O nu DI te K Primeros pasos Manual de referencia r pida 10 14 email Subject amp VB2100 Es el asunto del email definido en el paso 6 Sending escriba 00 1 Esta salida estar a uno mientras se procesa y envia el email Se pondr a cero cuando se haya completado con xito el env o Write escriba una marca libre por ejemplo MO 0 La utilizar en el siguiente paso para hacer la llamada a la funci n write email 9 La funci n write email se utiliza para construir secuencialmente el texto del correo electr nico Cada llamada a la funci n write email a ade una nueva cadena de texto al cuerpo del email Importante Debe llamar a la funci n usando el bit write que asign como salida de la funci n Send email en este caso MO 0 Para este ejemplo llame a la funci n 2 veces al modo
4. deseada Importante no deben incluirse variables de usuario en este rango de memoria que usa la librer a Pulse Aceptar Asignar memoria a libreria Nubitek Email v1 5 La librer a de operaciones Hubitek Email v1 5 requiere 1001 byte s de la memoria Y global Indique una direcci n donde la librer a pueda utilizar esta cantidad de memoria W Haga clic en Proponer direcci n para acceder a la lista de referencias cruzadas del programa con objeto de buscar un bloque de memoria de tama o suficiente no utilizado todavia Proponer direcci n VBO hasta VB1000 Aceptar Cancelar Imagen 5 2 Asignar memoria a librer a nu DI te K Primeros pasos Manual de referencia r pida 8 14 email 6 C mo enviar un correo electr nico En este ejemplo se muestra de manera muy r pida y directa c mo enviar un correo electr nico Debe seguir los siguientes pasos 1 3 Disponga los equipos y con ctelos seg n las indicaciones de los cap tulos 2 y 3 de este manual Aseg rese de tener la librer a Nubitek_Email instalada como se indica en el cap tulo 4 En el Bloque de Programa llame a la funci n Email_Manager la encontrar en la carpeta ibrer as en la parte baja del rbol de navegaci n de MicroWIN Como debe ejecutarse todos los ciclos de programa use el contacto de llamada smo o Introduzca los siguientes par metros PIN el PIN de la tarjeta SIM entre comillas dobles Por ejemplo 2244
5. Settings Es una funci n OPCIONAL Se usa Extra Settings si se desea enviar el correo electr nico a trav s de un servidor de correo diferente al de Nubitek Recomendamos especificar un servidor de correo propio y no usar el de Nubitek embebido en el c digo como cortes a para pruebas y puesta en marcha Debe llamarse en cada ciclo de programa es decir usando el contacto SMO 0 a continuaci n de la funci n Email Manager Tiene 4 par metros de entrada mail server Entrada de tipo STRING Cadena de texto con la direcci n del servidor de correo se quiere usar mail user Entrada de tipo STRING Cadena de texto con el nombre de usuario que se debe emplear con el servidor de correo escogido mail passwd Entrada de tipo STRING Cadena de texto con la contrase a que se debe emplear con el servidor de correo escogido From Entrada de tipo STRING Cadena de texto con la direcci n de correo remitente que aparecer al recibir el correo electr nico 3 Send email Se utiliza la funci n Send email una vez para cada correo electr nico diferente que se desee enviar Debe llamarse a la funci n en todos los ciclos de programa es decir con un contacto SMO 0 en la entrada EN Posee 4 par metros de entrada y 2 de salida En los par metrs de tipo PUNTERO debe usarse el prefijo amp Send Entrada de tipo BOOL Es el bit de petici n de env o del email Conviene usarlo con un flanco de subida To Entrada de
6. WIN se requiere m nimo STEP7 MicroWIN v4 0 SP2 En la barra de men haga clic en Archivo gt Agregar o quitar librer a STEP 7 Micro WIN Proyecto1 KOP SIMATIC EJ Archivo Edici n Ver CPU Test Herramientas Ventana Ayuda Nuevo Ctri N v m Em Abrir Ctri 0 p Ses 2e gt i OL Guardar Ctrl 5 Guardar como Definir contrase a Importar Exportar Cargar en PG Ctrl U PU Ctrl Cargar en CPU Ctri D COMENTARIOS DE Crear librer a L_Agregar o quitar librer a Comentario de seg Configurar p gina Vista preliminar Imagen 4 1 Agregar librer a Hacer clic en Agregar acceder al directorio donde descarg Nubitek Email y seleccionar el fichero mw1 de la librer a Una vez agregada pulse Aceptar para salir F Agregar o quitar librerias Las siguientes librer as de operaciones personalizadas se pueden utilizar usar librerias adicionales haga clic en Agregar y seleccione el archiwa de STEF 7 Micro 4 IN Sino desea seguir utilizando una libreria de ope lista y haga clic en Quitar Si quita una libreria de operaciones de la lista borrar del disco duro CAdownloadstnubitek_email_y Snl Imagen 4 2 Agregar librer a En este punto la librer a Nubitek Email ya debe estar instalada Puede verificarlo accediendo al icono Librer as que hay en el rbol de operaciones debe aparecer la carpeta de la librer a y las 5 funciones que la componen 0 Librerias 1
7. antas veces como haga falta para generar el texto completo del email pero todas las llamadas deben partir del contacto asociado al bit Write Tiene 3 par metros de entrada Text Entrada de tipo STRING Cadena de texto que se va a enviar Puede escribirse directamente el texto con comillas dobles o indicarse la posici n de memoria donde se localiza por ejemplo vB3000 o en formato simb lico Encabezado Value Entrada de tipo DWORD Puntero a la variable num rica que se desea insertar en el texto del email Es OPCIONAL si no se va a incluir ning n valor la entrada Value debe ser O Para m s informaci n sobre la funcionalidad de inclusi n de variables consulte el manual de usuario Return Entrada de tipo BYTE Se utiliza con valor 1 para terminar la cadena de texto especificada en la entrada Text con un retorno de carro No se a ade el retorno si se indica el valor O Importante la aplicaci n construye el texto del email a partir de la posici n final de memoria reservada en el ejemplo de este manual VB1000 Por tanto el programa de control debe dejar sin usar tambi n el espacio necesario para esta acci n si en este ejemplo se mandara un email de 400 caracteres dejar libre desde VB1000 hasta VB1400 aproximadamente 5 Send_SMS Se utiliza la funci n Send_sms una vez para cada SMS diferente que se desee enviar Esta funci n es equivalente a la que contiene la librer a Nubitek SMS Manager Debe llama
8. e necesarios 3 Conexionado de los equipos Los pasos para el conexionado de los equipos son 1 Introducir la tarjeta SIM en el m dem TC65 La ranura donde debe insertarse est etiquetada en el m dem como SIM y tiene al lado un peque o el bot n Presion ndolo con un objeto punzante saldr la bandeja donde colocar la tarjeta SIM Colocar el adaptador de 9 pines macho macho en el puerto serie hembra del m dem Conectar al m dem la antena y la fuente de alimentaci n en la entrada RJ11 Configurar el cable PC PPI los microinterruptores de la mochila del cable PC PPI deben disponerse en modo 9600 baudios 10 bits PPI Freeport y conexi n remota Microinterruptor 1 2 3 4 5 6 17 8 Posici n 0 1 0 0 0 1 1 0 Conectar el extremo serie del cable PC PPI hembra al m dem mediante el adaptador de 9 pines macho macho El extremo PPI macho debe conectarse al puerto O del PLC 57 200 Dar alimentaci n a ambos equipos En algunas versiones de TC65 hay que pulsar el bot n On Off durante un segundo nu b te K Primeros pasos Manual de referencia r pida 6 14 email 4 Instalaci n de la librer a Nubitek Email Para poder hacer uso de la herramienta Nubitek Email en primer lugar se debe instalar de la librer a en el entorno de programaci n STEP 7 MicroWIN Descargue la librer a Nubitek Email desde la p gina de descargas de la web de Nubitek www nubitek com Abra STEP7 Micro
9. imeros pasos Manual de referencia r pida 9 14 email Defina el texto del email como cadena de texto en el Bloque de Datos atenci n el formato STRING usa comillas dobles Por ejemplo VB3000 Estacion remota funcionando sin incidencias Para mejorar la comprensi n del programa se recomienda asignar nombres simb licos a los frases del texto de forma que si vB3000 gt Estado OK el Bloque de Datos queda as Estado OK Estacion remota funcionando sin incidencias Las cadenas de texto individuales a enviar en el correo electr nico no deben sobrepasar los 254 caracteres Sin embargo puede ir encadenando tantas cadenas de texto diferentes como le permita el espacio de memoria V usando la funci n write email La longitud m xima de un correo electr nico a enviar es de 1500 caracteres Defina las direcciones de destino del correo en el Bloque de Datos de la misma forma que los textos Indique la direcci n de correo en la que desea recibir el email por ejemplo VB2000 david fgmail com Asigne nombres simb licos a los destinatarios p ej VB2000 gt MAIL David MAIL David davidfgmail com Puede incluir tantas direcciones de correo diferentes como le permita el espacio de memoria V Defina el texto que desea que aparezca en el campo del asunto del correo electr nico al recibirlo Asigne un nombre simb lico si lo desea VB2100 Informe de funcionamiento Ya est listo para enviar un email
10. modificaciones en el mismo nu DI te K Primeros pasos Manual de referencia r pida email ndice 1 INTRODUCCI N A QUI N VA DIRIGIDO ESTE DOCUMENTO C MO EST ORGANIZADO ESTE DOCUMENTO NOTACI N UTILIZADA 2 EQUIPOS NECESARIOS 3 CONEXIONADO DE LOS EQUIPOS 4 INSTALACI N DE LA LIBRER A NUBITEK EMAIL 5 ASIGNACI N DE MEMORIA A LA LIBRER A 6 C MO ENVIAR UN CORREO ELECTR NICO AP NDICE 1 FUNCIONES DE PROGRAMA DE NUBITEK EMAIL 1 EMAIL_MANAGER 2 EXTRA_SETTINGS 3 SEND_EMAIL 4 WRITE_EMAIL 5 SEND SMS AP NDICE 2 LA CLAVE NUBITEK Y EL MODO DE PRUEBAS 3 14 pp pp E A 11 11 12 12 13 13 14 nu DI te K Primeros pasos Manual de referencia r pida 4 14 email 1 Introducci n Esta gu a de primeros pasos ofrece una r pida toma de contacto con la librer a Nubitek Email Muestra c mo empezar a enviar correos electr nicos desde su S7 200 en pocos minutos A qui n va dirigido este documento Desarrolladores de S7 200 que quieren empezar a utilizar la libreria Nubitek Email para env o de correos electr nicos Clientes de automatizaci n no expertos en el desarrollo para S7 200 que quieran comprobar lo sencillo que es usar la librer a Nubitek Email C mo est organizado este documento Los capitulos 2 y 3 muestran los equipos hardware necesarios para el funcionamiento y c mo conectarlos Los cap tulos 4 y 5 explican c mo preparar el entorno de desarrollo soft
11. nubitek email www nubitek com Nubitek Email Primeros pasos Manual de referencia r pida nu DI te K Primeros pasos Manual de referencia r pida 2 14 email Nubitek Email v1 5 Primeros pasos Manual de referencia r pida ltima actualizaci n Julio 2008 2008 Nubitek industrial IT S L Todos los derechos reservados La informaci n contenida en este documento pertenece a Nubtek industrial IT S L en adelante NUBITEK NUBITEK concede autorizaci n para usar este documento s lo con fines profesionales y siempre que concurran las siguientes condiciones 1 la indicaci n de reserva de derechos aparezca en todas las copias junto con la presente autorizaci n 2 el uso de este documento se haga nicamente con finalidad informativa personal y no comercial sin que se copie o adjunte a ning n ordenador en red ni se difunda en medio alguno y 3 no se haga ninguna modificaci n de ning n tipo en el mismo El uso para cualquier otro prop sito queda expresamente prohibido NUBITEK no se hace responsable de que la informaci n contenida en este documento o en los gr ficos en l contenidos sea til para un prop sito concreto Todos los contenidos y gr ficos se publican tal como est n sin garant as de ning n tipo Este documento puede incluir imprecisiones t cnicas o errores tipogr ficos Su contenido est sometido a cambios peri dicos y actualizaciones NUBITEK puede en cualquier momento hacer mejoras y o
12. pero exclusivamente con un m dem en concreto Para solicitarla debe indicar el IMEI de su m dem es el identificador de 15 cifras que encontrar en la pegatina de la parte trasera del m dem Modo de pruebas Nubitek permite probar Nubitek_Email de forma gratuita y con todas sus prestaciones Basta con poner el valor O en el par metro Nubitek KEY Cada 5 horas se bloquea la aplicaci n y se apaga el m dem pero puede continuar las pruebas encendiendo de nuevo el m dem y reiniciando la CPU
13. que muestra en la imagen 6 3 e introduzca los siguientes par metros Text puede indicar directamente un texto ej Estacion MALAGA 8 o una posici n de memoria ej VB3000 que es el texto definido en el paso 4 Value no se usa en este ejemplo ponga 0 Return indique 1 para a adir un retorno de carro al final de la frase Network 3 tte email Estacion M L4G4 0 0 Write email 4 E SODA 0 0 Imagen 6 3 Llamada a la funci n Send_email 10 Cargue el programa y ponga la CPU en RUN Transcurrido no m s de un minuto y medio debe haberse activado la salida 00 0 lo que indica que el sistema ya est listo para operar Active la entrada 10 0 A los pocos segundos recibir el correo electr nico siguiente Estacion MALAGA 8 Estacion remota funcionando sin incidencias Nota El remitente aparecer como emailsenderfnubitek com debido a que se est usando el servidor de correo de Nubitek embebido en el c digo como cortesia para pruebas y puesta en marcha Para el uso indefinido se aconseja hacer uso de la funci n Extra Settings que permite definir su servidor de correo y el remitente nu DI te K Primeros pasos Manual de referencia r pida 11 14 email Ap ndice 1 Funciones de programa de Nubitek Email La librer a Nubitek Email se compone de 5 funciones o subrutinas Email Manager Send email Write email Send SMS y Extra Settings Email Manager Send email write email Estra Set
14. rse a la funci n un nico ciclo de programa cuando se produzca la condici n de env o del SMS Conviene por tanto atacar al enable de la funci n EN con la condici n de disparo y un flanco positivo Posee 4 par metros de entrada todos de tipo PUNTERO lo que significa que debe usarse el prefijo amp SMS Entrada de tipo DWORD Puntero a la cadena de texto que se va a enviar Tel 1 Entrada de tipo DWORD Puntero a la cadena de texto que contiene un n mero de tel fono de destino Tel 2 Entrada de tipo DWORD Puntero a la cadena de texto que contiene un segundo n mero de tel fono al que se quiera enviar el SMS Es OPCIONAL si no se desea enviar a otro tel fono basta con poner 0 en esta entrada Value Entrada de tipo DWORD Puntero a la variable num rica que se desea insertar en el texto del SMS Es OPCIONAL si no se va a incluir ning n valor la entrada Value debe ser O Para m s informaci n sobre la funcionalidad de inclusi n de variables consulte el manual de usuario nu DI te K Primeros pasos Manual de referencia r pida 14 14 email Ap ndice 2 La clave Nubitek y el modo de pruebas La clave Nubitek es la Ilave que permite funcionar a la librer a Se introduce en el propio programa como par metro Nubitek_KEY de la funci n principal Email_Manager Puede adquirirse f cilmente a trav s de la web de Nubitek www nubitek com Esta clave permite a la librer a funcionar de forma ilimitada en el tiempo
15. tings EM mail server mail user mail pass From Imagen A1 1 Funciones Email Manager Write email Send email Send SMS y Extra Settings 1 Email Manager Es el bloque principal de gesti n de la librer a Debe llamarse una vez y en cada ciclo de programa es decir usando el contacto smo 0 Tiene 5 entradas y una salida PIN Entrada de tipo STRING Cadena de texto con el c digo PIN de la tarjeta SIM introducida en el m dem GSM Ej 1234 Si la tarjeta SIM no tiene c digo PIN de AAYA seguridad debe indicarse con la cadena vac a apn Entrada de tipo STRING Cadena de texto con la direcci n del punto de acceso a la red GPRS Ej airtelnet es user Entrada de tipo STRING Cadena de texto con el nombre de usuario para la conexi n GPRS Ejemplo vodafone passwd Entrada de tipo STRING Cadena de texto con la contrase a para la conexi n GPRS Ejemplo vodafone Nubitek KEY Entrada de tipo INT Clave num rica proporcionada por Nubitek para permitir el correcto funcionamiento de la librer a Para trabajar en el modo de pruebas hay que poner el valor 0 En el Ap ndice 2 de esta gu a se dan m s detalles y se explica c mo obtener la clave Ready Salida de tipo BOOL Se activa cuando la librer a ha concluido el proceso de inicializaci n y est lista para enviar email y mensajes SMS nu DI te K Primeros pasos Manual de referencia r pida 12 14 email 2 Extra
16. tipo DWORD Puntero a la cadena de texto que contiene la direcci n de correo a la que se va a enviar el correo electr nico Por ejemplo amp vB2000 o en formato simb lico amp MAIL David cc Entrada de tipo DWORD Puntero a la cadena de texto que contiene otra direcci n de correo a la que se va a enviar el correo electr nico Es OPCIONAL si no se desea enviar nada a otro destino basta con poner O en esta entrada Subject Entrada de tipo DWORD Puntero a la cadena de texto que contiene el asunto o t tulo del email Por ejemplo amp vB2100 o en formato simb lico KInforme Sending Salida de tipo BOOL Indica que el email est en la bandeja de salida Se activa desde el momento en que se realiza la petici n de env o hasta que se concluye con xito la operaci n Nubitek_Email puede gestionar diversas peticiones simult neas por lo que puede existir varias salidas Sending activas al mismo tiempo Write Salida de tipo BOOL Bit de gesti n para la escritura del cuerpo del correo electr nico Debe usarse en el contacto de llamada a la funci n write email nu DI te K Primeros pasos Manual de referencia r pida 13 14 email 4 Write email Se utiliza la funci n write email una vez para cada cadena de texto de m ximo 254 caracteres cada una que se quiera incluir en el correo electr nico Importante debe llamarse a la funci n usando el bit de salida write de la funci n Send_email asociada Puede llamarse t
17. ware Step 7 MicroWin para usar la librer a Nubitek Email El cap tulo 6 explica paso a paso c mo enviar un correo electr nico desde su PLC S7 200 usando Nubitek Email El ap ndice 1 es la referencia b sica de la librer a Nubitek Email y recoge la descripci n de las funciones que ofrece El ap ndice 2 aporta m s informaci n sobre la clave necesaria para el funcionamiento de Nubitek Email Notaci n utilizada Este documento utiliza diferencias tipogr ficas para identificar caracter sticas del texto tal como se recoge en la siguiente tabla Tipograf a Uso y ejemplos Italica Opciones de men Ejemplo Archivo gt Agregar o quitar librer a Negrita Avisos importantes para el lector Ejemplo Atenci n Monoespaciada Nombres de fichero y rutas de directorio Ejemplo nubitek_email_v1 5 mwl Texto referente a c digo de programa Ejemplo VB2000 david gmail com nu o te K Primeros pasos Manual de referencia r pida 5 14 email 2 Equipos Necesarios Los elementos hardware necesarios para la utilizaci n de la libreria Nubitek Email son Una CPU S7 200 m nimo CPU224 y versi n xxx23 firmware 2 0 Un m dem GSM GPRS TC65 firmware 2 0 con antena y fuente de alimentaci n Una tarjeta SIM de cualquier operador de telefon a m vil Un cable PC PPI multimaestro ref Siemens 6ES7 901 3CB30 OXAO Un adaptador macho macho de 9 pines Sub D 9 pin Sub D Adapter PC PPI Imagen 2 1 Equipos hardwar
Download Pdf Manuals
Related Search