¿Cómo podemos ayudar?
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
- Haga clic en el icono New y asigne un nombre: el nuevo script aparece en la lista unsave
- Pegue o escriba el código en la ventana de edición.
- 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.
- Haga clic en Save.
Para importar un script existente
- Haga clic en el icono Import/Open
- Seleccione el archivo del script exportado previamente desde otro proyecto (véase el paso 3).
- Compruebe el código y la pestaña Variable Setting: las direcciones deben corresponder al proyecto actual.
- 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.

- Seleccione el script en la lista de scripts
- Clic derecho Export script
- 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
![]()
- 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.
- 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).
- Abra Setting > Global Script.
- Seleccione el script compilado en la lista.
- Configure la frecuencia de ejecución.
- 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. - 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.
- Coloque un objeto Timer en la pantalla (no es visible durante la ejecución).
- Execution mode: Always Execute, o Address Triggered (se ejecuta mientras el bit esté en ON).
- Frequency: de 0,1 s a 60 s.
- Execution Times: 0 = ejecución indefinida; si no, el número de ejecuciones.
- 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.
- Abra Setting > Init Script.
- Seleccione el script compilado en la lista.
- 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
- Abra Setting > Trigger Script y haga clic en New.
- Seleccione el script compilado.
- 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.
- 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
MarcoIniten todos los scripts.MacroInitprovoca 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.