4. Interfaz gráfica para PC

Transcripción

1 4. Interfaz gráfica para PC 4.1 Introducción El núcleo del siguiente proyecto gira en torno al diseño y programación de una interfaz gráfica sencilla para PC que permita la interacción del usuario con el DSP, y la prueba de la misma y sus funcionalidades conectando el PC al DSP mediante el puerto serie. Para el diseño de esta interfaz gráfica del PC se decidió utilizar el lenguaje de programación Visual Basic por las facilidad a la hora de crear interfaces gráficas debido a que, como su propio nombre indica, es un lenguaje visual. Dentro del grupo del lenguajes visuales se eligió este y no otro por la experiencia acumulada en anteriores proyectos, nula para otros lenguajes de programación. Finalmente, se optó por trabajar con la última versión de Microsoft para teste lenguaje de programación: Visual Basic.NET. Aunque el código completo del programa se puede encontrar comentado en el ANEXO I, en los próximos puntos se intentará explicar el funcionamiento de éste, mostrando cual ha sido la filosofía de programación: estructurar el programa de tal manera que sea fácilmente entendible y modificable por otros programadores con nuevas necesidades en un futuro. Por esto último se ha intentado que la programación sea lo mas modular posible facilitando con ello la inclusión de nuevas funciones no previstas en un principio durante el desarrollo de la interfaz. La presentación y el análisis de las diferentes funciones que componen el programa se hará siguiendo el mismo orden modular del mismo viendo las ventanas que conforman la aplicación. De este modo empezaremos explicando todos los componentes del formulario y sus funciones asociadas, así como de las funciones de otros módulos de las que ser sirven las primeras. Seguiremos explicando en detalle las funciones ubicadas en el resto de los bloques. Para una descripción mas funcional del programa, remitimos al lector al Apéndice A de este documento donde puede encontrar un breve Manual de Usuario que, sin entrar en detalles estructurales, puede dar al usuario novato una idea bastante clara de la utilidad de la interfaz así

2 como de sus límites operacionales. 4.2 Descripción de los módulos del programa Módulo Form1 Figura 4.1: Ventana del formulario al abrir el programa. Éste es el módulo principal de la aplicación, ya que contiene toda la configuración del formulario así como de todas las funciones asociadas a los objetos del mismo. Este formulario (ver figura 4.1) esta dividido en dos partes bien diferenciadas. Ocupando la mayor parte de la ventana hay ubicado un Tabpage que contiene ocho TabControls: 1. Estado y Alarmas, donde se representan de forma visual los errores comunicados por el DSP a

3 través de la trama de Flags de avisos y errores. 2. Osciloscopio, donde podemos solicitar al DSP una serie de medidas para visualizarlas y/o almacenarlas en una hoja de cálculo. 3. Histórico de medidas, que muestra de forma gráfica los datos de la ventana Medidas. 4. Tabla, cuya finalidad es el tratamiento de una base de datos ACCESS para el almacenamiento de los datos. 5. Medidas, que muestra de forma numérica las medidas realizadas por el DSP. 6. Parámetros, donde se pueden visualizar/editar los parámetros de calibración. 7. Mensajes, donde la aplicación irá guardando la información relacionada con las acciones realizadas por ella en respuesta a órdenes directas del usuario o por la ocurrencia de eventos. 8. Conexión, donde estarán disponibles para el usuario todas las opciones posibles para establecer la comunicación por el puerto serie. Además, en la parte inferior del formulario y común a todos los TabControls se encuentran varios botones: Conectar/Desconectar: Activa/desactiva la comunicación por el puerto serie. Salir: Cierra el programa. Comandos maniobra: Tres botones para manejar el estado del convertidor desde el PC. Por último, nos encontramos un label que nos informará del estado de la comunicación en función del dato contenido en la trama de Comunicación activa que el DSP enviará al PC cuando éste se la pida (de forma automática cada 30 segundos).

4 Procedimiento mors232_commevent Ésta es la primera rutina que nos encontramos en el módulo Form1 que se ejecutará automáticamente cuando se reciba algún dato por el puerto serie. Es requisito indispensable para que se inicie este procedimiento que se haya activado la recepción de eventos (escucha del puerto serie), lo cual se produce cuando se inicia la conexión (botón Conectar). Todos los datos recibidos se guardan en el vector trama y se inicia el Timer1 para asegurarnos de que se ha esperado el tiempo suficiente para que la trama llegue completa. El flag al principio de la rutina sirve para que el vector con la trama recibida no se sobreescriba con la llegada de nuevos datos mientras se están evaluando los primeros Procedimiento Form1_Load Se ejecuta cuando se inicia la aplicación. Carga las propiedades dinámicas del formulario guardadas al cerrar por última vez éste, abre la base de datos ACCESS para el almacenamiento de los mensajes y prepara una posible conexión con la base de datos para el almacenamiento de los datos recibidos Procedimiento Form1_Closing Se ejecuta al cerrar la aplicación. Lo primero que hace es guardar los valores de todas las propiedades dinámicas en un archivo de configuración para leerlos en la próxima ejecución del programa. Después, si el puerto serie se quedó abierto antes de finalizar la aplicación, lo cierra desactivando primero la escucha de eventos. Por último si se usó la base de datos y se dejó abierta, la cierra.

