¿Cómo podemos ayudar?

Print

CommandHMI: importar, exportar, compilar y ejecutar scripts en C

Descripción general

Un script C solo se ejecuta en el HMI una vez que se ha compilado correctamente y se le ha asignado un modo de ejecución.

El procedimiento es siempre el mismo:

  • abrir el Script Editor
  • crear o importar el script
  • compilarlo
  • asignarlo como script Global, Init o Trigger
Modo de ejecución Cuándo se ejecuta Dónde configurarlo Límite
Cíclico (Global Script) De forma continua, a una frecuencia definida, opcionalmente condicionado por un bit Setting > Global Script 64 scripts, ejecutados en el orden de la lista
Cíclico (objeto Timer) A una frecuencia definida, siempre o mientras un bit esté en ON Objeto Timer colocado en una pantalla De 0,1 s a 60 s
Init Script Una sola vez, al arrancar el HMI, independientemente de las pantallas Setting > Init Script 64 scripts, ejecutados en el orden de la lista
Trigger Script Cuando un bit cambia de estado, o al abrir/cerrar una pantalla Setting > Trigger Script —

 

Todo script nuevo parte de esta plantilla. Mantenga la grafía MarcoInit exactamente como se muestra: es el nombre de la macro definido en el archivo de cabecera del editor.

#include "MacroInit.h"
//#include "subFun1.c" //Example: sub script
void Macro_main(IN *p)
{
	MarcoInit
	//ToDo
}

Paso 1 – Abrir el Script Editor

Abra su proyecto en CommandHMI y, a continuación, abra el Script Editor

La ventana del editor tiene 3 zonas principales:

  • Lista de scripts (izquierda) – scripts ordenados por estado:
    • Success (compilado correctamente)
    • Fail (errores de compilación)
    • Not compiled (no compilado)
    • Not saved (no guardado).
  • Ventana de edición del script – el código fuente C
  • Ventana de configuración y salida (abajo) – la pestaña Variable Setting y la pestaña Compile information output.

 

Paso 2 – Crear, pegar o importar un script

Para crear un script nuevo o pegar otro

  1. Haga clic en el icono New y asigne un nombre: el nuevo script aparece en la lista unsave
  2. Pegue o escriba el código en la ventana de edición.
  3. En la pestaña Variable Setting, haga doble clic (o clic derecho > New Variable) para declarar las variables vinculadas a las direcciones del HMI: nombre, tipo de dato, lectura/escritura, dirección. Las variables declaradas aquí, o tomadas de una biblioteca de direcciones, no necesitan declararse de nuevo en el código. Las variables internas del script se declaran en el código de la forma habitual.
  4. Haga clic en Save.

Para importar un script existente

  1. Haga clic en el icono Import/Open
  2. Seleccione el archivo del script exportado previamente desde otro proyecto (véase el paso 3).
  3. Compruebe el código y la pestaña Variable Setting: las direcciones deben corresponder al proyecto actual.
  4. Si el script llama a subscripts con #include "subXxx.c", asegúrese de que esos subscripts también estén presentes en el proyecto.

Paso 3 – Exportar un script

Exporte un script para reutilizarlo en otro proyecto o para hacer una copia de seguridad.

  1. Seleccione el script en la lista de scripts
  2. Clic derecho Export script
  3. Elija la carpeta y confirme con OK. El script se guarda como archivo *.csv.

Este es el archivo que seleccionará después con Import.

Paso 4 – Compilar el script

  1. Seleccione el script y haga clic en Compile en la barra de herramientas de la ventana de edición. El editor guarda, compila, enlaza y verifica el script en un solo paso.
  2. Lea la pestaña Compile information output:
    • «0 errors! Compile successfully» – el script pasa a la lista Success y ya se le puede asignar un modo de ejecución.
    • Errores listados – el script pasa a la lista Fail. Corrija las líneas indicadas y vuelva a compilar.

Solo los scripts de la lista Success aparecen en los cuadros de diálogo Global, Init y Trigger script.

 

Paso 5 – Ejecutar el script

Elija un modo de ejecución para cada uso: Init, Cíclico, Timer, Trigger… Un script compilado pero no asignado nunca se ejecuta.

5.1 Ejecución cíclica – Global Script

Úselo para la lógica que debe ejecutarse siempre, sea cual sea la pantalla mostrada (50 ms o más).

  1. Abra Setting > Global Script.
  2. Seleccione el script compilado en la lista.
  3. Configure la frecuencia de ejecución.
  4. Opcional: active el control por bit e introduzca una dirección de bit (p. ej. LB100). El script solo se ejecuta entonces mientras este bit esté en ON.
  5. Haga clic en OK. Se pueden añadir hasta 64 scripts globales; se ejecutan en el orden de la lista.

5.2 Ejecución cíclica – objeto Timer (alternativa)

Úselo cuando el script solo deba ejecutarse mientras una pantalla determinada esté abierta.

  1. Coloque un objeto Timer en la pantalla (no es visible durante la ejecución).
  2. Execution mode: Always Execute, o Address Triggered (se ejecuta mientras el bit esté en ON).
  3. Frequency: de 0,1 s a 60 s.
  4. Execution Times: 0 = ejecución indefinida; si no, el número de ejecuciones.
  5. Function type: Macro, y luego seleccione el Name del script.

5.3 Ejecución única al arranque – Init Script

Úselo para inicializar valores al encender el HMI.

  1. Abra Setting > Init Script.
  2. Seleccione el script compilado en la lista.
  3. Haga clic en OK. El script se ejecuta una sola vez al arrancar, independientemente de las pantallas. Hasta 64 scripts de inicialización, ejecutados en el orden de la lista.

5.4 Ejecución ante un evento – Trigger Script

  1. Abra Setting > Trigger Script y haga clic en New.
  2. Seleccione el script compilado.
  3. Elija el tipo de disparo:
    • Address trigger – introduzca una dirección de bit y un modo: OFF→ON, ON→OFF, OFF↔ON (cualquier cambio), o Immediate execute when ON.
    • Screen trigger – seleccione una pantalla y un modo: Open Screen o Close Screen.
  4. Haga clic en OK. Use Alter o Delete para gestionar la lista de disparadores.

Descarga al HMI

Compile todo el proyecto con Download > Compile y, a continuación, pruébelo con Off-line Simulation o envíelo con Download > USB/Ethernet download.

 

Consejos y errores frecuentes

  • Mantenga la grafía MarcoInit en todos los scripts. MacroInit provoca un error de compilación.
  • Mantenga cortos los scripts cíclicos. Nada de bucles bloqueantes ni llamadas largas a DELAY(): ralentizan el HMI.
  • En un script disparado por bit, reinicie el bit de disparo en el script si debe volver a dispararse.
  • Los bits LB50000–LB51999 y las palabras LW50000–LW51999 conservan su valor tras un corte de alimentación. Úselos para contadores o ajustes que deban mantenerse tras un reinicio.
  • Después de una importación, vuelva a compilar el script: un script importado no está en la lista Success hasta que se compila en el nuevo proyecto.