Hoe kunnen we helpen?
CommandHMI: C-scripts importeren, exporteren, compileren en uitvoeren
Overzicht
Een C-script draait pas op de HMI als het succesvol is gecompileerd en er een uitvoeringsmodus aan is toegewezen.
De werkwijze is altijd dezelfde:
- de Script Editor openen
- het script aanmaken of importeren
- het compileren
- het toewijzen als Global-, Init- of Trigger-script
| Uitvoeringsmodus | Wanneer het draait | Waar in te stellen | Limiet |
|---|---|---|---|
| Cyclisch (Global Script) | Continu, met een ingestelde frequentie, optioneel gestuurd door een bit | Setting > Global Script | 64 scripts, uitgevoerd in lijstvolgorde |
| Cyclisch (Timer-object) | Met een ingestelde frequentie, altijd of zolang een bit ON is | Timer-object op een scherm geplaatst | 0,1 s tot 60 s |
| Init Script | Eenmalig, bij het opstarten van de HMI, onafhankelijk van de schermen | Setting > Init Script | 64 scripts, uitgevoerd in lijstvolgorde |
| Trigger Script | Wanneer een bit van toestand verandert, of een scherm wordt geopend/gesloten | Setting > Trigger Script | — |
Elk nieuw script begint met dit sjabloon. Behoud de spelling MarcoInit precies zoals weergegeven: het is de macronaam die in het headerbestand van de editor is gedefinieerd.
#include "MacroInit.h"
//#include "subFun1.c" //Example: sub script
void Macro_main(IN *p)
{
MarcoInit
//ToDo
}
Stap 1 – De Script Editor openen
Open uw project in CommandHMI en open vervolgens de Script Editor

Het editorvenster heeft 3 hoofdgebieden:
- Scriptlijst (links) – scripts gesorteerd op status:
- Success (succesvol gecompileerd)
- Fail (compileerfouten)
- Not compiled (niet gecompileerd)
- Not saved (niet opgeslagen).
- Script-bewerkingsvenster – de C-broncode
- Instellings- en uitvoervenster (onderaan) – het tabblad Variable Setting en het tabblad Compile information output.
Stap 2 – Een script aanmaken, plakken of importeren

Een nieuw script aanmaken of een ander script plakken
- Klik op het pictogram New en geef een naam op: het nieuwe script verschijnt in de lijst unsave
- Plak of schrijf de code in het bewerkingsvenster.
- Dubbelklik in het tabblad Variable Setting (of rechtsklik > New Variable) om de variabelen te declareren die aan HMI-adressen zijn gekoppeld: naam, gegevenstype, lezen/schrijven, adres. Variabelen die hier zijn gedeclareerd, of uit een adresbibliotheek komen, hoeven niet opnieuw in de code te worden gedeclareerd. Interne scriptvariabelen worden zoals gebruikelijk in de code gedeclareerd.
- Klik op Save.
Een bestaand script importeren
- Klik op het pictogram Import/Open
- Selecteer het scriptbestand dat eerder uit een ander project is geëxporteerd (zie stap 3).
- Controleer de code en het tabblad Variable Setting: de adressen moeten overeenkomen met het huidige project.
- Als het script subscripts aanroept met
#include "subXxx.c", zorg er dan voor dat die subscripts ook in het project aanwezig zijn.
Stap 3 – Een script exporteren
Exporteer een script om het in een ander project te hergebruiken of als back-up te bewaren.

- Selecteer het script in de scriptlijst
- Rechtsklik Export script
- Kies de map en bevestig met OK. Het script wordt opgeslagen als
*.csv-bestand.
Dit is het bestand dat u later selecteert met Import.
Stap 4 – Het script compileren
![]()
- Selecteer het script en klik op Compile in de werkbalk van het bewerkingsvenster. De editor slaat het script in één stap op, compileert, linkt en controleert het.
- Lees het tabblad Compile information output:
- “0 errors! Compile successfully” – het script gaat naar de lijst Success en kan nu een uitvoeringsmodus krijgen.
- Fouten weergegeven – het script gaat naar de lijst Fail. Corrigeer de gemelde regels en compileer opnieuw.
Alleen scripts in de lijst Success verschijnen in de dialoogvensters Global, Init en Trigger script.
Stap 5 – Het script uitvoeren
Kies per toepassing één uitvoeringsmodus: Init, Cyclisch, Timer, Trigger… Een script dat gecompileerd maar niet toegewezen is, wordt nooit uitgevoerd.

5.1 Cyclische uitvoering – Global Script
Gebruik dit voor logica die altijd moet draaien, ongeacht het weergegeven scherm (50 ms of meer).
- Open Setting > Global Script.
- Selecteer het gecompileerde script in de lijst.
- Stel de uitvoeringsfrequentie in.
- Optioneel: schakel bitsturing in en voer een bitadres in (bijv.
LB100). Het script draait dan alleen zolang deze bit ON is. - Klik op OK. Er kunnen tot 64 globale scripts worden toegevoegd; ze worden uitgevoerd in de volgorde van de lijst.
5.2 Cyclische uitvoering – Timer-object (alternatief)
Gebruik dit wanneer het script alleen moet draaien zolang een bepaald scherm geopend is.
- Plaats een Timer-object op het scherm (het is tijdens runtime niet zichtbaar).
- Execution mode: Always Execute, of Address Triggered (draait zolang de bit ON is).
- Frequency: 0,1 s tot 60 s.
- Execution Times: 0 = onbeperkt, anders het aantal uitvoeringen.
- Function type: Macro, selecteer daarna de Name van het script.
5.3 Eenmalig uitvoeren bij opstarten – Init Script
Gebruik dit om waarden te initialiseren wanneer de HMI wordt ingeschakeld.
- Open Setting > Init Script.
- Selecteer het gecompileerde script in de lijst.
- Klik op OK. Het script draait eenmalig bij het opstarten, onafhankelijk van de schermen. Tot 64 init-scripts, uitgevoerd in lijstvolgorde.
5.4 Uitvoeren bij een gebeurtenis – Trigger Script
- Open Setting > Trigger Script en klik op New.
- Selecteer het gecompileerde script.
- Kies het triggertype:
- Address trigger – voer een bitadres en een modus in: OFF→ON, ON→OFF, OFF↔ON (elke wijziging), of Immediate execute when ON.
- Screen trigger – selecteer een scherm en een modus: Open Screen of Close Screen.
- Klik op OK. Gebruik Alter of Delete om de triggerlijst te beheren.
Downloaden naar de HMI
Compileer het hele project met Download > Compile, test het daarna met Off-line Simulation of verstuur het met Download > USB/Ethernet download.
Tips en veelgemaakte fouten
- Behoud de spelling
MarcoInitin elk script.MacroInitveroorzaakt een compileerfout. - Houd cyclische scripts kort. Geen blokkerende lussen of lange
DELAY()-aanroepen: die vertragen de HMI. - Reset bij een door een bit getriggerd script de triggerbit in het script als het opnieuw moet afgaan.
- Bits LB50000–LB51999 en woorden LW50000–LW51999 behouden hun waarde na een stroomonderbreking. Gebruik ze voor tellers of instellingen die een herstart moeten overleven.
- Compileer het script na een import opnieuw: een geïmporteerd script staat pas in de lijst Success als het in het nieuwe project is gecompileerd.