5 Procedimiento Bsalir_Click botón Salir. Realiza las mismas operaciones que la rutina del apartado anterior al pulsar el usuario el Procedimiento Bmostrartablas_Click Se ejecuta al pulsar el usuario el botón Mostrar Tablas de la pestaña Tabla. Comprueba que se ha seleccionado una base de datos y que ésta esté abierta. En ese caso, busca las tablas de la base y las muestra en el ComboBox correspondiente. Por último, habilita el botón Abrir Tabla Procedimiento Bexaminar_Click Al pulsarse el botón Examinar de la pestaña Tabla se abre un cuadro de diálogo para que el usuario seleccione la tabla almacenada en en PC que se usará para almacenar los datos Procedimiento cbtablas_selectedindexchanged Al seleccionar una tabla de las mostradas en el ComboBox almacena en la variable CadenaConexion el nombre completo de aquella. Acto seguido habilita el botón Abrir tabla Procedimiento Babrirtabla_Click Se ejecuta este procedimiento al pulsarse el botón Abrir Tabla. Lo primero que hace es borrar del List View los datos de otra tabla abierta anteriormente (si fuera el caso). Cierra y abre la tabla otra vez por si se produjeron externamente cambios en ésta en el tiempo transcurrido desde que se seleccionó y se decidió abrirla y completa el List View con sus campos. Activa, finalmente, los botones asociados a la modificación de la tabla.

6 Procedimientos tbbase_dragover y tbbase_dragdrop Permiten arrastrar el nombre de una base de datos y colocarlo encima del TextBox del nombre de la base a abrir. Evita usar el botón Examinar cuyo procedimiento asociado está descrito en el apartado Procedimiento Lvtabla_Click Guarda en la variable lwitemactual la fila de la tabla seleccionada con el puntero del ratón para poder ser modificada al pulsar los botones de modificación de tabla (parte inferior de la pestaña Tabla). Termina llamando al procedimiento MostrarCampo Procedimiento Lvtabla_SelectedIndexChanged Realiza las mismas acciones que el procedimiento descrito en el apartado anterior al cambiar con los cursores la fila seleccionada Procedimiento Basignar_Click Al pulsarse el botón Asignar se sobrescribe el campo seleccionado en el ComboBox con el valor escrito en el TextBox. Para esto se llama al procedimiento Escribe_campo() Procedimiento Bguardarbase_Click Se ejecuta al pulsar el botón Guardar Base almacenando la base mostrada en el List View en el disco duro del PC (se hubieran realizado cambios o no).

7 Procedimiento Bnuevoitem_Click Al pulsarse el botón Nuevo Item se crea una nueva fila después de la última escrita llamando al procedimiento Crea_fila() Procedimiento Beliminaritem_Click del List View. Procedimiento asociado al botón Eliminar Item que borra la fila seleccionada previamente Procedimiento breleerbase_click Carga de nuevo la tabla almacenada en el disco duro usando las funciones Conectar(), AsignarCabeceraLista() y LlenarLista. Se ejecuta al pulsar el botón Releer Tabla Procedimiento Timer1_Tick Se ejecuta cuando ha transcurrido el tiempo de ranura en recepción tras el cual, la trama debe haber llegado correctamente. La rutina decisor_trama realizará las acciones necesarias en función de la trama recibida. Después de ésto, se activa el flag flag_recepcion para permitir la recepción de una trama nueva Procedimiento cbautomatico_checkedchanged Cambia la variable booleana automatico en función de si se activa o desactiva el Check Box asociado. En el caso de que se active, habilita el TextBox para introducir el período de almacenamiento de datos en la base ACCESS abierta previamente.

8 Procedimiento actualiza_form Actualiza todos los objetos variables de cada una de las pestañas (TextBox, gráficas, barras de estado,...). La actualización es selectiva, en función del valor de cada uno de los flags de actualización asociado a cada una de las pestañas. Estas variables booleanas serán igual a True cuando se haya producido algún evento que haga variar un elemento de la pestaña con la que está relacionada Procedimiento Tbintervalo_TextChanged Actualiza la variable intervalo_almacenamiento con el valor contenido en el TextBox correspondiente si éste es modificado por el usuario. Se almacenarán datos en la tabla cuando pase un tiempo de valor igual o superior al contenido en la variable intervalo_almacenamiento desde la última vez que se guardaron datos en ella Procedimiento tbbase_textchanged Se ejecuta cuando cambia el nombre de la base a abrir en el TextBox correspondiente. Si este TextBox no está en blanco, se habilita el botón Mostrar Tablas Procedimiento B_envio_128_Click Al pulsar el usuario el botón Refrescar de la pestaña Osciloscopio, manda a la cola de transmisión la solicitud de envío de una trama de petición de datos para representarlos en el osciloscopio virtual Procedimiento Timer2_Tick

