Controller Assistant se puede parametrizar con un archivo de configuración externo en formato XML. Este archivo de configuración específico del usuario se puede cargar al iniciar el programa. Después, la configuración está disponible. Controller Assistant lee este archivo pero no escribe en él.
Si el archivo de configuración se encuentra en el directorio de ejecución de Controller Assistant, entonces sus valores se incorporarán al iniciar el programa. La configuración influye en el comportamiento, así como en el funcionamiento de Controller Assistant. La configuración se utiliza para realizar la integración en HMI.
La estructura del archivo sigue el formato XML (http://www.xml.org) y debe incluir la codificación ISO-8859-1. Esto permite la introducción de caracteres especiales (por ejemplo, la diéresis en ä, ö y ü) en cualquier momento usando un editor de textos.
El nodo raíz se denomina <config>. Para obtener una descripción de más subnodos, consulte la sección Parámetros de este capítulo.
El archivo de configuración típico que hay a continuación contiene 2 entradas, autofilesavefilename y defaultfilesavedirectory. Ambas están ubicadas como un grupo bajo el nodo principal fileoptions.
Ejemplo de un archivo de configuración típico de 2 entradas:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<config>
<fileoptions>
<autofilesavefilename>
<![CDATA[Backup_<date>_<counter>.pdi]]
<autofilesavefilename>
<defaultfilesavedirectory>
c:\temp\PD-BackUp
<defaultfilesavedirectory>
<fileoptions>
</config>>
Los cambios que se realicen en el archivo deben ser compatibles con XML. De lo contrario, el archivo no se podrá cargar. Al iniciar Controller Assistant, aparecerá el mensaje de diagnóstico en el que se indican la fila y la columna incorrectas. El programa se inicia y se ignora el archivo de configuración.
Existen 2 formas de cargar el archivo de configuración que se desea:
oDe forma automática
Si hay un archivo denominado Controller assistant.config.xml en el directorio de inicio de Controller Assistant, entonces este se cargará automáticamente al iniciarse el programa. Así, el programa usará la configuración mientras se ejecuta.
oManualmente
También es posible cargar el archivo de configuración explícitamente desde otra ubicación del sistema de archivos utilizando la línea de comandos. Esto tiene prioridad sobre la llamada automática. Para ello, puede utilizar la sintaxis siguiente a través de la línea de comandos:
-userconfigfile <file name>
En este caso, se cargará el archivo de configuración introducido como <file name>.
Los parámetros individuales se describen donde aparecen en el archivo de configuración Controller assistant.config.xml. Ahí encontrará ejemplos de aplicaciones. Puesto que este archivo se encuentra en el directorio de programas, puede utilizarlo como una plantilla.
Además, los parámetros están descritos con detalle. Los parámetros aparecen en la lista como rutas XML, que describen sus distintas posiciones en el archivo XML.
config/fileoptions/autofilesavefilename
Cuando se guarda un archivo, se puede generar un nombre de archivo automáticamente. El nombre del archivo puede incluir elementos del nombre de la constante, valores (como la fecha o el tipo de controlador) y un contador. A continuación, se propone el nombre generado de forma automática, por ejemplo en el cuadro de diálogo Guardar como.
El nombre generado de forma automática puede describirse mediante texto y marcadores de posición.
Ejemplo
BackUp_date=<date>.bpd obtendrá el nombre de archivo BackUp_date=2006-03-12.bpd
Se utiliza la fecha actual. El marcador de posición debe escribirse en minúscula. Esto significa que <date> es válido, mientras que <Date> no se reconoce.
El nuevo nombre de archivo generado quizás incluye caracteres que el sistema de archivos no admite (por ejemplo, el archivo es Mi?Archivo). Por consiguiente, estos caracteres se sustituyen con una x en minúscula.
Ejemplo
Mi?Archivo.bpd es sustituido por MixArchivo.bpd.
Se sustituirán los 8 caracteres siguientes:
\/:*?"<>|
La descripción (con marcadores de posición) del nombre que se generará incluye caracteres XML especiales que no se pueden escribir tal cual en un archivo XML. Por lo tanto, la descripción debe aparecer dentro de una sección CDATA.
Ejemplo
BackUp_<date>.bpd debe cambiarse a <!CDATA[BackUp_<date>.bpd]] para poder incluirlo en el archivo XML.
Dado que la descripción de un nombre de archivo que se genera automáticamente puede contener caracteres especiales, debe aparecer dentro de una sección CDATA.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<config>
<fileoptions>
<autofilesavefilename>
<![CDATA[Backup_<date>_<counter>.pdi]]
<autofilesavefilename>
<defaultfilesavedirectory>
c:\temp\PD-BackUp
<defaultfilesavedirectory>
<fileoptions>
</config>>
Los marcadores de posición aparecen entre paréntesis angulares. Deben introducirse de forma manual. La lista ofrece una descripción general de los posibles marcadores de posición:
o<date>
Fecha actual:
Formato: yyyy-MM-dd
Ejemplos
1999-12-01 2006-03-21
o<time>
Hora actual en formato de 24 horas:
Formato: HH-mm-ss
Ejemplos
07-41-29 19-41-29
o<counter>
El contador es una excepción. Primero sustituye el marcador de posición <counter> del nombre de archivo por un número, empezando por el 1. Por ejemplo, el resultado del nombre de archivo sería PD-BackUp_1.bpd. Después, verifica si el nombre de archivo ya existe en el mismo directorio. En caso afirmativo, aumenta el contador en 1 y vuelve a realizar el proceso hasta que no encuentre ningún archivo con el mismo nombre.
o<controllertype>
Inserta el tipo de controlador en un formato abreviado.
Ejemplos
LMC 300 C400600
o<firmwareversion>
Define la versión del firmware con el formato Major.Minor.Build.Revision
Ejemplos
1.30.0.0 1.31.201.2.
Ejemplos de llamadas con posibles resultados
<controllertype>_<firmwareversion>.bpd
--> MAX4_0.22.6.0.bpd
<controllertype>_<firmwareversion>_<date>_<counter>.bpd
--> C400600_2206_2006-03-22_1.bpd
config/fileoptions/defaultfilesavedirectory
Este parámetro define el directorio predeterminado que aparece en primer lugar cuando se abre un cuadro de diálogo Guardar como. Le permite cambiar el directorio y guardar el archivo. Cuando abra la próxima vez el cuadro de diálogo Guardar como, se volverá a sugerir el directorio definido en <defaultfilesavedirectory>.
En el ejemplo siguiente se define c:\temp\PD-BackUp como el directorio predeterminado.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<config>
<fileoptions>
<autofilesavefilename>
<![CDATA[Backup_<date>_<counter>.pdi]]
<autofilesavefilename>
<defaultfilesavedirectory>
c:\temp\PD-BackUp
<defaultfilesavedirectory>
<fileoptions>
</config>>
La entrada define c:\temp\PD-BackUp como el directorio predeterminado.
config/fileoptions/defaultfileopendirectory
Este parámetro define el directorio predeterminado que aparece en primer lugar cuando se abre un cuadro de diálogo Abrir. Le permite cambiar el directorio y abrir el archivo. Cuando abra la próxima vez el cuadro de diálogo Abrir, se volverá a sugerir el directorio definido en <defaultfileopendirectory>.
config/application/usermode
Mediante la modalidad de usuario, se pueden establecer más parámetros de Controller Assistant. La modalidad de usuario está pensada para las aplicaciones HMI. Define las funcionalidades disponibles.
Se aceptan las modalidades siguientes:
|
Modalidad |
Descripción |
|---|---|
|
Default |
Configuración predeterminada (no corresponde a ninguna modalidad de usuario activa) |
|
NoFirmwareChange |
Se han desactivado los cuadros de diálogo para sustituir el firmware. |
|
DontEditImage |
Se ha desactivado el menú para editar imágenes. |
|
NoExplorer |
Se ha desactivado el cuadro de diálogo ImageManager de Controller Assistant para la edición manual de la imagen. |
config/application/quicktransfermode
En caso de una programación con uso intensivo de recursos que requiera un alto nivel de demanda en el controlador y especialmente, para controladores con un firmware obsoleto, es posible que se sobrepasen los tiempos de ciclo. Si <quicktransfermode> se define como FALSE, la transferencia se llevará a cabo lentamente (hasta un factor de 15). Esto ayuda a minimizar el riesgo de desborde del tiempo de ciclo y los consiguientes errores de timeout de watchdog.
NOTA: El valor predeterminado de <quicktransfermode> es TRUE.