9 Provoca el envío de una trama de Comunicación activa (ver Anexo III)cada 30 segundos Procedimientos cbcursor_graf_x_checkedchanged (X=1,2,3,4) Cuatro procedimientos en total, uno para cada gráfica. Se ponen en funcionamiento cuando el CheckBox correspondiente se activa/desactiva. En el primer caso hace visibles los cursores y habilita los TextBox de representación de los incrementos vertical y horizontal. Hace lo contrario en el caso que se desactive la opción Procedimientos XyCursor_graf_X_AfterMove, tbcursors_graf_x_y_textchanged y tbcursors_graf_x_x_textchanged (X=1,2,3,4) En este caso, tres procedimientos para cada gráfica encargados de actualizar los TextBox de intervalo cuando se mueven los cursores de las gráficas con el puntero del ratón Procedimiento Bconexion_Click Asociado al botón Conectar/Desconectar. En el primer caso, recoge los parámetros de configuración establecidos por el usuario en el menú de Conexión llamando al procedimiento establece parámetros() y después abre el puerto con ayuda de la rutina Crea_conexión_Rs232() activando la escucha de eventos. Finalmente activa el temporizador para el envío periódico de la trama Comunicación activa. En el otro caso, deshabilita la escucha de eventos y cierra el puerto. En ambos casos, termina actualizando el formulario usando los procedimientos actualiza() y actualiza_form().

10 Procedimiento cbcursor_osc_checkedchanged Hace visibles los cursores sobre la gráfica y habilita los TextBox de representación de los incrementos vertical y horizontal al activar el CheckBox destinado a tal efecto. Realiza las acciones opuestas al desactivar el CheckBox Procedimientos XyCursor_osc_1_AfterMove y tbcursors_osc_x_textchanged (X=x,y) Actualizan los TextBox de intervalos vertical y horizontal cuando se mueven los cursores de las gráficas con el puntero del ratón Procedimientos Cb_osciloscopio_var_t_SelectedIndexChanged y Cb_osciloscopio_var_X_SelectedIndexChanged (X=1...6) Se ejecutan al cambiar el usuario en el correspondiente Combo Box de la pestaña Osciloscopio las señales a capturar o el ancho de ventana de la representación. Modifican los vectores s_osc_var y v_osc_var necesarios para la petición de los datos al DSP y el almacenamiento de datos en una hoja de cálculo EXCEL (ver apartados y ) Procedimiento B_marcha_Click Se ejecuta cuando se pulsa uno de los tres botones dedicados al envío de comandos de maniobra. Manda a la la cola de transmisión la orden de envío de la correspondiente trama (ver Anexo III) Procedimiento B_osc_exportar_Click Al pulsar el botón Exportar de la pestaña Osciloscopio abre un cuadro de diálogo para que el

11 usuario elija el nombre y la ubicación del fichero donde se guardarán los datos. Después llama al procedimiento guarda_osc_excel() que es el que realiza todas las operaciones necesarias (ver apartado ) Procedimiento B_osc_importar_Click Al pulsar el botón Importar de la pestaña Osciloscopio abre un cuadro de diálogo para que el usuario elija el fichero de donde se quieren extraer los datos para su representación. Los datos los extrae el procedimiento abre_osc_excel() (ver apartado ). Al terminar de ejecutarse este, el procedimiento act_leyendas() (ver apartado ) actualiza la leyenda de la gráfica con el nombre de las variables extraídas del archivo. Finalmente, se llama a la función actualiza_form() (ver apartado ) para que actualice la gráfica con los valores cargados Procedimiento Cb_osciloscopio_canal_SelectedIndexChanged Al cambiar la elección del canal que se use para el disparo en el Combo Box correspondiente de la pestaña Osciloscopio modifica la variable i_canal_disparo necesaria para la construcción de la trama de Petición de datos para osciloscopio virtual (ver apartado y Anexo III) Procedimiento Cb_osciloscopio_flanco_SelectedIndexChanged Al cambiar el tipo de disparo (de subida o de bajada) para la captura de datos en el Combo Box correspondiente de la pestaña Osciloscopio modifica la variable i_tipo_flanco necesaria para la construcción de la trama de Petición de datos para osciloscopio virtual (ver apartado y anexo III) Procedimiento Tb_osciloscopio_nivel_TextChanged

12 Al cambiar el nivel de disparo para la captura de datos en el TextBox correspondiente de la pestaña Osciloscopio modifica la variable d_nivel_disparo necesaria para la construcción de la trama de Petición de datos para osciloscopio virtual (ver apartado y Anexo III) Procedimiento B_envio_66_Click_1 Se ejecuta cuando el usuario pulsa el botón Enviar del grupo Parámetros de calibración de la pestaña Parámetros. Almacena en el vector d_vect_par_cal los parámetros de calibración introducidos por el usuario en los TextBox correspondientes, array necesario para la construcción de la trama del mismo nombre (ver Anexo III). Antes de finalizar la rutina, almacena en la cola de transmisión la orden de envío de esta trama (tipo 66) Procedimiento B_envio_67_Click_1 Se ejecuta cuando el usuario pulsa el botón Enviar del grupo Otros parámetros de la solapa Parámetros de calibración. Almacena en el vector d_vect_otros_par los parámetros de calibración introducidos por el usuario en los TextBox correspondientes, array necesario para la construcción de una trama del mismo nombre (ver Anexo III). Antes de finalizar la rutina, almacena en la cola de transmisión la orden de envío de esta trama (tipo 67) Procedimiento B_envio_68_1_Click Se ejecuta cuando el usuario pulsa cualquiera de los dos botones Leer de la solapa Parámetros de calibración. Manda a la cola de transmisión la petición de envío de una trama de Petición de parámetros (ver Anexo III) del tipo elegido (Parámetros de calibración u Otros parámetros).

13 Procedimiento envia_trama Dependiendo del tipo de trama que se quiera enviar, redimensiona el vector array_trama para que la función genera_trama() introduzca en él los bytes correspondientes. Por último, envía la trama (bytes del vector) con ayuda de la función Write del objeto de la clase Rs232 creado previamente al iniciar la conexión Procedimiento vacia_cola Recoge la última petición de envío de trama de la cola de transmisión y, usando el procedimiento envia_trama(), construye la trama y la envía Procedimiento abre_tabla_mensajes Se encarga de abrir la base de datos donde se guardarán (si el usuario lo solicita con el correspondiente botón) todos los mensajes de eventos mostrados en el List View de la pestaña Mensajes. La base a abrir se debe llamar mensajes.mdb, estar ubicada en el directorio de trabajo de la aplicación y tener una tabla llamada Tabla1. Una vez abierta la tabla se rellena el List View con los mensajes almacenados en ella previamente. Este procedimiento se ejecuta siempre al iniciar el programa, al ser invocado por el procedimiento Form1_Load Procedimiento envio_1 Si la cola no está llena almacena en ella la orden de envío de una trama tipo 1 (ver Anexo III). Este procedimiento se ejecuta cada vez que el temporizador Timer2 expira (cada 30 segundos).

14 Procedimiento SetRange Permite el cambio de la escala del eje (de cualquiera de las gráficas) que se le pase como parámetro. Para ello abre un cuadro de diálogo para que el usuario de la aplicación establezca los límites superior e inferior de ese rango Procedimiento elige_fichero_guardar Abre un cuadro de diálogo para que el usuario elija el archivo EXCEL donde se guardarán los datos. Estos datos pueden ser los parámetros de calibración (numero = 0) o los correspondientes a cualquiera de las cuatro gráficas de la pestaña Histórico de medidas (numero = 1, 2, 3, 4). La ruta completa del fichero seleccionado se guarda en la variable s_hoja Procedimiento elige_fichero_abrir Abre un cuadro de diálogo para que el usuario seleccione el fichero EXCEL de donde se extraerán los datos. Estos datos pueden ser parámetros de calibración (numero = 0) o para representarlos en cualquiera de las cuatro gráficas de la pestaña Histórico de medidas (numero = 1, 2, 3, 4). La ruta completa del fichero seleccionado se guarda en la variable s_hoja Procedimientos cbx4_selectedindexchanged (X=1, 2, 3, 4) Un procedimiento asociado a cada una de las gráficas de la pestaña Histórico de medidas. Cambia el rango del eje X de la correspondiente gráfica en función del intervalo de representación elegido por el usuario (mayor intervalo implica mas muestras, mayor rango). El cambio de este rango se realiza redimensionando el vector que contiene los datos a representar en la gráfica Procedimientos cbxy_selectedindexchanged (X=1, 2, 3, 4; Y=1, 2, 3) Tres procedimientos para cada gráfica asociados a cada uno de los tres Combo Boxes para

15 elegir las señales a representar. Cada vez que el usuario cambia esta elección, se ejecuta el procedimiento asociado al Combo Box, que guarda en los vectores s_graf_x_var y rep_hist_len (para las gráficas inferiores) o rep_hist_rap (para las gráficas superiores) el nombre y el código de la variable elegida respectivamente, este último necesario para la importación y exportación de datos (ver apartados y ). gráfica. Si se elige Ninguna, cambia el color del plot a transparente para que no aparezca en la Por último, borra todos los datos del vector asociado a la gráfica para empezar a guardar los nuevos, correspondientes a la señal elegida Procedimiento Timer3_Tick Este procedimiento se ejecuta cuando el contador (Timer3) expira. Su período lo establece el usuario (tiempo de ranura en transmisión). Si la cola de transmisión no está vacía (hay órdenes de envío de trama en ella), invoca al procedimiento vacia_cola() Procedimiento B_exp_hist_Click Guarda los datos de las gráficas de la pestaña Histórico de medidas si su Check Box (parte central inferior de la solapa) está activado por el usuario. Invoca al procedimiento elige_fichero_guardar() (ver apartado ) para que el usuario elija el archivo EXCEL donde se guardarán los datos y luego, con ayuda del procedimiento exporta_graf_x (X=1, 2, 3, 4), guarda los datos en el fichero abierto Procedimiento B_imp_hist_Click Importa datos de archivos EXCEL para representarlos en las gráficas cuyos Check Boxes están activados por el usuario. Para cada gráfica, se permite elegir un fichero portador de los datos

16 invocando al procedimiento elige_fichero_abrir() (ver apartado ), se abre con abre_hist_excel() (ver apartado ) y se copian los datos de éste en el array de representación de datos de la gráfica correspondiente, d_grafica_x (X= 1, 2, 3, 4). En los vectores rep_hist_rap o rep_hist_len, según corresponda, se guardan los códigos de las señales extraídas para poder actualizar las leyendas (ver apartado ). Por último, el procedimiento actualiza_form() representa los datos extraídos Procedimientos cb_rep_x (X = 1, 2, 3, 4) Un procedimiento para cada gráfica de la pestaña Medidas. Al activar/desactivar la opción de parar la captura de datos para representación gráfica cambia el contenido del vector booleano rep_graf. Si el contenido de este vector es False en alguna posición, no se actualizará la gráfica correspondiente a la llegada de nuevos datos Procedimiento B_borrar_mensajes_Click Se ejecuta cuando el usuario pulsa el botón Borrar de la pestaña Mensajes. Borra todo el contenido del List View contenido en dicha solapa Procedimiento B_guardar_mensajes_Click Se ejecuta cuando el usuario pulsa el botón Guardar de la pestaña Mensajes. Guarda el contenido del List View en la tabla abierta cuando se inició el programa (ver apartado ) Procedimiento B_exp_par_Click Guarda los parámetros de calibración contenidos en los Text Boxes de la pestaña Parámetros en una hoja de cálculo. Invoca a los procedimientos elige_fichero_guardar() (ver apartado

17 ), exporta_par() (ver apartado ), que copia los datos de los dos vectores de parámetros en uno solo para que guarda_par_excel() (ver apartado ) copie sus datos en la hoja. Este procedimiento se ejecuta cuando el usuario pulsa el botón Exportar de la misma pestaña Procedimiento B_imp_par_Click Se invoca al pulsar el usuario el botón Importar de la pestaña Parámetros. Extrae los parámetros de calibración de una base de datos y los muestra en los Text Boxes de la misma pestaña. Con la función elige_fichero_abrir() (ver apartado ) el usuario puede elegir el archivo de donde se extraerán los datos. El procedimiento abre_par_excel() extrae estos parámetros y los guarda en el vector de dos dimensiones v_par_excel. Por último, las dos filas de este vector se copian en los vectores asociados a esa pestaña para que el procedimiento actualiza_form() actualice los campos con los nuevos datos Procedimientos b_rango_y_x_click (X = 1, 2, 3, 4, osc) Un procedimiento para cada una de las cinco gráficas (cuatro en la pestaña Histórico de medidas y una en Osciloscopio). Al pulsar el botón Rango Y de cualquiera de las gráficas, permite que el usuario cambie el rango del/de los eje(s) vertical(es) con ayuda del procedimiento SetRange() (ver apartado ) Procedimientos cb_rango_xcheckedchanged (X = 1, 2, 3, 4, osc) Cinco procedimientos, uno para cada gráfica. Para cada una, establece el modo de rango vertical a manual o automático en función del estado del Check Box asociado. En modo automático, el rango variará en función de los datos de las señales que se estén representando. La activación o no del automático se consigue habilitando o deshabilitando respectivamente la propiedad de autoescalado de cada uno de los plots de la gráfica.

18 Procedimientos cb_rejilla_x_checkedchanged y cb_rejilla_y_x_checkedchanged (X = 1, 2, 3, 4, 5, 6) Se ejecutan cuando el usuario cambia el estado del correspondiente Check Box de la pestaña Osciloscopio haciendo visibles u ocultando las rejillas asociadas a cada uno de los ejes Módulo ADONETUtil En este módulo se encuentran todos los procedimientos y funciones utilizadas para la apertura de las bases ACCESS y la representación de sus datos en el formulario. El único procedimiento diseñado expresamente para este proyecto es MostrarCampo() por lo que será el único que se explicará brevemente. Para una mayor información del resto de funciones y procedimientos de este módulo, remitimos al lector a [W5] Procedimiento MostrarCampo La función de esta rutina es la de mostrar en el TextBox Valor el valor del campo marcado en el ComboBox Campo correspondiente a la fila seleccionada con el puntero del ratón o los cursores Módulo ActToolsUtils Es el módulo donde se encuentran los procedimientos utilizados (a excepción de actualiza_form() que se encuentra en el módulo Form1) para la habilitación/inhabilitación de botones y actualización del mensaje de las barras de estado. Consta de dos elementos: activabotonesaccess() y actualiza().

19 Procedimiento activabotonesaccess Habilita los botones asociados a las acciones de modificación de la tabla abierta para el almacenamiento de los datos recibidos, así como el ComboBox y el TextBox utilizados para la activación del almacenamiento automático. Como se puede comprobar en el módulo Form1, esta función se ejecuta al haberse abierto correctamente la tabla de la base ACCESS Procedimiento actualiza En función del estado del puerto de comunicaciones (abierto o cerrado) modifica los mensajes de las barras de estado y habilita/inhabilita los objetos relacionados con la configuración de la conexión y los botones de envío de tramas por el puerto serie. Estos cambios los hace efectivos el procedimiento actualiza_form() (ver apartado ) Módulo app.config En este fichero se almacena la configuración del programa cuando este se cierra para que, la próxima vez que se vuelva a abrir, esté establecida por defecto la última configuración utilizada por el usuario Módulo AppSettingsUtils Este es el módulo que contiene las rutinas necesarias para el almacenamiento de la configuración de la ventana en el fichero app.config descrito en el apartado anterior. Consta de un procedimiento llamado cfgsetvalue() que se encarga de escribir en el archivo citado las propiedades dinámicas establecidas al cerrar el programa (básicamente la configuración del puerto serie usada por el usuario) y de la función cfggetvalue() que se encarga de leer el mismo fichero cuando arranca el programa. Todo el módulo está tomado de [W5], a donde remitimos al lector para obtener una

20 información detallada Clase Rs232 Contiene las propiedades, funciones, procedimientos, enumeraciones,... necesarias para crear un objeto Rs232 (procedimiento Bconexion_Click) y poder realizar la comunicación por el puerto serie. En [W4], web creada por Corrado Cavalli, se encuentra toda la información referida a esta clase Módulo Rs232Utils Lo componen dos funciones: estableceparametros(), que guarda en las variables correspondientes la configuración de la comunicación serie establecida por el usuario en la pestaña dedicada a tal efecto para que luego crea_conexion_rs232() establezca estas propiedades en el objeto de la clase Rs232 previamente creado Módulo RxUtils En este módulo se encuentran las funciones y procedimientos necesarios para el tratamiento de las tramas recibidas procedentes del DSP Función calcula_crc Calcula el código de redundancia cíclica de 8 bits (CRC-8) cuyo polinomio generador es G(x)= x 8 + x 2 + x + 1. En el apéndice B se describe como se realiza el cálculo del CRC con detalle. En este apartado nos limitaremos a decir que el cálculo del CRC de una serie de bits consiste en la división binaria o de módulo 2 de ese conjunto de bits entre la representación binaria del polinomio

21 generador que, en nuestro caso, sería Previamente a la llamada de la función, el procedimiento de recepción de la trama habrá almacenado en el vector arraybyte todos los bytes a partir de los cuales se quiere calcular el CRC. El proceso de cálculo se encuentra imbuido en un bucle del que no se sale hasta que no se encuentra el CRC (flag1 = True). Dentro de este bucle se encuentra otro encargado de recorrer el vector arraybyte en busca del primer/siguiente bit a 1. Se sale del bucle si se encuentra este bit (flag2 = True) y/o se ha llegado el ultimo byte del vector arraybyte (flag3 = True), en cuyo caso, el CRC es ese último byte (ver apéndice B). Una vez hallado el bit a uno, se realiza la operación XOR entre los siguientes 8 bits al bit a 1 encontrado y los 8 bits del polinomio generador. El resultado de este proceso se sobreescribe en el vector arraybyte en las 8 posiciones siguientes al bit a 1 encontrado. Este proceso se repite hasta llegar al último byte del vector arraybyte. Devuelve el CRC en formato byte Procedimiento rec_trama_32 Se ejecuta cuando se recibe una trama tipo 32 (ver Anexo III). En primer lugar evalúa si la trama recibida es correcta. Para ello comprueba que los dos primeros bytes correspondientes al campo Size son coherentes (el tamaño de esta trama es de 6 bytes). Después calcula el CRC de la trama y lo compara el último byte de la trama (el byte que contienen el CRC calculados por el emisor). Si la trama es correcta actualiza los flags de estado contenidos en la pestaña Estado y Alarmas a la vez que va guardando el estado de los flags en la cadena estadostring para su posterior almacenamiento en la base de datos si el modo automático estaba activado por el usuario.

22 Procedimiento rec_trama_64 Se ejecuta cuando se recibe una trama tipo 64 (ver Anexo III). Se realiza la misma comprobación de errores que el descrito en el apartado anterior (en este caso, el tamaño debe ser 56). Si la trama se ha recibido correctamente, recoge los datos y los almacena en el vector arraydoublemedidasrx después de aplicarles el factor de multiplicación que les corresponda. A partir de este vector actualizará los TextBoxes de la pestaña Medidas y los arrays correspondientes a los datos de las gráficas de la solapa Histórico de medidas. abierta. Por último, si la opción correspondiente está activada, guarda estos datos en la base de datos Procedimiento rec_trama_65 Se ejecuta cuando se recibe una trama tipo 65 (ver Anexo III). Se realizan los mismos procesos descritos en el apartado anterior. En este caso, los datos recibidos, correspondientes a las medidas lentas, se guardan en el vector arraydouble_medidas_lentas Procedimiento obten_vector_datos Extrae los datos portados por una trama tipo 129 (datos para el oscilocopio virtual) y los introduce en el vector de dos dimensiones var_osc. Lo primero que hace es averiguar a que variable pertenecen esos datos. Esto se consigue mirando el byte correspondiente al canal que se envía. En el vector v_osc_var se encuentra la

23 correspondencia entre el canal y la variable ya que aquel se sobreescribió con estos valores al solicitar los datos previamente mediante una trama tipo 128. Una vez que sabemos la variable a la que corresponden estos datos podemos conocer el factor de multiplicación, que se guarda en la variable divisor. Finalmente, se recorre el vector extrayendo los datos, pasando éstos de dos bytes a entero y luego éste a un double tras dividirlo por el factor de multiplicación. Tras estas operaciones, se guardan en el array destinado a tal efecto Procedimiento rec_trama_66 Se ejecuta cuando se recibe una trama tipo 66 (ver Anexo III). Se realizan los mismos procesos descritos en el apartado en este caso, los datos se almacenan en el array d_vect_par_cal, que servirá para actualizar los TextBoxes del grupo Parámetros de calibración de la pestaña Parámetros Procedimiento rec_trama_67 Se ejecuta cuando se recibe una trama tipo 67 (ver Anexo III). Realiza las mismas operaciones que el procedimiento descrito en el apartado anterior. En este caso, los datos recibidos se guardan en d_vect_otros_par y los TextBox que se actualizan son los del grupo Otros parámetros Procedimiento decisor_trama A partir del primer byte de la trama recibida (se le pasa como parámetro) llama a la función correspondiente (rec_trama_x, X = Identificador de trama) para el tratamiento de los datos contenidos en aquella.

24 Procedimiento rec_trama_1 Se ejecuta cuando se recibe una trama tipo 1 (ver Anexo III). En este caso, no hay ningún dato en la trama variable por lo que el byte del CRC al igual que el resto, será siempre el mismo (CRC = 60). Por esta razón se comprueban todos los bytes de la trama a la vez. Tras la comprobación, escribe sendos mensajes en la barra de estado y en el List View de la pestaña Mensajes Procedimiento rec_trama_2 Se ejecuta cuando se recibe una trama tipo 2 (ver Anexo III). En primer lugar se realizan las mismas operaciones descritas en el apartado para comprobar los campos de tamaño y CRC. Si el resultado es positivo, escribe el código de error enviado por el DSP en el List View de la pestaña Mensajes Procedimiento rec_trama_16 Se ejecuta cuando se recibe una trama tipo 16 (ver Anexo III). Tras comprobar que los bytes de tamaño de trama y CRC son correctos escribe en el List View de la pestaña Mensajes el estado del automatismo según el código introducido por el DSP en el campo de datos Procedimiento rec_trama_129 Se ejecuta cuando se recibe una trama tipo 129 (ver Anexo III), que contiene datos para el osciloscopio virtual.

25 Si los campos de tamaño de trama y CRC son correctos, extrae los datos de la trama y los guarda en un vector para su representación. Esto se realiza con el procedimiento obten_vector_datos (ver apartado ) Módulo TablaUtils En este módulo se encuentran las funciones que ejecutan las acciones necesarias para agregar datos a la tabla Procedimiento Crea_fila Crea una nueva fila después de la última fila existente. Rellena cada campo de la fila creada con el correspondiente nombre de su columna. Por último, la muestra en el ListView y establece la fila creada como fila actual Procedimiento Escribe_campo Escribe el dato pasado como parámetro en la fila actual del ListView. La columna a sobreescribir también es pasada a la función por valor Módulo ExcelUtils Aquí encontramos todos los procedimientos para la gestión de los datos en hojas de cálculo EXCEL. Las rutinas necesarias para el almacenamiento y extracción de datos con procedencia o destino las gráficas de las pestañas Osciloscopio y/o Histórico de medidas se ubican en este módulo.

26 Procedimiento guarda_osc_excel Este es el procedimiento que se encarga de guardar en una hoja de cálculo los datos de las variables representadas en ese instante en la gráfica de la pestaña Osciloscopio. El primer paso es abrir un nuevo libro y, en éste, una nueva hoja, que será el lugar donde se almacenarán los datos. Para ello necesitamos tenerlos en un vector y, por comodidad a la hora de visualizarlos en la hoja, será preciso tenerlos por columnas en lugar de por filas por lo que en DataArray copiará la matriz var_osc invertida. Estos datos se guardarán a partir de la fila 3 de la hoja. En las dos primeras se introducirán, respectivamente, el nombre de la variable y el código asignado a ésta por la aplicación, necesario para la correcta (posible) extracción posterior de los datos (ver apartado siguiente). usuario. Finalmente, se guarda el libro. Si no es posible esta operación muestra un mensaje de error al Procedimiento abre_osc_excel() Realiza la operación inversa al procedimiento descrito en el apartado anterior, es decir, extrae los datos almacenados en una hoja de cálculo y los representa en la gráfica de la solapa Osciloscopio. Antes de todo hay que abrir la hoja EXCEL, cuya ruta o nombre completo se guardó previamente en la variable s_hoja al elegir el archivo a abrir en el cuadro de diálogo que aparece al pulsar el botón Importar. Con la hoja abierta, se extraen los datos empezando por los códigos de las variables cuyos datos vamos a extraer. Estos códigos son necesarios para que posteriormente el procedimiento act_leyendas() actualice la leyenda del gráfico (ver apartado siguiente). Tras extraer los datos y guardarlos en el vector var_osc para que el procedimiento

27 actualiza_form() actualice la gráfica se cierra la hoja Procedimiento act_leyendas Actualiza la leyenda de la gráfica de la solapa Osciloscopio tras extraer los datos almacenados en una hoja de cálculo para su representación. La actualización de esta leyenda la realiza actualiza_form() a partir de los nombres guardados en el vector s_osc_var por lo que lo único que hay que hacer es rellenar éste con el nombre correspondiente al código guardado por abre_osc_excel() en el array v_osc_var Procedimiento guarda_hist_excel Procedimiento similar a guarda_osc_excel() (ver apartado ). En este caso, se guardan las señales de una de las gráficas de la pestaña Histórico de medidas. Estos datos se deben haber guardado previamente en el vector v_hist_excel (ver apartado ). Como parámetro, se le pasa el tamaño del vector que contiene los datos, que será igual al ancho de ventana de la gráfica correspondiente. Este ancho es variable ya que es seleccionable por el usuario Procedimientos exporta_graf_x (X = 1, 2, 3, 4) Un procedimiento para cada gráfica de la pestaña Histórico de medidas. Copia los datos de los plots de la gráfica al vector v_var_excel y el nombre de las señales correspondientes a s_var_excel para que el procedimiento guarda_hist_excel guarde estos datos en una hoja de cálculo Procedimiento abre_hist_excel Extrae de la hoja de cálculo cuya ruta se ha guardado previamente en la variable s_hoja

28 datos para representarlos en una de las gráficas de la pestaña Histórico de medidas. Estos datos se guardan en el vector v_hist_excel Procedimiento act_leyendas_hist Similar al procedimiento act_leyendas (ver apartado ). En este caso, se actualizan las leyendas de todas las gráficas de la pestaña Histórico de medidas a partir de los vectores rep_hist_rap y rep_hist_len, donde se encuentran los códigos de las señales representadas Procedimiento exporta_par Copia los valores de los parámetros de calibración contenidos en los vectores d_vect_par_cal y d_vect_otros_par en el vector de dos dimensiones v_par_excel para que posteriormente la función guarda_par_excel() los guarde en una hoja de cálculo (ver apartado ) Procedimiento guarda_par_excel Procedimiento similar a guarda_osc_excel() descrito en el apartado En este caso, el vector que se guarda es el v_par_excel que contiene los parámetros de calibración que se quieren conservar Procedimiento abre_par_excel Procedimiento similar a abre_osc_excel() descrito en el apartado En este caso, los datos que se extraen son parámetros de calibración y se guardan en el vector v_par_excel.

29 Módulo TxUtils En este bloque podemos encontrar los procedimientos necesarios para generar las tramas que envía la aplicación Procedimiento convierte_byte_a_entero Convierte el byte que se le pasa como parámetro a entero Procedimiento genera_trama Es la rutina que realmente conforma la trama a enviar a partir de dos parámetros que se le pasan por valor. El primero de ellos es el tipo de trama que coincide con el identificador de ésta(ver Anexo III). Algunas tramas tienen subtipos diferentes que vienen representados en el segundo parámetro que toma el procedimiento. Este último es el caso, por ejemplo, de la trama de Comandos maniobra (Id_trama = 8) que tiene 3 posibles valores para el dato según el botón que haya pulsado el usuario en el formulario (Marcha, Parada, Rearme). En el primer bloque se introducen los bytes de cabecera y tamaño de trama en función de los bytes de tipo de trama antes comentados. Si la trama contiene datos variables estos se toman de las variables correspondientes (los datos estarán en estas variables antes de la llamada al procedimiento). Antes de salir de la estructura condicional, se fija el byte donde deberá ir ubicado el CRC que variará dependiendo del tamaño de la trama. Por último, usando la función calcula_crc() se introduce el CRC en el byte correspondiente (el último de la trama).